Pilotimplementierung mittels Serverumbenennung in die Produktion überführen

In diesem Artikel sind die Schritte beschrieben, mit denen Sie Server-URLs ändern müssen, wenn Sie eine kleine CLM-Pilotimplementierung in die Produktion überführen.

Vorbereitende Schritte

Überprüfen Sie vor der Umbenennung, ob Ihre Umgebung die Kriterien für das Szenario 'Überführung einer Pilotimplementierung in die Produktion' erfüllt. Weitere Details finden Sie im Artikel Unterstützte Szenarien.

Wichtig: Für eine Serverumbenennung müssen der Jazz Team Server und alle CLM-Anwendungen auf dem Stand von Version 4 oder einer aktuelleren Version sein.

Im folgenden Diagramm ist der allgemeine Ablauf der Umbenennung dargestellt.

Szenario 'Pilotimplementierung in die Produktion überführen'

Informationen zu diesem Vorgang

Im Rahmen dieses Verfahrens werden Sie die Daten und Konfigurationsdateien von den Pilotservern auf die Produktionsserver kopieren. Da Sie die Datenbanken nicht kopieren, sondern verlagern, muss die Pilotumgebung für diesen Schritt durchgehend außer Betrieb sein, um den Eintrag von Daten in die Produktionsumgebung zu vermeiden.

Das Feature für Serverumbenennung bestimmt anhand einer Zuordnungsdatei, welche URLs umbenannt werden müssen. Es gibt einen repotools-Befehl, mit dem Sie eine erste Zuordnungsdatei generieren können. Die Zuordnungsdatei enthält source-target-Paare für JTS und alle Anwendungen sowie für alle weiteren, von Anwendungen beigetragenen URLs. Weitere Einzelheiten zur Zuordnungsdatei enthält der Artikel Zuordnungsdatei für die Serverumbenennung verstehen. Beispiele für Topologiediagramme und Zuordnungsdateien finden Sie im Artikel Topologien und Zuordnungsdateien für das Szenario 'Überführung einer Pilotimplementierung in die Produktion'.

