Release Notes

Mit dem Release 2023.2 sind folgende intern verwendete Software aktualisiert worden.

• Apache Commons IO (Bibliothek mit Operationen für Datei-Ein- und -Ausgaben)
  Aktualisierung von Version 1.3.2 auf Version 2.11.0
• Apache Commons Lang
  Aktualisierung auf Version 3.12.0
• Java (JRE, mit dem die Desktop Clients SiteArchitect und ServerManager betrieben werden)
  In FirstSpirit integriert (Standard): 17.0.5+8 64bit AdoptOpenJDK

Mit dem Release 2023.3 wird folgende intern verwendete Software aktualisiert.

• Gson (2.8.0 --> 2.10)
• metadata-extractor (2.11.0 --> 2.18.0)
• Apache POI (3.7 --> 5.2.2)
• commons-codec (1.11 --> 1.15)
• commons-collections (4.1 --> 4.4)
• commons-math (3.6.1, neu)
• xmlbeans (2.5.0 --> 5.0.3)
• dom4j (1.6.1 --> wird nicht mehr verwendet)

Im FirstSpirit ContentCreator konnte es beim Betrieb eines Application-Servers mit Java 17 oder neuer zu Problemen beim Anlegen bzw. Bearbeiten von Absätzen kommen.

Um diese zu beheben, ist es notwendig, den folgenden Parameter zu verwenden:

--add-opens=java.base/java.lang=ALL-UNNAMED

Der Parameter wurde in der fs-wrapper-vendor.conf-Datei hinzugefügt. Nach einem Update des FirstSpirit-Servers steht er automatisch zur Verfügung.

In den Startparametern externer Application-Server (z.B. Tomcat) müssen die --add-opens-Parameter, die in der fs-wrapper-vendor.conf-Datei zu finden sind, ergänzt werden.

Zum Start der FirstSpirit-Desktop-Anwendungen (ServerManager, SiteArchitect) wird nun standardmäßig Java 17 verwendet.

Wenn für den Benutzer, unter dem der FirstSpirit-Server betrieben wird, im Betriebssystem keine freien File-Handles mehr zur Verfügung standen, führte das zu schwerwiegenden Folgeproblemen.

Die Server-Einstellungen für Linux-basierte Betriebssysteme wurden nun in der fs-server.conf-Datei verändert, um solchen Problemen vorzubeugen:

• Die Open Files werden im 60-Sekunden-Takt geprüft.
• Sobald das Warn-Limit überschritten wird (Voreinstellung: 90%), erhält der Server den Status „Degraded“.
• Sobald das Shutdown-Limit überschritten wird (Voreinstellung: 95%), wird der Server heruntergefahren.
• Der Server-Administrator wird bei einer Limit-Überschreitung via E-Mail benachrichtigt.

Standardwerte der fs-server.conf-Datei:

# open files warning limit
files.limit.percent=90
files.limit.active=true
# open files shutdown limit
files.shutdown.percent=95
files.shutdown.active=true

Die Open Files können nun im „HealthManager MBeans“ mithilfe der Einträge maxFileHandles und openFileHandles geprüft werden.

Bisher wurde die JSON-Generierung abgebrochen, wenn es zu Implementierungsfehlern des Data Access Plugins kam.

Die JSON-Generierung wird nun auch bei DAP-Fehlern fortgesetzt. Der Fehler wird dabei als JSON-Fehlerobjekt ausgegeben.

Das Zurücksetzen manueller Zuschnitte kann für die gesamte Gruppe ausgeführt werden. Wenn Auflösungen manuell hochgeladen wurden, werden sie mit einem Ausrufezeichen gekennzeichnet und können ebenfalls als Gruppe zurückgesetzt werden.

Folgende Modul-Versionen für „FirstSpirit Content Experience Tools“ werden von FirstSpirit 2023.2 unterstützt.

* Diese Module benötigen ab dieser Version FirstSpirit 2020-03 oder höher.

Ab dem FirstSpirit Relase 2022.13 ist es möglich über die Managementseite die Verfügbarkeit vom MicroApps zu konfigurieren.

Diese Managementseite ist unter

/management

(angehängt an die URL der Plattform) erreichbar, also z. B.

http://myServer:8080/cxt-platform/management

Bisher wurde die Managementseite nur für Server-Administratoren erreichbar.

Mit dem aktuellen Release ist die Seite auch für Projekt-Administaratoren zugänglich.

Installation / Module / Module installieren / Plattform (→Dokumentation „Content Experience Tools“)

Grenzwerte für den freien Festplatten-Speicherplatz können in den globalen Server-Eigenschaften (FirstSpirit ServerMananger) oder mit den Parametern hdd.limit und hdd.shutdown (fs-server.conf) festgelegt werden. Beim Überschreiten dieser Werte wird eine E-Mail an den Server-Administrator versendet. Beim Überschreiten des Shutdown-Limits wird der FirstSpirit-Server heruntergefahren.

Bisher konnte der Grenzwert nur als Festplatten-Speicherplatz-Prozentsatz angegeben werden.

Mit dem aktuellen Release kann statt der prozentualen Angabe des freien Speicherplatzes ein absoluter Wert angegeben werden.

Hinweis:

Werte unter 100 werden als Prozentangaben interpretiert:

• hdd.shutdown=1073741824: Shutdown-Limit bei 1 GiB Festplatten-Restspeicherplatz
• hdd.shutdown=97: Shutdown-Limit bei 97% des gesamten Festplatten-Speicherplatzes

Bei der Angabe absoluter Werte können die Einheiten m (MiB), g (GiB) und t (TiB) verwendet werden:

• hdd.shutdown=2g: Shutdown-Limit bei 2 GiB Festplatten-Restspeicherplatz

Hinweis:

• Technisch kleinstmöglicher Festplatten-Restspeicherplatz für Shutdown-Limit: 512 MiB
• Empfohlener Restspeicherplatz für Shutdown-Limit: 95%, mindestens 2 GiB

Die Grenzwerte können auch per API definiert werden (FirstSpirit Access-API, Package de.espirit.firstspirit.server.configuration). Die bisherigen Methoden wurden deprecated und durch neue ersetzt. Die Grenzwerte werden nun als String übergeben.

Bisher waren beim Erstellen und Bearbeiten einer Tabelle in einem Datenbank-Schema Leerzeichen im Namen der Tabelle erlaubt. Leerzeichen in Tabellen konnten dazu führen, dass beim Suchen in der Datenquelle zur betroffenen Tabelle keine Ergebnisse angezeigt wurden.

Mit dem aktuellen Release ist es beim Erstellen und Bearbeiten einer Tabelle in der GUI nicht mehr möglich, Leerzeichen in Tabellennamen zu verwenden.

Hinweis: Die Namen existierender Tabellen werden nicht angepasst und gelten weiterhin als korrekt, auch wenn Leerzeichen im Namen vorkommen. Bei Änderungen am Tabellennamen müssen Leerzeichen entfernt werden.