ARender pour FileNet dans Apache Tomcat

Ci-dessous un exemple de déploiement de ARender HMI pour FileNet dans le serveur d’application Apache Tomcat.

Attention

Limitation : l’authentification d’ARender vers FileNet doit se faire via un compte technique.

Par conséquent :

  • Les documents/annotations/métadonnées vont être récupérés via le compte technique,
  • Les annotations seront sauvegardées au nom du compte technique.

Si le besoin est de propager l’authentification il faut utiliser le déploiement dans le serveur d’application IBM Websphere (voir la documentation ici).

Dans notre exemple, nous déployons ARender HMI dans l’environnement suivant :

  • Système d’exploitation : Windows Server 2016
  • Filenet 5.5
  • Apache Tomcat 9.0
  • ARender HMI pour FileNet version 4.8.15

Télécharger le WAR ARender HMI pour FileNet

En utilisant l’identifiant et mot de passe préalablement fournis, vous pouvez récupérer l’application web en format EAR ici.

Configuration d’ARender HMI WAR pour FileNet

Plusieurs configurations additionnelles sont nécessaires pour faire fonctionner ARender pour FileNet dans Apache Tomcat.

Configuration du user-context

Ouvrir le fichier ci-dessous :

  • arondor-arender-hmi-filenet-4.8.15.war\WEB-INF\classes\arender-user-context.xml

Et remplacer le bean ayant l’id suivant urlFilter par le bean ci-dessous :

<bean id="urlFilter"
    class="com.arondor.viewer.server.security.RequestParameterAuthenticationFilter">
    <property name="authenticationManager" ref="authenticationManager" />
</bean>

Configuration de la sécurité

Supprimer le fichier ci-dessous :

  • arondor-arender-hmi-filenet-4.8.15.war\WEB-INF\lib\arondor-arender-filenet-ce-4.8.15.jar\META-INF\web-fragment.xml

Configuration de la connexion avec un compte technique

Ouvrir le fichier ci-dessous :

  • arondor-arender-hmi-filenet-4.8.15.war\WEB-INF\classes\arender-server-custom-filenet.properties

Et ajouter le contenu ci-dessous (en adaptant les valeurs selon votre contexte) :

# Default authentication method is jaasObjectStoreProvider. To activate connect throught a technical account use loginPasswordObjectStoreProvider and set the right login and password below
arender.server.filenet.authentication.method=loginPasswordObjectStoreProvider
# Exemple of URL for jaasObjectStoreProvider: iiop://localhost:2809/FileNet/Engine and for loginPasswordObjectStoreProvider : http://localhost:9080/wsi/FNCEWS40MTOM/
arender.server.filenet.ce.url=http://localhost:9080/wsi/FNCEWS40MTOM/
arender.server.filenet.ce.login=loginToChange
arender.server.filenet.ce.password=passwordToChange

Ajout des librairies additionnelles

Télécharger les JARs ci-dessous :

Et placer ces deux librairies dans le dossier : arondor-arender-hmi-filenet-4.8.15.war\WEB-INF\lib.