IBM® Rational Asset Manager requiert IBM Rational Team Concert,
qui contrôle les fonctions de cycle de vie disponibles pour gérer le développement d'actifs. Si vous n'avez pas encore Rational Team Concert,
une version limitée du produit est incluse. Elle peut être déployée sur un serveur Tomcat.
Avant de commencer
Si vous avez déjà déployé et configuré une application du serveur Rational Team Concert, vous pouvez l'utiliser au lieu d'installer une nouvelle application. Si vous souhaitez configurer Rational Team Concert pour l'utiliser avec Rational Asset Manager,
voir Configurer un serveur Rational Team Concert pour l'utiliser avec Rational Asset Manager.
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.
Pourquoi et quand exécuter cette tâche
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.
Procédure
- Vérifiez que tous les serveurs de référentiels sont définis aux mêmes date, heure et fuseau horaire courants.
- 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/.

Extrayez les fichiers de bibliothèque de Rational
Licensing Key Server V8.1.2 dans
le dossier répertoire_installation_tomcat_pour_rtc\shared\lib :
Important : Ne suivez pas cette étape sous Linux for zSeries
- 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 le contenu extrait du fichier rlsibmratl812.zip dans le répertoire répertoire_installation_tomcat_pour_rtc\shared\lib.
Si vous installez Rational Asset Manager et Rational Team Concert sur le même serveur d'applications, vous avez déjà effectué cette étape.
- 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.
- 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 le serveur Tomcat pour la sécurité utilisateur. Si vous prévoyez d'utiliser la sécurité LDAP, utilisez d'abord la sécurité basée sur les fichiers pour configurer les applications et passez à l'authentification LDAP après avoir configuré les applications : Pour
plus d'informations, voir Configurer l'authentification LDAP pour Tomcat.
- Dans un éditeur de texte, ouvrez le fichier répertoire_installation_tomcat_pour_rtc\conf\tomcat-users.xml. Si vous installez les applications sur le même serveur Tomcat, ce fichier est le même que celui dans lequel vous avez modifié les paramètres de sécurité de l'utilisateur pour les applications Rational Asset Manager.
- 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'utilisateur créé lorsque vous avez modifié les paramètres de sécurité de l'utilisateur pour les applications Rational Asset Manager.
- 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
- Configurez Rational Team Concert pour l'utiliser avec Rational Asset Manager.
Vous devez configurer des droits d'administration et créer une zone de projet dans Rational Team Concert.