5.7 Prise en charge du protocole IPv6 par LiveCycle

Les composants d’infrastructure ne prennent pas tous en charge le protocole IPv6. Par exemple, la base de données Oracle ne prend pas en charge le protocole IPv6. Cependant, vous pouvez toujours utiliser ces bases de données. Pour cela, il suffit de configurer la connexion entre le serveur d’applications et ces bases de données via le protocole IPv4, tout en utilisant IPv6 pour le reste des communications.

• Bases de données qui prennent en charge IPv6 : Microsoft SQL Server 2005 et 2008, DB2 9.1 ou versions ultérieures de 9.x.

• Serveurs d’applications prenant en charge le protocole IPv6 : JBoss 5.1.0, WebLogic 11g, WebSphere 7.0.0.15.

Lorsque vous recourez à l’implémentation du protocole IPv6, en tout ou partie, tenez compte des points suivants :

• Après avoir installé LiveCycle, n’utilisez pas l’option pour démarrer LiveCycle Configuration Manager directement à partir du programme d’installation de LiveCycle. Accédez plutôt au répertoire [racine LiveCycle]\configurationManager\bin\IPv6 et exécutez le script spécifique à IPv6 (ConfigurationManager_IPv6.bat ou ConfigurationManager_IPv6.sh) pour démarrer LiveCycle Configuration Manager.

• Si vous avez choisi de valider la configuration du serveur d’applications à l’aide de Configuration Manager, la validation échoue lorsque vous activez IPv6 sur ce serveur. Vous pouvez ignorer ce message d’erreur lors du processus. Une fois redémarré en mode IPv6, le serveur d’applications peut se connecter à la base de données.

• (WebLogic uniquement) Vous devez activer le mode IPv6 uniquement pour les serveurs gérés. Admin Server peut poursuivre son exécution en mode IPv4. Il est alors accessible via son adresse IPv4. Cependant, le serveur géré que vous avez démarré dans l’environnement IPv6 n’est accessible que via son adresse IPv6 ou un nom d’hôte résolu via le serveur DNS.

• (WebLogic uniquement) Même si vous exécutez Configuration Manager sur l’ordinateur hébergeant le serveur d’applications, vous devez indiquer l’adresse qu’utilise le serveur géré pour écouter les communications dans le cadre de l’amorçage et du déploiement des modules LiveCycle. Cette adresse d’écoute doit correspondre au nom DNS résolu en tant qu’adresse IPv6 de l’ordinateur.

• Pour disposer de communications n’utilisant qu’IPv6 pour contacter le serveur de base de données, modifiez les paramètres de connexion EDC_DS et IDP_DS afin qu’ils utilisent le nom d’hôte de la base de données, résolu en tant qu’adresse IPv6 numérique.

• De nombreux composants de logiciels (pilotes de base de données, par exemple) ne prennent pas entièrement en charge les adresses IPv6 numériques. Il est donc recommandé d’utiliser le nom d’hôte résolu via DNS plutôt que des adresses IPv6 numériques.

• Assurez-vous que le nom utilisé pour le mappage d’IPv6 est ajouté au CSRF (section filtre). Si le nom n’est pas ajouté, voir Prévention des attaques CSRF dans Aide à l’administration.

  Remarque : le nom utilisé pour le mappage IPv6 ne doit pas contenir de crochets ([]).
• Si vous utilisez Microsoft SQL Server dans un environnement IPv6, vous devez indiquer l’adresse IP du serveur de base de données en respectant le format ci-après. N’oubliez pas que dans cette chaîne, ;serverName est un mot-clé et ne doit pas être remplacé par le nom réel du serveur.

  jdbc:sqlserver://;serverName=<IPv6 address>; portNumber=<port>;databaseName=<db_name>

  Ici, vous pouvez indiquer le nom d’hôte de la base de données SQL Server au lieu de l’adresse IPv6 numérique.

1. Vous pouvez télécharger et installer JBoss à partir de http://www.jboss.org/jbossas/downloads/ ou obtenir le fichier jboss.zip dans le répertoire tiers sur le support d’installation et extraire le fichier JBoss fourni.

2. Modifiez le fichier adobe-ds.xml et le fichier de configuration de la source de données spécifique à la base de données pour la connexion à la base de données LiveCycle.

3. Modifiez le fichier login-config.xml pour établir la connexion à la base de données LiveCycle.

4. Modifiez les fichiers suivants afin d’activer le protocole IPv6 :

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

     (JBoss 5.1, autres plateformes) [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, autres plateformes) [racine du serveur d’applications]\bin\run.sh

     Modifiez ce fichier comme suit :

     • Remplacez -Djava.net.preferIPv4Stack=true par -Djava.net.preferIPv6Stack=true.

     • Ajoutez l’argument -Djava.net.preferIPv6Addresses=true.

   • [racine serveur d’applications]\bin\service.bat: Remplacez - b 0.0.0.0 par -b <nom d'hôte associé à une adresse IPv6>.

