Allgemeiner Installationsinhalt - Datei mit Inhaltsverweisen

Apache Tomcat wird im Verzeichnis 'jazz-installationsverzeichnis/server/tomcat' installiert. Die Webanwendung (jazz.war) wird im Apache Tomcat-Verzeichnis 'webapps' installiert. Stellen Sie in einem Befehlsfenster das Verzeichnis 'jazz-installationsverzeichnis/server' als aktuelles Verzeichnis ein. Die Scripts zum Starten und Herunterfahren des Servers befinden sich in diesem Verzeichnis.
  • Wenn Sie die Start- und Stopscripts in einem anderen Verzeichnis ausführen möchten, müssen Sie die Datei 'profiles.ini' in 'jazz-installationsverzeichnis/server/conf/jazz/provision_profiles' so ändern, dass ein absoluter Pfad verwendet wird. Siehe Dateien 'profile.ini' und 'license_profile.ini' ändern.
  • Apache Tomcat ist in der Datei 'jazz-installationsverzeichnis/server/tomcat/conf/server.xml' für die Verwendung der Ports 9080 und 9443 konfiguriert. Ändern Sie diese Einstellungen bei Bedarf in für Sie passende Werte. Aktualisieren Sie bei Bedarf auch die Konfigurationseinstellungen der HTTP-Ports des Jazz-Server-Repositorys auf der Konfigurationsseite 'Erweiterte Eigenschaften' der Webbenutzerschnittstelle für Jazz-Verwaltung.
  • Im Verzeichnis 'jazz-installationsverzeichnis/server/logs' sind die Serverprotokolldateien enthalten. Wenn Probleme beim Start des Servers auftreten, überprüfen Sie die Protokolldateien.
  • Die Datei jazz-installationsverzeichnis/server/tomcat/conf/server.xml enthält die SSL-Einstellungen. Sie geben einen Algorithmus an, der nur in der IBM® JRE verfügbar ist. Wenn Sie den Server mit einer JRE von SUN ausführen möchten, ändern Sie in der Datei 'server.xml' die Einstellungen für Connector port="9443" so, dass sslProtocol="TLS" anstatt "SSL" verwendet wird. Entfernen Sie auch den Algorithmusparameter.

Jazz-Team-Server, Rational Team Concert Client, das Toolkit für Buildsysteme, ClearCase Connector, ClearQuest Connector und weitere Installationsdateien können von http://jazz.net heruntergeladen werden. Wenn Sie Rational Team Concert beziehen möchten, rufen Sie die Seite http://www.ibm.com/software/awdtools/rtc/ auf, auf der Sie ein installierbares Image herunterladen oder eine DVD bestellen können.

Auf Installation Manager basierende Installationen

Diese Schritte und Hinweise sind für eine Installation vorgesehen, die auf Installation Manager basiert.

Vorbereitende Schritte

Informationen zu diesem Vorgang

Wenn Sie IBM Installation Manager verwenden, notieren Sie während des Installationsprozesses die Angabe unter 'Installationsverzeichnis' auf der Seite 'Position'. Der Name des Verzeichnisses lautet jazz-installationsverzeichnis.

  • Installation Manager-Webinstallation für Client, Server und optionale Komponenten: Diese Archivdatei enthält das Installation Manager-Launchpadprogramm und die vordefinierten Positionen für das Installationsrepository. Hierbei handelt es sich um eine sich selbst entpackende Datei, von der das IBM Installation Manager-Launchpadprogramm gestartet wird, nachdem der Inhalt extrahiert wurde. Der Vorteil dieses Webinstallationspakets ist die Tatsache, dass sich die Größe des Anfangsdownloads verringert und vom Installationsprozess nur die Ressourcen heruntergeladen werden, die für die Installation ausgewählt werden.
    Anmerkung: Für die Webinstallation ist während des Installationsprozesses eine Internetverbindung erforderlich.
  • ZIP-Datei mit komplettem DVD-Inhalt: Diese Archivdatei enthält das Installation Manager-Launchpadprogramm und eine lokale Kopie aller installierbaren Ressourcen. Der Vorteil des lokalen Installationspakets ist die Tatsache, dass die Installation ohne eine Internetverbindung durchgeführt werden kann. Hierbei handelt es sich nicht um eine sich selbst extrahierende komprimierte Datei.
  • ZIP-Datei mit Inhalt der Client-CD - Lokale Installation Manager-Installation für den Client: Diese Archivdatei enthält das Installation Manager-Launchpadprogramm und eine lokale Kopie von Rational Team Concert Client. Der Vorteil des lokalen Installationspakets ist die Tatsache, dass die Installation ohne eine Internetverbindung durchgeführt werden kann. Hierbei handelt es sich um eine komprimierte Datei, die sich nicht selbst extrahiert.
  • Installation Manager-Webinstallation für Client, Server und optionale Komponenten: Diese Archivdatei enthält das Installation Manager-Launchpadprogramm und die vordefinierten Positionen für das Installationsrepository. Hierbei handelt es sich um eine sich selbst entpackende Datei, von der das IBM Installation Manager-Launchpadprogramm gestartet wird, nachdem der Inhalt extrahiert wurde. Der Vorteil dieses Webinstallationspakets ist die Tatsache, dass sich der Anfangsdownload verringert und vom Installationsprozess nur die Ressourcen heruntergeladen werden, die für die Installation ausgewählt werden.
    Anmerkung: Für die Webinstallation ist während des Installationsprozesses eine Internetverbindung erforderlich.
  • ZIP-Datei mit komplettem DVD-Inhalt: Diese Archivdatei enthält das Installation Manager-Launchpadprogramm und eine lokale Kopie aller installierbaren Ressourcen. Der Vorteil des lokalen Installationspakets ist die Tatsache, dass die Installation ohne eine Internetverbindung durchgeführt werden kann. Hierbei handelt es sich um eine komprimierte Datei, die sich nicht selbst extrahiert.

