Versions Compared

Old Version 1

changes.mady.by.user Jeremy McCormick

Saved on

compared with

New Version 2

changes.mady.by.user Jeremy McCormick

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

This guide provides a step-by-step walkthrough covering package and tool installation.

It presumes nothing except a working Windows machine (2000, XP) 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.

Standalone Windows Distribution

If you do not want to build SLIC yourself, there is a Windows executable available for download.

The current version is available as a ZIP file containing a static binary and the required DLLs.

Download the ZIP file using your browser and unzip the contents to C:. You should see the directory C:\slic_win32.

Test out the binary by running it in a console window.

  1. Start -> Run -> cmd.
  2. Press ENTER.
  3. Go to the SLIC directory.
    No Format
    
C:\
cd slic_win32
  4. Execute SLIC from the command line.
    No Format
    
slic

The Xerces and Cygwin DLLs are also included so that the package is standalone.

Preliminary Setup for Installation

Cygwin

The Cygwin Linux emulation package is a prerequisite for building on Windows.

Info

Unfortunately, the support for native WIN32 using project files is lacking.

These are brief instructions for installing the necessary Cygwin packages.

  1. Download the Cygwin setup program.
  2. Double-click on it and click Next.
  3. Select Install from Internet and click Next.
  4. Enter your preferred Root Directory and click Next.
  5. Enter your preferred Local Package Directory, which can be the same as the Root Directory, and then click Next.
  6. Select Direct Connection and click Next.
  7. Select a site from the Available Download Sites. Servers inside your country will probably be fastest. I use ftp://ftp.sunsite.utk.edu.
  8. Click Next.
  9. 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.
    1. Required packages.
      • Devel -> cvs
      • Devel -> gcc-core
      • Devel -> gcc-g++
      • Devel -> make
      • Base -> gzip
      • Base -> tar
    2. Tool for downloading package tarballs and zip files.
      • Web -> wget
  10. Click Next after you have selected the packages.
  11. 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.
  12. If desired, select Create icon on Desktop or Add icon to Start Menu, and click Finish.

If you need additional information on this installation process, Norman Graf has more detailed Cygwin installation instructions.

Testing the Cygwin Command Line Tools

  1. Select Start -> Programs -> Cygwin -> Cygwin Bash Shell
  2. Check that the following commands do not result in a command not found message.
    No Format
    
cvs
gcc
g++
tar
wget
make
  3. 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.
Warning

Throughout this guide, I assume you are using bash or at least another sh-compatible shell. I take no responsibility if you decide to use csh, tcsh, et al.

Work Area

The SLIC package and its dependencies will be installed into a common work area.

  1. From the Cygwin shell, create a work directory where you have a lot of space and go into it.
    No Format
    cd /cygdrive/c~
mkdir sim
cd sim
  2. Create the file setup.sh with the following contents.
    No Format
    #!/bin/sh
export sim_work=/cygdrive/c~/sim
  3. Source the script to setup the work dir.
    No Format
    source setup.sh

...

You are now ready to install the simulation packages.

Tip

The same Cygwin shell window should be used throughout the installation process in order to preserve the environment variables.

...

No Format
#!/bin/sh

# 1. work area
export sim_work=/cygdrive/c/work/nsim

# 2. java
export JAVA_HOME=/cygdrive/c/Java/jdk1.4.2
export JDK_HOME=${JAVA_HOME}
export PATH=${JAVA_HOME}/bin:${PATH}

# 3. clhep installation area
export CLHEP_BASE_DIR=${sim_work}/clhep

# 4. geant4
export G4INSTALL=${sim_work}/geant4/geant4.7.0.p01
export G4SYSTEM=WIN32-g++

# 5. LCPhys
export LCPHYS_BASE=${sim_work}/LCPhys

# 6. LCIO
export LCIO=${sim_work}/lcio
export LD_LIBRARY_PATH=$LCIO/tools:$LCIO/bin:$PATH

# 7. Xerces-C++ installation area
export XERCESCROOT=${sim_work}/xercesc
export PATH=$XERCESCROOT/bin:$PATH

# 8. GDML
export GDML_BASE=${sim_work}/GDML2/CPPGDML
export PLATFORM=cygwin_g++

# 9. LCDD
export LCDD_BASE=${sim_work}/lcdd

# 10. SLIC
export SLIC_BASE=${sim_work}/slic

...