//Cloudogu EcoSystem Docs

Installation des Exporters in einer CES-VM-Instanz

Um die Daten und Konfigurationen von einer CES-VM-Instanz auf eine neue CES-MN-Instanz zu übertragen muss auf der Quellinstanz eine Exporter-Applikation (Exporter) installiert und konfiguriert werden. Dieser Exporter wird vom Importer auf der Zielinstanz gesteuert. Er sammelt und überträgt die Daten und Konfigurationen der Quellinstanz. Nach Abschluss der finalen Migration stellt der Exporter die Quellinstanz in den Wartungsmodus.

Voraussetzungen prüfen

  • Die Quellinstanz ist eine CES-VM-Instanz.
  • Es wird ein SSH-Schlüsselpaar benötigt.

    • Für den Exporter wird ein öffentlicher Schlüssel benötigt.
    • Dieses Schlüsselpaar kann mit ssh-keygen erzeugt werden.
    • Das SSH-Schlüsselpaar darf keine Passphrase erfordern.
  • Außerdem wird ein API-Schlüssel benötigt.

    • Der Schlüssel kann individuell mit beliebigen Zeichen erzeugt werden.
    • Der API-Schlüssel darf eine Länge von 8 bis 128 Zeichen haben.
    • Der API-Schlüssel wird auch für die Installation des Importers auf der Zielinstanz benötigt.
  • Die Instanz ist über die Ports 443 und 7022 erreichbar.
  • Das nginx Dogu ist mindestens in Version 1.28.0-2 installiert.

Exporter installieren

  • Auf der Kommandozeile der Quellinstanz z.B. per SSH einloggen.
  • In den Superuser-Modus (sudo su) wechseln.
  • Exporter aus dem APT-Paket installieren:

    apt update && apt install ces-exporter
  • Prüfen, dass der Exporter erfolgreich gestartet ist:

    docker ps | grep ces-exporter
    • liefert dieser Befehl kein Ergebnis zurück, so wurde der Exporter nicht korrekt installiert

Exporter konfigurieren

  • Konfigurieren des API-Schlüssels für eine sichere HTTPS-Verbindung:

    etcdctl set /config/ces-exporter/authentication/api_key "<my-api-key>"
  • Konfigurieren des öffentlichen SSH-Schlüssel für die Verbindung zwischen Importer & Exporter:

    1. Mit Datei (z.B. „id_rsa.pub“):

      cat id_rsa.pub | etcdctl set /config/ces-exporter/authentication/public_key
    2. Ohne Datei:

      etcdctl set /config/ces-exporter/authentication/public_key "<public key>"