In diesem Abschnitt sind die Prüfschritte beschrieben, die Sie nach einer Serverumbenennung ausführen
müssen.
Falls Fehler gemeldet werden, lesen Sie die Beschreibung der Wiederherstellungsprozeduren im Artikel Fehler bei der Serverumbenennung beheben.
Allgemeine Prüfungen bei Serverumbenennung in einer Bereitstellungsumgebung
Allgemeine Verwaltung von Jazz Team Server
- Melden Sie sich auf der Verwaltungsschnittstelle von Jazz Team Server an (z. B.
unter https://clmhost.production.example.org:9443/jts/admin).
- Überprüfen Sie die Homepage auf offensichtliche Fehler.
- Bewegen Sie den Mauszeiger auf verschiedene Links und prüfen Sie in der Statusleiste des Browsers, ob die angezeigten URLs die neu
zugeordneten URLs sind.
- Überprüfen Sie das Menü 'Home'.
- Öffnen Sie das Menü 'Home' und vergewissern Sie sich, dass keine Fehler vorliegen und dass keine Einträge fehlen.
- Bewegen Sie den Mauszeiger auf jeden Menüeintrag und überprüfen Sie die URLs in der Statusleiste des Browsers.
- Klicken Sie auf einige Einträge des Menüs 'Home' und überprüfen Sie die Seite, zu der Sie navigieren.
- Prüfen Sie die Verwaltungsseiten für Jazz Team Server,
Change and Configuration Management (CCM) und Quality Management
(QM). Rufen Sie für Jazz Team Server
die Seite server/jts/admin auf und klicken Sie auf Server
verwalten. Rufen Sie für die Anwendungen die Seite server/ccm/admin
bzw. server/qm/admin auf.
- Überprüfen Sie auf der Seite 'Statusübersicht' die Text- und URL-Links mit dem öffentlichen
URI von Jazz Team Server und des Clients
für Floating-Lizenzen.
- Wenn sich bei einer Umbenennung in einer Bereitstellungsumgebung Server außerhalb der Bereitstellungsumgebung befinden,
werden auf der Diagnoseseite Fehler für 'Anwendungen und Freunde' angezeigt.
- Überprüfen Sie auf der Seite 'Registrierte Anwendungen' (nur Jazz Team Server)
die Erkennungs-URLs und den Anwendungsstatus. Jede Anwendung muss mit einem grünen Haken versehen sein und den Status 'Installiert' haben.
- Suchen Sie auf der Seite 'Erweiterte Eigenschaften' nach url, http:
oder https://. Vergewissern Sie sich, dass es keine URLs gibt, die auf Produktionssysteme zeigen.
- Überprüfen Sie auf der Seite 'Freunde (abgehend)' den Root-Services-URI für jeden Freund.
- Überprüfen Sie auf der Seite 'Whitelist (abgehend)' die Whitelist-URLs.
- Wenn Sie ein Motiv für die Webbenutzerschnittstelle installiert hatten, prüfen Sie, ob es noch immer ordnungsgemäß angezeigt wird.
Requirements Management
- Prüfen Sie, ob die folgenden Einträge in fronting.properties den nach der Umbenennung richtigen URL enthalten:
- com.ibm.rdm.fronting.server.serverBaseUrl (der neue
JTS-URL)
- com.ibm.rdm.fronting.server.ConverterURL (ein neuer
RM-URL)
- com.ibm.rdm.fronting.server.RDMFrontsideURL (ein anderer neuer
RM-URL)
- Prüfen Sie, ob friendsconfig.rdf "jfs:oauthDomain" den nach der Umbenennung richtigen JTS-URL enthält.
- Navigieren Sie mit /rm/web zur Webanwendung RM und prüfen Sie, ob die Feeds für 'Dashboard' und 'Kürzlich' fehlerfrei
geladen werden. Prüfen Sie, ob der Artefakt-URL in einem Feed 'Kürzlich'
auf den neuen Server-URL zeigt und ob der Rich Text der Kurzinfo angezeigt wird.
- Klicken Sie neben einem vorhandenen Projekt auf den Link Artefakte anzeigen. Prüfen Sie, ob die Projektansichten
(Abschnitt 'Filtern nach' in Ansichten, Ansichten 'Kürzliche Artefakte') ordnungsgemäß angezeigt werden. Überprüfen Sie, ob die Artefakt-URLs in diesen Ansichten die umbenannten
URLs sind. Vergewissern Sie sich, dass die Ordnerbaumstruktur vorhanden ist und dass Sie fehlerfrei in der Struktur navigieren
können.
- Prüfen Sie, ob in vorhandenen Projekten Artefaktinhalte erstellt und bearbeitet werden können.
- Öffnen Sie in einem vorhandenen LPA-Projekt ein Textartefakt. Prüfen Sie in der Seitenleiste die Links zu
CCM oder QM. Vergewissern Sie sich, dass in den Links die neuen Server-URLs angegeben sind und dass die Kurzinfo angezeigt wird. Prüfen Sie, ob die CLM-Links im Rich Text
aktualisiert wurden und die neuen URLs enthalten. Vergewissern Sie sich, dass neue
CLM-Links erstellt werden können.
- Öffnen Sie ein RRCx-Artefakt, z. B. eine Skizze oder ein Anwendungsfalldiagramm.
Prüfen Sie, ob ein Bild im Diagramm im Nur-Lese-Modus angezeigt wird. Klicken Sie auf die
Schaltfläche Bearbeiten, um sich zu vergewissern, dass diese Artefakte bearbeitet werden können.
- Überprüfen Sie die Berichterstellung. Bestätigen Sie, dass die RM-ETL-Prozesse (Datenerfassungsjobs)
fehlerfrei ausgeführt werden können.
Berichte
- Klicken Sie nach einer Serverumbenennung auf der Verwaltungsseite für Berichte von
Jazz Team Server auf Alle Data-Warehouse-Erfassungsjobs für alle Anwendungen ausführen, um die ETL-Prozesse
(Datenerfassungsjobs) zu starten.
- Führen Sie einige sofort einsatzfähige Berichte unter Gemeinsame
Berichte aus, um sicherzustellen, dass diese weiterhin funktionieren.
- Falls RRDI installiert ist, erstellen Sie ein paar RRDI-Berichte, um sich zu vergewissern, dass dies weiterhin möglich ist. Erstellen Sie die Berichte in RRDI und von den Dashboards aus. Die Berichte müssen
vor und nach der Umbenennung erstellt werden, damit überprüft werden kann, ob durch die Serverumbenennung Fehler ausgelöst wurden.
- Überprüfen Sie den Berichtsserver-URL für QM und JTS.
- Geben Sie https://Host:Port/qm/admin oder https://Host:Port/jts/admin ein.
- Klicken Sie auf Berichte.
- Klicken Sie unter Konfiguration auf Verbindung für
angepasste Berichte.
- Sehen Sie sich den Berichtsserver-URL an.
Eclipse-Client von Rational Team Concert
- Aktualisieren Sie wie folgt die Repository-Verbindung:
- Erweitern Sie in der Ansicht Teamartefakte die Anzeige für
Repository-Verbindungen und wählen Sie die betreffende Repository-Verbindung aus.
- Wählen Sie im Kontextmenü Eigenschaften aus.
- Ersetzen Sie den URI auf der Seite Jazz-Repository-Verbindung durch den neuen Server-URI
von Rational Team Concert (z. B.
https://NeuerServer:9443/ccm).
In einem Dialogfenster müssten Sie gewarnt werden, dass sich der Serverstatus geändert hat und der Client neu
gestartet werden muss.
- Bestätigen Sie dies, um die Anzeige zu verlassen.
- Führen Sie anschließend einen Neustart des Clients aus.
- Falls für die Verbindung keine automatische Anmeldung ausgewählt ist, wählen Sie im Kontextmenü der Verbindung
Anmelden aus.
- Prüfen Sie, ob über die Verbindung eine erfolgreiche Anmeldung beim neuen Server möglich ist.
- Überprüfen Sie wie folgt die Links für Feeds:
- Erweitern Sie in der Ansicht Teamartefakte die Anzeige für
Feeds und wählen Sie einen Feed aus.
- Wählen Sie im Kontextmenü Eigenschaften aus.
- Überprüfen Sie das Feld Link.
- Falls Sie mit verteiltem SCM arbeiten, gehen Sie wie folgt vor:
- Starten Sie den Eclipse-Client. Öffnen Sie im Arbeitsbereichseditor die Arbeitsbereiche oder Datenströme mit
Datenflusszielen, die auf den umbenannten Server zeigen. Prüfen Sie, ob der Arbeitsbereichseditor das Datenflussziel
ordnungsgemäß anzeigt. Wenn das nicht der Fall ist, erscheint Nicht erreichbar.
- Überprüfen Sie zusätzlich, ob in diesem Arbeitsbereich Änderungen für das Ziel auf dem umbenannten Server bereitstellen und von diesem Ziel akzeptieren können.
- Prüfen Sie, ob Sie mit Änderungsmengen verlinkte Arbeitselemente und Änderungsanfragen öffnen können.
- Prüfen Sie, ob Arbeitsbereiche und Datenströme, die in die verteilte SCM involviert sind, nach der Serverumbenennung und nach Anwendung der Zuordnung
Änderungen akzeptieren und bereitstellen können.
- Wenn der umzubenennende Server RTC-Freunde hat, mit denen er verteilte SCM-Workflows gemeinsam nutzt,
prüfen Sie, ob die Zuordnung auf jeden dieser befreundeten Server angewendet wurde.
So stellen Sie sicher, dass für Änderungsanfragen, die mit Änderungsmengen verlinkt sind, und für die Datenflusstabelle in
Arbeitsbereichen und Datenströmen die richtigen Zuordnungen gelten.
SCM-Befehlszeilenschnittstellenclient
- Prüfen Sie, ob der Registry-Eintrag für das umbenannte Repository aktualisiert wurde und den neuen Server-URL enthält. Dieser URL wird erst zugeordnet, wenn der Benutzer
lscm login für den neuen Server-URL ausführt. Repository-Einträge in der Registry können Sie mit lscm
ls cred auflisten.
- Prüfen Sie nach Ausführung von 'lscm login' für den neuen Server-URL, ob die vor der Serverumbenennung benutzten Aliasnamen
noch verwendet werden können.
- Verifizieren Sie, dass der alte Server-URL nicht in der CLI-Ausgabe auftaucht.
- Überprüfen Sie, ob die geladenen Arbeitsbereiche des umbenannten Servers Änderungen akzeptieren und bereitstellen können.
- Prüfen Sie, ob Arbeitsbereiche und Datenströme, die in die verteilte SCM involviert sind, nach der Serverumbenennung und nach Anwendung der Zuordnung
Änderungen akzeptieren und bereitstellen können.
Arbeitselemente
- Verifizieren Sie, dass alle in Zusammenfassungen, Beschreibungen, Kommentare und angepasste Zeichenfolgenattribute von Arbeitselementen eingebetteten Links
auf den neuen Server-URL zeigen.
- Verifizieren Sie, dass Arbeitselementlinks (z. B. CLM-Links), zugehörige Artefakte und Links in Erwähnungen auf den
neuen Server-URL zeigen.
- Überprüfen Sie, ob Sie Links zu umbenannten CLM-Servern hinzufügen und entfernen können und ob die Kurzinfos angezeigt werden.
- Überprüfen Sie, ob die Beschriftung der Arbeitselementlinks, die dem URL-Namen entspricht,
aktualisiert wurde und den neuen Server-URL enthält.
Jazz Team Build
- Überprüfen Sie externe Links in Build-Ergebnissen.
- Überprüfen Sie verlinkte Downloads und Protokolle in Build-Ergebnissen, d. h. die als Link zu einem externen System veröffentlichten
Ergebnisse, die nicht in Rational Team Concert hochgeladen werden.
- Überprüfen Sie alle Build-Forge-, Build-Agent- und/oder Hudson-Build-Steuerkomponenten und vergewissern Sie sich, dass die
externen Server, auf die diese Steuerkomponenten verweisen, die für die Zeit nach der Serverumbenennung geplanten
Server sind. Diese Server werden nicht automatisch zugeordnet. Falls die Umbenennung in einer Bereitstellungsumgebung mit einer Produktionsimplementierung erfolgt, sollten Sie diese Steuerkomponenten
inaktivieren oder löschen, um zu verhindern, dass von der Bereitstellungsumgebung aus Builds auf Build-Servern in der Produktionsumgebung
erstellt werden können.
- Überprüfen Sie die URL-Eigenschaften von Build-Steuerkomponenten und Build-Definitionen, z. B. Hostname und Port. Diese werden nicht automatisch zugeordnet und müssen möglicherweise
manuell aktualisiert werden. Ähnlich verhält es sich bei URLs in Build-Scripts. Auch diese müssen möglicherweise
aktualisiert werden.
Dashboards
- Navigieren Sie zu Ihren Dashboards und prüfen Sie, ob diese ordnungsgemäß mit allen Widgets von den umbenannten Servern
geladen werden.
- Überprüfen Sie, ob die verschiedenen Arten von Dashboards korrekt geladen werden, z. B. persönliche Dashboards
auf dem JTS, das Mini-Dashboard oder Projekt- und Team-Dashboards in
CCM/QM/RM.
- Prüfen Sie, ob das Drop-down-Menü 'Home' Ihre Liste persönlicher Dashboards enthält.
- Überprüfen Sie, ob die Einstellungen von Widgets mit URL-Vorgaben den aktualisierten URL enthalten.
- Überprüfen Sie den Feed mit Neuigkeiten (für externe RSS- oder Atom-Feeds) und das Widget 'Externer Inhalt'
(für die Einbettung anderer Seiten).
- Überprüfen Sie, ob Links in Widgets, Lesezeichen, HTML und Überschriften aktualisierte URLs enthalten.
- Optional: Fügen Sie ein Widget zu einem Projekt- oder Team-Dashboard hinzu und klicken Sie auf Speichern.
Aktualisieren Sie dann die Browseranzeige und vergewissern Sie sich, dass die Modifikation übernommen wurde und ordnungsgemäß geladen wird.
Lifecycle Project Administration (LPA)
- Melden Sie sich als Benutzer mit Repository-Berechtigung JazzAdmins bei der Anwendung Lifecycle Project Administration an. Einzelheiten hierzu
enthält der Artikel Anmeldung bei der Anwendung Lifecycle Project Administration.
- Überprüfen Sie für vorhandene Lebenszyklusprojekte, ob Hyperlinks für Artefaktcontainer und die diesen Containern zugeordneten Elemente
den neuen Server-URL enthalten.
- Klicken Sie auf ein vorhandenes Lebenszyklusprojekt, um es zu bearbeiten. Laden Sie die Ressource Empfohlene
Rollenzuweisungen herunter und überprüfen Sie, ob es sich den URLs um die erwarteten URLs handelt.
- Prüfen Sie, ob auf der Registerseite 'Schablonen' Schablonen aufgelistet sind.
Prozess und Prozess-Authoring auf der Webbenutzerschnittstelle
- Überprüfen Sie in jedem Projektbereichseditor auf der Registerseite 'Übersicht' alle Projektbereichslinks im Abschnitt 'Zuordnungen'.
- Überprüfen Sie auf der Registerseite 'Prozessbeschreibung' alle Hyperlinks in der Prozessbeschreibung.
- Überprüfen Sie bei gemeinsamer Prozessnutzung im konsumierenden Projektbereich den Link zu dem Projektbereich, der den gemeinsamen Prozess bereitstellt.
Planung
- Prüfen Sie, ob die Arbeitselemente unter 'Geplante Elemente' auf den neuen Server-URL zeigen.
- Überprüfen Sie vorhandene Links auf der Registerseite 'Geplante Elemente' (Referenzspalten wie 'Untergeordnete Elemente', 'Implementiert Anforderungen',
'Testfall für Test' usw.).
- Erstellen Sie auf der Registerseite 'Geplante Elemente' neue Links zu RM, QM und CCM.
- Überprüfen Sie unter 'Planung' auf der Registerseite 'Links' alle vorhandenen Links.
- Fügen Sie neue Links 'Überwacht' / 'Leistet Beiträge für' zum Plan hinzu.
Rational ClearQuest Bridge
Führen Sie die folgenden Schritte für die Validierung der Serverumbenennung
in der angegebenen Reihenfolge aus.
- Prüfen Sie ,ob Sie neue Links von den CLM-Anwendungen zur integrierten
ClearQuest-Benutzerdatenbank erstellen können.
- Prüfen Sie, ob Sie über vorhandene Links von den CLM-Anwendungen zu ClearQuest-Datensätzen gelangen.
- Prüfen Sie, ob Sie neue Links von der
ClearQuest-Benutzerdatenbank zu den CLM-Anwendungen, in die die Datenbank integriert ist, erstellen können.
Tritt bei diesem Prüfschritt ein Fehler auf, enthalten die
Konfigurationsdateien von ClearQuest Web Server Fehler. Führen Sie das Tool für erneute Zuordnung zwischen ClearQuest und CLM (Remapping
Tool) mit der Option -remapconfigfiles aus, um die in den
ClearQuest-Web-Server-Konfigurationsdateien gespeicherten URLs zu aktualisieren. Ausführliche Informationen zum
Remapping Tool enthält
der Artikel URIs nach Umbenennen eines
CLM-Servers neu zuordnen. Nach Ausführung des Tools müssen Sie den
ClearQuest Web Server neu starten.
- Prüfen Sie, ob Sie über vorhandene Links von ClearQuest Web zu CLM-Artefakten gelangen.
Tritt bei diesem Prüfschritt ein Fehler auf, enthält die
ClearQuest-Benutzerdatenbank veraltete URLs. Führen Sie das Tool für erneute Zuordnung zwischen ClearQuest und CLM (Remapping
Tool) mit der Option -update aus, um die in der
ClearQuest-Benutzerdatenbank gespeicherten URLs zu aktualisieren.
Rational ClearQuest Synchronizer
Wenn Sie die Serverumbenennung für eine Bereitstellungsumgebung
durchführen, überprüfen Sie, ob die abgehende Synchronisation über die Webadministration oder die externe Repository-Verbindung
inaktiviert ist.
Wenn Sie die Serverumbenennung für eine Pilotimplementierung durchführen, die in die
Produktion überführt werden soll, erscheinen in Arbeitselementfeldern mit URLs nach der Serverumbenennung die aktualisierten URLs.
Diese Änderungen werden aber nicht automatisch mit CQ synchronisiert. Setzen Sie die Synchronisation dieser aktualisierten Links manuell durch. Einzelheiten
hierzu enthält der Artikel Aktionen für den ClearQuest
Synchronizer nach einer Serverumbenennung -
Szenario 'Pilotprojekt für Produktion'.
Wenn sehr viele Arbeitselemente synchronisiert werden müssen, kann dieser Vorgang lange
dauern. Überprüfen
Sie nach der Synchronisation Folgendes:
- Prüfen Sie, ob es sich bei URLs in Überschriften oder Beschreibungsfeldern synchronisierter CQ-Defects um den aktualisierten URL des jeweiligen
Arbeitselements handelt.
- Links in CQ-Kommentaren enthalten weiterhin die veralteten URLs. Sie sollten jedoch einen neuen CQ-Kommentar sehen, in dem der Benutzer über die Serverumbenennung
informiert wird.
- Bestätigen Sie, dass CQ-Kommentare mit veralteten URLs nicht über die Synchronisation wieder in die Anwendung
Change and Configuration Management (CCM) gelangen.
Integrierte Rational-ClearCase-Produkte (Synchronizer
und Bridge)
ClearCase Synchronizer
- Prüfen Sie, ob Synchronisations-Build-Steuerkomponenten nach ihrem Neustart von der Ansicht 'Synchronisierte ClearCase-Datenströme' aus eine Verbindung zum umbenannten
Server herstellen. In der Konsole der Build-Steuerkomponente sollte Warten auf
Anforderung und nicht Repository-Verbindung fehlgeschlagen angezeigt werden.
ClearCase Bridge
- Prüfen Sie im CTE/RTC-Eclipse-Client, ob von UCM-Aktivitäten oder Base-ClearCase-Versionen aus das zugehörige Arbeitselement geöffnet werden kann.
- Überprüfen Sie bei verwendetem VOB-Schema 80 und der Produktstufe 7 oder höher mit dem Befehl
cleartool describe, ob der Arbeitselement-URL in den zugehörigen Base-ClearCase-Versionen
aktualisiert wurde. Wenn das nicht der fall ist, muss der URL des Arbeitselements
nicht überprüft werden.
Enterprise Extensions
- Prüfen Sie, ob im
Eclipse-Client von Rational Team Concert in der Ansicht 'Teamartefakte' noch alle Enterprise-Extensions-Definitionen
angezeigt werden und geöffnet werden können.
- Öffnen Sie ein vorhandenes Ergebnis eines Abhängigkeits-Builds. Überprüfen Sie, ob der Build-Bericht noch aufgerufen werden kann und den neuen Server-URL
enthält.
- Erstellen Sie nach der Umbenennung einen Abhängigkeits-Build. Prüfen Sie, ob der Build erfolgreich abgeschlossen werden kann und ob alle verwendeten Systemdefinitionen
aufgelöst werden.
- Verifizieren Sie im Navigator für Teamartefakte, dass alle vorhandenen Quellcodedatenabfragen noch sichtbar sind und fehlerfrei ausgeführt werden können.