Déploiement sans Tomcat (version autonome)

Télécharger la dernière version de l'application serveur en cliquant ici .

Puis suivez les étapes suivantes :

• Dézipper l'archive dans un répertoire de votre choix.

• Editer le fichier <quadrige2-synchro-server>/conf/synchro-server.config

• Modifier les propriétés suivantes :

  • quadrige2.synchro.server.security.ldap.url. Par exemple :

    ldap://ldap.domain.com

  • quadrige2.synchro.server.security.ldap.baseDn. Par exemple :

    ou=annuaire,dc=domain,dc=com

  • pour la connection Oracle : URL, user/pwd Pour le schema, attention à bien mettre le propriétaire des tables (généralement Q2_DBA) même si un user autre est utilisé.

• Lancer le serveur :

  • Sous Unix : webapp.sh (ou webapp.sh --port NNNN)

  • Sous Windows : webapp.bat (ou webapp.bat --port NNNN)

• Vérifier que le serveur est bien démarré :

  • Ouvrir dans un navigateur l'adresse : http://localhost:8080/ Une page d'accueil devrait s'ouvrir, après authentification avec vos login/mot de passe LDAP

• En cas d'erreur OutOfMemoryException :

  • Ajuster les capacités mémoire de la JVM dans le fichier de lancement (webapp.bat ou webapp.sh).

  • Déduire le nombre maximum de processus simulatné, en modifiant l'option de configuration: quadrige2.synchro.server.maxPoolSize. Il s'agit du nombre de processus maximum (importation et exportation) qui peuvent être éxecuté simultanément (Par défaut: 5). Au dela de cette valeur, les demandes sont mises en attente (dans une file d'attente).

note :

Les écrans HTML visibles depuis une navigateur ne sont pas utilisés par le client BD Récif, qui utilise des appels en webservice REST/JSON. Ces écrans servent uniquement pour le développement et les tests (ex: pour vérifier que le serveur est bien démarré).

Déploiement avec Tomcat

Configuration par variables d'environnement

Vouc pouvez choisir de déployer sous une serveur Tomcat :

• Télécharger la version autonome, comme indiqué au paragraphe précedent.

• Editer le fichier <quadrige2-synchro-server>/conf/synchro-server.config, comme indiqué au paragraphe précedent.

• Dans le répertoire <quadrige2-synchro-server>/lib/, renommer le fichier .war en observed-server.war

• Copier le fichier renommé dans <TOMCAT_HOME>/webapps/

• Ajout des drivers JDBC aux librairies du serveur:

  • Copier les librairies JDBC présents dans <quadrige2-synchro-server>/lib/*.jar dans <TOMCAT_HOME>/lib/

• Configurer les variables de configuration, dans les scripts de lancement de Tomcat :

  • Sous Unix :

    Editer le fichier <TOMCAT_HOME>/bin/startup.sh.

    Ajouter, tout en haut du script, les lignes suivantes

    quadrige2_config_path=/path/to/config/file; export quadrige2_config_path
    quadrige2_workspace_path=/path/to/working/directory; export quadrige2_workspace_path
    JAVA_OPTS="${JAVA_OPTS} -Dquadrige2.basedir=${quadrige2_workspace_path} -Dsynchro-server.config=${quadrige2_config_path}"; export JAVA_OPTS

  • Sous Windows :

    Editer le script de lancement de Tomcat <TOMCAT_HOME>/bin/startup.bat

    Ajouter, tout en haut du script, les lignes suivantes

    set quadrige2_config_path=c:\path\to\config\file
    set quadrige2_workspace_path=c:\path\to\working\directory
    set JAVA_OPTS=-Dquadrige2.basedir=${quadrige2_workspace_path} -Dsynchro-server.config=${quadrige2_config_path}

.

Configuration par contexte (META-INF/context.xml)

Un déploiement sans modification des scripts de Tomcat est possible :

• Télécharger la version autonome, comme indiqué au paragraphe précedent.

• Dans le répertoire <quadrige2-synchro-server>/lib/, dézipper le fichier .war

• Editer le fichier <UNZIPED_WAR>/META-INF/context.xml

• Décommenté les parties XML suivantes, et renseigner les attributs XML : url, username, password, value (/path/to/config/file)

  <Resource
     name="quadrige2-ds"
     auth="Container"
     type="javax.sql.DataSource"
     driverClassName="oracle.jdbc.driver.OracleDriver"
     url="jdbc:oracle:thin:@<HOST>:1521:<INSTANCE>"
     username="<USER>"
     password="<PWD>"
     maxActive="20"
     maxIdle="2"
     maxWait="-1"
   />
  
  <!-- Use to set the configuration file path (default path is: <WAR>/WEB-INF/classes/synchro-server.config) -->
  <Environment
   name="synchro-server.config"
   type="java.lang.String"
   value="/path/to/config/file"
   override="false"
  />

• Reconstruire le fichier .war, puis dployer sous Tomcat comme précédemment (sans modifier les scripts de lancement).

note :

Vous pouvez également saisir la configuration directement en éditant le fichier <UNZIPED_WAR>/WEB-INF/classles/synchro-server.config, Et laisser commenter la balise XML <Environment> du fichier context.xml