Vorgehensweise

  1. Starten Sie das Launchpadprogramm.

    Wenn Installation Manager noch nicht ausgeführt wird, starten Sie das Programm jetzt.

    Anmerkung: Sie müssen über Administratorrechte verfügen, um das Launchpadprogramm auszuführen.
    • Wenn Sie die Installation Manager-Webinstallation verwenden, führen Sie die ausführbare Datei aus. Die Dateien werden in ein Verzeichnis extrahiert und das Launchpadprogramm wird angezeigt.
      • Führen Sie zur Ausführung der Datei unter Windows® den folgenden Befehl aus:
        RTC-edition-Full-version-Win-Web.exe
      • Führen Sie zur Ausführung der Datei unter Linux® den folgenden Befehl aus:
        sh RTC-edition-Full-version-Linux-Web.sh
    • Wenn Sie die ZIP-Datei mit komplettem DVD-Inhalt verwenden, extrahieren Sie den Inhalt des Archivs in ein temporäres Verzeichnis und führen das Launchpadprogramm aus.
      • Führen Sie zur Ausführung der Datei unter Windows den folgenden Befehl aus:
        launchpad.exe
      • Führen Sie zur Ausführung der Datei unter Linux den folgenden Befehl aus:
        sh launchpad.sh
  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.

    Anmerkung: Sie müssen über Administratorrechte verfügen, um das Launchpadprogramm auszuführen.
    Anmerkung: 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:
    • Wenn Sie die ZIP-Datei mit Inhalt der Client-CD verwenden, extrahieren Sie den Inhalt des Archivs in ein temporäres Verzeichnis und führen das Launchpadprogramm aus. Gehen Sie wie folgt vor, um die Launchpadprogrammdatei zu starten:
      • Führen Sie zur Ausführung der Datei unter Windows den folgenden Befehl aus:
        launchpad.exe
      • Führen Sie zur Ausführung der Datei unter Linux den folgenden Befehl aus:
        sh launchpad.sh
    • Wenn Sie die Installation Manager-Webinstallation verwenden, führen Sie die ausführbare Datei aus. Die Dateien werden in ein Verzeichnis extrahiert und das Launchpadprogramm wird angezeigt. Gehen Sie wie folgt vor, um die ausführbare Datei zu starten:
      • Führen Sie zur Ausführung der Datei unter Windows den folgenden Befehl aus:
        RTC-edition-Full-version-Win-Web.exe
      • Führen Sie zur Ausführung der Datei unter Linux den folgenden Befehl aus:
        sh RTC-edition-Full-version-Linux-Web.sh
    • Wenn Sie die ZIP-Datei mit komplettem DVD-Inhalt verwenden, extrahieren Sie den Inhalt des Archivs in ein temporäres Verzeichnis und führen das Launchpadprogramm aus. Gehen Sie wie folgt vor, um die Launchpadprogrammdatei zu starten:
      • Führen Sie zur Ausführung der Datei unter Windows den folgenden Befehl aus:
        launchpad.exe
      • Führen Sie zur Ausführung der Datei unter Linux den folgenden Befehl aus:
        sh launchpad.sh

Auf ZIP-Datei basierende Installationen

Für eine Installation auf der Basis einer ZIP-Datei werden die folgenden Komponenten verwendet.

About this task

Note: Notieren Sie das Verzeichnis, in dem die Dateien extrahiert werden, wenn Sie komprimierte Archivdateien zur Durchführung der Installation verwenden. Das Verzeichnis wird in späteren Schritten als 'jazz-installationsverzeichnis' bezeichnet.

Procedure

  1. Laden Sie die Datei(en) auf Ihren Computer herunter.
    • Laden Sie für den Server die ZIP-Datei herunter.
    • Laden Sie für den Client die ZIP-Datei herunter.
    • Optional: Laden Sie die ZIP-Datei für den Build herunter.
    • Optional: Laden Sie die ZIP-Datei(en) für den Connector herunter.
  2. Extrahieren Sie den Inhalt des Pakets in Ihrem Dateisystem.
    Note: Wählen Sie beim Extrahieren der Dateien eine Position aus, die sich in der Nähe des Stammverzeichnisses in Ihrem Dateisystem befindet. Lange Dateipfadnamen können unnötige Warnungen zur Folge haben. Extrahieren Sie die Dateien zum Beispiel in 'c:\IBM' unter Windows oder in '/opt/IBM' unter Linux.

Clientinstallationen

