Upgrade auf Version 3.0.1 Fixpack-Releases

In diesem Thema finden Sie Informationen zum Upgrade Ihrer vorhandenen Rational-Lösung für CLM-Produkte auf Version 3.0.1 Fixpack-Releases.

Vorbereitende Schritte

Wichtig:
  • In den unten genannten Beispielen bezieht sich 3.0.1 auf das Verzeichnis, in dem die Serverversion 3.0.1 installiert ist, und 3.0.1.x bezieht sich auf das Verzeichnis, in dem das Fixpack der neuen Version 3.0.1 (3.0.1.1 oder höher) des Servers installiert ist.
  • Alle Beispiele betreffen Linux. Sie müssen für Windows oder andere Betriebssysteme entsprechend angepasst werden.
  • Der Aktualisierungsprozess für 3.0.1 auf das 3.0.1 Fixpack-Release verwendet die vorhandene CLM-Datenbank. Die Befehle addTables und createWarehouse aktualisieren diese Datenbanken auf die 3.0.1.x Formate.
  • Wenn alle Jazz-Anwendungen auf dem gleichen Anwendungsserver installiert wurden, dann müssen alle Anwendungen gleichzeitig auf das Fixpack 3.0.1 aufgerüstet werden. Wenn Sie jede Anwendung auf einem eigenen Anwendungsserver implementiert haben, können die Anwendungen unabhängig voneinander aufgerüstet werden.
  • Führen Sie nicht den Befehl jts/setup aus. Setup wird bereits ausgeführt. Verwenden Siejts/admin, um die Installation zu betrachten oder zu ändern.
  • Es werden sowohl die Anweisungen zur Verwendung des Upgrade-Wrapper-Scripts als auch zur manuellen Ausführung des Upgrades zur Verfügung gestellt.

Upgrade von Version 2

Informationen zu diesem Vorgang

Die Anweisungen für das Upgrade von Version 2 auf die V3.0.1 Fixpack-Releases sind die gleichen wie für das Upgrade von Version 2 auf 3.0.1. Ausführliche Informationen hierzu enthält der Artikel Upgrade auf die Rational-Lösung für CLM.

Upgrade von Version 3.0.1 mit Tomcat

Vorgehensweise

  1. Installieren Sie CLM 3.0.1.x. Führen Sie nicht den Befehl setup aus. Bei verteilten Konfigurationen müssen Sie die Anwendung CLM 3.0.1.x entsprechend zur bereits vorhandenen Anwendung 3.0.1 installieren.
    Anmerkung: Der Jazz Team Server muss immer zuerst aktualisiert werden.
  2. Stoppen Sie den Server der Version 3.0.1.
  3. Falls Derby eingesetzt wird, verschieben Sie die Derby-Datenbank von 3.0.1 auf 3.0.1.x:
    cp -R <3.0.1_installationsverzeichnis>/server/conf/jts/derby/repositoryDB  <3.0.1.x_installationsverzeichnis>/server/conf/jts/derby
    cp -R <3.0.1_installationsverzeichnis>/server/conf/ccm/derby/repositoryDB  <3.0.1.x_installationsverzeichnis>/server/conf/ccm/derby
    cp -R <3.0.1_installationsverzeichnis>/server/conf/qm/derby/repositoryDB  <3.0.1.x_installationsverzeichnis>/server/conf/qm/derby
  4. Wenn Sie DB2, Oracle, oder SQL Server einsetzen, sichern Sie die Datenbank.
  5. Bei Verwendung von Upgrade-Wrapper-Scripts springen Sie nun zum Schritt 11
  6. Schützen Sie Ihre Benutzerregistry-Dateien der Version 3.0.1.
    1. Falls die Tomcat-Benutzerregistry eingesetzt wird, schützen Sie die beiden Dateien der Version 3.0.1 tomcat-users.xml und server.xml:
      cp <3.0.1_installationsverzeichnis>/server/tomcat/conf/tomcat-users.xml  <3.0.1.x_installationsverzeichnis>/server/tomcat/conf/tomcat-users.xml
      cp <3.0.1_installationsverzeichnis>/server/tomcat/conf/server.xml <3.0.1.x_installationsverzeichnis>/server/tomcat/conf/server.xml
    2. Falls eine LDAP-Benutzerregistry eingesetzt wird, schützen Sie die beiden Dateien der Version 3.0.1 server.xml und web.xml auf den entsprechenden Anwendungsservern:
      cp <3.0.1_installationsverzeichnis>/server/tomcat/conf/server.xml <3.0.1.x_installationsverzeichnis>/server/tomcat/conf/server.xml
      cp <3.0.1_installationsverzeichnis>/server/tomcat/webapps/admin/WEB-INF/web.xml <3.0.1.x_installationsverzeichnis>/server/tomcat/webapps/admin/WEB-INF/web.xml
      cp <3.0.1_installationsverzeichnis>/server/tomcat/webapps/jts/WEB-INF/web.xml <3.0.1.x_installationsverzeichnis>/server/tomcat/webapps/jts/WEB-INF/web.xml
      cp <3.0.1_installationsverzeichnis>/server/tomcat/webapps/ccm/WEB-INF/web.xml <3.0.1.x_installationsverzeichnis>/server/tomcat/webapps/ccm/WEB-INF/web.xml
      cp <3.0.1_installationsverzeichnis>/server/tomcat/webapps/qm/WEB-INF/web.xml <3.0.1.x_installationsverzeichnis>/server/tomcat/webapps/qm/WEB-INF/web.xml
      cp <3.0.1_installationsverzeichnis>/server/tomcat/webapps/rm/WEB-INF/web.xml <3.0.1.x_installationsverzeichnis>/server/tomcat/webapps/rm/WEB-INF/web.xml
  7. Kopieren Sie die Indizes JFS/text von Version 3.0.1 auf 3.0.1.x. (Bei verteilten Systemen gehen Sie auf den entsprechenden Server, um die Dateien zu kopieren.)
    cp -R <3.0.1_installationsverzeichnis>/server/conf/jts/indices <3.0.1.x_installationsverzeichnis>/server/conf/jts
    cp -R <3.0.1_installationsverzeichnis>/server/conf/ccm/indices <3.0.1.x_installationsverzeichnis>/server/conf/ccm
    cp -R <3.0.1_installationsverzeichnis>/server/conf/qm/indices <3.0.1.x_installationsverzeichnis>/server/conf/qm
  8. Kopieren Sie die Konfigurationsdateien der Anwendung von Version 3.0.1 auf 3.0.1.x. (Bei verteilten Systemen gehen Sie auf den entsprechenden Server, um die Dateien zu kopieren.)
    cp <3.0.1_installationsverzeichnis>/server/conf/jts/teamserver*.properties  <3.0.1.x_installationsverzeichnis>/server/conf/jts
    cp <3.0.1_installationsverzeichnis>/server/conf/ccm/teamserver*.properties  <3.0.1.x_installationsverzeichnis>/server/conf/ccm
    cp <3.0.1_installationsverzeichnis>/server/conf/qm/teamserver*.properties  <3.0.1.x_installationsverzeichnis>/server/conf/qm
    cp <3.0.1_installationsverzeichnis>/server/conf/admin/admin.properties*  <3.0.1.x_installationsverzeichnis>/server/conf/admin
    cp <3.0.1_installationsverzeichnis>/server/conf/admin/friends.rdf*  <3.0.1.x_installationsverzeichnis>/server/conf/admin
    cp <3.0.1_installationsverzeichnis>/server/conf/rm/fronting.properties  <3.0.1.x_installationsverzeichnis>/server/conf/rm
    cp <3.0.1_installationsverzeichnis>/server/conf/rm/friendsconfig.rdf  <3.0.1.x_installationsverzeichnis>/server/conf/rm
  9. Führen Sie den Befehl repotools -addTables aus, um sicherzustellen, dass die Datenbank die richtigen Tabellen enthält. (Bei verteilten Systemen müssen Sie sich auf dem richtigen Server befinden, um den Befehl 'repotools' auszuführen.)
    cd <3.0.1.x_installationsverzeichnis>/server
    ./repotools-jts.sh -addTables noPrompt
    ./repotools-ccm.sh -addTables noPrompt
    ./repotools-qm.sh -addTables noPrompt
  10. Falls ein Data-Warehouse konfiguriert wurde, führen Sie den Befehl repotools-jts -createWarehouse aus, um das Data-Warehouse-Schema auf die Version 3.0.1.x zu aktualisieren.
    cd <3.0.1.x_installationsverzeichnis>/server
    ./reportools-jts.sh -createWarehouse
  11. Beim Einsatz von Upgrade-Wrapper-Scripts wechseln Sie ins Verzeichnis <3.0.1.x_installationsverzeichnis>/server.
    upgrade/jts_upgrade.sh -oldJTSHome <3.0.1_installationsverzeichnis>/server/conf
    upgrade/ccm_upgrade.sh -oldApplicationHome <3.0.1_installationsverzeichnis>/server/conf
    upgrade/qm_upgrade.sh -oldApplicationHome <3.0.1_installationsverzeichnis>/server/conf
    upgrade/rm_upgrade.sh -oldApplicationHome <3.0.1_installationsverzeichnis>/server/conf
  12. Starten Sie die Server.
  13. Aktivieren Sie die Lizenzen der Version 3.0.1.x, falls nötig. Beispielsweise müssen Sie bei Releases von Meilensteinen die Lizenzen für den Vorabzugriff aktivieren, die mit dem Meilenstein zusammen ausgeliefert werden. Im endgültigen Release 3.0.1.x können Sie dann weiterhin Ihre Lizenzen der Version 3.0.1 verwenden.
    1. Melden Sie sich als Administrator beim Jazz Team Server V3.0.1.x an.
    2. Wechseln Sie zur Seite Serveradministration > Lizenzschlüsselverwaltung und aktivieren Sie die Lizenzen.
    Anmerkung: Die Ausführung des Befehls setup auf dem System 3.0.1.x ist unnötig, denn es ist bereits alles eingerichtet.

