Zum Inhalt

Container-Update

Diese Anleitung beschreibt den Prozess des Container-Updates für das charly-System. Sie umfasst den Export der Daten vom alten Server, den Import auf den neuen Server (oder demselben Server) und die notwendigen Schritte zur Verifizierung.

Voraussetzungen:

  • Administrator-Zugriff auf beide Server (oder den Server, wenn das Update auf demselben System durchgeführt wird)
  • PowerShell ab Version 5.1 mit Administratorrechten

charly-server main Skript

Wenn Sie das charly-server-Skript noch nicht haben, laden Sie es mit folgendem Befehl in der PowerShell (mit Administratorrechten) herunter:

Invoke-WebRequest -Uri "https://charly-cdn-solutio.s3.amazonaws.com/release/windows/charly-server-install.ps1" -OutFile ".\charly-server-install.ps1"
Set-ExecutionPolicy RemoteSigned -Force

Wenn es zu einem Problem beim Download kommt können sie noch probieren TLS in der PowerShell zu setzen.

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Sie können charly-server dann installieren (außer beim Serverumzug, siehe untern)

.\charly-server-install.ps1 

charly-server Signatur Problem

Sollte das charly-server-install Skript sich nicht ausführen lassen wegen einer ungültigen Signatur, setzen sie vor dem Start des Skriptes auf dem Server die ExecutionPolicy auf unrestricted.

Set-ExecutionPolicy Unrestricted -Force
Nachdem alle Arbeiten abgeschlossen wurden, setzen sie die Policy zurück auf RemoteSigned
Set-ExecutionPolicy RemoteSigned -Force

Allgemeiner Ablauf

flowchart TD
    A[Alter Server] -->|Export| B[ISO-Datei]
    B -->|Option 1: Neuer Server| C[Iso Datei Kopieren]
    B -->|Option 2: Selber Server| E
    C --> E[Container-Installation]
    E -->|Verifizierung| F[Abschluss]
    F -->|Bei Erfolg| G[Alte Installation entfernen]

Export auf dem alten Server

PreCheck für die Konfigurationsüberprüfung

Sie können Vorab einen PreCheck durchführen um die Konfiguration und den voraussichtlichen Erfolg eines ContainerUpdate zu überprüfen. Dies kann im laufenden Betrieb erfolgen:

charly-server pre-check 

Hinweis: Der PreCheck versucht, alle möglichen Fehlerquellen zu identifizieren, die bei einer Migration auftreten könnten. Es wird auch ein ISO erstellt und überprüft sowie eine Dokumentation generiert, die mögliche Probleme aufzeigt. Der PreCheck überspringt Fehler und fährt fort, um eine vollständige Übersicht über potenzielle Probleme zu erhalten.

Vollständiger Export im Migrationsmodus

Ein vollständiger Export im Migrationsmodus erstellt eine ISO Datei, welche für die Installation der Container genutzt wird. Dies sollte ein einmaliger Vorgang sein, welcher der Migration des Systems dient.

Führen Sie diesen Prozess außerhalb der Praxiszeiten durch, da er eine erhebliche Zeitspanne in Anspruch nehmen kann und charly während dieser Zeit nicht verfügbar ist.

Wichtig: Falls bisher kein PreCheck durchgeführt wurde, werden automatisch die für eine erfolgreiche Migration erforderlichen PreCheck-Schritte ausgeführt.

charly-server export migration 

Wichtig:

  • Der Migrationsmodus beendet alle Services und erstellt ein Vollbackup.
  • Nach Erstellung des Backups werden die Services und die PostgreSQL Datenbank deaktiviert. Dies verhindert, dass sich Clients versehentlich mit dem alten Server verbinden.
  • Die Dauer dieses Prozesses kann erheblich sein, besonders bei großen Datenmengen.

Nach dem Export

  • Überprüfen Sie die generierte Dokumentation auf mögliche Probleme oder Warnungen.
  • Stellen Sie sicher, dass die ISO-Datei erfolgreich erstellt wurde und sich über den Windows Explorer öffnen lässt.

Import auf dem neuen Server oder demselben Server

Installation vorbereiten

Wenn Sie einen neuen Server verwenden, kopieren Sie die erstellte ISO-Datei auf diesen Server. Bei Verwendung desselben Servers ist dieser Schritt nicht notwendig.

Installation der virtuellen Maschine

Bitte beachten Sie, dass die Installation des virtuellen Images auf dem Windows-Betriebssystem erfolgen muss, das direkt auf der Bare-Metal-Hardware läuft. Es ist nicht möglich, unser System in einer virtualisierten Windows-Umgebung zu installieren.

Zur Installation befolgen Sie bitte für die Installation des charly Servers in der VM die Installationsanleitung.

Diese Anleitung bietet detaillierte Informationen zu den Systemvoraussetzungen, der Vorbereitung der Umgebung und den spezifischen Installationsschritten, die erforderlich sind, um den charly Service erfolgreich zu installieren und zu betreiben.

Installation überprüfen

Installation des charly-Client auf dem Host Server

Für einen ersten einfachen Test können sie auf dem Host den charly-Client installieren. Hierzu laden sie unter der neuen IP Addresse den charly-Client installer herunter und rufen .... auf.

Installation des charly-Client auf einem Arbeitsplatz

.... work in progress ....

Alte Installation entfernen

Wenn der charly Server in die VM umgezogen ist, alle Tests erfolgreich sind, Sie mehrere Tage mit dem neuen System erfolgreich gearbeitet haben, entfernen Sie die alte Installation auf dem alten Server

flowchart TD
    A[Status überprüfen] --> B{Alles korrekt?}
    B -->|Ja| C[Standardtests durchführen]
    C --> D{Tests erfolgreich?}
    D -->|Ja| E[Alte Installation entfernen]
    D -->|Nein| F[Fehler beheben]
    F --> A
    B -->|Nein| F
    E --> G[Abschluss]

Wiederherstellung des alten Servers bei gescheiterter Migration

Sollten Sie feststellen, dass die Migration fehlgeschlagen ist, können Sie den charly-Server durch einen Neustart auf dem alten Server wieder in Betrieb nehmen:

charly-server manage start

Wichtig: Diese Wiederherstellung sollte nur dann durchgeführt werden, wenn in der Zwischenzeit keine Daten in der neuen Container-Installation angelegt oder bearbeitet wurden. Falls Sie bereits mit der Container-Installation gearbeitet haben, kontaktieren Sie bitte umgehend den Support. Dieser wird versuchen, die neue Installation zum Laufen zu bringen.

Wichtige Hinweise

  • Der Export im Migrationsmodus verhindert ein erneutes automatisches Hochfahren der Services des alten Servers oder des alten S:\ charly Verzeichnisses.
  • Das Container-Update kann auf einem neuen Server oder auf demselben Server durchgeführt werden, sofern die Systemvoraussetzungen erfüllt sind.
  • Stellen Sie sicher, dass Sie vor dem Entfernen der alten Installation alle wichtigen Daten und Konfigurationen gesichert haben bzw. diese erfolgreich auf dem neuen Server laufen.
  • Bewahren sie das ISO auch bei einem erfolgreiche ContainerUpdate auf.

Diese Anleitung bietet einen Überblick über den Container-Update-Prozess. Für detailliertere Informationen oder bei spezifischen Problemen wenden Sie sich bitte an den Support.


Version: 2.1.1

Datum der letzten Aktualisierung: 27.02.2025