About this task

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.
Fehlerbehebung: Nachfolgend werden einige Verfahren zur Fehlerbehebung eventuell auftretender Probleme erläutert.
  • Starten Sie einen leeren Arbeitsbereich.
  • Die Client- und Servererstellungen müssen übereinstimmen. Stellen Sie sicher, dass die Build-IDs für die Client- und die Serverdistribution identisch sind.
  • Stellen Sie sicher, dass der Server betriebsbereit ist. Bestätigen Sie dies mithilfe der Status-URL 'https://example.com:9443/jazz'.
  • Wenn Sie den Client unter Linux in einem Verzeichnis außerhalb von 'jazz-installationsverzeichnis/client/eclipse' starten möchten, müssen Sie jede Datei in 'jazz-installationsverzeichnis/client/eclipse/links/' so ändern, dass der absolute Pfad im genannten Verzeichnis eingeschlossen ist. Standardmäßig werden relative Pfade verwendet. So enthält zum Beispiel 'jazz-installationsverzeichnis/client/eclipse/links/build.link' den Text "path=jazz/build". Wenn der Client im Verzeichnis '/home/username/teamconcert' installiert ist, bearbeiten Sie die Datei so, dass der Text in nachher "path=/home/username/teamconcert/jazz/client/eclipse/build" lautet.

Procedure


  1. 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.

Sonstige Inhaltsverweise zur Installation

About this task

Important: Bei Verwendung des Jazz-Team-Servers mit einer Derby-Datenbank werden maximal zehn Benutzer unterstützt. Zur Unterstützung von mehr als zehn Benutzern verwenden Sie eine Datenbank des Typs DB2® Workgroup Server, DB2, Oracle oder Microsoft® SQL Server. DB2 Workgroup Server ist im Lieferumfang der Installationspakte von Enterprise Edition, Standard Edition und Express® Edition enthalten, wenn Sie IBM Installation Manager verwenden. Wenn Sie die Installation mit einer ZIP-Datei durchführen, steht der Download von DB2 Workgroup Server auf derselben Seite wie der Download von Rational Team Concert zur Verfügung. Wenn der DB2 Workgroup Server-Download heruntergeladen ist, müssen Sie die Software wie im Installationshandbuch beschrieben installieren und konfigurieren.

Wenn Eigenschaftendateien gespeichert werden, wird von der Anwendung immer eine Sicherungskopie der vorherigen Version in demselben Verzeichnis erstellt. Wenn Sie alle Dateien entfernen möchten, in denen das Klartextkennwort enthalten ist, entfernen Sie die Sicherungseigenschaftendateien nach der ersten Konfiguration des Servers.

Note: Wenn Sie beabsichtigen, einen vorhandenen Anwendungsserver anstatt des im Lieferumfang enthaltenen Apache Tomcat-Servers zu verwenden, nehmen Sie die Auswahl des Kontrollkästchens für das Apache Tomcat-Paket zurück. In diesem Fall werden nur die Dateien installiert, die für die Verwendung mit Ihrem vorhandenen Anwendungsserver erforderlich sind. Sie werden von Installation Manager aufgefordert, eine Position für die Installation dieser Dateien auszuwählen.
Note: Die Datenbank Derby ist zwar in der Standardkonfiguration enthalten und macht keine Installation erforderlich, sie bietet jedoch nur eine Unterstützung von maximal zehn Benutzern. Wenn Sie Unterstützung für mehr als zehn Benutzer wünschen und nicht über Zugriff auf eine vorhandene DB2- oder Oracle-Datenbank verfügen, installieren Sie das Produktpaket DB2 Workgroup Server Edition.

Wenn Sie DB2 Workgroup Server installieren, notieren Sie Benutzer-ID, Kennwort und Portnummer. Diese Informationen werden später wieder benötigt. Wenn Sie die Standardwerte während der Installation bestätigen, erleichtert dies die Konfiguration des Jazz-Team-Servers.

Server starten

About this task

Wenn Sie beabsichtigen, den im Lieferumfang enthaltenen Apache Tomcat-Anwendungsserver zu verwenden, können Sie den Jazz-Team-Server starten.

Wenn Sie beabsichtigen, WebSphere® Application Server zu verwenden, konfigurieren Sie die Serverumgebung wie in WebSphere Application Server konfigurieren beschrieben.

Wenn Sie beabsichtigen, WebSphere Application Server zu verwenden, konfigurieren Sie die Serverumgebung wie in WebSphere Application Server konfigurieren beschrieben.

Apache Tomcat-Server starten