Vorgehensweise

  1. Erstellen und prüfen Sie die Zuordnungsdatei vor der eigentlichen Umbenennung, solange Ihre Server noch online sind. Gehen Sie dazu wie im Artikel Zuordnungsdatei erstellen beschrieben vor.

    Falls Sie Ihre Implementierung auf einen neuen Computer verlagern, führen Sie die Installation auf dem neuen Computer durch. Wenn Sie den URL desselben Computers ändern, wählen Sie für die Installation ein anderes Verzeichnis als für die bereits vorhandene Installation. Sollten Sie auch das Kontextstammverzeichnis ändern, lesen Sie die Informationen im Artikel Kontextstammverzeichnis ändern.

    Das Endergebnis der Vorbereitungsphase ist eine Zuordnungsdatei, die im Pilot-Jazz-Team-Server generiert wird. Die Zuordnungsdatei enthält source-target-Paare für Jazz Team Server und alle Anwendungen sowie für alle weiteren, von Anwendungen beigetragenen URLs.

  2. Erstellen Sie eine Sicherung der Pilotumgebung mit Version 4 und kopieren Sie Textindizes und Anwendungskonfigurationsdateien in die neue Installation.
    1. Stoppen Sie Jazz Team Server und alle dezentralen CLM-Anwendungen, die bei Jazz Team Server registriert sind.

      Stoppen Sie alle anderen Anwendungsserver, die von der Serverumbenennung betroffen sind, z. B. die Jazz-Build-Steuerkomponente, sowie alle integrierten Produkte, die betroffen sind, wie Rational Reporting for Development Intelligence (RRDI), Rational ClearCase oder Rational ClearQuest.

      Anmerkung: Wenn die Server inaktiv sind, können Benutzer von externen Systemen, die in die umzubenennende CLM-Implementierung integriert sind, keine Links erstellen oder verwenden.
    2. Sichern Sie die Datenbanken in der CLM-4.0-Pilotumgebung, einschließlich der Datenbank für Jazz Team Server und der Datenbanken für die Anwendungen CCM und QM, der Data-Warehouse-Datenbank und der Content-Store-Datenbank für RRDI (sofern Sie RRDI verwenden). Falls Sie den Datenbankserver oder -anbieter wechseln, informieren Sie sich im Artikel CLM-Datenbank verlagern über die zusätzlichen Schritte.
    3. Kopieren Sie die JFS- bzw. Textindizes vom Quellenpilotserver auf den Zielproduktionsserver. (Bei verteilten Systemen müssen Sie die Dateien vom entsprechenden Server kopieren.)

      Bei den folgenden Beispielen für einen Linux-Server wird davon ausgegangen, dass die Laufwerke der Produktionscomputer angehängte Netzlaufwerke sind. Sollte dies in Ihrer Umgebung nicht möglich sein, nutzen Sie zum Kopieren der Dateien andere Dateiübertragungsmethoden.

      cp -R Quellen-Jazz-Installationsverzeichnis/server/conf/jts/indices Ziel-Jazz-Installationsverzeichnis/server/conf/jts
      cp -R Quellen-Jazz-Installationsverzeichnis/server/conf/ccm/indices Ziel-Jazz-Installationsverzeichnis/server/conf/ccm
      cp -R Quellen-Jazz-Installationsverzeichnis/server/conf/qm/indices Ziel-Jazz-Installationsverzeichnis/server/conf/qm 
    4. Kopieren Sie die Anwendungskonfigurationsdateien vom Quellenpilotserver auf den Zielproduktionsserver. (Bei verteilten Systemen müssen Sie die Dateien vom entsprechenden Server kopieren.) Wie im vorherigen Schritt beziehen sich die folgenden Beispiele auf einen Linux-Server und es wird davon ausgegangen, dass die Laufwerke der Produktionscomputer angehängte Netzlaufwerke sind.
      cp Quellen-Jazz-Installationsverzeichnis/server/conf/jts/teamserver*.properties Ziel-Jazz-Installationsverzeichnis/server/conf/jts
      cp Quellen-Jazz-Installationsverzeichnis/server/conf/ccm/teamserver*.properties Ziel-Jazz-Installationsverzeichnis/server/conf/ccm
      cp Quellen-Jazz-Installationsverzeichnis/server/conf/qm/teamserver*.properties Ziel-Jazz-Installationsverzeichnis/server/conf/qm
      cp Quellen-Jazz-Installationsverzeichnis/server/conf/admin/admin.properties* Ziel-Jazz-Installationsverzeichnis/server/conf/admin
      cp Quellen-Jazz-Installationsverzeichnis/server/conf/admin/friends.rdf* Ziel-Jazz-Installationsverzeichnis/server/conf/admin
      cp Quellen-Jazz-Installationsverzeichnis/server/conf/rm/fronting.properties Ziel-Jazz-Installationsverzeichnis/server/conf/rm
      cp Quellen-Jazz-Installationsverzeichnis/server/conf/rm/friendsconfig.rdf Ziel-Jazz-Installationsverzeichnis/server/conf/rm 
    5. Kopieren Sie die Zuordnungsdatei in das Verzeichnis Ziel-Jazz-Installationsverzeichnis\server auf dem Produktionsserver. Einzelheiten zur Zuordnungsdatei enthält der Artikel Zuordnungsdatei erstellen.
  3. Führen Sie den Offlineabschnitt der Serverumbenennung aus. Importieren Sie dazu mit dem Befehl repotools-jts -importURLMappings die Zuordnungsdatei in den Ziel-Jazz-Team-Server in der Produktionsumgebung.
    1. Wenn Sie eine zentrale Implementierung mit nur einem Server haben, können Sie die Zuordnungsdatei wie folgt mit dem Befehl repotools-jts.bat -importURLMappings importieren:
      • For Windows operating system repotools-jts.bat -importURLMappings fromFile=".\mappings.txt"
      • For Unix operating systems ./repotools-jts.sh -importURLMappings fromFile="./mappings.txt"

      Die Umbenennung beginnt offline im Jazz Team Server, bevor der Server erneut gestartet wird.

    2. Wenn Sie in einer verteilten Implementierung arbeiten und die Möglichkeit haben, Netzlaufwerke zuzuordnen, ordnen Sie jedem der Anwendungshosts ein Netzlaufwerk vom Jazz-Team-Server-Host zu. Erstellen Sie dann eine Datei (z. B. serverConfFile.txt) mit einer Liste aller fernen server/conf-Verzeichnisse Ihrer Umgebung im folgenden Format:
       # Ferner CCM Server
         x:/JazzTeamServer/server/conf
         # Ferner QM Server
         y:/JazzTeamServer/server/conf
         # Ferner RM Server
         z:/JazzTeamServer/server/conf

      Führen Sie abschließend den Befehl repotools-jts -importURLMappings wie folgt aus und fügen Sie den Parameter serverConfFile= hinzu.

      • For Windows operating system repotools-jts.bat -importURLMappings fromFile=".\mappings.txt" serverConfFile=".\serverConf.txt"
      • For Unix operating systems ./repotools-jts.sh -importURLMappings fromFile="./mappings.txt" serverConfFile="./serverConf.txt"
    3. Sollten Sie in einer verteilten CLM-Implementierung arbeiten und nicht die Möglichkeit haben, Netzlaufwerke neu zuzuordnen, führen Sie den Befehl repotools-jts -importURLMappings (ohne den Parameter serverConfFile=) aus. Kopieren Sie dann die Datei server/conf/jts/.mappingEvent in die Konfigurationsverzeichnisse der fernen Anwendungen (server/conf/Anwendungsname, wobei /Anwendungsname für ccm, qm oder rm steht). Die Ereignisdatei wird generiert, wenn Sie die Zuordnungen importieren. Die Datei .mappingEvent müssen Sie nach dem Import der Zuordnungsdatei und vor dem Start des Servers kopieren.

      Die Datei .mappingEvent enthält Informationen, die die Anwendungen für den Kontakt zum Jazz Team Server an seiner neuen Position benötigen. Ein Jazz Team Server und die bei diesem registrierten Anwendungen verwenden eine Datei .mappingEvent mit identischem Inhalt.

    Anmerkung: Unter z/OS ausgeführte Server sollten mit dem Beispiel-JCL-Member HLQ.SBLZSAMP(BLZRENAM) umbenannt werden. Ausführliche Anpassungsanweisungen finden Sie in den Kopfdaten von BLZRENAM in den Kommentaren.

    Überprüfen Sie die Konsolausgabe und die Datei Jazz-Installationsverzeichnis/server/repotools-jts_importURLMappings.log, um sich zu vergewissern, dass die Umbenennung erfolgreich war. Falls Fehler angezeigt werden oder Sie meinen, dass Ihnen in der Zuordnungsdatei ein Fehler unterlaufen ist, bestimmen Sie präzise, um welchen Fehler es sich handelt, und korrigieren Sie ihn. Informationen dazu finden Sie im Artikel Fehler bei der Serverumbenennung beheben.

  4. Starten Sie Jazz Team Server und alle installierten dezentralen CLM-Anwendungen.

    Jetzt werden die CLM-Anwendungen mit Jazz Team Server synchronisiert, um die URL-Zuordnungen anzuwenden und ihre Data-Warehouse-Daten zu aktualisieren. Dieser Prozess dauert für eine kleine Dateigruppe etwa fünf Minuten und für eine sehr große Dateigruppe bis zu 30 Minuten oder noch länger.

  5. Melden Sie sich bei Jazz Team Server an (https://Hostname:Port/jts/serverRenameStatus), um den Fortschritt der Umbenennung zu überwachen. (Verwenden Sie beispielsweise den URL https://clmhost.production.example.org:9443/jts/serverRenameStatus.) Die Seitenanzeige wird automatisch aktualisiert, bis die Umbenennung abgeschlossen ist.

    Falls Fehler angezeigt werden, bestimmen Sie präzise, um welche Fehler es sich handelt, und korrigieren Sie sie. Informationen dazu finden Sie im Artikel Fehler bei der Serverumbenennung beheben.

    Anmerkung: Bei jedem Versuch, sich vor Abschluss der Umbenennung bei der Webbenutzerschnittstelle einer CLM-Anwendung anzumelden, werden Sie zu dieser Statusseite umgeleitet.
  6. Führen Sie die im Artikel Serverumbenennung überprüfen beschriebenen Schritte aus, um die Serverumbenennung zu überprüfen.
  7. Führen Sie bei Bedarf die folgenden Schritte aus, um Rational Reporting for Development Intelligence (RRDI) in der Produktionsumgebung zu konfigurieren.
    1. Sichern Sie die folgenden Datenbanken aus der Pilotumgebung und speichern Sie sie auf einem neuen Datenbankserver für die Neuinstallation von RRDI in der Produktionsumgebung zurück:
      • Content-Store-Datenbank (z. B RICM, sofern noch nicht gesichert und wiederhergestellt)
      • Data Warehouse (z. B. RIDW, sofern noch nicht gesichert und wiederhergestellt)
    2. Installieren Sie Rational Reporting for Development Intelligence Version 2.0 in der Produktionsumgebung. Einzelheiten hierzu enthält der Artikel Rational Reporting for Development Intelligence mit Installation Manager installieren.
    3. Konfigurieren Sie den Berichtsserver. Führen Sie dazu die RRDI-Setup-Anwendung aus. Einzelheiten hierzu enthält der Artikel Aufgaben nach der Installation. Vergessen Sie nicht, die folgenden Aktionen auszuführen:
      • Geben Sie auf der Seite Configure Content Store Database die Verbindungseigenschaften für die Content-Store-Datenbank (z. B. RICM) ein, die Sie in Schritt 7.a wiederhergestellt haben.
      • Geben Sie auf der Seite Configure Data Warehouse die Verbindungseigenschaften für die Data-Warehouse-Datenbank (z. B. RIDW) ein, die Sie in Schritt 7.a wiederhergestellt haben.
    4. Melden Sie sich bei Jazz Team Server an und prüfen Sie die auf der Verwaltungsseite von Jazz Team Server und den Anwendungen CCM und QM die unter Erweiterte Eigenschaften gespeicherten Berichtsserver-URLs. Die neuen URLs müssen auf den RRDI-Berichtsserver in der Produktionsumgebung zeigen. Ist das nicht der Fall, müssen Sie sie entsprechend aktualisieren.
      Anmerkung: Enthielt Ihre Zuordnungsdatei Zuordnungen für den Berichtsserver-URL, müssten diese automatisch aktualisiert worden sein.
    5. Verifizieren Sie, dass alle bisher importierten Berichte vom RRDI-Berichtsserver aus der Pilotimplementierung weiter funktionieren.
    6. Alle Cognos-Berichte oder -Berichtsansichten mit gesetzter Aktion View most recent report müssen nach einer CLM-Serverumbenennung neu erstellt werden, damit der zwischengespeicherte HTML-Bericht aktualisiert wird.
      1. Melden Sie sich beim RRDI-Berichtsserver an.
      2. Suchen Sie nach Berichten oder Berichtsansichten mit zwischengespeicherten Ausgabeversionen.
        Anmerkung: Wenn Sie eine zwischengespeicherte Ausgabeversion für einen Bericht oder eine Berichtsansicht finden, können Sie auf View the output versions klicken, um die zwischengespeicherten Berichte anzuzeigen. Falls die Berichte oder Berichtsansichten vor der CLM-Serverumbenennung generiert wurden, müssen Sie diese erneut erstellen, um sie zu aktualisieren. Andernfalls sehen Benutzer, die die Berichte oder Berichtsansichten verwenden, ungültige Links, die auf den alten CLM-Server zeigen.
      3. Klicken Sie auf Run with Options, um die Berichte oder Berichtsansichten neu zu erstellen.
      4. Klicken Sie in der Berichtsanzeige auf Keep this version > Save Report, um die zwischengespeicherten Ausgabeversionen der Berichte oder Berichtsansichten zu aktualisieren.
    7. Importieren Sie einen neuen Bericht vom RRDI-Berichtsserver in der Produktionsumgebung. Verifizieren Sie, dass der Bericht importiert wurde und ohne Probleme ausgeführt werden kann.
    8. Falls Sie in RRDI Liveberichte für Rational Quality Manager konfiguriert haben, generieren Sie die xdc-Datei für den neuen Server und konfigurieren Sie sie im 32-Bit-ODBC-Manager. Einzelheiten hierzu enthält der Artikel Erstellung von Liveberichten einrichten.
  8. Führen Sie alle weiteren Schritte aus, die für die Integration anderer Komponenten und Produkte wie die Jazz-Build-Steuerkomponenten, Rational Reporting, die Clients von Rational Team Concert, Rational ClearQuest oder Rational ClearCase erforderlich sind, um die Serverbenennung abzuschließen. Einzelheiten hierzu enthält der Artikel Einschränkungen und zusätzliche Informationen.

Feedback