Upgrade auf Version 4.0 durchführen

In diesem Handbuch ist das Upgrade von Rational Team Concert 3.0 oder von Serveranwendungen für Collaborative Lifecycle Management (CLM) Version 3.0.1 auf CLM Version 4.0 beschrieben.

Hinweis: Das Upgrade von Version 2 auf Version 4 erfolgt in zwei Schritten. Zunächst müssen Sie für Ihren Server ein Upgrade auf Version 3.0.1 durchführen und dann das Upgrade auf Version 4.0. Anweisungen für das Upgrade von Version 2 auf Version 3.0.1 finden Sie im Information Center zu Version 3.0.1.

Informationen zum Upgrade für die CLM-Anwendungen unter z/OS enthält der Artikel Spezielle Anweisungen für Upgrades unter z/OS.

Optionen auswählen, die Ihre Installationsumgebung am besten beschreiben

Anwendungen auswählen, für die ein Upgrade durchgeführt werden soll:
Upgrade für Jazz Team Server ist bereits durchgeführt
Implementierungstopologie auswählen:
Betriebssystem für Ihren Anwendungsserver auswählen:
Anwendungsserver auswählen:
Datenbankserver auswählen:
Angabe, ob in CLM 3.0.1 das Data Warehouse konfiguriert wurde
Angabe, ob andere Produkte integriert werden sollen:

Sie haben folgende Angaben zusammengestellt, auf deren Grundlage die vollständigen Anweisungen für Ihr Produktupgrade generiert werden:

Wichtige Hinweise:

Planungsprüfliste

Prüfen Sie die Angaben in der folgenden Planungsprüfliste, bevor Sie das Upgrade für die Produkte der Rational-Lösung für Collaborative Lifecycle Management durchführen.

  Planungsaufgabe Weitere Informationen
Upgradedatenblatt verwenden: Das Upgradedatenblatt unterstützt Sie beim Zusammenstellen und Erfassen bestimmter Daten, die Sie während des Upgrades und beim Konfigurieren Ihrer Implementierung benötigen, z. B. von URLs, Benutzer-IDs und weiteren Elementen. Upgradedatenblatt
Verifizieren, dass Hardware und Software die Systemmindestvoraussetzungen erfüllen: Für Version 4.0 gelten eine Reihe neuer Anforderungen. So werden beispielsweise nur noch 64-Bit-Betriebssysteme unterstützt. Klicken Sie rechts auf den Link, um sich über die neuen Voraussetzungen zu informieren und festzustellen, ob Ihr aktuelles System die Systemmindestvoraussetzungen erfüllt. Systemvoraussetzungen
Produktinstallationsmedien abrufen: Für den Download in ein lokales Repository benötigen Sie ca. fünf Gigabytes (5 GB) Speicherplatz auf dem Festplattenlaufwerk. Die Serverinstallationsdateien können Sie von der Seite jazz.net herunterladen.
Beispiel einer Upgradetopologie ansehen Beispiel für eine verteilte Unternehmenstopologie
Systemzeit aller Maschinen synchronisieren: In einer verteilten Umgebung müssen Sie sicherstellen, dass die Systemzeiten aller Maschinen mit dem Network Time Protocol (NTP) synchronisiert werden. Weitere Informationen zu NTP finden Sie auf ntp.org.
Implementierungs- und Upgradeprozess verstehen: Lesen Sie diesen Artikel, damit Sie den Upgradeprozess verstehen, über Einschränkungen und wichtige Aspekte informiert sind und wissen, wie lange das Upgrade für die einzelnen Anwendungen dauern wird. Basisinformationen zum Implementierungs- und Upgradeprozess
Nichtverfügbarkeit Ihrer Anwendungen einplanen: Planen Sie ein, dass Ihre Anwendungen kurze Zeit nicht verfügbar sein werden, während Sie Sicherungen erstellen und das Update auf Version 4.0 durchführen. Alle mit Jazz Team Server verbundenen Anwendungen sind offline, solange Jazz Team Server offline ist. Nehmen Sie sich die Zeit, vollständige Sicherungen Ihrer vorhandenen Anwendungen zu erstellen.  
Informationen zu den Datenbankvoraussetzungen zusammenstellen:
  • Sie haben Zugriff auf die Datenbank von Version 3 und können das Verzeichnis derby/repositoryDB kopieren.
  • Sie benötigen den richtigen Benutzernamen mit zugehörigem Kennwort.
    • Fordern Sie auf UNIX-Systemen das Kennwort für den Benutzer db2inst1 an.
  • Vor Beginn des Upgradeprozesses müssen Sie Ihre Datenbank sichern.
  • Sie benötigen den richtigen Benutzernamen mit zugehörigem Kennwort.
  • Vor Beginn des Upgradeprozesses müssen Sie Ihre Datenbank sichern. Lesen Sie in der Dokumentation Ihres Datenbankanbieters nach, wie eine Datenbanksicherung erstellt wird.
  • Die Rational-Lösung für CLM 4.0 bietet keine Unterstützung mehr für JRE 5.0. Unterstützt werden die Versionen JRE 6.0 und 7.0. Die Klassenbibliothek ojdbc5.jar erfordert JRE 5.0 und die Klassenbibliothek ojdbc6.jar erfordert JRE 6.0 oder eine aktuellere JRE. Sie müssen ojdbc6.jar verwenden.
  • Sie müssen eine Umgebungsvariable mit dem Namen ORACLE_JDBC_DRIVER_FILE erstellen, die auf den JDBC-Treiber ojdbc6.jar zeigt.
  • Sie benötigen den richtigen Benutzernamen mit zugehörigem Kennwort.
  • Vor Beginn des Upgradeprozesses müssen Sie Ihre Datenbank sichern. Lesen Sie in der Dokumentation Ihres Datenbankanbieters nach, wie eine Datenbanksicherung erstellt wird.
  • Der JDBC-Treiber (Java Database Connectivity) ist installiert. Die Rational-Lösung für CLM 4.0 bietet keine Unterstützung mehr für JRE 5.0. Unterstützt werden die Versionen JRE 6.0 und 7.0. Für die Klassenbibliothek sqljdbc4.jar ist JRE 6.0 oder eine aktuellere JRE-Version erforderlich. Sie müssen sqljdbc4.jar verwenden.
  • Der SQL-Dienst muss gestartet sein.
Informationen zur Lizenzierung einholen. Sie müssen neue Lizenzen für Version 4 kaufen. Lizenzen für Version 4 sind mit Anwendungen der Version 3 kompatibel. Anwendungen der Version 4 können jedoch nicht mit Lizenzen für Version 3 verwendet werden. Lizenzierung verwalten
Browserkompatibilität prüfen:
  • Aktivieren Sie JavaScript in Ihren Webbrowsern, damit die Assistenten angezeigt werden können.
  • In Webbrowsern, die für die Migration verwendet werden, müssen Pop-up-Blocker inaktiviert sein.
 

Testumgebung für Upgradeprozess bereitstellen (optional)

Vor dem Upgrade für Ihre Produktionsumgebung können Sie eine Testumgebung einrichten, um Problemen vorzubeugen. Weitere Informationen hierzu enthält der Artikel Testumgebung für den Upgradeprozess bereitstellen.

Zurücksetzen der Server anfordern

Rufen Sie mit https://qualified.host.name:port/jts/admin?internal#action=com.ibm.team.repository.admin.serverReset die Verwaltungsseite von Jazz Team Server 3.0.1 auf und klicken Sie auf Serverzurücksetzung.

Rufen Sie mit https://qualified.host.name:port/ccm/admin?internal#action=com.ibm.team.repository.admin.serverReset die Verwaltungsseite von Change and Configuration Management 3.0.1 auf und klicken Sie auf Serverzurücksetzung.

Rufen Sie mit https://qualified.host.name:port/qm/admin?internal#action=com.ibm.team.repository.admin.serverReset die Verwaltungsseite von Quality Management 3.0.1 auf und klicken Sie auf Serverzurücksetzung.

Servernamen, Knotennamen und Namen der installierten Anwendungen der Version 3.0.1 notieren

  1. Melden Sie sich bei der Integrated Solutions Console von WebSphere Application Server an.
  2. Erweitern Sie die Anzeige für Server > Servertypen und wählen Sie WebSphere-Anwendungsserver aus.
  3. Notieren Sie den Servernamen und den Knotennamen.
  4. Erweitern Sie die Anzeige für Anwendungen > Anwendungstypen und wählen Sie WebSphere-Unternehmensanwendungen aus.
  5. Notieren Sie die Namen der folgenden installierten Anwendungen:
    • Jazz Team Server
    • CLMHelp
    • Change and Configuration Management
    • Quality Management
    • Requirements Management
    • Converter

Upgrade für Rational Reporting for Development Intelligence (RRDI) durchführen

Hinweis: Sie müssen das Upgrade für Rational Reporting for Development Intelligence vor dem Upgrade für die Rational-Lösung für Collaborative Lifecycle Management durchführen. Beim Upgrade für Rational Reporting for Development Intelligence müssen Sie die Data Warehouses nicht einbeziehen, da diese beim Upgrade für die Rational-Lösung für CLM mit berücksichtigt werden.

Wenn Sie mit Rational Reporting for Development Intelligence Version 1.0.2 arbeiten und ein Upgrade auf Version 2.0 durchführen möchten, gehen Sie wie folgt vor:

  1. Sichern Sie die Installation von Rational Reporting for Development Intelligence 1.0.2. Weitere Informationen enthält der Artikel Dateien für Rational Reporting for Development Intelligence 1.0.2.x sichern.
  2. Deinstallieren Sie Rational Reporting for Development Intelligence 1.0.2 und WebSphere Application Server.
  3. Installieren Sie Rational Reporting for Development Intelligence 2.0.
  4. Installieren Sie WebSphere Application Server.
  5. Führen Sie die Setup-Anwendung aus, um Rational Reporting for Development Intelligence zu konfigurieren.
  6. Konfigurieren und testen Sie den Berichtsserver.
  7. Testen Sie die Ausführung der Java-ETL-Jobs. Führen Sie vorhandene Berichte und Dashboards aus, um sicherzugehen, dass es keine Regression gibt.

Weitere Informationen enthält der Artikel Upgrade von Rational Reporting for Development Intelligence Version 1.0.2.x auf Version 2.0 durchführen.

Laden Sie nach dem Upgrade auf Version 4.0 der Rational-Lösung für CLM die neuesten Berichtsbeispiele und -ressourcen herunter und laden Sie sie in den Berichtsserver. Vollständige Anweisungen enthält der Artikel Upgrade für Berichtsartefakte durchführen.

CLM 4.0 installieren

Installieren Sie die Anwendungen von CLM 4.0. Führen Sie jedoch nicht den Setup-Assistenten aus. Bei verteilten Konfigurationen müssen Sie die Anwendungen von CLM 4.0 installieren, die Sie bereits in der Version 3.0.1 installiert haben. Informationen zur Installation des Servers enthält der Artikel Installation mit IBM Installation Manager.

Installieren Sie die Anwendungen von CLM 4.0. Führen Sie jedoch nicht den Setup-Assistenten aus. Bei verteilten Konfigurationen müssen Sie die Anwendungen von CLM 4.0 installieren, die Sie bereits in der Version 3.0.1 installiert haben. Informationen zur Installation des Servers enthält der Artikel Installation für Lizenzprogramme unter IBM i.

Hinweis: Der Jazz Team Server muss immer zuerst aktualisiert werden. In einer dezentralen Umgebung müssen Sie die Lizenzen für Version 4 vor den CLM-Anwendungen installieren. Weitere Informationen finden Sie unter dem Schritt "Testlizenz aktivieren oder Lizenzen für Version 4 installieren".

Profil von WebSphere Application Server sichern

