fROOT: fnd.sh file configuration help

General notes

You are not supposed to modify the "fnd.sh" file directly in $FROOTSYS: copy it in your home directory first. The "fnd.sh" file is a bash shell script: it is reccomended to run it within a bash shell. If bash is not your default shell, then just type:
# bash
before running "fnd.sh". You will be able to leave the bash shell simply typing "exit" on the command line.
Many comments were added to the "fnd.sh" content, in order to guide the user in the configuration process; a step-by-step help is provided

Step by step configuration

===> CVS distribution <===

CVS environmental variables are commented by default, but you can uncomment them if you want to check CVS log-files, eventual differences between the content of your sendbox and the content of the repository, perform updates, and so on...

• CVSROOT
  this variable points to the directory in which the repository is stored (in the CVS server):
  if you are not an fROOT developer you should set it to ":ext:finuda@fnddiskfe.lnf.infn.it:/home/online/CVS_REP_ONLINE"

• CVS_RSH
  this variables indicates the access method: ssh in our case.

===> SOFTWARE INSTALLATION <===

• CERNDIR
  path to cern-libraries (default is reccomended: "/cern/pro")

• ROOTSYS
  path to the top ROOT installation directory

• FROOTSYS
  path to the top fROOT installation directory

• REC_OUTPUTS
  The directories structure under $REC_OUTPUTS is required only if you plan to run the pre-analysis monitor or the fidarc wrapper (fROOT interface to the reconstruction program):
  in this case you have to define $REC_OUTPUTS as you like,
  and create the following directories under $REC_OUTPUTS: out, dstapes, histos.
  Don't modify following lines of "fnd.sh":
  export OUT=$REC_OUTPUTS/out
  export DST=$REC_OUTPUTS/dstapes
  export HIS=$REC_OUTPUTS/histos

===> MSQL <===

• MSQLDIR
  path to the top installation directory of miniSQL-1 (for example "/usr/local/Minerva").

• MSQL_DB_HOST
  host to be contacted for any connection to the database.

• MSQLHOST
  This variable is used by fROOT: don't change it.

• MSQL_TCP_PORT
  default value (4333) is reccomended.

===> MYSQL <===

• MYSQL_DIR_INC
  path to the top installation directory of mysql (for example "/usr/include/mysql").

• MYSQLCLIENT_DIR_LIB
  path to "libmysqlclient.so"

• MYSQL_DB_HOST
  host to be contacted for any connection to the database.

• MYSQL_TCP_PORT
  default value (3306) is reccomended.

===> DATA path <===

• RDT
  directory containg raw (zipped) files.

• FND_WRK
  work directory, in which you will copy and execute fROOT macros.

===> OUTPUT AND STORAGE <===

• FND_HDT
  directory in which HDT root files are stored (produced by geb2hdt.

• FND_MON_HISTOS
  directory in which monitoring-histograms-root-files are stored.

• FND_HISTOS
  directory in which default run-summary-histograms files are stored.

• FND_TREES
  directory in which root trees produced by the analysis of fROOT DSTs will be stored (kept for backwards compatibility).

===>PRE-ANALYSIS <===

• FND_PREAN_TREES
  directory in which pre-analysis output files (trees) are stored (note: sub-directories with fidarc-version are needed).

===> ONLINE <===

• FND_SHR
  This directory will contains shared files while the monitoring or the pre-analysis software will be running in online mode:
  if you plan to use the online monitor via NFS, the access to the directory pointed by this variable must be read/write both for the producer (geb2hdt) and the consumer (showing histograms) machines.

• CAN_RUN_PRODUCER
  if this variable is set to "no" you will not be able to run the "geb2hdt" macro (using the fROOT GUI) on your machine.

• FND_GEBIP
  IP address of the machine in which the "GEB" is running.

Last update: Oct 16, 07