Bereitstellungsumgebung mit Produktionsdaten zu Testzwecken einrichten

In diesem Artikel ist beschrieben, wie Sie mit dem Feature für Serverumbenennung eine Bereitstellungsumgebung mit tatsächlichen Produktionsdaten einrichten können. Eine Bereitstellungsumgebung ist eine Test-Sandbox, die von der Produktionsumgebung isoliert ist. In dieser Sandbox können Sie neue Features oder Funktionen an realen Daten ausprobieren, ohne dass sich Auswirkungen auf die Produktionsdatenbank ergeben.

Informationen zu diesem Vorgang

Wichtig: Dieses Verfahren ist nicht geeignet, um für Ihre Umgebung ein Upgrade für ein früheres Release durchzuführen. Die Serverumbenennung wird erst ab Version 4 unterstützt. Ein Upgrade auf Version 4 ist daher die Vorbedingung für das Einrichten einer Bereitstellungsumgebung mittels Serverumbenennung.

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 Jazz Team Server 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 die Einrichtung einer Bereitstellungsumgebung zu Testzwecken.

Wenn Sie eine Bereitstellungsumgebung planen, müssen Sie besonders darauf achten, dass keine Wechselwirkung mit den Produktionsdaten möglich ist. Dies können Sie auf zwei Wegen sicherstellen. Zum Einen können Sie Einträge zur Datei hosts hinzufügen, wenn das in Ihrer Umgebung erlaubt ist. Zum Anderen können Sie Zuordnungen erstellen, die die nicht in der Bereitstellungsumgebung vorhandenen Server maskieren. In die Zuordnung müssen Sie alle weiteren CLM-Server und Nicht-CLM-Produkte aufnehmen, die eine Verbindung zum Produktionsserver herstellen können. Einzelheiten hierzu finden Sie in Schritt 3.c und im Artikel Pseudozuordnungen für Bereitstellungsumgebungen.

Angenommen, es gibt auf einem Produktionsserver eine Anwendung Change and Configuration Management (CCM) mit Links zur Anwendung CCM auf einem anderen Produktionsserver sowie Links zu Quality Management (QM) auf einem wieder anderen Produktionsserver. Darüber hinaus könnten Nicht-CLM-Produkte wie Rational ClearQuest eingebunden sein. In einem solchen Fall sollten Sie zuerst den URL des zusätzlichen CCM-Servers und QM-Servers maskieren und sicherstellen, dass der URL für Rational ClearQuest ebenfalls maskiert ist oder auf andere Weise einem Rational-ClearQuest-Gateway-Server in der Bereitstellungsumgebung zugeordnet ist.

Wichtig: Ein Rational Team Concert Client darf keine Verbindung zu den Produktions-Repositorys herstellen können, wenn er mit den Bereitstellungs-Repositorys verbunden werden kann, und umgekehrt. Nutzen Sie für die Verbindung zum Bereitstellungsserver stets einen Bereitstellungsarbeitsbereich.

Im folgenden Diagramm sind die wichtigsten Schritte für das Einrichten einer Bereitstellungsumgebung mithilfe einer Serverumbenennung dargestellt. Hier ist vorausgesetzt, dass die jeweils aktuellste Version von CLM (Version 4) und RRDI (Version 2) bereits installiert ist.

Szenario 'Produktionsimplementierung in Bereitstellungsumgebung verlagern'