5. Lancez Configuration Manager en appelant le script [racine LiveCycle]\configurationManager\bin\IPv6\ ConfigurationManager_IPv6.bat ou ConfigurationManager_IPv6.sh.

6. Dans Configuration Manager, sélectionnez les étapes de configuration des fichiers EAR, amorcez le serveur et déployez les modules LiveCycle.

7. Une fois le processus Configuration Manager effectué, copiez ces fichiers EAR et collez-les dans le répertoire [racine serveur d’applications]\\\server\<nom_profil>\deploy.

8. Démarrez JBoss à partir d’une ligne de commande.

9. Indiquez le nom d’hôte Configuration Manager de l’ordinateur associé à son adresse IPv6, puis amorcez le serveur d’applications pour déployer les modules LiveCycle.

1. Installez LiveCycle via le programme d’installation.

2. Ne lancez pas Configuration Manager lorsque le programme d’installation est terminé. Lancez Configuration Manager en appelant le script [racine LiveCycle]\configurationManager\bin\IPv6\ ConfigurationManager_IPv6.bat ou ConfigurationManager_IPv6.sh.

3. Sélectionnez les options de configuration des fichiers EAR de et du serveur d’applications WebLogic et vérifiez les paramètres de ce dernier à l’aide de LiveCycle Configuration Manager.

1. Dans la console d’administration WebLogic Server, modifiez les arguments de démarrage du serveur d’applications géré afin d’activer le mode IPv6.

   • Remplacez -Djava.net.preferIPv4Stack=true par -Djava.net.preferIPv6Stack=true.

   • Ajoutez l’argument -Djava.net.preferIPv6Addresses=true.

2. Modifiez l’adresse d’écoute du serveur géré afin de l’activer via l’adresse IPv6.

   • Dans WebLogic Server Administration Console, sélectionnez l’onglet Environment > Servers > [Nom serveur géré]Configuration.

   • Dans le champ Listen Address, saisissez le nom d’hôte de l’ordinateur. Assurez-vous que ce nom d’hôte est résolu en tant qu’adresse IPv6 de cet ordinateur.

3. Enregistrez les modifications, puis redémarrez le serveur géré.

4. Lancez Configuration Manager en appelant le script [racine LiveCycle]\configurationManager\bin\IPv6\ ConfigurationManager_IPv6.bat ou ConfigurationManager_IPv6.sh.

5. Dans Configuration Manager, sélectionnez les étapes de déploiement des fichiers EAR, amorcez le serveur et déployez les modules LiveCycle.

6. Indiquez le nom d’hôte fourni dans le champ de l’adresse d’écoute du serveur géré.

1. Installez LiveCycle via le script du programme d’installation. Une fois l’installation terminée, ne lancez pas Configuration Manager lorsque le programme d’installation vous invite à le faire.

2. Accédez plutôt au répertoire [racine LiveCycle]\configurationManager\bin\IPv6 et exécutez le script spécifique à IPv6 (ConfigurationManager_IPv6.bat ou ConfigurationManager_IPv6.sh) pour lancer LCM.

3. Configurez les fichiers EAR et le serveur d’applications à l’aide des options de Configuration Manager.

4. Suivez les étapes de Configuration Manager pour configurer le serveur d’applications. Lors de la configuration de la base de données, indiquez le nom d’hôte de la base de données associé à une adresse IPv6.

5. Validez la configuration du serveur d’applications faite à l’aide de Configuration Manager. Si la validation de la source de données échoue et qu’un message d’avertissement s’affiche, ignorez-le. Vous pouvez valider les sources de données à partir de la console d’administration WebSphere.

6. Dans la console d’administration WebSphere, sélectionnez Servers > Server Types > WebSphere application servers > [nom du serveur] > Java and Process Management > Process definition > Java Virtual Machine. Dans la zone Generic JVM arguments, ajoutez l’argument -Djava.net.preferIPv6Addresses=true.

7. Sélectionnez Servers > Server Types > WebSphere application servers > [nom du serveur] > Java and Process Management > Process definition > Java Virtual Machine, puis cliquez sur Custom Properties. Remplacez java.net.preferIPv4Stack=true par java.net.preferIPv6Stack=true.

8. Déployez manuellement les fichiers EAR dans WebSphere Application Server à l’aide de la console d’administration WebSphere. Les fichiers EAR configurés se trouvent dans le dossier [racine LiveCycle]/configurationManager/export.

9. Redémarrez WebSphere Application Server.

10. Accédez au répertoire [racine LiveCycle]configurationManager\bin\IPv6 et exécutez le script ConfigurationManager_IPv6.bat ou ConfigurationManager_IPv6.sh pour lancer Configuration Manager.

11. Dans Configuration Manager, sélectionnez les options permettant l’amorçage et le déploiement des modules LiveCycle. Indiquez le nom d’hôte du serveur d’applications associé à une adresse IPv6.