Guide d'installation Oratio® sur SME Server

Ce How-To a été rédigé dans le cadre du projet SMERP. Je souhaite remercier les personnes ayant écrit les différents How-To concernant l'installation de Postgres, de SQL-Ledger dont ce document est en grande partie la synthèse (traduite en français).

Sommaire

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®

L'installation de Oratio a été effectuée avec la versione 6.0.1 de SME Server. On suppose dans ce how-to qu'une Information Bay nommée "oratio" a été crée.

Installation de Postgres

Installation du serveur de base de données

1. Récupération des différents RPM

2. Installation des RPM

# rpm -uvh --NODEPS *.rpm

3. Lancement de PostgresQL

# /etc/init.d/postgresql start
Résultat escompté :


						Initializing database: [ OK ]

						Starting postgresql service: [ OK ]

4. Création des templates de configuration

Création du répertoire de template :
# mkdir -p /etc/e-smith/templates/var/lib/pgsql/data # mkdir -p /etc/e-smith/templates-custom/var/lib/pgsql/data
Copie des fichiers de base dans le répertoire template :
# cp /var/lib/pgsql/data/postgresql.conf /etc/e-smith/templates/var/lib/pgsql/data # cp /var/lib/pgsql/data/pg_hba.conf /etc/e-smith/templates/var/lib/pgsql/data # cp /var/lib/pgsql/data/postgresql.conf /etc/e-smith/templates-custom/var/lib/pgsql/data # cp /var/lib/pgsql/data/pg_hba.conf /etc/e-smith/templates-custom/var/lib/pgsql/data

5. Modification des fichiers de configuration

Edition du fichier postgresql.conf afin que le serveur accepte les connections TC/IP :
# pico /etc/e-smith/templates-custom/var/lib/pgsql/data/postgresql.conf Décommenter la ligne #tcpip_socket = false et la remplacer par :
tcpip_socket = true
Sauvez CTRL+o et quittez CTRL+x
Edition du fichier pg_hba.conf afin de régler les accès TCP/IP :
# pico /etc/e-smith/templates-custom/var/lib/pgsql/data/pg_hba.conf Remplacer la ligne #local all ident sameuser à la fin du fichier par :
local all trust host all [IP_LOCAL] [MASK] trust host all all 0.0.0.0 255.255.255.255 reject IP_LOCAL est a remplacé par votre IP, MASK est à remplacé par votre mask réseaux.

6. Génération des templates


					# /sbin/e-smith/expand-template /var/lib/pgsql/data/pg_hba.conf

					# /sbin/e-smith/expand-template /var/lib/pgsql/data/postgresql.conf

7. Redémmarage de postgresQL


					/etc/init.d/postgresql stop

					Stopping postgresql service: [ OK ]

					/etc/init.d/postgresql start

					Starting postgresql service: [ OK ]

8. Création des liens symboliques pour lancer Postgres au démarrage:


					# ln -s /etc/init.d/postgresql /etc/rc.d/rc7.d/S56postgresql

					# ln -s /etc/init.d/postgresql /etc/rc.d/rc6.d/K03postgresql

Installation des drivers de base de données

Il s'agit d'installer les driver de base de données pour Perl DBI, et les drivers spécifiques à Postgres DBD-Pg.

1. Téléchargement des RPMs

2. Installation des RPMs

# rpm -Uvh perl-DBI-1.14-10.i386.rpm perl-DBD-Pg-0.95-1.i386.rpm
Il se peut que les drivers DBI soient déjà installés avec le package Postgres-Perl, dans ce cas, rpm vous le signal mais ne pas y prêter attention.

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"

Installation de LaTeX

1. Téléchargement des RPMs

2. Installation des RPMs

# rpm -Uvh tetex*.rpm --NODEPS
Ceci installe sur la machine le système TeTeX permettant de générer à partir de code source TeX des documents .dvi puis .ps et .pdf nécessaires afin d'éditer ensuite des états au format pdf avec Oratio.

Création des templates

