RCF and AFS accounts

Before you can do anything you need an RCF account and an AFS account. Visit the RCF new accounts page for information. When you obtain an account you're automatically given an AFS account as well. The contact person in the last part of the information must be your council representative who must vouch for you. Please, remember to bug your council representative so he can also inform Liz Mogavero of your recent arrival in STAR and send her the updated list of active members from your institution.

Once you have an account you have access to the RHIC AFS cell and the STAR directories and files mounted thereon. You must get an AFS token with the klog command before accessing any AFS area.

Computers to use

See the Computing Environment or information on STAR and RHIC computers and printers. If you're bringing a computer of your own to BNL contact Jerome Lauret or Wayne Betts regarding an IP address.

Set up your login

This login environment is partly related to HEPiX, a standard within the HENP community and used at many labs. Starting in the middle of 2001, the standard STAR login was chosen to be a stand-alone minimal login instead of the default HEPix login and stack suite (which became un-maintainable and cumbersome). Older users should follow the above instructions and update their .cshrc and .login file if not already done.

The STAR group on the RCF machines is rhstar. The group directory with scripts for the STAR environment is GROUP_DIR = /afs/rhic.bnl.gov/rhstar/group. There is also a link /afs/rhic.bnl.gov/rhstar -> /afs/rhic.bnl.gov/star. Note that the initial /afs/rhic/rhstar AFS volume needed to change name in mid-2003 to comply with Kerberos 5 authentication and token passing mechanism. It is however a link toward the rhic.bnl.gov volume but its use should be discontinued.

If your Unix group is different from star or rhstar, first of all you should ask to the RCF team that you be added to the rhstar group (submit a ticket, see the Software Infrastructure for more instructions). Several possibilities/scenario are now described :

1. Your account was recently created by the RCF team : there should be nothing to do.
2. Your account was created on a remote site, and you have access to the RHIC AFS cell : you could either
   • Copy /afs/rhic.bnl.gov/star/group/templates/cshrc and /afs/rhic.bnl.gov/star/group/templates/login as .cshrc and .login in your home directory.

        % cp /afs/rhic.bnl.gov/star/group/templates/cshrc ~/.cshrc
        % cp /afs/rhic.bnl.gov/star/group/templates/login ~/.login
        

   • You may want to copy/clone the /afs/rhic.bnl.gov/star/group on a local storage and modify the variable GROUP_DIR located on top of your .login and .cshrc after you have accomplish step 1.

Then you can customize both .cshrc and .login for your taste (or source separate personal setups from them).

When you next logout and log back in, your PATH, MANPATH, and LD_LIBRARY_PATH will include the proper STAR directories. Your environment variables will also include several STAR variables (below).

The group login script

The group environment variables are defined in the group_env.csh script. Some of the more important environment variables set up by this script follows. The variable in blue, if defined before the login scripts are loaded, will not be superseded. Variables in green are likely already defined if the optional component has been deployed on your machine. Variable in red are fixed values on purpose to ensure compatibility and the scrict install path MUST be present for STAR's environment to load properly.

