34. Installation

See the download pages   ⁸⁸  for information related to installation.

34.1 Debian

SiSU is developed on Debian, and packages are available for Debian that take care of the dependencies encountered on installation.

The package is divided into the following components:

*sisu*, the base code, (the main package on which the others depend), without any dependencies other than ruby (and for convenience the ruby webrick web server), this generates a number of types of output on its own, other packages provide additional functionality, and have their dependencies

*sisu-complete*, a dummy package that installs the whole of greater sisu as described below, apart from sisu-examples

*sisu-pdf*, dependencies used by sisu to produce pdf from LaTeX generated

*sisu-postgresql*, dependencies used by sisu to populate postgresql database (further configuration is necessary)

*sisu-remote*, dependencies used to place sisu output on a remote server (further configuration is necessary)

*sisu-sqlite*, dependencies used by sisu to populate sqlite database

*sisu-markup-samples*, sisu markup samples and other miscellany (under Debian Free Software Guidelines non-free)

SiSU is available off Debian Unstable and Testing   ⁸⁹  install it using apt-get, aptitude or alternative Debian install tools. SiSU is currently comprised of eight packages.

Initial packaging is done here and to get the latest version of SiSU available you may add the following line(s) to your sources list:

  #/etc/apt/sources.list

  deb http://www.jus.uio.no/sisu/archive unstable main non-free
  deb-src http://www.jus.uio.no/sisu/archive unstable main non-free

The non-free section is for sisu markup samples provided, which contain authored works the substantive text of which cannot be changed, and which as a result do not meet the debian free software guidelines.

On Debian there is little more to know beyond how to install software on Debian using apt, aptitude or synaptic.

  #Using aptitude:

    aptitude update

    aptitude install sisu-complete sisu-markup-samples

  Using apt-get

    apt-get update

    apt get install sisu-complete sisu-examples

34.2 Other Unix / Linux

A source tarball or an rpms built using alien are available, (however dependencies have not been tested). SiSU is first packaged and tested with dependency handling for Debian.   ⁹⁰  Information on dependencies configured for Debian is provided as this may be of assistance.

34.2.1 source tarball

installation with provided install script

To install SiSU, in the root directory of the unpacked SiSU as root type:  ⁹¹ 

ruby install

Once installed see man 8 sisu for information on additional programs that sisu makes use of.

Further notes on install script.

The install script is prepared using Rant, and a Rantfile is provided,  ⁹²  with more comprehensive install options, and post install and setup configuration and generation of first test file, if you have installed Stefan Lang's Rant   ⁹³  installed. While in the package directory, type: rant help, or rant -T, or to install SiSU as root, type:

*install* is an install script prepared using Stefan Lang's Rant   ⁹⁴  It should work whether you have previously installed Rant or not. It has fairly comprehensive install options, and can do some post install and setup configuration and generation of first test file. For options type:

ruby install -T

To install as root type:

ruby install

For a minimal install type:

ruby install base

installation with setup.rb

setup.rb   ⁹⁵  is provided the package and will install SiSU  ⁹⁶  installation is a 3 step process  ⁹⁷  the following string assumes you are in the package directory and that you have root as sudo:

ruby setup.rb config && ruby setup.rb setup && sudo ruby setup.rb install

installation of rpm

The RPM is generated from the source file using Alien.  ⁹⁸  Dependencies are not handled, not even that of the essential Ruby.