Install Bootstrapping

Table of Contents Get a Taranis distribution package Bootstrap options Questions During Installation Upgrading from 3.3.x to 3.4.x Upgrading after 3.4.0

Get a Taranis distribution package

Since release 3.4.0, Taranis will install under a username, by default taranis. You may already have an older version of Taranis

On a freshly installed host, you need to start with a Taranis distribution package. A Taranis distribution package is named as taranis-$version.tar.gz.

If you have not received the bootstrap script separately, you can collect extract it from the package:

root# tar xzf taranis-$version.tar.gz taranis-$version/taranis-bootstrap
root# mv taranis-$version/taranis-bootstrap

or

tara$ taranis install --version 3.4    # Newest version in 3.4

With a recent bootstrap script, you run:

root# ./taranis-bootstrap taranis-$version.tar.gz

The bootstrap script will start with creating the user ‘taranis’ (if the name doesn’t already exist). It will unpack the sources (if not unpacked already) into ~taranis/sources/taranis-$version. Then it starts the install scripts which are contained in the package.

Bootstrap options

The more popular options of the taranis-bootstrap commands are:

-u --user USERNAME   (default 'taranis')
-g --group GROUPNAME (default 'taranis')
-m --migrate DIR     (default '/opt/taranis')

Install the software under this username. You can safely run very distinct releases of Taranis under different usernames on the same server.

Questions During Installation

During installation, you will get some questions. These values will get stored in ~taranis/etc/setup-generic or ~taranis/etc/setup-$version may change them later, by hand in that file, but need to rerun taranis install to effectuate them.

Also, you may get some questions from the Perl modules during the installation. You can simply accept the defaults.

Upgrading from 3.3.x to 3.4.x

Please, read the release notes for 3.4.0.

Upgrading after 3.4.0

When you wish to upgrade to a newer release, you have the following options:

• Bootstrap with a new username: read the taranis bootstrap procedure.
• Share an installation under an existing username: become that user and run taranis install taranis-$new_version.tar.gz
• Install from GIT under the existing username

In both the second and third case, you must be careful which database you assign to the instances: you cannot share the database between 3.3 and 3.4 releases, but 3.4.0 and 3.4.1 can probably share one without too many problems. Read the release notes.

When you create a new username to install a parallel instance (or same username on a different server), you need the content of ~/var, ~/local*, and the database from your older installation.

Example: upgrading a minor release

tara$  taranis install --version 3.4.1-rc2 # Explicit version
tara$  taranis install --version 3.4       # Newest version in 3.4

If you have GIT configured:

tara$  cd ~/sources/taranis-3.4.1
tara$  taranis install –--git              # Reinstall from GIT

Once you have bootstrapped a Taranis user, you probably do not need to check for missing perl or distributions modules anymore. You may skip these checks via:

tara$  taranis install --no-internet       # Skip external  checks