• AFS : afs utility directory [ default = /usr/afsws ]
• AFS_RHIC : top rhic directory path [ default = /afs/rhic.bnl.gov ]
• ROOTSYS : ROOT system directory
• GROUP_DIR : star group login scripts [ default = $AFS_RHIC/star/group/ ] . This directory contains login scripts used to setup the rest of the environment. Note that you should be able to cvs checkout as-is this directory on your local machine / cluster and still be functional. If this is not the case, you should contact the Infrastructure Leader immediately.
• XOPTSTAR : AFS resident base directory [ default = ${AFS_RHIC}/opt/star (see also $OPTSTAR below). Although this variable may be redefined, it would be hazardous to do so ...
• OPTSTAR : Base directory for updates of /usr/XXX or /usr/local/XXX [ default = either /opt/star if exists or $XOPTSTAR ]. Note that for a local setup, the entire tree $XOPTSTAR may be installed on your local cluster and $OPTSTAR variable defined appropriately before loading the group environment script.
• STAR : the top directory path for the particular version of STAR software
• STAR_ROOT : the top directory path to STAR [default = ${AFS_RHIC}/star or /usr/local/star ]
• STAR_PATH : the top directory path to STAR software [ ${STAR_ROOT}/packages]
• STAR_LEVEL : dev/new/pro/old version of software. If undefined, the default value is “pro”
• STAR_VERSION: SL98d/SL98c/SL98b/SL98a version of software
• STAR_SYS : architecture (i386_linux2, sun4x_56, i386_sl302 ...).
  This is what is used for AFS access via the @sys replacement.
  In a local installation environment (non-AFS based), this variable need to be used to access the partition containing the equivalent of what you find in AFS land.
• STAR_HOST_SYS : architecture flag used for separating compilation results (may be be equal to STAR_SYS but usually, contains the compiler style and version in it).
• STAR_LIB : the top directory path of the particular version of STAR Library (usually set to something like $STAR/.${STAR_HOST_SYS}/lib )
• STAR_BIN : the pointer to StAF executables, geant3, stic, ...
• STAR_DATA : the top directory for ``test'' data samples
• STAR_CALIB : the top directory for detector calibration constants
• STAR_DB : the top directory for the Objectivity database
• CVSROOT : the STAR CVS repository
• CERN : base path for the CERN environment. If undefined the first path in the following list found will be used as default starting point: /cern, ${AFS_RHIC}/asis/@sys/cern, /usr/local/cern
  If nothing is found, a default value /cern will be set
• CERN_LEVEL : base path for the current version of CERN library.
  If undefined, will be set to “pro”
• CERN_ROOT: will equate to ${CERN}/${CERN_LEVEL}

To see these variables in your own environment use printenv | grep -i star.
Other variables are

• CLHEP_BASE_DIR : base path for the CLHEP libraries. [ default = ${OPTSTAR} ]
• QTDIR : the base path for Qt installation. Equal to $OPTSTAR/qt and if found, will overwrite any value previously set. If not found, $OPTSTAR/qt3 and $OPTSTAR/qt4 will be searched in repsective order and QTDIR defined accordingly but only if QTDIR is not already defined (no overwrite in this case).
• INSV : the insure version level. The login script will be looking in $AFS_RHIC/app/$INSV if this directory exists
• JAVA_ROOT : the base path for java installation. Directories like bin/ man/ etc ... are expected to be below this level [default = latest version in /usr/java ]

Grid related environment variables:

• WNOSG: a path where a Worker Node, client install of the grid toolkit is available.
• GLOBUS_PATH : a path to “a” globus installation is available (old VDT or new OSG). If found, WNOSG will NOT be considered.
• OSG: a path where an OSG installation exists. This will overwrite the GLOBUS/VDT definitions and WNOSG will be ignored.

The PATH environment variable is appended with directories of executables which are part of the STAR computing environment. For example:

• /usr/afsws/bin : AFS utilities
• /usr/afsws/etc : AFS utilities
• /opt/rhic/bin : opt rhic is RHIC wide update for /usr/bin and /usr/local/bin .
• /usr/local/bin : updates to /usr/bin. At the RCF this is what we took from CERN
• $STAR/mgr : scripts for ``dev/new/pro/old'' version of STAR library
• /usr/sbin : System
• /opt/SUNWspro/bin : System
• /usr/ccs/bin : System
• /usr/ccs/lib : System
• /usr/bin : System
• /usr/openwin/bin : System
• /usr/dt/bin : System
• /usr/ucb : System
• /usr/local/bin/X11 : System

Note on /afs/rhic.bnl.gov/opt/star and /opt/star versus Linux

While at the RCF, /opt/star is a soft link to /afs/rhic.bnl.gov/opt/star/, there is a misleading component to the the path /afs/rhic.bnl.gov/opt/star ... The real path is /afs/rhic.bnl.gov/@sys/opt/star and depends on the result of the translation of the AFS @sys set on YOUR client. The current translation has been so far as follow

Linux release support	Notes or Also supports	Result of fs sysname MUST be
RH 6.1	(obsolete)	i386_redhat61
RH 7.2	(obsolete)	i386_linux24
RH 8	none additional	i386_redhat80
SL 3.0.2	gcc 3.2.3 - SL 3.0.4, rh3	i386_sl302
SL 3.0.5	gcc 3.2.3 - SL 3.0.{6|7|8|9}, rh3	i386_sl305
SL 4.4	gcc 3.4.6 - SL 4.5, rh4	i386_sl4

A typical problem for off-site facilities is to deploy a version of Linux with no match for sysname (or wrong match). For example, RedHat8.0 set with i386_linux24 will pick up the program in the wrong AFS area, a RedHat 9.0 system would be equally problematic as currently not supported. There are some backward compatibility support for other Linux OS versions we document in the second column. If your OS does not appear in this table, you could send a note for a request support to the offsites or starsofi Hypernews fora.

The sysname is configured in /etc/sysconfig/afs . It uses a default value or is set via a line similar to the following

AFS_POST_INIT="/usr/bin/fs sysname -newsys i386_sl4"