Führen Sie die folgenden Schritte auf jedem Anwendungsserver aus, um die Profile von WebSphere Application Server zu sichern.
  1. Öffnen Sie eine Eingabeaufforderung und rufen Sie das Unterverzeichnis bin des Installationsverzeichnisses von WebSphere Application Server auf. Beispiel: C:\Programme\IBM\WebSphere\AppServer\profiles\AppSrv01\bin
  2. Führen Sie den folgenden Befehl aus. Wenn die Sicherheit von WebSphere Application Server aktiviert ist, müssen Sie außerdem den Benutzernamen und das Kennwort angeben.
  3. backupConfig.bat Pfad zu einer neuen komprimierten Datei (in der die Profilsicherung erstellt werden soll) Name des primären WAS-Benutzers mit Verwaltungsaufgaben Kennwort des WAS-Benutzers mit Verwaltungsaufgaben (Beispiel: backupConfig.bat C:\WAS_backup\clm_301_profile.zip -username WAS-Administrator -password WAS-Administratorkennwort)

    Hinweis: Das Verzeichnis muss vor Ausführung des Befehls vorhanden sein.

    Tipp: Das gesicherte Profil kann bei Bedarf mit dem Befehl restoreConfig.bat wiederhergestellt werden. Beispiel: restoreConfig.bat C:\WAS_backup\clm_301_profile.zip

  1. Öffnen Sie eine Eingabeaufforderung und rufen Sie das Unterverzeichnis bin des Installationsverzeichnisses von WebSphere Application Server auf. Beispiel: /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/bin
  2. Führen Sie den folgenden Befehl aus. Wenn die Sicherheit von WebSphere Application Server aktiviert ist, müssen Sie außerdem den Benutzernamen und das Kennwort angeben.
  3. ./backupConfig.sh Pfad zu einer neuen komprimierten Datei (in der die Profilsicherung erstellt werden soll) Name des primären WAS-Benutzers mit Verwaltungsaufgaben Kennwort des WAS-Benutzers mit Verwaltungsaufgaben (Beispiel: ./backupConfig.sh /root/WAS_backup/clm_301_profile.zip -username WAS-Administrator -password WAS-Administratorkennwort)

    Hinweis: Das Verzeichnis und die ZIP-Datei müssen vor Ausführung des Befehls vorhanden sein.

    Tipp: Das gesicherte Profil kann bei Bedarf mit dem Befehl ./restoreConfig.sh wiederhergestellt werden. Beispiel: ./restoreConfig.sh /root/WAS_backup/clm_301_profile.zip

  1. Öffnen Sie eine Eingabeaufforderung und rufen Sie das Unterverzeichnis bin des Installationsverzeichnisses von WebSphere Application Server auf. Beispiel: /usr/IBM/WebSphere/AppServer/profiles/AppSrv01/bin
  2. Führen Sie den folgenden Befehl aus. Wenn die Sicherheit von WebSphere Application Server aktiviert ist, müssen Sie außerdem den Benutzernamen und das Kennwort angeben.
  3. ./backupConfig.sh Pfad zu einer neuen komprimierten Datei (in der die Profilsicherung erstellt werden soll) Name des primären WAS-Benutzers mit Verwaltungsaufgaben Kennwort des WAS-Benutzers mit Verwaltungsaufgaben (Beispiel: ./backupConfig.sh /root/WAS_backup/clm_301_profile.zip -username WAS-Administrator -password WAS-Administratorkennwort)

    Hinweis: Das Verzeichnis und die ZIP-Datei müssen vor Ausführung des Befehls vorhanden sein.

    Tipp: Das gesicherte Profil kann bei Bedarf mit dem Befehl ./restoreConfig.sh wiederhergestellt werden. Beispiel: ./restoreConfig.sh /root/WAS_backup/clm_301_profile.zip

Anwendungen der Version 3.0.1 in WebSphere Application Server deinstallieren

Führen Sie die folgenden Schritte auf jedem Anwendungsserver aus, um die WAR-Dateien der Anwendungen der Version 3.0.1 zu deinstallieren.
  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-Unternehmensanwendungen.
  3. Notieren Sie die Zuordnung der Sicherheitsrollen für die folgenden Anwendungen der Version 3.0.1, damit Sie die entsprechenden Zuordnungen in Version 4.0 leichter vornehmen können:
    • jts_war
    • ccm_war
    • qm_war
  4. Stoppen und deinstallieren Sie die folgenden Anwendungen der Version 3.0.1:
    • jts_war
    • clmhelp_war
    • admin_war
    • ccm_war
    • qm_war
    • rm_war
    • converter_war
  5. Speichern Sie die Änderungen an der Masterkonfiguration, wenn Sie dazu aufgefordert werden.

Angepasste Eigenschaften JAZZ_HOME und log4j.configuration aktualisieren

Führen Sie auf jedem Anwendungsserver die folgenden Schritte aus.
  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 ist server1.
  4. Klicken Sie im Abschnitt '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 den Wert. Setzen Sie die Eigenschaft auf file:///4.0-Installationsverzeichnis/server/conf. Beispiel: file:///C:/PROGRA~2/IBM/JazzTeamServer_4.0/server/conf
  8. Klicken Sie auf JAZZ_HOME und aktualisieren Sie den Wert. Setzen Sie die Eigenschaft auf file:///4.0-Installationsverzeichnis/server/conf. Beispiel: file:///opt/IBM/JazzTeamServer_4.0/server/conf
  9. Klicken Sie auf JAZZ_HOME und aktualisieren Sie den Wert. Setzen Sie die Eigenschaft auf file:///4.0-Installationsverzeichnis/server/conf. Beispiel: file:///usr/IBM/JazzTeamServer_4.0/server/conf
  10. Klicken Sie auf log4j.configuration und aktualisieren Sie den Wert. Setzen Sie die Eigenschaft auf file:///4.0-Installationsverzeichnis/server/conf/startup_log4j.properties. Beispiel: file:///C:/PROGRA~2/IBM/JazzTeamServer_4.0/server/conf/startup.log4j.properties
  11. Klicken Sie auf log4j.properties und aktualisieren Sie den Wert. Setzen Sie die Eigenschaft auf file:///4.0-Installationsverzeichnis/server/conf/startup_log4j.properties. Beispiel: file:///opt/IBM/JazzTeamServer_4.0/server/conf/startup_log4j.properties
  12. Klicken Sie auf log4j.properties und aktualisieren Sie den Wert. Setzen Sie die Eigenschaft auf file:///4.0-Installationsverzeichnis/server/conf/startup_log4j.properties. Beispiel: file:///usr/IBM/JazzTeamServer_4.0/server/conf/startup_log4j.properties
  13. Wenn Sie eine Verbindung zu einer Oracle-Datenbank herstellen, muss ORACLE_JDBC_DRIVER_FILE auf die richtige JDBC-Treiberdatei zeigen.
  14. Wenn Sie eine Verbindung zu einer SQL-Server-Datenbank herstellen, muss SQLSERVER_JDBC_DRIVER_FILE auf die richtige JDBC-Treiberdatei zeigen.
  15. Speichern Sie die Änderungen an der Masterkonfiguration, wenn Sie dazu aufgefordert werden.

Hinweis: Ausführliche Informationen finden Sie im Artikel WebSphere Application Server einrichten.

WebSphere Application Server stoppen

Führen Sie die folgenden Schritte auf jedem Anwendungsserver aus, um WebSphere Application Server zu stoppen.
  1. Öffnen Sie eine Eingabeaufforderung und rufen Sie das Verzeichnis WAS-Profilstammverzeichnis\bin auf.
  2. Geben Sie den folgenden Befehl ein:
  3. stopServer.bat server1 -user Benutzer-ID_des_Administrators -password Administratorkennwort

  1. Öffnen Sie eine Eingabeaufforderung und rufen Sie das Verzeichnis WAS-Profilstammverzeichnis/bin auf.
  2. Geben Sie den folgenden Befehl ein:
  3. ./stopServer.sh server1 -user Benutzer-ID_des_Administrators -password Administratorkennwort

Temporäre Verzeichnisse von WebSphere Application Server bereinigen

Entfernen Sie auf jedem Anwendungsserver CLM-bezogene Inhalte aus den folgenden Verzeichnissen wscache und temp im Profil. Das Profil kann abhängig von den installierten Vorversionen die folgenden Verzeichnisse enthalten, die Sie entfernen können:
Entfernen Sie CLM-bezogene Inhalte aus den folgenden Verzeichnissen wscache und temp im Profil. Das Profil kann abhängig von den installierten Vorversionen die folgenden Verzeichnisse enthalten, die Sie entfernen können:
  • jts_war
  • ccm_war
  • qm_war
  • rm_war
  • converter_war
  • admin_war
  • clmhelp_war

WAS-Profilstammverzeichnis\wscache (z. B. C:\Programme\IBM\WebSphere\AppServer\profiles\AppSrv01\wscache)
WAS-Profilstammverzeichnis\temp (z. B. C:\Programme\IBM\WebSphere\AppServer\profiles\AppSrv01\temp)

WAS-Profilstammverzeichnis/wscache (z. B. opt/IBM/WebSphere/AppServer/profiles/AppSrv01/wscache)
WAS-Profilstammverzeichnis/temp (z. B. opt/IBM/WebSphere/AppServer/profiles/AppSrv01/temp)

WAS-Profilstammverzeichnis/wscache (z. B. usr/IBM/WebSphere/AppServer/profiles/AppSrv01/wscache)
WAS-Profilstammverzeichnis/temp (z. B. usr/IBM/WebSphere/AppServer/profiles/AppSrv01/temp)

Verzeichnis 'logs' bereinigen

Entfernen Sie auf jedem Anwendungsserver CLM-bezogene Protokolldateien aus dem Verzeichnis für die Protokolldateien im Profil.
Entfernen Sie CLM-bezogene Protokolldateien aus dem Verzeichnis 'logs' im Profil.

WAS-Profilstammverzeichnis\logs (z. B. C:\Programme\IBM\WebSphere\AppServer\profiles\AppSrv01\logs)

WAS-Profilstammverzeichnis/logs (z. B. opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs)

WAS-Profilstammverzeichnis/logs (z. B. usr/IBM/WebSphere/AppServer/profiles/AppSrv01/logs)

Server stoppen

Stoppen Sie alle Anwendungsserver der Version 3.0.1.

  1. Öffnen Sie eine Eingabeaufforderung und rufen Sie das Verzeichnis 3.0.1-Installationsverzeichnis\server auf.
  2. Geben Sie den folgenden Befehl ein:
  3. server.shutdown.bat

  1. Öffnen Sie eine Eingabeaufforderung und rufen Sie das Verzeichnis 3.0.1-Installationsverzeichnis/server auf.
  2. Geben Sie den folgenden Befehl ein:
  3. ./server.shutdown.sh

Derby-Datenbanken aus dem Installationsverzeichnis der Version 3.0.1 kopieren

Öffnen Sie eine Eingabeaufforderung und geben Sie die folgenden Befehle ein, um das Standardverzeichnis mit der Derby-Repository-Datenbank der Version 4.0 zu bereinigen:

del /s /f 4.0-Installationsverzeichnis\server\conf\jts\derby\repositoryDB
del /s /f 4.0-Installationsverzeichnis\server\conf\jts\derby\warehouseDB
del /s /f 4.0-Installationsverzeichnis\server\conf\ccm\derby\repositoryDB
del /s /f 4.0-Installationsverzeichnis\server\conf\qm\derby\repositoryDB
rm -rf 4.0-Installationsverzeichnis/server/conf/jts/derby/repositoryDB
rm -rf 4.0-Installationsverzeichnis/server/conf/jts/derby/warehouseDB
rm -rf 4.0-Installationsverzeichnis/server/conf/ccm/derby/repositoryDB
rm -rf 4.0-Installationsverzeichnis/server/conf/qm/derby/repositoryDB

Öffnen Sie eine Eingabeaufforderung und geben Sie die folgenden Befehle ein, um die Derby-Datenbank von Version 3.0.1 in Version 4.0 zu kopieren.

Hinweis: Bei den folgenden Befehlen wird davon ausgegangen, dass Sie die mit dem Produktpaket bereitgestellte Derby-Datenbank verwenden. Falls Sie die Position der Derby-Datenbank geändert haben, müssen Sie die Befehle aktualisieren und stattdessen die Position Ihrer vorhandenen Datenbank von Version 3.0.1 angeben.

