The SLIC detector simulation package requires the setup of 7 different pieces of software. This guide is intended as a step-by-step walkthrough of installing all these packages from scratch in the Windows Cygwin environment.
It presumes nothing except a working Windows machine with internet access. Therefore, you may only need to use parts of this installation guide if you have some of the external dependencies already installed.
Preliminaries
Cygwin
- Download www.cygwin.com/setup.exe from the www.cygwin.com.
- Double-click on it.
- Click Next.
- Select Install from Internet.
- Click Next.
- Enter your preferred Root Directory.
- Click Next.
- Enter your preferred Local Package Directory, which can be the same as the Root Directory.
- Click Next.
- Select Direct Connection if it is not already.
- Click Next.
- Select a site from the Available Download Sites. Servers inside your country will probably be fastest. I use ftp://ftp.sunsite.utk.edu.
- Click Next.
- In the Cygwin Setup - Select Packages window, you need to make sure that the following tools are selected by clicking in the corresponding box under the New column until you see a version number.
- Required packages.
- Devel -> cvs
- Devel -> gcc-core
- Devel -> gcc-g++
- Devel -> make
- Base -> gzip
- Base -> tar
- Tool for downloading package tarballs and zip files.
- If you want to use Geant4's OpenGL drivers, you need to install X Windows, too. I believe these two packages should give you all the required X11 dependencies.
- X11 -> xorg-x11-base
- X11 -> xorg-x11-xwin
- Click Next after you have selected the packages.
- Cygwin will now automatically download and install all the selected packages. It might take awhile, so now is the time to go get some coffee.
- If desired, select Create icon on Desktop or Add icon to Start Menu.
- Click Finish.
Testing the Cygwin Command Line Tools
- Select Start Menu -> Cygwin -> Cygwin Bash Shell
- Check that the following commands do not result in a command not found message.
- cvs
- gcc
- g++
- tar
- wget
- make
- If a command was not found, rerun the Cygwin setup to select the missing package, making sure to select Keep on the Cygwin Setup - Select Packages screen so that all the packages are not reinstalled.
Work Area
We will install all packages into a common work area.
- From the Cygwin shell, create a work directory for SLIC and its external dependencies.
cd /cygdrive/c
mkdir sim
cd sim
|
- Create the file setup.sh with the following contents. (We will be adding to this file as the installation proceeds.)
#!/bin/sh
export sim_work=/cygdrive/c/sim
|
- Source the script to setup the work dir.
Java
Java is required for installing LCIO.
- Install an appropriate JDK from http://java.sun.com/ with a minimum version of 1.4.2.
- In your setup.sh, set JAVA_HOME and JDK_HOME to the Java installation area.
export JAVA_HOME=/cygdrive/c/java/jdk1.4.2/
export JDK_HOME=${JAVA_HOME}
|
The above JAVA_HOME location is an example only. You need to replace it with the correct path to your JDK. |
Proceed!
You are now ready to begin the package installations.
Leave your Cygwin window open, as you will be using it throughout the installation. |
Package Installations
CLHEP
There are installation instructions for version 1.9 and up http://wwwasd.web.cern.ch/wwwasd/lhc++/clhep/INSTALLATION/newCLHEP-install.html.
But you should not need them to setup the package.
- Create a working directory for CLHEP and go into it.
- Download the CLHEP tarball.
wget http://cern.ch/clhep/clhep-1.9.2.0.tgz
|
- Unzip to your work directory.
tar zxvf clhep-1.9.2.0.tgz
|
- Change to CLHEP directory.
- Run configure. (Takes a long time!)
./configure --prefix=`cd ../..; pwd` --disable-shared
|
- Build the library and install it. (Also takes a long time!)
- Add the following to $sim_work/setup.sh
export CLHEP_BASE_DIR=$sim_work/clhep
|
Now that the CLHEP dependency is satisfied, you should be able to install Geant4.
Geant4
Geant4 is probably the most difficult application to install of SLIC's dependencies, because there are a lot of options. I will describe a minimal installation procedure with OpenGL support. You can always update the libraries later if you decide to change these settings.
- Return to the work dir, create a Geant4 work subdir and go into it.
cd $sim_work
mkdir geant4
cd geant4
|
- Download the Geant4 tarball.
wget http://geant4.cern.ch/geant4/source/source/geant4.7.0.p01.tar.gz
|
- Unzip it.
tar zxvf geant4.7.0.p01.tar.gz
|
- Setting the following variables in $sim_work/setup.sh should allow you to compile without running the ./Configure script.
G4INSTALL=${sim_wrk}/geant4/geant4.7.0.p01
G4SYSTEM=WIN32-g++
OGLHOME=/usr/X11R6
|
- Go into the Geant4 install dir.
- Build the libraries. These will be placed at $G4INSTALL/lib/WIN32-g++. (Maybe you should let this run overnight!)
- Build the physics list libraries. These will go into $G4INSTALL/lib/plists/WIN32-g++.
cd ../physics_lists/hadronic
make
cd ../electromagnetic
make
|
The default Geant4 library settings for WIN32 are global and static. You may choose other settings, but this could require changes in installation settings "down the line" that I may not mention. |
LCPhys
LCIO
Xerces
GDML
LCDD
SLIC
Additional Resources