Déployer Rational Asset Manager sur Apache Tomcat 5.5 connecté à DB2

Vous pouvez installer IBM® Rational Asset Manager manuellement sur une installation existante d'Apache Tomcat.

Avant de commencer

Vous devez disposer d'un accès administratif et aux fichiers pour un serveur Tomcat installé et en cours d'exécution.

Vous devez disposer d'un certificat de sécurité pour votre serveur Tomcat. La version incluse de Rational Team Concert requiert une connexion sécurisée.

Vous devez connaître l'emplacement des fichiers db2jcc_license_cu.jar et db2jcc.jar qui permettent à Tomcat de communiquer avec un serveur de base de données IBM DB2. Votre fournisseur de serveur de base de données doit vous fournir ces fichiers.

Pourquoi et quand exécuter cette tâche

Pour améliorer les performances et la stabilité de Rational Asset Manager, vous pouvez installer les applications Web pour Rational Asset Manager et les fichiers d'application pour l'application Rational Team Concert incluse sur des serveurs Tomcat distincts. Par le biais de ce document, le répertoire d'installation du serveur Tomcat pour Rational Asset Manager correspond à <répertoire_installation_tomcat>, et le répertoire d'installation du serveur Tomcat pour Rational Team Concert à <répertoire_installation_tomcat_pour_rtc>. Si vous installez toutes les applications Web sur le même serveur, les répertoires seront les mêmes.

Remarque : Si vous prévoyez de déployer Rational Asset Manager et la version Rational Team Concert incluse sur différentes applications serveur Tomcat sur une même machine, vérifiez que les différents serveurs Tomcat sont configurés pour utiliser différentes ports sécurisés et non sécurisés afin d'éviter les collisions. Pour plus d'informations sur les ports dans Tomcat 5.5, voir la documentation Apache Tomcat.

