Migration von Standard Edition zu Standard Edition

Erfüllen Sie die folgenden Voraussetzungen:

• Richten Sie Ihren neuen Host ein, wie unter „Vorbereitung Ihrer Ein-Knoten-Umgebung“ oder „Vorbereitung Ihrer Mehr-Knoten-Umgebung“ beschrieben.
  • Verwenden Sie für die Einstellungen unter „ DNS “ die Mandanten- und Einheitsnamen Ihrer alten Umgebung. Da die Namen des Mieters und der Einheit Teil des Domänennamens der Einheit sind, müssen diese Namen im „ DNS “-Eintrag der „ Standard Edition “-Umgebung enthalten sein. Dies ist auch erforderlich, um sich unter Standard Edition über die Authentifizierung von LDAP anzumelden, da die Konfigurationen von LDAP ebenfalls migriert werden.
• Installieren Sie die stanctl Binärdatei. Weitere Informationen finden Sie unter „Installieren des Befehlszeilentools stanctl “.
• Stellen Sie sicher, dass die Backend-Version von „ Instana “ auf Ihrem alten und Ihrem neuen Host identisch ist. Führen Sie bei Bedarf ein Upgrade des Backends durch:
  • Informationen zum Aktualisieren des „ Instana “-Backends in der Classic Edition finden Sie unter „Aktualisieren der Classic Edition “. Das Backend „ Instana “ in der Classic Edition muss Build 271 oder höher sein.
  • Informationen zum Aktualisieren des „ Instana “-Backends auf Standard Edition finden Sie unter „Aktualisieren von Standard Edition “.
• Für die Migration in einer isolierten Umgebung erstellen Sie ein isoliertes Paket auf dem Bastion-Host, übertragen Sie das Paket auf den isolierten Host, installieren Sie stanctl auf dem isolierten Host und importieren Sie das Paket auf dem isolierten Host.

Führen Sie zur Migration der Daten die folgenden Schritte aus:

1. Extrahieren Sie die Konfigurationsdaten der Mandanteneinheit aus dem Datenspeicher „ Postgres “. Führen Sie den folgenden Befehl auf dem alten „ Standard Edition “-Host aus:

   stanctl dump config-data

   Im Verzeichnis ./dump wird eine dump.tar.gz Datei erstellt. Diese Datei enthält die Konfigurationsdaten der Mandanteneinheiten in Form von ausführbaren SQL-Abfragen.

2. Optional: Setze das --include-sensitive Flag, um den folgenden Dialog zu ....Do you want to include sensitive information?überspringen.

   Zu den sensiblen Daten gehören das SMTP-Passwort, das Proxy-Passwort und die Download-Schlüssel.

   Wenn das nicht eingestellt --include-sensitive ist, wird der folgende Dialog angezeigt.

   This operation may include sensitive information (for example, SMTP credentials, proxy credentials, and download key).
   Do you want to include sensitive information?
   Note: Excluding it will require you to reconfigure SMTP and proxy settings in the destination environment during installation.

3. Führen Sie einen der folgenden Schritte aus:
   • Um vertrauliche Daten in die Sicherung aufzunehmen, geben Sie „Ja“ ein.
   • Um sensible Daten von der Sicherung auszuschließen, geben Sie „Nein“ ein.

   Im aktuellen Verzeichnis wird eine dump-<timestamp>.tar.gz Datei erstellt. Diese Datei enthält die Konfigurationsdaten der Mandanteneinheiten in Form von ausführbaren SQL-Abfragen.

4. Führen Sie einen der folgenden Schritte aus:

   • Online-Migration: Übertragen Sie das dump.tar.gz Paket vom alten Host auf Ihren neuen Host bei Standard Edition.
   • Migration mit Luftspalt: Übertragen Sie das dump.tar.gz Paket mithilfe des Bastion-Hosts vom alten Host auf Ihren neuen Host mit Luftspalt unter Standard Edition.

5. Übertragen Sie auf Ihrem neuen Host unter Standard Edition die Daten aus der dump.tar.gz Datei.

   Migrationsparameter

   Parameter	Nutzung	Beispiel
   --volume-data =<benutzerdefiniertes-Verzeichnis>	Gibt das Verzeichnis an, in dem Konfigurations- und Betriebsdaten für die Datenspeicher von Elasticsearch, PostgreSQL, und Kafka gespeichert werden sollen Standardwert: /mnt/instana/stanctl/data	--volume-data =/custom/data/path
   --volume-metrics =<benutzerdefiniertes-Verzeichnis>	Gibt das Verzeichnis an, in dem Metriken und Zeitreihendaten für die Datenspeicher von Cassandra und BeeInstana gespeichert werden sollen Standardwert: /mnt/instana/stanctl/metrics	--volume-metrics =/custom/metrics/path
   --volume-analytics =<benutzerdefiniertes-Verzeichnis>	Gibt das Verzeichnis an, in dem die Analysedaten für den Datenspeicher von „ ClickHouse “ gespeichert werden sollen Standardwert: /mnt/instana/stanctl/analytics	--volume-analytics =/custom/analytics/path
   --volume-objects =<benutzerdefiniertes-Verzeichnis>	Gibt das Verzeichnis an, in dem Objektspeicherdaten, einschließlich Trace- und Überwachungsdaten, gespeichert werden sollen Standardwert: /mnt/instana/stanctl/objects	--volume-objects =/custom/objects/path

   • Führen Sie bei einer Bereitstellung mit einem einzelnen Knoten die folgenden Befehle aus:
     • Online-Migration

       stanctl migrate -f </path/to/tar.gz>
        

     • Migration mit Luftspalt

       stanctl migrate --air-gapped -f </path/to/tar.gz>
        

   • Führen Sie bei einer Bereitstellung mit mehreren Knoten die folgenden Befehle aus:
     • Online-Migration

       stanctl migrate --file=</path/to/tar.gz> --multi-node-enable --multi-node-ips=<node0IPaddress,node1IPaddress,node2IPaddress>
        

     • Migration mit Luftspalt

       stanctl migrate --air-gapped --file=</path/to/tar.gz> --multi-node-enable --multi-node-ips=<node0IPaddress,node1IPaddress,node2IPaddress>
        

