Déploiement du fichier WAR du serveur de gestion sur WebSphere Application Server Community Edition

Vous pouvez utiliser IBM® Installation Manager pour installer le serveur de gestion et les bases de données et fichiers de données associés sur un serveur d'applications. Cependant, l'installation n'est pas complète tant que vous n'avez pas déployé le fichier d'archive Web (WAR) du serveur de gestion sur le serveur d'applications. Cette tâche vous permet de déployer le fichier WAR du serveur de gestion sur la version anglaise de WebSphere Application Server Community Edition.

Lorsque vous déployez le fichier WAR du serveur de gestion sur le serveur d'applications, ce dernier crée une base de données Apache Derby appelée OptimServerDB.

La version de WebSphere Application Server Community Edition livrée avec le gestionnaire est uniquement disponible en anglais. Vous devez configurer cette version de WebSphere Application Server Community Edition à l'aide de l'interface utilisateur anglaise. Cependant, lorsque vous utilisez le gestionnaire, le paramètre de langue du navigateur détermine la langue de l'interface utilisateur du gestionnaire. Le paramètre de langue du navigateur détermine également la langue des messages envoyés par le serveur de gestion et le proxy.

Utilisez la Console d'administration de WebSphere Application Server Community Edition pour déployer le fichier WAR du serveur de gestion. L'emplacement par défaut de la console d'administration est http://nom_hôte:8080/console, où nom_hôte correspond au nom d'hôte de l'ordinateur sur lequel WebSphere Application Server Community Edition est installé.

Pour déployer le fichier WAR du serveur de gestion à l'aide de la Console d'administration de WebSphere Application Server Community Edition, procédez comme suit :

  1. Cliquez sur Deploy New.
  2. Indiquez l'emplacement du fichier WAR du serveur de gestion dans Archive, puis cliquez sur Install. Le fichier WAR du serveur de gestion est répertoire_installation_partagé/server/app/management-server.war, où répertoire_installation_partagé correspond au répertoire d'installation spécifié pour le groupe de packages partagé IBM Optim. Par exemple, l'emplacement par défaut du fichier WAR du serveur de gestion sous Microsoft Windows est C:\Program Files\IBM Optim\shared\server\app\management-server.war. Si vous préférez, vous pouvez cliquer sur Browse pour rechercher le fichier WAR du serveur de gestion. Le déploiement du fichier WAR du serveur de gestion peut prendre plusieurs minutes.
Une fois le fichier WAR du serveur de gestion déployé, vous pouvez configurer les propriétés du serveur de gestion en modifiant le script que vous utilisez pour démarrer le serveur d'applications. Ce script se trouve à l'emplacement suivant, où répertoire_installation_partagé correspond au répertoire d'installation spécifié pour le package d'installation d'Optim Management Server.
  • Ordinateurs Windows : répertoire_installation_partagé\WebSphere\AppServerCommunityEdition\bin\startup.bat
  • Ordinateurs Linux ou UNIX : répertoire_installation_partagé/WebSphere/AppServerCommunityEdition/bin/startup.sh