xcopy /s 3.0.1-Installationsverzeichnis\server\conf\jts\derby\repositoryDB 4.0-Installationsverzeichnis\server\conf\jts\derby\repositoryDB
xcopy /s 3.0.1-Installationsverzeichnis\server\conf\jts\derby\warehouseDB 4.0-Installationsverzeichnis\server\conf\jts\derby\warehouseDB
xcopy /s 3.0.1-Installationsverzeichnis\server\conf\ccm\derby\repositoryDB 4.0-Installationsverzeichnis\server\conf\ccm\derby\repositoryDB
xcopy /s 3.0.1-Installationsverzeichnis\server\conf\qm\derby\repositoryDB 4.0-Installationsverzeichnis\server\conf\qm\derby\repositoryDB
cp -R 3.0.1-Installationsverzeichnis/server/conf/jts/derby/repositoryDB 4.0-Installationsverzeichnis/server/conf/jts/derby/repositoryDB
cp -R 3.0.1-Installationsverzeichnis/server/conf/jts/derby/warehouseDB 4.0-Installationsverzeichnis/server/conf/jts/derby/warehouseDB
cp -R 3.0.1-Installationsverzeichnis/server/conf/ccm/derby/repositoryDB 4.0-Installationsverzeichnis/server/conf/ccm/derby/repositoryDB
cp -R 3.0.1-Installationsverzeichnis/server/conf/qm/derby/repositoryDB 4.0-Installationsverzeichnis/server/conf/qm/derby/repositoryDB

Datenbank sichern

Sichern Sie Ihre DB2-Datenbanken, einschließlich der Data-Warehouse-Datenbank. Diesbezügliche Informationen enthält der Artikel DB2-Datenbank sichern und wiederherstellen.

Sichern Sie Ihre Oracle-Datenbanken, einschließlich der Data-Warehouse-Datenbank. In der Oracle-Dokumentation finden Sie Anweisungen für das Sichern der Datenbanken.

Sichern Sie Ihre SQL-Server-Datenbanken, einschließlich der Data-Warehouse-Datenbank. In der Dokumentation zu SQL Server finden Sie Anweisungen für das Sichern der Datenbanken.

Indexposition überprüfen

Prüfen Sie vor Beginn des Upgrades mit den folgenden Schritten, ob die Indexposition in den Eigenschaftendateien als absoluter Pfad im Dateisystem angegeben ist, anstatt als relativer Pfad.

  1. Rufen Sie für Jazz Team Server das Verzeichnis JTS-3.0.1-Installationsverzeichnis/server/jts auf und öffnen Sie die Datei temserver.properties zur Bearbeitung.
  2. Rufen Sie für die Anwendung Change and Configuration Management das Verzeichnis CCM-3.0.1-Installationsverzeichnis/server/ccm auf und öffnen Sie die Datei temserver.properties zur Bearbeitung.
  3. Rufen Sie für die Anwendung Quality Management das Verzeichnis QM-3.0.1-Installationsverzeichnis/server/qm auf und öffnen Sie die Datei temserver.properties zur Bearbeitung.
  4. Suchen Sie nach der Zeile com.ibm.team.fulltext.indexlocation.
  5. Wenn die Position als relativer Pfad angegeben ist, handelt es sich um eine Indexposition bezogen auf das WebSphere-Application-Server-Profil für die Anwendungen. Ersetzen Sie die Positionsangabe wie folgt durch einen absoluten Pfad:
    • Geben Sie für Jazz Team Server com.ibm.team.fulltext.indexLocation=WAS-Installationsverzeichnis/IBM/WebSphere/appServer/profiles/Appsrv01/conf/jts/indices/workitemindex ein. Hier steht WAS-Installationsverzeichnis für das WebSphere-Application-Server-Installationsverzeichnis und Appsrv01 für den Namen des Anwendungsserverprofils.
    • Geben Sie für die Anwendung Change and Confoguration Management com.ibm.team.fulltext.indexLocation=WAS-Installationsverzeichnis/IBM/WebSphere/appServer/profiles/Appsrv01/conf/ccm/indices/workitemindex ein. Hier steht WAS-Installationsverzeichnis für das WebSphere-Application-Server-Installationsverzeichnis und Appsrv01 für den Namen des Anwendungsserverprofils.
    • Geben Sie für die Anwendung Quality Management com.ibm.team.fulltext.indexLocation=WAS-Installationsverzeichnis/IBM/WebSphere/appServer/profiles/Appsrv01/conf/qm/indices/workitemindex ein. Hier steht WAS-Installationsverzeichnis für das WebSphere-Application-Server-Installationsverzeichnis und Appsrv01 für den Namen des Anwendungsserverprofils.
  6. Während des Upgrades öffnet das Script nach dem Zusammenführen der Eigenschaften die Datei teamserver.properties von Version 4.0, damit Sie eine Vorschau der Eigenschaften sehen. Setzen Sie jetzt die Position der Indexdateien auf einen absoluten Pfad, d. h. auf eine stabile Position auf Ihrem Laufwerk. Eine stabile Position ist ein Verzeichnis, das bei der Deinstallation einer Anwendung nicht gelöscht wird. Ein absoluter Pfad zu einer stabilen Position sieht wie folgt aus:
    • com.ibm.team.fulltext.indexLocation=JTS-4.0-Installationsverzeichnis/server/conf/jts/indices/workitemindex (wobei JTS-4.0-Installationsverzeichnis für die Installationsposition der Anwendung Jazz Team Server 4.0 steht)
    • com.ibm.team.fulltext.indexLocation=CCM-4.0-Installationsverzeichnis/server/conf/ccm/indices/workitemindex (wobei CCM-4.0-Installationsverzeichnis für die Installationsposition der Anwendung Change and Configuration Management 4.0 steht)
    • com.ibm.team.fulltext.indexLocation=QM-4.0-Installationsverzeichnis/server/conf/qm/indices/workitemindex (wobei QM-4.0-Installationsverzeichnis für die Installationsposition der Anwendung Quality Management 4.0 steht)
    Das Script kopiert die Indizes von Version 3.x dann in das neue stabile Verzeichnis der Version 4.0.

Upgrade-Befehl der Repository Tools ausführen

Rufen Sie für ein Upgrade der Konfigurationsdateien von Jazz Team Server das Verzeichnis JTS4.0-Installationsverzeichnis/server auf und führen Sie die folgenden Befehle aus:

repotools-jts.bat -migration_jts_updateConfigurationFiles oldJTSHome=JTS3.0.1-Installationsverzeichnis/server/conf

repotools-jts.bat -addTables

repotools-jts.bat -upgradeWarehouse

repotools-jts.bat -migration_jts_updateConfigurationFiles oldJTSHome=JTS3.0.1-Installationsverzeichnis/server/conf updateTomcatFiles=no

repotools-jts.bat -addTables

repotools-jts.bat -upgradeWarehouse

./repotools-jts.sh -migration_jts_updateConfigurationFiles oldJTSHome=JTS3.0.1-Installationsverzeichnis/server/conf

./repotools-jts.sh -addTables

./repotools-jts.sh -upgradeWarehouse

./repotools-jts.sh -migration_jts_updateConfigurationFiles oldJTSHome=JTS3.0.1-Installationsverzeichnis/server/conf updateTomcatFiles=no

./repotools-jts.sh -addTables

./repotools-jts.sh -upgradeWarehouse

Rufen Sie für ein Upgrade der Konfigurationsdateien von Change and Configuration Management das Verzeichnis CCM4.0-Installationsverzeichnis/server auf und führen Sie die folgenden Befehle aus:

Das Standardkontextstammverzeichnis der Anwendung ist jazz. Falls Ihr Upgradepfad bei Version 3.x beginnt, verwenden Sie den Befehl mit dem Schalter applicationContextRoot=ccm.

repotools-ccm.bat -migration_ccm_updateConfigurationFiles oldApplicationHome=CCM3.0.1-Installationsverzeichnis/server/conf ignoreJTSVersionCheck applicationContextRoot=ccm

repotools-ccm.bat -addTables

repotools-ccm.bat -migration_ccm_updateConfigurationFiles oldApplicationHome=CCM3.0.1-Installationsverzeichnis/server/conf ignoreJTSVersionCheck applicationContextRoot=ccm updateTomcatFiles=no

repotools-ccm.bat -addTables

./repotools-ccm.sh -migration_ccm_updateConfigurationFiles oldApplicationHome=CCM3.0.1-Installationsverzeichnis/server/conf ignoreJTSVersionCheck applicationContextRoot=ccm

./repotools-ccm.sh -addTables

./repotools-ccm.sh -migration_ccm_updateConfigurationFiles oldApplicationHome=CCM3.0.1-Installationsverzeichnis/server/conf ignoreJTSVersionCheck applicationContextRoot=ccm updateTomcatFiles=no

./repotools-ccm.sh -addTables

Rufen Sie für ein Upgrade der Konfigurationsdateien von Quality Management das Verzeichnis QM4.0-Installationsverzeichnis/server auf und führen Sie die folgenden Befehle aus:

Das Standardkontextstammverzeichnis der Anwendung ist jazz. Falls Ihr Upgradepfad bei Version 3.x beginnt, verwenden Sie den Befehl mit dem Schalter applicationContextRoot=qm.

repotools-qm.bat -migration_qm_updateConfigurationFiles oldApplicationHome=QM3.0.1-Installationsverzeichnis/server/conf ignoreJTSVersionCheck applicationContextRoot=qm

repotools-qm.bat -addTables

repotools-qm.bat -migration_qm_updateConfigurationFiles oldApplicationHome=QM3.0.1-Installationsverzeichnis/server/conf ignoreJTSVersionCheck applicationContextRoot=qm updateTomcatFiles=no

repotools-qm.bat -addTables

./repotools-qm.sh -migration_qm_updateConfigurationFiles oldApplicationHome=QM3.0.1-Installationsverzeichnis/server/conf ignoreJTSVersionCheck applicationContextRoot=qm

./repotools-qm.sh -addTables

./repotools-qm.sh -migration_qm_updateConfigurationFiles oldApplicationHome=QM3.0.1-Installationsverzeichnis/server/conf ignoreJTSVersionCheck applicationContextRoot=qm updateTomcatFiles=no

./repotools-qm.sh -addTables

