Mettre à niveau à partir d'une version précédente sur Tomcat

Utilisez ce guide pour effectuer une mise à niveau à partir d'une version antérieure de IBM® Rational Asset Manager sur Apache Tomcat.

Avant de commencer

Important : En outre, vous devez installer IBM Rational Team Concert, qui nécessite une base de données supplémentaire et un certificat sécurisé pour votre serveur Tomcat.

Vous devez mettre à niveau le serveur de licences et enregistrer une demande de clés de licence mises à jour. Pour plus d'informations sur la version requise du serveur de licences de Rational, voir Installation de Rational License Key Server.

En outre, vous devez arrêter et redémarrer votre serveur d'applications plusieurs fois.

Vous pouvez améliorer les performances et la stabilité de Rational Asset Manager en installant ses applications Web et les fichiers d'applications de la version incluse d'IBM Rational Team Concert sur des serveurs Tomcat distincts. Dans le présent document, le répertoire d'installation du serveur Tomcat Rational Asset Manager est appelé répertoire_installation_tomcat. Le répertoire d'installation du serveur Tomcat de Rational Team Concert correspond à répertoire_installation_tomcat_pour_rtc. Si vous installez toutes les applications Web sur le même serveur Tomcat, les répertoires sont les mêmes.

Pourquoi et quand exécuter cette tâche

Cette présentation montre comment procéder pour mettre à niveau à la dernière version de Rational Asset Manager :
  1. Préparez la mise à niveau et sauvegardez les fichiers et les bases de données importants : step 1.
  2. Récupérez les fichiers d'application pour la dernière version de Rational Asset Manager : étape 4.
  3. Si vous faites une mise à niveau depuis V7.1.1.1 ou antérieure, créez une autre base de données : étape 5.
  4. Arrêtez le serveur Tomcat : étape 6.
  5. Mettez à niveau votre serveur de licences vers Rational Common Licensing 8.1.2 : étape 7.
  6. Copiez les nouveaux fichiers de bibliothèque partagée pour Rational Asset Manager et Rational Common Licensing 8.1.2 et modifiez les fichiers de démarrage du serveur Tomcat en conséquence : étapes 810.
  7. Configurez le serveur Tomcat pour la connexion unique : étape 11.
  8. Récupérez les fichiers d'application en cours pour l'instance Rational Team Concert incluse : étapes 1213.
  9. Si vous faites une mise à niveau depuis V7.1.1.1 ou antérieure et avez besoin de Rational Team Concert, installez Rational Team Concert sur votre serveur d'applications : étapes 1623.
  10. Si vous faites une mise à niveau depuis V7.1.1.1 ou antérieure, configurez Rational Team Concert : étapes2430.
  11. Si vous faites une mise à niveau depuis V7.2 ou ultérieure, mettez à niveau l'instance Rational Team Concert incluse : étape 32.
  12. Supprimez les fichiers d'application existants pour Rational Asset Manager et installez les nouvelles versions des applications : étapes 3338.
  13. Connectez-vous à Rational Asset Manager et migrez le référentiel : étape 39.
  14. Si vous faites une mise à niveau depuis V7.1.1.1 ou antérieure, configurez Rational Asset Manager pour vous connecter à Rational Team Concert : étape 40.
  15. Mettez à niveau tous les clients Eclipse : étape 41.

