GENESIS: Documentation

Related Documentation:
GENESIS System

Developer Installation Ubuntu (Lenny/Sid)

Installing GENESIS on Ubuntu requires executing the following major steps. Note: Installation requires administrator privileges.

• Prepare and upgrade the system software.
• Download and install the DeveloperPackage.
• Install the software packages.
• Check if the installation was successful.

Prepare and upgrade the system software

• Install the following packages using the System -> Administration -> Synaptic Package Manager menu.
  • perl-CPAN (only required to run tests, see below)
  • libyaml-perl
  • libexpect-perl (and its dependency perl-IO)
  • libinline-perl
  • autoconf
  • automake
  • libc6-dev
  • libncurses5-dev
  • flex
  • bison
  • libperl-dev
  • patch
  • python-dev
  • python-yaml
  • swig
  • libreadline5-dev
  • libclone-perl
  • libterm-readline-gnu-perl
  • libxml-simple-perl
• monotone-0.44 (available as a statically linked binary from http://monotone.ca/)
• Install the dependencies for running tests:
  • perl -MCPAN -e “install Test::More”
  • perl -MCPAN -e “install Clone”
  • perl -MCPAN -e “install Data::Utilities”
  • perl -MCPAN -e “install File::Find::Rule”
  • perl -MCPAN -e “install Digest::SHA”

  Note: The running of tests is optional, but strongly advised.

Download and Install the DeveloperPackage

1. Download the latest version of the DeveloperPackage, available from Sourceforge. It is called developer-release-label.tar.gz, where release-label is the current release identifier.
2. Change to the directory where you downloaded the file.
3. Unpack the archive by typing “tar xfz developer-release-label.tar.gz”.
4. Change to the directory with the content of the archive by typing “cd developer-release-label”.
5. Configure by typing “./configure”.
6. Compile by typing “make”.
7. Install by typing “make install”.

Install software packages

1. Use the installer script to create the correct directory layout by typing “neurospaces_create_directories”.
2. Pull the archives of the source code by typing “neurospaces_pull”.
3. Update the source code in the working directories by typing “neurospaces_update”.
4. Generate make files by typing “neurospaces_configure”.
5. Compile and install the software by typing “neurospaces_install”.

Check if the installation was successful

This step is optional but strongly advised.

• Run tests of all the packages and save tester output to a file by typing “neurospaces_check >/tmp/check.out 2>&1”.
• Check the output by typing “less /tmp/check.out”. Importantly, search for lines containing the string error_count.