Release Notes FirstSpirit™ 2023.6

Release Notes

FirstSpirit™ 2023.6

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.LZ4Compressor

Deflate

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:

UID=rechtliche_hinweise_1

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 nameVersion number
FirstSpirit CXT Plattform
platform-[version].fsm
3.0.9
FirstSpirit CXT DAP Bridge
dataservice-[version].fsm
1.44.12
FirstSpirit CXT FragmentCreator
fragment-creator-[version].fsm
4.0.6
FirstSpirit Fragment DAP
fragmentdap-[version].fsm
1.40.19
FirstSpirit Media DAP
mediadap-[version].fsm
1.31.11
FirstSpirit PageRef DAP
pagerefdap-[version].fsm
1.9.11
FirstSpirit Markdown Editor
markdown-editor-[version].fsm
1.29.10
FirstSpirit Tagging Editor
tagging-editor-[version].fsm
1.29.10
FirstSpirit CXT FragmentCreator - CaaS Integration
caas-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)
This generation can be influenced via the user-defined project property

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 editorId function.

Generation, Template Development
CORE-14921

Starting with the current FirstSpirit release, XML Log4j 2 configuration files are supported.

Further information can be found in chapter “Administration: Logging: Log4j2 XML configuration files”.

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 JC_API existed (Interface JavaClientApi, package de.espirit.firstspirit.client.gui). The limitations have been removed.

FirstSpirit API
CORE-15257

The project property ImageWriteParam can be used to discard metadata of the original image (e.g., EXIF information) when generating images. By default, these are taken over.

Further information can be found in chapter “Template development: Images: Discard the metadata of the original image for automatically generated image files.”.

Developer, Media
CORE-15267

In very rare cases it was possible that entries in fs-server-aux.conf were not taken into account after a server restart. The problem has been resolved.

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.

Further information can be found in chapter “Administration / Modules: Downloading modules installed on FirstSpirit server”.

Modules
CORE-15298

When using SiteArchitect with certain versions of third-party libraries (e.g. Apache commons-lang3), problems on the server scope could occur, e.g. when search results were listed. The error susceptibility has been reduced. Module developers are still advised to avoid dependencies in the server scope if possible.

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

Further information can be found in chapter “FirstSpirit Content Experience Tools (CXT): Latest module versions”.

FirstSpirit Content Experience Tools (CXT)
CORE-15354

The BerkeleyUtil.jar is no longer signed.

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