charly-Server-Skript für macOS

Diese Dokumentation beschreibt alle Funktionalitäten, die mit dem charly-Server-Skript für das Betriebssystem macOS möglich sind.

Klassischer charly-Server

• Export der Datenbank und Files
• Migration vom klassischen Server

Container (charly-VM)

• Installation und Konfiguration
• Betrieb und Wartung

Release Notes

Übersicht

Das charly-Server-Skript ist ein Wartungsskript für macOS-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

Zuerst muss der macOS Paketmanager brew installiert werden

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

WICHTIG

Am Ende fordert die brew Installation auf, noch einige Dinge als "Next steps" in der Kommandozeile einzugeben. Führen Sie die 3 Kommandos nacheinander aus.

Prüfen, ob homebrew schon installiert ist:

brew --version

Hier sollte eine Versionnummer ausgegeben werden.

Dann kann das charly-server Skript mit folgendem Befehl installiert werden:

/bin/zsh -c "$(curl -fsSL https://charly-cdn-solutio.s3.amazonaws.com/release/macos/charly-server-install.zsh)"

Prüfen, ob charly-server installiert wurde:

charly-server -help

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

Update des charly-Server-Skripts

Das charly-Server-Skript automatisch bei jedem Aufruf auf die neueste 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

Fremdprogramme, die das charly-Server-Skript verwendet

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

• Homebrew Ein Paketmanager für macOS, der das einfache installieren verschiedener Tools erlaubt
• PostgreSQL 16: Datenbankmanagement-System, welches für die Datenspeicherung und Verarbeitung für charly verwendet wird.
• 7zip: Ein Tool zum Packen von Ordnern in eine .7z oder tar.gz Datei
• QEMU: Hypervisor, der für den Betrieb der Container (charly-VM) benötigt wird.
• xorriso: Wird eingesetzt, um ISO-Dateien zu generieren und so Exportprozesse zu unterstützen.
• Restic: Ein leistungsfähiges Backup-System für platzsparende, inkrementelle Backups

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

Häufig gestellte Fragen (FAQ)

1. Wird meine aktuelle Aufgabe durch ein Update unterbrochen?

   • Nein, Updates laufen im Hintergrund und unterbrechen keine laufenden Aufgaben.

2. Muss ich das Update des charly-Server-Skripts manuell anstoßen?

   • Nein, die Updates des charly-Server-Skripts werden automatisch geprüft und installiert, wenn das charly-Server-Skript aufgerufen wird.

3. Kann ich die unterstützende Software deinstallieren?

   • Grundsätzlich ist das problemlos möglich, sie wird jedoch automatisch erneut installiert, sobald sie vom charly-Server-Skript benötigt wird.

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 /usr/local/var/log/charly-server ansehen.
• Die automatischen Updates des charly-Server-Skripts beim Aufruf gewährleisten, dass Sicherheitsupdates und Bug-Behebungen zeitnah installiert werden.

---

Version: 2.8.7

Datum der letzten Aktualisierung: 20.11.2025