Release Notes

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

• Eclipse Jetty (im Modul fs-jetty.fsm / „FirstSpirit Jetty Service“ enthalten)
  Aktualisierung auf Version 12.0.2
  Der Einsatz von Eclipse Jetty für Produktivzwecke wird weiterhin nicht empfohlen!
• Java Die folgende neue Java-Version ist verfügbar
  In FirstSpirit integriert (Standard): 17.0.9+9 OpenJDK

Das „FirstSpirit SAML Login“ Modul setzte für das Debug-Logging bisher ein konfiguriertes Log4j voraus.

Mit der aktuellen Version ist dies nicht mehr notwendig, stattdessen wird jetzt Java-Util-Logging (JUL) verwendet, das als Standard-Logging-Framework von Apache Tomcat konfiguriert ist.

Für existierende Installationen ist hier eine Anpassung der Konfiguration notwendig, wenn das Logging dauerhaft aktiv sein soll.

Zu beachten ist, dass der verwendete SLF4J-JUL-Adapter in Einzelfällen zu Konflikten führen kann, falls andere Web-Komponenten der FirstSpirit-Startseite ebenfalls einen SLF4J-Adapter mitliefern.

Die Online-Dokumentation von FirstSpirit (ODFS) wird jetzt nicht mehr durch die lokale Firstspirit-Installation bereitgestellt. Stattdessen leitet ein Aufruf der Hilfe automatisch auf die aktuelle Dokumentation auf docs.e-spirit.com um.

Falls gewünscht, kann der bisherige Zustand vom Server-Administrator wiederhergestellt werden.

1) „FirstSpirit Online Documentation“ Modul (odfs.fsm) installieren

2) Eine globale WebApp hinzufügen

3) Web-Komponente „FirstSpirit Online Dokumentation“ hinzufügen

4) Die globale WebApp ausrollen

5) Parameter ODFS_BASE_URL in fs-server.conf definieren

Beispiel:

ODFS_BASE_URL=https://myServer:8000/help/odfs

Details dazu ist in der Dokumentation für Administratoren zu finden.

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

Die Simple Logging Facade for Java (SLF4J) ist eine einheitliche API zum Erzeugen von Logging, die über eine Vielzahl von Adaptern mit vielen Logging-Frameworks (Log4j, Logback, ...) zusammenarbeiten kann.

Seit der Version 2023.12 wird FirstSpirit mit einem SLF4J-Adapter ausgeliefert, der Logging über SLF4J an das Base-Logging weiterreicht. Die Vorteile dieser API sind unter anderem

• Nutzung einer bekannten, einheitlichen Schnittstelle
• einfacherer Aufruf ohne Class-Objekte
• automatischer Ersatz von Platzhaltern

Beispiel:

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class Demo {
   private static final Logger LOGGER = LoggerFactory.getLogger(Demo.class);
   public Demo() {
      LOGGER.info("Demo application started.");
   }
}

Diese API kann ebenfalls von Web-Komponenten, die zum ContentCreator hinzugefügt werden, ohne weitere Konfiguration verwendet werden. Bei anderen Komponenten, etwa solchen, die in einem eigenen Web-Context installiert werden, ist jedoch das Einbinden eines eigenen SL4FJ-Adapters notwendig.

Start und Aktualisierung („Rollout“) der FirstSpirit Desktop Apps (FirstSpirit SiteArchitect und ServerManager) erfolgen über den FirstSpirit Launcher.

Das Modul „FirstSpirit Launcher JRE“ ermöglicht Kunden und Partnern einen einfachen Wechsel zwischen unterschiedlichen Java-Versionen für den Betrieb der FirstSpirit Desktop Apps. Die Auswahl der gewünschten Java-Version kann serverweit jeweils für Microsoft Windows und macOS getrennt vorgenommen werden.

Dokumentation zum Modul „FirstSpirit Launcher JRE“ siehe FirstSpirit Launcher JRE unter FirstSpirit Online Dokumentation.

Mit dem aktuellen Release wurden die enthaltene Java-Version aktualisiert: Neben der mit dem FirstSpirit Launcher ausgelieferten Version, AdoptOpenJDK 17.0.9 „(Default)“, ist aktuell Java-Variante Eclipse Temurin 21+35 verfügbar.

FirstSpirit wurde auf Kompatibilität mit OpenJDK 21 getestet.

Zusätzlich wurde OpenJDK 21 in die Liste der kompatiblen JDKs aufgenommen.

Dies gilt sowohl für den FirstSpirit-Server, als auch für die FirstSpirit-Desktop-Anwendungen.

Eine vollständige Auflistung der unterstützten Java-Versionen für den FirstSpirit-Server findet sich unter Technische Voraussetzungen und Empfehlungen (Dokumentation für Administratoren).