Déployer les applications du serveur Rational Asset Manager sur Tomcat 5.5

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

Avant de commencer

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

Vous devez connaître l'emplacement des fichiers JDBC .jar suivants pour le serveur de la base de données :
  • Pour IBM DB2 :db2jcc_license_cu.jar et db2jcc.jar
  • Pour Oracle :ojdbc5.jar. Si vous utilisez Oracle 10, continuez à utiliser le fichier ojdbc5.jar pour Oracle 11. Vous pouvez télécharger les fichiers d'Oracle.
  • Pour Microsoft SQL Server :sqljdbc.jar. Vous pouvez télécharger les fichiers de Microsoft.

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.

Remarque : Si vous envisagez de déployer Rational Asset Manager et la version incluse de Rational Team Concert sur des applications différentes du serveur Tomcat au sein de la même machine, veillez à configurer les différents serveurs Tomcat avec des ports sécurisés et non sécurisés différents pour éviter les conflits. Pour plus d'informations sur les ports de Tomcat 5.5, voir la documentation Apache Tomcat.

Procédure

  1. Vérifiez que tous les serveurs de référentiels sont définis aux mêmes date, heure et fuseau horaire courants.
  2. Extrayez les fichiers 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/.
  3. Extrayez les fichiers de la bibliothèque partagée dans le dossier répertoire_installation_tomcat\shared\lib :
    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\shared\lib.
    3. Si vous installez Rational Team Concert sur un serveur Tomcat différent, copiez le contenu extrait du fichier sharedLib.zip dans le répertoire répertoire_installation_tomcat_pour_rtc\shared\lib pour l'autre serveur Tomcat.
  4. Pour Windows : Pour Linux :Pour AIX : 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.
    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 :
  5. Pour Windows : Pour Linux :Pour AIX : Modifiez le script de démarrage du serveur Tomcat pour Rational Asset Manager :
    Important : Si vous exécutez l'installation sur Linux for zSeries, ne suivez pas cette étape.
    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. Dans le fichier de démarrage, entrez le texte suivant :
      • Pour Windows :
        set JAVA_OPTS=-Djava.library.path="répertoire_installation_tomcat\shared\lib"
      • Pour Linux :Pour AIX :
        export JAVA_OPTS="-Djava.library.path=répertoire_installation_tomcat/shared/lib"
  6. 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
  7. Pour changer le chemin du contexte de l'application, renommez les fichiers d'application WAR. Utilisez les noms 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
  8. Configurez le serveur Tomcat pour permettre à Rational Asset Manager d'accéder à la base de données :
    1. Dans un éditeur de texte, ouvrez le fichier répertoire_installation_tomcat\conf\server.xml.
    2. Dans server.xml, retrouvez toutes les lignes commençant par <Connector et contenant port="8080" ou port="8009". Changez le début de ces lignes pour <Connector URIEncoding="UTF-8".
    3. Entre les balises d'ouverture et de fermeture des ressources JNDI globales, <GlobalNamingResources> et </GlobalNamingResources>, entrez le texte suivant pour votre version de Tomcat.
      Remarque : Pour les valeurs votre_nom_d'utilisateur et votre_mot_de_passe, indiquez une combinaison ID utilisateur/mot de passe ayant un accès administrateur complet à la base de données. Pour l'attribut "url", par exemple, peut être similaire à jdbc:db2://localhost:50000/RAMDB
    Entrez ce texte pour le serveur de base de données en remplaçant les variables suivantes :
    • Pour les attributs username et password, remplacez votre_nom_d'utilisateur et votre_mot_de_passe par un ID utilisateur et un mot de passe ayant un accès administrateur complet au serveur de base de données.
    • Pour l'attribut url, remplacez nom_serveur_base_de_données_complet et numéro_port_base_de_données par l'adresse et le numéro de port du serveur de la base de données et remplacez nom_base_de_données_Rational_Asset_Manager par le nom de la base de données des actifs. Par exemple, pour DB2, l'attribut url peut s'apparenter à jdbc:db2://localhost:50000/RAMDB.
    • Les valeurs indiquées pour les attributs maxWait, maxActive et maxIdle sont des valeurs fournies à titre d'exemple qui peuvent être adaptées en fonction de vos besoins de performances.
    • Pour IBM DB2 :
      <Resource name="jdbc/RAM_Con"
      type="javax.sql.DataSource"
      driverClassName="com.ibm.db2.jcc.DB2Driver"
      username="votre_nom_d'utilisateur"
      password="votre_mot_de_passe"
      url="jdbc:db2://nom_serveur_base_de_données_complet:numéro_port_base_de_données/nom_base_de_données_Rational_Asset_Manager"
      poolPreparedStatements="true"
      maxWait="5000"
      maxActive="4"
      maxIdle="2"/>
    • Pour Oracle :
      <Resource name="jdbc/RAM_Con"
      type="javax.sql.DataSource"
      driverClassName="oracle.jdbc.driver.OracleDriver"
      username="votre_nom_d'utilisateur"
      password="votre_mot_de_passe"
      url="jdbc:oracle:thin:@nom_serveur_base_de_données_complet:numéro_port_base_de_données:nom_base_de_données_Rational_Asset_Manager"
      poolPreparedStatements="true"
      maxWait="5000"
      maxActive="4"
      maxIdle="2"/>
    • Pour Microsoft SQL Server :
      <Resource name="jdbc/RAM_Con"
      type="javax.sql.DataSource"
      driverClassName="com.microsoft.jdbc.sqlserver.SQLServerDriver"
      username="votre_nom_d'utilisateur"
      password="votre_mot_de_passe"
      url="jdbc:microsoft:sqlserver://nom_serveur_base_de_données_complet:numéro_port_base_de_données:nom_base_de_données_Rational_Asset_Manager"
      poolPreparedStatements="true"
      maxWait="5000"
      maxActive="4"
      maxIdle="2"/>
  9. 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" />
  10. Copiez les fichiers JAR suivants dans le dossier répertoire_installation_tomcat\common\lib :
    • Pour IBM DB2 :
      • db2jcc_license_cu.jar
      • db2jcc.jar
    • Pour Oracle :
      • ojdbc5.jar (vous pouvez télécharger ce fichier d'Oracle. Si vous utilisez Oracle 10, téléchargez un package pour Oracle 11 et recherchez le fichier ojdbc5.jar.)
    • Pour Microsoft SQL Server :
      • sqljdbc.jar (vous pouvez télécharger ce fichier de Microsoft.)
    Ces fichiers sont disponibles à partir du fournisseur de base de données, généralement dans le dossier /java/ de l'installation de la base de données.
  11. 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.
    1. Dans un éditeur de texte, ouvrez le fichier répertoire_installation_tomcat\conf\tomcat-users.xml.
    2. Ajoutez un utilisateur nommé admin et affectez à cet utilisateur les rôles admin et manager. Pour ajouter cet utilisateur, vous pouvez copier et coller le texte suivant entre les balises <tomcat-users> :
      <user username="admin" password="" roles="admin,manager" />

      L'utilisateur doit être nommé admin.

  12. En fonction de votre configuration, déployez ou configurez Rational Team Concert.

Vos commentaires