Guide d'installation Oratio® sous GNU/Linux

Sommaire

• Prérequis
• Installation
  • Mise en place des fichiers
  • Configuration de Apache
  • Permissions des fichiers
• Configuration de Postgres
• Configuration de Oratio®
  • Créer une base de données
  • Créer un utilisateur
  • Se connecter au logiciel

Prérequis

Oratio® est un logiciel de gestion type ERP distribué sous licence GPL. Il fonctionne sur une base de données Postgres. De plus il fonctionne en mode "CGI", c'est à dire qu'il est atteignable via un navigateur internet. Ainsi, avant de pouvoir utiliser Oratio® il faut s'assurer que les outils utilisés par ce dernier soient installés sur le serveur où sera installé Oratio®

Liste des programmes

1. Perl, version 5 et+, pour plus d'informations se reporter au site CPAN (Comprehensive Perl Archive Network)
2. Le serveur http Apache
3. Le système de gestion de base de donées Postgres, version 7.4 et+
4. Les bibliothèques suivantes pour Perl : DBD-Pg et DBI, toujours sur le site CPAN
5. La librérie Perl pour créer des documents en format pdf:
   - systèmes Debian: libpdf-api2-perl
   - autres systèmes Linux/Windows : PDF-API2
6. LaTeX (optionel) : afin de générer des documents au format PDF

Installation

Mise en place des fichiers :

• Décompresser le fichier .tar.gz dans le répertoire /usr/local de votre serveur Linux : tar xzvf oratio-x.x.x.tar.gz
• Vous deviez avoir tous les fichiers installés dans le répertoire /usr/local/oratio/

Configuration de Apache

• Créer un fichier nomé oratio-httpd.conf à placer dans le répertoire de configuration d'apache (par défaut /etc/httpd/conf/ dans lequel il s'agit de copier le texte suivant :
  Alias /oratio/ /usr/local/oratio/ <Directory /usr/local/oratio> AddHandler cgi-script .pl Options ExecCGI Includes FollowSymlinks </Directory> <Directory "/usr/local/oratio/users"> Order Deny,Allow Deny from All </Directory>
• Editer le fichier httpd.conf de Apache et y ajouter :
  # Oratio Include <ServerRoot>/oratio-httpd.conf

Permissions des fichiers

Donner la propriété des répertoire users et templates à l'utilisateur de apache (en général, c'est apache:apache ou www, ou encore nobody). Voir le fichier de configuration de Apache.
Pour cela :
# chown apache:apache users templates
en remplaçant éventuellement apache:apache par le nom d'utilisateur et le groupe d'utilisateur utilisé par Apache.

Configuration de Postgres

• Il s'agit d'ajouter un utilisateur base de données utilisé ensuite par Oratio® pour se connecter au serveur de base de données.
• # su postgres $ createuser -d oratio
• Si vous souhaitez donner un mot de passe à cet utilisateur (conseillé), utilisez plutôt :
  $ createuser -d -P oratio
• Répondre 'y' à la question : "Shall the new user be allowed to create more dataset? (y/n) y"
• Répondre 'n' à la question : "Shall the new user be allowed to create more new users? (y/n) n"

Configuration de Oratio®

Créer une base de données

• Ouvrir un navigateur internet et charger la page http://localhost/oratio/admin.pl. En remplaçant éventuellement localhost par l'adresse du serveur sur lequel est installé Oratio®
• Entrer dans la section "Pg Database Administration"
• Renseigner les champs host, port, user et password en indiquant respectivement l'adresse ip du serveur de base données (par défaut localhost), le port (en général 5432), le nom d'utilisateur du serveur de base de données (dans notre exemple oratio) ainsi que le mot de passe saisi lors de la création de cet utilisateur.
• Entrer un nom pour la base de données, choisissez une configuration par défaut et presser ensuite Continue
• Cela peut prendre un certain temps, vu la taille de certain plan comptables par défaut.

Créer un utilisateur

• Recharger la page http://localhost/oratio/admin.pl. En remplaçant éventuellement localhost par l'adresse du serveur sur lequel est installé Oratio®
• Entrer dans la section "Add User"
• Renseigner les champs voulus
• Dans la partie "Database", insérer les mêmes valeurs que celles utilisées pour créer la base de données
• Une fois les renseignements saisis, cliquez sur Save

Se connecter au logiciel

• Charger la page http://localhost/oratio/login.pl. En remplaçant éventuellement localhost par l'adresse du serveur sur lequel est installé Oratio®
• Entrer les valeurs pour login et password créées lors de l'étape précédente.
• Cliquer sur login
• Se référer ensuite au manuel d'utilisation de Oratio® fourni avec les sources.

Félicitations, vous venez d'installer votre ERP Open Source, Oratio® !