charly-Server-Skript für Windows

Anleitung nach Aufgabengebieten

Die Anleitung ist aufgeteilt in die Funktionen welche charly-Server bereit hält für Klassische Installationen des charly-Servers sowie die Container (charly-VM).

Klassischer charly-Server

• Routinewartung
• Datensicherung und Wiederherstellung
• Systemvoraussetzungen überprüfen

Container (charly-VM)

• Installation und Konfiguration
• Betrieb und Wartung
• Migration vom klassischen Server

Release Notes

Übersicht

Das charly-Server-Skript ist ein Wartungsskript für Windows-Systeme, das verschiedene administrative Aufgaben automatisiert und vereinfacht. Es bietet Funktionen für Backups, Service-Neustarts, Berechtigungsreparaturen und wird kontinuierlich um weitere Funktionen erweitert, die von Support und Systemadministratoren benötigt werden.

Umgebungen

Das charly-Server-Skript unterstützt verschiedene Umgebungen für unterschiedliche Einsatzzwecke:

• Vorabversion

  • Für Tests neuer Funktionen in Produktionsumgebungen
  • Wird von Support und ausgewählten Partnern verwendet
  • Wechselt automatisch zur Release-Version, wenn die Versionsnummern übereinstimmen

• Release

  • Standardumgebung für alle Kunden
  • Wird standardmäßig bei der Installation eingerichtet
  • Stabile und getestete Version

Installation des charly-Server-Skripts

Ab der charly-Version 9.31.6 wird das charly-Server-Skript über den Updater auf nativen Servern installiert (nicht über das Offline-Update). Des Weiteren ist es Voraussetzung für die Installation der Container (charly-VM).

Manuell können Sie das charly-Server-Skript folgendermaßen installieren:

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
.\charly-server-install.ps1 

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

Nach der erfolgreichen Installation können Sie alle Funktionalitäten des charly-Server-Skripts verwenden. Alle Aufrufe erfolgen direkt über das Terminal.

• Ausführung über eine Administrator-PowerShell
• Verfügbar über PATH (kann von jedem Verzeichnis aus aufgerufen werden)
• Hilfe ist über den Parameter "-Help" verfügbar
  • Beispiel: charly-server -Help
  • Beispiel für spezifische Befehle: charly-server manage -Help

charly-Server Signatur Problem

Sollte das charly-Server-install-Skript sich wegen einer ungültigen Signatur nicht ausführen lassen, 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

Besonderheiten der Installation

• Der Installationsprozess verwendet das Skript charly-server-install
• Dieses wird während der charly-Updater-Ausführung heruntergeladen
• Dadurch wird sichergestellt, dass immer die aktuellste Version des Installationsskripts verwendet wird

Update des charly-Server-Skripts

Das charly-Server-Skript wird bei jeder Ausführung des Updaters auf die neuste Version aktualisiert (nicht über das Offline-Update).

Des Weiteren wird das charly-Server-Skript automatisch bei jedem Aufruf auf die neuste Version aktualisiert (nur mit Internet-Verbindung möglich).

Update-Details

• Automatische Prüfung

  • Bei jedem Aufruf von charly-server wird auf Updates geprüft
  • Betrifft sowohl das Hauptskript als auch alle Module

• Hintergrundinstallation

  • Updates werden im Hintergrund heruntergeladen und installiert
  • Laufende Aufgaben werden nicht unterbrochen
  • Keine Beeinträchtigung der Systemnutzung

• Umgebungswechsel

  • Automatischer Wechsel von Vorabversion zu Release, wenn die Versionen übereinstimmen
  • Sichert die Konsistenz der Produktivumgebung

Fremdprogramme, die das charly-Server-Skript verwendet

Die folgenden Programme kommen bei der Verwendung des charly-Server-Skripts unter Windows zum Einsatz:

• PostgreSQL 16: Datenbankmanagement-System, welches für die Datenspeicherung und Verarbeitung für charly verwendet wird.
• 7zip: Hier erfolgte die Umstellung von der portablen Version, die seit vielen Jahren von charly verwendet wird, auf eine Installation auf dem Server. Dies erleichtert die Nutzung und Verwaltung. Das Tool ist Teil der Erstinstallation und für viele Prozesse erforderlich, weshalb die Installation bei Bedarf wieder nachgezogen wird, da die Zustimmung bereits vorlag.
• AWSToolS3: Dieses Tool wurde integriert, um das bereits seit Jahren für den charly-Updater verwendete Backend für den Datenaustausch in den charly-Server zu integrieren.
• NuGet-Provider: Dieses Paket wird benötigt, um AWS-Funktionalität für PowerShell bereitzustellen. Es ermöglicht den Zugriff auf AWS-Dienste im Rahmen von Containern und Sendback-Prozessen.
• DiskSpd: Dieses Programm wird verwendet, um die Geschwindigkeit und den Zustand von Festplatten zu messen und zu bewerten. Dadurch können Hochrechnungen für die Ausführungszeiten von festplattenintensiven Vorgängen wie Backups, Container-Migrationen und Datenbank-Migrationen erstellt werden.
• Windows ADK: Das Windows Assessment and Deployment Kit (ADK) wird eingesetzt, um ISO-Dateien zu generieren und so Exportprozesse zu unterstützen. Ein Bestandteil ist das Tool OSDCIMG.
• Wiztree Portable: Wird verwendet, um vor der Erstellung eines Backups zu ermitteln, ob der Festplattenplatz dafür ausreicht.

Installationen zwischen dem 19.12.2024 und dem 9.1.2025 beinhalten noch eine native Installation von Wiztree, welche automatisch mit dem nächsten Aufruf vom charly-Server-Skript entfernt wird.

Support und Hilfe

Bei Fragen oder Problemen: - Verwenden Sie den -Help Parameter für detaillierte Informationen zu jedem Befehl - Kontaktieren Sie unseren Support - Dokumentieren Sie unerwartetes Verhalten mit der genauen Fehlermeldung

Sicherheitshinweise

• Führen Sie das charly-Server-Skript nur mit Administrator-Rechten aus.
• Alle Aktionen werden protokolliert. Sie können sich die Log-Dateien unter C:\Programdata\CharlyServer\Logs ansehen.
• Die automatischen Updates des charly-Server-Skripts beim Aufruf gewährleisten, dass Sicherheitsupdates und Bug-Behebungen zeitnah installiert werden.

---

Version: 2.1.2

Datum der letzten Aktualisierung: 27.02.2025