Installing Steward

Installing steward consists of the following steps:

1. Get the code
2. install the software
3. Edit the configuration files
4. Create the environment.
5. Run the service.

Download steward from http://protocultura.cl/steward/releases , decompress the archive and enter into the created steward-* directory. All official releases should be signed by Marijn’s GPG Key

Steward uses setuptools to do the installation magic so the following command will pull all needed dependencies:

$ python setup.py install

To generate the template configuration with all the options run:

$ paster make-config steward my_configuration.conf

Edit the newly created my_configuration.conf file to suit your needs. You can leave this configuration file where you leave your other configuration files.

The configuration file is auto-commented and by default uses sqlite as a database. Once the file has been edited prepare the environment by doing:

$ paster setup-app my_configuration.conf

This will prepare the database and create the directory where steward stores its files.

Now your system is ready to run with a:

$ paster serve my_configuration.conf

By default it will run on port 5000 and listens on all interfaces. This is of course simple to change (see “paster serve –help” for many more options).