Release Notes
1 Administration
1.1 Update of internally used software
As of the release 2023.6, the following internally used software has been updated.
- ASM (library for analyzing and modifying Java byte code)
Updated from version 9.3 to version 9.5 - Google Guava
Updated from version 27.0 to version 31.1
1.2 Logging: Log4j2 XML configuration files
In FirstSpirit logging, the “Log4j 2” version branch of the “Apache Log4j” logging framework is used starting with the FirstSpirit version 2022.5.
With the current FirstSpirit release, “Log4j 2” configuration files in XML format are supported, as well. The sample configurations are located in the <FirstSpiritROOT>/conf/conf-all folder (fs-logging*.xml.default.txt) after the FirstSpirit server is updated.
The new “Log4j 2” configuration has priority over the old “Log4j 1” configuration.
For FirstSpirit servers with the FirstSpirit version 2023.6 or newer, “Log4j 2” is used by default. For FirstSpirit servers with an older FirstSpirit version, the configurations must be adjusted to switch from “Log4j 1” to “Log4j 2”.
Note: Mixed configurations are possible. For example, DEBUG logging can be configured with “Log4J 1” and INFO logging with “Log4j 2”.
Important: In a future release, support for “Log4j 1” will be permanently discontinued. Crownpeak recommends changing the configuration to “Log4j 2” early.
For more information, see Log4j 2 Configuration.
1.3 Repository compression with LZ4
For better server performance, the current FirstSpirit version compresses the repository of new projects with the LZ4 compression algorithm by default. The smaller size of the compressed repository database requires fewer filehandles and more data can be cached in the compressed database cache.
The default value can be configured with the new repository.defaultCompressor parameter in the fs-server.conf configuration file.
Possible values are:
LZ4 (default value):
repository.defaultCompressor=de.espirit.firstspirit.storage.backend.LZ4CompressorDeflate
repository.defaultCompressor=de.espirit.firstspirit.storage.backend.DeflaterCompressor[none]
repository.defaultCompressor=Parameter changes will only affect new projects.2 Administration / Modules
Downloading modules installed on FirstSpirit server
Server administrators now can download modules that are installed on the FirstSpirit server under “Legal notices” on the homepage:

Note: It is not possible to download system modules here.
3 FirstSpirit Content Experience Tools (CXT)
Latest module versions
FirstSpirit 2023.6 supports the following module versions for “FirstSpirit Content Experience Tools”.
| Module / file name | Version number |
FirstSpirit CXT Plattformplatform-[version].fsm | 3.0.9 |
FirstSpirit CXT DAP Bridgedataservice-[version].fsm | 1.44.12 |
FirstSpirit CXT FragmentCreatorfragment-creator-[version].fsm | 4.0.6 |
FirstSpirit Fragment DAPfragmentdap-[version].fsm | 1.40.19 |
FirstSpirit Media DAPmediadap-[version].fsm | 1.31.11 |
FirstSpirit PageRef DAPpagerefdap-[version].fsm | 1.9.11 |
FirstSpirit Markdown Editormarkdown-editor-[version].fsm | 1.29.10 |
FirstSpirit Tagging Editortagging-editor-[version].fsm | 1.29.10 |
FirstSpirit CXT FragmentCreator - CaaS Integrationcaas-integration-[version].fsm | 1.31.11 |
4 Template development
Images: Discard the metadata of the original image for automatically generated image files.
During an upload to FirstSpirit, images are initially stored in the project without changes concerning the format and resolution (resolution “Original”). However, for certain actions (based on the original image data), new image files are automatically generated by FirstSpirit, for example:
- when generating a preview image
- when generating new resolutions
- when using an automatically generated resolution
- in case of an image crop (in the FirstSpirit ContentCreator or SiteArchitect)
ImageWriteParams(FirstSpirit Access API, package de.espirit.firstspirit.access.project, interface Project, Method setCustomProperties). For example, you can configure the compression rate of images to generate a better image quality or smaller file size.
With the current release, it is now also possible to discard the metadata of the original image (e.g. EXIF information) using the discardMetadata parameter. By default, these are taken over.
In the following example, the property is configured to discard metadata for all images expect for PNG files.
project = context.getProject();
project.lock();
properties = new java.util.LinkedHashMap();
properties.put("default.discardMetadata", "true");
properties.put("default.png.discardMetadata", "false");
project.setCustomProperties("ImageWriteParam", properties);
project.save();
project.unlock();For more information, see documentation to ImageWriteParam.
Overview
| ID | Description | Categories |
|---|---|---|
| CORE-14888 | In projects, FormData objects of StoreElements are used in preview generation in certain cases. This is now supported for identifying such data structures in the |
Generation, Template Development |
| CORE-14921 | Starting with the current FirstSpirit release, XML Log4j 2 configuration files are supported. |
FirstSpirit Administrator, Logging |
| CORE-15101 | The default values for the integrated media preview have been adjusted. The image format SVG is now included in the file extension list for the browser engine. The image format WebP is now included in the file extension list for the integrated image view. The default values only apply to new projects or after restoring the default settings (see FirstSpirit ServerManager / Project properties / Client applications (→Documentation for Administrators)). |
Media, Preview, SiteArchitect |
| CORE-15113 | A problem in the preview display was occurring if the preview was based on a remote project or contained remote media. The issue has been fixed. |
ContentCreator, Preview, Remote access |
| CORE-15149 | Starting with the current FirstSpirit version, the “FirstSpirit Agency Support” module ceases to be a system module and can thus be uninstalled. |
Server Administrator |
| CORE-15151 | In the JxBrowser integration, limitations to the use of the |
FirstSpirit API |
| CORE-15257 | The project property |
Developer, Media |
| CORE-15267 | In very rare cases it was possible that entries in |
Server Administrator |
| CORE-15273 | Update of internally used software Further information can be found in chapter “Administration: Update of internally used software”. |
Integrated software |
| CORE-15285 | Server administrators can now download modules installed on the FirstSpirit server in “Legal notices” on the homepage. |
Modules |
| CORE-15298 | When using SiteArchitect with certain versions of third-party libraries (e.g. |
Developer, Module development |
| CORE-15326 | The repository of new projects is compressed by default using the LZ4 algorithm. Further information can be found in chapter “Administration: Repository compression with LZ4”. |
Repository, Server Administrator |
| CORE-15337 | FirstSpirit Content Experience Tools: Latest module versions |
FirstSpirit Content Experience Tools (CXT) |
| CORE-15354 | The |
Database |
| CXT-2870 | Open script forms can now also be saved with the initially displayed values. |
ContentCreator |
| CXT-2881 | The project homepage is opened in the project master language again. For this, the UI language setting is no longer relevant. |
ContentCreator |
Deprecations
| Functionality | Deprecated as of | Will be removed / Was removed as of |
|---|---|---|
| Input component CMS_INPUT_CONTENTAREALIST | 5.2R3 | |
| Input component CMS_INPUT_CONTENTLIST | 5.2R3 | |
| Input component CMS_INPUT_FILE | 5.2R3 | |
| Input component CMS_INPUT_LINKLIST | 5.2R3 | |
| Input component CMS_INPUT_OBJECTCHOOSER | 5.2R3 | |
| Input component CMS_INPUT_PAGEREF | 5.2R3 | |
| Input component CMS_INPUT_PICTURE | 5.2R3 | |
| Input component CMS_INPUT_TABLIST | 5.2R3 | |
| FirstSpirit Access API: de.espirit.firstspirit.agency.GroupsAgent | 5.2R15 | |
| FirstSpirit Access API: delete (de.espirit.firstspirit.access.AccessUtil) | 5.2R18 | |
| FirstSpirit Access API: release (de.espirit.firstspirit.access.AccessUtil) | 2018-06 | |
| FirstSpirit Access API: getLastLoginAsDate (de.espirit.firstspirit.agency.UserStatisticsAgent) | 2018-07 | |
| FirstSpirit Access API: remainingDurationOfCurrentStageInMillis (de.espirit.firstspirit.server.MaintenanceModeInfo) | 2018-07 | 2025-13 |
| FirstSpirit Access API: getStartingTimeOfStageAsDate (de.espirit.firstspirit.server.MaintenanceModeInfo) | 2018-07 | 2025-13 |
| FirstSpirit Access API: getSelectedWebserverConfiguration (de.espirit.firstspirit.access.serverConfiguration) | 2018-10 | 2025-13 |
| FirstSpirit Access API: setSelectedWebserverConfiguration (de.espirit.firstspirit.access.serverConfiguration) | 2018-10 | 2025-13 |
| FirstSpirit Access API: getSelectedWebServer (de.espirit.firstspirit.access.project.Project) | 2018-10 | 2025-13 |
| FirstSpirit Access API: setSelectedWebServer (de.espirit.firstspirit.access.project.Project) | 2018-10 | 2025-13 |
| FirstSpirit Access API: getLostAndFoundStoreNodes(); (de.espirit.firstspirit.feature.FeatureInstallResult) | 2018-10 | |
| FirstSpirit Access API: getDeletedStoreNodes(); (de.espirit.firstspirit.feature.FeatureInstallResult) | 2018-10 | |
| FirstSpirit Access API: de.espirit.firstspirit.access.store.Previewable | 2019-01 | |
| WebSphere Application Server support for FirstSpirit | 2019-05 | |
| Database layer for Oracle Database 11g/12c | 2020-12 | 2025-05 |
| FirstSpirit Access API: redirectTemplateLogToDefaultLog() (Interface RenderingAgent.Renderer) | 2021-05 | |
| Support for Log4j 1 | 2022-05 | 2024-06 |