Sie können den Apache Tomcat-Server jetzt starten.
Apache Tomcat wird im Verzeichnis 'jazz-installationsverzeichnis/server/tomcat' installiert. Die Webanwendung (jazz.war) wird im Apache Tomcat-Verzeichnis 'webapps' installiert. Stellen Sie in einem Befehlsfenster das Verzeichnis 'jazz-installationsverzeichnis/server' als aktuelles Verzeichnis ein. Die Scripts zum Starten und Herunterfahren des Servers befinden sich in diesem Verzeichnis.
  • Wenn Sie die Start- und Stopscripts in einem anderen Verzeichnis ausführen möchten, müssen Sie die Datei 'profiles.ini' in 'jazz-installationsverzeichnis/server/conf/jazz/provision_profiles' so ändern, dass ein absoluter Pfad verwendet wird. Siehe Dateien 'profile.ini' und 'license_profile.ini' ändern.
  • Apache Tomcat ist in der Datei 'jazz-installationsverzeichnis/server/tomcat/conf/server.xml' für die Verwendung der Ports 9080 und 9443 konfiguriert. Ändern Sie diese Einstellungen bei Bedarf in für Sie passende Werte. Aktualisieren Sie bei Bedarf auch die Konfigurationseinstellungen der HTTP-Ports des Jazz-Server-Repositorys auf der Konfigurationsseite 'Erweiterte Eigenschaften' der Webbenutzerschnittstelle für Jazz-Verwaltung.
  • Im Verzeichnis 'jazz-installationsverzeichnis/server/logs' sind die Serverprotokolldateien enthalten. Wenn Probleme beim Start des Servers auftreten, überprüfen Sie die Protokolldateien.
  • Die Datei jazz-installationsverzeichnis/server/tomcat/conf/server.xml enthält die SSL-Einstellungen. Sie geben einen Algorithmus an, der nur in der IBM JRE verfügbar ist. Wenn Sie den Server mit einer JRE von SUN ausführen möchten, ändern Sie in der Datei 'server.xml' die Einstellungen für Connector port="9443" so, dass sslProtocol="TLS" anstatt "SSL" verwendet wird. Entfernen Sie auch den Algorithmusparameter.

Server unter Windows starten

Führen Sie die Startdatei zum Starten des Servers unter Windows aus.

Informationen zu diesem Vorgang

Vorgehensweise

  1. Führen Sie zum Starten des Servers im Verzeichnis 'JazzInstallDir/server' den folgenden Befehl aus:
    server.startup.bat
    Anmerkung: Ein separates Konsolfenster für Apache Tomcat wird geöffnet. Schließen Sie dieses Fenster nicht, da der Server sonst gestoppt wird. Außerdem werden mehrere Informationsnachrichten angezeigt, zum Beispiel zur nativen Bibliothek von Apache Tomcat (Apache Tomcat Native Library). Diese Informationsnachrichten haben keinen Einfluss auf die Funktionalität des Jazz-Team-Servers.
  2. Führen Sie zum Stoppen des Servers im Verzeichnis 'JazzInstallDir/server' den folgenden Befehl aus:
    server.shutdown.bat

Nächste Schritte

Anmerkung: Im obigen Beispiel werden das Start- und das Stopscript direkt im Verzeichnis 'jazz-installationsverzeichnis/server' ausgeführt. Wenn Sie Jazz-Team-Server mithilfe von IBM Installation Manager installiert haben, können Sie die Befehle auch im Windows-Startmenü von Jazz-Team-Server ausführen.

Wenn der Server gestartet ist, fahren Sie mit Installationsassistenten ausführen fort.

Server unter Linux starten

Führen Sie die folgende Startdatei aus, um den Server unter Linux zu starten oder zu stoppen.

Informationen zu diesem Vorgang

Vorgehensweise

  1. Führen Sie zum Starten des Servers im Verzeichnis 'JazzInstallDir/server' als Rootbenutzer den folgenden Befehl aus:
    ./server.startup
    Wenn Ihre Benutzer-ID über Administratorzugriff verfügt, führen Sie diesen Befehl aus:
    sudo ./server.startup

    Ein separates Konsolfenster für Apache Tomcat wird nicht angezeigt. Sie können den Fortschritt des Serverstarts durch Anzeigen der Protokolldatei in 'jazz-installationsverzeichnis/server/logs/jazz.log' überprüfen.

  2. Führen Sie zum Stoppen des Servers im Verzeichnis 'JazzInstallDir/server' als Rootbenutzer den folgenden Befehl aus:
    ./server.shutdown
    Wenn Ihre Benutzer-ID über Administratorzugriff verfügt, führen Sie diesen Befehl aus:
    sudo ./server.shutdown

Nächste Schritte

Anmerkung: Im Beispiel werden das Start- und das Stopscript direkt im Verzeichnis 'jazz-installationsverzeichnis/server' ausgeführt. Wenn Sie den Jazz-Team-Server mithilfe von IBM Installation Manager installiert haben, können Sie die Befehle auch im Anwendungsstartmenü des Jazz-Team-Servers ausführen.

Wenn der Server gestartet ist, fahren Sie mit Installationsassistenten ausführen fort.

WebSphere Application Server konfigurieren

In diesem Abschnitt wird beschrieben, wie der Jazz-Team-Server für die Arbeit mit WebSphere Application Server konfiguriert wird. Für diese Konfiguration ist Voraussetzung, dass der Jazz-Team-Server auf derselben Maschine wie WebSphere Application Server konfiguriert wird. Die Anweisungen basieren auf der WebSphere Application Server-Version 6.1.0.23. Für Version 7.0.0.7 und höher gibt es geringfügige Abweichungen. Darauf wird gegebenenfalls im Text hingewiesen.

Vorbereitende Schritte