Vorgehensweise

  1. Bereiten Sie die Umbenennung vor, indem Sie die Schritte im Artikel Zuordnungsdatei erstellen ausführen.

    Sie müssen für alle betroffenen URLs in der Zuordnungsdatei Pseudozuordnungen erstellen. Damit vermeiden Sie Querverbindungen zwischen der Bereitstellungs- und der Produktionsumgebung. Einzelheiten hierzu finden Sie im Artikel Pseudozuordnungen für Bereitstellungsumgebungen.

    Das Endergebnis der Vorbereitungsphase ist eine Zuordnungsdatei, die im ursprünglichen Quellen-Jazz-Team-Server generiert wird. Nachdem Sie die Zuordnungsdatei sorgfältig bearbeitet und überprüft haben, können Sie sie in das Verzeichnis Jazz-Installationsverzeichnis\server des Ziel-Jazz-Team-Servers in der Bereitstellungsumgebung kopieren.

  2. Erstellen Sie eine Sicherung der Produktionsumgebung mit Version 4 und kopieren Sie Textindizes und Anwendungskonfigurationsdateien auf den Zielbereitstellungsserver.

    Da die Produktionsserver während dieser Schritte gestoppt sein müssen, wählen Sie für die Sicherung eine günstige Zeit aus. Am besten ist es, wenn Sie die Sicherung unmittelbar vor dem Einrichten der Bereitstellungsumgebung erstellen. Falls bis zur eigentlichen Umbenennung noch Änderungen an der Produktionsumgebung vorgenommen werden, müssen Sie die Zuordnungsdatei erneut generieren, bevor Sie sie auf den Bereitstellungsserver importieren. Wenn die Server inaktiv sind, können Benutzer von externen Systemen, die in die umzubenennende CLM-Implementierung integriert sind, keine Links erstellen oder verwenden.

    1. Stoppen Sie Jazz Team Server und alle dezentralen CLM-Anwendungen, die bei Jazz Team Server in der Produktionsumgebung registriert sind.
    2. Sichern Sie alle Datenbanken in der CLM-4.0-Produktionsumgebung, 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. Führen Sie beim Kopieren der Datenbanken von der Produktions- in die Bereitstellungsumgebung die im Artikel CLM-Datenbank verlagern beschriebenen Schritte aus.
    3. Kopieren Sie die JFS- bzw. Textindizes vom Quellenproduktionsserver auf den Zielbereitstellungsserver. (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 Bereitstellungscomputer 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 Quellenproduktionsserver auf den Zielbereitstellungsserver. (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 Bereitstellungscomputer 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.
      Anmerkung: Falls bis zum folgenden Schritt noch Konfigurationsänderungen an der CLM-Implementierung vorgenommen werden, müssen Sie die Zuordnungsdatei erneut generieren.
    6. Starten Sie alle CLM-Server neu. Die Benutzer können jetzt ihre Arbeit in der Produktionsumgebung fortsetzen. Alle übrigen Schritte gelten für die Bereitstellungstestumgebung.
  3. Führen Sie in der Bereitstellungstestumgebung die folgenden Schritte aus.
    1. Speichern Sie die gesicherten Datenbanken aus der Produktionsumgebung in der Bereitstellungsumgebung zurück. Sie sollten in der Bereitstellungsumgebung einen gesonderten Datenbankserver verwenden, um eine Überlastung des Produktionsdatenbankservers zu vermeiden.
    2. Setzen Sie die Datenbankverbindungsparameter in den Dateien Jazz-Installationsverzeichnis/server/conf/Anwendungsname/teamserver.properties auf die Werte der Verbindungsparameter der Bereitstellungskopie der Datenbank in der Testumgebung. Dazu gehören die Einträge für die Datenbank von jts, die Datenbanken der Anwendungen ccm und qm, die Data-Warehouse-Datenbank und für aktualisierte Kennwörter.
    3. Als zusätzliche Vorsichtsmaßnahme zu den Pseudozuordnungen in der Zuordnungsdatei sollten Sie Ihre Datei 'hosts' aktualisieren (sofern dies in Ihrer Umgebung erlaubt ist), um den Zugriff auf die URLs des Produktionssystems und eine versehentliche Bearbeitung von Artefakten auf dem Produktionsserver zu verhindern.

      Ziel ist es, die Hostnamen in eine falsche IP-Adresse aufzulösen, die von keinem der CLM-Server in der Produktionsumgebung verwendet wird. Wenn also ein Server in der Bereitstellungsumgebung versucht, eine Verbindung zu einem Produktionsserver herzustellen, schlägt dieser Versuch fehl.

      Erstellen Sie eine Liste aller Hostnamen, die in Ihrer Zuordnungsdatei erscheinen. Dabei kann es sich um Quellen-URLs oder betroffene URLs handeln. Erstellen Sie in der Datei 'hosts' für jeden einzelnen Namen einen Eintrag, der den Hostnamen einer falschen IP-Adresse zuordnet. Sie müssen die Datei 'hosts' für alle Server in Ihrer Bereitstellungsumgebung bearbeiten, also auch die Datei 'hosts' für Server anderer Anbieter und für Clientworkstatations. In der folgenden Datei 'hosts' sehen Sie Beispieleinträge für einen Bereitstellungsserver:

       # 10.10.10.10 bezieht sich auf eine IP-Adresse, unter der keine CLM-Anwendung bereitgestellt wird.
        10.10.10.10   ProduktionsserverP1
        10.10.10.10   ProduktionsserverP2
        10.10.10.10   ProduktionsserverP3
    4. Öffnen Sie im Verzeichnis Jazz-Installationsverzeichnis\server eine Eingabeaufforderung und importieren Sie die Zuordnungsdatei mit dem Befehl repotools-jts -importURLMappings in den Ziel-Jazz-Team-Server.
      • 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="C:\mappings.txt"

        For Unix operating systems ./repotools-jts.sh -importURLMappings fromFile="opt/mappings.txt"

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

      • 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="C:\mappings.txt" serverConfFile="C:\serverConf.txt"

        For Unix operating systems ./repotools-jts.sh -importURLMappings fromFile="/opt/mappings.txt" serverConfFile="/opt/serverConf.txt"

      • 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 wie folgt aus:

        For Windows operating system repotools-jts.bat -importURLMappings fromFile="C:\mappings.txt"

        For Unix operating systems ./repotools-jts.sh -importURLMappings fromFile="opt/mappings.txt"

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

      Überprüfen Sie die Konsolausgabe und die Datei 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.

      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.
  4. Starten Sie Jazz Team Server und alle dezentralen CLM-Anwendungen, die bei Jazz Team Server registriert sind.

    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 (unter https://neuer Host:Port/jts/serverRenameStatus), um den Status der Umbenennung zu überprüfen.

    Warten Sie, bis alle Anwendungen umbenannt sind und der Schritt 'Serverumbenennung abschließen' vollständig ausgeführt ist. Verifizieren Sie, dass die folgende Nachricht erscheint: Die Serverumbenennung wurde erfolgreich abgeschlossen. Jazz Team Server und die Anwendungen sind voll funktionsfähig. Sie können sofort mit der Servernutzung beginnen. Ein Neustart ist nicht erforderlich.

    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.
    Anmerkung: Wenn Sie Pseudozuordnungen zum Schutz der Produktionsumgebung eingeführt haben, werden auf dem bereitgestellten Server auf der Diagnoseseite im Abschnitt Anwendungen und Freunde Fehler zu diesen URLs angezeigt.
  7. Führen Sie bei Bedarf die folgenden Schritte aus, um Rational Reporting for Development Intelligence (RRDI) in der Bereitstellungsumgebung zu konfigurieren.
    1. Sichern Sie die folgenden Datenbanken aus der Produktionsumgebung und speichern Sie sie auf einem neuen Datenbankserver für die Neuinstallation von RRDI in der Bereitstellungsumgebung zurück:
      • Content-Store-Datenbank (z. B RICM)
      • Data Warehouse (z. B. RIDW, sofern noch nicht gesichert und wiederhergestellt)
    2. Installieren Sie Rational Reporting for Development Intelligence Version 2.0 in der Bereitstellungsumgebung. 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 aktualisieren 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 Bereitstellungsumgebung zeigen.
      Anmerkung: Dieser Schritt ist nur erforderlich, wenn Ihre Zuordnungsdatei keine URLs für RRDI enthält.
    5. Verifizieren Sie, dass alle bisher importierten Berichte vom RRDI-Berichtsserver aus der Produktion 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 Bereitstellungsumgebung. 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. Falls Sie andere Komponenten wie die Jazz-Build-Steuerkomponenten, Clients von Rational Team Concert, Rational ClearQuest oder Rational ClearCase in Ihre Bereitstellungsumgebung aufnehmen, führen Sie alle dafür zusätzlich erforderlichen Schritte aus. Einzelheiten finden Sie im Artikel Einschränkungen und zusätzliche Informationen.

Feedback