====================
latua_ documentation
====================

.. _latua: http://www.petunial.com/latua/

------------
Installation
------------

:Contact: team@petunial.com
:date: $Date: 2007-12-20 13:45:07 +0100 (Do, 20 Dez 2007) $
:status: This is a "work in progress".
:revision: $Revision: 338 $
:copyright: BSD License

:Dedication:

    For system administrators.

:Abstract:

    This document describes how to install latua.

.. contents:: Table of Contents
.. section-numbering::

Supported platforms
===================

latua should run on the following platforms:

 * Linux
 * Windows
 * Mac Os X
 * OpenBSD

Other platforms should work too, but are not official
supported.

Requirements
============

The following software is required to run latua:

 * Python >=2.5 from [http://www.python.org/]

Python 2.4 should work too, but is not official
supported because it does not contain the sqlite3 core module.
Running latua with Python 2.4 requires pysqlite from
[http://www.initd.org/tracker/pysqlite] for the indexer module.

Python <=2.3 is not supported.

Windows dependencies
--------------------

Running latua under windows requires:

 * Python Win32 Extensions from [https://sourceforge.net/projects/pywin32/]

Packages installation
=====================

latua is available as package for various operating systems and distributions.

Windows
-------

Just download and run: ``latua-version.win32.exe``.

Linux RPM
---------

Download the ``latua-version.noarch.rpm`` package and use the
following command for installation::

    # rpm -ihv latua-version.noarch.rpm

.. Debian
.. ------
..
.. Via aptitude package manager::
..
..     # apt-get install latua
..
.. OpenBSD
.. -------
..
.. Via OpenBSD packages::
..
..     # pkg_add -v latua-version.tgz
..
.. From OpenBSD ports-tree::
..
..     # cd /usr/ports/sysutils/petunial/
..     # make install clean


Source installation
===================

Extract latua sources::

    # tar xzvf latua-version.tar.gz

Installation via python distutils::

    # cd latua-version
    # python setup.py install

Optional: run test suite before (or after) installation::

    # python test/test