8.13. Configuration JNDI pour ARender HMI

8.13.1. Prérequis

  • ARender 3.1.9

8.13.2. Quel est l’intérêt du JNDI dans ARender HMI ?

La configuration du JNDI permet de ne plus avoir à modifier le binaire ARender HMI à chaque livraison.

Depuis la version 3.1.9 d’ARender, la configuration serveur a été externalisée dans un fichier de propriété : arender-server.properties (situé dans le dossier WEB-INF/classes de ARender HMI). Ce qui a permis de mettre en place la technologie JNDI dans ARender pour définir la configuration directement depuis le serveur d’applciation. Ci-dessous vous trouverez un détail par serveur d’application.

8.13.3. Configuration JNDI pour Apache Tomcat

  • Créer un fichier de propriété (exemple : customer-<integration_type>.properties, avec <integration_type> le type d’intégration; vanilla, alfresco, filenet) et enregistrer le dans le dossier de votre choix (Exemple : C:\Dev\apache-tomcat-8.5.13\customConfiguration).
  • Y ajouter la configuration spécifique voulue en s’inpirant des propriétés définies dans arender-server.properties (situé dans le dossier WEB-INF/classes de ARender HMI) : Exemple : arender.server.rendition.hosts=http://localhost:8761/
  • Ouvrir le fichier de configuration Apache Tomcat context.xml (situé dans le dossier conf)
  • Y ajouter la variable d’environnement propertiesFileLocation ayant pour valeur le chemin menant vers le fichier de propriété customer-<integration_type>.properties créé ci-dessus. Exemple :
<Context>
    <Environment name="propertiesFileLocation" value="C:\Dev\apache-tomcat-8.5.13\customConfiguration" type="java.lang.String" override="false"/>
</Context>
  • Redémarrer le serveur d’application.

8.13.4. Configuration JNDI pour Wildfly

Prérequis: WAR ARender pour wildfly.

  • Créer un fichier de propriété (exemple : customer-<integration_type>.properties) et enregistrer le dans le dossier de votre choix (Exemple : C:\Dev\customConfiguration).
  • Y ajouter la configuration spécifique voulue en s’inpirant des propriétés définies dans arender-server.properties (situé dans le dossier WEB-INF/classes de ARender HMI) : Exemple : arender.server.rendition.hosts=http://localhost:8761/
  • Ouvrir le fichier de configuration Wildfly standalone.xml (situé dans le dossier configuration)
  • Y ajouter le binding propertiesFileLocation ayant pour valeur le chemin menant vers le dossier contenant le fichier de propriété customer-<integration_type>.properties créé ci-dessus. Exemple :
<subsystem xmlns="urn:jboss:domain:naming:2.0">
    <bindings>
        <simple name="java:global/propertiesFileLocation" value="C:\Dev\customConfiguration\" type="java.lang.String"/>
    </bindings>
    <remote-naming/>
</subsystem>
  • Redémarrer le serveur d’application.

8.13.5. Configuration JNDI pour Websphere

  • Créer un fichier de propriété (exemple : customer-<integration_type>.properties) et enregistrer le dans le dossier de votre choix (Exemple : C:\Dev\customConfiguration).
  • Y ajouter la configuration spécifique voulue en s’inpirant des propriétés définies dans arender-server.properties (situé dans le dossier WEB-INF/classes de ARender HMI) : Exemple : arender.server.rendition.hosts=http://localhost:8761/
  • Ouvrir la console Websphere et se rendre dans : Environnement -> Attribution des noms -> Liaisons de l’espace de nom :
../../_images/Websphere_JNDI_Naming.png
  • Cliquer sur nouveau puis sélectionner chaine et cliquer sur suivant :
../../_images/Websphere_JNDI_Naming_new_value.png
  • Remplir les champs comme suit puis cliquer sur suivant

-> Identificateur de liaison : propertiesFileLocation

-> Nom de l’espace de nom relatif pour rechercher un préfixe de nom “cell/node/nodename/servers/serverName (en remplaçant les noms de noeud et nom de serveur) : Exemple cell/node/*nodename*/servers/*serverName*/propertiesFileLocation

-> Valeur de la chaîne : le chemin menant vers le dossier contenant le fichier de propriété customer-<integration_type>.properties créé ci-dessus

../../_images/Websphere_JNDI_Naming_set_property.png
  • Enfin cliquer sur Terminer
../../_images/Websphere_JNDI_Naming_Summary.png
  • Redémarrer le serveur d’application.