Navigation: Home | Downloads | Getting SST | Documentation | Support
SST is an open source, cross platform simulation platform that provides a framework to connect multiple simulated hardware objects including CPUs, network, memory, etc. Simulations using the toolkit can be run either single node, or run on multiple nodes via MPI. The toolkit provides a parallel discrete event core as well as several programming interfaces including classes to manage random number generation, statistics handling, simulation output and efficient memory pooling for simulation events. The most recent performance evaluation has shown that SST can scale to simulate beyond 1.5M objects and operate efficiently on simulations up to 128 dual-processor nodes.
This quick start guide is intended to get the user up and running with SST as quickly as possible. It is intended for users with intermediate knowledge in the operation of Unix/Linux/OSX environments.
It is strongly recommend that new users refer to the Detailed SST Build and Install Instructions when building SST for the first time.
The SST 13.0.x Release Notes identify what operating systems, compiler and external component combinations have been tested and proven to work with this version of SST.
NOTE: Using combinations other than what is identified in the Release Notes may cause build failures and/or unexpected results.
A detailed list of elements provided with the SST distribution are available at SST Element Summary and SST Element Release Matrix.
If you encounter difficulties, refer to the Detailed SST Build and Install Instructions or go to the SST Support page
NOTE: SST has many configuration options and optional dependencies which, combined, can make building error prone. It is STRONGLY recommended that new users follow the detailed description of how to build SST and its external component dependancies referenced at Detailed SST Build and Install Instructions.
SST has a number of external components that are required to be installed on the users machine before building SST. These components are identified in the Release Notes.
Obtain SST-Core 13.0.x and SST-Elements 13.0.x tarfiles from the SST Downloads Page
Extract each tarfile to a unique development directory (i.e. $HOME/mysst/sst-core and $HOME/mysst/sst-elements).
$ cd $HOME/mysst/sst-core
$ ./configure <configure options defined below>
$ make
$ make install
$ cd $HOME/mysst/sst-elements
$ ./configure <configure options defined below>
$ make
$ make install
$ sst --version
$ sst-test-core
$ sst-test-elements (NOTE: This will take a long time to run. Try 'sst-test-elements -w "*simpleComponents*"' for a shorter test.)
All available configuration options for SST-Core can be displayed using $ ./configure –help
Some commonly used options for SST-Core are:
--prefix=<Install path>
- Sets the installation directory for SST-Core.CC=<Path to C compiler>
CXX=<Path to C++ compiler>
MPICC=<Path to MPIC compiler>
MPICXX=<Path to MPIC++ compiler>
An Example SST-Core configuration:
$ ./configure --prefix=$HOME/local/sstcore-13.0.0
CC=`which gcc` CXX=`which g++` MPICC=`which mpicc` MPICXX=`which mpicxx`
All available configuration options for SST-Elements can be displayed using $ ./configure –help
Some commonly used options for SST-Elements are:
--prefix=<Install path>
- Sets the installation directory for SST-Elements.--with-sst-core=<Path to SST-Core Installation>
- Identifies where the SST-Core is installed.An Example SST-Elements configuration:
$ ./configure --prefix=$HOME/local/sstelements-13.0.0
--with-sst-core=$HOME/local/sstcore-13.0.0
$ ./configure --with-<component name>
parameter.
If a new element (or new files) is added to the source code, it will be necessary to completely rebuild the configuration script (autogen.sh then configure) to add the new element into the build system.
git clone -b devel https://github.com/sstsimulator/sst-core.git
git clone -b devel https://github.com/sstsimulator/sst-elements.git
$ ./autogen.sh
before running the configure file.Additional information on running and creating components for SST may be found at sst-simulator.org