Ce document décrit les grandes étapes de l'installation d'OpenAguila.

OpenAguila peut s'installer sous Linux comme sous Windows XP

Un tutoriel d'installation sur Ubuntu a été rédigé par un contributeur et se trouve ici :

http://doc.ubuntu-fr.org/openaguila  

Sinon suivez le détail de l'installation ci-dessous... 

• PostgreSQL 8.x
• JAVA SE 5.0 et Apache Tomcat 5.5.x
  
  Notes pour les utilisateurs de sytèmes basés sur Linux :
  

• Nous vous recommandons vivement d'installer Tomcat en le téléchargeant directement depuis le site d'Apache (et ne pas utiliser celui livré avec votre distribution, car il peut y avoir quelques bugs comme par exemple avec Ubuntu Feisty Fawn). A titre indicatif, voici un exemple d'installation.

• Téléchargez OpenAguila à cette adresse. Décompactez l'archive là où vous souhaitez installer OpenAguila.
• Donnez bien les droits à l'utilisateur qui exécute Tomcat, sur le répertoire dans lequel vous avez décompacté l'archive.
• Renommez le répertoire selon votre souhait.
• Allez dans le répertoire 'install' et adaptez le script 'install.sh' à votre besoin (en début de fichier).
• Exécutez 'install.sh'
• Si vous avez des problèmes d'affichage d'accents (notamment dans les éditions), consultez cet article.
  

• Récupérer les sources d'OpenAguila. Vous pouvez les télécharger à cette adresse.
• Décompacter  le fichier récupéré là où vous souhaitez installer OpenAguila.
• Renommer le répertoire selon votre souhait (dans la suite de ce document, on suppose que 'oa_prod' a été choisi).

• Copier le fichier 'openaguila.xml' qui se trouve dans le répertoire 'install' dans le répertoire 'conf/Catalina/localhost' de Tomcat.
• Le renommer en 'oa_prod.xml'
  

• Veiller notamment à adapter les lignes qui sont en gras.
  
  <?xml version='1.0' encoding='utf-8'?>
  <Context displayName="OpenAguila Prod" 
      docBase="/home/mschneider/projets/openaguila/oa_prod" 
      path="/oa_prod" privileged="true" 
      workDir="work/Catalina/localhost/oa_prod" 
      reloadable="true"
  >
    
      <Resource 
          name="jdbc/aguila" 
          auth="Container" 
          type="javax.sql.DataSource" 
          driverClassName="org.postgresql.Driver"
          url="jdbc:postgresql://localhost:5432/oa_prod"
          username="aguila"
          password="mypassword"
          accessToUnderlyingConnectionAllowed="true"
          validationQuery="select version();"
      /> 
    
  </Context>
  
  

• Mettre le driver JDBC PostgreSQL dans le répertoire 'common/lib' de Tomcat (il se trouve dans le répertoire 'install' d'OpenAguila).
  
  
• Opérations à effectuer dans PostgreSQL

• Créer l'utilisateur 'aguila' (createuser -U postgres aguila -P)
• Créer la base de données 'oa_prod' en mode UTF8 (createdb -E UTF8 -U aguila oa_prod)
• Restaurer la base qu'il convient d'installer, qui se trouve dans le répertoire 'install' d'OpenAguila
  (pg_restore -U postgres -d oa_prod /usr/local/openaguila/install/oa_basic.pgsql.dump)
   

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

http://192.168.0.1:8080/oa_prod

• '192.168.0.1' 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) 

• Un problème ? Postez un message sur  la Cet e-mail est protégé contre les robots collecteurs de mails, votre navigateur doit accepter le Javascript pour le voir