6.1.2 Configuration des arguments de démarrage du serveur

Vous devez configurer les arguments de démarrage du serveur pour chaque instance WebLogic Server de la grappe LiveCycle à ajouter aux options LiveCycle 

Avant de démarrer cette procédure, vous devez savoir si votre grappe utilise une JVM 32 ou 64 bits. Voir Préparation à l’installation de LiveCycle sur une grappe de serveurs pour déterminer la JVM requise pour votre configuration de grappe.

Avant de démarrer cette procédure, déterminez la manière dont votre grappe LiveCycle est mise en cache, afin de pouvoir configurer correctement un argument de démarrage du serveur. Vous pouvez mettre en cache votre grappe à l’aide du protocole UDP ou TCP, mais pas les deux à la fois. Choisissez l’implémentation appropriée pour votre grappe :

  • Le protocole UDP peut uniquement être utilisé si votre grappe est basée sur le protocole IPv4.

  • Utilisez le protocole TCP si votre grappe est basée sur le protocole IPv4 ou IPv6. Sur une grappe basée sur le protocole IPv6, vous devez utiliser le protocole TCP.

    Si vous mettez en cache votre grappe à l’aide du protocole TCP, assurez-vous de configurer correctement les localisateurs TCP (voir Configuration des localisateurs de mise en cache (mise en cache via TCP uniquement)).

Il est recommandé d’utiliser le protocole TCP au lieu de la multidiffusion UDP pour les systèmes de production en raison de la fiabilité inhérente du protocole TCP.

Configuration des arguments de démarrage de serveur

  1. Dans WebLogic Administration Console, sous Domain Structure, cliquez sur Environment > Servers, puis, dans le volet situé à droite, cliquez sur le nom d’un serveur de la grappe LiveCycle 

  2. Cliquez sur l’onglet Configuration > Server Start.

  3. Sous Change Center, cliquez sur Lock & Edit.

  4. Dans la zone Arguments, ajoutez le jeu suivant d’arguments JVM :

    • (JVM 32 bits uniquement) Ajoutez -XX:MaxPermSize=256m -Xms256m -Xmx1024m

    • (JVM 64 bits uniquement) Ajoutez -XX:MaxPermSize=512m -Xms256m -Xmx1792m

    Remarque : copiez le bloc de texte approprié dans un éditeur de texte et supprimez tous les retours à la ligne.

  5. (Uniquement IPv4) Dans la zone Arguments, ajoutez les arguments JVM suivants :

    -Dadobeidp.RootDirectory=<domaine du serveur d'applications> -Djava.net.preferIPv4Stack=true -Dfile.encoding=utf8

    -Djava.security.policy=<racine du serveur d'applications>/server/lib/weblogic.policy

  6. (Uniquement IPv6) Dans la zone Arguments, ajoutez les arguments JVM suivants :

    -Dadobeidp.RootDirectory=<domaine du serveur d'applications> -Djava.net.preferIPv6Stack=true -Djava.net.preferIPv6Addresses=true -Dfile.encoding=utf8

    -Djava.security.policy=<racine du serveur d'applications>/server/lib/weblogic.policy

    Remarque : si vous utilisez une plateforme UNIX 64 bits, ajoutez l’argument JVM suivant :
    -d64
    Remarque : la propriété adobeidp.RootDirectory doit être créée exactement au même emplacement sur tous les nœuds de la grappe.
    Copiez le bloc de texte ci-dessus dans un éditeur de texte, supprimez tous les retours à la ligne et remplacez les occurrences suivantes :

    • <domaine du serveur d'applications> : à remplacer par le chemin du domaine du serveur d’applications

    • <racine du serveur d'applications> : à remplacer par le répertoire racine du serveur d’applications

  7. Configurez un argument JVM pour la mise en cache de la grappe. A présent, dans la zone Arguments, ajoutez ou configurez l’un des arguments de mise en cache suivants :

    • (Mise en cache avec découverte UDP) Configurez l’argument du port à diffusion multiple selon le format suivant :

      -Dadobe.cache.multicast-port=<port number>
      Remarque : la valeur du <port number> peut correspondre à n’importe quel port disponible entre 1025 et 65535. Le port de multidiffusion doit être unique dans la grappe LiveCycle : il ne doit pas être utilisé par une autre grappe sur le même réseau. Toute tentative d’utilisation du même port par toute autre grappe sur le même réseau entraîne un échec du démarrage. Il est recommandé de configurer le même <numéro de port> sur tous les nœuds de la grappe LiveCycle, comme dans l’exemple suivant :
      -Dadobe.cache.multicast-port=33456

    • (Mise en cache avec la découverte UDP) La configuration de l’argument de l’adresse de multidiffusion est facultative. Les adresses de multidiffusion par défaut pour IPv4 et IPv6 sont les suivantes : 

      IPv6 - FF38::1234 
