% SiSU insert 2.0

@title: SiSU
 :subtitle: Installation

@creator:
 :author: Amissah, Ralph

@date:
 :published: 2007-09-16
 :created: 2002-11-12
 :issued: 2002-11-12
 :available: 2002-11-12
 :modified: 2011-02-07

@rights:
 :copyright: Copyright (C) Ralph Amissah 2007
 :license: GPL 3 (part of SiSU documentation)

:A~? SiSU Installation notes

:C~ Installation

1~installation Installation

See the {~^ download pages }http://www.jus.uio.no/sisu/SiSU/download.html for information related to installation.

2~ 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:

_1 *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

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

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

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

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

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

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

SiSU is available off { Debian Unstable and Testing }http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&subword=1&version=all&release=all&keywords=sisu&sourceid=mozilla-search ~{ http://packages.qa.debian.org/s/sisu.html }~ install it using apt-get, aptitude or alternative Debian install tools. SiSU is currently comprised of eight packages. *~apt-get

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: *~sources.list

code{

#/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

}code

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.

code{

#Using aptitude:

  aptitude update

  aptitude install sisu-complete sisu-markup-samples

}code

code{

Using apt-get

  apt-get update

  apt get install sisu-complete sisu-examples

}code

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.~{ Notes on dependencies are provided in the section that follows }~ Information on dependencies configured for Debian is provided as this may be of assistance.

3~ source tarball

!_ installation with provided install script

To install SiSU, in the root directory of the unpacked SiSU _{as root type}_:~{ This makes use of rant and the provided Rantfile. Note however, that additional external package dependencies, such as tetex-extra are not taken care of for you. }~

_1 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 *~rant is provided,~{ a Rantfile has been configured to do post installation setup }~ 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 }http://make.rubyforge.org/ ~{ http://make.rubyforge.org/ \\ http://rubyforge.org/frs/?group_id=615 }~ 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 }http://make.rubyforge.org/ ~{ http://make.rubyforge.org/ \\ http://rubyforge.org/frs/?group_id=615 }~ 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:

_1 ruby install -T

To install as root type:

_1 ruby install

For a minimal install type:

_1 ruby install base

!_ installation with setup.rb

{~^ setup.rb }http://i.loveruby.net/en/projects/setup/ is provided the package and will install SiSU~{ Minero Aoki \\ http://i.loveruby.net/en/projects/setup/doc/ }~ installation is a 3 step process~{ Installation instructions \\ http://i.loveruby.net/en/projects/setup/doc/usage.html }~ the following string assumes you are in the package directory and that you have root as sudo:

_1 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.~{ http://www.kitenet.net/programs/alien/ }~ Dependencies are not handled, not even that of the essential Ruby.

1~install_dependencies_and_notes SiSU Components, Dependencies and Notes

The dependency lists are from the Debian control file for SiSU version 0.36, and may assist in building SiSU on other distributions.

2~ 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

*Depends:* on ruby (>=1.8.2), libwebrick-ruby

*Recommends:* sisu-pdf, sisu-sqlite, sisu-postgresql, sisu-examples, librmagick-ruby, trang, tidy, libtidy, librexml-ruby, zip, unzip, openssl

initialise directory

_1 sisu -CC

html

_1 sisu -hv [filename/wildcard]

_1 sisu -Hv [filename/wildcard]

LaTeX (but sisu-pdf dependencies required to convert that to pdf)

_1 sisu -pv [filename/wildcard]

plain text Unix with footnotes

_1 sisu -av [filename/wildcard]

plain text Dos with footnotes

_1 sisu -Av [filename/wildcard]

plain text Unix with endnotes

_1 sisu -ev [filename/wildcard]

plain text Dos with endnotes

_1 sisu -Ev [filename/wildcard]

openoffice odt

_1 sisu -ov [filename/wildcard]

xhtml

_1 sisu -bv [filename/wildcard]

XML SAX

_1 sisu -xv [filename/wildcard]

XML DOM

_1 sisu -Xv [filename/wildcard]

wordmap (a rudimentary index of content)

_1 sisu -wv [filename/wildcard]

document content certificate

_1 sisu -Nv [filename/wildcard]

placement of sourcefile in output directory

_1 sisu -sv [filename/wildcard]

creation of source tarball with images, and placement of source tarball in ouput directory

_1 sisu -Sv [filename/wildcard]

manifest of output produced (polls output directory and provides links to existing output)

_1 sisu -yv [filename/wildcard]

url for output files -u -U

_1 sisu -uv[and other flags] [filename/wildcard]

_1 sisu -Uv [filename/wildcard]

toggle screen colour

_1 sisu -cv[and processing flags] [filename/wildcard]

verbose mode

_1 sisu -v[and processing flags] [filename/wildcard]

_1 sisu -V[and processing flags] [filename/wildcard]

quiet mode

_1 sisu -q[and processing flags] [filename/wildcard]

maintenance mode, intermediate files kept -M

_1 sisu -Mv[and other flags] [filename/wildcard]

[the -v is for verbose]

start the webrick server

_1 sisu -W

2~ sisu-complete

_* a dummy package that installs the whole SiSU, apart from sisu-examples

*Depends:* ruby (>=1.8.2), sisu, sisu-pdf, sisu-postgresql, sisu-remote, sisu-sqlite

*Recommends:* sisu-examples

2~ sisu-examples

_* installs sisu markup samples and other miscelleny

*Depends:* sisu

2~ sisu-pdf

_* dependencies used by sisu to produce pdf from LaTeX generated

*Depends:* sisu, tetex-bin, tetex-extra, latex-ucs

*Suggests:* evince, xpdf

converts sisu LaTeX produced to pdf

_1 sisu -pv [filename/wildcard]

[the -v is for verbose]

2~ sisu-postgresql

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

*Depends:* sisu, postgresql-8.1, libdbi-ruby, libdbm-ruby, libdbd-pg-ruby

*Suggests:* pgaccess, libdbd-pgsql, postgresql-contrib-8.1

installs dependencies for sisu to work with and populate postgresql database

create database

_1 sisu -Dv createall

drop database

_1 sisu -Dv dropall

import content

_1 sisu -Div [filename/wildcard]

_1 sisu -Dv import [filename/wildcard]

update content

_1 sisu -Duv [filename/wildcard]

_1 sisu -Dv update [filename/wildcard]

[the -v is for verbose]

The following are available without installation of the sisu-postgresql component, but are of interest in this context

generate a sample database query form for use with webserver on port 80

_1 sisu -F

or for use with webrick server

_1 sisu -F webrick

to start webrick server

_1 sisu -W

2~ sisu-remote

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

scp

_1 sisu -vr[and processing flags] [filename/wildcard]

rsync

_1 sisu -vR[and processing flags] [filename/wildcard]

[the -v is for verbose]

*Depends:* sisu, rsync, openssh-client|lsh-client, keychain

2~ sisu-sqlite

_* dependencies used by sisu to populate sqlite database

*Depends:* sisu, sqlite, libdbi-ruby, libdbm-ruby, libdbd-sqlite-ruby

*Suggests:* libdbd-sqlite

installs dependencies for sisu to work with and populate sqlite database

create database

_1 sisu -dv createall

drop database

_1 sisu -dv dropall

update content

_1 sisu -div [filename/wildcard]

_1 sisu -dv import [filename/wildcard]

update content

_1 sisu -duv [filename/wildcard]

_1 sisu -dv update [filename/wildcard]

[the -v is for verbose]

The following are available without installation of the sisu-sqlite component, but are of interest in this context

generate a sample database query form for use with webserver on port 80

_1 sisu -F

or for use with webrick server

_1 sisu -F webrick

to start webrick server

_1 sisu -W