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 : Si vous effectuez une mise à niveau à partir de Rational Asset Manager,
Version 7.1.1.1 ou précédente, 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 :
- Préparez la mise à niveau et sauvegarder les fichiers et les bases de données importants : étapes 1–4.
- Récupérez les fichiers d'application pour la dernière version de Rational
Asset Manager : étape 5.
- Si vous faites une mise à niveau depuis V7.1.1.1 ou antérieure, créez une autre base de données : étape 6.
- Arrêtez le serveur Tomcat : étape 7.
- Mettez à niveau votre serveur de licences
vers Rational Common Licensing 8.1.2 : étape 8.
- 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 9–11.
- Configurez le serveur Tomcat pour la connexion unique : étape 12.
- Récupérez les fichiers d'application en cours pour l'instance Rational
Team Concert incluse : étapes 13–14.
- 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 17–24.
- Si vous faites une mise à niveau depuis V7.1.1.1 ou antérieure, configurez Rational
Team Concert : étapes25–31.
- Si vous faites une mise à niveau depuis V7.2 ou ultérieure, mettez à niveau l'instance
Rational Team Concert incluse : étape 33.
- Supprimez les fichiers d'application existants pour Rational Asset Manager
et installez les nouvelles versions des applications : étapes 34–39.
- Connectez-vous à Rational Asset Manager et migrez le référentiel : étape 40.
- 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 42.
- Modifiez vos paramètres pour vous connecter à votre nouveau serveur Rational Common Licensing : étape 43.
- Mettez à niveau tous les clients Eclipse : étape 44.
Procédure
- 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.
- 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 ) puis, une fois le serveur mis à jour, appliquez à nouveau le thème et les messages. Pour
plus d'informations, voir Migration du thème.
- Vérifiez que tous les serveurs de référentiels sont définis aux mêmes date, heure et fuseau horaire courants.
- Si vous utilisez Rational Asset Manager,
version 7.0.0.2 ou antérieure, vérifiez que le serveur de travaux est activé.
Pour activer le serveur de travaux :
- Connectez-vous au client
Web de Rational Asset Manager en tant qu'administrateur de référentiels.
- Cliquez sur Administration.
- Cliquez sur Outils dans la barre latérale Administration du référentiel.
- Dans la barre d'adresses du navigateur, remplacez tools.faces par advancedConfiguration.faces et accédez à cette adresse. Par exemple, http://example.com:9080/com.ibm.ram.repository.web/admin/repository/advancedConfiguration.faces
- Sur la page Paramètres avancés, dans la section Options des travaux,
sélectionnez Enable job server.
- Cliquez sur Sauvegarder.
- Redémarrez le serveur d'applications.
- 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/.
- 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 :
- 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.


Migrez Rational Licensing Server vers Rational Common Licensing V8.1.2 ou une version 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 centre de téléchargement Rational.
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, voirConfiguration 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.
- Extrayez les fichiers de bibliothèque partagée dans le dossier \shared\lib des serveurs Tomcat :
- Recherchez et extrayez le fichier emplacement_extraction_archive\apps\tomcat\sharedLib.zip.
- Copiez l'intégralité du contenu du fichier sharedLib.zip extrait dans le répertoire répertoire_installation_tomcat\shared\lib.

Extrayez les fichiers de bibliothèque de Rational
Licensing Key Server V8.1.2 dans
le dossier répertoire_installation_tomcat\shared\lib :
Important : Si vous exécutez l'installation sur Linux for zSeries, ne suivez pas cette étape.
- Recherchez et extrayez le fichier emplacement_extraction_archive\sharedLibs\rlsclients_rlsibmratl_812.zip.
- 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.
- Extrayez le contenu du fichier rlsibmratl812.zip approprié.
- Copiez la totalité du contenu du fichier rlsibmratl812.zip extrait
dans le répertoire répertoire_installation_tomcat\shared\lib :


Modifiez le script de démarrage du serveur
Tomcat pour Rational Asset Manager- 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.
- 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 :
- Si la variable d'environnement JAVA_OPTS n'est pas définie, entrez le texte suivant :
- Configurez le serveur Tomcat afin que la fonction SSO soit utilisée pour toutes les applications :
- Dans un éditeur de texte, ouvrez le fichier répertoire_installation_tomcat\conf\server.xml.
- Recherchez le texte suivant :
<!--
<Valve className="org.apache.catalina.authenticator.SingleSignOn" />
-->
- Supprimez la mise en commentaire de l'élément <Valve> :
<Valve className="org.apache.catalina.authenticator.SingleSignOn" />
- Sur le support d'installation, recherchez le fichier emplacement_extraction_archive/apps/tomcat/RTC-server.zip.
- Extrayez le fichier RTC-server.zip dans un emplacement de l'unité de disque dur, appelé rép_installation_rtc dans ces instructions.
- 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 16.
- Si vous mettez à niveau la version 7.2 ou suivante :
Mettez à jour la version incluse de Rational Team Concert.
Passez
à l'étape 33.
- 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 17.
- Si vous disposez d'une application Rational Team Concert existante et que vous souhaitez la configurer pour Rational Asset Manager :
Passez à l'étape 25.
- Recherchez le fichier rép_installation_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/.
- Configurez un port sécurisé sur votre serveur Tomcat pour Rational Team Concert :
- 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_installation_rtc/jazz/server/ ;
le fichier de certificat est ibm-team-ssl.keystore
- 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.
- 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_installation_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.
- 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 5.5 SSL Configuration HOW-TO et Apache Tomcat Configuration reference.

