Documentation

La base de connaisance complète sur ARender - Comment l’installer et le configurer pour répondre à vos besoins

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 :

image

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

image

  • 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

image

  • Enfin cliquer sur Terminer

image

  • Redémarrer le serveur d’application.