Analysis Workbook. Account Setup

Getting an Account

Every user who wants to access LCLS data needs to have valid SLAC UNIX account. Getting a SLAC account for new user involves filling request forms and is usually done by proposal primary investigator (PI). The process is described on LCLS User Resources page.

Analysis farm

Once the new UNIX account is established the user receives an access to LCLS analysis machines. The names of the hosts that users can use for interactive purposes (including doing interactive analysis) may depend on the particular experiment, the list is usually communicated to the PI. In addition to interactive hosts the maybe in the future a dedicated processing farm for batch jobs. More information about computing at LCLS can be found here.

Logging in

The analysis machines are accessible only from a SLAC network and not accessible from outside of SLAC. To login to analysis host one has to first login to a dedicated "gateway" host with name pslogin. From pslogin one connects directly to analysis hosts. The only login type supported by LCLS machines is ssh. Here is the example of the login session from SLAC general network:

yakut % ssh pslogin
....
pslogin % ssh psana
....
psana101 %

Currently all LCLS machines run the same operating system which is RedHat Enterprise Linux 5 (RHEL5).

Setting Up Account

For the analysis software to work correctly it has to run in a correct environment. LCLS Analysis environment consists of few environment variables that either point to a location of specific directories or define some configuration options such as type of the machine, compiler versions, etc. Users do not need to set environment variables manually, instead users need to execute just one simple command which defines the complete environment. The command that needs to be run from Bourne-type shell (e.g. bash) is:

. /reg/g/psdm/etc/ana_env.sh

For C-type thell (e.g. tcsh) the command should be:

source /reg/g/psdm/etc/ana_env.csh

The above command needs to be executed every time when user logs in, for convenience it should be added to the user's shell login script. In case of bash shell here is the line of code that should be placed into ~/.bashrc file:

test -f /reg/g/psdm/etc/ana_env.sh && . /reg/g/psdm/etc/ana_env.sh

For tcsh the following code should be added to ~/.cshrc:

if ( -f /reg/g/psdm/etc/ana_env.csh ) source /reg/g/psdm/etc/ana_env.csh