4.2 Configuration des instances WebSphere Application Server

4.2.1 Modification des paramètres de délai d’expiration de WebSphere
4.2.2 Modification des propriétés JVM
4.2.3 Création d’un alias d’authentification J2C pour la base de données

Vous devez configurer les instances WebSphere Application Server que vous avez installées dans la grappe en exécutant les tâches suivantes :

Modification des paramètres de délai d’expiration de WebSphere (voir 4.2.1 Modification des paramètres de délai d’expiration de WebSphere ).
Modification des propriétés JVM (voir 4.2.2 Modification des propriétés JVM ).
Création d’un alias d’authentification J2C pour la base de données (voir 4.2.3 Création d’un alias d’authentification J2C pour la base de données ).

4.2.1 Modification des paramètres de délai d’expiration de WebSphere

Vous devez modifier les paramètres de délai d’expiration de sur chaque instance WebSphere Application Server de la grappe.

Modification des paramètres de délai d’expiration de WebSphere

Dans l’arborescence de navigation de la console d’administration WebSphere, cliquez sur Servers > Application Servers , puis, dans le volet de droite, cliquez sur le nom du serveur.
Sous Container Settings, cliquez sur Container Services > Transaction Service .
Dans la zone Total transaction lifetime timeout , saisissez 600 , puis cliquez sur OK .
Sous Container Settings, cliquez sur Container Services > ORB Service .
Dans la zone Request timeout , saisissez 360 , dans la zone Locate Request Timeout , saisissez 600 , puis cliquez sur OK .
Sous Server Infrastructure, cliquez sur Administration > Administration Services .
Dans l’écran suivant, cliquez sur JMX Connectors , puis, dans le tableau, cliquez sur SOAPConnector .
Dans l’écran suivant, cliquez sur Custom Properties , puis cliquez sur requestTimeout dans le tableau.
Dans la zone Value, saisissez 1800 .
Cliquez sur OK , puis sur Save directly to the master configuration .

4.2.2 Modification des propriétés JVM

Vous devez modifier les propriétés de la machine virtuelle Java (Java Virtual Machine, JVM) de chaque instance WebSphere Application Server de la grappe AEM forms pour ajouter les options AEM forms.

Remarque : Vous devez redémarrer chaque nœud du serveur d’applications après avoir modifié les paramètres de la JVM.

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 d’AEM forms sur une grappe de serveurs, afin de déterminer la JVM requise pour la configuration de la grappe.

Avant de démarrer cette procédure, vous devez déterminer la manière dont votre grappe AEM forms est mise en cache, afin de pouvoir configurer correctement un argument JVM de mise en cache. Vous pouvez mettre en cache votre grappe à l’aide du protocole UDP ou TCP, mais pas les deux à la fois. Les facteurs suivants peuvent influer sur votre choix :

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, il vous faut utiliser le protocole TCP.