Copiez le fichier .jar approprié du fournisseur de base de données :
- Configurez les paramètres de la propriété de démarrage Tomcat :
- 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.
- Dans le fichier de démarrage, entrez le texte suivant :
Remplacez chaque espace dans rép_installation_rtc par %20 :set ORACLE_JDBC=oracle_jar_dir
set SQLSERVER_JDBC=sqlServer_jar_dir
set JAZZ_INSTALL_DIR=rép_installation_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



ORACLE_JDBC=oracle_jar_dir
SQLSERVER_JDBC=sqlServer_jar_dir
JAZZ_INSTALL_DIR=rép_installation_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"
- Recherchez et renommez le fichier de propriétés du serveur Jazz approprié :
- Dans le répertoire rép_installation_rtc/jazz/server/conf/ramjazz/,
recherchez le fichier teamserver.properties et renommez-le en
teamserver.derby.properties.
- Recherchez le fichier approprié à votre serveur de base de données :

Pour DB2 sous Windows : teamserver.db2.win32.properties



Pour DB2 sous Linux, AIX ou Linux for
zSeries : teamserver.db2.linux.properties
teamserver.oracle.properties
teamserver.sqlserver.properties
- Renommez le fichier en teamserver.properties.
- 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) :

- 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
- 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 :
- 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.
- Remplacez JAZZ par le nom de la base de données des cycles de vie.
- 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.
- 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.
- 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é

