Mise à niveau vers les éditions de groupe de correctif de la version 3.0.1

Cette rubrique permet de mettre à niveau vos produits Rational solution for CLM existant vers la version 3.0.1.

Avant de commencer

Important :
  • Dans les exemples ci-dessous, 3.0.1 fait référence au répertoire dans lequel la version 3.0.1 est installée et 3.0.1.x fait référence au répertoire dans lequel la nouvelle version du groupe de correctifs 3.0.1 (3.0.1.1 ou une version ultérieure) du serveur est installée.
  • Tous les exemples concernent Linux. Vous devez procéder aux modifications qui s'imposent pour Windows ou d'autres systèmes d'exploitation.
  • Le processus de mise à niveau pour 3.0.1 vers le groupe de correctifs 3.0.1 utilise la base de données CLM existante existante. Les commandes addTables et createWarehouse vont mettre à jour ces bases de données aux formats 3.0.1.x.
  • Si vous avez installé toutes les applications Jazz sur le même serveur d'application, vous devez mettre à niveau toutes les applications vers le groupe de correctifs 3.0.1 en même temps. Si vous avez déployé chaque application dans un serveur d'application séparé, les applications doivent être mises à niveau indépendamment.
  • N'exécutez pas jts/setup. Tout est déjà configuré. Utilisez jts/admin pour afficher ou modifier la configuration.
  • Les instructions permettant d'utiliser le script d'enveloppe de mise à niveau et d'effectuer la mise à niveau manuelle sont fournies.

Mise à niveau vers la version 2

Pourquoi et quand exécuter cette tâche

Les instructions pour la mise à niveau de la version 2 vers le groupe de correctifs 3.0.1 sont identiques à la mise à niveau de la version 2 vers la 3.0.1. Pour plus d'informations, voir Mise à niveau vers la solution Rational pour CLM.

Mise à niveau à partir de la version 3.0.1 à l'aide de Tomcat

