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
Container (charly-VM)
Ü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
- Beispiel:
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
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