Le logiciel Oratio requiert une configuration de Apache un peu différente de celles proposées en standard sur SME Server. Il faut donc réécrire les templates concernant la construction du fichier httpd.conf.

1. Ajouter le nom de fichier login.pl aux fichiers index

Pour cela éditer les templates suivants :

50DirectoryIndex00 : # pico /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/50DirectoryIndex00 Et ajouter login.pl à la fin : votre fichier devrait ressembler à :
# DirectoryIndex: Name of the file or files to use as a pre-written HTML # directory index. Separate multiple entries with spaces. DirectoryIndex index.htm index.html index.shtml index.cgi login.pl
50DirectoryIndex00PHP : # pico /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/50DirectoryIndex00PHP Et ajouter login.pl : votre fichier devrait ressembler à :
{ use esmith::config; use esmith::db; local $services{'php'} = $php; my $status = db_get_prop(\%services, 'php', 'status'); if (defined $status) { if ($status eq 'enabled') { $OUT .= "DirectoryIndex index.htm index.html index.shtml index.cgi index.php index.php3 login.pl\n"; } } }

2. Ajouter la handler pour les fichier Perl .pl

Pour cela éditer le template 80AddHandler00 :


			# pico /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/80AddHandler00

Et ajouter le cas des fichier .pl : votre fichier devrait ressembler à :

3. Traiter le cas de l'information bay Oratio :

Pour cela éditer le template 90e-smithAccess40ibays :


			# pico /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/90e-smithAccess40ibays

Et ajouter le cas de l'Information Bay oratio éventuellement à remplacer par le nom donné au départ (télécharger le fichier)
Il s'agit de définir les accès permis sur les différents répertoires de oratio : on permet d'exécution de cgi Perl (.pl) et on interdit l'accès au répertoire users
.

#------------------------------------------------------------
# Information bay directories
#------------------------------------------------------------

