...
This will create the log files configure.log and build.log, which might be useful if your build fails.
Testing the Build
Try executing this script when the build completes.
No Format |
---|
./scripts/slic.sh
|
If there is an error running the slic binary using this script, then check your build logs (starting at the top) for error messages.
Starting a Clean Build
To cleanup an existing build and start a new one from scratch, execute these commands in the SimDist directory.
No Format |
---|
make distclean
./configure [options]
|
This should remove all package binaries and return the project to a clean state. The build can then be executed in the normal fashion.
Creating a Tarball
The slic package includes a target for creating a .tar.gz file containing the slic binary and its runtime dependencies.
No Format |
---|
make dist
|
The tarball will be named based on the slic and Geant4 versions and your platform. It will appear one directory below your SimDist directory.
Configure Script
Simdist uses a configure script generated by Autoconf. This script only accepts a few options, as the slic binary has a standard set of external dependencies, none of which are optional.
...
The arguments listed under "Fine tuning" and "Optional Packages" are generally not supported. For instance, you cannot disable individual packages, as they are all required. Also, the "influential environment variables" are generally ignored by SimDist, as each package has a different set of compiler arguments.
Disabling Geant4 Visualization
Sometimes it may be useful to disable Geant4 visualization entirely, as at has many dependencies that may not all be present on your host system. Execute this command from the SimDist directory to disable Geant4 visualization.
...
This should set the variable G4VIS_NONE to 1 in the Geant4 environment configuration file at packages/geant4/env.gmk.
Testing the Build
Try executing this script when the build completes.
No Format |
---|
./scripts/slic.sh
|
If there is an error running the slic binary using this script, then check your build logs (starting at the top) for error messages.
Starting a Clean Build
To cleanup an existing build and start a new one from scratch, execute these commands in the SimDist directory.
No Format |
---|
make distclean
./configure [options]
|
This should remove all package binaries and return the project to a clean state. The build can then be executed in the normal fashion.
Creating a Tarball
The slic package includes a target for creating a .tar.gz file containing the slic binary and its runtime dependencies.
No Format |
---|
make dist
|
The tarball will be named based on the slic and Geant4 versions and your platform. It will appear one directory below your SimDist directory.
Troubleshooting Common Build Problems
...