Führen Sie für ein Upgrade der Konfigurationsdateien von Requirements Management die folgenden Schritte aus:

  1. Starten Sie die physische Maschine, auf der die alte Version und Version 4.0 der Anwendung Requirements Management installiert sind.
  2. Kopieren Sie den Inhalt der Verzeichnisse RM4.0-Installationsverzeichnis/server und RM3.0.1-Installationsverzeichnis/server in zwei unterschiedliche Verzeichnisse auf einem tragbaren Laufwerk.
  3. Starten Sie die physische Maschine, auf der Jazz Team Server 4.0 installiert ist, und kopieren Sie den Inhalt des tragbaren Laufwerks in ein temporäres Verzeichnis. Sie sollten für jede RM-Version ein Verzeichnis haben, z. B. C:\Temp\RM4.0 und C:\Temp\RM3.0.1.
  4. Öffnen Sie eine Eingabeaufforderung und rufen Sie das Verzeichnis C:\Temp\RM4.0\server auf. Führen Sie dann den folgenden Befehl aus:

    upgrade\rm\rm_upgrade.bat -oldApplicationHome C:\Temp\RM3.0.1\server\conf -oldJTSHome JTS3.0.1-Installationsverzeichnis\server\conf -newJTSHome JTS4.0-Installationsverzeichnis\server\conf applicationContextRoot=rm

    Das Standardkontextstammverzeichnis der Anwendung ist rdm. Falls Ihr Upgradepfad bei Version 3.x beginnt, verwenden Sie den Befehl mit dem Schalter applicationContextRoot=rm.

  5. Wenn das Upgrade auf der JTS-Maschine abgeschlossen ist, kopieren Sie den Inhalt von C:\Temp\RM4.0 auf ein tragbares Laufwerk.
  6. Starten Sie die physische Maschine, auf der die Anwendung Requirements Management installiert ist, und fügen Sie den Inhalt des tragbaren Laufwerks in das Verzeichnis RM4.0-Installationsverzeichnis/server ein. Dabei überschreiben Sie den bereits vorhandenen Inhalt.
  1. Starten Sie die physische Maschine, auf der die alte Version und Version 4.0 der Anwendung Requirements Management installiert sind.
  2. Kopieren Sie den Inhalt der Verzeichnisse RM4.0-Installationsverzeichnis/server und RM3.0.1-Installationsverzeichnis/server in zwei unterschiedliche Verzeichnisse auf einem tragbaren Laufwerk.
  3. Starten Sie die physische Maschine, auf der Jazz Team Server 4.0 installiert ist, und kopieren Sie den Inhalt des tragbaren Laufwerks in ein temporäres Verzeichnis. Sie sollten für jede RM-Version ein Verzeichnis haben, z. B. C:\Temp\RM4.0 und C:\Temp\RM3.0.1.
  4. Öffnen Sie eine Eingabeaufforderung und rufen Sie das Verzeichnis C:\Temp\RM4.0\server auf. Führen Sie dann den folgenden Befehl aus:

    upgrade\rm\rm_upgrade.bat -oldApplicationHome C:\Temp\RM3.0.1\server\conf -oldJTSHome JTS3.0.1-Installationsverzeichnis\server\conf -newJTSHome JTS4.0-Installationsverzeichnis\server\conf -updateTomcatFiles=no applicationContextRoot=rm

    Das Standardkontextstammverzeichnis der Anwendung ist rdm. Falls Ihr Upgradepfad bei Version 3.x beginnt, verwenden Sie den Befehl mit dem Schalter applicationContextRoot=rm.

  5. Wenn das Upgrade auf der JTS-Maschine abgeschlossen ist, kopieren Sie den Inhalt von C:\Temp\RM4.0 auf ein tragbares Laufwerk.
  6. Starten Sie die physische Maschine, auf der die Anwendung Requirements Management installiert ist, und fügen Sie den Inhalt des tragbaren Laufwerks in das Verzeichnis RM4.0-Installationsverzeichnis/server ein. Dabei überschreiben Sie den bereits vorhandenen Inhalt.
  1. Starten Sie die physische Maschine, auf der die alte Version und Version 4.0 der Anwendung Requirements Management installiert sind.
  2. Kopieren Sie den Inhalt der Verzeichnisse RM4.0-Installationsverzeichnis/server und RM3.0.1-Installationsverzeichnis/server in zwei unterschiedliche Verzeichnisse auf einem tragbaren Laufwerk.
  3. Starten Sie die physische Maschine, auf der Jazz Team Server 4.0 installiert ist, und kopieren Sie den Inhalt des tragbaren Laufwerks in ein temporäres Verzeichnis. Sie sollten für jede RM-Version ein Verzeichnis haben, z. B. opt/tmp/rm4.0 und opt/tmp/rm3.0.1.
  4. Öffnen Sie eine Befehls-Shell und rufen Sie das Verzeichnis opt/tmp/rm4.0/server auf. Führen Sie dann den folgenden Befehl aus:

    upgrade/rm/rm_upgrade.sh -oldApplicationHome opt/tmp/rm3.0.1/server/conf -oldJTSHome JTS3.0.1-Installationsverzeichnis/server/conf -newJTSHome JTS4.0-Installationsverzeichnis/server/conf applicationContextRoot=rm

    Das Standardkontextstammverzeichnis der Anwendung ist rdm. Falls Ihr Upgradepfad bei Version 3.x beginnt, verwenden Sie den Befehl mit dem Schalter applicationContextRoot=rm.

  5. Wenn das Upgrade auf der JTS-Maschine abgeschlossen ist, kopieren Sie den Inhalt von opt/tmp/rm4.0 auf ein tragbares Laufwerk.
  6. Starten Sie die physische Maschine, auf der die Anwendung Requirements Management installiert ist, und fügen Sie den Inhalt des tragbaren Laufwerks in das Verzeichnis RM4.0-Installationsverzeichnis/server ein. Dabei überschreiben Sie den bereits vorhandenen Inhalt.
  1. Starten Sie die physische Maschine, auf der die alte Version und Version 4.0 der Anwendung Requirements Management installiert sind.
  2. Kopieren Sie den Inhalt der Verzeichnisse RM4.0-Installationsverzeichnis/server und RM3.0.1-Installationsverzeichnis/server in zwei unterschiedliche Verzeichnisse auf einem tragbaren Laufwerk.
  3. Starten Sie die physische Maschine, auf der Jazz Team Server 4.0 installiert ist, und kopieren Sie den Inhalt des tragbaren Laufwerks in ein temporäres Verzeichnis. Sie sollten für jede RM-Version ein Verzeichnis haben, z. B. opt/tmp/rm4.0 und opt/tmp/rm3.0.1.
  4. Öffnen Sie eine Befehls-Shell und rufen Sie das Verzeichnis opt/tmp/rm4.0/server auf. Führen Sie dann den folgenden Befehl aus:

    upgrade/rm/rm_upgrade.sh -oldApplicationHome opt/tmp/rm3.0.1/server/conf -oldJTSHome JTS3.0.1-Installationsverzeichnis/server/conf -newJTSHome JTS4.0-Installationsverzeichnis/server/conf -updateTomcatFiles=no applicationContextRoot=rm

    Das Standardkontextstammverzeichnis der Anwendung ist rdm. Falls Ihr Upgradepfad bei Version 3.x beginnt, verwenden Sie den Befehl mit dem Schalter applicationContextRoot=rm.

  5. Wenn das Upgrade auf der JTS-Maschine abgeschlossen ist, kopieren Sie den Inhalt von opt/tmp/rm4.0 auf ein tragbares Laufwerk.
  6. Starten Sie die physische Maschine, auf der die Anwendung Requirements Management installiert ist, und fügen Sie den Inhalt des tragbaren Laufwerks in das Verzeichnis RM4.0-Installationsverzeichnis/server ein. Dabei überschreiben Sie den bereits vorhandenen Inhalt.

Die obigen Befehle führen folgende Aktionen aus:

  • Sie aktualisieren die Datei teamserver.properties von Version 4.0 ausgehend von den Informationen in der Datei von Version 3.0.1.
  • Sie fügen Tabellen zur Datenbank hinzu.
  • Sie aktualisieren das Data-Warehouse-Schema.
  • Sie kopieren den Inhalt der Tomcat-Datei users.xml.

    Beachten Sie: Dies gilt nur für die Tomcat-Benutzerdatenbank. Die Datei tomcat-users.xml wird kopiert (und nicht mit der vorhandenen Datei zusammengeführt). Wenn Sie ein Upgrade für mehrere CLM-Anwendungen mit einem gemeinsamen JTS durchführen, müssen Sie die Benutzer- und Gruppeninformationen in der Datei tomcat-users.xml manuell zusammenführen. Wenn die Benutzer in verschiedenen Anwendungen zu unterschiedlichen Gruppen gehören, unterscheiden sich die Benutzer- und Gruppeninformationen. Benutzer A könnte in CCM beispielsweise die Rolle JazzAdmins und in QM die Rolle JazzUsers haben. Es kann auch sein, dass Benutzer in der einen Anwendung vorhanden sind, jedoch nicht in der anderen. Diese müssen dann manuell zur Datei tomcat-users.xml hinzugefügt werden.

  • Sie nehmen den Inhalt der Dateien server.xml und web.xml von Version 3.0.1 in die entsprechenden Dateien von Version 4 auf.
  • Sie kopieren den Inhalt der Datei fronting.properties von Version 3.0.1 in Version 4.
  • Sie kopieren den Inhalt der Datei friendsconfig.rdf von Version 3.0.1 in Version 4.

Weitere Informationen zu diesen Repository-Tools-Befehlen finden Sie in folgenden Artikeln:

Upgrade-Script ausführen

Wichtiger Hinweis: Die Script-Datei befindet sich im Verzeichnis upgrade/Kontextstammverzeichnis der Anwendung, muss jedoch im Verzeichnis 'server' ausgeführt werden. Falls Ihr Pfadname Leerzeichen enthält, müssen Sie ihn in Anführungszeichen setzen.

Hinweis: Wenn Sie das Upgrade-Script in einer verteilten Umgebung verwenden möchten, in der Sie die CLM-Anwendung getrennt vom Jazz Team Server installieren, muss das Upgrade-Script auf das Laufwerk oder Dateisystem mit der installierten Anwendung zugreifen können. Unter Windows muss das Laufwerk beispielsweise in dieser Form angehängt werden: mounted Laufwerksbuchstabe:\server\conf. Ein absoluter Pfad wie \\Maschinenname\JTS4.0-Installationsverzeichnis\server\conf funktioniert nicht. Das angehängte Laufwerk muss mit Lese-, Schreib- und Ausführungsrechten für den Administratoraccount konfiguriert sein.

Öffnen Sie für ein Upgrade von Jazz Team Server eine Eingabeaufforderung, rufen Sie das Verzeichnis JTS-4.0-Installationsverzeichnis\server auf und führen Sie den folgenden Befehl aus:

upgrade\jts\jts_upgrade.bat

upgrade\jts\jts_upgrade.bat -oldJTSHome JTS-3.0.1-Installationsverzeichnis\server\conf

Während des Upgrades wird nach Zusammenführung der Konfigurationsdateien ein Editorfenster geöffnet, in dem Sie die Datei teamserver.properties von Jazz Team Server prüfen können. Falls die Positionseigenschaft com.ibm.team.fulltext.indexlocation auf einen relativen Pfad gesetzt ist, müssen Sie diesen nicht ändern. Ist die Position als absoluter Pfad angegeben, müssen Sie sicherstellen, dass es sich um ein stabiles Verzeichnis handelt, das bei einer Deinstallation nicht gelöscht wird. Ein absoluter Pfad zu einer stabilen Position sollte so aussehen: com.ibm.team.fulltext.indexLocation=JTS-4.0-Installationsverzeichnis/server/conf/jts/indices/workitemindex. Hier steht JTS-4.0-Installationsverzeichnis für das Verzeichnis, in dem Jazz Team Server 4.0 installiert ist.

Öffnen Sie für ein Upgrade von Change and Configuration Management eine Eingabeaufforderung, rufen Sie das Verzeichnis CCM-4.0-Installationsverzeichnis\server auf und führen Sie den folgenden Befehl aus:

upgrade\ccm\ccm_upgrade.bat -oldApplicationHome CCM-3.0.1-Installationsverzeichnis\server\conf

upgrade\ccm\ccm_upgrade.bat -oldApplicationHome CCM-3.0.1-Installationsverzeichnis\server\conf -newJTSHome JTS-4.0-Installationsverzeichnis\server\conf

Während des Upgrades wird nach Zusammenführung der Konfigurationsdateien ein Editorfenster geöffnet, in dem Sie die Datei teamserver.properties von Change and Configuration Management prüfen können. Ist die Position als absoluter Pfad angegeben, müssen Sie sicherstellen, dass es sich um ein stabiles Verzeichnis handelt, das bei einer Deinstallation nicht gelöscht wird. Ein absoluter Pfad zu einer stabilen Position sollte so aussehen: com.ibm.team.fulltext.indexLocation=CCM-4.0-Installationsverzeichnis/server/conf/ccm/indices/workitemindex. Hier steht CCM-4.0-Installationsverzeichnis für das Verzeichnis, in dem die Anwendung Change and Configuration Management 4.0 installiert ist.

Öffnen Sie für ein Upgrade der Anwendung Quality Management eine Eingabeaufforderung, rufen Sie das Verzeichnis QM-4.0-Installationsverzeichnis\server auf und führen Sie den folgenden Befehl aus:

upgrade\qm\qm_upgrade.bat -oldApplicationHome QM-3.0.1-Installationsverzeichnis\server\conf

upgrade\qm\qm_upgrade.bat -oldApplicationHome QM-3.0.1-Installationsverzeichnis\server\conf -newJTSHome JTS-4.0-Installationsverzeichnis\server\conf

Während des Upgrades wird nach Zusammenführung der Konfigurationsdateien ein Editorfenster geöffnet, in dem Sie die Datei teamserver.properties von Quality Management prüfen können. Ist die Position als absoluter Pfad angegeben, müssen Sie sicherstellen, dass es sich um ein stabiles Verzeichnis handelt, das bei einer Deinstallation nicht gelöscht wird. Ein absoluter Pfad zu einer stabilen Position sollte so aussehen: com.ibm.team.fulltext.indexLocation=QM-4.0-Installationsverzeichnis/server/conf/qm/indices/workitemindex. Hier steht QM-4.0-Installationsverzeichnis für das Verzeichnis, in dem die Anwendung Quality Management 4.0 installiert ist.

Öffnen Sie für ein Upgrade der Anwendung Requirements Management eine Eingabeaufforderung, rufen Sie das Verzeichnis RM-4.0-Installationsverzeichnis\server auf und führen Sie den folgenden Befehl aus:

upgrade\rm\rm_upgrade.bat -oldApplicationHome RM-3.0.1-Installationsverzeichnis\server\conf

upgrade\rm\rm_upgrade.bat -oldApplicationHome RM-3.0.1-Installationsverzeichnis\server\conf -newJTSHome JTS-4.0-Installationsverzeichnis\server\conf -oldJTSHome JTS-3.0.1-Installationsverzeichnis\server\conf