Si vous mettez en cache votre grappe en utilisant le protocole TCP, vous devez également vous assurer que vous configurez les localisateurs TCP correctement (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.

Modification des propriétés de la JVM

Ouvrez une session sur la console d’administration WebSphere, puis dans l’arborescence de navigation, cliquez sur Servers > Application servers , puis sur le nom du serveur dans le volet de droite.
Sous Server Infrastructure, cliquez sur Java and forms workflow > Process Definition .
Sous Additional Properties, cliquez sur Java Virtual Machine et ajoutez ou configurez les propriétés suivantes :
- Dans la zone Initial Heap Size , tapez 512
- Dans la zone Maximum Heap Size , définissez l’une des valeurs suivantes :
  - (JVM 32 bits uniquement) Saisissez 1024 .
  - (JVM 64 bits uniquement) Saisissez 4096 .
- Dans la zone Generic JVM arguments , ajoutez les arguments suivants :
  
  -Xgcpolicy:gencon
  
  -Dfile.encoding=utf8
  Remarque : Ajoutez l’argument -Xgcpolicy:gencon JVM uniquement si WebSphere utilise IBM JDK. Toutefois, n’ajoutez pas cet argument si WebSphere est exécuté sur un système d’exploitation Solaris.
- Dans la zone Generic JVM arguments , définissez l’une des valeurs suivantes :
  - (JVM 32 bits uniquement) Saisissez -XX:MaxPermSize=256m .
  - (JVM 64 bits uniquement) Saisissez -XX:MaxPermSize=512m .
Sur le même écran, dans la zone Generic JVM arguments , ajoutez l’un des arguments de mise en cache suivants, en fonction de la configuration du mécanisme du cache de la grappe (UDP ou TCP) :
- Mise en cache avec découverte UDP
  - Configurez l’argument du port de multidiffusion selon le format suivant :
```
-Dadobe.cache.multicast-port=<port number> 
```
    Remarque : La valeur de <port number> peut correspondre à n’importe quel port disponible entre 1025 et 65535. Le port de multidiffusion doit être réservé à la grappe AEM forms : 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 une 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 AEM forms, comme dans l’exemple suivant :
```
-Dadobe.cache.multicast-port=33456
```
  - 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 de multidiffusion doit être réservée à la grappe d’AEM forms et ne doit pas être utilisée par une autre grappe sur le même réseau. Il est recommandé de configurer la même <adresse ip> sur tous les nœuds d’une grappe AEM forms. Par exemple :
```
-Dadobe.cache.multicast-address=239.192.81.1
```
- Mise en cache via 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 <port number> pour tous les localisateurs, comme dans cet exemple :
```
-Dadobe.cache.cluster-locators=10.20.30.5[22345],10.20.30.6[22345]
```
    Remarque : N’exécutez pas le localisateur TCP pour tous les nœuds. Configurez uniquement deux localisateurs TCP. Activez un localisateur TCP en tant que localisateur principal et un autre en tant que localisateur secondaire/de secours. Pour plus d’informations sur la configuration des localisateurs TCP, voir Configuration des localisateurs de mise en cache dans des grappes (mise en cache via TCP uniquement).
- 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 de formulaires.
```
-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
```
Cliquez sur Apply , puis sur Custom Properties .
(IPv4 uniquement) Sur l’écran suivant, cliquez sur New , ajoutez ou configurez les propriétés suivantes, puis cliquez sur OK :
- Dans la zone Name , entrez java.net.preferIPv4Stack .
- Dans la zone Value , entrez true .
(IPv6 uniquement) Sur l’écran suivant, cliquez sur New , ajoutez ou configurez les propriétés suivantes, puis cliquez sur OK :
- Dans la zone Name , entrez java.net.preferIPv6Stack .
- Dans la zone Value , entrez true .
- Dans la zone Name , saisissez java.net.preferIPv6Addresses .
- Dans la zone Value , entrez true .
Cliquez sur OK , puis sur Save directly to the master configuration .
Redémarrez le serveur.
Répétez les étapes 11 à 19 pour chaque serveur de la grappe.

4.2.3 Création d’un alias d’authentification J2C pour la base de données

Vous devez créer un alias d’authentification J2C pour la base de données.

Création d’une configuration d’authentification J2C pour la source de données

Dans l’arborescence de la console d’administration de WebSphere, cliquez sur Security > Global security .
Dans le volet de droite, sous Authentication, cliquez sur Java Authentication and Authorization Service > J2C authentication data , puis sur New .
Définissez les propriétés suivantes :
- Dans la zone Alias , saisissez un nom d’alias approprié pour l’utilisateur de la base de données, par exemple IDP_DS/db2-db2user .
- Dans la zone User ID , saisissez un nom, par exemple utilisateurdb2 . Cet identifiant correspond aux informations d’identification de connexion utilisées pour accéder à la base de données qui sera utilisée avec la source de données IDP_DS.
- Dans la zone Password , saisissez un mot de passe pour cet utilisateur.
Remarque : Dans ce guide, IDP_DS identifie la source de données AEM forms.
Cliquez sur OK , puis sur Save directly to master configuration .
Répétez les étapes 3 et 4 pour RM_DS. Utilisez EDC_DS/db2-db2user comme nom d’alias.

Remarque : EDC_DS est le nom JNDI de la source de données RM_DS.