DE 

//Cloudogu EcoSystem Docs

  1. docs.cloudogu.com
  2. Benutzerhandbuch
  3. Automatische Migration
  4. Anleitungen
  5. Troubleshooting
Getting Started
Benutzerhandbuch
Entwicklerdokumentation

Troubleshooting

Importer

Volumes werden zu klein angelegt

  • Im Exporter den VolumeIncreaseFactor (etcdctl set /config/ces-exporter/volumeIncreaseFactor <Faktor>) auf > 1 erhöhen

Ändern des Migrationszeitpunktes

  • Um den Migrationszeitpunkt zu ändern, müssen entweder die Helm-Werte in der Component-CR oder direkt die ConfigMap ces-importer-config angepasst werden. Anschließend muss immer der ces-importer-Pod neu gestartet werden!

    kubectl rollout restart deployment/ces-importer -n ecosystem

Dogus hängen im Starting-State und verhindern eine neue Migration

  • Alle Dogu-Deployments auf 0 skalieren und die Migration neu starten
  • Ab v3.7.0 des Dogu-Operators wurde dieses Problem gefixed und kann nicht mehr auftreten

Geänderte Konfiguration wird nicht übernommen

Nach dem Ändern der Konfiguration muss der Importer immer neu gestartet werden, damit die neue Konfiguration übernommen wird.

kubectl rollout restart deployment/ces-importer -n ecosystem

Fehler in der finalen Migration

Tritt ein Fehler bei der finalen Migration auf, müssen folgende Schritte ausgeführt werden:

  1. Einen neuen Zeitpunkt für die finale Migration konfigurieren

    • config/migration/finalSchedule

    • Danach muss der Importer neu gestartet werden!

      kubectl rollout restart deployment/ces-importer -n ecosystem
  2. Sicherstellen, dass die Quellinstanz weiterhin erreichbar ist

Absturz des Importers

Nach einem Absturz des Importers müssen alle bereits gestoppten Dogus manuell (über die Dogu-CR) neu gestartet werden. Ansonsten können diese vom Dogu-Operator nicht mehr gestoppt werden und die Migration wird nicht erfolgreich sein.

Dogus hängen nach der Migration im Pending-State

Im CES-VM konnte lediglich das Limit für die RAM-Nutzung der Container eingestellt werden. Wenn in CES-MN (bzw. Kubernetes) ein Memory-Limit gesetzt wird, aber kein Memory-Request, dann wird der Memory-Request automatisch auf das Limit gesetzt. Dies kann dazu führen, dass Dogus zu viel RAM verlangen und im Pending-Status stehen bleiben. Ist dies der Fall, sollte entweder der Memory-Request angepasst werden oder die Leistung erhöht werden.

Dogus starten nach einer fehlgeschlagenen Migration nicht mehr

Nach einer fehlgeschlagenen Migration kann es vorkommen, dass Dogus nicht mehr starten können. Dies kann passieren, wenn die Konfiguration eines Dogus schon übertragen wurde, die Daten aber nicht. Der nächste erfolgreiche Migrationslauf sollte dieses Problem beheben.

Exporter

API überprüfen

Um die API des Exporters auf Funktionsfähigkeit zu überprüfen, kann z.B. curl verwendet werden.

curl -l -H "X-CES-EXPORTER-API-KEY: <myApiKey>" <exporterFqdn>/ces-exporter/export-mode

SSH-Konfiguration überprüfen

Um die SSH-Verbindung zum Exporter unabhängig vom Importer zu prüfen kann folgender Befehl genutzt werden:

ssh -p 7022 -l root -i ./<path/to/private/key> -o StrictHostKeyChecking=no -o BatchMode=yes <host-ip>

rsync überprüfen

Die Migration wird durch das Programm rsync ausgeführt. Um zu überprüfen, ob rsync korrekt funktioniert, kann folgender Befehl verwendet werden:

rsync -avhz --delete --sparse --stats -e ssh -p 7022 -l root -i /.ssh/privateKey -o StrictHostKeyChecking=no -o BatchMode=yes <host-ip>:</path/on/exporting/machine/> </path/on/importing/machine/>

Achtung: Rsync migriert Daten aus dem Quellsystem in den angegebenen Ordner und löscht Daten im Zielordner. Für den Test sollte am besten ein leerer Ordner verwendet werden.