Stellen Sie vor der Ausführung dieser Schritte sicher, dass die folgenden Punkte durchgeführt wurden:
  • WebSphere Application Server ist bereits installiert.
  • Die Datenbank wurde erstellt und die Datei 'teamserver.properties' wurde mithilfe Ihrer Datenbankeinstellungen aktualisiert.
  • Aktivieren der Anmeldung, bei der Groß-/Kleinschreibung nicht beachtet werden muss (optional): Wenn die Authentifizierungsmethode des Servers eine Anmeldung ermöglicht, bei der die Groß-/Kleinschreibung nicht beachtet werden muss, ist es möglich, dass die Jazz-Anwendung dies ebenfalls akzeptiert. Die Anmeldung, bei der die Groß-/Kleinschreibung nicht beachtet werden muss, kann auf der Seite Erweiterte Eigenschaften der Webbenutzerschnittstelle für Verwaltung über die Eigenschaft "Abgleich von Benutzer-IDs ohne Berücksichtigung von Groß-/Kleinschreibung durchführen" aktiviert werden. Die Standardeinstellung wird nicht geändert; Administratoren müssen diese Eigenschaft explizit außer Kraft setzen, um eine Anmeldung zu aktivieren, bei der die Groß-/Kleinschreibung nicht beachtet werden muss.
  • Die Java™ 2-Sicherheitsoption muss inaktiviert sein. Wenn diese Option in WebSphere Application Server aktiviert ist, schlägt der Start der WAR-Datei von Jazz-Team-Server fehl.
  • Stellen 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'. (Navigieren Sie unter WAS 7.0.0.7 zu 'Sicherheit' -> 'Globale Sicherheit' -> 'Web- und SIP-Sicherheit' -> 'Allgemeine Einstellungen'.)
    2. Wählen Sie das Markierungsfeld für 'Verfügbare Authentifizierungsdaten beim Zugriff auf einen ungeschützten URI verwenden' aus.
  • Im Lieferumfang des Jazz-Team-Servers sind die Dateien zur Ausführung eines vollständigen Apache Tomcat-basierten Servers enthalten. Für eine WebSphere-Installation ist nur eine Teilmenge der Dateien des Jazz-Team-Servers erforderlich; diese Dateien müssen Sie in ein Verzeichnis auf der WebSphere-Servermaschine stellen. In anderen Anweisungen wird dieses Verzeichnis als Installationsverzeichnis des Jazz-Team-Servers oder als 'jazz-installationsverzeichnis' bezeichnet. Verwenden Sie in diesem Verzeichnis Folgendes:
    • Die Datei 'jazz-installationsverzeichnis/server/tomcat/webapps/jazz.war'.
    • Das Verzeichnis 'jazz-installationsverzeichnis/server/update-site'.
    • Das Verzeichnis 'jazz-installationsverzeichnis/server/conf'.
    • Die Standard-Repository-Datenbank in 'jazz-installationsverzeichnis/repositoryDB'.
    • Die Repository-Tools in 'jazz-installationsverzeichnis/repotools'.
    • Das Verzeichnis 'jazz-installationsverzeichnisserver/license-update-site'.
    • Das Verzeichnis 'jazz-installationsverzeichnis/server/nl1-update-site'.
    • Das Verzeichnis 'jazz-installationsverzeichnis/server/nl2-update-site'.
Tipp: Wenn IBM Installation Manager zur Installation von Jazz-Team-Server für die Verwendung mit Rational Team Concert verwendet wird, können die Jazz-Team-Server-Dateien in einem Webanwendungsverzeichnis installiert werden. Während des Installationsprozesses dürfen Sie nicht den im Lieferumfang enthaltenen Apache Tomcat-Anwendungsserver installieren, da Sie in diesem Fall von Installation Manager aufgefordert werden, ein Webanwendungsverzeichnis anzugeben und von Installation Manager nur die für WebSphere erforderlichen Dateien installiert werden. Das Standardverzeichnis lautet unter Windows 'c:\Programme\IBM\JazzTeamServer' und unter Linux '/opt/IBM/JazzTeamServer'. Das Installationsverzeichnis in dieser Prozedur lautet 'jazz-installationsverzeichnis'. Wenn Sie IBM Installation Manager für die Installation der Dateien im Webanwendungsverzeichnis von WebSphere Application Server verwenden, müssen Sie die Dateien nicht wie oben beschrieben manuell verschieben.

Informationen zu diesem Vorgang

Anmerkung: In diesem Dokument wird nicht die Konfiguration der WebSphere-Authentifizierung oder von Secure Sockets Layer (SSL) erläutert, da dies ein komplexes Thema ist. Ausführliche Informationen zu den verschiedenen Authentifizierungs- und Verschlüsselungsoptionen für WebSphere finden Sie im WebSphere Information Center. Rufen Sie für weitere Informationen die Adresse des WebSphere Information Center auf und suchen Sie nach Anwendungen und ihre Umgebung sichern. Für die Jazz-Webbenutzerschnittstelle ist es erforderlich, dass die Authentifizierung konfiguriert werden kann, damit eine Autorisierung durchgeführt werden und Anwendung angepasst werden kann.