Upgrade von Version 3.0.1 mit WebSphere Application Server

Vorgehensweise

Anmerkung: Wenn Ihre Umgebung keinen Converter unterstützt, z. B. AIX oder Solaris, müssen Sie die Version 3.0.1.x der Datei converter.war auf dem dedizierten Converter installieren. Ausführliche Informationen finden Sie unter Installation der Converteranwendung für Rational Requirements Composer.

  1. Installieren Sie CLM 3.0.1.x. Führen Sie nicht den Befehl setup aus. Bei verteilten Konfigurationen müssen Sie die Anwendung CLM 3.0.1.x entsprechend zur bereits vorhandenen Anwendung 3.0.1 installieren.
    Anmerkung: Der Jazz Team Server muss immer zuerst aktualisiert werden.
  2. Sichern Sie das WebSphere Application Server-Profil.
    1. Öffnen Sie eine Eingabeaufforderung und rufen Sie das Verzeichnis <WAS_installationsverzeichnis>/bin auf. Beispiel: /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/bin.
    2. Führen Sie den folgenden Befehl aus:
      ./backupConfig <path zu einer neuen komprimierten Datei zur Erstellung einer Profilsicherungskopie> (Beispiel: ./backupConfig /root/was_backups/clm_301_profile.zip)
      Anmerkung: Das gesicherte Profil kann bei Bedarf wiederhergestellt werden, indem Sie den Befehl ./restoreConfig ausführen. Beispiel: ./restoreConfig /root/was_backups/clm_301_profile.zip.
  3. Deinstallieren Sie die Anwendungen der Version 3.0.1 in WebSphere Application Server.
    1. Melden Sie sich bei der Integrated Solutions Console von WebSphere Application Server unter https://<hostname>:9043/ibm/console/logon.jsp an.
    2. Klicken Sie auf Anwendungen > Anwendungstypen > WebSphere Enterprise-Anwendungen.
    3. Tragen Sie die Zuordnung der Sicherheitsrollen der V3.0.1-Anwendungen jts_war, ccm_war, und qm_war ein, damit Sie sie zu den entsprechenden Anwendungen in Version 3.0.1.x im Schritt16 erneut zuordnen können.
    4. Stoppen und deinstallieren Sie die folgenden Anwendungen der Version 3.0.1: jts_war, admin_war, ccm_war, qm_war, rm_war, clmhelp_war, converter_war.
    5. Speichern Sie die Änderungen an der Masterkonfiguration, wenn Sie dazu aufgefordert werden.
  4. Aktualisieren Sie die benutzerdefinierten Eigenschaften JAZZ_HOME und log4j.configuration.
    1. Melden Sie sich bei der Integrated Solutions Console von WebSphere Application Server unter https://<hostname>:9043/ibm/console/logon.jsp an.
    2. Klicken Sie auf Server > Servertypen > WebSphere-Anwendungsserver.
    3. Klicken Sie auf den Servernamen um den Server zu öffnen. Der Standardservername lautet server1.
    4. Klicken Sie unter 'Serverinfrastruktur' auf Java- und Prozessverwaltung > Prozessdefinition.
    5. Klicken Sie unter 'Weitere Eigenschaften' auf Java Virtual Machine.
    6. Klicken Sie unter 'Weitere Eigenschaften' auf Angepasste Eigenschaften.
    7. Klicken Sie auf JAZZ_HOME und aktualisieren Sie diesen Wert zu file:///<3.0.1.x_installationsverzeichnis>/server/conf. Beispiel: file:///opt/IBM/JazzTeamServer_3.0.1.x/server/conf.
    8. Klicken Sie auf log4j.configuration und aktualisieren Sie diesen Wert zu file:///<3.0.1.x_installationsverzeichnis>/server/conf/startup_log4j.properties. Beispiel: file:///opt/IBM/JazzTeamServer_3.0.1.x/server/conf/log4j.properties.
    9. Wenn Sie eine Verbindung zu einer Oracle- oder SQL Server-Datenbank herstellen, müssen Sie sicherstellen, dass der Pfad ORACLE_JDBC_DRIVER_FILE bzw. SQLSERVER_JDBC_DRIVER_FILE auf die richtige JDBC-Treiberdatei verweist.
    10. Speichern Sie die Änderungen an der Masterkonfiguration, wenn Sie dazu aufgefordert werden.
      Anmerkung: Ausführliche Informationen hierzu enthält der Artikel WebSphere Application Server konfigurieren.
  5. Stoppen Sie WebSphere Application Server.
  6. Entfernen Sie CLM-bezogenen Inhalt aus den Verzeichnissenwstemp und temp im Profil. Abhängig von früher installierten Anwendungen befinden sich folgende Verzeichnisse im Profil und können entfernt werden: jts_war, admin_war, ccm_war, qm_war, rm_war, clmhelp_war, converter_war.
    <profilverzeichnis>/wstemp (Beispiel: /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/wstemp)
    <profilverzeichnis>/temp (Beispiel: /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/temp)
  7. Entfernen Sie CLM-bezogene Protokolldateien aus dem Verzeichnis für die Protokolldateien im Profil.
    <profilverzeichnis>/logs (Beispiel: /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs)
  8. Vorbereitung der Datenbanken für CLM 3.0.1.x-Anwendungen.
    1. Falls Derby eingesetzt wird, verschieben Sie die Derby-Datenbank von 3.0.1 auf 3.0.1.x:
      cp -R <3.0.1_installationsverzeichnis>/server/conf/jts/derby/repositoryDB  <3.0.1.x_installationsverzeichnis>/server/conf/jts/derby
      cp -R <3.0.1_installationsverzeichnis>/server/conf/ccm/derby/repositoryDB  <3.0.1.x_installationsverzeichnis>/server/conf/ccm/derby
      cp -R <3.0.1_installationsverzeichnis>/server/conf/qm/derby/repositoryDB  <3.0.1.x_installationsverzeichnis>/server/conf/qm/derby
    2. Wenn Sie DB2, Oracle, oder SQL Server einsetzen, sichern Sie die Datenbank.
  9. Bei Verwendung von Upgrade-Wrapper-Scripts springen Sie nun zum Schritt 14
  10. Kopieren Sie die Indizes JFS/text von Version 3.0.1 auf 3.0.1.x. (Bei verteilten Systemen gehen Sie auf den entsprechenden Server, um die Dateien zu kopieren.)
    cp -R <3.0.1_installationsverzeichnis>/server/conf/jts/indices <3.0.1.x_installationsverzeichnis>/server/conf/jts
    cp -R <3.0.1_installationsverzeichnis>/server/conf/ccm/indices <3.0.1.x_installationsverzeichnis>/server/conf/ccm
    cp -R <3.0.1_installationsverzeichnis>/server/conf/qm/indices <3.0.1.x_installationsverzeichnis>/server/conf/qm
  11. Kopieren Sie die Konfigurationsdateien für Ihre Anwendung von Version 3.0.1 auf 3.0.1.1. (Bei verteilten Systemen gehen Sie auf den entsprechenden Server, um die Dateien zu kopieren.)
    cp <3.0.1_installationsverzeichnis>/server/conf/jts/teamserver*.properties  <3.0.1.x_installationsverzeichnis>/server/conf/jts
    cp <3.0.1_installationsverzeichnis>/server/conf/ccm/teamserver*.properties  <3.0.1.x_installationsverzeichnis>/server/conf/ccm
    cp <3.0.1_installationsverzeichnis>/server/conf/qm/teamserver*.properties  <3.0.1.x_installationsverzeichnis>/server/conf/qm
    cp <3.0.1_installationsverzeichnis>/server/conf/admin/admin.properties*  <3.0.1.x_installationsverzeichnis>/server/conf/admin
    cp <3.0.1_installationsverzeichnis>/server/conf/admin/friends.rdf*  <3.0.1.x_installationsverzeichnis>/server/conf/admin
    cp <3.0.1_installationsverzeichnis>/server/conf/rm/fronting.properties  <3.0.1.x_installationsverzeichnis>/server/conf/rm
    cp <3.0.1_installationsverzeichnis>/server/conf/rm/friendsconfig.rdf  <3.0.1.x_installationsverzeichnis>/server/conf/rm
  12. Führen Sie den Befehl repotools -addTables aus, um sicherzustellen, dass die Datenbank die richtigen Tabellen enthält. (Bei verteilten Systemen müssen Sie sich auf dem richtigen Server befinden, um den Befehl 'repotools' auszuführen.)
    cd <3.0.1.x_installationsverzeichnis>/server
    ./repotools-jts.sh -addTables noPrompt
    ./repotools-ccm.sh -addTables noPrompt
    ./repotools-qm.sh -addTables noPrompt
  13. Falls ein Data-Warehouse konfiguriert wurde, führen Sie den Befehl repotools-jts -createWarehouse aus, um das Data-Warehouse-Schema auf die Version 3.0.1.x zu aktualisieren.
    cd <3.0.1.x_installationsverzeichnis>/server
    ./reportools-jts.sh -createWarehouse
  14. Beim Einsatz von Upgrade-Wrapper-Scripts wechseln Sie ins Verzeichnis <3.0.1.x_installationsverzeichnis>/server.
    upgrade/jts_upgrade.sh -oldJTSHome <3.0.1_installationsverzeichnis>/server/conf
    upgrade/ccm_upgrade.sh -oldApplicationHome <3.0.1_installationsverzeichnis>/server/conf
    upgrade/qm_upgrade.sh -oldApplicationHome <3.0.1_installationsverzeichnis>/server/conf)
    upgrade/rm_upgrade.sh -oldApplicationHome <3.0.1_installationsverzichnis>/server/conf
  15. Starten Sie WebSphere Application Server.
  16. Implementieren Sie die WAR-Dateien der Version 3.0.1 in WebSphere Application Server.
    1. Melden Sie sich bei der Integrated Solutions Console von WebSphere Application Server unter https://<hostname>:9043/ibm/console/logon.jsp an.
    2. Klicken Sie auf Anwendungen > Anwendungstypen > WebSphere Enterprise-Anwendungen.
    3. Installieren Sie die Dateien jts_war, admin_war, ccm_war, qm_war, rm_war, clmhelp_war, converter_war.
    4. Ornden Sie die Sicherheitsrollen den folgenden Anwendungen entsprechend zu: jts_war, ccm_war, qm_war.
      Anmerkung: Ausführliche Informationen hierzu enthält der Artikel CLM-Anwendungen in WebSphere Application Server implementieren.
  17. Während Sie sich auf der Seite 'Unternehmensanwendungen' befinden, starten Sie folgende Anwendungen: jts_war, admin_war, ccm_war, qm_war, rm_war, clmhelp_war, converter_war.
  18. Führen Sie ein Reset für JTS, CCM, und QM durch:
    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
    Anmerkung: Sie müssen die Server erneut starten, damit der Reset Wirkung zeigt.
  19. Aktivieren Sie die Lizenzen der Version 3.0.1.x, falls nötig. Beispielsweise müssen Sie bei Releases von Meilensteinen die Lizenzen für den Vorabzugriff aktivieren, die mit dem Meilenstein zusammen ausgeliefert werden. Im endgültigen Release 3.0.1.x können Sie dann weiterhin Ihre Lizenzen der Version 3.0.1 verwenden.
    1. Melden Sie sich als Administrator beim Jazz Team Server V3.0.1.x an.
    2. Wechseln Sie zur Seite Serveradministration > Lizenzschlüsselverwaltung und aktivieren Sie die Lizenzen.
    Anmerkung: Die Ausführung des Befehls setup auf dem System 3.0.1.x ist unnötig, denn es ist bereits alles eingerichtet.
    Anmerkung: Die aktuellsten Informationen zum Upgradeprozess enthält der Artikel CLM Upgrading Knowledge Collection.

Feedback