Rational® Team Concert-Client mit IBM Installation Manager installieren


Diese Version wurde am 20 Nov 2009 erstellt.

Die neueste Version dieses Installationsverfahrens und die dazugehörigen Planungsinformationen finden Sie online unter http://publib.boulder.ibm.com/infocenter/rtc/v2r0m0/index.jsp.

Contents

Client mit IBM Installation Manager installieren
Upgrade auf Rational Team Concert 2.0.0.2 durchführen
Rational Team Concert mit Security-Enhanced Linux installieren

Client mit IBM Installation Manager installieren

Der Client wird als Downloaddatei über IBM® Installation Manager verteilt.

Warum und wann dieser Vorgang ausgeführt wird

Note:
Wenn Sie den Client in einer vorhandenen Eclipse-Arbeitsumgebung installieren möchten, verwenden Sie hierzu IBM Installation Manager. Sie werden von IBM Installation Manager aufgefordert, die Arbeitsumgebung anzugeben, die Sie erweitern möchten. Außerdem werden von Installation Manager zukünftige Aktualisierungen, Rollbacks und Änderungen der Arbeitsumgebung verwaltet.
Note:
Wenn Security-Enhanced Linux® (SELinux) aktiviert ist, müssen Sie es inaktivieren oder den Sicherheitskontext der JREs (Java Runtime Environments) ändern, um die Textverlagerung zu ermöglichen, damit Rational Team Concert installiert und ausgeführt werden kann. Weitere Informationen hierzu finden Sie in Rational Team Concert mit Security-Enhanced Linux installieren.

  1. Laden Sie eines der folgenden Installationspakete herunter.

    Der Client von Rational Team Concert™ kann auf drei Arten installiert werden.

  2. Starten Sie das Launchpadprogramm.

    Wenn Installation Manager noch nicht ausgeführt wird, führen Sie die folgenden Schritte aus, um das Programm zu starten.

    Note:
    Sie müssen über Administratorrechte verfügen, um das Launchpadprogramm auszuführen.
    Note:
    Die Linux-Befehle zum Starten des Launchpadprogramms gelten lediglich für Rational Team Concert für Eclipse-IDE.
    Gehen Sie wie folgt vor, um die Launchpadprogrammdatei zu starten:
  3. Sie können die folgenden Clients installieren: Der Assistent Installation Manager wird anschließend angezeigt. Der Assistent führt Sie durch den Prozess der Installation des Clients.
  4. Starten Sie den Client durch Klicken auf die Verknüpfung von Rational Team Concert, die im Verlauf der Installation erstellt wurde.
  5. Stellen Sie eine Verbindung zum Server her. Der einfachste Weg zur Herstellung einer Verbindung zu einem Server ist eine Teameinladung. Wenn Sie nicht über eine Einladung verfügen, können Sie die Verbindung manuell herstellen.
    1. Klicken Sie auf Datei -> Teameinladung annehmen. Der Assistent führt Sie durch den Prozess.
      Note:
      Wenn Sie nicht über eine Einladung verfügen, benötigen Sie die URI oder die URL von Ihrem Serveradministrator. (Beispielformat: https://example.com:9443/jazz). Klicken Sie auf den Hyperlink Verbindung zu einem vorhandenen Projektbereich herstellen, der in der rechten unteren Ecke des Fensters Teameinladung akzeptieren angezeigt wird.
    2. Gehen Sie gemäß der Anweisungen im Assistenten vor, um die Verbindung aufzubauen.

Beispiel

Fehlerbehebung: Nachfolgend werden einige Verfahren zur Fehlerbehebung eventuell auftretender Probleme erläutert.

Nächste Maßnahme

Nachdem Sie den Client erfolgreich installiert haben, informieren Sie sich in den folgenden Abschnitten über die ersten Schritte mit Rational Team Concert.

Upgrade auf Rational Team Concert 2.0.0.2 durchführen

Im allgemeinen können Sie ein Upgrade der Clients und Server von Rational Team Concert durchführen, indem Sie eine komprimierte Datei ausführen oder eine Installation mit IBM Installation Manager durchführen.

Note:
Wenn Sie IBM Installation Manager zum Installieren von Rational Team Concert 2.0.0.2 auf einem Computer verwenden, auf dem Rational Team Concert momentan nicht installiert ist, fordert Sie Installation Manager dazu auf, die zu installierenden Sprachen auszuwählen. Wenn Sie jedoch ein Update von einer vorherigen Version auf 2.0.0.2 durchführen wollen, nimmt IBM Installation Manager an, dass Sie die aktuellen Sprachen verwenden wollen und fordert daher nicht zur Auswahl von Sprachen auf. Im weitere Sprachen nach dem Update auf 2.0.0.2 auszuwählen, wählen Sie Ändern in der Hauptanzeige von IBM Installation Manager und anschließend die entsprechende Option aus. In der nächsten Anzeige werden die unterstützten Sprachen aufgelistet. Wählen Sie die Sprachen aus, die Sie benötigen.

Wenn Sie den Jazz™-Team-Server nach der Aktualisierung auf Version 2.0.0.2 starten, müssen Sie den Server wie folgt zurücksetzen, bevor Sie Ändern auswählen, um Sprachen hinzuzufügen oder zu ändern:

  1. Navigieren Sie in einem Web-Browser zu
    https://<server-host>:<jazz-port>/jazz/admin?internal#action=com.ibm.team.repository.admin.serverReset
  2. Klicken Sie auf Request Server Reset.
  3. Fahren Sie den Server herunter.

Anschließend können Sie Ändern in IBM Installation Manager auswählen, um Sprachen hinzuzufügen oder zu entfernen.

Kompatibilität von Rational Team Concert-Clients und Servern

Die folgende Tabelle zeigt die Kompatibilität von Rational Team Concert-Clientversionen mit Jazz-Team-Server-Versionen an.

Table 1. Client- und Serverkompatibilität
Rational Team Concert - Clientversion Kompatible Jazz-Team-Server-Version
1.0.x für Eclipse 0.6.x
2.0.x für Eclipse 1.0.x
2.0.0.0 für Microsoft Visual Studio 1.0.0.0
2.0.x für Microsoft Visual Studio 1.0.x

Rational Team Concert-Client für Eclipse-IDE aktualisieren

Wenn Sie über Version 1.0, 1.0.1 oder 1.0.1.1 des Clients für die Eclipse-IDE verfügen, müssen Sie einen Client der Version 2.0.x beschaffen, um eine Verbindung zu einem Server der neuen Version 2.0 herstellen zu können. Sie können diese mithilfe einer komprimierten Datei installieren oder frühere IBM Installation Manager-Installationen aktualisieren.

Rational Team Concert-Client für Microsoft Visual Studio-IDE installieren

Wenn Sie über Version 1.0.1.1 des Clients für die Microsoft Visual Studio-IDE verfügen, müssen Sie einen Client der Version 2.0.x beschaffen, um eine Verbindung zu einem Server der neuen Version 2.0.x herstellen zu können.

Hinweis:
Für den Client für Microsoft Visual Studio wird keine komprimierte Datei bereitgestellt. Wenn Sie Version 2.0.x installieren oder ein Upgrade auf Version 2.0 durchführen möchten, müssen Sie hierzu IBM Installation Manager verwenden.

Server-Upgrade von Trial-Release oder Early Access-Release zu permanentem Release durchführen

Wenn Sie ein Early Access-Release von Rational Team Concert ausführen, führen Sie zuerst das Upgrade auf das Trial-Release 2.0.0.2 durch.

Vom Trial-Release 2.0.0.2 können Sie ein Upgrade auf ein permanentes Release durchführen, wenn Sie das Aktivierungskit für den Server für Ihre Edition erwerben, das unter der folgenden Adresse verfügbar ist: http://www.ibm.com/software/awdtools/rtc/. Das Aktivierungskit besteht aus einer JAR-Datei, in der der Schlüssel für das permanente Server-Release enthalten ist. Er wird auf der Seite 'Lizenzschlüsselverwaltung' der Verwaltungswebschnittstelle des Servers installiert.

Upgrade eines Servers von Version 1.0, 1.0.1, 1.0.1.1 oder 2.0 durchführen

Von vorherigen Releases können Sie ein direktes Upgrade auf Release 2.0.0.2 von Rational Team Concert durchführen. Für Aktualisierungen von Version 1.x auf Version 2.x ist eine Datenbankmigration erforderlich. Informationen zur Durchführung einer Datenbankmigration finden Sie in Jazz-Repository nach dem Upgrade des Jazz Team Servers migrieren.

Note:
Bevor Sie mit dem Upgrade von WebSphere® Application Server beginnen, setzen Sie den Server zurück, indem Sie zu https://{servername}:9443/jazz/admin#action=com.ibm.team.repository.admin.serverReset navigieren und Request Server Reset anklicken.

Wenn Sie Release 2.0 unter Verwendung einer komprimierten Datei installiert haben, gibt es keine Überschneidungen mit der früheren Installation. Sie können Release 2.0.0.2 mithilfe einer komprimierten Datei an einer neuen Position installieren oder mithilfe von IBM Installation Manager eine Instanz von Release 2.0 installieren.

Wenn Sie das vorhergehende Release unter Verwendung von IBM Installation Manager installiert haben, können Sie Release 2.0.0.2 entweder als separate Instanz installieren oder eine Aktualisierung der vorhergehenden Instanz auf 2.0.0.2 durchführen. Wenn Sie eine separate Instanz des Servers für Release 2.0.0.2 installieren, wählen Sie Neue Paketgruppe erstellen auf der Seite 'Pakete installieren' des Installationsassistenten aus.

Note:
Wenn Sie ein Upgrade von WebSphere Application Server-Implementierung von Jazz-Team-Server durchführen möchten, entfernen Sie die vorherige Datei 'jazz.war' und implementieren die Datei 'jazz.war' der Version 2.0.0.2.

Informationen zur Durchführung des Upgrades finden Sie in Erforderliche Konfigurationsdateien aus früheren Serverinstallationen kopieren und Aktivierungsschlüssel von Version 2.0.0.2 installieren.

Upgrade eines Servers von einer Edition von Rational Team Concert zu einer anderen durchführen

Sie können Upgrades zwischen den einzelnen Editionen von Rational Team Concert durchführen. Üblicherweise werden Upgrades von der Express-C Edition auf dieExpress™ Edition oder von der Express Edition auf die Standard Edition durchgeführt. Mithilfe desselben Prozesses können Sie auch in der gegenseitigen Richtung ein Downgrade durchführen.

Da die Datenbank Derby von allen Editionen von Rational Team Concert 2.0.0.2 unterstützt wird, müssen Sie keine Migration von Derby zu DB2® oder Oracle durchführen, wenn Sie ein Upgrade von 'Express-C' auf Express oder 'Standard' durchführen. Es wird empfohlen, zuerst die Serveredition zu migrieren, danach die reibungslose Funktion mit der vorhandenen Datenbank sicherzustellen und später die Datenbankmigration durchzuführen, sofern diese erforderlich ist. Beachten Sie, dass Derby-Datenbanken lediglich 10 Benutzer unterstützen. Informationen zur Durchführung einer Datenbankmigration finden Sie in Jazz-Repository nach dem Upgrade des Jazz Team Servers migrieren.

Wenn Sie Rational Team Concert Edition 2.0.0.2 installiert haben und ein Upgrade auf eine andere Edition durchführen möchten, laden Sie die neue Edition herunter und installieren sie neben der vorhandenen Edition. Anschließend kopieren Sie die erforderlichen Konfigurationsdateien zum Ausführen der neuen Edition. Im folgenden Abschnitt werden die erforderlichen Konfigurationsdateien erläutert.

Wenn Sie die frühere Edition unter Verwendung einer komprimierten Datei installiert haben, gibt es keine Überschneidungen mit der früheren Installation. Sie können die neue Edition mithilfe einer komprimierten Datei an einer neuen Position installieren oder die Installation von IBM Installation Manager für die neue Edition verwenden. Es wird empfohlen, IBM Installation Manager für Produktionsserver zu verwenden, damit Aktualisierungen in der Zukunft angewendet werden können.

Wenn Sie die frühere Serverinstallation mit Installation Manager durchgeführt haben und die neue Edition mit IBM Installation Manager installieren möchten, dürfen Sie während der neuen Installation mit IBM Installation Manager nicht die frühere Edition überschreiben. Wählen Sie auf der Seite Pakete installieren des Installationsassistenten die Option Neue Paketgruppe erstellen aus.

Somit wird die neue Edition an einer anderen Position installiert und die Programmverknüpfungen werden unter Verwendung des neuen Paketgruppennamens erstellt.

Wenn Sie diese Task nicht ausführen, wird die Installation aufgrund einer Dateikollision fehlschlagen. Dies ist der Fall, wenn der Fehlerdialog Installation fehlgeschlagen angezeigt wird und im Text die folgenden Details angezeigt werden:

Installation failed.
  Error during "install" phase:
    Failed to extract zip standard 1.0.1.I20081018-1820.  File
    D:\JazzTeamServer\server\license-update-site\site.xml already exists.

Wenn dies der Fall ist, ist dies kein echtes Problem. Sie können die Installation erneut starten und dann ordnungsgemäß eine neue Paketgruppe erstellen.

Konfigurationsaktualisierungen von WebSphere Application Server

Die folgenden Schritte sind erforderlich, um WebSphere Application Server in Rational Team Concert 2.0.0.2 ordnungsgemäß zu konfigurieren.

  1. Stellen Sie sicher, dass die neuesten Fixpacks für WAS und WASDK installiert sind. Eine wichtige Voraussetzung für die Implementierung von WAS 7.0 ist, dass mindestens WebSphere Application Server 7.0.0.3 installiert ist.
  2. Entfernen Sie die alten angepassten JVM-Eigenschaften:
    1. com.ibm.team.repository.provision.profile
    2. com.ibm.team.server.configURL
    3. log4j.configuration
  3. Fügen Sie die neue angepasste JVM-Eigenschafte JAZZ_HOME hinzu und stellen Sie den folgenden Wert ein:
    file:///<JazzInstallDir>/server/conf
  4. Sellen Sie sicher, dass die WAS-Sicherheitseinstellung 'Verfügbare Authentifizierungsdaten beim Zugriff auf einen ungeschützten URI verwenden' ausgewählt ist. Wenn Sie die WAS Integrated Solutions Console verwenden, können hierzu wie folgt vorgehen:
    1. Navigieren Sie zu 'Sicherheit' -> 'Sichere Verwaltung, Anwendungen und Infrastruktur' -> 'Websicherheit - Allgemeine Einstellungen'.
    2. Wählen Sie das Markierungsfeld für 'Verfügbare Authentifizierungsdaten beim Zugriff auf einen ungeschützten URI verwenden' aus.

Erforderliche Konfigurationsdateien aus früheren Serverinstallationen kopieren

Kopieren Sie die folgenden Dateien aus vom Quellenserver auf den Zielserver. Benennen Sie zuerst die Originaldateien der Installation auf dem Server um, auf dem das Upgrade durchgeführt wurde, um Sicherungen zu erstellen. Wenn Sie IBM Installation Manager für die Aktualisierung von Version 1.0, 1.0.1 oder 1.0.1.1 auf Version 2.0 oder 2.0.0.2 verwendet haben, wurde ein Sicherungsverzeichnis erstellt, in dem die Konfigurationsdateien der Versionen 1.0.x oder 2.0 enthalten sind; der Name dieses Verzeichnisses lautet zum Beispiel backup-config-timestamp und es befindet sich im Serverunterverzeichnis des Installationsverzeichnisses.

Wenn Sie ein Upgrade auf die Edition 'Standard' oder 'Enterprise' durchführen und das Clientaktivierungskit für Entwickler für die Edition Express erworben haben, erwerben und installieren Sie das Clientaktivierungskit für Entwickler für die Edition 'Standard' oder 'Enterprise', damit Sie diese Clientlizenzen verwenden können. Die Entwicklerlizenzzuordnungen sind zwar noch wirksam, die Entwicklerlizenzen werden aber erst aktiviert, wenn das korrekte Aktivierungskit installiert wird.

Aktivierungsschlüssel von Version 2.0.0.2 installieren

Von Release 2.0.0.2 werden die Aktivierungsschlüssel für Version 2.0.0.2 verwendet. Wenn für einen Server ein Upgrade von Version 1.0.x.x auf Version 2.0.x ausgeführt wird, wird die Testlizenz nach dem Upgrade zurückgesetzt und Sie müssen die Aktivierungsschlüssel für Version 2.0 oder 2.0.0.2 von IBM Rational License Key Center abrufen.

Weitere Informationen zu IBM Rational License Key Center finden Sie auf der Supportsite für die IBM Rational-Lizenzierung und dem zugehörigen technischen Tipp für jazz.net.

Nachfolgend werden die Namen der anwendbaren Schlüssel für jeden Kit aufgeführt:

Zeitachse für ein Projekt festlegen

In Rational Team Concert 1.x konnten Projekte über mehrere Zeitachsen verfügen (bisher wurde sie "Entwicklungslinien" genannt) und alle dieser Zeitachsen wurden als gleich betrachtet.

Auch in Rational Team Concert 2.0 können Projekte weiterhin über mehrere Zeitachsen verfügen, aber eine dieser Zeitachsen kann als "Projektzeitachse" markiert werden. Da die wichtigste Zeitachse des Projekts bei der Migration der Datenbank auf Version 2.0 nicht bekannt ist, wird für die Projekte keine Projektzeitachse eingestellt. Sie können die Projekte nach dem Upgrade auf Version 2.0 manuell aktualisieren, um die Projektzeitachse festzulegen.

Momentaufnahme der Quellcodeverwaltung konfigurieren

Die SCM-Momentaufnahme (SCM = Source Control Management) für das Data-Warehouse erfasst Daten in Datenströmen, einschließlich der Informationen zur Größe der Datenströme und der Aktivität (Änderungsset und Datei/Ordner ändern sich) darin. In Version 1.0 wurden von dieser Momentaufnahme automatisch alle Datenströme erfasst. Da dies ein aufwendiger Vorgang sein kann, wurden in Version 2.0 Optionen für die Konfigurierbarkeit zur SCM-Momentaufnahme hinzugefügt, damit der Benutzer entscheiden kann, für welche Datenströme die Daten erfasst werden sollen. Die unmittelbare Auswirkung dieser Änderung bedeutet, dass keine Daten erfasst werden, wenn Sie dies nicht ausdrücklich so konfigurieren.

Gehen Sie wie folgt vor, um eine SCM-Momentaufnahme zu konfigurieren:

  1. Sie müssen über Schreibberechtigungen für den Datenstrom verfügen, für den Sie Daten erfassen möchten.
  2. Wechseln Sie auf die Seite Berichte in der Webbenutzerschnittstelle.
  3. Wählen Sie im Navigationsfenster SCM-Momentaufnahme verwalten aus. Eine Liste der Datenströme wird angezeigt.
  4. Wählen Sie Markierungsfelder für mindestens einen Datenstrom aus und wählen Sie anschließend Änderungen speichern aus.

Daraufhin werden für die Daten aller ausgewählten Datenströme in allen folgenden Momentaufnahmen erfasst.

Inkompatible Änderungen an BIRT-Berichten

Wenn Sie die BIRT-Berichtsentwurfsfunktion zum Erstellen Ihrer eigenen Berichtsschablonen verwendet haben, können Sie Probleme auftreten, wenn Sie versuchen, diese Berichte in Version 2.0 zu verwenden. Beachten Sie dabei die folgenden Probleme:

Import der Arbeitselementdatein in das Data-Warehouse

In Rational Team Concert 2.0 gibt es mehrere Schemaänderungen an den Arbeitselementtabellen im Data-Warehouse. Aus diesem Grund werden bei der Migration von Version 1.0 auf Version 2.0 vom Importprogramm alle Arbeitselementdaten aus dem Data-Warehouse ignoriert. Deswegen kann es vorkommen, dass beim ersten Start des Servers der Version 2.0 die Arbeitselementberichte nicht ordnungsgemäß funktionieren. Als Fehlerumgehung können Sie entweder so lange warten, bis die Momentaufnahme für die Arbeitselemente zum ersten Mal ausgeführt wurde oder diese manuell nach dem Starten des Servers ausführen. Bei der ersten Ausführung nach der Migration werden durch die Momentaufnahme für die Arbeitselemente die gesamten Protokolldaten für die Arbeitselemente im Data-Warehouse wiederhergestellt. Dies bedeutet auch, dass die erste Ausführung der Momentaufnahme nach der Migration wahrscheinlich viel länger dauert, als eine durchschnittliche nächtliche Ausführung.

Neue Berichte erkennen

In Rational Team Concert 2.0 wurden einige neue Berichte hinzugefügt. Diese Berichte werden zwar in den neuen Prozessschablonen angezeigt, die im Lieferumfang des Produkts enthalten sind, sie werden jedoch nicht automatisch während der Migration zu den vorhandenen Projektbereichen hinzugefügt. Es wurde eine neue Aktion hinzugefügt, die Sie dabei unterstützt, diese neuen Berichtsschablonen zu erkennen und nach der Migration in die vorhandenen Projektbereiche zu implementieren. Gehen Sie wie folgt vor, um die neuen Berichtsschablonen zu implementieren:

  1. Öffnen Sie in Rich Client die Ansicht Teamartefakte.
  2. Erweitern Sie den Projektbereich und erweitern Sie Berichte.
  3. Klicken Sie mit der rechten Maustaste auf Berichtsschablonen und wählen Sie Neue Schablonen implementieren aus.

Das Dialogfenster ist eine Hilfe beim Erkennen von Berichtsschablonen, die verfügbar sind, aber noch nicht im Projektbereich implementiert sind. Sie können eine oder mehrere auswählen und erstellen. Nach der Erstellung können Sie aus diesen Schablonen mithilfe der verfügbaren Menüaktionen neue Berichte erstellen.

Anpassungen

Änderungen, die Sie an Arbeitselementtypen, Attributen, Workflows, Aufgabenbereichen und Ereignishandlern vorgenommen haben, bleiben beim Upgrade von Version 1.0 auf Version 2.0 erhalten. Wenn Sie eine vordefinierte Prozessschablone (zum Beispiel Scrum) angepasst haben, beachten Sie, dass diese Anpassungen beim erneuten Implementieren der vordefinierten Schablone (in der Ansicht 'Prozessschablonen) überschrieben werden. Wenn Sie die vordefinierte Schablone erneut implementieren müssen, sollten Sie zuerst den Namen und die ID der vordefinierten Schablone ändern, die Sie angepasst haben, damit sie nicht überschrieben wird.

Rational Team Concert mit Security-Enhanced Linux installieren

Wenn Security-Enhanced Linux (SELinux) aktiviert ist, müssen Sie es entweder inaktivieren oder den Sicherheitskontext der Java™ Runtime Environments (JREs) ändern, die für das Installieren und Ausführen von Rational Team Concert verwendet werden, um die Textverlagerung zu ermöglichen.

Warum und wann dieser Vorgang ausgeführt wird

Wenn Sie nur zum Auswerten von Rational Team Concert eine Maschine konfiguriert haben und die SELinux-Features für Sie nicht von Bedeutung sind, ist es am einfachsten, SELinux zu inaktivieren.

Note: