LinuxInstall

From KratosWiki
Revision as of 16:51, 30 October 2012 by Maceli (Talk | contribs)
Jump to: navigation, search

Contents

install Kratos the easy way

If you are a lucky owner of a ubuntu-based linux machine, than you can directly install a .deb file. Such package ( Download ) automatically installs the Kratos together with all of the libraries necessary for its correct usage and leaves the system ready for being used.

compile your own version of the Kratos

Developers, users of non-ubuntu machines and sudoers are expected to download and compile the source files.


This tutorial assumes that a reasonably modern distribution is being used. Older versions may require compiling some of the files "by hand"


All of the kratos installation is based on the use of "cmake" for which a modern version is needed.

Since "cmake" is continuosly being improved we advice the user to get and install the most modern version.

You can follow an installation guide here InstallCmake.


Once the cmake is installed, one should proceed to the installation of the prerequisites, that is, of the libraries that are not part of the Kratos but that are needed for its compilation.

The installation of such prerequisites is described at Install Kratos Prerequisites.


At this point we are finally ready to install the Kratos. Let's assume that we are in the current user's home directory:

  $HOME/

We shall first of all get a clean version by downloading from the repository

  mkdir kratos
  cd kratos
  svn checkout https://svn.cimne.upc.edu/p/kratos/kratos .

we can finally proceed to the compilation of the files. The idea is that each user can write a configuration file and activate or deactivate the applications to be included.

In order to simplify the compilation an example configuration file is provided in the directory "cmake_build".

The user is expected to make a copy of the example file and to change it according to his needs

  cd cmake_build
  cp example_configure.sh.do_not_touch configure.sh

now it is possible to edit the configuration file to modify it as needed. Applications are activated by setting them to ON and deactivated by setting them to OFF.

while the current configuration is designed to work "out-of-the-box" on ubuntu, on other systems one may be required to tell the cmake the position of the libraries. The file README included in the cmake_build directory attempts to cover the common cases.

Once this is done we can proceed to the compilation by doing

  sh configure.sh

which, if completed correctly, is expected to compile the kratos and install it in the directory where it was downloaded, that is

  $HOME/kratos


In order to be able to use the Kratos we need now to tell to the system's python installation where to find the Kratos libraries. This can be done by setting the environment variable PYTHONPATH

by appending the Kratos installation directory to the existing path information by typing:

  echo "export PYTHONPATH=\$HOME/kratos:\$PYTHONPATH" >> $HOME/.bashrc

The previous shell command adds one line at the end of the file '.bashrc', located in your home folder.

prescribing a different installation path

The cmake provides the possibility of prescribing a different installation path for Kratos

this can be done for example by adding the line

  -DKRATOS_INSTALL_PREFIX="/path/to/my/kratos/installation" \
  -DINSTALL_PYTHON_FILES=ON \

to your "configure.sh", so to instruct to install the Kratos in the specified directory.

Warn_icon.gif Warning. Please, note that:

  • Cmake requires all definitions in a single line! The line concatenation character '\' therefore MUST NOT be followed by any whitespace in the same line as this would prevent the cmake from running the lines below

Of course, if this is done, the PYTHONPATH environment variable should be modified accordingly (for example as)

  export PYTHONPATH=/path/to/my/kratos/installation/:$PYTHONPATH


Preparing a deb package

Kratos can be configured to generate deb packages. In order to do this, the installation directory has to be set to "/opt/kratos" by adding

  -DKRATOS_INSTALL_PREFIX="/opt/kratos" \
  -DINSTALL_PYTHON_FILES=ON \

to our "configure.sh" configuration file.

The debian package is then generated by:

   make package
Personal tools
Categories