Migration von der Classic Edition zu „ Standard Edition “

Mit „ Standard Edition “ können Sie:

• Zugriff auf neue Funktionen von „ Instana “, darunter Infrastrukturanalysen, intelligente Warnmeldungen und benutzerdefinierte Dashboards, mit Protokollierung, synthetischen Tests, „ OpenTelemetry, “-Automatisierung, Observability für KI-Agenten und LLM sowie weiteren Funktionen
• Verwalten Sie Ihre Bereitstellung mithilfe der stanctl Befehlszeilenschnittstelle (CLI)
• Passen Sie Ihre Umgebung an, wenn die Überwachungsanforderungen steigen
• Wählen Sie die Bereitstellungstopologie aus, die Ihren Anforderungen am besten entspricht, darunter ein System mit einem Knoten, ein Cluster mit drei Knoten oder ein Cluster mit fünf Knoten

Führen Sie die folgenden Schritte aus, um auf „ Standard Edition “ umzusteigen. Um das Migrationsrisiko zu verringern, sollten Sie während der Umstellung die Classic Edition und „ Standard Edition “ parallel ausführen.

1. Konfigurieren Sie „ Standard Edition “ in Ihrer bestehenden Classic Edition -Umgebung.
2. Konfigurieren Sie die Agenten so, dass sie Daten an beide Umgebungen senden.
3. Überprüfen Sie die Datenerfassung, die Konfiguration und die betrieblichen Arbeitsabläufe in „ Standard Edition “ über einen Zeitraum von zwei bis vier Wochen.
4. Wenn Sie mit den Validierungsergebnissen zufrieden sind, konfigurieren Sie die Agenten so um, dass sie Daten nur noch an Standard Edition senden, und deaktivieren Sie die Classic Edition.

Sie bestimmen den Zeitplan für die Migration und können den Übergang abschließen, sobald Sie sicher sind, dass die Bereitstellung von „ Standard Edition “ Ihren Anforderungen entspricht.

Überprüfen Sie die Anforderungen an die Dimensionierung für Ihre Bereitstellungstopologie und erfüllen Sie die Installationsvoraussetzungen, bevor Sie mit der Migration beginnen. Weitere Informationen finden Sie in den folgenden Quellen:

• Standard Edition Standard Edition Checkliste für die Installation
• Anforderungen an einen Single-Node-Cluster
• Anforderungen an einen Cluster mit drei Knoten
• Anforderungen an einen Cluster mit fünf Knoten

Wenn Sie Hilfe bei der Dimensionierung oder der Bereitstellungsplanung benötigen, wenden Sie sich bitte an das IBM® -Supportportal oder an Ihren Ansprechpartner bei IBM.

Sie können die Konfigurationsdaten der Mandanten von der selbst gehosteten Classic Edition ( Docker ) migrieren. Dazu gehören Benutzereinstellungen, Dashboards, Ereignisse, Benachrichtigungen, Anwendungsperspektiven, EUM-Websites und mobile Apps. Außerdem enthält es zusätzliche Daten.

Die folgenden Migrationspfade werden unterstützt:

• Von der Classic Edition bis hin zu Ein-Knoten-, Drei-Knoten- oder Fünf-Knoten- Standard Edition

Erfüllen Sie die folgenden Voraussetzungen:

• Bereiten Sie Ihren neuen Host vor, wie unter „Vorbereitung Ihrer Ein-Knoten-Umgebung“ oder „Vorbereitung Ihrer Mehr-Knoten-Umgebung“ beschrieben.
  • Die „ Standard Edition “-Version stellt höhere Mindestanforderungen an die Hardware als die Basisinstallation, da sie ein breiteres Spektrum an Funktionen und Skalierbarkeitsoptionen unterstützt. Ausführliche Anforderungen finden Sie unter „Anforderungen für Einzelknoten“.
• Installieren Sie die stanctl Binärdatei. Einzelheiten zur Installation finden Sie in der Stanctl-Installationsanleitung.
• Stellen Sie sicher, dass die Hauptversion des „ Instana “-Backends auf Ihrem alten und Ihrem neuen Host identisch ist. Um die Backend-Version in der Classic Edition zu überprüfen, führen Sie den folgenden Befehl aus:

  instana images version

