Nach dem Upgrade und dem Start von Jazz Team Server (sowie aller
verteilten Server von CLM-Anwendungen) müssen Sie Jazz Team Server und die CLM-Anwendung
konfigurieren.
Vorbereitende Schritte
Öffnen Sie zuvor Ihren Webbrowser und löschen Sie den Browsercache.
Sie müssen den öffentlichen URI von
Jazz Team Server und allen Anwendungen, die registriert werden sollen, kennen.
Der öffentliche URI der Vorversionen von Jazz Team Server oder anderen Anwendungen
kann sich nicht ändern. Weitere Informationen zur Planung Ihrer URIs finden Sie im Artikel
URIs planen.
Informationen zu diesem Vorgang
- Gehen Sie wie hier beschrieben vor, wenn Sie gerade das Upgrade für
Jazz Team Server und mindestens eine
der CLM-Anwendungen auf Version 3.0.1 durchgeführt haben. In diesem Fall sollten Sie
den Konfigurationsassistenten für Jazz Team Server und Anwendungen
ausführen, um Ihre Datenbank, E-Mail-Einstellungen, das Data Warehouse und die Benutzer-Registry zu konfigurieren und die Anwendungen zu registrieren. Der Assistent spürt die gerade installierten Anwendungen auf und ermöglicht ihre Konfiguration.
- Wenn Sie eine neue Anwendung oder eine zweite Instanz einer registrierten Anwendung zu einem vorhandenen
Jazz Team Server hinzufügen, führen Sie die
Konfigurationsschritte auf der Webbenutzerschnittstelle für Administration von Jazz Team Server aus. Weitere Informationen hierzu finden Sie unter Zusätzliche Anwendungen bei Jazz Team Server registrieren.
Vorgehensweise
Anmerkung: Wenn Sie den Assistenten für die Konfiguration verteilter
Anwendungen nutzen, führen Sie die folgenden Schritte in der hier angegebenen Reihenfolge
aus:
- Installieren Sie auf dem ersten Server die Anwendung Jazz Team Server mit Testlizenzen. Starten Sie den ersten Server, ohne jedoch den Konfigurationsassistenten auf diesem Server auszuführen.
- Installieren Sie auf dem zweiten Server die Anwendungen Change and Configuration Management, Quality Management oder
Requirements Management. (Sie können auch einen Server pro Anwendung verwenden. Lesen Sie dazu den Artikel
Beispiele für Unternehmenstopologien.)
Starten Sie die Server, ohne jedoch den Konfigurationsassistenten auszuführen.
- Führen Sie den Konfigurationsassistenten auf dem ersten Server (mit der Anwendung Jazz Team Server) aus.
Beginnen Sie mit Schritt 2 der nachfolgend angegebenen Schritte. Wenn Sie zur Seite Anwendungen registrieren des
Konfigurationsassistenten gelangen (siehe unten Schritt 8), geben Sie den Erkennungs-URL der auf den anderen Servern installierten
Anwendungen an.
- Wenn Sie nach Ausführung von
Schritt 9 zum Konfigurieren der Benutzer-Registry festlegen möchten,
dass die verteilten Anwendungen LDAP verwenden sollen, kopieren Sie die LDAP-Dateien von dem Server mit
Jazz Team Server auf die Server mit den anderen Anwendungen.
Starten Sie dann alle Server neu.
- Stellen Sie sicher, dass der Server gestartet ist. Befolgen Sie dafür die Anweisungen im Abschnitt
Server implementieren und starten.
- Zeigen Sie mit Ihrem Webbrowser auf die folgende Adresse: https://[vollständig qualifizierter
Hostname]:9443/jts/setup
- Die Seite 'Jazz Team Server' erscheint.
- Geben Sie bei einer Neuinstallation in den Feldern Benutzer-ID und Kennwort jeweils ADMIN ein. Beachten Sie die Groß-/Kleinschreibung. Klicken Sie auf Anmelden.
Anmerkung: - Verwenden Sie ADMIN (unter Beachtung der Groß-/Kleinschreibung) nicht als Benutzer-ID und Kennwort, wenn Sie Anwendungen für die Verwendung von LDAP
in
WebSphere Application Server konfiguriert haben. Melden Sie sich stattdessen als registrierter
LDAP-Benutzer mit JazzAdmins-Berechtigungen an.
- Verwenden Sie für WebSphere Application
Server unter z/OS mit RACF-Sicherheit
oder für WebSphere Application Server unter IBM® i mit Authentifizierung des lokalen Betriebssystems
eine Benutzer-ID, der auf dem System die JazzAdmins-Berechtigungen erteilt sind.
- Melden Sie sich bei einem Upgrade mit einer in der Vorversion verwendeten Verwaltungs-ID an und klicken Sie auf
Weiter.
Anmerkung: Falls Sie sich nicht anmelden können oder die Benutzer-ID keinen Verwaltungszugriff hat, überprüfen Sie, ob folgende
Aufgaben ausgeführt wurden:
- Apache Tomcat:
- Wenn Sie die Tomcat-Benutzerdatenbank verwenden, vergewissern Sie sich, dass die Datei tomcat-users.xml ordnungsgemäß
kopiert wurde.
- Falls Sie mit LDAP arbeiten, prüfen Sie, ob die LDAP-Einstellungen korrekt in die Datei
server.xml aufgenommen wurden.
- WebSphere Application Server:
- Prüfen Sie, ob die Rollen-Gruppen-Zuordnungen für
für alle Anwendungen
ordnungsgemäß konfiguriert sind.
- Klicken Sie auf der Seite Einführung auf Weiter.
- Geben Sie auf der Seite Öffentlichen URI konfigurieren das Stammverzeichnis eines öffentlichen
URL im Format https://[vollständig qualifizierter Hostname]:9443/jts an, wählen Sie das Kontrollkästchen Ich habe die
Konfigurationsempfehlungen für den öffentlichen URI gelesen und zur Kenntnis genommen. Ich bestätige, dass der URI ordnungsgemäß gesetzt ist. aus.
Klicken Sie
auf Verbindung
testen. Klicken Sie nach erfolgreich bestandenem Test auf Weiter. Wenn Sie ein Upgrade für
Jazz Team Server durchführen, können Sie diesen öffentlichen URI nicht
ändern.
Wichtig: Ein [vollständig qualifizierter Hostname] umfasst den Hostnamen
und die DNS-Domänenreferenz der Maschine, auf der
Jazz Team Server installiert wird.
Ein Beispiel für einen guten
[vollständig qualifizierten Hostnamen] ist clmwb.example.com.
Beispiele für schlechte
[vollständig qualifizierte Hostnamen] sind localhost und eine
IP-Adresse.
- Geben Sie auf der Seite Datenbank konfigurieren Informationen für die Konfiguration einer Verbindung zur Datenbank
ein.
Bei einem Upgrade müssten Sie die Datenbankkonfiguration sehen, die Sie während des Upgradeprozesses
angegeben haben. Vergewissern Sie sich, dass hier die erwarteten Werte angezeigt werden.
Wenn Sie die Derby-Datenbank verwenden, sollten Sie die Standardwerte nicht ändern. Sie werden in dem Fall nicht zur Erstellung von Datenbanktabellen aufgefordert.
Wenn Sie für eine Unternehmensdatenbank wie die von DB2, Oracle oder SQL Server die Standardwerte oder festgelegten Werte ändern, klicken Sie auf Verbindung
testen, um sicherzustellen, dass die Verbindung ordnungsgemäß konfiguriert ist.
Falls Sie die Datenbanktabellen nicht mit repotools erstellt haben, wird möglicherweise eine Warnung angezeigt,
dass die Datenbank vorhanden ist, jedoch keine Tabellen enthält. Klicken Sie zum Erstellen der Tabellen auf
Tabellen erstellen. Die Ausführung des Befehls kann mehrere Minuten dauern.
Testen Sie die Verbindung. Wenn keine Warnungen oder Fehler angezeigt werden, klicken
Sie auf Weiter.
- Auf der Seite E-Mail-Benachrichtigung aktivieren können Sie die E-Mail-Benachrichtigung aktivieren oder
inaktivieren. Wenn Sie die Benachrichtigung aktivieren, müssen Sie Informationen zu Ihrem E-Mail-Server angeben und die Verbindung zum E-Mail-Server
testen. Wenn Sie Ihre Auswahl getroffen und die Verbindung getestet haben, klicken Sie auf Weiter.
- Auf der Seite Anwendungen registrieren spürt der Assistent die Anwendungen auf,
die zusammen mit Jazz Team Server installiert wurden.
Es kann eine Minute dauern, bis alle Anwendungen aufgespürt und zur Liste der zu registrierenden Anwendungen
hinzugefügt sind. Der Assistent erkennt auch die Anwendung
Lifecycle Project Administration, die auf demselben Server wie der
Jazz Team
Server installiert sein muss. Der Assistent kann keine auf einem anderen Server installierten
Anwendungen aufspüren. Diese müssen Sie manuell hinzufügen (siehe unten Schritt c).
- Falls Sie die Anwendung nicht registrieren möchten, klicken Sie ganz rechts neben dem Anwendungsnamen auf das Symbol
. Normalerweise müssen alle Anwendungen registriert werden.
In einer der folgenden Situationen kann jedoch für bestimmte Anwendungen von dieser Regel abgewichen werden:
- Sie haben alle Anwendungen heruntergeladen und implementiert, haben jedoch nicht vor, sie alle zu verwenden.
- Sie verfügen nicht über Lizenzen, die den Zugriff auf eine Anwendung ermöglichen.
- Sie konfigurieren diese Jazz-Team-Server-Anwendung als
eigenständigen Server für Floating- oder Tokenlizenzierung.
- Überprüfen Sie den Anwendungstyp und den Erkennungs-URL der installierten Anwendungen. Der Assistent erstellt für alle Anwendungen vorab autorisierte funktionale Benutzer-IDs.
Was ist ein Erkennungs-URL?: Der Erkennungs-URL ist der URL einer Serviceergänzungsressource
für eine Anwendung.
Generell wird der SCR-URL
erstellt, indem zum öffentlichen URI der Anwendung /scr hinzugefügt wird. Der öffentliche URI der Anwendung Change
and Configuration Management lautet https://[vollständig qualifizierter
Hostname]:9443/ccm. Der entsprechende URL der Serviceergänzungsressource muss demzufolge
https://[vollständig qualifizierter Hostname]:9443/ccm/scr lauten.
Bei lokal installierten Anwendungen trägt der Konfigurationsassistent
diesen URL ein und gibt eine funktionale Benutzer-ID an.
- Wenn Sie eine auf einem anderen Server installierte Anwendung hinzufügen möchten, klicken Sie auf
Anwendung hinzufügen und geben Sie den Anwendungsnamen und den Erkennungs-URL an. Nach Angabe des Anwendungsnamens und des Erkennungs-URL wird die
Funktionale
Benutzer-ID generiert und automatisch in das Feld eingetragen.
Die funktionale Benutzer-ID wird für die Ausführung von Aufgaben im Hintergrund verwendet.
Sie muss nicht in der externen Benutzer-Registry oder als Benutzer im Repository
enthalten sein. Wenn es den Benutzer nicht im Repository gibt, wird er automatisch erstellt.
- Klicken Sie auf Anwendungen registrieren.
Anmerkung: Der Assistent erstellt Freundschaftsbeziehungen, registriert die Anwendungen und generiert für jede Anwendung einen Consumer-Schlüssel und einen geheimen Schlüssel.
- Klicken Sie nach erfolgreicher Registrierung auf Weiter, um die registrierten Anwendungen
zu konfigurieren.
Anmerkung: Im Menü auf der linken Seite ist jetzt die registrierte Anwendung mit untergeordneten Schritten
aufgelistet.
- Geben Sie auf der Seite Benutzer-Registry konfigurieren die folgenden Informationen an: Bei einem Upgrade ist Ihre Benutzer-Registry bereits konfiguriert. Sie müssen dem Benutzer mit Verwaltungsaufgaben eine
Lizenz zuweisen.
- Wählen Sie den Typ der zu verwendenden Benutzer-Registry aus.
Anmerkung: - Falls Sie
eine LDAP-Benutzer-Registry auswählen, müssen Sie Konfigurationsinformationen für die Verbindung zwischen
Jazz Team Server und Ihrem LDAP-Server angeben. Sie
müssen diese Informationen möglicherweise bei Ihrem LDAP-Administrator anfordern.
- Wählen Sie für WebSphere Application
Server unter z/OS mit RACF-Sicherheit
oder für WebSphere Application Server unter IBM i mit Authentifizierung des lokalen Betriebssystems
nicht LDAP als externe Registry aus.
- Geben Sie die Benutzer-ID, den Namen, das Kennwort und die E-Mail-Adresse des Benutzers an, der Administrationszugriff auf
Jazz Team Server haben soll.
- Wählen Sie abhängig von den installierten Anwendungen unter Rational Requirements Composer, Rational Team Concert und Rational Quality Manager
die Clientzugriffslizenzen aus, die dem Benutzer mit Verwaltungsaufgaben zugewiesen werden sollen. Dem Administrator können Sie nur einen rollenbasierten Clientzugriffslizenztyp zuweisen. Sie können
dem Administrator beispielsweise nur eine Rational-Team-Concert-Clientzugriffslizenz für Entwickler oder
eine
Rational-Team-Concert-Clientzugriffslizenz für Stakeholder zuweisen, jedoch nicht beide. Dieselbe Regel gilt für andere Anwendungen.
Falls Sie die Testlizenzen installiert haben, können Sie diese dem Benutzer mit Verwaltungsaufgaben erst zuweisen, nachdem Sie
die Lizenzbedingungen akzeptiert haben. Klicken Sie zum Aktivieren einer Lizenz
auf Test aktivieren. Klicken Sie dann im Fenster "Lizenzvereinbarung für Clientzugriffslizenz"
auf Ich akzeptiere die Bedingungen der Lizenzvereinbarung. und auf Fertigstellen.
- Wenn Sie Ihre
Auswahl getroffen haben, klicken Sie auf Weiter.
- Machen Sie auf der Seite Data Warehouse konfigurieren Angaben, um eine Verbindung zum
Data Warehouse zu konfigurieren. Das Data Warehouse ist eine Datenbank für Berichterstellung und Analysen. Standardmäßig ist die Anwendung
für die Verwendung der im Anwendungslieferumfang enthaltenen Derby-Datenbank konfiguriert. Wenn Sie auf einem Unternehmensdatenbankserver eine Datenbank vorbereitet haben, z. B.
DB2 oder
Oracle, müssen Sie Jazz Team
Server für die Verwendung dieser Datenbank konfigurieren.
- Optional: Konfigurieren Sie jetzt nicht das Data Warehouse. Klicken Sie auf Data Warehouse jetzt nicht konfigurieren. Übergehen Sie das Data Warehouse nur unter den folgenden Bedingungen:
- Sie haben vor, für eine Vorhandene Anwendung Rational Quality
Manager Version 2 ein Upgrade durchzuführen und alle folgenden Punkte treffen für Sie zu:
- Sie haben Rational Common
Reporting mit Rational Quality
Manager verwendet.
- Sie wollen die Anwendung Rational Quality
Manager zu dieser Jazz-Team-Server-Umgebung
hinzufügen.
- Sie möchten die vorhandene Datenbank von Rational Common
Reporting als Data Warehouse für Ihre CLM-Produkte verwenden.
- Sie führen gerade kein Upgrade für diese Anwendung Rational Quality Manager durch.
Wenn Sie ein Upgrade
für Ihre Anwendung Rational Quality
Manager durchführen, können Sie erneut den Konfigurationsassistenten aufrufen und
Jazz Team Server sowie die anderen Anwendungen für die Verwendung
der vorhandenen Datenbank von Rational Common Reporting konfigurieren.
- Sie haben Rational Insight
verwendet und alle folgenden Punkte treffen auf Sie zu:
- Sie möchten die vorhandene Data-Warehouse-Datenbank von Rational Insight
als Data Warehouse für Ihre CLM-Produkte verwenden.
- Sie haben noch kein Upgrade auf Rational Insight
Version 1.0.1.1 durchgeführt. Dies ist die erste Version mit Unterstützung für CLM.
Nachdem Sie ein Upgrade
auf Rational Insight
Version 1.0.1.1 durchgeführt haben, können Sie erneut den Konfigurationsassistenten aufrufen und
Jazz Team Server sowie die anderen Anwendungen für die Verwendung
der vorhandenen Rational-Insight-Datenbank konfigurieren.
Wenn Sie das Data Warehouse nicht konfigurieren, funktionieren Ihre Anwendungen. Es werden jedoch keine Berichtsdaten gespeichert, und die meisten
Berichte können nicht erstellt werden.
- Wählen Sie im Abschnitt "Datenbankanbieter und Verbindungstyp für Data-Warehouse konfigurieren"
Ihren Datenbankanbieter und den Verbindungstyp für diesen Datenbankanbieter aus. Standardmäßig wird die integrierte und vorkonfigurierte
Derby-Datenbank mit einer JDBC-Verbindung verwendet. Sie können diese Standardeinstellung übernehmen oder einen anderen Datenbankanbieter und einen anderen Verbindungstyp
auswählen.
- Falls Sie die Derby-Datenbank nicht verwenden, geben Sie im Abschnitt "Verbindungseigenschaften für Data-Warehouse-Datenbank konfigurieren"
die Verbindungseigenschaften für die Verbindung zu Ihrer Datenbank ein. Welche Werte erforderlich sind, richtet sich nach Ihrem Datenbankanbieter und nach dem Verbindungstyp.
- Geben Sie für Oracle oder Microsoft SQL
Server im Feld Ordner für Datenbanktabellenbereich den Pfad zu einem vorhandenen Verzeichnis auf dem Datenbankserver ein, auf dem
der Tabellenbereich erstellt werden soll.
- Falls Sie Rational Common
Reporting oder Rational Insight
verwendet haben und die vorhandene Data-Warehouse-Datenbank als Data Warehouse für Ihre CLM-Produkte
verwenden möchten, geben Sie die Informationen für die Verbindung zu der vorhandenen Datenbank
an. Sie werden aufgefordert, Tabellen zu Ihrer Rational-Common-Reporting-
oder Rational-Insight-Datenbank hinzuzufügen.
- Geben Sie die Anmeldeinformationen für einen funktionalen Benutzer ein, der die Datenerfassungsjobs ausführen soll. Wenn Sie Tomcat und die integrierte Tomcat-Benutzerdatenbank verwenden, wird dieser Benutzer in der Registry
erstellt. Falls Sie LDAP oder eine andere externe Registry verwenden, müssen Sie einen Benutzer angeben, der in der externen Registry
enthalten ist.
Anmerkung: Die Benutzer-ID, die Sie für den funktionalen Benutzer eingeben, muss sich von der des Benutzers mit Verwaltungsaufgaben, mit
der Sie gerade die Anwendung konfigurieren, unterscheiden.
- Klicken Sie auf die Schaltfläche Verbindung testen, um zu überprüfen, ob der Server
über die von Ihnen angegebenen Verbindungsinformationen erfolgreich mit der Datenbank kommunizieren kann.
- Falls Sie die Datenbanktabellen nicht mit einem repotools-Befehl erstellt haben, wird möglicherweise eine Warnung angezeigt,
dass die Datenbank vorhanden ist, jedoch keine Tabellen enthält. Klicken Sie zum Erstellen der Tabellen auf
Tabellen erstellen. Die Ausführung des Befehls kann mehrere Minuten dauern. Bei Verwendung des
Standard-Derby-Data-Warehouse wird diese Warnung nicht angezeigt.
- Klicken Sie auf Weiter.
- Konfigurieren Sie für jede Anwendung die Datenbank und das Data Warehouse. Die Schritte dafür sind mit den oben von Ihnen ausgeführten
vergleichbar.
Anmerkung: Requirements Management verwendet dieselbe Datenbank wie Jazz
Team Server. Im Menü für
Requirements Management sind daher keine Optionen für Datenbanken verfügbar.
Falls Sie in Schritt
10 nicht das Data Warehouse für Jazz Team Server
konfiguriert haben, wählen Sie auf der Seite Data
Warehouse konfigurieren der Anwendung Data Warehouse jetzt nicht konfigurieren aus.
Für den Benutzer, der die Datenerfassungsjobs ausführt, müssen Sie eine andere Benutzer-ID als die zum Konfigurieren der Anwendung verwendete
angeben.
- Klicken Sie auf der Seite Konfiguration abschließen für jede Anwendung auf
Anwendungskonfiguration abschließen.
In diesem Schritt werden der Consumer-Schlüssel und der geheime Schlüssel für eine Anwendung gespeichert
und
die Benutzer von Jazz Team Server
synchronisiert. Wenn Sie ein Upgrade für Rational Requirements Composer Version 2 durchführen oder eine Anwendung Requirements Management zu einer
vorhandenen Jazz-Team-Server-Umgebung hinzufügen, klicken Sie für die Anwendung Requirements Management außerdem auf Index
neu erstellen. Wenn Sie eine komplett neue Umgebung konfigurieren, muss der Index nicht neu erstellt werden. Wenn Sie eine Nachricht sehen, dass der Prozess beendet ist, klicken Sie auf
Weiter.
Anmerkung: Wenn sich die Anwendungen auf anderen Servern befinden und Sie die Fehlernachricht
"Fehler 500 - Während des abschließenden Schritts für die Anwendung ist ein unerwarteter
Fehler aufgetreten"
sehen, überprüfen Sie, ob die Server auf dasselbe Datum, dieselbe Uhrzeit und dieselbe Zeitzone eingestellt sind.
- Klicken Sie auf der Seite Konfiguration abschließen für die Anwendung Lifecycle Project Administration auf
Autorisieren.
Möglicherweise müssen Sie sich bei den registrierten Anwendungen anmelden. Melden Sie sich als Benutzer mit Verwaltungsaufgaben an. (Verwenden Sie dieselbe
Benutzer-ID wie für den Konfigurationsassistenten.) Klicken Sie dann auf Anwendungskonfiguration
fertigstellen.
Wenn der Prozess beendet ist, klicken Sie auf Weiter.
- Auf der Seite Zusammenfassung können Sie die Servereinstellungen überprüfen und eine der folgenden Optionen auswählen:
- Klicken Sie auf Benutzer erstellen oder auf Fertigstellen, um die Benutzerschnittstelle für Administration
von Jazz Team Server aufzurufen, auf der Sie den Server, Benutzer und Lizenzen verwalten können. Weitere Informationen hierzu
enthält der Abschnitt Jazz Team Server verwalten.
- Klicken Sie auf Lebenszyklusprojekte erstellen, wenn Sie auf die Anwendung
Lifecycle Projects Administration zugreifen möchten, um Projekte für die Verwaltung von Anwendungsbeziehungen
zu erstellen. Weitere Informationen hierzu enthält der Artikel Lebenszyklusprojekte
erstellen und verwalten.