Migration von der „ Standard Edition “ zur „Custom Edition“

Stellen Sie sicher, dass die folgenden Voraussetzungen erfüllt sind:

• Der Cluster „ Kubernetes “ ist installiert und konfiguriert.
• Das Plug-in „ Instana “ ( kubectl ) ist installiert.
• Die Datenspeicher sind betriebsbereit.

Um die Daten zu migrieren, führen Sie die folgenden Schritte aus:

1. Extrahieren Sie auf Ihrem selbst gehosteten Standard Edition -Host die Konfigurationsdaten der Mandanteneinheit aus dem Datenspeicher „ Postgres “.

   stanctl dump config-data
    

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

2. Optional: Setzen Sie 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 --include-sensitive Kennzeichen nicht gesetzt 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 Informationen in die Sicherung aufzunehmen, geben Sie „Ja“ ein.
   • Um sensible Daten von der Sicherung auszuschließen, geben Sie „Nein“ ein.
4. Übertragen Sie das generierte dump-<timestamp>.tar.gz Dateipaket vom alten Host auf Ihren neuen Custom Edition-Host.
5. Installieren Sie Datenspeicher; siehe „Einrichten von Datenspeichern “.
6. Daten aus Standard Edition importieren.

   kubectl-instana migrate -f <path-to-dump-file>

   Tabelle 1. Migrationsparameter

   Parameter	Beschreibung
   -f, --file	Pfad zum Archiv der Migrationsspeicherauszüge
   --postgres-namespace	Namensraum (Standard: instana-postgres)
   --postgres-name	Name des Clusters „ Postgres “ (Standard: postgres)
   --postgres-user	Postgres Benutzername
   --postgres-password	Postgres Passwort

7. Entpacken Sie das Speicherauszugsarchiv und verwenden Sie die folgende Konfiguration für die Installation des Backends:

   tar -xzf dump-<timestamp>.tar.gz -o dump/migrate.yaml | cat

8. Beachten Sie die Parameter in der migrate.yaml Datei. Sie müssen diese Werte verwenden, um das Backend „ Instana “ zu installieren.
   • Verwenden Sie die folgenden Parameter aus der migrate.yaml Datei in Core Secret :
     • salesKey
     • tokenSecret
     • downloadKey
     • emailConfig

       emailConfig:
         smtpConfig:
           user: smtp-user@example.com
           password: smtp-password-123

     • Proxy

       
       proxyConfig:
         user: proxy-user
         password: proxy-password-456
        

   • Verwenden Sie die folgenden Parameter aus der migrate.yaml Datei in Unit Secret :
     • downloadKey
     • Agentenschlüssel
   • Verwenden Sie die folgenden Parameter aus der migrate.yaml Datei zum Erstellen eines Kerns, wie im folgenden Beispiel gezeigt.

     apiVersion: instana.io/v1beta2
     kind: Core
     metadata:
       namespace: instana-core
       name: instana-core
     spec:
        base-domain: instana.example.com
        imageConfig:
          tag: 3.xxx.xxx-0
        emailConfig:
          smtpConfig:
            from: noreply@example.com
            host: smtp.example.com
            port: 587
            useSSL: false
            startTLS: true
            check_server_identity: true
        proxyConfig:
          host: proxy.example.com
          port: 8080
          nonProxyHosts:
            - localhost
            - 127.0.0.1
            - "*.internal.example.com"
        acceptors:
          agent:
            host: <agent subdomain>
            port: <port>
          eum:
            host: <base domain>
            port: <port>
          synthetics:
            host: <base domain>
            port: <port>
          serverless:
            host: <base domain>
            port: <port>
          otlp:
            http:
              host: <otlp-http subdomain>
              port: <port>
            grpc:
              host: <otlp-grpc subdomain>
              port: <port>
          opamp:
            host: <opamp subdomain>
            port: <port>
        feature-flags:
          - name:feature.new-ui.enabled
            enabled:true
          - name:feature.advanced-analytics.enabled
            enabled:false
        use-tu-url-path: false # If this value is set to true, remove the "use-tu-url-path" attribute and instead add the following configuration in core.yaml
                              # properties:
                              # - name: config.url.format.pathStyle
                              #   value: true

   • Verwenden Sie die folgenden Parameter aus der migrate.yaml Datei zum Erstellen einer Einheit und eines Mieters.
     • tenantName
     • unitName
9. Installieren Sie das Backend „ Instana “; siehe „Installation des Backends „ Instana ““.

Führen Sie bei Bedarf die folgenden Konfigurationen, die auf dem alten Host vorhanden waren, erneut durch.

• Die neue Custom Edition-Instanz ist standardmäßig mit keinem Agenten verbunden. Führen Sie einen der folgenden Schritte aus:

  • Verbinden Sie Ihre Agenten mit alten und neuen Backends, siehe Konfigurieren mehrerer Backends.
  • Verbinden Sie Ihre Agenten mit dem neuen Backend und aktualisieren Sie die vorhandenen „ DNS ”-Datensätze, sodass sie auf die neue Custom Edition-Instanz verweisen. Die Agenten melden sich automatisch beim neuen Backend an.