• Um die entsprechende stanctl Version für „ Standard Edition “ zu ermitteln, sehen Sie sich bitte die Kompatibilitätsmatrix in den Versionshinweisen zu Ihrer „ Instana “-Version an. Führen Sie bei Bedarf ein Upgrade des Backends durch:
  • Informationen zum Upgrade des „ Instana “-Backends in der Classic Edition finden Sie unter „Upgrade der Classic Edition “. Das Backend „ Instana “ in der Classic Edition muss Build 271 oder höher sein.
  • Informationen zum Upgrade des „ Instana “-Backends auf Standard Edition finden Sie unter „Upgrade von Standard Edition “.
• Für eine Migration im Air-Gap-Modus erstellen Sie ein Air-Gap-Paket auf dem Bastion-Host, übertragen Sie das Paket auf den Air-Gap-Host, installieren Sie „stanctl“ auf dem Air-Gap-Host und importieren Sie das Paket auf dem Air-Gap-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 Classic Edition-Host aus:

     instana 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. Übertragen Sie das Paket dump.tar.gz vom alten Host auf Ihren neuen Host unter Standard Edition.

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

   Migration parameters

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

   Es wird das folgende Dialogfeld angezeigt.

   Are you migrating from the Classic offering?

4. Geben Sie „Ja“ ein. Für alle Dienste wird weiterhin eine Single-Domain verwendet.

   Nach dem Befehl erscheint folgende Eingabeaufforderung:

   ? Choose installation type:
    demo <
    production

5. Wählen Sie production aus.

   Hinweis:

   Die Demo-Installation ist ausschließlich für Test- und Demo-Umgebungen vorgesehen. Verwenden Sie dies nicht demo in einer Produktionsumgebung.
   Wenn die Migration erfolgreich abgeschlossen ist, wird eine Bestätigungsmeldung angezeigt, wie im folgenden Beispiel:

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

6. 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 zusammen mit dem Befehl stanctl up verwenden, um diese Einstellungen zu konfigurieren, einschließlich der gewünschten Feature-Flags.

Nachdem die Installation erfolgreich abgeschlossen wurde, wird eine Meldung wie im folgenden Beispiel angezeigt:

*****************************************************************
* 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 Classic Edition-Umgebung verwendet haben.

Nach Abschluss der Migration müssen Sie gegebenenfalls einige Konfigurationen vom alten Host erneut vornehmen. Sie können die Konfiguration gemäß den Vorschlägen in der folgenden Liste anpassen, um „ Standard Edition “ voll funktionsfähig zu machen.

• Eine neue „ Standard Edition “-Instanz ist standardmäßig mit keinem Agenten verbunden. Konfigurieren Sie Ihre Agenten so, dass sie Daten sowohl an Ihre alte „Classic Edition “-Umgebung als auch an Ihre neue „ Standard Edition “-Umgebung senden, damit Sie beide während der Validierung parallel betreiben können. Informationen dazu, wie Sie Ihre Agenten mit dem alten und dem neuen Backend verbinden können, 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 für dieselben Ereignisse. Um doppelte Benachrichtigungen zu vermeiden, können Sie auf einer Ihrer „ Instana “-Instanzen ein Wartungsfenster festlegen. Weitere Informationen finden Sie unter „Planung von Wartungsfenstern “.

• Feature-Flags, die in Ihrer alten Umgebung aktiviert waren, werden nicht in „ Standard Edition “ migriert. Sie müssen die Feature-Flags in Ihrer neuen Umgebung erneut manuell aktivieren. Weitere Informationen finden Sie unter „Optionale Funktionen “.

• Wenn Sie von der Classic Edition auf „ Standard Edition “ umsteigen, wird der gesamte Ingress-Datenverkehr – einschließlich des Datenverkehrs des Agenten, der Benutzeroberfläche und von „ API “ – standardmäßig über eine einzige Domain (die Basisdomain) abgewickelt. Um dieses Verhalten rückgängig zu machen, führen Sie nach Abschluss der Migration den folgenden Befehl aus:

  stanctl backend apply \
  --core-use-tu-url-path=false \
  --core-acceptors-agent-host=<desired-agent-acceptor-domain> \
  --core-acceptors-agent-port=<desired-agent-acceptor-port>

Wenn die Classic Edition und „ Standard Edition “ gleichzeitig ausgeführt werden und beide mit Ihren Agenten verbunden sind, gelten die folgenden Einschränkungen:

• Einschränkungen auf Agentenseite
  • Der Sensor „ Kubernetes “ im Agenten „ Instana “ unterstützt keine Konfigurationen mit zwei „ Instana “-Backends. Eine Umgehungslösung finden Sie unter „Berichte 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.
• Einschränkungen auf der Backend-Seite
  • Konfigurationsänderungen, die Sie nach der Migration vornehmen, 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.