IPv4 - 239.192.81.1

      Si des restrictions existent sur votre réseau pour les adresses de multidiffusion, utilisez l’argument suivant pour configurer des adresses de multidiffusion :

      -Dadobe.cache.multicast-address=<ip address>
      Remarque : la valeur <ip address> correspond à l’adresse IP utilisée pour la mise en réseau multidiffusion. L’adresse IP est ignorée si la valeur de adobe.cache.multicast-port est zéro.
      Remarque : l’adresse à diffusion multiple doit être propre à la grappe LiveCycle et ne doit être utilisée par aucune autre grappe du même réseau. Il est recommandé de configurer la même <adresse ip> sur tous les nœuds de la LiveCycle  Par exemple : 
      -Dadobe.cache.multicast-address=239.192.81.1

    • (Mise en cache avec TCP uniquement) Pour IPv4, configurez l’argument des localisateurs de grappe selon le format suivant :

      -Dadobe.cache.cluster-locators=<IPaddress>[<port number>],<IPaddress> 
[<port number>]

      Pour IPv6, configurez l’argument des localisateurs de grappe selon le format suivant :

      -Dadobe.cache.cluster-locators=<hostname>@<IPv6 address> 
[<port number>], <hostname>@<IPv6 address>[<port number>]
      Remarque : configurez, sous forme de liste de valeurs séparées par des virgules, les localisateurs pour tous les nœuds de la grappe. La valeur de <IP address> est l’adresse IP de l’ordinateur qui exécute le localisateur, et la valeur de <port number> peut être tout port inutilisé entre 1025 et 65535. Il est recommandé de configurer le même <numéro de port> sur tous les nœuds de la grappe LiveCycle, comme dans l’exemple suivant :
      -Dadobe.cache.cluster-locators=10.20.30.5[22345],10.20.30.6[22345] 
-Dadobe.cache.cluster-locators=node1@ 2001:1890:110b:7131:7996:3596:2921:364e [22345],node2@ 2001:1890:110b:7131:9192:a8df:1cc7:75b2 [22345]

    • Pour les systèmes avec plusieurs interfaces réseau

      Certains systèmes peuvent être connectés à plusieurs réseaux via plusieurs cartes d’interface réseau (NIC). Pour ces systèmes, définissez la propriété -Dadobe.cache.bind-address de la JVM à l’adresse IP de la carte d’interface réseau que vous utilisez pour le serveur LiveCycle. 

      -Dadobe.cache.bind-address=<IP Address>
      Remarque : il est recommandé de définir également la propriété -Dadobe.cache.bind-address de la JVM pour les systèmes avec une seule carte d’interface réseau.
    • Pour protéger le serveur d’applications des attaques par déni de service, configurez l’argument JVM suivant :
      -DentityExpansionLimit=10000

  8. Cliquez sur Save, puis sur Activate Changes.

  9. Répétez les étapes 2 à 8 pour chaque serveur de la grappe.