Öffnen Sie für ein Upgrade von Jazz Team Server eine Befehls-Shell, rufen Sie das Verzeichnis JTS-4.0-Installationsverzeichnis/server auf und führen Sie den folgenden Befehl aus:

upgrade/jts/jts_upgrade.sh

upgrade/jts/jts_upgrade.sh -oldJTSHome JTS-3.0.1-Installationsverzeichnis/server/conf

Während des Upgrades wird nach Zusammenführung der Konfigurationsdateien der Editor vi geöffnet, in dem Sie die Datei teamserver.properties von Jazz Team Server prüfen können. Ist die Position als absoluter Pfad angegeben, müssen Sie sicherstellen, dass es sich um ein stabiles Verzeichnis handelt, das bei einer Deinstallation nicht gelöscht wird. Ein absoluter Pfad zu einer stabilen Position sollte so aussehen: com.ibm.team.fulltext.indexLocation=JTS-4.0-Installationsverzeichnis/server/conf/jts/indices/workitemindex. Hier steht JTS-4.0-Installationsverzeichnis für das Verzeichnis, in dem Jazz Team Server 4.0 installiert ist.

Öffnen Sie für ein Upgrade von Change and Configuration Management eine Befehls-Shell, rufen Sie das Verzeichnis CCM-4.0-Installationsverzeichnis/server auf und führen Sie den folgenden Befehl aus:

upgrade/ccm/ccm_upgrade.sh -oldApplicationHome CCM-3.0.1-Installationsverzeichnis/server/conf

upgrade/ccm/ccm_upgrade.sh -oldApplicationHome CCM-3.0.1-Installationsverzeichnis/server/conf -newJTSHome JTS-4.0-Installationsverzeichnis/server/conf

Während des Upgrades wird nach Zusammenführung der Konfigurationsdateien der Editor vi geöffnet, in dem Sie die Datei teamserver.properties von Change and Configuration Management prüfen können. Ist die Position als absoluter Pfad angegeben, müssen Sie sicherstellen, dass es sich um ein stabiles Verzeichnis handelt, das bei einer Deinstallation nicht gelöscht wird. Ein absoluter Pfad zu einer stabilen Position sollte so aussehen: com.ibm.team.fulltext.indexLocation=CCM-4.0-Installationsverzeichnis/server/conf/ccm/indices/workitemindex. Hier steht CCM-4.0-Installationsverzeichnis für das Verzeichnis, in dem die Anwendung Change and Configuration Management 4.0 installiert ist.

Öffnen Sie für ein Upgrade der Anwendung Quality Management eine Befehls-Shell, rufen Sie das Verzeichnis QM-4.0-Installationsverzeichnis/server auf und führen Sie den folgenden Befehl aus:

upgrade/qm/qm_upgrade.sh -oldApplicationHome QM-3.0.1-Installationsverzeichnis/server/conf

upgrade/qm/qm_upgrade.sh -oldApplicationHome QM-3.0.1-Installationsverzeichnis/server/conf -newJTSHome JTS-4.0-Installationsverzeichnis/server/conf

Während des Upgrades wird nach Zusammenführung der Konfigurationsdateien der Editor vi geöffnet, in dem Sie die Datei teamserver.properties von Quality Management prüfen können. Ist die Position als absoluter Pfad angegeben, müssen Sie sicherstellen, dass es sich um ein stabiles Verzeichnis handelt, das bei einer Deinstallation nicht gelöscht wird. Ein absoluter Pfad zu einer stabilen Position sollte so aussehen: com.ibm.team.fulltext.indexLocation=QM-4.0-Installationsverzeichnis/server/conf/qm/indices/workitemindex. Hier steht QM-4.0-Installationsverzeichnis für das Verzeichnis, in dem die Anwendung Quality Management 4.0 installiert ist.

Öffnen Sie für ein Upgrade der Anwendung Requirements Management eine Befehls-Shell, rufen Sie das Verzeichnis RM-4.0-Installationsverzeichnis/server auf und führen Sie den folgenden Befehl aus:

upgrade/rm/rm_upgrade.sh -oldApplicationHome RM-3.0.1-Installationsverzeichnis/server/conf

upgrade/rm/rm_upgrade.sh -oldApplicationHome RM-3.0.1-Installationsverzeichnis/server/conf -newJTSHome JTS-4.0-Installationsverzeichnis/server/conf -oldJTSHome JTS-3.0.1-Installationsverzeichnis/server/conf

Öffnen Sie für ein Upgrade von Jazz Team Server eine Eingabeaufforderung, rufen Sie das Verzeichnis JTS-4.0-Installationsverzeichnis\server auf und führen Sie den folgenden Befehl aus:

upgrade\jts\jts_upgrade.bat -updateTomcatFiles=no

upgrade\jts\jts_upgrade.bat -oldJTSHome JTS-3.0.1-Installationsverzeichnis\server\conf -updateTomcatFiles=no

Während des Upgrades wird nach Zusammenführung der Konfigurationsdateien ein Editorfenster geöffnet, in dem Sie die Datei teamserver.properties von Jazz Team Server prüfen können. Falls die Positionseigenschaft com.ibm.team.fulltext.indexlocation auf einen relativen Pfad gesetzt ist, müssen Sie diesen durch einen absoluten Pfad ersetzen und sicherstellen, dass das Verzeichnisse stabil ist und bei einer Deinstallation nicht gelöscht wird. Ein Beispiel für ein instabiles Verzeichnis ist das 3.0.1-Installationsverzeichnis, das deinstalliert werden könnte. In dem Fall würden Sie Ihre Indexdateien verlieren. Ein absoluter Pfad zu einer stabilen Position sollte so aussehen: com.ibm.team.fulltext.indexLocation=JTS-4.0-Installationsverzeichnis/server/conf/jts/indices/workitemindex. Hier steht JTS-4.0-Installationsverzeichnis für das Verzeichnis, in dem Jazz Team Server 4.0 installiert ist.

Öffnen Sie für ein Upgrade von Change and Configuration Management eine Eingabeaufforderung, rufen Sie das Verzeichnis CCM-4.0-Installationsverzeichnis\server auf und führen Sie den folgenden Befehl aus:

upgrade\ccm\ccm_upgrade.bat -oldApplicationHome CCM-3.0.1-Installationsverzeichnis\server\conf -updateTomcatFiles=no

upgrade\ccm\ccm_upgrade.bat -oldApplicationHome CCM-3.0.1-Installationsverzeichnis\server\conf -newJTSHome JTS-4.0-Installationsverzeichnis\server\conf -updateTomcatFiles=no

Während des Upgrades wird nach Zusammenführung der Konfigurationsdateien ein Editorfenster geöffnet, in dem Sie die Datei teamserver.properties der Anwendung Change and Configuration Management prüfen können. Falls die Positionseigenschaft com.ibm.team.fulltext.indexlocation auf einen relativen Pfad gesetzt ist, müssen Sie diesen durch einen absoluten Pfad ersetzen und sicherstellen, dass das Verzeichnisse stabil ist und bei einer Deinstallation nicht gelöscht wird. Ein Beispiel für ein instabiles Verzeichnis ist das 3.0.1-Installationsverzeichnis, das deinstalliert werden könnte. In dem Fall würden Sie Ihre Indexdateien verlieren. Ein absoluter Pfad zu einer stabilen Position sollte so aussehen: com.ibm.team.fulltext.indexLocation=CCM-4.0-Installationsverzeichnis/server/conf/ccm/indices/workitemindex. Hier steht CCM-4.0-Installationsverzeichnis für das Verzeichnis, in dem die Anwendung Change and Configuration Management 4.0 installiert ist.

Öffnen Sie für ein Upgrade der Anwendung Quality Management eine Eingabeaufforderung, rufen Sie das Verzeichnis QM-4.0-Installationsverzeichnis\server auf und führen Sie den folgenden Befehl aus:

upgrade\qm\qm_upgrade.bat -oldApplicationHome QM-3.0.1-Installationsverzeichnis\server\conf -updateTomcatFiles=no

upgrade\qm\qm_upgrade.bat -oldApplicationHome QM-3.0.1-Installationsverzeichnis\server\conf -newJTSHome JTS-4.0-Installationsverzeichnis\server\conf -updateTomcatFiles=no

Während des Upgrades wird nach Zusammenführung der Konfigurationsdateien ein Editorfenster geöffnet, in dem Sie die Datei teamserver.properties der Anwendung Quality Management prüfen können. Falls die Positionseigenschaft com.ibm.team.fulltext.indexlocation auf einen relativen Pfad gesetzt ist, müssen Sie diesen durch einen absoluten Pfad ersetzen und sicherstellen, dass das Verzeichnisse stabil ist und bei einer Deinstallation nicht gelöscht wird. Ein Beispiel für ein instabiles Verzeichnis ist das 3.0.1-Installationsverzeichnis, das deinstalliert werden könnte. In dem Fall würden Sie Ihre Indexdateien verlieren. Ein absoluter Pfad zu einer stabilen Position sollte so aussehen: com.ibm.team.fulltext.indexLocation=QM-4.0-Installationsverzeichnis/server/conf/qm/indices/workitemindex. Hier steht QM-4.0-Installationsverzeichnis für das Verzeichnis, in dem die Anwendung Quality Management 4.0 installiert ist.

Öffnen Sie für ein Upgrade der Anwendung Requirements Management eine Eingabeaufforderung, rufen Sie das Verzeichnis RM4.0-Installationsverzeichnis\server auf und führen Sie den folgenden Befehl aus:

upgrade\rm\rm_upgrade.bat -oldApplicationHome RM-3.0.1-Installationsverzeichnis\server\conf -updateTomcatFiles=no

upgrade\rm\rm_upgrade.bat -oldApplicationHome RM-3.0.1-Installationsverzeichnis\server\conf -newJTSHome JTS-4.0-Installationsverzeichnis\server\conf -oldJTSHome JTS-3.0.1-Installationsverzeichnis\server\conf -updateTomcatFiles=no

Öffnen Sie für ein Upgrade von Jazz Team Server eine Befehls-Shell, rufen Sie das Verzeichnis JTS-4.0-Installationsverzeichnis/server auf und führen Sie den folgenden Befehl aus:

upgrade/jts/jts_upgrade.sh -updateTomcatFiles=no

upgrade/jts/jts_upgrade.sh -oldJTSHome JTS-3.0.1-Installationsverzeichnis/server/conf -updateTomcatFiles=no

Während des Upgrades wird nach Zusammenführung der Konfigurationsdateien der Editor vi geöffnet, in dem Sie die Datei teamserver.properties von Jazz Team Server prüfen können. Falls die Positionseigenschaft com.ibm.team.fulltext.indexlocation auf einen relativen Pfad gesetzt ist, müssen Sie diesen durch einen absoluten Pfad ersetzen und sicherstellen, dass das Verzeichnisse stabil ist und bei einer Deinstallation nicht gelöscht wird. Ein Beispiel für ein instabiles Verzeichnis ist das 3.0.1-Installationsverzeichnis, das deinstalliert werden könnte. In dem Fall würden Sie Ihre Indexdateien verlieren. Ein absoluter Pfad zu einer stabilen Position sollte so aussehen: com.ibm.team.fulltext.indexLocation=JTS-4.0-Installationsverzeichnis/server/conf/jts/indices/workitemindex. Hier steht JTS-4.0-Installationsverzeichnis für das Verzeichnis, in dem Jazz Team Server 4.0 installiert ist.

Öffnen Sie für ein Upgrade von Change and Configuration Management eine Befehls-Shell, rufen Sie das Verzeichnis CCM4.0-Installationsverzeichnis/server auf und führen Sie den folgenden Befehl aus:

upgrade/ccm/ccm_upgrade.sh -oldApplicationHome CCM-3.0.1-Installationsverzeichnis/server/conf -updateTomcatFiles=no

upgrade/ccm/ccm_upgrade.sh -oldApplicationHome CCM-3.0.1-Installationsverzeichnis/server/conf -newJTSHome JTS-4.0-Installationsverzeichnis/server/conf -updateTomcatFiles=no

