marx-software.de

Setup und Configuration

Installation

Die Installation gestaltet sich relativ einfach:

  1. Aktuelle Version von GitHub laden
  2. Download entpacken
  3. Mindestens Java Version 21 Installieren

Die Installation is somit abgeschlossen.

Start

java -Dlog4j2.configurationFile=log4j2.xml -jar cms-server-4.16.0.jar start 

Server Konfiguration

Beispielkonfiguration für einen Server-Konfig:

server:
    port: 1010
    ip: "127.0.0.1"
env: dev
apm:
  enabled: true
  max_requests: 100
  max_suspend: "PT1S"
  thread_limit: 10

Server Port und IP

Hier können Port und IP konfiguriert werden unter denen das CMS erreichbar ist.

Environment

Für Environment gibt es zwei mögliche Werte. dev bedeutet, es handelt sich um ein Entwicklungssystem. alles andere bedeutet, es handelt sich um ein Produktionssystem.

Im Betrieb unterscheiden sich die beiden in erster Linie durch unterschiedlich konfigurierte Caches.

Entwicklungssystem: Cache für gerenderte Inhalte ist deaktiviert. Für Medien wird kein Cache-Header gesetzt.

Produktionssystem: Gerenderte Inhalte werden für eine Minute gecacht. Für Medien wird ein Cache-Header (10d) ausgeliefert.

Application Performance Management (kurz apm)

Hier können Einstellung vorgenommen werden, die den Server vor Überlastung schützen und für einen bessere Besuchererfahrung sorgen.

enabled: APM aktivieren

max_request: Die maximale Anzahl an Requests, die der Server gleichzeitig verarbeitet.

thread_limit: Die maximale Anzahl von Threads/Requests die gleichzeitig von einer IP verarbeitet werden.

max_suspend: Die maximale Zeit, die ein Request blockiert wird, bis Resourcen frei sind. java.time.Duration

Inter process communication (kurz ipc)

Zum starten und stoppen des Servers über die CLI wird einen IPC-Schnittstelle erzeugt, die nur local erreichbar ist.

port: Port für die IPC. Default: 6868

password: Optionales Passwort für die IPC.