Vorgehensweise

  1. Überprüfen und aktualisieren Sie die Datenbankposition in der Datei 'teamserver.properties'.
    com.ibm.team.repository.db.vendor = DB2
    com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:user=db2admin;password={password};
    com.ibm.team.repository.db.jdbc.password=db2admin
    Anmerkung: Dies ist eine DB2-Beispielkonfiguration. Die Datei 'teamserver.properties' muss abhängig vom jeweiligen Datenbankanbieter (Oracle/MS-SQL) aktualisiert werden.
  2. Überprüfen oder aktualisieren Sie die Version von WebSphere Application Server.

    Für den Jazz-Team-Server ist WebSphere Application Server Version 6.1 mit IBM Java SDK 1.5 SR5 oder einem späteren kumulativen Fix oder WebSphere Application Server Version 7.0 mit Version 7.0.0.7 oder aktueller erforderlich. Die Aktualisierung IBM Java SDK 1.5 SR6 SDK ist unter http://www-1.ibm.com/support/docview.wss?rs=180&uid=swg24017492 verfügbar. Wenn WebSphere 6.1 und das allgemein verfügbare IBM Java SDK verwendet werden, werden von Jazz nach manchen Operationen 'Proxyfehler' gemeldet.

    Sie müssen die entsprechenden i-Fixes von WebSphere Application Server für Korrekturen an IBM Java SDK 1.5 SR9 oder IBM Java SDK 1.6 SR4 beziehen, die für die ordnungsgemäße Ausführung von IBM Rational Team Concert erforderlich sind. Andernfalls kann es vorkommen, dass manche Services auf dem Server nicht ordnungsgemäß gestartet werden. Die i-fixes sind unter den entsprechenden WebSphere Application Server APAR-Nummern zu beziehen. Der APAR für IBM Java SDK 1.5/WebSphere Application Server 6.1 trägt die Bezeichnung PK85942; Sie können die Datein von ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK85942/ herunterladen. Installieren Sie mindestens WebSphere Application Server 6.1 Fixpack 19, bevor Sie das JRE i-fix installieren. Der APAR für IBM Java SDK 1.6/WebSphere Application Server 7.0 trägt die Bezeichnung PK 86771; Sie können die Dateien von ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK86771/ herunterladen.

  3. Aktualisieren Sie die JVM-Argumente.

    Für den Jazz-Team-Server sind mehrere besondere Einstellungen in derJava Virtual Machine erforderlich, in der die Ausführung erfolgt.

    Die erste Eigenschaft, die in den generischen JVM-Argumenten eingestellt werden muss, ist der Standardwert für die maximale Hauptspeicherzuordnung mithilfe der Einstellung '-Xmx'. Grundlage für die Einstellung dieses Werts sind das Team, das vom Server unterstützt wird und die Hauptspeicherkapazität des Servers, auf dem der Jazz-Team-Server ausgeführt wird. Für ein normales, mittelgroßes Team kann der Wert '-Xmx1536M' verwendet werden, durch den ein Heapspeicher von 1536 MB für den Jazz-Team-Server-Prozess bereitgestellt wird.

    Eine zweite Eigenschaft, die in den generischen JVM-Argumenten speziell für Rational Quality Manager eingestellt werden muss, ist die Größe des Thread-Stacks. Eine typische Stackgröße für Rational Quality Manager ist -Xss786K.

    Wenn Sie eine Verbindung zu einer Oracle- oder SQL Server-Datenbank herstellen, müssen Sie die Eigenschaft 'ORACLE_JDBC' bzw. 'SQLSERVER_JDBC' hinzufügen. Stellen Sie für die Eigenschaft den absoluten Dateipfad (nicht eine URL) zu den passenden JDBC-Treibern ein.

    In den folgenden Beispielen werden die generischen JVM-Argumente für die Herstellung von Verbindungen zu Oracle- und SQL Server-Datenbanken sowie die maximale Hauptspeicherzuordnung und die Größe des Thread-Stacks gezeigt. Ersetzen Sie jazz-installationsverzeichnis durch das Jazz-Team-Server-Installationsverzeichnis.

    -DORACLE_JDBC=jazz-installationsverzeichnis\server\oracle -Xmx1536M -Xss768k
    -DSQLSERVER_JDBC=jazz-installationsverzeichnis\server\sqlserver -Xmx1536M -Xss768k

    Es gibt noch weitere Systemeigenschaften, die zur Steuerung bestimmter Serververhalten eingestellt werden müssen. Diese werden unten genannt. Im Folgenden werden die Besonderheiten bei der Einstellung dieser JVM-Eigenschaften in der WebSphere-Administrationskonsole beschrieben. Ersetzen Sie jazz-installationsverzeichnis durch das Jazz-Team-Server-Installationsverzeichnis:

    1. Klicken Sie auf Server > Anwendungsserver.
    2. Klicken Sie auf server1.
    3. Klicken Sie auf Java- und Prozessverwaltung > Prozessdefinition.
    4. Klicken Sie auf Java Virtual Machine.
    5. Fügen Sie den Wert 100 für Größe des Heapspeichers hinzu.
    6. Geben Sie für Maximale Größe des Heapspeichers den Wert 1000 an.
    7. Klicken Sie auf Anwenden.
    8. Klicken Sie auf Protokollierung und Tracing. Klicken Sie auf Protokolldetailstufen ändern. Jazz-Team-Server verwendet die BIRT-Reporting-Engine. Um zu vermeiden, dass BIRT-Informationseinträge in die WebSphere-Protokolldatei geschrieben werden, setzen Sie die Protokollstufe für die org.eclipse.birt.*-Pakete auf schwerwiegend. Klicken Sie auf Anwenden.
    9. Klicken Sie auf Anwendungsserver > {servername} > Prozessdefinition > Java Virtual Machine > Benutzerdefinierte Eigenschaften. Eine der benutzerdefinierten Eigenschaften, die Sie hinzufügen müssen, ist JAZZ_HOME. Diese Systemeigenschaft gibt an, wo sich bestimmte Konfigurationsdateien befinden. Da von dieser Eigenschaft eine URL und nicht ein einfacher Pfad verwendet wird, muss der Wert als URL mit dem Format 'datei://-style' angegeben werden.
    10. Fügen Sie die folgenden Eigenschaften hinzu: Klicken Sie auf Neu, geben Sie einen Namen und einen Wert ein und klicken Sie anschließend auf 'OK'.
      • Name: 'java.awt.headless' Wert: 'true'
      • Name: 'org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin' Wert: 'true'
      • Name: JAZZ_HOME Wert: file:///jazz-installationsverzeichnis/server/conf
    11. Klicken Sie auf Sichern, um die Masterkonfiguration direkt zu speichern.
    Wichtig: Nur bei Solaris müssen Sie auch das folgende Java -Befehlszeilenargument hinzufügen:
    -XX:MaxPermSize=256m
    Weitere Informationen finden Sie im Kapitel zum Konfigurieren einer Solaris-Umgebung für WebSphere Application Server des IBM Redbooks IBM WebSphere Application Server V6.1 unter Betriebssystem Solaris 10.
  4. Starten Sie WebSphere erneut, um die Anwendung Jazz zu installieren.
    In den folgenden Befehlszeilenbeispielen steht 'was-installationsverzeichnis' für die Position, an der WebSphere Application Server auf dem Server installiert ist.
    • Unter Windows ist der Standardwert für das WebSphere-Installationsverzeichnis:
      c:\Programme\IBM\WebSphere\AppServer
      Mithilfe der folgenden Befehle können Sie den Server unter Windows erneut starten:
      cd was-installationsverzeichnis\bin 
      stopServer.bat server1 [for a secure server, include: -username {LDAP_User} -password {LDAP_Password}] 
      startServer.bat server1
    • Unter Linux ist der Standardwert für das WebSphere-Installationsverzeichnis:
      /opt/IBM/WebSphere/AppServer
      Mithilfe der folgenden Befehle können Sie den Server unter Linux erneut starten:
      cd was-installationsverzeichnis/bin 
      ./stopServer.sh server1 [for a secure server, include: -username {LDAP_User} -password {LDAP_Password}] 
      ./startServer.sh server1
    1. Öffnen Sie die Administrationskonsole für WebSphere Application Server.
    2. Klicken Sie auf Anwendungen > Neue Anwendung installieren. (Für WebSphere Application Server 7.0.0.7 und höher klicken Sie auf Anwendungen > Neue Anwendung > Neue Unternehmensanwendung.)
    3. Klicken Sie unter Pfad zur neuen Anwendung auf 'Lokales Dateisystem'.
    4. Geben Sie unter Vollständiger Pfad Folgendes ein:
      jazz-installationsverzeichnis/server/tomcat/webapps/jazz.war
    5. Legen Sie Kontextstammverzeichnis auf '/jazz' fest und klicken Sie anschließend auf Weiter.
      Anmerkung: Dieser Schritt steht fast am Ende der Installation in WebSphere Application Server 7.0.0.7 und höher.
    6. Klicken Sie auf Weiter und fahren Sie mit den restlichen Schritten von Neue Anwendung installieren fort.
    7. Klicken Sie auf Fertig stellen.
    8. Prüfen Sie, ob die Anwendung 'jazz_war' installiert wurde, und klicken Sie dann auf Sichern, um die Änderungen direkt in der Hauptkonfigurationsdatei zu speichern.
    9. Klicken Sie auf Anwendungen > Unternehmensanwendungen.
    10. Wählen Sie das Kästchen neben 'jazz_war' aus und klicken Sie auf Starten.

      Jetzt müsste ein grüner Pfeil angezeigt werden, dar angibt, dass die Anwendung erfolgreich gestartet wurde.

      Anmerkung: Die restlichen Schritte betreffen nur Rational Quality Manager.
    11. Rufen Sie erneut die Seite Install New Application auf.
    12. Wechseln Sie in das Verzeichnis, in dem sich die Datei help.war auf dem lokalen Dateisystem befindet, und wählen Sie die Datei aus. Geben Sie als Kontextstammverzeichnis /help ein und klicken Sie anschließend auf Next.
      Anmerkung: Die Datei help.war befindet sich im Pfad jazz-installationsverzeichnis\server\tomcat\webapps\help.war.
    13. Klicken Sie so oft auf Next, bis die Zusammenfassung angezeigt wird. Klicken Sie anschließend auf Finish, um die neue Anwendung zu installieren.
    14. Prüfen Sie, ob die Anwendung "help_war" installiert wurde, und klicken Sie dann auf Save, um die Änderungen an der Hauptkonfigurationsdatei zu sichern.
    15. Klicken Sie auf Anwendungen > Unternehmensanwendungen.
    16. Wählen Sie help_war aus und klicken Sie auf Start.