Procédure

  1. Vérifiez que tous les serveurs de référentiels sont définis aux mêmes date, heure et fuseau horaire courants.
  2. Extrayez les fichiers du serveur Rational Asset Manager sur l'archivage approprié à Tomcat et à votre système d'exploitation. Vous trouverez les fichiers d'application dans le dossier <emplacement_extraction_archivage>/apps/tomcat/.
  3. Extrayez les fichiers de bibliothèque partagée dans le dossier <répertoire_installation_tomcat>\shared\lib :
    1. Recherchez et extrayez le fichier <emplacement_extraction_archivage>\apps\tomcat\sharedLib.zip.
    2. Copiez l'intégralité du contenu du fichier sharedLib.zip extrait dans le répertoire <répertoire_installation_tomcat>\shared\lib.
    3. Si vous installez Rational Team Concert sur un serveur Tomcat différent, répétez la copie du contenu extrait du fichier sharedLib.zip dans le répertoire <répertoire_installation_tomcat_pour_rtc>\shared\lib pour l'autre serveur Tomcat.
  4. A partir du répertoire <emplacement_extraction_archivage>/apps/tomcat/, copiez les fichiers suivants dans le répertoire <répertoire_installation_tomcat>/webapps/ :
    • com.ibm.ram.repository.web.tomcat_runtime.war
    • com.ibm.ram.repository.web.ws.tomcat_runtime.war
    • iehs.war
    • rmcabdgovernprocess.war
  5. Pour changer le chemin du contexte de l'application, renommez les fichiers d'application WAR. Utilisez de préférence les noms suivants :
    Tableau 1. Chemins du contexte recommandés pour les fichiers d'application Web Rational Asset Manager
    Nom de fichier d'origine Nom de fichier recommandé Chemin du contexte obtenu De quoi s'agit-il ?
    com.ibm.ram.repository.web.tomcat_runtime.war ram.war ram Application Web principale Rational Asset Manager pour Tomcat
    com.ibm.ram.repository.web.ws.tomcat_runtime.war ram.ws.war ram.ws Application des services Web Rational Asset Manager pour Tomcat
    iehs.war ram.help.war ram.help Application d'aide aux utilisateurs Rational Asset Manager
    rmcabdgovernprocess.war ram.process.war ram.process Application de documentation pour les processus à base d'actifs et de gouvernance
  6. Configurez le serveur Tomcat pour que Rational Asset Manager puisse accéder à DB2.
    1. Dans un éditeur de texte, ouvrez le fichier <répertoire_installation_tomcat>\conf\server.xml.
    2. Dans server.xml, retrouvez toutes les lignes commençant par <Connector et contenant port="8080" ou port="8009". Changez le début de ces lignes pour <Connector URIEncoding="UTF-8".
    3. Toujours dans le fichier server.xml, entre les balises d'ouverture et de fermeture des ressources JNDI globales <GlobalNamingResources> et </GlobalNamingResources>, entrez le texte suivant pour votre version de Tomcat.
      Remarque : Pour les valeurs <votre_nom_d'utilisateur> et <votre_mot_de_passe>, spécifiez une combinaison ID utilisateur/mot de passe ayant un accès administrateur complet à la base de données. Les valeurs indiquées pour "maxWait", "maxActive" et "maxIdle" sont des valeurs fournies à titre d'exemple qui peuvent être adaptées en fonction de vos besoins en performances. Pour l'attribut "url", par exemple, peut être similaire à jdbc:db2://localhost:50000/RAMDB
    Entrez le texte suivant :
    <Resource name="jdbc/RAM_Con"
    type="javax.sql.DataSource"
    driverClassName="com.ibm.db2.jcc.DB2Driver"
    username="<votre_nom_d'utilisateur>"
    password="<votre_mot_de_passe>"
    url="jdbc:db2://<nom_complet_serveur>:<numéro_port_db2>/<nom_base_de_données_Rational_Asset_Manager>"
    poolPreparedStatements="true"
    maxWait="5000"
    maxActive="4"
    maxIdle="2"/>
  7. Copiez les fichiers JAR suivants du dossier <emplacement_installation_DB2>\java de votre installation DB2 dans le dossier <répertoire_installation_tomcat>\common\lib :
    • db2jcc_license_cu.jar
    • db2jcc.jar
  8. Recherchez le fichier <emplacement_extraction_archivage>/apps/tomcat/RTC-server.zip sur le support d'installation.
  9. Extrayez RTC-server.zip sur un emplacement de votre disque dur, auquel il est fait référence dans ces instructions sous l'intitulé <rtc_install_dir>.
  10. Recherchez le fichier <rtc_install_dir>/jazz/server/jazz_war.ear et extrayez-le. Vous pouvez faire appel à l'utilitaire gratuit 7-Zip pour extraire les fichiers .ear. Dans le package extrait jazz_war.ear, copiez le fichier jazz.war dans le répertoire <répertoire_installation_tomcat_pour_rtc>/webapps/.
  11. Configurez un port sécurisé sur votre serveur Tomcat pour Rational Team Concert :
    1. Vous devez créer un certificat de sécurité qui identifie votre serveur Tomcat pour Rational Team Concert pour les connexions SSL. Vous avez la possibilité d'utiliser la commande keytool du kit SDK Java pour créer un certificat autosigné ou demander un certificat signé par une autorité de certification digne de confiance.

      Pour plus d'informations sur la création de certificats autosignés à l'aide de la commande keytool, voir la documentation Sun Java. Par ce biais, vous pouvez créer un certificat autosigné en utilisant l'exemple de commande suivant : keytool -genkey -alias tomcat -keystore <répertoire_installation_tomcat_pour_rtc>/.keystore

      Si vous utilisez un environnement IBM JRE, un grand nombre de versions incluent l'outil IBM ikeyman dans le répertoire <emplacement_installation_IBM_Java_JRE>/jre/bin/. Vous pouvez faire appel à cet outil pour créer et gérer les certificats de sécurité sur le serveur. Pour plus d'informations sur l'utilisation de l'outil iKeyman, voir le document iKeyman User's Guide.

    2. Dans le fichier <répertoire_installation_tomcat_pour_rtc>\conf\server.xml, recherchez la balise <Connector> associée à l'attribut scheme="https". Le fichier par défaut inclut un exemple de balise <Connector> pour le port 8443 qui est mis en commentaire.
    3. Copiez et collez le texte suivant :
      <Connector port="8443"
           maxHttpHeaderSize="8192" 
           maxThreads="150"
           minSpareThreads="25" 
           maxSpareThreads="75"
           enableLookups="false"
           disableUploadTimeout="true" 
           acceptCount="100"
           scheme="https"
           secure="true" 
           clientAuth="false"
           keystoreFile="<fichier_de_clés>"
           keystorePass="<mot_de_passe_du_fichier_de_clés>"
           sslProtocol="<protocole_du_fichier_de_clés>"
           algorithm="<algorithme_du_fichier_de_clés>"
           URIEncoding="UTF-8" />
      Où :
      • <fichier_de_clés> correspond au nom du fichier de clés. Il peut s'agir d'un chemin absolu ou relatif par rapport au répertoire racine de votre serveur Tomcat (<répertoire_installation_tomcat_pour_rtc>);
      • <mot_de_passe_du_fichier_de_clés> correspond au mot de passe du fichier de clés ;
      • <protocole_du_fichier_de_clés> correspond au protocole du fichier de clés. Il s'agit le plus souvent de TLS ou SSL_TLS;
      • <algorithme_du_fichier_de_clés> correspond à l'algorithme X509 du fichier de clés. Il s'agit le plus souvent de SunX509 ou IbmX509, selon la source du certificat.
    4. Si vous changez la valeur port afin d'utiliser un port autre que 8443, pour le connecteur non SSL (port 8080 par défaut), changez la valeur de l'attribut redirectPort pour qu'elle corresponde à votre numéro de port pour le connecteur SSL.

    Pour plus d'informations sur la configuration de SSL pour Tomcat, voir Apache Tomcat 5.5 SSL Configuration HOW-TO et Apache Tomcat Configuration reference.

  12. Configurez les paramètres de la propriété de démarrage Tomcat :
    1. Recherchez le fichier de démarrage Tomcat et ouvrez-le dans un éditeur de texte. Sous Windows®, il s'agit de <répertoire_installation_tomcat_pour_rtc>\bin\startup.bat. Sous Linux®, AIX ou Linux for zSeries, il s'agit de <répertoire_installation_tomcat_pour_rtc>/bin/startup.sh.
    2. Dans le fichier de démarrage, entrez le texte suivant dans lequel <rtc_install_dir> est le répertoire extrait à l'étape 9 :
      • Pour Windows :Sous Windows (remplacez les caractères espace dans <rtc_install_dir> par %20) :
        set JAZZ_INSTALL_DIR=<rtc_install_dir>
        set JAVA_OPTS=-Djava.awt.headless=true -DSQLSERVER_JDBC="%SQLSERVER_JDBC%" -DORACLE_JDBC="%ORACLE_JDBC%" -DDB2I_JDBC="%DB2I_JDBC%" -DDB2Z_JDBC="%DB2Z_JDBC%" -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true -DJAZZ_HOME=file:///%JAZZ_INSTALL_DIR%\jazz\server\conf -Dcom.ibm.team.repository.tempDir=%TEMP% -Xmx700M
      • Pour Linux :Pour AIX :Pour Linux for zSeries :Sous Linux, AIX ou Linux for zSeries :
        JAZZ_INSTALL_DIR=<rtc_install_dir>
        export JAVA_OPTS="-Djava.awt.headless=true -DSQLSERVER_JDBC=$SQLSERVER_JDBC -DORACLE_JDBC=$ORACLE_JDBC -DDB2I_JDBC=$DB2I_JDBC -DDB2Z_JDBC=$DB2Z_JDBC -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true -DJAZZ_HOME=file://"$JAZZ_INSTALL_DIR"/jazz/server/conf -Dcom.ibm.team.repository.tempDir=$TEMP_DIR -Xmx700M"
  13. Editez le fichier des propriétés de serveur Jazz :
    1. Dans le répertoire <rtc_install_dir>/jazz/server/conf/jazz/, recherchez le fichier teamserver.properties et renommez-le en teamserver.derby.properties.
    2. Dans le répertoire <rtc_install_dir>/jazz/server/conf/jazz/, recherchez le fichier teamserver.db2.win32.properties (pour Windows) ou le fichier teamserver.db2.linux.properties (pour Linux, AIX ou zLinux), puis renommez le fichier en teamserver.properties.
    3. Dans le fichier teamserver.properties, indiquez les propriétés de base de données et de connexion :
      1. Dans un éditeur de texte, ouvrez le fichier teamserver.properties.
      2. Recherchez les lignes suivantes :
        com.ibm.team.repository.db.vendor = DB2
        com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:user=db2admin;password={password};
        com.ibm.team.repository.db.jdbc.password=db2admin
      3. Editez la valeur de com.ibm.team.repository.db.jdbc.location pour votre emplacement de serveur DB2 ainsi que le nom de la base de données pour des cycles de vie :
        1. Remplacez localhost:50000 par l'emplacement et le port associés à la base de données DB2.
          Conseil : Dans la fenêtre de commande DB2, exécutez la commande db2 get dbm cfg, puis recherchez la ligne contenant SVCENAME qui indique le nom ou le numéro du port DB2. Si cette commande affiche un numéro, utilisez-le comme numéro de port (à la place de 50000 dans l'exemple ci-dessus). Si la commande retourne un nom non numérique, déterminez quel numéro de port a été attribué à ce nom et utilisez ce numéro de port. Sous Linux, le fichier /etc/services contient le mappage entre les noms et numéros de port ; sous Windows, le fichier C:\windows\system32\drivers\etc\services contient le mappage. Pour plus d'informations, demandez à votre administrateur de base de données ou consultez la documentation de la base de données.
        2. Remplacez JAZZ par le nom de la base de données pour des cycles de vie.
        3. Remplacez db2admin par le nom d'utilisateur pour la base de données DB2.
          Remarque : L'utilisateur DB2 doit posséder les droits de création de tables, d'espaces table et de modification de la configuration de la base de données. Les utilisateurs DB2 sont créés par le système d'exploitation.
      4. Indiquez le mot de passe de l'utilisateur dans la propriété com.ibm.team.repository.db.jdbc.password.
        Remarque : Ne changez pas le texte password={password} dans la propriété com.ibm.team.repository.db.jdbc.location.
      5. Ajoutez les propriétés suivantes au fichier teamserver.properties, où <unsecure_port> est le port non sécurisé de votre serveur Tomcat (par défaut, 8080), <secure_port> est le numéro de port sécurisé de votre serveur Tomcat (par défaut, 8443) et <team_temp_dir> est un chemin d'accès absolu vers un répertoire destiné au stockage des fichiers temporaires :
        com.ibm.team.scm.tmpdir=<team_temp_dir>
        com.ibm.team.repository.server.repourl.port.http=<unsecure_port>
        com.ibm.team.repository.user.registry.type=UNSUPPORTED
        com.ibm.team.repository.ws.allow.admin.access=false
        com.ibm.team.repository.server.repourl.port.https=<secure_port>
  14. Créez les tables pour Rational Team Concert :
    1. Ouvrez une fenêtre de ligne de commande et accédez au répertoire <rtc_install_dir>/jazz/server/.
    2. Exécutez la commande suivante :
      • Pour Windows ::
        repotools.bat -createTables teamserver.properties=conf\jazz\teamserver.properties
      • Pour Linux :Pour AIX :Pour Linux for zSeries ::
        ./repotools.sh -createTables teamserver.properties=conf/jazz/teamserver.properties
  15. Configurez les serveurs Tomcat pour la sécurité utilisateur. Si vous prévoyez d'utiliser la sécurité LDAP, employez d'abord la sécurité fondée sur les fichiers pour configurer l'application et passez à l'authentification LDAP après avoir configuré les applications (pour plus d'informations, voir Configuration de l'authentification LDAP pour Tomcat) :
    1. Dans un éditeur de texte, ouvrez le fichier <répertoire_installation_tomcat>\conf\tomcat-users.xml (du serveur pour Rational Asset Manager).
    2. Ajoutez un utilisateur nommé admin et affectez-lui les rôles admin et manager. Vous pouvez copier et coller les éléments suivants entre les balises <tomcat-users> :
      <user username="admin" password="" roles="admin,manager" />

      L'utilisateur doit être nommé admin.

    3. Dans un éditeur de texte, ouvrez le fichier <répertoire_installation_tomcat_pour_rtc>\conf\tomcat-users.xml (du serveur pour Rational Team Concert). A nouveau, si vous installez les applications sur le même serveur Tomcat, il s'agira du même fichier que celui à l'étape 15a.
    4. Collez le texte suivant entre les balises <tomcat-users> :
      <role rolename="JazzUsers"/>
      <role rolename="JazzAdmins"/>
      <role rolename="JazzDWAdmins"/>
      <role rolename="JazzGuests"/>
    5. Ajoutez un utilisateur nommé admin et affectez-lui les rôles admin, manager et JazzAdmins. Vous pouvez copier et coller les éléments suivants entre les balises <tomcat-users> :
      <user username="admin" password="" roles="admin,manager,JazzAdmins" />

      Si vous installez les applications sur le même serveur, vous pouvez ajouter le rôle JazzAdmins à l'utilisateur que vous avez créé à l'étape 13b.

  16. Redémarrez le serveur Tomcat.
  17. Configurez l'utilisateur administratif pour Rational Team Concert:
    1. Lancez l'interface utilisateur Web d'administration de Rational Team Concert dans un navigateur Web à l'adresse https://<nom_machine>:<port_sécurisé>/jazz/admin/. Remarquez https ; la connexion doit être sécurisée.
    2. Connectez-vous avec l'ID utilisateur et le mot de passe de l'administrateur du serveur d'applications. Si une erreur se produit lors de l'extraction des informations de statut du serveur, arrêtez puis redémarrez le serveur de base de données et le serveur Tomcat et reconnectez-vous.
    3. Cliquez sur Gestion des utilisateurs. Ignorez toute erreur liée à la non-configuration d'un registre externe.
    4. Cliquez sur Créer l'utilisateur.
    5. Entrez les détails suivants :
      1. Nom d'utilisateur : l'ID utilisateur de l'administrateur de serveur Tomcat
      2. ID utilisateur : l'ID utilisateur de l'administrateur de serveur Tomcat
      3. Adresse e-mail : un adresse e-mail valide pour l'administrateur de serveur Tomcat
    6. Dans la section Licence Client Access, sélectionnez Rational Team Concert - Développeur de logiciel pour attribuer la licence développeur à cet utilisateur.
    7. Cliquez sur Sauvegarder.
    8. Déconnectez-vous puis reconnectez-vous à l'interface utilisateur Web d'administration en tant qu'administrateur du serveur d'applications.
  18. Importez le modèle de processus de cycles de vie dans Rational Team Concert :
    1. Dans l'interface utilisateur Web d'administration Rational Team Concert, cliquez sur Gestion des modèles de processus.
      Si le lien Gestion des modèles de processus n'apparaît pas, déconnectez-vous puis reconnectez-vous à l'interface utilisateur Web d'administration.
    2. Cliquez sur Importer un modèle et accédez au fichier com.ibm.ram.lifecycle.zip du dossier <emplacement_extraction_archivage>/DatabaseScripts/. Cliquez ensuite sur OK. Le modèle Cycle de vie RAM apparaît.
  19. Créez une zone de projet dans Rational Team Concert:
    1. Dans l'interface utilisateur Web d'administration, cliquez sur Gestion des zones de projet. Si le lien Gestion des zones de projet n'apparaît pas, déconnectez-vous puis reconnectez-vous à l'interface utilisateur Web d'administration.
    2. Cliquez sur Créer une zone de projet.
    3. Entrez les détails suivants pour la zone de projet :
      • Nom de projet : Cycle de vie RAM
      • Récapitulatif: Zone de projet de contrôle du cycle de vie de Rational Asset Manager
      • Description : Cette zone permet de gérer des cycles de vie pour Rational Asset Manager
    4. Cliquez sur Sauvegarder.
  20. Attribuez les appartenances et rôles de processus pour la zone de projet :
    1. Sur la page Gestion de zone de projet, cliquez sur la zone de projet Cycle de vie RAM.
    2. Dans la section Administrateurs, cliquez sur Ajouter ; puis recherchez et sélectionnez l'utilisateur administrateur que vous avez créé.
    3. Dans la section Membres, cliquez sur Ajouter ; puis recherchez et sélectionnez l'utilisateur administrateur que vous avez créé.
    4. Après avoir ajouté l'administrateur, cliquez sur l'icône Rôles de processus situé après le nom de l'administrateur.
    5. Dans la boîte de dialogue Editer des rôles de processus, dans la liste Rôles disponibles, sélectionnez Administration, puis cliquez sur Ajouter.
    6. Cliquez sur Terminer.
    7. Cliquez sur Sauvegarder.
  21. Arrêtez puis redémarrez le serveur Tomcat.
  22. Dans un navigateur Web, ouvrez Rational Asset Manager. Si vous avez utilisé les noms recommandés pour les fichiers d'application, l'adresse URL correspondra à http://localhost:8080/ram/home.faces, ou via un serveur Web, elle correspondra à http://<adresse_serveur_Web>:<port>/ram/home.faces. Le client Web Rational Asset Manager s'ouvre.

Que faire ensuite

Ensuite, configurez l'application Web Rational Asset Manager. Pour plus d'informations, voir Configurer l'application du serveur Rational Asset Manager.

Vos commentaires