Configuration JNDI pour ARender HMI

Prérequis

version >= ARender 3.1.9

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.

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) :
```
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.

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) :
```
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.

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) :
arender-server.properties
```
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 :

Cliquer sur nouveau puis sélectionner chaine et cliquer sur suivant :

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) :

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

Enfin cliquer sur Terminer

Redémarrer le serveur d’application.