Chapter 2. Installation

Last modified on $Date: 2007-07-09 21:53:04 +0200 (lun, 09 jui 2007) $

Before being able to use PyKota, you have of course to install it first. But before installing, you must carefully plan your installation.

First you have to determine which machine will be the PyKota database server. The database server is the host responsible for keeping a centralized database of print usage for all your printers, users and groups.

Then you have to list all the Print Servers for which you plan to use print quota facilities.

With most database backends, several print servers can share a single database, however as we'll see later this is not possible if you choose to use SQLite as your print quota database backend.

Finally you have to download PyKota's latest version or buy an official package, from http://www.pykota.com/software/pykota. If you've just bought an official package, then as soon as you've receive it you have to decompress and visit its archive, to do so just type the following commands :

jerome@nordine:~$ tar -zxf pykota-1.26_official.tar.gz    
jerome@nordine:~$ cd pykota-1.26_official
jerome@nordine:~/pykota-1.26_official$
    

You can see many files in this directory, the first ones to read are README, then COPYING and LICENSE. They will give you basic installation instructions and explain the licensing terms under which PyKota is distributed. Of course they are also mostly boring to read ! Detailed installation and operating instructions are defined in the ./docs directory, in the form of SGML documentation in the DocBook format. You have to compile these files into readable documentation like the HTML or PDF formats, or buy an official PyKota package which already contains these compiled forms of the documentation. Of course you already know this because that's what you are currently reading !

2.1. Interactive step-by-step installation of PyKota with pksetup

pksetup is a command line tool with which you'll be able to install PyKota and all its dependencies in a completely interactive way. At the end of the installation, a shell script is created which allows you to replicate the very same installation in an automated way. This can be useful if you've got several servers to install identically.

Currently, pksetup is experimental, and only works with Debian and Ubuntu distributions. In addition, the database backend which will be installed with this command is PostgreSQL and you have no choice for another backend. If you want another database backend, or use a different distribution, or want to do the installation manually, then read and follow the instructions in the next section.

To launch the installation procedure, just type pksetup followed with the name of your distribution, like :

    
jerome@nordine:~/pykota-1.26_official$ ./bin/pksetup debian
    
and then follow the instructions and answer to the several questions you'll be asked.