Procédure

  1. Installez CLM 3.0.1.x. N'exécutez pas la configuration. Pour les configurations réparties, installez l'application CLM 3.0.1 correspondant à l'application 3.0.1 que vous avez déjà installée.
    Remarque : Vous devez toujours mettre Jazz Team Server à niveau en premier.
  2. Arrêtez le serveur 3.0.1.
  3. Si vous utilisez Derby, faites passer Derby DB de 3.0.1 à 3.0.1.x :
    cp -R <3.0.1_install_dir>/server/conf/jts/derby/repositoryDB  <3.0.1.x_install_dir>/server/conf/jts/derby
    cp -R <3.0.1_install_dir>/server/conf/ccm/derby/repositoryDB  <3.0.1.x_install_dir>/server/conf/ccm/derby
    cp -R <3.0.1_install_dir>/server/conf/qm/derby/repositoryDB  <3.0.1.x_install_dir>/server/conf/qm/derby
  4. Si vous utilisez DB2, Oracle, ou SQL Server, mettez à jour la base de données.
  5. Si vous utilisez les scripts enveloppe de mise à niveau, passez directement à l'étape 11
  6. Conservez vos fichiers de registre utilisateur 3.0.1.
    1. Si vous utilisez le registre d'utilisateur Tomcat, conservez vos fichiers 3.0.1 tomcat-users.xml et server.xml :
      cp <3.0.1_install_dir>/server/tomcat/conf/tomcat-users.xml  <3.0.1.x_install_dir>/server/tomcat/conf/tomcat-users.xml
      cp <3.0.1_install_dir>/server/tomcat/conf/server.xml <3.0.1.x_install_dir>/server/tomcat/conf/server.xml
    2. Si vous utilisez un registre d'utilisateur LDAP, conserver vos fichiers 3.0.1 server.xml et web.xml files sur les serveurs d'application appropriés :
      cp <3.0.1_install_dir>/server/tomcat/conf/server.xml <3.0.1.x_install_dir>/server/tomcat/conf/server.xml
      cp <3.0.1_install_dir>/server/tomcat/webapps/admin/WEB-INF/web.xml <3.0.1.x_install_dir>/server/tomcat/webapps/admin/WEB-INF/web.xml
      cp <3.0.1_install_dir>/server/tomcat/webapps/jts/WEB-INF/web.xml <3.0.1.x_install_dir>/server/tomcat/webapps/jts/WEB-INF/web.xml
      cp <3.0.1_install_dir>/server/tomcat/webapps/ccm/WEB-INF/web.xml <3.0.1.x_install_dir>/server/tomcat/webapps/ccm/WEB-INF/web.xml
      cp <3.0.1_install_dir>/server/tomcat/webapps/qm/WEB-INF/web.xml <3.0.1.x_install_dir>/server/tomcat/webapps/qm/WEB-INF/web.xml
      cp <3.0.1_install_dir>/server/tomcat/webapps/rm/WEB-INF/web.xml <3.0.1.x_install_dir>/server/tomcat/webapps/rm/WEB-INF/web.xml
  7. `Copiez vos index JFS/text de 3.0.1 vers 3.0.1.x. (Pour les systèmes répartis, accédez au serveur approprié pour copier les fichiers.)
    cp -R <3.0.1_install_dir>/server/conf/jts/indices <3.0.1.x_install_dir>/server/conf/jts
    cp -R <3.0.1_install_dir>/server/conf/ccm/indices <3.0.1.x_install_dir>/server/conf/ccm
    cp -R <3.0.1_install_dir>/server/conf/qm/indices <3.0.1.x_install_dir>/server/conf/qm
  8. Copiez vos fichiers de configuration d'application de 3.0.1 vers 3.0.1.x. (Pour les systèmes répartis, accédez au serveur approprié pour copier les fichiers.)
    cp <3.0.1_install_dir>/server/conf/jts/teamserver*.properties  <3.0.1.x_install_dir>/server/conf/jts
    cp <3.0.1_install_dir>/server/conf/ccm/teamserver*.properties  <3.0.1.x_install_dir>/server/conf/ccm
    cp <3.0.1_install_dir>/server/conf/qm/teamserver*.properties  <3.0.1.x_install_dir>/server/conf/qm
    cp <3.0.1_install_dir>/server/conf/admin/admin.properties*  <3.0.1.x_install_dir>/server/conf/admin
    cp <3.0.1_install_dir>/server/conf/admin/friends.rdf*  <3.0.1.x_install_dir>/server/conf/admin
    cp <3.0.1_install_dir>/server/conf/rm/fronting.properties  <3.0.1.x_install_dir>/server/conf/rm
    cp <3.0.1_install_dir>/server/conf/rm/friendsconfig.rdf  <3.0.1.x_install_dir>/server/conf/rm
  9. Exécutez la commande repotools -addTables pour vérifier que la base de données comporte les tables correctes. (Pour les systèmes réparties, accédez au serveur approprié et exécutez la commande repotools.)
    cd <3.0.1.x_install_dir>/server
    ./repotools-jts.sh -addTables noPrompt
    ./repotools-ccm.sh -addTables noPrompt
    ./repotools-qm.sh -addTables noPrompt
  10. Si vous avec un entrepôt de données configuré, exécutez la commande repotools-jts -createWarehouse pour mettre à jour le schéma d'entrepôt de données vers 3.0.1.x.
    cd <3.0.1.x_install_dir>/server
    ./reportools-jts.sh -createWarehouse
  11. `Si vous utilisez des scripts enveloppe de mise à niveau, accédez au répertoire <3.0.1.x_install_dir>/server.
    upgrade/jts_upgrade.sh -oldJTSHome <3.0.1_install_dir>/server/conf
    upgrade/ccm_upgrade.sh -oldApplicationHome <3.0.1_install_dir>/server/conf
    upgrade/qm_upgrade.sh -oldApplicationHome <3.0.1_install_dir>/server/conf
    upgrade/rm_upgrade.sh -oldApplicationHome <3.0.1_install_dir>/server/conf
  12. Démarrez les serveurs.
  13. Activez les licences 3.0.1.x au besoin. Par exemple, avec les éditions intermédiaires, vous devez activer les licences d'accès anticipé envoyées avec l'édition intermédiaire. Pour la version 3.0.1.x finale, vous pouvez continuer d'utiliser vos licences 3.0.1.
    1. Connectez-vous en tant qu'administrateur à 3.0.1.x Jazz Team Server.
    2. Accédez à la page Server Administration > License Key Management et activez les licences.
    Remarque : Vous n'avez pas besoin d'exécuter la configuration sur le système 3.0.1.x car tout est déjà configuré.

Mise à niveau de la version 3.0.1 à l'aide de WebSphere Application Server

Procédure