Während des Upgrades wird nach Zusammenführung der Konfigurationsdateien der Editor vi geöffnet, in dem Sie die Datei teamserver.properties der Anwendung Change and Configuration Management prüfen können. Falls die Positionseigenschaft com.ibm.team.fulltext.indexlocation auf einen relativen Pfad gesetzt ist, müssen Sie diesen durch einen absoluten Pfad ersetzen und sicherstellen, dass das Verzeichnisse stabil ist und bei einer Deinstallation nicht gelöscht wird. Ein Beispiel für ein instabiles Verzeichnis ist das 3.0.1-Installationsverzeichnis, das deinstalliert werden könnte. In dem Fall würden Sie Ihre Indexdateien verlieren. Ein absoluter Pfad zu einer stabilen Position sollte so aussehen: com.ibm.team.fulltext.indexLocation=CCM-4.0-Installationsverzeichnis/server/conf/ccm/indices/workitemindex. Hier steht CCM-4.0-Installationsverzeichnis für das Verzeichnis, in dem die Anwendung Change and Configuration Management 4.0 installiert ist.

Öffnen Sie für ein Upgrade der Anwendung Quality Management eine Befehls-Shell, rufen Sie das Verzeichnis QM-4.0-Installationsverzeichnis/server auf und führen Sie den folgenden Befehl aus:

upgrade/qm/qm_upgrade.sh -oldApplicationHome QM-3.0.1-Installationsverzeichnis/server/conf -updateTomcatFiles=no

upgrade/qm/qm_upgrade.sh -oldApplicationHome QM-3.0.1-Installationsverzeichnis/server/conf -newJTSHome JTS-4.0-Installationsverzeichnis/server/conf -updateTomcatFiles=no

Während des Upgrades wird nach Zusammenführung der Konfigurationsdateien der Editor vi geöffnet, in dem Sie die Datei teamserver.properties der Anwendung Quality Management prüfen können. Falls die Positionseigenschaft com.ibm.team.fulltext.indexlocation auf einen relativen Pfad gesetzt ist, müssen Sie diesen durch einen absoluten Pfad ersetzen und sicherstellen, dass das Verzeichnisse stabil ist und bei einer Deinstallation nicht gelöscht wird. Ein Beispiel für ein instabiles Verzeichnis ist das 3.0.1-Installationsverzeichnis, das deinstalliert werden könnte. In dem Fall würden Sie Ihre Indexdateien verlieren. Ein absoluter Pfad zu einer stabilen Position sollte so aussehen: com.ibm.team.fulltext.indexLocation=QM-4.0-Installationsverzeichnis/server/conf/qm/indices/workitemindex. Hier steht QM-4.0-Installationsverzeichnis für das Verzeichnis, in dem die Anwendung Quality Management 4.0 installiert ist.

Öffnen Sie für ein Upgrade der Anwendung Requirements Management eine Befehls-Shell, rufen Sie das Verzeichnis RM-4.0-Installationsverzeichnis/server auf und führen Sie den folgenden Befehl aus:

upgrade/rm/rm_upgrade.sh -oldApplicationHome RM-3.0.1-Installationsverzeichnis/server/conf -updateTomcatFiles=no

upgrade/rm/rm_upgrade.sh -oldApplicationHome RM-3.0.1-Installationsverzeichnis/server/conf -newJTSHome JTS-4.0-Installationsverzeichnis/server/conf -oldJTSHome JTS-3.0.1-Installationsverzeichnis/server/conf -updateTomcatFiles=no

Das obige Script aktualisiert mit Repository-Tools-Befehlen die Konfigurationsdateien und Datenbanken sowie die Data-Warehouse-Schemata und bringt sie auf den Stand von Version 4.0. Weitere Informationen hierzu enthält der Artikel Upgrade-Script-Dateien.

Upgrade-Script unter IBM i ausführen

  1. Melden Sie sich bei IBM i mit einer Benutzer-ID an, die die Berechtigung QSECOFR hat.
  2. Navigieren Sie in QShell zum Installationsverzeichnis von Jazz Team Server 4.0 (/QIBM/UserData/JazzTeamServer40/server).
  3. Geben Sie für ein Upgrade von Jazz Team Server den folgenden Befehl ein:

    upgrade/jts/jts_upgrade.sh -oldJTSHome /QIBM/UserData/JazzTeamServer301/server/conf -oldJTSVersion 3.0.1

  4. Geben Sie für ein Upgrade der Anwendung Change and Configuration Management den folgenden Befehl ein:

    upgrade/ccm/ccm_upgrade.sh -oldApplicationHome /QIBM/UserData/JazzTeamServer301/server/conf -oldApplicationVersion 3.0.1 -ignoreJTSVersionCheck

  5. Geben Sie für ein Upgrade der Anwendung Quality Management den folgenden Befehl ein:

    upgrade/qm/qm_upgrade.sh -oldApplicationHome /QIBM/UserData/JazzTeamServer301/server/conf -oldApplicationVersion 3.0.1 -ignoreJTSVersionCheck

  6. Geben Sie für ein Upgrade der Anwendung Requirements Management den folgenden Befehl ein:

    upgrade/rm/rm_upgrade.sh -oldApplicationHome /QIBM/UserData/JazzTeamServer301/server/conf -oldApplicationVersion 3.0.1 -ignoreJTSVersionCheck

  7. Führen Sie den folgenden Befehl aus, um den WebSphere Application Server von Version 3.01 zu aktualisieren und die WAR-Dateien für CLM 4.0 zu implementieren. Das Script erstellt außerdem eine Sicherung, aktualisiert die JVM-Einstellungen und die Einstellungen der Umgebungsvariablen, löscht die temporären Verzeichnisse und startet den Server neu.

     

    upgrade/was_upgrade.sh profileName serverName nodeName wasVersion wasOption maxHeapSize adminId adminPwd jvmVersion jazzAppName jtsAppName clmHelpAppName qmAppName rmAppName adminAppName

    Hierbei gilt Folgendes:

    • profileName ist der Name des Profils von Version 3.0.1.
    • serverName ist der Servername von Version 3.0.1.
    • nodeName ist der Name des Serverknotens von Version 3.0.1.
    • wasVersion ist die Version von WebSphere Application Server (Version 7 oder 8).
    • wasOption ist die WebSphere-Application-Server-Option (Base, ND oder Express), die Sie für Jazz Team Server 3.0.1 unter IBM i ausgewählt haben.
    • maxHeapSize ist die maximal benötigte Heap-Speichergröße für den Anwendungsserver.
    • adminId und adminPwd sind die ID und das Kennwort, mit denen Sie WebSphere Application Server unter IBM i schützen.
    • jvmVersion ist die Version der Java Virtual Machine (std64 für Version 6 Release 1 / Version 7 Release 1).
    • jazzAppName ist der Name der Anwendung Change and Configuration Management.
    • jtsAppName ist der Name von Jazz Team Server.
    • qmAppName ist der Name der Anwendung Quality Management.
    • rmAppName ist der Name der Anwendung Requirements Management.
    • clmHelpAppName ist der Name der CLM-Hilfeanwendung.
    • adminAppName ist der Name der Anwendung Lifecycle Project Administration.

Indexdateien kopieren

Wichtiger Hinweis: Führen Sie diese Schritte NUR aus, wenn die Position der Indexdateien in den Dateien teamserver.properties durch relative Pfade angegeben sind oder durch absolute Pfade, die jedoch zu instabilen Verzeichnissen führen. Ein Beispiel für ein instabiles Verzeichnis ist das 3.0.1-Installationsverzeichnis, das deinstalliert werden könnte. In dem Fall würden Sie Ihre Indexdateien verlieren.

Kopieren Sie Ihre JFS-Indizes bzw. Textindizes von Version 3.0.1 in Version 4.0. Bei verteilten Systemen müssen Sie die Dateien vom entsprechenden Server kopieren.

  1. Öffnen Sie eine Eingabeaufforderung und geben Sie den folgenden Befehl ein, um das Standardverzeichnis mit den Indizes der Version 4.0 zu bereinigen:
  2. Del /s /f JTS-4.0-Installationsverzeichnis\server\conf\jts\indices
    Del /s /f CCM-4.0-Installationsverzeichnis\server\conf\ccm\indices
    Del /s /f QM-4.0-Installationsverzeichnis\server\conf\qm\indices
    rm -rf JTS-4.0-Installationsverzeichnis/server/conf/jts/indices
    rm -rf CCM-4.0-Installationsverzeichnis/server/conf/ccm/indices
    rm -rf QM-4.0-Installationsverzeichnis/server/conf/qm/indices
  3. Öffnen Sie eine Eingabeaufforderung und geben Sie den folgenden Befehl ein, um die Indizes von Version 3.0.1 in Version 4.0 zu kopieren.
  4. copy JTS-3.0.1-Installationsverzeichnis\server\conf\jts\indices JTS-4.0-Installationsverzeichnis\server\conf\jts\indices
    copy CCM-3.0.1-Installationsverzeichnis\server\conf\ccm\indices CCM-4.0-Installationsverzeichnis\server\conf\ccm\indices
    copy QM-3.0.1-Installationsverzeichnis\server\conf\qm\indices QM-4.0-Installationsverzeichnis\server\conf\qm\indices
    cp -R JTS-3.0.1-Installationsverzeichnis/server/conf/jts/indices JTS-4.0-Installationsverzeichnis/server/conf/jts/indices
    cp -R CCM-3.0.1-Installationsverzeichnis/server/conf/ccm/indices CCM-4.0-Installationsverzeichnis/server/conf/ccm/indices
    cp -R QM-3.0.1-Installationsverzeichnis/server/conf/qm/indices QM-4.0-Installationsverzeichnis/server/conf/qm/indices

