4.4 Configuration des localisateurs de mise en cache dans des grappes (mise en cache via TCP uniquement)

Le programme d’installation de LiveCycle crée une configuration par défaut pour les localisateurs TCP. Cette configuration est prête à l’emploi et ne nécessite pas de modification. Vous pouvez déplacer les localisateurs vers n’importe quel ordinateur de votre réseau et les exécuter sur celui-ci. Les localisateurs n’ont pas besoin de se trouver sur un ordinateur membre de la grappe LiveCycle. Vous pouvez également créer des localisateurs de basculement supplémentaires, pour une haute disponibilité au sein de votre grappe (voir Installation des localisateurs TCP).

Vous pouvez également modifier les localisateurs TCP afin d’utiliser un port autre que le port par défaut (22345) (voir Modification du port des localisateurs par défaut (Windows) ou Modification de la valeur des localisateurs par défaut (UNIX)).

1. Connectez-vous à l’ordinateur sur lequel vous avez installé LiveCycle, puis accédez au répertoire [racine LiveCycle]/lib/caching.

2. Copiez le répertoire de mise en cache ainsi que son contenu sur l’ordinateur à partir duquel vous souhaitez exécuter les localisateurs.

   Vous pouvez démarrer le localisateur TCP depuis son emplacement par défaut. Il est conseillé de copier le répertoire de mise en cache vers un autre emplacement uniquement si :

   • Vous souhaitez exécuter le localisateur TCP sur un ordinateur sur lequel LiveCycle n’est pas installé.

   • Vous ne souhaitez pas démarrer le localisateur TCP depuis son emplacement par défaut.

   Remarque : N’exécutez pas les localisateurs TCP sur tous les nœuds de la grappe LiveCycle. Il est recommandé d’exécuter au moins deux localisateurs. Un localisateur TCP sert de localisateur principal et l’autre de localisateur secondaire pour gérer les problèmes de basculement. Vous pouvez ajouter d’autres localisateurs TCP comme localisateurs de sauvegarde, mais ce n’est pas obligatoire.

1. Ouvrez le fichier startlocator.bat file dans un éditeur de texte. Dans une installation par défaut, le fichier startlocator se trouve sur l’ordinateur sur lequel vous avez installé LiveCycle, dans le répertoire [racine LiveCycle]/lib/caching.

2. Remplacez le numéro de port par défaut (22345) par votre numéro de port préféré, en respectant les propriétés suivantes :

       set port=22345 

   Le numéro de port doit être compris entre 1025 et 65535.

   Remarque : Assurez-vous que le numéro de port qui est configuré ici correspond au numéro de port qui est configuré dans l’argument JVM de chaque nœud de la grappe LiveCycle. Le numéro de port peut être tout port disponible compris entre 1025 et 65535. Voir 3.4 Modification du fichier run.conf de JBoss pour finaliser la configuration.

3. Si vous utilisez plusieurs délimiteurs pour le mode reprise sur le serveur secondaire, attribuez-les tous à l’argument JVM -Dlocators figurant à la fin du fichier startlocator.bat.

   -Dlocators=localhost[22345]

4. (Pour les ordinateurs équipés de plusieurs cartes réseau uniquement) Si l’ordinateur hébergeant les localisateurs comprend plusieurs cartes réseau, définissez les propriétés suivantes dans le script :

   set bindaddr=<bind IP address>

   où <adresse IP de liaison> correspond à l’adresse IP à laquelle se réfère le localisateur. Vous devez spécifier l’<adresse IP de liaison> pour l’argument JVM adobe.cache.cluster-locators sur chaque nœud de votre grappe LiveCycle.

   Remarque : si vous ne spécifiez pas l’adresse de liaison et le port de liaison dans le script startlocator, vous serez invité à saisir ces valeurs lors de l’exécution du script. Toutefois, pour IPv6, vous devez spécifier l’adresse de liaison et le port de liaison dans le script startlocator.

5. Enregistrez le fichier modifié.

6. Répétez les étapes 1 à 4 pour tous les autres localisateurs de la grappe LiveCycle.

1. Ouvrez le fichier startlocator.sh file dans un éditeur de texte. Dans une installation par défaut, le fichier startlocator se trouve sur l’ordinateur où vous avez installé LiveCycle, dans le répertoire [racine LiveCycle]/lib/caching.

2. Remplacez le numéro de port par défaut (22345) par votre numéro de port préféré, en respectant les propriétés suivantes :

       GF_PORT=22345 

   Le numéro de port doit être compris entre 1025 et 65535.

   Important : veillez à ce que le numéro de port qui est configuré ici corresponde à celui configuré dans l’argument JVM de chaque nœud de la grappe LiveCycle.

3. Si vous utilisez plusieurs localisateurs pour le mode reprise sur le serveur secondaire, attribuez-les tous à l’argument JVM -Dlocators figurant à la fin du fichier startlocator.sh.

   -Dlocators=localhost[22345]

4. (Pour les ordinateurs équipés de plusieurs cartes réseau uniquement) Si l’ordinateur hébergeant les localisateurs possède plusieurs cartes réseau, modifiez l’argument suivant :

           GF_BIND_ADDRESS="<bind IP address>"

   où <adresse IP de liaison> correspond à l’adresse IP à laquelle se réfère le localisateur. Vous devez spécifier l’<adresse IP de liaison> pour l’argument JVM adobe.cache.cluster-locators sur chaque nœud de votre grappe LiveCycle.

   Remarque : pour IPv6, il est recommandé de spécifier l’adresse de liaison et le port de liaison dans le script startlocator.

5. Enregistrez le fichier modifié.

6. Répétez les étapes à pour tous les autres localisateurs de la grappe LiveCycle.

Pour utiliser la mise en cache basée sur TCP pour la grappe LiveCycle utilisant un localisateur TCP, vous devez démarrer les localisateurs TCP avant de démarrer votre grappe. Si les localisateurs TCP ne sont pas en cours d’exécution lorsque vous démarrez les membres de la grappe LiveCycle, celle-ci ne fonctionnera pas.

1. Sur l’ordinateur hébergeant les localisateurs TCP, accédez au répertoire de mise en cache. Dans une installation par défaut, les localisateurs TCP sont situés sur l’ordinateur sur lequel vous avez installé LiveCycle, dans le répertoire [racine LiveCycle]/lib/caching.

2. (Uniquement IPv6) Modifiez startlocator.bat (Windows) ou startlocator.sh (UNIX), puis ajoutez les arguments JVM suivants :

           -Djava.net.preferIPv6Stack=true 
           -Djava.net.preferIPv6Addresses=true

3. Exécutez le fichier approprié :

   • (Windows) startlocator.bat

   • (UNIX) startlocator.sh

4. Répétez les étapes ci-dessus pour tous les autres localisateurs de la grappe LiveCycle.

1. Sur l’ordinateur hébergeant les localisateurs TCP, accédez au répertoire de mise en cache. Dans une installation par défaut, les localisateurs TCP sont situés sur l’ordinateur sur lequel vous avez installé LiveCycle, dans le répertoire [racine LiveCycle]/lib/caching.

2. Exécutez le fichier approprié :

   • (Windows) stoplocator.bat

   • (UNIX) stoplocator.sh

3. Répétez les étapes 1 à 2 pour tous les autres localisateurs de la grappe LiveCycle.