Konfiguration des ContentCreator

Der FirstSpirit ContentCreator stellt eine browserbasierte Oberfläche für die schnelle und unkomplizierte Pflege redaktioneller Inhalte zur Verfügung. Dabei können Autoren die vielfältigen Funktionen der FirstSpirit Redaktionsumgebung sofort nutzen, da entgegen der Installation des FirstSpirit-SiteArchitect für den ContentCreator keine Java-Umgebung (JRE) benötigt wird. Der ContentCreator arbeitet aus technischer Sicht rein auf Basis von HTML und JavaScript.

Allgemeine Voraussetzungen

Die Technischen Voraussetzungen hinsichtlich Hard- und Software für FirstSpirit ContentCreator finden sich im „FirstSpirit Technische Datenblatt“ (siehe FirstSpirit: Technische Voraussetzungen und Empfehlungen).

Folgende Randbedingungen müssen darüber hinaus gegeben sein, um FirstSpirit ContentCreator erfolgreich einsetzen zu können. Diese Bedingungen sollten vor dem Einsatz geprüft werden:

• Funktionalität
  Teilweise weichen die Funktionen der Eingabekomponenten im ContentCreator von denen im SiteArchitect ab. Daher sollte vor Verwendung des ContentCreator genau geprüft werden, ob die im Projekt benötigten Eingabekomponenten vom ContentCreator unterstützt werden. Siehe dazu u.a. ContentCreator (→Online Dokumentation FirstSpirit).
  Auch kundenspezifische Komponenten müssen genau geprüft werden.
• Browser-Kompatibilität
  • Welcher Browser wird eingesetzt?
    Zu unterstützten Browsern siehe auch FirstSpirit: Technische Voraussetzungen und Empfehlungen.
  • Welche Sicherheits-Einstellungen werden im Unternehmen verwendet? Läuft der ContentCreator in dieser Konfiguration?
• Proxy-/Firewall-Konfiguration
  Wird zwangsweise ein Proxy oder eine Firewall verwendet? Läuft der ContentCreator in dieser Konfiguration (speziell Refresh-Problem)?
• Gesicherter Zugriff
  Kann der http/https-Port des FirstSpirit-Servers für den ContentCreator-Anwenderkreis gefahrlos (ggf. auch nach außen) freigeschaltet werden?
• Bildschirmauflösung
  mind.: 1024x768 Pixel

Best practice

Für einen erfolgreichen Betrieb des FirstSpirit ContentCreator gelten folgende Empfehlungen:

• Applikations-Server / Ressourcen
  Der eingesetzte Applikations-Server (z. B. Apache Tomcat) sollte über ausreichende Ressourcen verfügen, speziell was Festplattenplatz und Java-Heap betrifft (zum Java-Heap siehe beispielsweise Seite Konfiguration der Java-VM).
  Bei einem Einsatz von Apache Tomcat als Application-Server wird grundsätzlich nach jeder Aktualisierung von FirstSpirit ein Neustart des Apache Tomcat empfohlen.
• Globale vs. projekt-lokale Web-Applikation
  Ebenfalls aus Ressourcen- sowie Wartungsgründen sollte der ContentCreator, soweit möglich, als globale Web-Applikation verwendet werden. Als eigene Projektinstanz („projektlokal“) sollte der ContentCreator nur betrieben werden, wenn dies unbedingt nötig ist.
  (Siehe dazu auch Seiten Individualisierung der FirstSpirit Webanwendungen und Der ContentCreator als projektlokale Anwendung.)

Logging

Standardmäßig loggt der FirstSpirit ContentCreator in die Konsole.

Um Logging in eine Datei zu aktivieren, muss eine Datei

~/config/cxt-cc.properties

im Classpath erstellt werden.

In dieser Properties-Datei muss über den Parameter logging.file.name Pfad und Name einer Datei definiert werden, in die das Logging erfolgen soll, z. B.

logging.file.name=/home/tomcat/logs/firstspirit-cc.log 

Das Standard-Log-Level ist INFO, das bedeutet, dass Fehler der Kategorien ERROR, WARN und INFO festgehalten werden.

Bei den zur Verfügung stehenden Properties (inkl. logging.file.name) handelt es sich um die entsprechenden Standard-Spring-Boot-Properties. Die Logging-Konfiguration kann bei Bedarf weiter angepasst werden: https://docs.spring.io/spring-boot/docs/2.4.2/reference/html/appendix-application-properties.html#common-application-properties-core.

Standardmäßig wird keine Log-Datei erzeugt.

Hinweis: Die Konfiguration über ~/config/cxt-cc.properties gilt für alle ContentCreator-Instanzen, sowohl für den globalen ContentCreator als auch für evtl. konfigurierte projektlokale ContentCreator-Instanzen (= auf dem Register „ContentCreator“ unter Projekt-Eigenschaften / Web-Komponenten ist ein Webserver konfiguriert).

Weitere Konfigurationsmöglichkeiten

• Serverseitige Konfiguration per Konfigurationsdatei fs-server.conf, Bereiche Web Applications und WEBedit configuration
  Vor dem produktiven Einsatz des ContentCreator sollte die Konfiguration gemäß dieser Abschnitte an die jeweiligen Erfordernisse angepasst werden.
• Konfiguration als globale oder projektlokale Webanwendung: Siehe dazu Seiten Individualisierung der FirstSpirit Webanwendungen und Der ContentCreator als projektlokale Anwendung.
• Konfiguration des ContentCreator als globale Web-Applikation (Webserver, Deployment, Einstellungen / web.xml usw.: Seite Web-Applikationen
• Konfiguration des ContentCreator als projekt-lokale Web-Applikation (Webserver, Deployment, Einstellungen / web.xml usw.: Seite Web-Komponenten
• Vorlagenentwicklung: Zu Funktionen, Einschränkungen und Erweiterungsmöglichkeiten des ContentCreator siehe Kapitel ContentCreator (→Online Dokumentation FirstSpirit).
• Hinweise zur Browserkonfiguration: Browserkonfiguration für den Einsatz des ContentCreator