Führen Sie die folgenden Schritte aus, um Ihre JFS-Indizes bzw. Textindizes von Version 3.0.1 in Version 4.0 zu kopieren. Bei verteilten Systemen müssen Sie die Dateien vom entsprechenden Server kopieren.

  1. Öffnen Sie eine Eingabeaufforderung und geben Sie den folgenden Befehl ein, um das Standardverzeichnis mit den Indizes der Version 4.0 zu bereinigen:
  2. Del /s /f JTS-4.0-Installationsverzeichnis\server\conf\jts\indices
    Del /s /f CCM-4.0-Installationsverzeichnis\server\conf\ccm\indices
    Del /s /f QM-4.0-Installationsverzeichnis\server\conf\qm\indices
    rm -rf JTS-4.0-Installationsverzeichnis/server/conf/jts/indices
    rm -rf CCM-4.0-Installationsverzeichnis/server/conf/ccm/indices
    rm -rf QM-4.0-Installationsverzeichnis/server/conf/qm/indices
  3. Öffnen Sie die Datei teamserver.properties jeder Anwendung und suchen Sie nach com.ibm.team.fulltext.indexlocation.
  4. Zeigt die Eigenschaft com.ibm.team.fulltext.indexlocation auf einen relativen Pfad, z. B. mit com.ibm.team.fulltext.indexLocation=conf/ccm/indices/workitemindex, ist die Position der Volltextindizes eine Position bezogen auf das WebSphere-Application-Server-Profil für die Anwendungen, z. B. WAS-Installationsverzeichnis/IBM/WebSphere/AppServer/profiles/Appsrv01. Ersetzen Sie diesen relativen Pfad in der Datei teamserver.properties der CLM-4.0-Anwendung durch einen absoluten Pfad zu einer stabilen Position. Hier ein Beispiel für einen absoluten Pfad zu einer stabilen Position: com.ibm.team.fulltext.indexLocation=4.0-Installationsverzeichnis/server/conf/ccm/indices/workitemindex (wobei 4.0-Installationsverzeichnis für die Installationsposition der CLM-4.0-Anwendung steht). Öffnen Sie eine Eingabeaufforderung und geben Sie den folgenden Befehl ein, um die Volltextindizes von Version 3.0.1 in Version 4.0 zu kopieren.
  5. copy WAS-Profilverzeichnis\conf\jts\indices JTS-4.0-Installationsverzeichnis\server\conf\jts\indices
    copy WAS-Profilverzeichnis\conf\ccm\indices CCM-4.0-Installationsverzeichnis\server\conf\ccm\indices
    copy WAS-Profilverzeichnis\conf\qm\indices QM-4.0-Installationsverzeichnis\server\conf\qm\indices
    cp -R WAS-Profilverzeichnis/conf/jts/indices JTS-4.0-Installationsverzeichnis/server/conf/jts/indices
    cp -R WAS-Profilverzeichnis/conf/ccm/indices CCM-4.0-Installationsverzeichnis/server/conf/ccm/indices
    cp -R WAS-Profilverzeichnis/conf/qm/indices QM-4.0-Installationsverzeichnis/server/conf/qm/indices
  6. Wenn die Eigenschaft com.ibm.team.fulltext.indexlocation auf einen instabilen absoluten Pfade gesetzt ist, z. B. auf das 3.0.1-Installationsverzeichnis, das deinstalliert und gelöscht werden kann, ersetzen Sie den Wert durch einen absoluten Pfad zu einer stabilen Position. Hier ein Beispiel für einen absoluten Pfad zu einer stabilen Position: com.ibm.team.fulltext.indexLocation=4.0-Installationsverzeichnis/server/conf/ccm/indices/workitemindex (wobei 4.0-Installationsverzeichnis für die Installationsposition der CLM-4.0-Anwendung steht). Öffnen Sie eine Eingabeaufforderung und geben Sie den folgenden Befehl ein, um die Volltextindizes von Version 3.0.1 in Version 4.0 zu kopieren.
  7. copy JTS-3.0.1-Installationsverzeichnis\server\conf\jts\indices 4.0-Installationsverzeichnis\server\conf\jts\indices
    copy CCM-3.0.1-Installationsverzeichnis\server\conf\ccm\indices 4.0-Installationsverzeichnis\server\conf\ccm\indices
    copy QM-3.0.1-Installationsverzeichnis\server\conf\qm\indices 4.0-Installationsverzeichnis\server\conf\qm\indices
    cp -R JTS-3.0.1-Installationsverzeichnis/server/conf/jts/indices 4.0-Installationsverzeichnis/server/conf/jts/indices
    cp -R CCM-3.0.1-Installationsverzeichnis/server/conf/ccm/indices 4.0-Installationsverzeichnis/server/conf/ccm/indices
    cp -R QM-3.0.1-Installationsverzeichnis/server/conf/qm/indices 4.0-Installationsverzeichnis/server/conf/qm/indices
  8. Öffnen Sie eine Eingabeaufforderung und geben Sie den folgenden Befehl ein, um die JFS-Indizes von Version 3.0.1 in Version 4.0 zu kopieren.
  9. copy JTS-3.0.1-Installationsverzeichnis\server\conf\jts\indices JTS-4.0-Installationsverzeichnis\server\conf\jts\indices
    copy CCM-3.0.1-Installationsverzeichnis\server\conf\ccm\indices CCM-4.0-Installationsverzeichnis\server\conf\ccm\indices
    copy QM-3.0.1-Installationsverzeichnis\server\conf\qm\indices QM-4.0-Installationsverzeichnis\server\conf\qm\indices
    cp -R JTS-3.0.1-Installationsverzeichnis/server/conf/jts/indices JTS-4.0-Installationsverzeichnis/server/conf/jts/indices
    cp -R CCM-3.0.1-Installationsverzeichnis/server/conf/ccm/indices CCM-4.0-Installationsverzeichnis/server/conf/ccm/indices
    cp -R QM-3.0.1-Installationsverzeichnis/server/conf/qm/indices QM-4.0-Installationsverzeichnis/server/conf/qm/indices

WebSphere Application Server starten

Führen Sie die folgenden Schritte auf jedem Anwendungsserver aus, um WebSphere Application Server zu starten:

Hinweis: Vergewissern Sie sich, dass Ihre JDBC-Umgebungsvariable umgestellt ist und jetzt auf den JDBC-Treiber der JRE6 zeigt. Weitere Informationen hierzu enthält der Artikel Oracle-Datenbank konfigurieren.

Hinweis: Vergewissern Sie sich, dass Ihre JDBC-Umgebungsvariable umgestellt ist und jetzt auf den JDBC-Treiber der JRE6 zeigt. Weitere Informationen hierzu enthält der Artikel SQL-Server-Datenbank einrichten.

  1. Öffnen Sie eine Eingabeaufforderung und rufen Sie das Verzeichnis WAS-Profilstammverzeichnis\bin auf.
  2. Geben Sie den folgenden Befehl ein:
  3. startServer.bat server1 -user Benutzer-ID_des_Administrators -password Administratorkennwort

  1. Öffnen Sie eine Eingabeaufforderung und rufen Sie das Verzeichnis WAS-Profilstammverzeichnis/bin auf.
  2. Geben Sie den folgenden Befehl ein:
  3. ./startServer.sh server1 -user Benutzer-ID_des_Administrators -password Administratorkennwort

WAR-Dateien von Version 4.0 in WebSphere Application Server implementieren

Führen Sie die folgenden Schritte auf jedem Anwendungsserver aus, um die WAR-Dateien der Anwendungen der Version 4.0 zu implementieren:

Hinweis: Wenn Sie die CLM-Anwendungen mit IBM Installation Manager installiert haben und während der Installation die Markierung im Kontrollkästchen für Tomcat Application Server 7 gelöscht haben, werden die Webanwendungsdateien (.war) standardmäßig in das Verzeichnis Jazz-Installationsverzeichnis/server/webapps kopiert. Falls Sie während der Installation Tomcat Application Server 7 ausgewählt hatten, werden die Webanwendungsdateien (.war) in das Verzeichnis Jazz-Installationsverzeichnis/server/tomcat/webapps kopiert.

  1. Melden Sie sich bei der Integrated Solutions Console von WebSphere Application Server unter https://hostname.example.com:9043/ibm/console/logon.jsp an.
  2. Klicken Sie auf Anwendungen > Anwendungstypen > WebSphere-Unternehmensanwendungen.
  3. Installieren Sie die folgenden Webanwendungsdateien:
    • jts_war
    • ccm_war
    • qm_war
    • rm_war
    • converter_war
    • clmhelp_war
    • admin_war
  4. Ordnen Sie den folgenden Anwendungen die entsprechenden Sicherheitsrollen zu:
    • jts_war
    • ccm_war
    • qm_war

Ausführliche Informationen enthält der Artikel CLM-Anwendungen in WebSphere Application Server implementieren.

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

Anwendungen starten

Rufen Sie die Seite 'Unternehmensanwendungen' auf und starten Sie die folgenden Anwendungen:
Melden Sie sich auf jedem Anwendungsserver bei der Integrated Solutions Console an und starten Sie die folgenden Anwendungen:
  • jts_war
  • ccm_war
  • qm_war
  • rm_war
  • converter_war
  • admin_war
  • clmhelp_war

Server starten

Hinweis: Vergewissern Sie sich, dass Ihre JDBC-Umgebungsvariable umgestellt ist und jetzt auf den JDBC-Treiber der JRE6 zeigt. Weitere Informationen hierzu enthält der Artikel Oracle-Datenbank konfigurieren.

Hinweis: Vergewissern Sie sich, dass Ihre JDBC-Umgebungsvariable umgestellt ist und jetzt auf den JDBC-Treiber der JRE6 zeigt. Weitere Informationen hierzu enthält der Artikel SQL-Server-Datenbank einrichten.

Starten Sie alle Anwendungsserver der Version 4.0.

  1. Öffnen Sie eine Eingabeaufforderung und rufen Sie das Verzeichnis 4.0-Installationsverzeichnis\server auf.
  2. Geben Sie den folgenden Befehl ein:
  3. server.startup.bat

  1. Öffnen Sie eine Eingabeaufforderung und rufen Sie das Verzeichnis 4.0-Installationsverzeichnis/server auf.
  2. Geben Sie den folgenden Befehl ein:
  3. ./server.startup.sh

Testlizenz aktivieren oder Lizenzen für Version 4 installieren

Sie müssen neue Lizenzen für Version 4.0 kaufen. Lizenzen für Version 4 sind mit Anwendungen der Version 3 kompatibel. Anwendungen der Version 4 können jedoch nicht mit Lizenzen für Version 3 verwendet werden. Installieren Sie für Version 4.0 Floating-Lizenzen, Token-Lizenzen oder Lizenzen für die Einzelinstallation berechtigter Benutzer als Entsprechungen der Lizenzen, die Sie in Version 3 verwendet haben. Ihre Lizenzvereinbarungen für Benutzerlizenzen von Version 3 gelten während der Installation der Lizenzen von Version 4 weiter.

Falls Sie noch keine Lizenzen für Version 4 gekauft haben, können Sie Testlizenzen aktivieren und diese für eine begrenzte Zeit verwenden. Gehen Sie zum Aktivieren von Testlizenzen wie folgt vor:

  1. Melden Sie sich als Administrator beim Jazz Team Server 4.0 an. https://host.example.com:9443/jts/admin
  2. Klicken Sie auf Server > Lizenzschlüsselverwaltung.
  3. Klicken Sie auf Test aktivieren, um Testlizenzen zu aktivieren.

Hinweis: Wenn Sie eine Testlizenz vor Ausführung des folgenden Schritts (Migration für Rational Requirements Composer durchführen) verwenden, müssen Sie die Testlizenz dem Benutzer mit Administratorberechtigung zuweisen, der das Upgrade für RRC durchführt.

Weitere Informationen zu Lizenzen enthält der Artikel Lizenzen verwalten.

Migration für Rational Requirements Composer durchführen

Hinweis: Das Upgrade von Requirements Composer auf Version 4.0 versetzt Jazz Team Server zwischen dem Neustart der Anwendung Requirements Composer und dem Abschluss des Onlinemigrationsassistenten in den Lesezugriffsmodus.

  1. Öffnen Sie Ihren Browser, löschen Sie den Browsercache und navigieren Sie zum Webclient von Requirements Composer. Geben Sie den Servernamen und den Port im folgenden URL an: https://hostname.example.com:Port/rm/web/projects/migration. Der Standard-Port ist 9443. Die Seite erkennt, dass eine Migration durchgeführt wird und startet den Migrationsassistenten.
  2. Akzeptieren Sie für Rational Requirements Composer die Clientzugriffslizenz für Analysten.
  3. Klicken Sie auf Anzeige 'Upgradeservice' öffnen. Klicken Sie dann im Upgradeassistenten auf Weiter, um mit dem Upgrade für Rational Requirements Composer zu beginnen. Auf der Migrationswebseite erhält der Administrator Statusinformationen, sodass er während des Upgrades sehen kann, welcher Speicherbereich gerade verarbeitet wird und wann mit der Indexierung begonnen wurde.

    Wichtiger Hinweis: Ein einmal gestartetes Upgrade kann nicht abgebrochen werden. Es läuft bis zum Abschluss durch.

  4. Nach dem Upgrade werden die Daten von Rational Requirements Composer neu indexiert.
  5. Wenn der neue Index erstellt ist, führt die Anwendung Gültigkeits- und Konsistenzprüfungen für die migrierten Daten durch und gibt dem Administrator Rückmeldungen. Die Nachricht "Upgrade abgeschlossen" wird angezeigt. Klicken Sie auf Schließen. Sie werden zur Anwendung Rational Requirements Composer weitergeleitet.
  6. Initialisieren Sie nach dem Serverstart den Publish Service unter https://[hostname.example.com]:9443/[Kontextstammverzeichnis der Anwendung]/publish/initialize.

Data Warehouse konfigurieren

Falls Sie das Data Warehouse in Version 3.0.1 Ihrer CLM-Installation nicht konfiguriert haben und dies in Version 4.0 nachholen möchten, führen Sie die folgenden Schritte aus:

  1. Erstellen Sie eine Datenbank, die als Data Warehouse verwendet werden soll. Weitere Informationen hierzu enthält der Artikel Datenbank einrichten.
  2. Führen Sie den Setup-Assistenten aus. Überspringen Sie die Schritte, bis Sie zur Konfiguration des Data Warehouse gelangen. Weitere Informationen hierzu enthält der Artikel Data Warehouse konfigurieren.

    Hinweis: Für den Server der Version 4.0 müssen Sie den Setup-Assistenten nicht ausführen. Er wird nur zum Konfigurieren des Data Warehouse benötigt, sofern Sie diesen Schritt in CLM 3.0.1 noch nicht ausgeführt haben.

Checkliste für Verifizierung

Nutzen Sie die folgende Checkliste, um nach dem Upgradeprozess festzustellen, ob alle Schritte fehlerfrei ausgeführt wurden.

  Überprüfungsaufgabe Weitere Informationen