Nächste Schritte

Wenn der Server gestartet ist, fahren Sie mit Installationsassistenten ausführen fort.

Installationsassistenten ausführen

Wenn Sie den Installationsassistenten ausführen, wird sichergestellt, dass der Server ordnungsgemäß ausgeführt wird. Außerdem werden Sie vom Installationsassistenten durch die Schritte zur Konfiguration des Servers geführt.

Informationen zu diesem Vorgang

Wenn Sie sicherstellen möchten, dass des Jazz-Team-Servers eine Verbindung zur Datenbank hergestellt wurde, überprüfen Sie das Serverprotokoll oder die Konsolausgabe. Die Verbindung und die Datenbankinformationen werden beim ersten Zugriff zurückgemeldet. Das Verzeichnis 'jazz-installationsverzeichnis/server/logs' wird für die Serverprotokolldateien verwendet.

Für diese Prozedur wird vorausgesetzt, dass der Server verfügbar ist und von ihm der Hostname 'localhost' sowie der Standardport 9443 verwendet werden. Ersetzen Sie bei Bedarf den Hostnamen 'localhost' durch den Hostnamen Ihres Servers und den Port 9443 durch den Port Ihres Servers.

Vorgehensweise

Starten Sie den Installationsassistenten zur Konfiguration des Servers. Verwenden Sie hierzu die URL https://localhost:9443/jazz/setup.