Remarque : Si votre environnement n'accepte pas de convertisseur, par exemple AIX ou Solaris, vous devez installer la version 3.0.1.x du fichier converter.war sur le convertisseur dédié. Pour obtenir des informations détaillées, voir Rational Requirements Composer converter application installation.

  1. Installez CLM 3.0.1.x. N'exécutez pas la configuration. Pour les configurations réparties, installez l'application CLM 3.0.1 correspondant à l'application 3.0.1 que vous avez déjà installée.
    Remarque : Vous devez toujours mettre Jazz Team Server à niveau en premier.
  2. Sauvegardez le profil WebSphere Application Server.
    1. Ouvrez une invite de commande sur le répertoire <WAS_Install>/bin. Par exemple, /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/bin.
    2. Exécutez la commande suivante :
      ./backupConfig <path to a new compressed file to create back up of profile> (for example ./backupConfig /root/was_backups/clm_301_profile.zip)
      Remarque : Le profil sauvegardé peut être restauré au besoin en exécutant la commande ./restoreConfig. Par exemple, ./restoreConfig /root/was_backups/clm_301_profile.zip.
  3. Désinstallez les applications 3.0.1 de WebSphere Application Server.
    1. Connectez-vous à la console WebSphere Application Server Integrated Solutions à l'adresse https://<host name>:9043/ibm/console/logon.jsp.
    2. Cliquez sur Applications > Types d'application > Applications d'entreprise WebSphere.
    3. Ecrivez la correspondance des rôles de sécurité des applications jts_war, ccm_war et qm_war 3.0.1 pour faciliter le rétablissement de la mise en correspondance pour les équivalents 3.0.1.x à l'étape 16
    4. Arrêtez et désinstallez les applications 3.0.1 suivantes : jts_war, admin_war, ccm_war, qm_war, rm_war, clmhelp_war, converter_war.
    5. Sauvegardez les modifications apportées à la configuration maître lorsque vous y êtes invité.
  4. Mettez à jour les propriétés personnalisées de JAZZ_HOME et log4j.configuration.
    1. Connectez-vous à la console WebSphere Application Server Integrated Solutions à l'adresse https://<host name>:9043/ibm/console/logon.jsp.
    2. Cliquez sur Serveurs > Types de serveurs > Serveurs d'applications WebSphere.
    3. Cliquez sur le nom du serveur pour l'ouvrir. Le nom du serveur par défaut est server1.
    4. Sous la section Infrastructure du serveur, cliquez sur Gestion des processus et Java > Gestion des processus.
    5. Sous Propriétés supplémentaires, cliquez sur Machine virtuelle Java.
    6. Sous Propriétés supplémentaires, cliquez sur Alias d'hôte.
    7. Cliquez sur JAZZ_HOME et mettez à jour sa valeur dans le fichier :///<3.0.1.x_install_dir>/server/conf. Par exemple, file:///opt/IBM/JazzTeamServer_3.0.1.x/server/conf.
    8. Cliquez sur log4j.configuration et mettez à jour sa valeur dans le fichier :///<3.0.1.x_install_dir>/server/conf/startup_log4j.properties. Par exemple, file:///opt/IBM/JazzTeamServer_3.0.1.x/server/conf/log4j.properties.
    9. Si vous vous connectez à la base de données Oracle ou SQL Server, vérifiez que ORACLE_JDBC_DRIVER_FILE ou SQLSERVER_JDBC_DRIVER_FILE pointe vers le fichier pilote JDBC correct.
    10. Sauvegardez les modifications apportées à la configuration maître lorsque vous y êtes invité.
      Remarque : Pour plus d'informations, voir Configuration de WebSphere Application Server.
  5. Arrêtez WebSphere Application Server.
  6. Supprimez le contenu associé à CLM des répertoires wstemp et temp dans le profil. Selon les applications précédemment installées, les répertoires suivants sont présents sous le profil et peuvent être supprimés : jts_war, admin_war, ccm_war, qm_war, rm_war, clmhelp_war, converter_war.
    <profile directory>/wstemp (for example /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/wstemp)
    <profile directory>/temp (for example /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/temp)
  7. Supprimez les journaux concernant CLM du répertoire des journaux dans le profil.
    <profile directory>/logs (for example /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs)
  8. Préparez les bases de données pour les applications CLM 3.0.1.x
    1. Si vous utilisez Derby, faites passer Derby DB de 3.0.1 à 3.0.1.x :
      cp -R <3.0.1_install_dir>/server/conf/jts/derby/repositoryDB  <3.0.1.x_install_dir>/server/conf/jts/derby
      cp -R <3.0.1_install_dir>/server/conf/ccm/derby/repositoryDB  <3.0.1.x_install_dir>/server/conf/ccm/derby
      cp -R <3.0.1_install_dir>/server/conf/qm/derby/repositoryDB  <3.0.1.x_install_dir>/server/conf/qm/derby
    2. Si vous utilisez DB2, Oracle, ou SQL Server, mettez à jour la base de données.
  9. Si vous utilisez les scripts enveloppe de mise à niveau, passez directement à l'étape 14
  10. `Copiez vos index JFS/text de 3.0.1 vers 3.0.1.x. (Pour les systèmes répartis, accédez au serveur approprié pour copier les fichiers.)
    cp -R <3.0.1_install_dir>/server/conf/jts/indices <3.0.1.x_install_dir>/server/conf/jts
    cp -R <3.0.1_install_dir>/server/conf/ccm/indices <3.0.1.x_install_dir>/server/conf/ccm
    cp -R <3.0.1_install_dir>/server/conf/qm/indices <3.0.1.x_install_dir>/server/conf/qm
  11. Copiez vos fichiers de configuration d'application de 3.0.1 vers 3.0.1.1. (Pour les systèmes réparties, accédez au serveur approprié pour copier les fichiers.)
    cp <3.0.1_install_dir>/server/conf/jts/teamserver*.properties  <3.0.1.x_install_dir>/server/conf/jts
    cp <3.0.1_install_dir>/server/conf/ccm/teamserver*.properties  <3.0.1.x_install_dir>/server/conf/ccm
    cp <3.0.1_install_dir>/server/conf/qm/teamserver*.properties  <3.0.1.x_install_dir>/server/conf/qm
    cp <3.0.1_install_dir>/server/conf/admin/admin.properties*  <3.0.1.x_install_dir>/server/conf/admin
    cp <3.0.1_install_dir>/server/conf/admin/friends.rdf*  <3.0.1.x_install_dir>/server/conf/admin
    cp <3.0.1_install_dir>/server/conf/rm/fronting.properties  <3.0.1.x_install_dir>/server/conf/rm
    cp <3.0.1_install_dir>/server/conf/rm/friendsconfig.rdf  <3.0.1.x_install_dir>/server/conf/rm
  12. Exécutez la commande repotools -addTables pour vérifier que la base de données comporte les tables correctes. (Pour les systèmes réparties, accédez au serveur approprié et exécutez la commande repotools.)
    cd <3.0.1.x_install_dir>/server
    ./repotools-jts.sh -addTables noPrompt
    ./repotools-ccm.sh -addTables noPrompt
    ./repotools-qm.sh -addTables noPrompt
  13. Si vous avec un entrepôt de données configuré, exécutez la commande repotools-jts -createWarehouse pour mettre à jour le schéma d'entrepôt de données vers 3.0.1.x.
    cd <3.0.1.x_install_dir>/server
    ./reportools-jts.sh -createWarehouse
  14. `Si vous utilisez des scripts enveloppe de mise à niveau, accédez au répertoire <3.0.1.x_install_dir>/server.
    upgrade/jts_upgrade.sh -oldJTSHome <3.0.1_install_dir>/server/conf
    upgrade/ccm_upgrade.sh -oldApplicationHome <3.0.1_install_dir>/server/conf
    upgrade/qm_upgrade.sh -oldApplicationHome <3.0.1_install_dir>/server/conf)
    upgrade/rm_upgrade.sh -oldApplicationHome <3.0.1_install_dir>/server/conf
  15. Démarrez WebSphere Application Server.
  16. Déployez les fichiers war 3.0.1.x dans WebSphere Application Server.
    1. Connectez-vous à la console WebSphere Application Server Integrated Solutions à l'adresse https://<host name>:9043/ibm/console/logon.jsp.
    2. Cliquez sur Applications > Types d'application > Applications d'entreprise WebSphere.
    3. Installez les fichiers jts_war, admin_war, ccm_war, qm_war, rm_war, clmhelp_war, converter_war .
    4. Mappez les rôles de sécurité conformément pour les applications suivantes : jts_war, ccm_war, qm_war.
      Remarque : Pour plus d'informations, voir Déploiement d'applications CLM sur WebSphere Application Server.
  17. Une fois dans la page des applications d'entreprise, démarrez les applications suivantes : jts_war, admin_war, ccm_war, qm_war, rm_war, clmhelp_war, converter_war.
  18. Réinitialisez le serveur pour JTS, CCM et QM :
    https://jts_server.mydomain.com:9443/jts/admin#action=com.ibm.team.repository.admin.serverReset
    https://ccm_server.mydomain.com:9443/ccm/admin#action=com.ibm.team.repository.admin.serverReset
    https://rqm_server.mydomain.com:9443/qm/admin#action=com.ibm.team.repository.admin.serverReset
    Remarque : Vous devez redémarrer les serveurs pour que la réinitialisation du serveur soit effective.
  19. Activez les licences 3.0.1.x au besoin. Par exemple, avec les éditions intermédiaires, vous devez activer les licences d'accès anticipé envoyées avec l'édition intermédiaire. Pour la version 3.0.1.x finale, vous pouvez continuer d'utiliser vos licences 3.0.1.
    1. Connectez-vous en tant qu'administrateur à 3.0.1.x Jazz Team Server.
    2. Accédez à la page Server Administration > License Key Management et activez les licences.
    Remarque : Vous n'avez pas besoin d'exécuter la configuration sur le système 3.0.1.x car tout est déjà configuré.
    Remarque : Pour obtenir les informations les plus à jour concernant le processus de mise à niveau, consultez CLM Upgrading Knowledge Collection.

Commentaires