{
    my %accounts;
    tie %accounts, 'esmith::config', '/home/e-smith/accounts';

my $key;
    my $value;
    my $result = "";

while (($key,$value) = each %accounts)
    {
	my ($type, %properties) = split (/\|/, $value, -1);
	if ($type eq 'ibay')
	{
	    #------------------------------------------------------------
	    # Figure out which combination of parameters to use. If
	    # PublicAccess parameter is present, this is e-smith 4.0.
	    # Otherwise, it's e-smith 3.0.
	    #------------------------------------------------------------

my $allow;
	    my $pass;
	    my $satisfy;

if ($properties{'PublicAccess'})
	    {
		if ($properties{'PublicAccess'} eq 'none')
		{
		    next;
		}
		elsif ($properties{'PublicAccess'} eq 'local')
		{
		    $allow   = $localAccess;
		    $pass    = 0;
		    $satisfy = 'all';
		}
		elsif ($properties{'PublicAccess'} eq 'local-pw')
		{
		    $allow   = $localAccess;
		    $pass    = 1;
		    $satisfy = 'all';
		}
		elsif ($properties{'PublicAccess'} eq 'global')
		{
		    $allow   = 'all';
		    $pass    = 0;
		    $satisfy = 'all';
		}
		elsif ($properties{'PublicAccess'} eq 'global-pw')
		{
		    $allow   = 'all';
		    $pass    = 1;
		    $satisfy = 'all';
		}
		elsif ($properties{'PublicAccess'} eq 'global-pw-remote')
		{
		    $allow   = $localAccess;
		    $pass    = 1;
		    $satisfy = 'any';
		}
	    }
	    elsif ($properties {'ReadAccess'} eq 'global')
	    {
		if ($properties {'UsePassword'} eq 'yes')
		{
		    $allow   = 'all';
		    $pass    = 1;
		    $satisfy = 'all';
		}
		else
		{
		    $allow   = 'all';
		    $pass    = 0;
		    $satisfy = 'all';
		}
	    }
	    else
	    {
		if ($properties {'UsePassword'} eq 'yes')
		{
		    $allow   = $localAccess;
		    $pass    = 1;
		    $satisfy = 'all';
		}
		else
		{
		    $allow   = $localAccess;
		    $pass    = 0;
		    $satisfy = 'all';
		}
	    }

my $dynamicContent = $properties{'CgiBin'} || "disabled";
            $result .= "\n";
            $result .= "#------------------------------------------------------------\n";
	    $result .= "# $key ibay directories ($properties{'Name'})\n";
            $result .= "#------------------------------------------------------------\n";

$result .= "\n";
            $result .= "<Directory /home/e-smith/files/ibays/$key/html>\n";
            if ($key eq 'oratio')
            {
	            $result .= "    Options ExecCGI FollowSymlinks\n";
	    }
	    else
	    {
            	$result .= "    Options Indexes\n";
	    }	
	    if ($dynamicContent eq 'enabled')
	    {
		$result .= "    Options +Includes\n";
	    }
	    else
	    {
		$result .= "    <FilesMatch \"\\.(php|php3|phtml)\$\">\n";
		$result .= "        order deny,allow\n";
		$result .= "        Deny from all\n";
		$result .= "    </FilesMatch>\n";
		$result .= "    Options +IncludesNOEXEC\n";
	    }
            $result .= "    AllowOverride None\n";
            $result .= "    order deny,allow\n";
            $result .= "    deny from all\n";
            $result .= "    allow from $allow\n";
	    if ($pass)
	    {
                $result .= "    AuthName \"$properties{'Name'}\"\n";
                $result .= "    AuthType Basic\n";
                $result .= "    AuthExternal pwauth\n";
                $result .= "    require user $key\n";
		$result .= "    Satisfy $satisfy\n";
	    }
            $result .= "</Directory>\n";
            $result .= "\n";

if ($key eq 'oratio')
            {
                $result .= "<Directory /home/e-smith/files/ibays/$key/html/users>\n";
                $result .= "    Options None\n";
                $result .= "</Directory>\n";
            }
            $result .= "\n";

$result .= "<Directory /home/e-smith/files/ibays/$key/cgi-bin>\n";
	    if ($dynamicContent eq 'enabled')
	    {
		$result .= "    Options ExecCGI\n";
	    }
            $result .= "    AllowOverride None\n";
            $result .= "    order deny,allow\n";
            $result .= "    deny from all\n";
            $result .= "    allow from $allow\n";
	    if ($pass)
	    {
                $result .= "    AuthName \"$properties{'Name'}\"\n";
                $result .= "    AuthType Basic\n";
                $result .= "    AuthExternal pwauth\n";
                $result .= "    require user $key\n";
                $result .= "    Satisfy $satisfy\n";
	    }
            $result .= "</Directory>\n";

$result .= "\n";
            $result .= "<Directory /home/e-smith/files/ibays/$key/files>\n";
            $result .= "    AllowOverride None\n";
            $result .= "    ForceType application/octet-stream\n";
            $result .= "    order deny,allow\n";
            $result .= "    deny from all\n";
            $result .= "    allow from $allow\n";
	    if ($pass)
	    {
                $result .= "    AuthName \"$properties{'Name'}\"\n";
                $result .= "    AuthType Basic\n";
                $result .= "    AuthExternal pwauth\n";
                $result .= "    require user $key\n";
                $result .= "    Satisfy $satisfy\n";
	    }
            $result .= "</Directory>\n";
	}
    }

$result;
}

4. Appliquer les modification sur les templates et redémarrer Apache :


			# /sbin/e-smith/expand-template etc/httpd/conf/httpd.conf

			# service httpd restart

Mise en place de Oratio®

Installation des fichiers

1. Télécharger les sources de Oratio :

2. Mettre en place les fichiers :


					#tar -C /home/e-smith/files/ibays/oratio/html -vzxf oratio.tar.gz

3. Vérifier les droits des fichiers :


						#cd /home/e-smith/files/ibays/oratio/html

						#chown www:www -R *

						#chmod 555 -R *

						#chmod 700 -R users

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® !