Si le déploiement du fichier WAR échoue en raison d'erreurs java.lang.OutOfMemoryError: PermGen space, augmentez la quantité de mémoire de génération permanente disponible pour les objets dans la machine virtuelle Java Java du serveur d'applications. Pour augmenter l'espace disponible de mémoire de génération définitive, modifiez le script que vous utilisez pour lancer le serveur d'applications. Ouvrez ce script dans un éditeur de texte et ajoutez l'argument suivant à la fin du paramètre JAVA_OPTS dans le script. NNN est l'espace initial de mémoire de génération définitive en Mo et MMM est l'espace maximal de mémoire de génération définitive en Mo. La totalité du paramètre JAVA_OPTS doit se trouver sur une seule ligne ou sur des lignes consécutives reliées par des caractères de continuation de ligne. Le caractère de continuation de ligne est le caret (^) pour les scripts de traitement par lots Windows ou la barre oblique inversée (\) pour les scripts Linux ou UNIX.
-XX:PermSize=NNNm -XX:MaxPermSize=MMMm
Par exemple, le paramètre JAVA_OPTS suivant d'un script par lots Windows spécifie 128 Mo comme quantité initiale de mémoire de génération permanente et 256 Mo comme quantité maximale de mémoire de génération permanente.
@set JAVA_OPTS=%ADDITIONAL_JAVA_OPTS% %JAVA_OPTS% ^
               -Djavax.net.ssl.keyStore="%GERONIMO_HOME%\var\security\keystores\optim-management-server.jks" ^
               -Djavax.net.ssl.trustStore="%GERONIMO_HOME%\var\security\keystores\optim-management-server.jks" ^
               -Djavax.net.ssl.keyStorePassword=manager -Djavax.net.ssl.trustStorePassword=manager ^
               -XX:PermSize=128m -XX:MaxPermSize=256m
Le paramètre JAVA_OPTS suivant d'un script Linux ou UNIX définit 128 Mo comme espace initial de mémoire de génération définitive et 256 Mo comme espace maximal de mémoire de génération définitive.
JAVA_OPTS=-Djavax.net.ssl.keyStore=$GHOME/../var/security/keystores/optim-management-server.jks \
          -Djavax.net.ssl.trustStore=$GHOME/../var/security/keystores/optim-management-server.jks \
          -Djavax.net.ssl.keyStorePassword=manager -Djavax.net.ssl.trustStorePassword=manager \
          -XX:PermSize=128m -XX:MaxPermSize=256m \
          $JAVA_OPTS

Par défaut, le serveur de gestion utilise 64 Mo de mémoire de génération permanente. Si vous définissez des tailles de mémoire sur une valeur supérieure à l'espace de mémoire physique disponible sur votre machine, vous risquez de réduire de manière significative les performances de votre machine.

Si le serveur d'applications se trouve sur un ordinateur paramétré dans une langue nécessitant l'utilisation de caractères à deux octets, configurez le serveur d'applications pour utiliser le chiffrement UTF-8 dans ses fichiers journaux. Pour configurer le serveur d'applications afin qu'il utilise le codage UTF-8, ajoutez l'argument suivant à la fin du paramètre JAVA_OPTS dans le script de démarrage du serveur d'applications. La totalité du paramètre JAVA_OPTS doit se trouver sur une seule ligne ou sur des lignes consécutives reliées par des caractères de continuation de ligne. Le caractère de continuation de ligne est le caret (^) pour les scripts de traitement par lots Windows ou la barre oblique inversée (\) pour les scripts Linux ou UNIX.
-Dfile.encoding=UTF-8
Si le fichier WAR ne parvient pas à se déployer sur un ordinateur Linux en raison d'erreurs IOException: too many open files, augmentez le nombre maximal de fichiers ouverts sur l'ordinateur. Pour augmenter le nombre maximal de fichiers ouverts, connectez-vous en tant que superutilisateur et procédez comme suit.
  1. Entrez la commande suivante :
    /sbin/sysctl -w fs.file-max=100000
  2. Ajoutez la ligne suivante au fichier /etc/sysctl.conf pour que le paramètre ne soit pas modifié après réamorçage du système.
    fs.file-max = 100000
  3. Entrez la commande suivante pour que le changement apporté au fichier /etc/sysctl.conf prenne effet.
    /sbin/sysctl -p
  4. Entrez la commande suivante pour vérifier les paramètres.
    /sbin/sysctl fs.file-max
  5. Entrez la commande suivante pour augmenter le nombre maximal de processus et le faire passer à 20 048.
    ulimit -n 20048
  6. Ajoutez la ligne suivante au début du script répertoire_installation_partagé/WebSphere/AppServerCommunityEdition/bin/startup.sh pour que le paramètre soit défini chaque fois que vous démarrez le serveur d'applications.
    ulimit -n 20048