Installation dans Apache Tomcat
Ci-dessous un exemple de déploiement de ARender HMI pour FileNet dans le serveur d’application Apache Tomcat.
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 2023.6.0
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-2023.6.0.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-2023.6.0.war\WEB-INF\lib\arondor-arender-filenet-ce-2023.6.0.jar\META-INF\web-fragment.xml
Configuration de la connexion avec un compte technique
Ouvrir le fichier ci-dessous :
- arondor-arender-hmi-filenet-2023.6.0.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 through 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 :
- xercesImpl version 2.11.0 : Lien de téléchargement.
- xml-apis version 1.4.01 : Lien de téléchargement.
Et placer ces deux librairies dans le dossier : arondor-arender-hmi-filenet-2023.6.0.war\WEB-INF\lib.