OpenAguila

OpenAguila est un logiciel libre de gestion d'entreprise, sous licence GNU GPL v2. Site officiel : http://www.openaguila.org/

Forum sur ubuntu-fr: http://forum.ubuntu-fr.org/viewtopic.php?id=91740

Le tutoriel ci-dessous est valable pour OpenAguila 4.100.x. Il a été testé sur Dapper et Gutsy.

Il est nécessaire de récupérer l'archive Core en tar.gz de Tomcat 5.X sur le site http://tomcat.apache.org/

Ainsi que l'archive Openaguila sur le site http://labs.libre-entreprise.org/frs/?group_id=101

Installer le paquet postgresql-8.1 pour Dapper ou le paquet postgresql-8.2 pour Gutsy. Concernant Feisty je ne sais pas quelle version est disponible, mais ce tuto fonctionne avec les deux versions.

Installer les paquets sun-java5-jre sun-java5-plugin

Ensuite il faut choisir la version de Java utilisée par le système.

# sudo update-java-alternatives --set java-1.5.0-sun

Placer la variable JAVA_HOME

# export JAVA_HOME=/usr/lib/jvm/java-1.5.0-sun 

Décompresser Tomcat

# sudo tar -zxvf apache-tomcat-5.5.25.tar.gz apache-tomcat-5.5.25/ 

Le déplacer dans le répertoire de votre choix

# sudo mv apache-tomcat-5.5.25 /usr/share/tomcat

Entrer dans ce répertoire

# sudo cd /usr/share/tomcat

Editez le fichier tomcat-users.xml qui se trouve dans le repertoire conf

# sudo vi conf/tomcat-users.xml

Entre les balises <tomcat-users> Ajouter juste après le dernier role

<role rolename="manager"/>

Ajouter à la fin, juste avant la balise </tomcat-users>

<user username="manager" password="my_password" roles="tomcat,manager"/>

Entrer dans le répertoire ou se trouve les exécutables de tomcat

# cd bin

Et lancer le serveur

# sudo ./startup.sh

Tester dans le navigateur

http://192.168.250.8:8080 par exemple ou http://localhost:8080/ si vous avez un navigateur sur la machine

Si vous avez la page Tomcat c'est gagné, sinon c'est qu'il doit manquer une étape. Dans ce cas regardez si Tomcat est lancé (dans une console, tapez

ps aux

et regardez si vous avez un processus qui a le nom de Java. Si oui regardez alors ce qui se passe dans les logs de Tomcat (répertoire 'logs' là où est installé Tomcat).

Dans le répertoire ou se trouve l'archive Openaguila

Décompresser l'archive (remplacer 'x' par le no. de version que vous avez)

#  tar -xvf oa-4.100.x.tgz

La placer dans le répertoire de votre choix

#  sudo mv oa-4.100.x /opt/oa_prod

Entrer dans ce répertoire

# cd /opt/oa_prod/

Editer le fichier openaguila.xml

# sudo cp install/openaguila.xml install/openaguila.xml.bak
# sudo vi install/openaguila.xml

Adapter les lignes

docBase=

path=

workDir

password=

Copier le fichier openaguila.xml sous le même nom que votre répertoire openaguila dans Tomcat.

#  sudo cp install/openaguila.xml /usr/share/tomcat/conf/Catalina/localhost/oa_prod.xml 

Et copier le pilote sql livré avec Openaguila dans Tomcat

 # sudo cp install/jdbc_pgsql_oa.jar /usr/share/tomcat/common/lib/ 

# sudo su postgres

Création de l'utilisateur aguila

# createuser aguila -P

Donner le mot de passe dans mon cas j'ai garder le mot de passe par défaut (le même que dans oa_prod.xml) Et répondu par « entrée » au questions suivantes.

Création de la base de données

# createdb -E UTF8 -O aguila oa_prod

Et création des tables

# pg_restore -d oa_prod /opt/oa_prod/install/oa_basic.pgsql.dump 

# exit

Démarrer un navigateur en indiquant l'adresse correspondant à OpenAguila, par exemple :

http://192.168.250.8:8080/oa_prod

• '192.168.250.8' est l'adresse IP du serveur sur lequel OpenAguila a été installée
• 8080 le port utilisé par Tomcat (défini dans le fichier 'conf/server.xml' de Tomcat)
• 'oa_prod' est le nom de l'application déclarée dans Tomcat (fichier XML du répertoire 'conf/Catalina/localhost' de Tomcat).
• Pour se connecter, vous pouvez utiliser :

  demo / demo (compte utilisateur normal)

  admin / geidac71 (compte administrateur) 

* En fonction de l'utilisation que vous aller faire d'OpenAguila, il peut être nécessaire d'augmenter la mémoire de la machine virtuelle Java, lors du lancement de Tomcat. Pour cela, créez un script avec par exemple :

#!/bin/bash
# Script de demarrage Tomcat pour OpenAguila

export TOMCAT_HOME=/usr/share/tomcat
export JAVA_HOME=/usr/lib/jvm/java-1.5.0-sun
export JAVA_OPTS="-server -Xms256M -Xmx256M"
export CATALINA_OPTS="-Dfile.encoding=iso8859-1 -Djava.awt.headless=true"
 
cd $TOMCAT_HOME/bin
./startup.sh
tail -f $TOMCAT_HOME/logs/catalina.out

La dernière ligne vous permet de voir tout de suite si le lancement de Tomcat se passe bien. Faites simplement CTRL-C dans la console pour reprendre la main.

* Si vous avez des problèmes d'accents, il se peut que vos locales ne soient pas configurées. Vous pouvez faire cela pour y remédier :

Editer le fichier /var/lib/locales/supported.d/local et ajoutez : fr_FR ISO-8859-1

Puis :

sudo dpkg-reconfigure locales