Skip to content

building ssc

Dylan Harris edited this page Nov 25, 2020 · 13 revisions

Introduction

SSC can be built from the *nix command line or Visual Studio 2015/2017/2019.

The build subdirectory is recipe (a nod to Vernor Vinge) then tea (for builders' tea).

dependencies

Before you can build SSC, you must install and build the boost libraries. The minimum is version 1.71. You may find you have a copy installed on your system as a matter of course, or by using a common package installed. Alternatively, you can download it from the boost website, and follow the instructions there on how to build it.

environment variables

Both build systems need some environment variables set up:

  • SSCPATH which must point to the SSC root directory (the one containing recipe and the licence info)
  • BOOST which must point to the boost directory, the one containing the subdirectories boost and stage (created once boost is built). This may not be necessary if your systems has the boost libraries installed in the standard place, whatever that is.

windows

To build from Visual Studio, open the appropriate ssc.sln, and build. The community edition of Visual Studio 2019 is a free download. Note the 32 bit version is unsuitable for large sites.

Unix

SSC can be built using CMake version 3.11 or better. If it's not installed on your system, you should be able to grab it using your systems package installer. You'll also require a C++ 17 compiler, such as a recent version of gcc or clang. Unzip, then issue the following commands in the unzipped directory:

cmake .
make
ctest
make install

Note that some systems might require you to run gmake, not make. CMake will inform you if that's the case.

Currently, the executables are installed in the ssc root directory itself. Soon, I expect to modify the process to install the executable in /opt/local/bin, once I'm confident that this directory exists on most unix flavours.

Clone this wiki locally