Verifizieren, dass die folgenden Anwendungskonfigurationsdateien von Version 3.0.1 in Version 4.0 kopiert wurden:
  • Jazz Team Server: [4.0-Installationsverzeichnis]/server/conf/jts/teamserver.properties
  • Anwendung Change and Configuration Management: [4.0-Installationsverzeichnis]/server/conf/ccm/teamserver.properties
  • Anwendung Quality Management: [4.0-Installationsverzeichnis]/server/conf/qm/teamserver.properties
  • Anwendung Lifecycle Project Administration: [4.0-Installationsverzeichnis]/server/conf/admin/admin.properties
  • Anwendung Lifecycle Project Administration: [4.0-Installationsverzeichnis]/server/conf/admin/friends.rdf
  • Anwendung Requirements Management: [4.0-Installationsverzeichnis]/server/conf/rm/friendsconfig.rdf
  • Anwendung Requirements Management: [4.0-Installationsverzeichnis]/server/conf/rm/fronting.properties
 
Verifizieren, dass jede Datei teamserver.properties die folgenden Informationen enthält:
  • Aus teamserver.properties der Version 3.0.1 kopierte Eigenschaften
  • Gültiger, eindeutiger öffentlicher URL com.ibm.team.repository.server.webapp.url (Der URL für Version 4 der Anwendung muss mit dem in Version 3 verwendeten übereinstimmen.)
  • Gültige db.vendor-Einträge für den Datenbankanbieter (Stellen Sie sicher, dass die in /conf/jts/teamserver.properties angegebene Datenbank vorhanden ist.)
 
Anwendungsserver überprüfen:
  • Verifizieren Sie, dass [4.0-Installationsverzeichnis]/server/tomcat/conf/tomcat-users.xml die Informationen aus Version 3.0.1 enthält.
  • Falls Sie eine LDAP-Registry nutzen oder die HTTPS-Authentifizierung bzw. die Formularauthentifizierung inaktiviert haben, verifizieren Sie, dass [4.0-Installationsverzeichnis]/server/tomcat/conf/server.xml folgende Codefragmente enthält:

    <Realm className="org.apache.catalina.realm.JNDIRealm"
    ...>
    </Realm>

    Diese Codefragmente dürfen nicht enthalten sein:

    Realm className="org.apache.catalina.realm.UserDatabaseRealm"
    resourceName="UserDatabase"
    ...>
    </Realm>

    Hinweis: Falls Sie in der Datei [3.0.1-Installationsverzeichnis]/server/tomcat/conf/server.xml weitere Einstellungen angepasst hatten, verifizieren Sie, dass diese in die Datei [4.0-Installationsverzeichnis]/server/tomcat/conf/server.xml kopiert wurden.

  • Verifizieren Sie, dass die Datei web.xml die richtigen Tags <security-role> enthält:
    • Jazz Team Server: [4.0-Installationsverzeichnis]/server/tomcat/webapps/jts/WEB-INF/web.xml
    • Anwendung Change and Configuration Management: [4.0-Installationsverzeichnis]/server/tomcat/webapps/ccm/WEB-INF/web.xml
    • Anwendung Quality Management: [4.0-Installationsverzeichnis]/server/tomcat/webapps/qm/WEB-INF/web.xml
    • Anwendung Requirements Management: [4.0-Installationsverzeichnis]/server/tomcat/webapps/rm/WEB-INF/web.xml
    • Anwendung Lifecycle Project Administration: [4.0-Installationsverzeichnis]/server/tomcat/webapps/admin/WEB-INF/web.xml
  • Vergewissern Sie sich, dass die folgenden Anwendungen implementiert sind und gestartet wurden:
    • jts.war
    • ccm.war
    • qm.war
    • rm.war
    • converter.war
    • admin.war
    • clmhelp.war
Server implementieren und starten
Serverprotokolle überprüfen: Überprüfen Sie, ob die folgenden Serverprotokolle die Informationen zum Upgradeabschluss enthalten:
  • Wenn Sie einen Tomcat-Server verwenden, befinden sich die Protokolldateien im Verzeichnis [4.0-Installationsverzeichnis]/server/logs.
  • Wenn Sie WebSphere Application Server verwenden, befinden sich die Protokolldateien im Verzeichnis [WAS-Installationsverzeichnis]/profiles/AppSrv01/logs.
 
Öffentliche URLs verifizieren: Falls Sie ein Upgrade für die Anwendung Jazz Team Server, Change and Configuration Management oder Quality Management durchgeführt haben, überprüfen Sie, ob der öffentliche URL auf der Seite mit der Statuszusammenfassung mit dem der Vorversion übereinstimmt.  
Links auf der Jazz-Team-Server-Webschnittstelle für Administration überprüfen: Öffnen Sie einen Webbrowser und rufen Sie die Seite 'Verwaltung' von Jazz Team Server auf (https://[hostname.example.com]:9443/jts/admin). Es dürfen keine Fehler angezeigt werden. Jazz-Team-Server-Webschnittstelle für Administration
Links auf der Webschnittstelle für Anwendungsverwaltung überprüfen: Öffnen Sie einen Webbrowser und rufen Sie die Seite 'Verwaltung' der Anwendung auf (https://[hostname.example.com]:9443/[Kontextstammverzeichnis der Anwendung]/admin). Es dürfen keine Fehler angezeigt werden. Webschnittstelle für Anwendungsverwaltung
Benutzer, Lizenzen und Linkartefakte überprüfen:
  • Benutzer und Lizenzen überprüfen
  • Verlinkte Artefakte prüfen
  • Webclient überprüfen
  • Indexierung mit Suchfunktion verifizieren
  • Eclipse-Client oder Visual-Studio-Client von Rational Team Concert überprüfen
Benutzer, Lizenzen und Linkartefakte überprüfen

Integration anderer Produkte

Rational Developer für System z

Rational Developer für System z wird in Rational Team Concert für System z integriert, um den z/OS-Entwicklern eine integrierte Entwicklungsumgebung für die Onlinezusammenarbeit bereitzustellen. Diese integrierte Lösung kombiniert die Vorteile einer individuellen Entwicklungsumgebung von Rational Developer für System z mit Funktionen für die Kooperation im Team von Rational Team Concert. Weitere Informationen enthält der Artikel Rational Team Concert und Rational Developer für System z.


Rational ClearQuest

Rational Team Concert umfasst einige Tools, die Sie bei der Integration Ihrer Arbeit aus Rational ClearQuest unterstützen (Rational ClearQuest Synchronizer, Rational ClearQuest Bridge und Rational ClearQuest Importer). Weitere Informationen enthält der Artikel Rational Team Concert und Rational ClearQuest.

Sie können mit dem ClearQuest Synchronizer (früher ClearQuest Connector) das Defect-Überwachungssystem von Rational ClearQuest in Rational Quality Manager integrieren. Weitere Informationen enthält der Artikel Rational Quality Manager und Rational ClearQuest.

Sie können Rational ClearQuest in Rational Requirements Composer integrieren und die Anwendungen so konfigurieren, dass Anforderungen mit Defects, Aufgaben, Verbesserungsvorschlägen und anderen Datensatztypen verknüpft werden können. Weitere Informationen enthält der Artikel Rational Requirements Composer und Rational ClearQuest.


Rational ClearCase

In Rational Team Concert gibt es ClearCase Connectors, die Interaktionen von Rational Team Concert und Rational ClearCase unterstützen. Weitere Informationen enthält der Artikel Rational Team Concert und Rational ClearCase.


Rational Build Forge

Wenn Sie Rational Team Concert in Kombination mit Rational Build Forge einsetzen, können Sie Rational-Build-Forge-Build-Steuerkomponenten und -Build-Definitionen erstellen und Ihre Build-Forge-Projekte integrieren. Weitere Informationen enthält der Artikel Rational Team Concert und Rational Build Forge.


Hudson

Wenn Sie Rational Team Concert mit Hudson kombinieren, können Sie Hudson-Build-Steuerkomponenten und -Build-Definitionen erstellen und Ihre Hudson-Projekte integrieren. Weitere Informationen enthält der Artikel Rational Team Concert und Hudson.


Subversion

Rational Team Concert bietet verschiedene Möglichkeiten für die Zusammenarbeit von Teams, die sowohl Subversion als auch die Quellcodeverwaltung von Rational Team Concert einsetzen. Weitere Informationen enthält der Artikel Rational Team Concert und Subversion.


Rational DOORS

Mit Rational DOORS können Sie Ihre Anforderungen verwalten, und mit der Arbeitselementfunktion von Rational Team Concert können Sie diese Anforderungen dann der Änderungsüberwachung unterstellen. Weitere Informationen enthält der Artikel Rational Team Concert und Rational DOORS.

Sie können Rational DOORS in Rational Quality Manager integrieren, um Anforderungen aus Rational DOORS mit Testplänen oder Testfällen verknüpfen und überwachen zu können. Weitere Informationen enthält der Artikel Rational Quality Manager und Rational DOORS.


Rational Focal Point

Mit Rational Focal Point können Sie Geschäftsanforderungen erfassen, priorisieren und dann als Projekt in Rational Team Concert exportieren. Weitere Informationen enthält der Artikel Rational Team Concert und Rational Focal Point.


Lotus Connections

Zum Lieferumfang von Rational Team Concert gehört Lotus Connections. Mit Lotus Connections können Sie Ressourcen und Artefakte aus Change and Configuration Management mit Ressourcen und Artefakten der Lotus-Connections-Community verbinden. Weitere Informationen enthält der Artikel Rational Team Concert und Lotus Connections.


Rational Developer für Power-Systems-Software

Rational Team Concert kann in Kombination mit Rational Developer für Power-Systems-Software eingesetzt werden, um Entwicklern unter IBM i eine integrierte Umgebung für die kooperative Anwendungsentwicklung bereitzustellen. Diese integrierte Lösung macht die Teamkooperationsfunktionen von Rational Team Concert für die individuelle Entwicklungsumgebung von Rational Developer für Power-Systems-Software verfügbar. Weitere Informationen hierzu enthält der Artikel Rational Team Concert und Rational Developer für Power-Systems-Software.


Rational RequisitePro

Bei kombiniertem Einsatz von Rational Quality Manager und Rational RequisitePro können Sie Anforderungsansichten und -pakete aus Rational RequisitePro zu Testplänen in der Anwendung Quality Management hinzufügen. Weitere Informationen enthält der Artikel Rational Quality Manager und Rational RequisitePro.


Rational Change

Mit der API OSLC-CM (Open Services for Lifecycle Collaboration Change Management) von IBM Rational Change können Sie neue Änderungsanfragen übergeben und diese auf der Webschnittstelle von Quality Management direkt mit Ausführungsergebnissen verlinken. Weitere Informationen enthält der Artikel Rational Quality Manager und Rational Change.


Rational-Testtools

Mit Rational Quality Manager können Sie automatisierte Tests ausführen, die sich auf Ihren Testlabormaschinen oder an gemeinsam genutzten Netzpositionen befinden. Weitere Informationen enthält der Artikel Rational Quality Manager und Rational-Testtools.


Selenium

Die Integration von Selenium wird über einen JUnit-Selenium-Adapter implementiert, mit dem Sie in der Anwendung Quality Management JUnit4-Tests mit dem Selenium Version 2.0 WebDriver ausführen können. Weitere Informationen enthält der Artikel Rational Quality Manager und Selenium.


Tools für Softwarebestand und Automation

In Rational Quality Manager können Sie Tools für Softwarebestand und Automation integrieren, z. B. Rational Build Forge und die Testing Automation Framework Execution Engine (STAX) des Software Testing Automation Framework (STAF). Weitere Informationen enthält der Artikel Rational Quality Manager und Tools für Softwarebestand und Automation.


Rational Software Architect Design Manager

Wichtiger Hinweis: Das Designmanagement ist als Beta-Funktionalität anzusehen und nur für Bewertungszwecke bestimmt. Weitere Informationen hierzu enthält der Artikel Design Management project auf jazz.net.

Sie können IBM® Rational® Software Architect Design Manager in die Anwendungen Requirements Management (RM) und Change and Configuration Management (CCM) der Rational-Lösung für Collaborative Lifecycle Management (CLM) integrieren. Über diese Integration haben Sie die Möglichkeit, Designmodelle und Modellressourcen mit Anforderungen, anforderungsbezogenen Artefakten, Arbeitselementen und anderen Entwicklungsartefakten zu verlinken. Weitere Informationen enthält der Artikel Rational Requirements Composer und Rational Software Architect Design Manager.