Procédure

  1. Avant la mise à niveau, créez une sauvegarde intégrale du référentiel, des bases de données, des fichiers d'actifs et des paramètres de serveur d'applications selon les instructions dans Création d'une sauvegarde d'un référentiel Rational Asset Manager.
  2. Si vous avez modifié votre thème ou vos courriers électroniques, avant de mettre à jour le serveur Rational Asset Manager, téléchargez les fichiers de courriers électroniques et de thèmes actuels (dans la page Administration > Outils) puis, une fois le serveur mis à jour, appliquez à nouveau le thème et les messages. Pour plus d'informations, voir Migration du thème.
  3. Vérifiez que tous les serveurs de référentiels sont définis aux mêmes date, heure et fuseau horaire courants.
  4. Extrayez les fichiers d'application dans l'archive appropriée pour Tomcat et votre système d'exploitation. Les fichiers d'application se trouvent dans le dossier emplacement_extraction_archive/apps/tomcat/.
  5. Si vous effectuez une mise à niveau à partir de la version 7.1.1.1 ou précédente : Créez la base de données pour des cycles de vie d'actifs :
  6. Arrêtez le ou les serveurs Tomcat. Votre référentiel et toutes les autres applications de votre serveur doivent maintenant être déconnectées.
  7. Pour Windows :Pour Linux :Pour AIX : Migrez votre serveur Rational Licensing Server vers Rational Common Licensing version 8.1.2 ou ultérieure. Pour plus d'informations, voir Migration depuis Rational Licensing Server v7.1.x ou antérieure vers Rational Common Licensing.

    Rational License Key Server est inclus sur le support d'installation de Rational Asset Manager. Vous pouvez également récupérer la dernière version de Rational License Server avec votre compte Passport Advantage ou par le biais du portail du support IBM.

    Ce processus requiert l'arrêt de toutes les applications utilisant Rational Licensing Server, la désinstallation de la version existante de votre serveur Rational Licensing Server, la mise à jour des fichiers de licence et l'installation du serveur Rational Common Licensing. Pour Windows, voir Configuration d'un serveur de licences pour Windows ; pour AIX ou Linux, voir Configuration d'un serveur de licences pour UNIX.

    Pour Linux for zSeries, continuez à utiliser le serveur Rational License Server for UNIX et Linux 7.0.0.1.
  8. Extrayez les fichiers de bibliothèque partagée dans le dossier \shared\lib des serveurs Tomcat :
    1. Recherchez et extrayez le fichier emplacement_extraction_archive\apps\tomcat\sharedLib.zip.
    2. Copiez l'intégralité du contenu du fichier sharedLib.zip extrait dans le répertoire répertoire_installation_tomcat\lib.
  9. Pour Windows : Pour Linux :Pour AIX : Extrayez les fichiers de bibliothèque pour Rational Licensing Key Server V8.1.2 vers le dossier répertoire_installation_tomcat\lib :
    Important : Si vous exécutez l'installation sur Linux for zSeries, ne suivez pas cette étape.
    1. Recherchez et extrayez le fichier emplacement_extraction_archive\sharedLibs\rlsclients_rlsibmratl_812.zip.
    2. Dans le fichier .zip extrait, recherchez le fichier rlsibmratl812.zip pour votre système d'exploitation et architecture. Par exemple, le fichier pour Windows 32 bits se trouve dans le répertoire win32.
    3. Extrayez le contenu du fichier rlsibmratl812.zip approprié.
    4. Copiez la totalité du contenu du fichier rlsibmratl812.zip extrait dans le répertoire répertoire_installation_tomcat\shared\lib. Pour Tomcat 6 ou 7, copiez la totalité du contenu du fichier rlsibmratl812.zip extrait dans le répertoire répertoire_installation_tomcat\lib.
  10. Pour Windows :Pour Linux :Pour AIX : Modifiez le script de démarrage du serveur Tomcat pour Rational Asset Manager
    1. Recherchez le fichier de démarrage Tomcat et ouvrez-le dans un éditeur de texte. Sous Windows, ce fichier correspond à répertoire_installation_tomcat\bin\startup.bat. Sous Linux, AIX ou Linux for zSeries, il s'agit de répertoire_installation_tomcat/bin/startup.sh.
    2. Recherchez une ligne incluant JAVA_OPTS=.
      • Si la variable d'environnement JAVA_OPTS est déjà définie, ajoutez l'option et la valeur suivantes :
        • Pour Windows :
          -Djava.library.path="répertoire_installation_tomcat\shared\lib"
        • Pour Linux :Pour AIX :
          -Djava.library.path=répertoire_installation_tomcat/shared/lib
      • Si la variable d'environnement JAVA_OPTS n'est pas définie, entrez le texte suivant :
        • Pour Windows :
          set JAVA_OPTS=-Djava.library.path="répertoire_installation_tomcat\lib"
        • Pour Linux :Pour AIX :
          export JAVA_OPTS="-Djava.library.path=répertoire_installation_tomcat/lib"
  11. Configurez le serveur Tomcat afin que la fonction SSO soit utilisée pour toutes les applications :
    1. Dans un éditeur de texte, ouvrez le fichier répertoire_installation_tomcat\conf\server.xml.
    2. Recherchez le texte suivant :
      <!--
      <Valve className="org.apache.catalina.authenticator.SingleSignOn" />
      -->
    3. Supprimez la mise en commentaire de l'élément <Valve> :
      <Valve className="org.apache.catalina.authenticator.SingleSignOn" />
    4. Si vous n'exécutez pas Tomcat en tant que service, ouvrez dans un éditeur de texte le fichier startup.bat (sur Microsoft Windows) ou le fichier startup.sh (sur Linux). Ajoutez la ligne ci-dessous au fichier. Pour Microsoft Windows :
      SET JAVA_OPTS=" -Dorg.apache.catalina.authenticator.Constants.SSO_SESSION_COOKIE_NAME=JSSOSESSIONID"
      Pour Linux :
      export JAVA_OPTS=" -Dorg.apache.catalina.authenticator.Constants.SSO_SESSION_COOKIE_NAME=JSSOSESSIONID"
    5. Si vous exécutez Tomcat en tant que service, ajoutez les options suivantes à la commande d'installation de service que vous utilisez pour installer Tomcat en tant que service : --JvmOptions "-Xrs; -Dorg.apache.catalina.authenticator.Constants.SSO_SESSION_COOKIE_NAME=JSSOSESSIONID"
  12. Sur le support d'installation, recherchez le fichier emplacement_extraction_archive/apps/tomcat/RTC-server.zip.
  13. Extrayez le fichier RTC-server.zip dans un emplacement de l'unité de disque dur, appelé rép_install_rtc dans ces instructions.
  14. En fonction de la situation, installez et configurez ou mettez à jour Rational Team Concert :
    • Si vous mettez à niveau la version 7.1.1.1 ou suivante : Installez et configurez la version incluse de Rational Team Concert. Passez à l'étape 15.
    • Si vous mettez à niveau la version 7.2 ou suivante : Mettez à jour la version incluse de Rational Team Concert. Passez à l'étape 32.
  15. En fonction de votre situation, installez et configurez ou configurez uniquement Rational Team Concert :
    • Si vous devez installer et configurer Rational Team Concert : Passez à l'étape 16.
    • Si vous disposez d'une application Rational Team Concert existante et que vous souhaitez la configurer pour Rational Asset Manager : Passez à l'étape 24.
  16. Recherchez le fichier rép_install_rtc/jazz/server/ramjazz_war.ear et extrayez-le. Pour extraire des fichiers .ear, vous pouvez lancer un utilitaire gratuit, tel que 7-Zip. Dans le package extrait ramjazz_war.ear, copiez le fichier ramjazz.war dans le répertoire répertoire_installation_tomcat_pour_rtc/webapps/.
  17. Configurez un port sécurisé sur votre serveur Tomcat pour Rational Team Concert :
    1. Créez un certificat de sécurité qui identifie le serveur Tomcat pour Rational Team Concert lors de connexions SSL. Vous pouvez utiliser la commande keytool de Java™ JDK pour créer un certificat autosigné. Vous pouvez également demander un certificat signé par une autorité de certification habilitée.
      Pour plus d'informations sur la création de certificats autosignés avec la commande keytool, voir la documentation Java d'Oracle. Vous pouvez créer un certificat autosigné avec l'exemple de commande keytool suivant :
      keytool -genkey -alias tomcat -keystore répertoire_installation_tomcat_pour_rtc/.keystore

      Lorsque vous exécutez cette commande, vous êtes invité à entrer un mot de passe pour le fichier de clés. Le mot de passe par défaut est changeit mais vous devez en indiquer un autre. Vous devez mémoriser ce mot de passe pour l'indiquer ultérieurement dans le fichier server.xml.

      Si vous utilisez un environnement JRE IBM, de nombreuses versions incluent l'outil IBM ikeyman dans le répertoire emplacement_installation_JRE_Java_IBM/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.

      Vous trouverez aussi un certificat dans le dossier rép_install_rtc/jazz/server/ ; le fichier de certificat est ibm-team-ssl.keystore

    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"
           connectionTimeout="20000"
           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). Si vous avez utilisé la commande simple ci-dessus, il s'agit de .keystore. Si vous utilisez le certificat inclus, il s'agit de rép_install_rtc/jazz/server/ibm-team-ssl.keystore .
      • mot_de_passe_du_fichier_de_clés est le mot de passe pour le fichier de clés. Si vous utilisez le fichier de clés inclus, il s'agit de ibm-team.
      • 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. Si vous utilisez le fichier de clés inclus, il s'agit de 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. Si vous utilisez le fichier de clés inclus, il s'agit de IbmX509.
    4. Vous pouvez modifier la valeur port pour utiliser un port autre que 8443 pour le connecteur non SSL (par défaut, le port 8080). Si vous modifiez la valeur du port, modifiez la valeur de l'attribut redirectPort pour qu'elle corresponde au numéro de port du connecteur SSL.

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

  18. Pour Oracle :Pour Microsoft SQL Server : Copiez le fichier .jar approprié du fournisseur de base de données :
    • Pour Oracle : Copiez le fichier ojdbc6.jar dans le dossier rép_install_rtc/jazz/server/oracle (il peut s'avérer nécessaire de créer le dossier oracle).

      Vous pouvez télécharger le fichier d'Oracle.

    • Pour Microsoft SQL Server : Copiez le fichier suivant dans le dossier rép_install_rtc/jazz/server/sqlserver (il peut s'avérer nécessaire de créer le dossier sqlserver) :
      • sqljdbc4.jar (vous pouvez télécharger ce fichier de Microsoft.)
  19. 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, ce fichier correspond à répertoire_installation_tomcat_pour_rtc\bin\startup.bat. Sous Linux, AIX ou Linux for zSeries, le fichier correspond à répertoire_installation_tomcat_pour_rtc/bin/startup.sh.
    2. Dans le fichier de démarrage, entrez le texte suivant :
      • Pour Windows : Remplacez chaque espace dans rép_install_rtc par %20 :
        set ORACLE_JDBC=oracle_jar_dir
        set SQLSERVER_JDBC=sqlServer_jar_dir
        set JAZZ_INSTALL_DIR=rép_install_rtc
        set JAVA_OPTS=-Djava.awt.headless=true -Djava.library.path="répertoire_installation_tomcat_pour_rtc\shared\lib" -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 :
        ORACLE_JDBC=oracle_jar_dir
        SQLSERVER_JDBC=sqlServer_jar_dir
        JAZZ_INSTALL_DIR=rép_install_rtc
        export JAVA_OPTS="-Djava.awt.headless=true -Djava.library.path=répertoire_installation_tomcat_pour_rtc/shared/lib -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"
      Où :
      • rép_install_rtc est le répertoire extrait du fichier RTC-server.zip. Sous Windows, remplacez chaque espace dans rép_install_rtc par %20
      • Pour Oracle : oracle_jar_dir est le répertoire pour le fichier ojdbc6.jar (rép_install_rtc/jazz/server/oracle)
      • Pour Microsoft SQL Server : sqlServer_jar_dir est le répertoire pour le fichier sqljdbc4.jar (rép_install_rtc/jazz/server/sqlserver)
      • répertoire_installation_tomcat_pour_rtc correspond au répertoire d'installation du serveur Tomcat
      • Pour Windows : Pour Linux :Pour AIX : Si vous installez Rational Asset Manager et Rational Team Concert sur le même serveur d'applications, utilisez cette variable système JAVA_OPTS pour remplacer celle que vous avez créée lorsque vous avez configuré le script de démarrage du serveur Tomcat pour Rational Asset Manager ; cette déclaration comprend aussi l'option -Djava.library.path.
  20. Recherchez et renommez le fichier de propriétés du serveur Jazz approprié :
    1. Dans le répertoire rép_install_rtc/jazz/server/conf/ramjazz/, recherchez le fichier teamserver.properties et renommez-le en teamserver.derby.properties.
    2. Recherchez le fichier approprié à votre serveur de base de données :
      • Pour DB2 :Pour Windows :Pour DB2 sous Windows : teamserver.db2.win32.properties
      • Pour DB2 :Pour Linux :Pour AIX :Pour Linux for zSeries :Pour DB2 sur Linux, AIX ou Linux for zSeries : teamserver.db2.linux.properties
      • Pour Oracle : teamserver.oracle.properties
      • Pour SQL Server : teamserver.sqlserver.properties
    3. Renommez le fichier en teamserver.properties.
  21. Dans un éditeur de texte, ouvrez le fichier teamserver.properties et modifiez-le de la manière suivante (pour le fournisseur de base de données) :
    • Pour DB2 :
      1. 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
      2. 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, tapez 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 (au lieu 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 des cycles de vie.
        3. Remplacez db2admin par le nom d'utilisateur de 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.
      3. Dans la propriété com.ibm.team.repository.db.jdbc.password, indiquez le mot de passe de l'utilisateur.
        Remarque : Ne changez pas le texte password={password} dans la propriété com.ibm.team.repository.db.jdbc.location.
      4. Dans le fichier teamserver.properties, ajoutez les propriétés suivantes :
        Où :
        • port_non_sécurisé est le port non sécurisé pour votre serveur Tomcat (par défaut, 8080).
        • port_sécurisé est le numéro du port sécurisé pour votre serveur Tomcat (par défaut, 8443).
        • rép_temp_équipe est le chemin d'accès absolu à un répertoire pour stocker les fichiers temporaires.
        com.ibm.team.scm.tmpdir=rép_temp_équipe
        com.ibm.team.repository.server.repourl.port.http=port_non_sécurisé
        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=port_sécurisé
    • Pour Oracle :
      1. Recherchez les lignes suivantes :
        com.ibm.team.repository.db.vendor = ORACLE
        com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@localhost:1521/ORCL
        com.ibm.team.repository.db.jdbc.password=jazzDBpswd
      2. Editez la valeur de com.ibm.team.repository.db.jdbc.location pour votre emplacement de serveur Oracle ainsi que le nom de la base de données pour des cycles de vie :
        1. Remplacez jazzDBUser par le nom d'utilisateur de la base de données Oracle (par exemple, RAMSCHEMA.
        2. Replacez @localhost:1521 par l'emplacement et le port pour la base de données Oracle. Si l'emplacement n'est pas localhost, vous devez faire précéder l'emplacement par deux barres obliques (//) ; par exemple @//oracleserver.exemple.com:1521.
        3. Remplacez ORCL par le nom de la base de données des cycles de vie ; par exemple, rtcdb.
      3. Dans la propriété com.ibm.team.repository.db.jdbc.password, remplacez JazzDBpswd par le mot de passe Oracle de l'utilisateur Oracle indiqué ci-dessus.
        Remarque : Ne modifiez pas le texte {password} dans la propriété com.ibm.team.repository.db.jdbc.location.
      4. Dans le fichier teamserver.properties, ajoutez les propriétés suivantes :
        Où :
        • port_non_sécurisé est le port non sécurisé pour votre serveur Tomcat (par défaut, 8080).
        • port_sécurisé est le numéro du port sécurisé pour votre serveur Tomcat (par défaut, 8443).
        • rép_temp_équipe est le chemin d'accès absolu à un répertoire pour stocker les fichiers temporaires.
        com.ibm.team.scm.tmpdir=rép_temp_équipe
        com.ibm.team.repository.server.repourl.port.http=port_non_sécurisé
        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=port_sécurisé
      5. Si vous utilisez Oracle 11 : dans le fichier teamserver.properties, ajoutez la propriété suivante :
        com.ibm.team.repository.db.override.versioncheck=true
    • Pour Microsoft SQL Server :
      1. Recherchez les lignes suivantes :
        com.ibm.team.repository.db.vendor = SQLSERVER
        com.ibm.team.repository.db.jdbc.location=//localhost:1433;databaseName=jazz;user=jazzDBuser;password={password}
        com.ibm.team.repository.db.jdbc.password=jazzDBpswd
      2. Editez la valeur de com.ibm.team.repository.db.jdbc.location pour votre emplacement SQL Server ainsi que le nom de la base de données pour des cycles de vie :
        1. Replacez @localhost:1433 par l'emplacement et le port pour la base de données SQL Server.
        2. Replace jazz par le nom de la base de données des cycles de vie ; par exemple RTCDB.
        3. Remplacez jazzDBUser par le nom d'utilisateur pour la base de données SQL Server.
      3. Dans la propriété com.ibm.team.repository.db.jdbc.password, remplacez JazzDBpswd par le mot de passe de l'utilisateur du serveur SQL indiqué ci-dessus.
        Remarque : Ne modifiez pas le texte {password} dans la propriété com.ibm.team.repository.db.jdbc.location.
      4. Dans le fichier teamserver.properties, ajoutez les propriétés suivantes :
        Où :
        • port_non_sécurisé est le port non sécurisé pour votre serveur Tomcat (par défaut, 8080).
        • port_sécurisé est le numéro du port sécurisé pour votre serveur Tomcat (par défaut, 8443).
        • rép_temp_équipe est le chemin d'accès absolu à un répertoire pour stocker les fichiers temporaires.
        com.ibm.team.scm.tmpdir=rép_temp_équipe
        com.ibm.team.repository.server.repourl.port.http=port_non_sécurisé
        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=port_sécurisé
  22. Créez les tables pour Rational Team Concert :
    1. Ouvrez la fenêtre de ligne de commande et accédez au répertoire rép_install_rtc/jazz/server/.
    2. Entrez 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
  23. Configurez l'autorisation utilisateur pour l'application Rational Team Concert incluse.
    • Pour la sécurité fondée sur les fichiers :
      1. Dans un éditeur de texte, ouvrez le fichier répertoire_installation_tomcat_pour_rtc\conf\tomcat-users.xml.
      2. Entre les balises <tomcat-users>, collez le texte suivant :
        <role rolename="JazzUsers"/>
        <role rolename="JazzAdmins"/>
        <role rolename="JazzDWAdmins"/>
        <role rolename="JazzGuests"/>
      3. Ajoutez un utilisateur admin et affectez-lui les rôles admin, manager et JazzAdmins. Pour ajouter cet utilisateur, vous pouvez copier et coller le texte suivant entre les balises <tomcat-users> :
        <user username="admin" password="" roles="admin,manager,JazzAdmins" />

        Si vous installez les applications sur le même serveur Tomcat, ajoutez le rôle JazzAdmins à l'administrateur existant.

    • Pour l'authentification LDAP : Configurez le serveur Tomcat pour l'authentification LDAP, puis configurez quatre groupes LDAP avec les mêmes noms que les quatre rôles mentionnés ci-dessus. Vous avez également la possibilité d'associer des groupes LDAP existants au rôle du serveur Jazz comme indiqué dans Tech Tip TN0030: User Management in Tomcat. Suivez les étapes 23 dans la rubrique Configurer Rational Team Concert sur Tomcat pour utiliser LDAP.
  24. Démarrez le serveur Tomcat pour Rational Team Concert. Pour démarrer Tomcat, exécutez le fichier suivant :
    • Pour Windows :répertoire_installation_tomcat_pour_rtc\bin\startup.bat
    • Ppur Linux :Pour AIX :Pour Linux for zSeries :répertoire_installation_tomcat_pour_rtc/bin/startup.sh
  25. Lancez l'interface d'administration Web de Rational Team Concert dans un navigateur Web à l'adresse https://nom_système:port_sécurisé/jazz/admin/. Notez la mention https ; la connexion doit être sécurisée.
  26. Connectez-vous à l'aide de l'ID utilisateur et du mot de passe de l'administrateur de Rational Team Concert. Si personne ne s'est connecté à Rational Team Concert auparavant, utilisez l'ID utilisateur et le mot de passe de l'administrateur du serveur d'applications.
  27. Si vous utilisez une nouvelle installation de Rational Team Concert : Configurez l'administrateur de Rational Team Concert :
    1. 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 d'applications et reconnectez-vous.
    2. Dans l'interface d'administration Web de Rational Team Concert, cliquez sur Gestion d'utilisateurs. Ignorez toute erreur liée à la non-configuration d'un registre externe.
    3. Cliquez sur Créer l'utilisateur.
    4. Entrez les détails suivants :
      1. Nom d'utilisateur : ID utilisateur de l'administrateur du serveur d'applications
      2. ID utilisateur : ID utilisateur de l'administrateur du serveur d'applications
      3. Adresse électronique : adresse électronique valide pour l'administrateur du serveur d'applications.
    5. Dans la section Licence Accès client, sélectionnez Rational Team Concert - Développeur de logiciel pour attribuer la licence développeur à cet utilisateur.
    6. Cliquez sur Enregistrer.
    7. Déconnectez-vous, puis reconnectez-vous à l'interface d'administration Web en tant qu'administrateur du serveur d'applications.
  28. Importez le modèle de processus de cycles de vie dans Rational Team Concert :
    1. Dans l'interface d'administration Web de 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 d'administration Web.
    2. Cliquez sur Importer un modèle et accédez au fichier com.ibm.ram.lifecycle.zip du dossier emplacement_extraction_archive/DatabaseScripts/. Cliquez ensuite sur OK. Le modèle correspondant au cycle de vie RAM est affiché.
  29. Créez une zone de projet dans Rational Team Concert :
    1. Dans l'interface d'administration Web de Rational Team Concert, 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 d'administration Web.
    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 Enregistrer.
  30. 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 le client Administrateurs, cliquez sur Ajouter. Recherchez et sélectionnez l'administrateur que vous avez créé. Si vous utilisez une application Rational Team Concert existante, vous pouvez également sélectionner un autre utilisateur comme administrateur de cette zone de projet.
    3. Dans la section Membres, cliquez sur Ajouter ; Recherchez et sélectionnez le même utilisateur en tant qu'administrateur pour la zone de projet.
    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 liste Rôles disponibles de la fenêtre Editer des rôles de processus, sélectionnez Administration, puis cliquez sur Ajouter.
    6. Cliquez sur Terminer.
    7. Cliquez sur Enregistrer.
  31. Si vous mettez à niveau la version 7.1.1.1 ou suivante : Passez à l'étape 33.
  32. Si vous mettez à niveau la version 7.2 ou suivante , mettez à niveau l'application Rational Team Concert incluse :
    1. A partir du support d'installation, extrayez le fichier RTC-Server.zip dans un nouvel emplacement de l'unité de disque dur correspondant à nouveau_rép_install_rtc dans les instructions.
    2. A partir du dossier rép_install_rtc/jazz/server/conf/jazz/ antérieur, copiez le fichier teamserver.properties dans le nouveau dossier nouveau_rép_install_rtc/jazz/server/conf/jazz/.

      Vous pouvez rechercher l'emplacement existant rép_install_rtc dans le fichier de démarrage Tomcat. Dans ce fichier, recherchez la ligne qui contient JAZZ_INSTALL_DIR= ; la valeur de la variable JAZZ_INSTALL_DIR correspond à l'emplacement des fichiers Rational Team Concert en cours.

    3. Recherchez le fichier de démarrage Tomcat et ouvrez-le dans un éditeur de texte. Sous Windows, ce fichier correspond à répertoire_installation_tomcat_pour_rtc\bin\startup.bat. Sous Linux, AIX ou Linux for zSeries, le fichier correspond à répertoire_installation_tomcat_pour_rtc/bin/startup.sh.
    4. Dans le fichier de démarrage Tomcat, recherchez la ligne qui contient JAZZ_INSTALL_DIR=. Modifiez la valeur pour les éléments suivants, où nouveau_rép_install_rtc correspond au répertoire extrait à l'étape 32.a :
      • Pour Windows : (remplacez les espaces dans nouveau_rép_install_rtc par %20 ):
        set REP_INSTALL_JAZZ=nouveau_rép_install_rtc
      • Pour Linux :Pour AIX :Pour Linux for zSeries : :
        REP_INSTALL_JAZZ=nouveau_rép_install_rtc
    5. Démarrez le serveur Tomcat.
    6. Dans un navigateur Web, entrez l'adresse URL suivante : https://hôte:port_sécurisé/jazz/admin?internal, où hôte est l'adresse IP ou le nom du serveur et port_sécurisé est le port sécurisé du serveur Tomcat.
    7. Connectez-vous en tant qu'administrateur du serveur d'applications.
    8. Dans la barre d'outils latérale, sous la section Internal Tools, cliquez sur Server reset.
    9. Cliquez sur Request server reset.
    10. Arrêtez, puis redémarrez le serveur Tomcat. L'application Rational Team Concert incluse est mise à jour.
  33. Arrêtez le serveur Tomcat pour Rational Asset Manager.
  34. Supprimez les anciens fichiers de l'application Web .war de Rational Asset Manager installés sur Tomcat :
    1. Accédez au répertoire répertoire_installation_tomcat/webapps/.
    2. Notez les dossiers et les noms de fichier de toutes les applications Web de Rational Asset Manager. Dans les versions précédentes de Rational Asset Manager, les noms suivants étaient conseillés pour ces dossiers (c'est-à-dire les chemins du contexte des applications) :
      • /com.ibm.ram.repository.web.tomcat_runtime
      • /com.ibm.ram.repository.web.ws.tomcat_runtime
      • /help/
      • /abdprocess/
    3. Supprimez les fichiers d'application suivants :
      • com.ibm.ram.repository.web.tomcat_runtime.war
      • com.ibm.ram.repository.web.ws.tomcat_runtime.war
      • ramhelp.war
      • rmcabdgovernprocess.war
      Les noms de fichiers peuvent être différents de ceux indiqués dans la liste, en fonction du mode d'installation des applications sur votre serveur.
    4. Supprimez les dossiers associés pour ces applications.
  35. A partir du répertoire emplacement_extraction_archive/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
    • ramhelp.war
    • rmcabdgovernprocess.war
  36. Pour changer le chemin du contexte de l'application, renommez les fichiers d'application WAR. Utilisez les mêmes chemins de contexte que précédemment. Les noms de fichier et les chemins de contexte des nouvelles installations sont les suivants :
    Tableau 1. Chemins de contexte des fichiers d'application Web Rational Asset Manager
    Nom de fichier d'origine Nouveau nom de fichier 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 de services Web Rational Asset Manager pour Tomcat
    ramhelp.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
  37. Videz le cache du serveur Tomcat. Supprimez le répertoire répertoire_installation_tomcat/work/.
  38. Redémarrez le serveur Tomcat pour Rational Asset Manager.
  39. Faites migrer le référentiel Rational Asset Manager vers la nouvelle version :
    1. Dans un navigateur Web, ouvrez le client Web de Rational Asset Manager. A la première ouverture du client Web après une mise à niveau, un message vous indique que vous devez migrer le référentiel.
    2. Si nécessaire, connectez-vous avec un ID utilisateur disposant des droits d'administrateur de référentiels.
      Remarque : Pour SQL Server, si le classement d'une base de données Rational Asset Manager existante n'est pas défini sur une séquence se terminant par _BIN2 (Latin1_General_BIN2, par exemple), la page Configuration manuelle obligatoire apparaît avec un message. Vous pouvez soit recréer la base de données et définir l'option de classement comme sensible à la casse pour qu'elle fonctionne correctement avec Rational Asset Manager soit accepter qu'il puisse y avoir des conflits inattendus de respect de la casse.
    3. Cliquez sur Migrer. Pour les référentiels volumineux, la migration peut prendre plusieurs minutes. Certaines informations sur les référentiels peuvent être indisponibles tant que le processus n'est pas terminé.
    4. Une fois la migration effectuée, cliquez sur Accueil.
  40. Si vous mettez à niveau la version 7.1.1.1 ou suivante : Configurez les paramètres utilisés pour se connecter à Rational Team Concert à partir de Rational Asset Manager :
    1. Sur le client Web de Rational Asset Manager, cliquez sur Administration.
    2. Cliquez sur Configuration.
    3. Dans la section Chemin interne de Rational Team Concert, entrez les informations suivantes :
      1. Chemin : Adresse URL sécurisée du serveur Rational Team Concert que vous avez configuré. Par exemple, https://localhost:9443/ramccm. Notez la connexion https sécurisée et le numéro de port sécurisé.
      2. Utilisateur : Nom d'utilisateur dans Rational Team Concert correspondant à l'administrateur de la zone de projet "Cycles de vie RAM".
      3. Mot de passe : Mot de passe de l'utilisateur correspondant à l'administrateur de la zone de projet "Cycles de vie RAM".
      4. Délai d'attente : Délai d'attente, en secondes, utilisé pour permettre à Rational Asset Manager de se connecter à Rational Team Concert. La valeur par défaut est 120.
  41. Facultatif : Mettez à jour l'application Eclipse Rational Asset Manager en procédant comme vous l'avez fait pour l'installer. Pour plus d'informations sur l'installation du client Eclipse, voir Installer le client Eclipse de Rational Asset Manager.
    Remarque : Avant d'installer la dernière version du client Eclipse Rational Asset Manager, désinstallez le plug-in du client Eclipse Rational Asset Manager.

    Si vous avez installé les plug-ins du client Eclipse de Rational Asset Manager à l'aide du gestionnaire Eclipse de mises à jour, avant d'installer la dernière version de Rational Asset Manager, utilisez le gestionnaire de configuration Eclipse pour supprimer toutes les fonctions qui portent le nom de Rational Asset Manager. Pour utiliser le gestionnaire de configuration Eclipse, dans Eclipse, cliquez sur Aide > Mises à jour de logiciel > Gérer la configuration.

Que faire ensuite

Pour Rational Asset Manager version 7.5.1 ou postérieure, l'URL du serveur Rational Team Concert interne est passée de https://hôte:port/jazz à https://hôte:port/ramjazz. Si vous effectuez une mise à niveau à partir d'une version de Rational Asset Manager antérieure à la version 7.5.1, modifiez les références d'URL et indiquez à vos utilisateurs les modifications qu'ils doivent faire.

Mettez à jour les URL aux endroits suivants :
  • Les connexions de référentiel IDE Eclipse Rational Team Concert qui utilisent l'URL précédente. Pour mettre à jour une connexion de référentiel :
    1. Ouvrez la vue Artefacts d'équipe.
    2. Développez Connexions de référentiel.
    3. Cliquez avec le bouton droit sur la connexion Rational Asset Manager et sélectionnez Propriétés.
    4. Sélectionnez Connexion de référentiel Jazz.
    5. Dans la zone d'URI, remplacez l'URL par http://nom_hôte/ramjazz.
    6. Cliquez sur OK.
  • Les propriétés avancées du serveur Rational Team Concert qui utilisent l'URL précédente. Pour mettre à jour les propriétés avancées :
    1. Ouvrez Rational Asset Manager dans un navigateur Web en utilisant l'URL révisée : http://nom_hôte/ramjazz/admin.
    2. Connectez-vous en tant qu'administrateur.
    3. Cliquez sur Serveur > Configuration > Propriétés avancées.
    4. Mettez à jour les propriétés qui incluent l'URL précédente. Par exemple : com.ibm.ram.repository.service.internal.RepositoryRemoteService
  • Les liens Rational Asset Manager enregistrés dans les signets dans les navigateurs Web.

Vos commentaires