6.12 Configuration du service Connector for IBM FileNet

LiveCycle ne prend en charge que les versions 4.0, 4.5 et 5.0 d’IBM FileNet. Vérifiez que votre version d’ECM est à niveau.

Si vous avez installé Connector for IBM FileNet dans le cadre de votre solution LiveCycle, configurez le service de manière à ce qu’il se connecte à la banque d’objets FileNet.

Pour configurer le service Connector for IBM FileNet, procédez comme suit.

Configuration de Connector for IBM FileNet à l’aide de FileNet 4.x ou FileNet 5.0 et du transport CEWS

  1. Ouvrez le fichier d’exécution du serveur d’applications dans un éditeur de texte. Le fichier exécutable est le suivant :

    • (JBoss 5.1, Windows) [racine du serveur d’applications]/bin/run.conf

    • (JBoss 5.1, non Windows) [racine du serveur d’applications]/bin/run.conf

    • (JBoss 4.2.1, Windows) [racine du serveur d’applications]/bin/run.bat

    • (JBoss 4.2.1, non windows) [racine du serveur d’applications]/bin/run.sh

  2. (Uniquement pour FileNet 4.x) Ajoutez l’emplacement des fichiers de configuration FileNet comme option Java dans la commande start du serveur d’applications, puis enregistrez le fichier.

    Remarque : si JBoss est exécuté en tant que service, vous devez ajouter l’option Java dans le registre où sont définis les arguments JVM.
  3. -Dwasp.location= <configuration files location>

    Par exemple, avec une installation par défaut de FileNet Application Engine sous un système d’exploitation Windows, vous devez ajouter l’option Java :

    -Dwasp.location=C:/Progra~1/FileNet/AE/CE_API/wsi
  4. Si votre déploiement utilise le service Process Engine Connector, copiez le fichier [racine du serveur d’applications]\client\logkit.jar dans le répertoire suivant :

    • (JBoss 5.1 configuré manuellement, grappe de serveurs) [racine du serveur d’applications]/server/all/lib

    • (JBoss 5.1 configuré manuellement, serveur unique) [racine du serveur d’applications]/server/standard/lib

    • (JBoss préconfiguré par Adobe, grappe de serveurs) [racine du serveur d’applications]/server/lc_<nom_bdd>_cl/lib

    • (JBoss préconfiguré par Adobe, serveur unique) [racine du serveur d’applications]/server/lc_<nom_bdd>/lib

    • (JBoss 4.2.1 configuré manuellement, grappe de serveurs) [racine du serveur d’applications]/server/all/lib

    • (JBoss 4.2.1 configuré manuellement, serveur unique, mise à niveau uniquement) [racine du serveur d’applications]/server/all/lib

  5. Localisez le fichier adobe-component-ext.properties dans le dossier /bin[racine du serveur d’applications] (si le fichier n’existe pas, créez-le).

  6. Ajoutez une nouvelle propriété système qui fournit l’emplacement des fichiers JAR Application Engine suivants :

    Pour FileNet 4.x, ajoutez les fichiers JAR suivants.

    • javaapi.jar

    • soap.jar

    • wasp.jar

    • builtin_serialization.jar (FileNet 4.0 uniquement)

    • wsdl_api.jar

    • jaxm.jar

    • jaxrpc.jar

    • saaj.jar

    • jetty.jar

    • runner.jar

    • p8cjares.jar

    • Jace.jar

    • (facultatif) pe.jar

    Pour FileNet 5.0, ajoutez les fichiers JAR suivants.

    • Jace.jar

    • javaapi.jar

    • log4j.jar

    • pe.jar

    • stax-api.jar

    • xlxpScanner.jar

    • xlxpScannerUtils.jar

    Remarque : ajoutez le fichier pe.jar uniquement si votre déploiement utilise le service IBMFileNetProcessEngineConnector. La nouvelle propriété système doit avoir la forme suivante :
    [component id].ext=[JAR files and/or folders]

    Par exemple, avec une installation par défaut de FileNet Application Engine sous un système d’exploitation Windows, vous devez ajouter la propriété système suivante sur une nouvelle ligne, sans saut de ligne, et terminer la ligne par un retour chariot :

    Remarque : le texte suivant contient des caractères de formatage pour les sauts de ligne. Si vous copiez ce texte vers un emplacement en dehors de ce document, supprimez les caractères de formatage lorsque vous le collez à son emplacement.
    com.adobe.livecycle.ConnectorforIBMFileNet.ext= 
    C:/Program Files/FileNet/AE/CE_API/lib2/javaapi.jar, 
    C:/Program Files/FileNet/AE/CE_API/lib2/log4j-1.2.13.jar
  7. (FileNet Process Engine Connector uniquement) Configurez les propriétés de connexion du moteur de processus comme suit :

    • Dans un éditeur de texte, créez un fichier avec le contenu suivant sur une seule ligne, puis terminez cette ligne par un retour chariot :

      RemoteServerUrl = cemp:http://[contentserver_IP]:[contentengine_port]/ wsi/FNCEWS40DIME/
    • Enregistrez le fichier dans un dossier à part sous le nom de WcmApiConfig.properties et ajoutez l’emplacement de ce dossier dans le fichier adobe-component-ext.properties.

      Par exemple, si vous enregistrez le fichier sous c:/pe_config/WcmApiConfig.properties, ajoutez le chemin c:/pe_config au fichier adobe-component-ext.properties.

      Remarque : le nom de fichier est sensible à la casse.
  8. Localisez le fichier login-config.xml dans le dossier suivant et ajoutez la stratégie d’application en tant qu’enfant du nœud <policy > :

    • (JBoss 5.1 configuré manuellement, serveur unique) [racine du serveur d’applications]/server/standard/conf

    • (JBoss 5.1 configuré manuellement, grappe de serveurs) [racine du serveur d’applications]/server/all/conf

    • (JBoss préconfiguré par Adobe, serveur unique) [racine du serveur d’applications]/server/lc_<nom_bdd>/conf

    • (JBoss préconfiguré par Adobe, grappe de serveurs) [racine du serveur d’applications]/server/lc_<nom_bdd>_cl/conf
              <application-policy name = "FileNetP8WSI"> 
               <authentication>  
               <login-module code = "com.filenet.api.util.WSILoginModule" flag = 
                      "required" /> 
               </authentication>  
              </application-policy>
    • (JBoss 4.2.1 configuré manuellement, serveur unique, mise à niveau uniquement) [racine du serveur d’applications]/server/all/conf

    • (JBoss 4.2.1 configuré manuellement, grappe de serveurs, mise à niveau uniquement) [racine du serveur d’applications]/server/all/conf

  9. (FileNet Process Engine Connector uniquement) Si votre déploiement utilise Process Engine, ajoutez au fichier login-config le nœud suivant :

            <application-policy name = "FileNetP8"> 
                <authentication> 
                    <login-module code = "com.filenet.api.util.WSILoginModule" flag = 
                    "required" /> 
                </authentication> 
            </application-policy>
  10. Si le serveur d’applications n’est pas en cours d’exécution, démarrez le serveur. Sinon, arrêtez, puis redémarrez le serveur.

  11. Si JBoss s’exécute en tant que service, démarrez (ou redémarrez) le service JBoss pour Adobe LiveCycle ES3.

  12. (Grappe uniquement) Répétez toutes les étapes précédentes sur chaque instance au niveau de la grappe.

  13. Ouvrez un navigateur Web, puis saisissez l’URL suivante :

    http://[hôte]:[port]/adminui

  14. Connectez-vous à l’aide du nom d’utilisateur et du mot de passe par défaut :

    Nom d’utilisateur : administrator

    Mot de passe : password

  15. Cliquez sur Services > LiveCycle ES3 Connector for IBM FileNet.

  16. Saisissez les informations requises concernant le référentiel FileNet, puis, dans la zone Informations sur le fournisseur de services de référentiels, sélectionnez Fournisseur du référentiel IBM FileNet.

    Si votre déploiement utilise le service facultatif Process Engine, sélectionnez Use Process Engine Connector Service dans la zone Options de Process Engine, puis indiquez les paramètres de Process Engine. Pour plus d’informations, cliquez sur le lien Aide dans le coin supérieur droit de la page.

    Remarque : les informations d’identification entrées lors de cette étape sont validées par la suite, lors du démarrage des services de référentiels IBM FileNet. Si ces informations ne sont pas valides, une erreur est générée et les services ne démarrent pas.
  17. Cliquez sur Enregistrer, puis sélectionnez Services > Applications and Services > Gestion des services.

  18. Sélectionnez les services suivants, puis cliquez sur Démarrer :

    • IBMFileNetAuthProviderService

    • IBMFileNetContentRepositoryConnector

    • IBMFileNetRepositoryProvider

    • IBMFileNetProcessEngineConnector (si configuré)

    Si l’un des services ne démarre pas correctement, vérifiez les paramètres de Process Engine.

  19. Effectuez l’une des opérations suivantes :

    • Pour utiliser le service FileNet Authorization (IBMFileNetAuthProviderService) afin d’afficher le contenu d’une banque d’objets FileNet dans l’affichage Ressources de Workbench, procédez comme suit. Le service FileNet Authorization remplace l’autorisation de LiveCycle par défaut et doit être configuré en vue d’une connexion à Workbench à l’aide des informations d’identification de FileNet.

    • Pour utiliser le référentiel LiveCycle, connectez-vous à Workbench à l’aide des informations d’identification de super-administrateur de LiveCycle (par défaut, administrator et password). Les informations d’identification fournies à l’étape 16 utilisent le service d’autorisation par défaut de LiveCycle pour accéder au référentiel par défaut dans ce cas.

  20. Redémarrez le serveur d’applications.

  21. Connectez-vous à Administration Console et cliquez sur Paramètres > User Management > Gestion des domaines.

  22. Cliquez sur Nouveau domaine d’entreprise, puis saisissez le nom et l’identifiant du domaine. L’identifiant du domaine est unique. Le nom est la description du domaine.

    Lors de l’utilisation de MySQL pour la base de données LiveCycle, utilisez uniquement des caractères ASCII (codés sur un octet) pour définir l’ID (Voir Ajout de domaines d’entreprise dans Aide à l’administration de LiveCycle).

  23. Ajoutez un fournisseur d’authentification personnalisé:

    • Cliquez sur Ajouter une authentification.

    • Dans la liste Fournisseur d’authentification, sélectionnez Personnalisé.

    • Sélectionnez IBMFileNetAuthProviderService, puis cliquez sur OK.

  24. Ajoutez un fournisseur d’authentification LDAP :

    • Cliquez sur Ajouter une authentification.

    • Dans la liste Fournisseur d’authentification, sélectionnez LDAP, puis cliquez sur OK.

  25. Ajoutez un annuaire LDAP :

    • Cliquez sur Ajouter un annuaire puis, dans la zone Nom du profil, saisissez un nom unique et cliquez sur Suivant.

    • Renseignez les zones Serveur, Port, SSL, Liaison et Remplir la page avec. Si vous sélectionnez Utilisateur pour l’option Liaison, vous devez également spécifier les valeurs des champs Nom et Mot de passe.

    • (Facultatif) Sélectionnez Récupérer les DN de base pour récupérer les noms de domaine de base comme requis. Lorsque vous avez terminé, cliquez sur Suivant.

    • Configurez les paramètres utilisateur, cliquez sur Suivant, configurez les paramètres de groupe comme requis, puis cliquez sur Suivant.

      Pour plus d’informations sur les paramètres, cliquez sur le lien Aide dans le coin supérieur droit de la page.

  26. Cliquez sur OK pour fermer la page Ajouter un annuaire, puis de nouveau sur OK.

  27. Sélectionnez le nouveau domaine d’entreprise, puis cliquez sur Synchroniser maintenant. En fonction du nombre d’utilisateurs et de groupes sur votre réseau LDAP et du débit de votre connexion, le processus de synchronisation peut prendre plusieurs minutes.

    (Facultatif) Pour vérifier l’état de la synchronisation, cliquez sur Actualiser, puis affichez l’état dans la colonne Etat de synchronisation actuel.

  28. Accédez à Paramètres > User Management > Utilisateurs et groupes.

  29. Recherchez les utilisateurs synchronisés via LDAP et effectuez les tâches suivantes :

    • Sélectionnez un ou plusieurs utilisateurs et cliquez sur Affecter le rôle.

    • Sélectionnez un ou plusieurs rôles LiveCycle, puis cliquez sur OK.

    • Cliquez une deuxième fois sur OK pour confirmer l’affectation des rôles.

    Répétez cette étape pour tous les utilisateurs auxquels vous voulez affecter des rôles. Pour plus d’informations, cliquez sur le lien Aide dans le coin supérieur droit de la page.

  30. Démarrez Workbench et ouvrez une session à l’aide des informations d’identification suivantes du référentiel IBM FileNet :

    Nom d’utilisateur : [nom_utilisateur]@[nom_référentiel]

    Mot de passe : [password]

    A présent, la banque d’objets FileNet doit être visible dans l’affichage Ressources de Workbench. Si vous ne vous connectez pas en utilisant nom_utilisateur@nom_référentiel, Workbench essaie de se connecter au référentiel par défaut spécifié à l’étape 16.

  31. (Facultatif) Pour installer des exemples LiveCycle pour Connector for IBM FileNet, créez une banque d’objets FileNet nommée Exemples, puis installez-y les exemples.

    Une fois Connector for IBM FileNet configuré, il est recommandé de se reporter à l’Aide à l’administration de LiveCycle pour obtenir plus d’informations sur la configuration appropriée des fonctions de Workbench à l’aide du référentiel FileNet.