Project

General

Profile

Guide ยป

Installation

TinyIDS can be installed either directly from source code or from a package, for instance an RPM or DEB package, that has been specifically prepared for your operating system.

The following procedure describes how to install the TinyIDS release from source code on a POSIX-compatible operating system.

Requirements

The requirements for running TinyIDS are:

Download

Download and extract the source-code distribution package of a TinyIDS release. For instance:

wget http://www.codetrax.org/attachments/download/47/tinyids-0.1.0.tar.gz
tar -xzvf tinyids-0.1.0.tar.gz
cd tinyids-0.1.0

Run the installer

To install TinyIDS run:

python setup.py install -f

TinyIDS is now installed on your system.

Unless you plan to run a TinyIDS server on the current system, you may now proceed to the configuration tutorial.

Prepare the system to run a TinyIDS Server

Before running a TinyIDS server, it is necessary to accomplish some extra system administration tasks.

Create a user to run tinyidsd

If you plan to run a TinyIDS server (tinyidsd) on the current system, it is highly recommended that you create an unprivileged system user which will be used to run the server process.

groupadd -r tinyids
useradd -r -g tinyids tinyids

Set filesystem permissions

The TinyIDS server stores the client information in a database. The default location, where this database is stored is /var/lib/tinyids/tinyids.db. This means that the tinyidsd server process needs to have write permission to the /var/lib/tinyids/ directory. Proper permissions can be set by invoking the following commands:

chmod 0750 /var/lib/tinyids
chown tinyids /var/lib/tinyids
chgrp tinyids /var/lib/tinyids

Appendix I - Installing to a custom location

For installation to a custom location you can use something like the following:

python setup.py install --prefix=/usr --root=/tmp

For more information about the 'install' command, study the help message:

python setup.py --help install

Appendix II - Creating an RPM package

To create an RPM package:

python setup.py bdist_rpm --release 1