NEXT Offline Code Installation and Setup

Install NEXT offline code

The instructions in this Section should be done only once per release version installed in your machine.

First, make sure you have all the required 3rd party software installed, see SoftwareOfflineDependencies.

Now get the installer script from SVN:

svn export svn://next.ific.uv.es:/svn/next/offline/FMWK/pkgs/SRT_NEXT/trunk/scripts/install_nextoffline

In order to get the current production release, just type:

./install_nextoffline <some directory>

where <some directory> is some directory of your choice, below which the nextoffline directory will be created, which in turn will have three subdirectories: packages, releases, srt.

The installer script will:

• check that your environment variables are properly set, and that the specified release name (if any) is sensible
  
• install SoftRelTools^? (http://www.fnal.gov/docs/products/srt/) if not already present
  
• get the release source code, checking whether the requested tag for each package is already present or not in your system. Please be patient: there is a relatively large (100 MB) raw data file in the Tutorial package, which may take a few minutes to download
  
• create a script (setup_nextoffline.(c)sh) to setup the nextoffline code environment
  
• finally build the release

If you want to install a release other than the current one, you should use the -release= option, with either the release tag in the form R201x-yy-zz, or with the corresponding release nickname, for example:
./install_nextoffline -release=R2010-03-17 <some directory>
or
./install_nextoffline -release=hydrogen <some directory>

Absence of the -release= option will default to the current release. To see which releases are available, which one is the current release at this time, and what are the release nicknames, have a look at the release_versions file with:

svn cat svn://next.ific.uv.es:/svn/next/offline/FMWK/pkgs/releaseDB/trunk/release_versions

or with a SVN repository browser at SoftwareOfflineBrowsers

It is highly recommended to install all releases of the NEXT offline code in the same top-level directory, eg run the install_nextoffline script always with the same <some directory> specification.

This will have the advantage of centralizing the (relase-independent) srt scripts into one location, and to reduce the amount of packages that need to be pulled out of SVN for each release. No worries, your past releases won't be deleted in the process!

Set up NEXT offline code

To set up NEXT offline code, just source the setup_nextoffline script:
. <some directory>/nextoffline/srt/setup_nextoffline.sh

for a bash shell, or:

source <some directory>/nextoffline/srt/setup_nextoffline.csh

for a tcsh shell, where <some directory> is what you have specified above.

Unless you have other projects in your system that use SRT, you will most likely find convenient to add the former in your .profile or .bashrc file, and the latter in your .login or .tcshrc file.

To make sure that you have set up your environment correctly, type:

source srt_environment

The information printed on screen will show your current SRT environment. Note that SRT_PUBLIC_CONTEXT and SRT_BASE_RELEASE should point to your base release, and that SRT_MAKEFLAGS, PATH and LD_LIBRARY_PATH should include your base release include, bin and lib directories, respectively.