- 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
- 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 :
- Remplacez jazzDBUser par le nom d'utilisateur de la base de données
Oracle (par exemple, RAMSCHEMA.
- 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.
- Remplacez ORCL par le nom de la base de données des cycles de vie ; par exemple, rtcdb.
- 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.
- 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é
- Si vous utilisez Oracle 11 : dans le fichier teamserver.properties, ajoutez la propriété suivante :
com.ibm.team.repository.db.override.versioncheck=true

- 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
- 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 :
- Replacez @localhost:1433 par l'emplacement et le port pour la base de données SQL Server.
- Replace jazz par le nom de la base de données des cycles de vie ; par exemple RTCDB.
- Remplacez jazzDBUser par le nom d'utilisateur pour la base de données SQL Server.
- 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.
- 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é
- Créez
les tables pour Rational Team Concert :
- Ouvrez la fenêtre de ligne de commande et accédez au répertoire rép_installation_rtc/jazz/server/.
- Entrez la commande suivante :
- Configurez l'autorisation utilisateur pour l'application Rational Team Concert incluse.
- Pour la sécurité fondée sur les fichiers :
- Dans un éditeur de texte, ouvrez le fichier répertoire_installation_tomcat_pour_rtc\conf\tomcat-users.xml.
- Entre les balises <tomcat-users>, collez le texte suivant :
<role rolename="JazzUsers"/>
<role rolename="JazzAdmins"/>
<role rolename="JazzDWAdmins"/>
<role rolename="JazzGuests"/>
- 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 2–3 dans la rubrique Configurer Rational Team Concert sur Tomcat pour utiliser LDAP.
- Démarrez le serveur Tomcat pour Rational Team Concert.
Pour démarrer Tomcat, exécutez le fichier suivant :
répertoire_installation_tomcat_pour_rtc\bin\startup.bat


répertoire_installation_tomcat_pour_rtc/bin/startup.sh
- 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.
- 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.
- Si vous utilisez une nouvelle installation de Rational Team Concert : Configurez l'administrateur de Rational Team Concert :
- 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.
- 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.
- Cliquez sur Créer l'utilisateur.
- Entrez les détails suivants :
- Nom d'utilisateur : ID utilisateur de l'administrateur du serveur d'applications
- ID utilisateur : ID utilisateur de l'administrateur du serveur d'applications
- Adresse électronique : adresse électronique valide pour l'administrateur du serveur d'applications.
- Dans la section Licence Accès client, sélectionnez Rational Team Concert - Développeur de logiciel pour attribuer la licence développeur à cet utilisateur.
- Cliquez sur Enregistrer.
- Déconnectez-vous, puis reconnectez-vous à l'interface d'administration Web en tant qu'administrateur du serveur d'applications.
- Importez le modèle de processus de cycles de vie dans Rational Team Concert :
- 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.
- 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é.
- Créez une zone de projet dans Rational Team Concert :
- 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.
- Cliquez sur Créer une zone de projet.
- 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
- Cliquez sur Enregistrer.
- Attribuez les appartenances et rôles de processus pour la zone de projet :
- Sur la page Gestion de zone de projet, cliquez sur la zone de projet Cycle de vie RAM.
- 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.
- Dans la section Membres, cliquez sur Ajouter ; Recherchez et sélectionnez le même utilisateur en tant qu'administrateur pour la zone de projet.
- Après avoir ajouté l'administrateur, cliquez sur l'icône Rôles de processus situé après le nom de l'administrateur.
- Dans la liste Rôles disponibles de la fenêtre Editer des rôles de processus, sélectionnez Administration, puis cliquez sur Ajouter.
- Cliquez sur Terminer.
- Cliquez sur Enregistrer.
- Si vous mettez à niveau la version 7.1.1.1 ou suivante : Passez
à l'étape 34.
- Si vous mettez à niveau la version 7.2 ou suivante ,
mettez à niveau l'application Rational Team Concert incluse :
- 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_installation_rtc dans les instructions.
- A partir du dossier rép_installation_rtc/jazz/server/conf/jazz/ antérieur,
copiez le fichier teamserver.properties dans le nouveau dossier nouveau_rép_installation_rtc/jazz/server/conf/jazz/.
Vous pouvez rechercher l'emplacement existant rép_installation_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.
- 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.
- 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_installation_rtc correspond au répertoire extrait à l'étape 33.a :
- Démarrez le serveur Tomcat.
- 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.
- Connectez-vous en tant qu'administrateur du serveur d'applications.
- Dans la barre d'outils latérale, sous la section Internal Tools, cliquez sur Server
reset.
- Cliquez sur Request server reset.
- Arrêtez, puis redémarrez le serveur Tomcat. L'application Rational Team Concert incluse est mise à jour.
- Arrêtez le serveur Tomcat pour Rational Asset Manager.
- Supprimez les anciens fichiers de l'application Web .war de Rational Asset Manager installés sur Tomcat :
- Accédez au répertoire répertoire_installation_tomcat/webapps/.
- 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/
- 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.
- Supprimez les dossiers associés pour ces applications.
- 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
- 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 |
- Videz le cache du serveur Tomcat. Supprimez le répertoire répertoire_installation_tomcat/work/.
- Redémarrez le serveur Tomcat pour Rational Asset Manager.
- Faites migrer le référentiel Rational Asset Manager vers la nouvelle version :
- 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.
- 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.
- 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é.
- Une fois la migration effectuée, cliquez sur Accueil.
- Une fois le référentiel migré, arrêtez et redémarrez le serveur d'applications.
- 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 :
- Sur le client Web de Rational Asset Manager, cliquez sur Administration.
- Cliquez sur Configuration.
- Dans la section Chemin interne de Rational Team Concert, entrez les informations suivantes :
- Chemin : Adresse URL sécurisée du serveur Rational Team Concert que vous avez configuré. Par exemple, https://localhost:9443/ramjazz.
Notez la connexion https sécurisée et le numéro de port sécurisé.
- Utilisateur : Nom d'utilisateur dans Rational Team Concert correspondant à l'administrateur de la zone de projet "Cycles de vie RAM".
- Mot de passe : Mot de passe de l'utilisateur correspondant à l'administrateur de la zone de projet "Cycles de vie RAM".
- 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.
- Pour une mise à niveau, vous devez enregistrer une demande de nouvelle clé de licences. Vous devez acquérir une nouvelle licence serveur et de nouvelles licences nominatives.
Accédez à Rational License
Key Center : http://www-01.ibm.com/software/rational/support/licensing/ Si vous constatez une erreur concernant Rational License
Server, ajustez la configuration de votre licence :
- Cliquez sur Administration.
- Sur la page Administration, cliquez sur Configuration.
- Dans la section Licence et version, pour choisir le type de licence serveur que ce référentiel utilisera, sélectionnez Edition standard ou Edition d'entreprise.
- En bas de la page, cliquez sur Sauvegarder.
- Il est possible que l'erreur du serveur de licences apparaisse encore.
Cliquez sur Retry connection to license server.
- 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 utilisé Installation Manager pour installer le client
Eclipse de Rational Asset Manager V7.0.0.2
dans une application Eclipse v3.3 existante,
utilisez également Installation Manager pour le désinstaller.
Il est impossible d'utiliser le gestionnaire de configuration Eclipse pour désinstaller Rational Asset Manager du
client Eclipse.
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 .