Déploiement du fichier WAR du gestionnaire sur WebSphere Application Server Community Edition

Vous devez déployer le fichier WAR du gestionnaire sur le serveur d'applications avant de pouvoir utiliser le gestionnaire. Cette tâche vous permet de déployer le fichier WAR sur la version anglaise de WebSphere Application Server Community Edition.

Lorsque vous déployez le fichier WAR sur le serveur d'applications, ce dernier crée une base de données Apache Derby appelée optimConsoleDB. Le serveur d'applications associe la base de données optimConsoleDB au pool de bases de données OptimConsoleDB.

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. 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 gestionnaire à 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 dans Archive, puis cliquez sur Install. Le fichier WAR est répertoire_installation_partagé/console/app/optim.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 sous Microsoft Windows est C:\Program Files\IBM Optim\shared\console\app\optim.war. Si vous préférez, vous pouvez cliquer sur Browse pour rechercher le fichier WAR. Le déploiement du fichier WAR peut prendre plusieurs minutes.
  3. Si vous mettez à niveau un fichier WAR du gestionnaire, signalez à tous les utilisateurs que vous avez déployé une version mise à niveau du gestionnaire. Il peut être nécessaire pour l'utilisateur d'actualiser le navigateur ou d'effacer le cache du navigateur pour obtenir la version mise à niveau du gestionnaire. Pour savoir si le navigateur affiche la version mise à niveau du gestionnaire, l'utilisateur doit cliquer sur Aide > A propos d'IBM Optim Manager dans l'interface du gestionnaire.
Une fois le fichier WAR du gestionnaire déployé sur le serveur d'applications, vous pouvez configurer les propriétés du gestionnaire. Pour configurer les propriétés du gestionnaire, éditez le script utilisé 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 Manager.
  • 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 gestionnaire 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