Ce module contient les classes ORM utilisées dans le cadre de Vigilo. Il est basé sur la bibliothèque SQLAlchemy et a été testé avec une base de données PostgreSQL, mais devrait pouvoir fonctionner avec un autre moteur de bases de données.

Pour les détails du fonctionnement des modèles Vigilo, se reporter à la documentation officielle.

Vigilo nécessite une version de Python supérieure ou égale à 2.5. Le chemin de l'exécutable python peut être passé en paramètre du make install de la façon suivante:

make install PYTHON=/usr/bin/python2.6

Les modèles ont besoin des modules Python suivants :

• setuptools (ou distribute)
• vigilo-common
• psycopg2 (pour PostgreSQL)
• sqlalchemy 0.5.x
• zope-sqlalchemy >= 0.4
• paste-deploy
• transaction

L'installation se fait par la commande make install (à exécuter en root).

Vous devez ensuite créer l'utilisateur et la base de données Vigilo. Exemple sous PostgreSQL:

sudo -u postgres createuser --no-inherit --no-createdb --no-createrole \
                            --no-superuser --pwprompt vigilo
sudo -u postgres createdb vigilo --owner vigilo --encoding UTF8

Puis, dans le cas de PostgreSQL, il faut autoriser l'accès local à l'utilisateur Vigilo dans la configuration du serveur. Pour cela, éditer le fichier /var/lib/pgsql/data/pg_hba.conf et ajouter les lignes suivantes en début de fichier:

local   vigilo      vigilo                            md5
host    vigilo      vigilo      127.0.0.1/32          md5
host    vigilo      vigilo      ::1/128               md5

Et recharger le serveur PostgreSQL. Enfin, après avoir installé tous les composants de Vigilo, vous pourrez initialiser la base de données Vigilo grâce à la commande:

vigilo-updatedb

Models est sous licence GPL v2.