NOTE: You do not need to build ssphys unless you want to hack on the code, you need features which have been committed but are not yet in a release or nightly build, or you want to run the migration on Linux. Otherwise, simply download the latest release or nightly zipfile.

Build ssphys on Linux

Prerequisites

• On Debian-based systems (below is from Ubuntu 8.04) you'll need:

  sudo apt-get install build-essential g++ libtool automake autoconf libboost-program-options-dev libboost-filesystem-dev
  

• On Gentoo, boost can be built and installed with the following command:

  emerge boost
  

• Warning ssphys is not 64-bit safe. If you build on a 64-bit machine it will fail with "unrecognized file". See this thread and this thread.

Build

cd ssphys
./runauto.sh && ./configure && make

Build ssphys on Windows

Prerequisites

• VS2005
• boost (>1.33) from www.boost.org
• SubWCRev.exe from TortoiseSvn (http://tortoisesvn.tigris.org/)

Build ssphys

Build boost

1. Get Boost from http://www.boost.org/ (boost_1_33_1.zip) You also need boost-jam to build (boost-jam-3.1.13-1-ntx86.zip) You can get the windows installer, so You wouldn't need to build the boost. But I am a little bit paranoid about the ability of installers to uninstall, so I took the harder way.
2. Unpack boost.
3. Unpack boost-jam into boost directory %PATH% or into the Boost directory.
4. Open command prompt (cmd.exe) and navigate to the boost directory. Execute "bjam -sTOOLS=vc-8_0 stage" to build, if you want to use VS2005 C++ to build. For other compilers, consult Boost/more/getting_started.html instructions.
5. Go and grab cup of coffe. Boost build takes quite long time.
6. Open VS2005 and navigate to "Tools->Options->Projects and Solutions->vc++ Directories"
7. Add the complete "boost" path of your boost installation to the "Include Files" section
8. Add the complete "stage\lib" path of your boost installation to the "Library Files" section

Get ssphys

1. Checkout ssphys from pumacode

   svn checkout http://svn.pumacode.org/repos/vss2svn/trunk/ssphys ssphys
   

Build ssphys

1. Open ssphys.sln in VS2005
2. In the solution explorer check whether the ssphys project is written in bold (== Startup Project)
3. Select the "Debug" or "Release" configuration
4. Build the solution.

If you come across a failure like

Performing Custom Build Step on ..\version.in
Der Befehl "SubWCRev" ist entweder falsch geschrieben oderkonnte nicht gefunden werden.
Project : error PRJ0019: A tool returned an error code from "Performing Custom Build Step on ..\version.in"
Build log was saved at "file://f:\src\vss2svn\vss2svn\ssphys\tmp\ssphys\Debug\BuildLog.htm"
ssphys - 1 error(s), 0 warning(s)

you probably don't have setup your PATH environment variable to point to the installation of TortoiseSvn's bin directory, or you don't want to do this. Please note also, that you need to restart VS2005 if you have changed the environment while VS2005 was running.

If you don't want to use the SubWCRev function you can do the following:

1. Navigate to ssphys/version.in in solution explorer, open proeprties and set "Exclude from build" to YES
2. Open explorer and copy that "version.in" to "version.h" in same folder.
3. Open that file and apply some creativity in changing $xxx$ with appropriate values.