Melden Sie sich auf dem Apache Tomcat-Anwendungsserver mit der Benutzername/Kennwort-Standardkombination ADMIN/ADMIN an. Sowohl für den Benutzernamen als auch für das Kennwort muss die Groß-/Kleinschreibung beachtet werden.

Für WebSphere Application Server und LDAP müssen Sie Benutzerzuordnungen ordnungsgemäß so konfigurieren, dass die WAS-Benutzerregistry- oder LDAP-Benutzer den entsprechenden Jazz-Gruppen (wie JazzAdmins, JazzUsers usw.) zugeordnet werden. Dann können Sie sich bei Jazz-Team-Server mit dem WAS- oder LDAP-Account anmelden. Weitere Informationen finden Sie in Benutzer mit LDAP verwalten.

Wählen Sie einen Konfigurationspfad aus. Der Assistent weist zwei Hauptpfade auf.
  • Bei Auswahl von Schnellkonfiguration wird die Standardkonfiguration verwendet. Wenn Sie den Server schnell ausführen möchten, ist diese Schnellkonfiguration eine gute Wahl. Im Verlauf der Schnellkonfiguration müssen Sie die
    • Benutzerregistry konfigurieren.
  • Bei Auswahl von Angepasste Konfiguration werden Sie durch die ausführliche Serverkonfiguration geführt, in deren Verlauf Sie auch die Funktion zur Aktivierung von E-Mail-Benachrichtigungen einstellen können. Während der angepassten Konfiguration können Sie Folgendes konfigurieren:
    • Datenbank
    • E-Mail-Benachrichtigung
    • Benutzerregistry
    Anmerkung: Der Server ist standardmäßig für die Verwendung von Derby als Datenbank konfiguriert. Wenn Sie eine andere Datenbank wie DB2 verwenden möchten, wählen Sie die angepasste Konfiguration aus und führen Schritt 2 (Datenbank konfigurieren) durch. Wenn Sie Ihre Datenbanktabellen nicht erstellt haben, werden Sie nach dem Testen der Verbindung aufgefordert, die Datenbanktabellen anzugeben. Wenn Sie die Schnellkonfiguration wählen und Ihre Datenbanktabellen sind nicht erstellt, werden Sie aufgefordert, zu Schritt 2 zu wechseln und die Datenbanktabellen zu erstellen.

Wenn die Erstkonfiguration abgeschlossen ist, können in der Webbenutzerschnittstelle für die Verwaltung des Jazz-Team-Servers unter Verwendung der URL https://localhost:9443/jazz/admin weitere Optionen konfiguriert werden.

Nächste Schritte

Wenn der Installationsassistent des Servers nicht geladen wird, überprüfen Sie die folgenden Punkte:
  • Stellen Sie sicher, dass der Anwendungsserver gestartet wurde. Verwenden Sie hierzu die URL 'http://localhost:9080'.
  • Stellen Sie sicher, dass der Jazz-Team-Server gestartet wurde; melden Sie sich hierzu mithilfe der URL https://localhost:9443/jazz/admin an der Webbenutzerschnittstelle für die Verwaltung des Jazz-Team-Servers an. Wenn die Seite nicht geladen wird oder auf dem Server Fehler auftreten, wurde der Server nicht ordnungsgemäß gestartet.
  • Das URI-Stammelement für den Jazz-Team-Server muss '/jazz' sein. Beispiel: nicht 'https://example.com:9443', sondern 'https://example.com:9443/jazz' muss verwendet werden.

Feedback