5 Activités après le déploiement

    5.1 Mise en grappe de l’instance d’auteur pour Correspondence Management

    Une fois la solution Correspondence Management déployée, l’instance d’auteur s’exécute sur le même serveur que LiveCycle ES3. Cependant, la grappe de l’instance d’auteur Correspondence Management n’est pas configurée en même temps que la grappe LiveCycle. Il vous faut la configurer manuellement.

    La mise en grappe de l’instance d’auteur ne présente aucune dépendance par rapport à la mise en grappe LiveCycle. La grappe LiveCycle agit en effet en tant que système d’arrière-plan pour la mise en grappe de l’instance d’auteur si LiveCycle est intégré à la solution Correspondence Management (voir 5.3 Intégration de LiveCycle à la solution Correspondence Management. Correspondence Management ne prend pas en charge le mode de mise en grappe shared nothing (sans partage).
    Remarque : voir cet article technique pour plus d’informations sur le mode « shared nothing ».
    Suivez ces étapes pour configurer la mise en grappe pour Correspondence Management :

    1. Déterminez l’instance qui sera l’instance maître. Notez le nom d’hôte et le numéro du port de cette instance. Par exemple, si vous exécutez l’instance maître sur l’ordinateur node1/port 8080, son adresse est node1:8080.

    2. Toutes les instances autres que l’instance maître sont des instances esclaves. La console CRX de chaque instance est accessible à l’adresse http://<adresse-esclave>/crx/index.jsp.

      Par exemple, si vous exécutez une instance esclave sur un ordinateur node2:port 8080, vous pouvez vous connecter à sa console CRX à l’aide de l’adresse http://node2:8080/crx/index.jsp.

    3. Une fois connecté à la console de l’instance esclave, cliquez sur Repository Configuration (Configuration du référentiel).

    4. Cliquez sur Cluster (Grappe) dans la liste Tools (Outils) de la page Repository Configuration.

    5. Saisissez l’adresse Web de l’instance maître dans le champ Master URL (URL du maître). Saisissez cette information au format suivant :
      http://<master-address>/crx/config/cluster.jsp
      Par exemple, si les instances maître et esclave sont exécutées respectivement sur node1 et node2, saisissez :
      http://node1:8080/crx/config/cluster.jsp

    6. Saisissez le nom d’utilisateur CRX et le mot de passe associé et cliquez ensuite sur Join (Joindre). L’accès administrateur est requis pour pouvoir configurer un cluster.

    7. L’opération de jonction de la grappe peut prendre plusieurs minutes. Après confirmation de la réussite de la demande de jonction, répétez la procédure de jonction sur chacune des instances esclaves.
      Remarque : il peut être nécessaire de redémarrer l’instance esclave pour éviter la péremption des sessions.
    Important : toutes les instances d’auteur de la grappe doivent avoir la même heure. Vous pouvez utiliser un serveur NTP (Network Time Protocol, protocole d’heure réseau) pour assurer leur synchronisation.
    Important : si vous configurez la mise en grappe dans votre solution Correspondence Management, vous devez vous assurer que le chemin d’accès au référentiel CRX ne contient aucun espace.

      5.1.1 Exigences spécifiques à WebSphere

      Des étapes de configuration supplémentaires sont nécessaires pour permettre l’utilisation de l’outil Dispatcher avec le serveur d’applications WebSphere. Les propriétés suivantes doivent être définies sur true pour le conteneur Web :
      com.ibm.ws.webcontainer.extractHostHeaderPort 
trusthostheaderport
      Définissez ces propriétés comme suit :

      1. Dans LiveCycle Administration Console, cliquez sur Servers > Server Types > WebSphere application servers > [nom_du_serveur] > Web Container Settings > Web Container.

      2. Sous Additional Properties, cliquez sur Custom Properties.

      3. Cliquez sur New sur la page Custom Properties.

      4. Sur la page des paramètres, saisissez le nom de la propriété personnalisée que vous voulez configurer dans le champ Name ainsi que la valeur que vous souhaitez lui attribuer dans le champ Value.

      5. Cliquez sur Apply ou sur OK.

      6. Cliquez sur Save dans la barre des tâches de la console pour enregistrer les modifications apportées à la configuration.

      7. Répétez les étapes 1 à 6 pour chacun des serveurs de la grappe.

      8. Redémarrez la grappe.

      Remarque : assurez-vous la liste des alias default_host contient les mêmes numéros de port que le serveur Web s’exécutant par-dessus la grappe WebSphere.

      5.2 Configuration de l’instance de publication

      Vous devez exécuter des instances distinctes d’auteur et de publication pour la solution Correspondence Management. Toutefois, vous pouvez configurer les deux instances sur le même ordinateur ou sur deux ordinateurs différents.

      Remarque : avant de configurer l’instance de publication, assurez-vous que l’instance d’auteur est configurée et déployée. Vous pouvez le vérifier en vous connectant au modèle de solution pour la solution Correspondence management. Voir 4.3 Accès au modèle de la solution pour plus d’informations.

      1. Créez un profil de serveur d’applications pour l’instance de publication sur le même ordinateur ou sur un ordinateur différent.

      2. Sur l’instance d’auteur, accédez au répertoire [racine LiveCycle]/configurationManager/export/.

      3. Copiez le fichier adobe-livecycle-publish-[serveur d’aplications].ear et déployez-le sur le profil de serveur d’applications créé à l’étape 1.

      4. Copiez le répertoire [racine LiveCycle]/configurationManager/export/crx-quickstart vers le serveur de fichiers pour l’instance de publication.

      5. Démarrez le serveur de publication à l’aide du paramètre -Dcom.adobe.livecycle.crx.home=<emplacement de crx-quickstart>, où <emplacement de crx-quickstart> correspond à l’emplacement où vous avez copié le répertoire crx-quickstart pour l’instance de publication.

      Remarque : si les instances de publication et d’auteur se trouvent sur le même ordinateur, veillez à démarrer l’instance de publication avec un port différent.

      Maintenant que l’instance de publication fonctionne, vous devez configurer les deux instances pour qu’elles communiquent ensemble.

      Important : si vous configurez la mise en grappe dans votre solution Correspondence Management, vous devez vous assurer que le chemin d’accès au référentiel CRX ne contient aucun espace.

        5.2.1 Configuration de l’instance d’auteur

          5.2.1.1 Définition de l’URL de l’instance de publication

          1. Accédez à http://<hôteAuteur>:<portAuteur>/lc/etc/replication/agents.author/publish.html.

          2. Cliquez sur Edit (Modifier). La boîte de dialogue Agent Settings (Paramètres des agents) s’ouvre.

          3. Cliquez sur l’onglet Transport et spécifiez l’URL du serveur de publication dans le champ URI.

            http://<hôtePublication>:<portPublication>/lc/bin/receive?sling:authRequestLogin=1

          4. Cliquez sur OK.

          Remarque : pour les grappes d’auteur, ces étapes doivent être exécutées sur une instance d’auteur (instance maître de préférence).

          5.2.1.2 Définition de l’URL de l’instance de publication pour ActivationManagerImpl

          1. Accédez à http://<hôteAuteur>:<portAuteur>/lc/system/console/configMgr.

          2. Recherchez l’icône d’édition située en regard du paramètre com.adobe.livecycle.content.activate.impl.ActivationManagerImpl et cliquez dessus.

          3. Dans le champ ActivationManager Publish URL (URL de publication ActivationManager), spécifiez l’URL de l’instance de publication correspondante.

          4. Cliquez sur Save (Enregistrer).

          5.2.1.3 Configuration de la file d’attente de réplication inversée

          1. Accédez à http://<hôteAuteur>:<portAuteur>/lc/etc/replication/agents.author/publish_reverse.html.

          2. Cliquez sur Edit (Modifier). La boîte de dialogue Agent Settings (Paramètres des agents) s’ouvre.

          3. Cliquez sur l’onglet Transport et spécifiez l’URL du serveur de publication correspondante dans le champ URI.

          4. Cliquez sur OK.

          5.2.2 Configuration de l’instance de publication

            5.2.2.1 Définition de l’URL de l’instance d’auteur

            1. Accédez à http://<hôtePublication>:<portPublication>/lc/system/console/configMgr.

            2. Recherchez l’icône d’édition située en regard du paramètre com.adobe.livecycle.content.activate.impl.VersionRestoreManagerImpl et cliquez dessus.

            3. Dans le champ VersionRestoreManager Author URL (URL d’auteur VersionRestoreManager), spécifiez l’URL de l’instance d’auteur correspondante.

            4. Cliquez sur Save (Enregistrer).

            5.3 Intégration de LiveCycle à la solution Correspondence Management

            Important : suivez les étapes suivantes dans le cas d’un déploiement non clé en main. Pour les grappes d’auteur, suivez ces étapes sur une instance d’auteur (instance maître de préférence). Dans le cas des grappes de publication, suivez ces étapes sur toutes les instances de publication.

            1. Accédez à http://[hôte]:[port]/lc/system/console/dsc et connectez-vous en utilisant admin comme nom d’utilisateur et mot de passe.

            2. Dans le champ Document Server URL (URL de Document Server), vérifiez que http://[hôte]:[port] est spécifié.
              Important : vérifiez que le serveur Document Server écoute la combinaison d’hôte et de port spécifiée. Les trois scénarios suivants sont possibles dans une grappe de serveurs LiveCycle :

              • Toutes les instances de serveur LiveCycle s’exécutent sur hôtelocal et le même port. Dans ce cas, utilisez hôtelocal:[port].

              • Toutes les instances de serveur LiveCycle s’exécutent sur hôtelocal mais sur des ports différents. Dans ce cas, utilisez une combinaison de nom d’hôte et port d’équilibreur de charge : [hôte_équilibreurDeCharge]:[port_équilibreurDeCharge].

              • Toutes les instances de serveur LiveCycle s’exécutent sur un nom d’hôte particulier (différent de hôtelocal) et des ports similaires/différents. Dans ce cas, utilisez un nom d’hôte et un port d’équilibreur de charge : [hôte_équilibreurDeCharge]:[port_équilibreurDeCharge].

              Si vous souhaitez utiliser une URL d’équilibreur de charge pour accéder à la grappe de serveurs LiveCycle (comme indiqué ci-dessus), veillez à ce que les ports de communication requis entre les instances d’auteur et l’équilibreur de charge soient ouverts.

            3. Spécifiez les informations d’identification de l’administrateur LiveCycle dans les champs Nom d’utilisateur et Mot de passe.

            4. Dans le champ Experience Server URL (URL d’Experience Server), spécifiez http://[hôte]:[port]/lc.
              Vérifiez que le serveur Experience Server écoute la combinaison d’hôte et de port spécifiée. La logique d’hôte/port mentionnée dans la remarque de l’étape 2 s’applique également au serveur Experience Server.

            5. Vérifiez que crxuserfordsc est spécifié dans le champ System user for accessing Experience Server (Utilisateur système pour l’accès à Experience Server).

            6. Spécifiez dscuserforcrx dans le champ System user for accessing Document Server (Utilisateur système pour l’accès à Document Server).

              Remarque : les utilisateurs mentionnés aux étapes 5 et 6 doivent être différents pour chaque instance de publication.

            7. Assurez-vous que toutes les cases à cocher sont sélectionnées.

            8. Cliquez sur Configure. Un message apparaît à l’écran, une fois la configuration terminée.

              5.4 Installation d’exemples d’utilisateur

              Vous pouvez installer des exemples d’utilisateur avec des autorisations d’utilisateurs prédéfinies afin d’explorer plus en détail le modèle de solution, que vous pouvez par ailleurs personnaliser afin de créer votre propre solution.

              1. Accédez à http://<hôteAuteur>:<portAuteur>/crx. La console du référentiel de contenu s’ouvre.

              2. Cliquez sur Package Share et connectez-vous à l’aide de votre ID Adobe et mot de passe.

              3. Saisissez samples-correspondencemanagement-pkg dans le champ de recherche et appuyez sur Entrée.

              4. Cliquez sur Download en regard du package samples-correspondencemanagement-pkg-<version>, où <version> correspond à la dernière version dans les résultats de recherche.

              5. Acceptez le contrat de licence puis cliquez sur OK lorsque vous êtes invité à télécharger le package.

              6. Lorsque le téléchargement est terminé, cliquez sur Downloaded en regard du package afin d’ouvrir Package Manager.

              7. Dans Package Manager, cliquez sur Install en regard du package téléchargé.

              8. Cliquez sur Install dans la boîte de dialogue de confirmation afin d’installer les exemples d’utilisateurs.

              9. (Facultatif) Répétez les étapes 1 à 8 sur l’instance de publication si vous souhaitez y installer des exemples d’utilisateur.

              Pour plus d’informations sur les exemples d’utilisateur et les instructions de mise en œuvre d’une solution à l’aide d’un modèle de solution, voir le Guide de la solution Correspondence Management.
              Remarque : pour les grappes d’auteur, ces étapes doivent être exécutées sur une instance d’auteur (instance maître de préférence).

                5.5 Configuration de l’implémentation IPv6

                Remarque : effectuez ces étapes uniquement si la solution Correspondence Management est exécutée sur un ordinateur utilisant une adresse IPv6.

                Etapes de mappage de l’adresse IPv6 d’un nom d’hôte sur le serveur et les machines clientes :

                1. Accédez au répertoire C:\Windows\System32\drivers\etc.

                2. Ouvrez le fichier hosts dans un éditeur de texte.

                3. Ajoutez un mappage pour l’adresse IPv6 d’un nom d’hôte. Par exemple :

                  2001:1890:110b:712b:d1d:9c99:37ef:7281 <ipv6_hostname>

                4. Enregistrez le fichier, puis fermez-le.

                Assurez-vous d’utiliser le nom d’hôte mappé au lieu de l’adresse IPv6 lors de l’accès à la solution Customer Experience.

                  5.6 Installation des polices japonaises pour Adobe Reader

                  Si vos actifs Correspondence Management utilisent les polices japonaises, vous devez installer le package de support pour le japonais pour Adobe Reader. Dans le cas contraire, vos lettres et formulaires ne s’afficheront pas et ne fonctionneront pas correctement. Pour l’installation des packs de langues, visitez la page des téléchargements d’Adobe Reader.

                    5.7 Désinstallation de la solution Correspondence Management

                    1. Accédez au répertoire [racine LiveCycle]\Uninstall_Correspondence Management Solution.

                    2. Exécutez le script ou l’application de désinstallation de la solution Correspondence Management.

                    3. Suivez les instructions de la procédure de désinstallation.

                    Remarque : une fois la solution Correspondence Management désinstallée, vous ne pouvez exécuter que LiveCycle en réexécutant Configuration Manager. Toutefois, dans le cas des déploiements clé en main, il vous faut restaurer le fichier adobe-jboss-core.ear.orig en le renommant adobe-jboss-core.ear.
                    Remarque : le programme de désinstallation ne supprime pas les données du référentiel de contenu. Si vous n’avez plus de besoin de ces données, vous pouvez supprimer manuellement le répertoire [racine LiveCycle]/configurationManager/export/crx-quickstart/.

                      5.8 Equilibrage de la charge de la grappe d’auteur/batterie de publication à l’aide de Dispatcher

                      Vous pouvez équilibrer la charge de toutes les demandes entrantes dirigées vers les instances d’auteur/de publication en utilisant Dispatcher, l’outil de détection et d’équilibrage de charge d’Adobe destiné à CRX. Dispatcher est fourni sous la forme d’un module externe utilisable avec n’importe quel serveur Web : Apache, IIS, iPlanet ou autre. Voir cet article technique pour plus d’informations.

                      Les fonctions suivantes qui sont fournies par Dispatcher présentent une importance particulière pour la solution Correspondence Management :

                      • Equilibrage de la charge

                      • Affinité de session

                      • Gestion des sessions

                      Si une instance Apache est déjà utilisée pour la grappe LiveCycle, vous pouvez utiliser la même installation Apache en exécutant des instances distinctes sur des ports différents à l’aide d’un autre fichier de configuration (httpd.conf). Les instances d’auteur et de publication peuvent être toutes deux gérées avec la même configuration de Dispatcher. Dans ce scénario, il vous faut configurer à la fois les batteries d’auteur et de publication.

                      Il vous est également possible de configurer des instances distinctes de Dispatcher pour les instances d’auteur et de publication. Pour configurer ce scénario, apportez-les modifications suivantes au fichier de configuration de Dispatcher, dispatcher.any :
                      En-têtes de client :
                      ajoutez un en-tête personnalisé AEP-APP-ROOT pour Correspondence Management :
                      /clientheaders 
{ 
"referer" 
"user-agent" 
............. 
............ 
.......... 
"AEP-APP-ROOT" 
}

                      Renders :
                      les instances d’auteur et de publication d’une batterie sont représentées par des renders. La charge est équilibrée entre ces différents renders.
                      /renders 
{ 
/node01 
{ 
#hostname or IP of the render 
/hostname "node1.com" 
#Port of the render 
/port "8080" 
/timeout "0" 
} 
/node02 
{ 
#hostname or IP of the render 
/hostname "node2.com" 
#Port of the render 
/port "8080" 
/timeout "0" 
} 
}

                      Filtres :
                      permettent de spécifier les demandes que le module Dispatcher doit accepter. Les autres demandes sont renvoyées vers le serveur où elles sont proposées aux autres modules exécutés sur le serveur Web.
                      /filter 
{ 
#deny everything and allow specific entries 
/001 {/type deny /glob "*"} 
/002 {/type allow /glob "* /admin/*"} # allow servlet engine admin 
/003 {/type allow /glob "* /crx/*"} # allow content repository 
/004 {/type allow /glob "* /system/*"} # allow OSGi console 
/0023 { /type "allow" /glob "* /content*" } #  disable this rule to allow mapped content only 
}

                      Affinité des connexions :
                      définissez l’affinité des connexions sur "/" car le contenu de la solution Correspondence Management réside dans diverses structures de répertoire menant vers différents chemins à partir de "/".
                       /stickyConnectionsFor "/"

                      Gestion des sessions :
                      le cookie login-token est utilisé pour la gestion des sessions de Correspondence Management. Déclarez la configuration suivante dans la section de gestion des sessions :

                      /header "Cookie: login-token"