Configuration de WebSphere Application Server pour l'exécution des applications Build Forge®

Configuration de WebSphere Application Server pour l'exécution de l'application des services et de l'application d'aide

Pourquoi et quand exécuter cette tâche

Effectuez les étapes de cette procédure sur la console d'administration de WebSphere Application Server.
Sur WebSphere Application Server version 8.0, l'interface utilisateur de la console d'administration de WebSphere Application Server a changé légèrement. Les instructions ci-dessous s'appliquent aux versions 7 et antérieures. Cette procédure est affectée par les différences suivantes dans la version 8.0 :
  • Pour accéder à une application, cliquez sur Applications > Types d'application > Applications d'entreprise.
  • Après avoir sélectionné une application, définissez la racine de contexte.
Remarques :
  • Il n'y a pas de case à cocher pour Créer des MBeans pour les ressources.
  • Pour redéployer Build Forge® sur WAS, supprimez le Build Forge® déployé précédemment.

Procédure

  1. Ouvrez la console d'administration de WebSphere Application Server. Les URL de la console sont les suivantes :
    • http://<hôte_was>:<port_was>/ibm/console ; 9060 est le port par défaut.
    • https://<hôte_was>:<port_was>/ibm/console ; 9043 est le port par défaut. Utilisez cette URL si la sécurité administrative de WebSphere Application Server est activée.
  2. Configurez la prise en charge de votre pilote JDBC :
    1. Créez une variable, RBF_JDBC_DRIVER_PATH. Créez la variable dans Environnement > Variables WebSphere. La portée doit comprendre le noeud et le serveur WebSphere Application Server. Paramétrez la valeur sur le répertoire qui contient vos fichiers JAR de pilote de base de données.
    2. Sauvegardez la modification apportée à la configuration principale.
    3. Arrêtez et redémarrez WebSphere Application Server pour rendre la nouvelle variable disponible.
    4. Créez une bibliothèque partagée, RBF_JDBC_LIBRARY.

      Effectuez cette opération dans Environnement > Bibliothèques partagées. Ajoutez les noms des fichiers JAR pour votre pilote de périphérique JDBC à l'aide de la variable RBF_JDBC_DRIVER_PATH que vous venez de créer. Si vous avez plusieurs fichiers jar à répertorier, placez chaque fichier jar sur une ligne différente, comme indiqué ci-dessous pour DB2.

      L'exemple suivant concerne un pilote de base de données MySQL :

      ${RBF_JDBC_DRIVER_PATH}\mysql-connector-java-5.0.5-bin.jar

      L'exemple suivant concerne DB2 :

      ${RBF_JDBC_DRIVER_PATH}\db2jcc.jar
      ${RBF_JDBC_DRIVER_PATH}\db2jcc_license_cu.jar

      Sous UNIX ou Linux (dans les exemples ci-dessus), utilisez une barre oblique (/) à la place d'une barre oblique inversée (\).

    5. Sauvegardez la modification apportée à la configuration principale.
  3. Si WebSphere Application Server est déployé sur Solaris, il est nécessaire de mettre à jour la machine virtuelle Java du serveur d'applications WAQ pour utiliser le DevPollSelectorProvider pour le processus d'E-S.

    Accédez à la console de gestion WAS. Ouvrez Serveurs > Types de serveur > Serveurs d'applications WebSphere > server1 > Gestion des processus et Java > Définition des processus > Machine virtuelle Java > Arguments de machine virtuelle Java génériques

    Le contenu des arguments de machine virtuelle Java génériques est le suivant :
    -Djava.nio.channels.spi.SelectorProvider=sun.nio.ch.DevPollSelectorProvider 

    Le nom du serveur par défaut est server1. Toutefois, si votre serveur d'applications sur lequel Build Forge® est déployé porte un nom différent, utilisez-le.

  4. Installez le fichier WAR d'application Build Forge®.
    1. Ouvrez Applications > Applications d'entreprise.
    2. Cliquez sur Installation.
    3. Accédez au fichier jas.war. Utilisez /jas comme racine de contexte.
      • Systèmes Windows :
        <rép_install_bf>\PrepForExternal\jas.war
      • Systèmes UNIX et Linux :
        <rép_install_bf>/Platform/PrepForExternal/jas.war
    4. Cliquez sur Suivant et décochez la case Créer des MBeans pour les ressources si elle est cochée.
    5. Cliquez sur Suivant, puis sur Terminer.
    6. Au bas du texte d'installation, cliquez sur Sauvegarder.
  5. Installez le fichier WAR d'aide Build Forge®.
    1. Cliquez sur Applications > Applications d'entreprise.
    2. Cliquez sur Installation.
    3. Accédez au fichier BuildForgeHelp.war dans le répertoire d'installation de Build Forge®. Utilisez /BuildForgeHelp comme racine de contexte.
    4. Cliquez sur Suivant et décochez la case Créer des MBeans pour les ressources si elle est cochée :
    5. Cliquez sur Suivant jusqu'à ce que vous voyiez le bouton Terminer, puis cliquez sur Terminer.
    6. Cliquez sur Sauvegarder en bas du texte d'installation.
  6. Définissez RBF_JDBC_LIBRARY comme référence de bibliothèque partagée.
    1. Cliquez sur Applications > Applications d'entreprise.
    2. Cliquez sur le lien jas.war.
    3. Cliquez sur Références de bibliothèque partagée.
    4. Cochez la case jas.war.
    5. Cliquez sur Reference Shared Libraries (Référencer les bibliothèques partagées).
    6. Ajoutez RBF_JDBC_LIBRARY à la liste.
  7. Définissez l'ordre du chargeur de classe :
    1. Sous Manage Modules (Gérer les modules), sélectionnez jas.war et sélectionnez Class loader order (Ordre du chargeur de classes) dans le menu déroulant.
    2. Remplacez cette valeur par Classes loaded with local class loader first (parent last) (Classes chargées au préalable avec le chargeur de classes local (parent en dernier)).
  8. Sauvegardez les changements dans la configuration principale.
  9. Consultez le fichier de configuration de Build Forge®. Assurez-vous que l'entrée services_url dans ce fichier pointe vers l'URL correcte. Si vous utilisez WebSphere Application Server, la valeur de cette propriété dans buildforge.conf doit être similaire à https://<hostname>:9443/jas ou https://<hostname>:9080/jas. Le fichier buildforge.conf se trouve à l'emplacement suivant :
    • Systèmes Windows
      <rép_install_bf>\
    • Systèmes UNIX et Linux
      <rép_install_bf>/Platform/
  10. Pour les systèmes UNIX et Linux, ajoutez des droits d'exécution sur tous les fichiers dans le répertoire bin de jas.

    Dans cet exemple, le profil AppSrv01 est utilisé. Si votre nom de profil n'est pas AppSrv01, utilisez votre nom de profil.

    chmod -R 755 <rép_install_WAS>/AppServer/profiles/AppSrv01/installedApps/<noeud>/jas_war.ear/jas.war/bin
  11. Mettez à jour la variable PATH de la bibliothèque de sorte qu'elle inclue les répertoires suivants :
    • Sous Windows, PATH inclut :
      <rép_install_bf>\token_libs
    • Sous AIX, LIBPATH inclut :
      <rép_install_bf>/Platform/token_libs
    • Sous Linux/Solaris, LD_LIBRARY_PATH inclut :
      <rép_install_bf>/Platform/token_libs
  12. Si vous utilisez WebSphere Application Server ou Linux 64 bits, effectuez les étapes suivantes pour copier les bibliothèques 64 bits fournies :
    1. Renommez le fichier de bibliothèques.
      • Systèmes Windows : renommez <rép_install_bf>\token_libs\rcl_rational.dll en <rép_install_bf>\token_libs\rcl_rational.dll.old.
      • Systèmes UNIX et Linux : renommez <rép_install_bf>/Platform/token_libs/librcl_rational.so en <rép_install_bf>/Platform/token_libs/librcl_rational.so.old.
    2. Copiez les fichiers de bibliothèques 64 bits de token_libs_64 vers token_libs. N'utilisez pas de retours à la ligne dans les commandes. Ils sont utilisés ici pour plus de lisibilité.
      • Systèmes Windows
        copy <rép_install_bf>\token_libs_64\rcl_rational.dll 
             <rép_install_bf>\token_libs\rcl_rational.dll
      • Systèmes UNIX et Linux
        cp <rép_install_bf>/Platform/token_libs_64/librcl_rational.so 
           <rép_install_bf>/Platform/token_libs/librcl_rational.so

Feedback