Installation Instructions

This page explains how to install the tools required for creating Secondo on your computer. Currently supported operating systems are several Linux distributions and Mac OS variants. For just trying Secondo, you can also use the Secondo-Virtual-Machine-Appliance. The installation of Secondo itselfs is explained on the Sources page.

Installation for Specific Operating Systems

Secondo needs some tools for compiling the sources. Furthermore, some environment variables must be set. The easiest way to do so, is to run an operating system specific script (Linux) or to install the SDK (OS X). If you find your operating system listed here, just follow the instructions for your system.

Script-based Installation of the Secondo-SDK

Platform Installation Guide Additional Software Needed
Fedora 20 Fedora 20 Installation Guide Installation Script
SuSe 42.1 SuSe 42.1 Installation Guide Installation Script
SuSe 12.2 SuSe 12.2 Installation Guide Installation Script
SuSe 12.1 SuSe 12.1 Installation Guide Installation Script
SuSe 11.3 SuSe 11.3 Installation Guide  
Ubuntu 64 Bit (Binary Installation)
Ubuntu 14.04
Ubuntu 16.04
Ubuntu Installation Guide using apt-get
Ubuntu (Full Installation)
Ubuntu 16.04 Ubuntu 16.04 Installation Guide Installation Script
Ubuntu 15.04 Ubuntu 15.04 Installation Guide Installation Script
Ubuntu 14.04 Ubuntu 14.04 Installation Guide Installation Script
Ubuntu 12.04 Ubuntu 12.04 Installation Guide Installation Script
Ubuntu 11.10 Ubuntu 11.10 Installation Guide Installation Script
Ubuntu 10.04 LTS Secondo 3.0/XUbuntu 10.04 LTS Installation Guide  
Ubuntu 9.10 Secondo 3.0/Ubuntu 9.10 Installation Guide  
Ubuntu 8.04 LTS Ubuntu 8.04 Installation Guide Tool for Patching Secondo Versions
File .secondorc

Installation of the Secondo SDK on OS X platforms

System Installation Guide SDK Download Size Known to Work
(with recent Secondo version)
Known not to Work Last Change
Mac OS X El Capitan/Mavericks/Yosemite Guide SDK_OSX_EL_CAPITAN 125 MB 10.9 Mavericks
10.10 Yosemite
10.11 El Capitan
Mac OS X Lion Mac-OSX Lion Guide SDK_OSX_Lion 52 MB 10.7 Lion   2011-12-16
Mac OS X Mac-OSX Guide SDK_OSX 90 MB 10.4 Tiger
10.5 Leopard
10.6 Snow Leopard (from Nov. 2010)

Upgrading the OS X version

After an upgrade of the OS X operating system, the xcode developer tools have to be reinstalled. If you have upgraded you system and the call of make produces the following error message:
xcrun: error: invalid active developer path
then you have to reinstall the xcode developer tools. To do so, start a terminal and enter:
xcode-select --install
In the upcoming dialog, click on the button Installation and wait until the installation is finished. After that, the make process should run as before.

Manual Installation of the Required Tools

If your operating system is not listed above or you dont want to use the scripts for some other reason, it is possible to install the needed tools manually. All tools must be executable for each directory and some of the tools must be installed as developer versions. Moreover, some environment variables must be set for a successful compiling of Secondo.


Package edition Version Project Home Page
flex dev >2.5.33
bison dev >2.1
gcc /g++   >4.7
berkeley DB dev, c++ Interface >4.3.29
libjpeg dev 6.2
open jdk dev >7
readline dev >5.2
recode dev >3.6  
gmp dev    
ncurses dev    
xml2 dev    
boost dev    
swi-prolog dev    
jpl dev    
gsl dev    

Environment variables

The environment variables used by Secondo:
Variable Meaning Example Value(s)
SECONDO_BUILD_DIR Secondo's home directory /home/user/secondo
SECONDO_PLATFORM Operation system linux, linux64, max_osx
BDB_DIR Home of the berkeley db /home/user/BDB
BERKELEY_DB_DIR Home of the berkeley db /home/user/BDB
BERKELEY_DB_LIB Name of the berkeley db lib db_cxx
BDB_INCLUDE_DIR Include dir of berkeley db /home/user/BDB/include
BDB_LIB_DIR directory of the berkeley db lib /home/user/BDB/lib64
J2SDK_ROOT home of the jdk /usr/lib64/jvm/java-1.8.0-openjdk-1.8.0/
JAVAVER java version 1.8
SWI_HOME_DIR home of swi prolog /usr/lib64/swipl-7.2.2
PL_LIB_DIR home of swi prolog lib /usr/lib64/swipl-7.2.2/lib/x86_64-linux/
PL_DLL_DIR home of swi prolog lib /usr/lib64/swipl-7.2.2/lib/x86_64-linux/
PL_LIB name of prolog lib swipl
PL_INCLUDE_DIR prolog's include dir /usr/lib64/swipl-7.2.2/include
PL_VERSION prolog's version as a single number 72020
JPL_DLL path to JPL library /usr/lib64/swipl-7.2.2/lib/x86_64-linux//
JPL_JAR path to JPL java file /usr/lib64/swipl-7.2.2/lib/jpl.jar
readline should readline be used true, false
SECONDO_CONFIG path to Secondo's config file /home/user/secondo/bin/SecondoConfig.ini
PD_HEADER path to PD header file /home/user/secondo/Tools/pd/pd_header_listing

Moreover, some variables should be extended as follows:
export PATH=.:$BDB_DIR/bin:$PATH:$SECONDO_BUILD_DIR/Tools/pd
Last Changed: 2016-09-26