6. Es wird das folgende Dialogfeld angezeigt.

   Are you migrating from the Classic offering?

7. Geben Sie „Nein“ ein, damit die ursprüngliche Konfiguration für mehrere Domänen oder eine einzelne Domäne beibehalten wird.
   Nachdem Sie den Befehl ausgeführt haben, erscheint folgende Eingabeaufforderung:

   ? Choose installation type:
   demo <
   production
    

8. Wählen Sie die gewünschte Installationsart aus. Bei Clustern mit mehreren Knoten wird nur der production Installationstyp unterstützt.

   Wenn die Migration erfolgreich abgeschlossen ist, wird eine Bestätigungsmeldung angezeigt, die in etwa wie im folgenden Beispiel aussieht:

   
      ╭──────────────────────────────────────────────╮ 
      │                                              │ 
      │ Migration completed successfully!            │ 
      │ You can now install Instana Standard Edition.│ 
      │                                              │ 
      ╰──────────────────────────────────────────────╯ 
      

9. Installieren Sie „ Standard Edition “ mit den Konfigurationsdaten der Mandanteneinheit, die Sie von Ihrem alten Host migriert haben. Weitere Informationen finden Sie unter „Installation des Standard Edition s in einer Online-Umgebung “ oder „Installation von „ Standard Edition “ in einer isolierten Umgebung “.

   Hinweis: Wenn Sie weitere Einstellungen wie benutzerdefinierte Zertifikate, SMTP-Konfiguration, Proxys und andere Einstellungen vornehmen möchten, lesen Sie den Abschnitt „Backend-Konfigurationen“ unter Instana. Sie können die Konfigurationsoptionen mit dem stanctl up Befehl verwenden.

Nach erfolgreichem Abschluss der Installation wird eine Meldung angezeigt, die in etwa dem folgenden Beispiel entspricht:

*****************************************************************
* Successfully installed Instana Self-Hosted Standard Edition! *
*                                                               *
* URL: https://instana.example.com                              *
* Username: admin@instana.local                                 *
*****************************************************************
 

Sie können sich bei der neuen Benutzeroberfläche von „ Standard Edition “ mit demselben Mandantenpasswort anmelden, das Sie in Ihrer alten „ Standard Edition “-Umgebung verwendet haben.

Gegebenenfalls müssen Sie einige Konfigurationen, die auf dem alten Host vorhanden waren, erneut vornehmen. Sie können die Konfiguration wie in der folgenden Liste vorgeschlagen anpassen:

• Eine neue „ Standard Edition “-Instanz ist standardmäßig mit keinem Agenten verbunden. Informationen dazu, wie Sie Ihre Agenten mit dem alten und dem neuen Backend verbinden, finden Sie unter „Konfigurieren mehrerer Backends “.

• Nach der Migration, wenn die alte und die neue Umgebung mit Ihren Agenten verbunden sind, generieren sowohl die „ Instana “-Umgebungen Warnmeldungen. Um doppelte Benachrichtigungen zu vermeiden, können Sie für eine Ihrer „ Instana “-Instanzen ein Wartungsfenster festlegen. Weitere Informationen finden Sie unter „Planung von Wartungsfenstern “.

Für die gleichzeitige Berichterstellung in zwei „ Instana “-Backends gelten folgende Einschränkungen:

• Der Sensor „ Kubernetes “ im Agenten „ Instana “ unterstützt keine Konfigurationen mit zwei „ Instana “-Backends. Siehe „Bericht an mehrere Backends“ für die Überwachung von „ Kubernetes “.
• Die EUM-Clients (End User Monitoring) unterstützen keine Berichterstellung an zwei „ Instana “-Backends.
• Serverlose Client-Implementierungen unterstützen keine Berichterstellung an zwei Backends von Instana.
• Nach der Migration vorgenommene Konfigurationsänderungen werden nicht automatisch zwischen den beiden „ Instana “-Backends synchronisiert.

Nach der Migration können Probleme auftreten. Sollten Sie diese Probleme nicht beheben können, wenden Sie sich bitte an den Support von IBM.