Software/Geant4/UCL HEP Cluster: Difference between revisions

From PBTWiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 21: Line 21:
In order to access these machines, you will need to obtain an account from the UCL HEP Group Computing Support.   
In order to access these machines, you will need to obtain an account from the UCL HEP Group Computing Support.   
Please contact Dr. Simon Jolly for instructions on obtaining an account.
Please contact Dr. Simon Jolly for instructions on obtaining an account.
== Folder structure ==
=== Disk ===
There is a separate (large) disk for PBT work mounted on the Linux system at <code>/unix/pbt</code>. 
When running simulations, you should create a subdirectory with your <code>username</code> at <code>/unix/pbt/username</code>
=== Software ===
All software is enclosed in a folder at <code>/unix/pbt/software</code>.
=== Source code ===
Source code for building and installing software packages is kept in a separate folder at <code>/unix/pbt/software/src</code>.
== Environments ==
Two separate environments are provide for PBT simulations: the '''Production''' environment for general use and the '''Development''' environment for testing changes or updates to the code. 
The '''Production''' environment is further subdivided depending on whether the machine you are logged in to is running SLC5 or SL6: the SLC5 legacy environment features an older version of Geant4 and related software that will not be updated.
* The recommended '''Production''' environment for SL6 is stored in <code>/unix/pbt/software/prod-sl6</code>;
* The '''Development''' environment for SL6 is stored in <code>/unix/pbt/software/dev</code>: code is then subdivided into directories by application name;
* The legacy '''Production''' environment for SLC5 is stored in <code>/unix/pbt/software/prod</code>: this is only accessible for users running on SLC5 machines.
It is possible to select whether the '''Development''' or '''Production''' environment is launched under SL6 by adding the appropriate flags when calling the setup script (see [[#Scripts]] below).
== Scripts ==
Access to the PBT '''Production''' and '''Development''' environments is implemented by a single script, <code>pbt.sh</code>. 
This calls a number of other utility scripts that set up the required PBT environment: these are all stored in <code>/unix/pbt/software/scripts/</code>. 
The <code>pbt.sh</code> script is called in the following way:
<pre>
source /unix/pbt/software/scripts/pbt.sh
</pre>
This will auto-detect whether you are running on a newer SL6 machine or a legacy SLC5 machine and set up the environment accordingly. 
The steps carried out during setup are as follows:
# Check the environment and whether the user wishes to run in verbose or development mode (see below);
# Launch a new <code>bash</code> shell with the appropriate Scientific Linux Developer Toolset (see below);
# Call the appropriate <code>bashrc</code> script to begin environment setup; this in turn runs the following actions:
## Run the user's own <code>.bashrc</code>;
## Set the environment name;
## Greeting with information for users;
## Define exit function with exit message when user exits environment;
## Call shell script to set up environment.
# The specific shell script then carries out the following actions:
## Set specific environment variables with locations of compiler, Geant4 etc.
## Add locations to path variables and remove duplicates (calls <code>setpaths.sh</code> script);
## Define colours for scripts, prompt, etc (calls <code>definecolours.sh<code> script);
## Check versions of installed software and display results (calls <code>checkversions.sh</code> script);
## Modify prompt to show environment name;
## Run <code>Geant4</code> setup script and set additional settings;
Adding the <code>-v</code> flag enables the scripts to run in verbose mode, which displays the full paths when checking the versions of the installed software. 
Adding the <code>-d</code> flag enables the '''Development''' environment to allow new software to be built without changing the '''Production''' setup needed by most users: this is only available on SL6 machines.
When <code>pbt.sh</code> is called, its first action after selecting the right environment is to launch a new <code>bash</code> shell that provides a degree of isolation for setting up the desired PBT environment. 
Once the user has finished with the PBT environment, exiting the shell will deposit the user back into their previous environment. 
Launching a new shell also provides access to the correct Scientific Linux Developer Toolset: on SL6 this is <code>devtoolset-3</code>, whereas SLC5 uses the older <code>devtoolset-2</code>. 
In either case, the Developer Toolset is a Linux software collection providing various tools for developers, including more up-to-date versions of software required by <code>Geant4</code>, most notably including a newer version of <code>GCC</code> (the '''GNU Compiler Collection''').
The following sub-directories are present within the <code>scripts</code> directory:
* <code>dev</code> &mdash: contains scripts for setting up '''Development''' environment;
* <code>prod-sl6</code> &mdash: contains scripts for setting up '''Production''' environment on SL6 machines;
* <code>prod-slc6</code> &mdash: contains scripts for setting up '''Production''' environment on SLC5 machines;
* <code>shared</code> &mdash; shared scripts used in the setup of all environments (see below);
* <code>old</code> &mdash; legacy scripts used in previous environment setup on SLC5.
The first 3 directories contain scripts that are almost identical, with small modifications to suit each environment. 
Along with the shared scripts, these are described below: substitute <code>xxx</code> for the particular environment.
=== <code>/unix/pbt/software/scripts/xxx/pbt-xxx.sh</code> ===
The 3 <code>pbt-xxx.sh</code> scripts carry out the majority of the customisation for the particular environment. 
In particular, the following tasks are carried out:
# Add locations to path variables;
# Define colours for scripts, prompt, etc.;
# Add locations to path variables and remove duplicates (calls <code>setpaths.sh</code> script);
# Check versions of installed software and display results (calls <code>checkversions.sh</code> script);
# Run Geant4 setup script;
These scripts in turn make use of the following shared scripts.
=== <code>/unix/pbt/software/scripts/shared/definecolours.sh</code> ===
This script defines various variables to represent colours for printing to the terminal and to file.
=== <code>/unix/pbt/software/scripts/shared/setpaths.sh</code> ===
This script sets the various <code>PATH</code> environment variables required for the specific environment and removes any duplicates.
=== <code>/unix/pbt/software/scripts/shared/checkversions.sh</code> ===
This script checks the versions (and optionally the paths/locations) of important software packages used in the PBT environment. 
== Installations ==
For each software package, the installation information is listed below.
The basic method used is as follows:
# Download the source tarball latest version to the <code>/unix/pbt/software/src</code> folder.
# Extract the tarball to a subfolder within the <code>src</code> folder using <code>tar -xvzf &lt;filename&gt;.tar.gz</code>.
# Create a build folder at <code>/unix/pbt/software/build</code> and set the working directory here.
# Run the specific configure, build and install steps for the package.
# Remove the build folder and extracted source folder, but keep the source tarball.
The configure, build and install steps may be different for each package, and this is described per package below.
However, in most cases the steps follow the general steps below:
# Change working directory to the build folder.
# Run the configuration script from the source folder to set the build options, including the customised installation prefix.
# Build the code.
# Install the code to the sandbox folder.
# (Optional) Move the compiled code to the desired location (only possible if the installation prefix cannot be specified).


== Software Matrix ==
== Software Matrix ==
Line 46: Line 164:
|Yes
|Yes
|Lawrence
|Lawrence
|No
|Yes
|
|Simon
|
|Yes
|
|Lawrence
|-
|-
|'''cmake'''
|'''cmake'''
Line 68: Line 186:
|Yes
|Yes
|Simon
|Simon
|
|Yes
|Lawrence (checked v.3.1.1)
|Lawrence
|No
|Yes
|
|Simon
|
|Yes
|
|Lawrence
|-
|-
|'''CLHEP'''
|'''CLHEP'''
Line 82: Line 200:
|Yes
|Yes
|Lawrence
|Lawrence
|No
|Yes
|
|Lawrence
|
|Yes
|
|Lawrence
|-
|-
|'''simage'''
|'''simage'''
Line 92: Line 210:
|Yes
|Yes
|Simon
|Simon
|
|Yes
|
|Lawrence
|No
|Yes
|
|Simon
|
|Yes
|
|Lawrence
|-
|-
|'''Coin3d'''
|'''Coin3d'''
Line 104: Line 222:
|Yes
|Yes
|Simon
|Simon
|
|Yes
|
|Lawrence
|No
|Yes
|
|Simon
|
|Yes
|
|Lawrence
|-
|-
|'''SoQt'''
|'''SoQt'''
Line 116: Line 234:
|Yes
|Yes
|Simon
|Simon
|
|Yes
|
|Lawrence
|No  
|No  
|
|
Line 128: Line 246:
|Yes
|Yes
|Simon
|Simon
|
|Yes
|
|Lawrence
|No
|Yes
|
|Simon
|
|Yes
|
|Lawrence
|-
|-
|'''Geant4'''
|'''Geant4'''
|4.10.02.p01
|4.10.02.p01
|src/geant4/geant4.10.02.p01-source
|src/geant4/geant4.10.02.p01-source
|No
|Yes
|
|Lawrence
|
|Yes
|
|Lawrence
|No
|Yes
|
|Lawrence
|
|Yes
|
|Lawrence
|-
|-
|'''DAWN'''
|'''DAWN'''
Line 152: Line 270:
|Yes
|Yes
|Simon
|Simon
|Need to check on SL6 machine
|Yes
|Simon
|Simon
|Yes (can copy from dev)
|Yes (can copy from dev)
|Simon
|Simon
|
|Yes
|
|Roisin
|-
|-
|'''HepRApp'''
|'''HepRApp'''
Line 195: Line 313:
|Simon (Standalone executables)
|Simon (Standalone executables)
|}
|}
== Folder structure ==
=== Disk ===
There is a separate (large) disk for PBT work mounted on the Linux system at <code>/unix/pbt</code>. 
When running simulations, you should create a subdirectory with your <code>username</code> at <code>/unix/pbt/username</code>
=== Software ===
All software is enclosed in a folder at <code>/unix/pbt/software</code>.
=== Source code ===
Source code for building and installing software packages is kept in a separate folder at <code>/unix/pbt/software/src</code>.
== Environments ==
Two separate environments are provide for PBT simulations: the '''Production''' environment for general use and the '''Development''' environment for testing changes or updates to the code. 
The '''Production''' environment is further subdivided depending on whether the machine you are logged in to is running SLC5 or SL6: the SLC5 legacy environment features an older version of Geant4 and related software that will not be updated.
* The recommended '''Production''' environment for SL6 is stored in <code>/unix/pbt/software/prod-sl6</code>;
* The '''Development''' environment for SL6 is stored in <code>/unix/pbt/software/dev</code>: code is then subdivided into directories by application name;
* The legacy '''Production''' environment for SLC5 is stored in <code>/unix/pbt/software/prod</code>: this is only accessible for users running on SLC5 machines.
It is possible to select whether the '''Development''' or '''Production''' environment is launched under SL6 by adding the appropriate flags when calling the setup script (see [[#Scripts]] below).
== Scripts ==
Access to the PBT production and development environments is implemented by two scripts, <code>pbt.sh</code> and <code>pbt-dev.sh</code>.
These scripts are located in the <code>bin</code> folders of the production and development environments, respectively, and should be called directly by the user to set up all paths and environment variables required to make use of <code>Geant4</code> and related packages.
Aliases can be set up by the users to simplify running the scripts, such as:
<pre>
alias pbt='source /unix/pbt/software/prod/bin/pbt.sh'
alias pbt-dev='source /unix/pbt/software/dev/bin/pbt-dev.sh'
</pre>
Two other scripts are required as functions used by the setup scripts.
=== /unix/pbt/software/prod/bin/pbt.sh ===
This is a simple script that launches a new shell (using the Developer Toolset 2) and calls the setup script <code>pbt.bashrc</code>.
The Developer Toolset 2 (<code>devtoolset-2</code>) is a Linux software collection providing various tools for developers, most notably including a newer version of <code>GCC</code> (the '''GNU Compiler Collection''').
=== /unix/pbt/software/prod/bin/pbt.bashrc ===
This is a <code>bash</code> startup script that sets various environment variables and other settings so that all PBT software is available to use.
Steps taken:
# Run the user's own .bashrc
# Add locations to path variables
# Define colours for scripts, prompt, etc
# Greeting with information for users
# Notify user on exiting environment
# Modify prompt to show environment name
# Run <code>Geant4</code> setup script and set additional settings
# Remove duplicates from path variables
=== /unix/pbt/software/prod/bin/definecolours.sh ===
This script defines various variables to represent colours for printing to the terminal and to file.
=== /unix/pbt/software/prod/bin/checkversions.sh ===
This script checks the versions (and optionally the paths/locations) of important software packages used in the PBT environment.
== Installations ==
For each software package, the installation information is listed below.
The basic method used is as follows:
# Download the source tarball latest version to the <code>/unix/pbt/software/src</code> folder.
# Extract the tarball to a subfolder within the <code>src</code> folder using <code>tar -xvzf &lt;filename&gt;.tar.gz</code>.
# Create a build folder at <code>/unix/pbt/software/build</code> and set the working directory here.
# Run the specific configure, build and install steps for the package.
# Remove the build folder and extracted source folder, but keep the source tarball.
The configure, build and install steps may be different for each package, and this is described per package below.
However, in most cases the steps follow the general steps below:
# Change working directory to the build folder.
# Run the configuration script from the source folder to set the build options, including the customised installation prefix.
# Build the code.
# Install the code to the sandbox folder.
# (Optional) Move the compiled code to the desired location (only possible if the installation prefix cannot be specified).
== Current Status Of Installations ==
Put in details on debugging and troubleshooting here...

Revision as of 12:06, 24 June 2016

Introduction

The UCL HEP Linux Cluster consists of a range of machines running Scientific Linux (CERN) 5 and Scientific Linux 6. This cluster provides a pre-compiled installation of Geant4 along with an environment for compiling code, running examples and viewing results.

Although there are over 100 individual machines that can be used — most of which are the individual Linux desktop PCs within the HEP group running SL6 — access from outside the HEP group subnet is only possible through the central Linux server, plus1, via ssh:

$ ssh -Y username@plus1.hep.ucl.ac.uk

It is then possible to connect to individual Linux desktops, again by ssh. In order to do so, you will need to know the number of the PC you are connecting to:

$ ssh -Y username@pc1XX.hep.ucl.ac.uk

...where 1XX is the number of the PC you wish to connect to.

In order to access these machines, you will need to obtain an account from the UCL HEP Group Computing Support. Please contact Dr. Simon Jolly for instructions on obtaining an account.

Folder structure

Disk

There is a separate (large) disk for PBT work mounted on the Linux system at /unix/pbt. When running simulations, you should create a subdirectory with your username at /unix/pbt/username

Software

All software is enclosed in a folder at /unix/pbt/software.

Source code

Source code for building and installing software packages is kept in a separate folder at /unix/pbt/software/src.

Environments

Two separate environments are provide for PBT simulations: the Production environment for general use and the Development environment for testing changes or updates to the code. The Production environment is further subdivided depending on whether the machine you are logged in to is running SLC5 or SL6: the SLC5 legacy environment features an older version of Geant4 and related software that will not be updated.

  • The recommended Production environment for SL6 is stored in /unix/pbt/software/prod-sl6;
  • The Development environment for SL6 is stored in /unix/pbt/software/dev: code is then subdivided into directories by application name;
  • The legacy Production environment for SLC5 is stored in /unix/pbt/software/prod: this is only accessible for users running on SLC5 machines.

It is possible to select whether the Development or Production environment is launched under SL6 by adding the appropriate flags when calling the setup script (see #Scripts below).

Scripts

Access to the PBT Production and Development environments is implemented by a single script, pbt.sh. This calls a number of other utility scripts that set up the required PBT environment: these are all stored in /unix/pbt/software/scripts/. The pbt.sh script is called in the following way:

source /unix/pbt/software/scripts/pbt.sh

This will auto-detect whether you are running on a newer SL6 machine or a legacy SLC5 machine and set up the environment accordingly.

The steps carried out during setup are as follows:

  1. Check the environment and whether the user wishes to run in verbose or development mode (see below);
  2. Launch a new bash shell with the appropriate Scientific Linux Developer Toolset (see below);
  3. Call the appropriate bashrc script to begin environment setup; this in turn runs the following actions:
    1. Run the user's own .bashrc;
    2. Set the environment name;
    3. Greeting with information for users;
    4. Define exit function with exit message when user exits environment;
    5. Call shell script to set up environment.
  4. The specific shell script then carries out the following actions:
    1. Set specific environment variables with locations of compiler, Geant4 etc.
    2. Add locations to path variables and remove duplicates (calls setpaths.sh script);
    3. Define colours for scripts, prompt, etc (calls definecolours.sh script);
    4. Check versions of installed software and display results (calls checkversions.sh script);
    5. Modify prompt to show environment name;
    6. Run Geant4 setup script and set additional settings;

Adding the -v flag enables the scripts to run in verbose mode, which displays the full paths when checking the versions of the installed software. Adding the -d flag enables the Development environment to allow new software to be built without changing the Production setup needed by most users: this is only available on SL6 machines.

When pbt.sh is called, its first action after selecting the right environment is to launch a new bash shell that provides a degree of isolation for setting up the desired PBT environment. Once the user has finished with the PBT environment, exiting the shell will deposit the user back into their previous environment. Launching a new shell also provides access to the correct Scientific Linux Developer Toolset: on SL6 this is devtoolset-3, whereas SLC5 uses the older devtoolset-2. In either case, the Developer Toolset is a Linux software collection providing various tools for developers, including more up-to-date versions of software required by Geant4, most notably including a newer version of GCC (the GNU Compiler Collection).

The following sub-directories are present within the scripts directory:

  • dev &mdash: contains scripts for setting up Development environment;
  • prod-sl6 &mdash: contains scripts for setting up Production environment on SL6 machines;
  • prod-slc6 &mdash: contains scripts for setting up Production environment on SLC5 machines;
  • shared — shared scripts used in the setup of all environments (see below);
  • old — legacy scripts used in previous environment setup on SLC5.

The first 3 directories contain scripts that are almost identical, with small modifications to suit each environment. Along with the shared scripts, these are described below: substitute xxx for the particular environment.

/unix/pbt/software/scripts/xxx/pbt-xxx.sh

The 3 pbt-xxx.sh scripts carry out the majority of the customisation for the particular environment. In particular, the following tasks are carried out:

  1. Add locations to path variables;
  2. Define colours for scripts, prompt, etc.;
  3. Add locations to path variables and remove duplicates (calls setpaths.sh script);
  4. Check versions of installed software and display results (calls checkversions.sh script);
  5. Run Geant4 setup script;

These scripts in turn make use of the following shared scripts.

/unix/pbt/software/scripts/shared/definecolours.sh

This script defines various variables to represent colours for printing to the terminal and to file.

/unix/pbt/software/scripts/shared/setpaths.sh

This script sets the various PATH environment variables required for the specific environment and removes any duplicates.

/unix/pbt/software/scripts/shared/checkversions.sh

This script checks the versions (and optionally the paths/locations) of important software packages used in the PBT environment.

Installations

For each software package, the installation information is listed below. The basic method used is as follows:

  1. Download the source tarball latest version to the /unix/pbt/software/src folder.
  2. Extract the tarball to a subfolder within the src folder using tar -xvzf <filename>.tar.gz.
  3. Create a build folder at /unix/pbt/software/build and set the working directory here.
  4. Run the specific configure, build and install steps for the package.
  5. Remove the build folder and extracted source folder, but keep the source tarball.

The configure, build and install steps may be different for each package, and this is described per package below. However, in most cases the steps follow the general steps below:

  1. Change working directory to the build folder.
  2. Run the configuration script from the source folder to set the build options, including the customised installation prefix.
  3. Build the code.
  4. Install the code to the sandbox folder.
  5. (Optional) Move the compiled code to the desired location (only possible if the installation prefix cannot be specified).

Software Matrix

The following software is installed on the HEP Linux cluster (SL6 machines only).

Software Version Source code Installed in dev? Installed by Working? Checked by Installed in prod? Installed by Working? Checked by
Qt 5.5.1 src/geant4-prerequisites/qt/qt-5.5.1 Yes Simon Yes Lawrence Yes Simon Yes Lawrence
cmake 3.5.2 src/geant4-prerequisites/cmake Yes Static binaries (Simon) Yes Lawrence Yes Static binaries (Simon) Yes Lawrence
xerces-c 3.1.3 src/geant4-prerequisites/xerces-c Yes Simon Yes Lawrence Yes Simon Yes Lawrence
CLHEP 2.3.1.1 src/geant4-prerequisites/clhep Yes Lawrence Yes Lawrence Yes Lawrence Yes Lawrence
simage 1.7.0 src/geant4-prerequisites/coin3d Yes Simon Yes Lawrence Yes Simon Yes Lawrence
Coin3d 3.1.3 src/geant4-prerequisites/coin3d Yes Simon Yes Lawrence Yes Simon Yes Lawrence
SoQt 1.5.0 src/geant4-prerequisites/coin3d Yes Simon Yes Lawrence No
SoXt 1.3.0 src/geant4-prerequisites/coin3d Yes Simon Yes Lawrence Yes Simon Yes Lawrence
Geant4 4.10.02.p01 src/geant4/geant4.10.02.p01-source Yes Lawrence Yes Lawrence Yes Lawrence Yes Lawrence
DAWN 3.90b src/geant4-addons/dawn Yes Simon Yes Simon Yes (can copy from dev) Simon Yes Roisin
HepRApp 3.15.4 src/geant4-addons/heprapp Yes Simon Yes Simon (Standalone .jar file) Yes Simon Yes Simon (Standalone .jar file)
Java Analysis Studio 3.1.5 src/geant4-addons/jas Yes Simon Yes Simon (Standalone executables) Yes Simon Yes Simon (Standalone executables)
gMocren 4 src/geant4-addons/gmocren Yes Simon Unknown Simon (Standalone executables) Yes Simon Unknown Simon (Standalone executables)