Introduction
Introduction

Introduction / Technical requirements and recommendations

FirstSpirit: Technical requirements and recommendations

Explanation of terms used

Table of contents

Recommended / reference: For the recommended reference system configurations, e-Spirit AG:

  • carries out regular tests (with every release) so that problems are generally discovered before delivery.
  • takes steps to eliminate errors based on error messages.   

Compatible: Compatible system configurations are / have been checked by e-Spirit and deemed functional. For these system configurations, e-Spirit AG:

  • carries out regular tests (depending on the market relevance of the configuration)
  • takes steps to eliminate errors based on error messages.

Not supported: List of system configurations that are known to cause problems or are highly likely to cause problems.

For non-supported system configurations, e-Spirit AG:

  • will NOT take any measures to eliminate any problems that may arise.

Note: If a system configuration is not listed in this area, this does not mean that it is supported. It only means that no specific information is currently available.

Important Unless otherwise specified, FirstSpirit always works with the current version of a third-party component (operating system, JDK, servlet engine, application server, databases).

Term

Information about troubleshooting

Recommended / reference

Yes*

Compatible

Yes*

Not supported

No

* Problems which arise when using these components in conjunction with FirstSpirit can be reported via FirstSpirit product support. Please address queries to Technical Support (for partners) or to your project manager (for customers). For more information, see also Information about troubleshooting.

  

SaaS or on-premises?

Important All of the information and recommendations below relate to on-premises FirstSpirit installations.

Alternatively, FirstSpirit is also increasingly hosted as a SaaS model. In this case, the costs and responsibility for providing and updating the infrastructure are borne by an external service provider.

More information on this subject can be found in the blog post FirstSpirit as a cloud solution.

FirstSpirit Server

Operating system

Recommended operating systems (reference):

  • Microsoft Windows Server (in the current version)
  • Common Linux distributions, e.g., Debian GNU/Linux (in the current version), indicating the file systems:

Compatible operating systems: FirstSpirit is also operated successfully with other operating systems and operating system versions, e.g.:

  • Microsoft Windows Server
  • Red Hat Enterprise Linux
  • Suse Linux Enterprise Server
  • Ubuntu

A detailed list of compatible operating systems can be found here.

Not supported:

  • Operating systems in the 32-bit version

Important The server only supports operating systems in the 64-bit version!

Hardware / Sizing

Due to the many (project-dependent) factors that influence the requirements regarding hardware dimensioning, architects or consultants from e-Spirit AG should always be consulted for a detailed assessment of the requirements and the necessary configurations.

Relevant scaling factors include:

  • Number of editors working at the same time
  • Number of projects on a server (main memory, preview)
  • Number of pages in all projects (generation, backup)
  • Size and number of media required (generation, backup)

Size

Number of editors

Number of projects

Number of pages (all projects)

Media size

S

< 50

< 5

< 50,000

< 5 GB

M

< 300

< 10

< 1,000,000

< 50 GB

L

< 1,000

> 10

> 1,000,000

> 50 GB

     

For current recommendations with regard to calculating the CPU, hard disk space, or RAM requirements (especially for size “L” projects), please contact us or your project manager directly.

Java

Recommended JDKs:

  • OpenJDK 11 (in the current version) **

Compatible JDKs: FirstSpirit is also operated successfully with other JDKs:

  • Oracle Java 11 (in the current version)
  • Oracle Java 8 (in the current version) *
  • OpenJDK 13 (in the current version) **
  • OpenJDK 11 (in the current version) **
  • OpenJDK 8 (in the current version) */**

More information about compatible JDKs can be found here.

Not supported:

  • Oracle JDK < 8, 9, 10
  • OpenJDK < 8, 9, 10
  • Java implementations from other manufacturers (e.g., IBM JDK on Linux or Windows, Apple JDK on macOS for FirstSpirit Server, Azul VM), JDK under IA64

* The Java 8 support will be discontinued in the future.

** Recommended: Use of the OpenJDK distribution AdoptOpenJDK (HotSpot JVM): AdoptOpenJDK provides up-to-date OpenJDK binaries for different platforms (e.g. macOS, Linux, Windows) for download. For information about AdoptOpenJDK see https://adoptopenjdk.net

Important Note regarding the switch from Java 8 to Java 11: Before operating Java 11 on a production system, the compatibility of all used modules and implementations with Java 11 must be checked on a test system !
Important The server only supports JDKs in the 64-bit version!

Outlook: Java 8 support

As part of product maintenance, discontinuation of support for Java 8 was announced with FirstSpirit 2019-05 (*).
FirstSpirit is scheduled to no longer support Oracle Java 8 and OpenJDK 8 from June 2020.

(*) Oracle themselves have not provided any public updates for Java 8 since February 2019 and recommend that developers and end users transition to a higher Java version in order to continue receiving public updates and security enhancements.

Background: FirstSpirit is operated successfully by customers and partners with a wide range of different third-party components (operating systems, JDKs, servlet engines, application servers, databases) and external libraries. Some of these components / libraries are no longer compatible with Java 8 in the current version. This applies, for example, to the internal “Apache Derby” database supplied with FirstSpirit. This means that updates can no longer be carried out for these third-party components / libraries, which is particularly critical for security-relevant updates.

Important If security gaps or security-relevant problems should occur under Java 8 in the future, e-Spirit AG reserves the right to terminate Java 8 support for FirstSpirit prematurely (before June 2020).

With the end of Java 8 support, as announced before, also:

  • the support for the Windows installer will be dropped. We advise our customers to use the new installation method via the install archive (see Installing FirstSpirit (→Installation Instructions)) and
  • the option of starting the FirstSpirit desktop applications via Java Web Start will no longer be available. (The Java Web Start functionality is included in Oracle Java 8, but will not appear in Oracle Java 11. OpenJDK does not offer a comparable technology.) SiteArchitect and ServerManager can then be started only via the FirstSpirit Launcher (see FirstSpirit Launcher documentation).

The ramp-down phase for Java 8 will start as planned in Q2-2020 and will gradually reduce the Java 8 compatibility tests. In Q4-2020 the byte code level will be switched from Java 8 to Java 11. From this point on, all Java versions prior to Java 11 (LTS) will be incompatible with FirstSpirit.

This means that FirstSpirit will no longer be executable with Oracle Java 8 or OpenJDK 8 and that e-Spirit AG will no longer implement any measures to eliminate errors or problems associated with Java 8. We recommend that you switch to a higher Java version soon.

FirstSpirit desktop apps

Operating system

Recommended operating systems (reference):

  • Microsoft Windows 10 (in the current version)
  • macOS Mojave (10.14) (in the current version)

Compatible operating systems: FirstSpirit is also operated successfully with other operating systems and operating system versions, e.g.:

  • Microsoft Windows
  • Ubuntu
  • macOS

A detailed list of known compatible operating systems can be found here.

Not supported:

  • Microsoft XP and older
  • macOS El Capitan (10.11) and older
  • Operating systems in the 32-bit version

Important Only operating systems in the 64-bit version are supported on the client side!

Hardware / Sizing

Installing and operating the FirstSpirit desktop applications does not result in any special requirements with regard to hardware dimensioning. If you need information about sizing in the case of special requirements, please contact us or your project manager directly.

Java

Recommended: Start via FirstSpirit Launcher (reference): The FirstSpirit desktop apps (SiteArchitect, ServerManager) are started via the FirstSpirit Launcher. The FirstSpirit Launcher provides a continuously updated, extensively tested, and license-free Java Runtime Environment which is rolled out when the Launcher is installed. This allows SiteArchitect and ServerManager to be operated in a preconfigured environment which is independent of the Java version on the client computer – even if there is no Java version installed at all.

FirstSpirit web apps

Browser

Recommended browsers (reference):

  • Microsoft Internet Explorer 10
  • Mozilla Firefox
  • Google Chrome *
  • Microsoft Edge *

* Reference only for FragmentCreator

Compatible browsers: The FirstSpirit web apps are also operated successfully with other browsers:

  • Microsoft Internet Explorer *
  • Microsoft Edge
  • Mozilla Firefox
  • Google Chrome
  • Apple Safari

* for FragmentCreator: only in version 11

A detailed list of known compatible browsers can be found here.

Not supported:

  • Microsoft Internet Explorer ≤ 7
  • Other web browsers, e.g., Opera

Hardware

Operating the FirstSpirit web apps does not result in any special requirements with regard to hardware dimensioning.

Servlet engine / Application server

The following application servers are supported for live use of FirstSpirit:

Recommended application servers (reference):

  • Apache HTTP Server 2.4
  • Apache Tomcat 9.0.31 or higher

Compatible application servers: FirstSpirit is also operated successfully by customers and partners with other application servers in different versions:

  • Apache HTTP Server
  • Apache Tomcat
  • Microsoft Internet Information Server
  • WebSphere Application Server *

* The support of WebSphere Application Server will be discontinued in the future.

A detailed list of known compatible application servers can be found here.

Important A servlet engine integrating version 3.0 of the servlet API is required in order to use the FirstSpirit web applications.
Important At the current time FirstSpirit is incompatible with Tomcat 10.
Using a Tomcat version higher than 9.0 is also not recommended.
Reason: Due to the change from Java EE to Jakarta EE and the associated change of the namespace (package) in Tomcat 10, extensive adjustments to the FirstSpirit web applications are required.

Not supported:

  • Apache Tomcat > 9.0
  • Apache Tomcat < 8.5
  • WebSphere Application Server < 8.5
  • JBoss Application Server 5

Important The open-source product “Eclipse Jetty” which is provided with FirstSpirit is not suitable for live operation and should only be used for test purposes.

Databases

External database systems can be connected with FirstSpirit via JDBC (see Database connection).
The following database systems are supported for live use of FirstSpirit:

Recommended database systems:

  • IBM DB2 10.5
  • MariaDB 10.1.23
  • MySQL 5.5.23
  • Microsoft SQL Server 2016 | 2014 (only for Windows Server)
  • Oracle 11.2.0.1
  • PostgreSQL 11 (reference)

Important The integrated Apache Derby database is not suitable for live operation and should only be used for tests.

Compatible database systems: FirstSpirit is also operated successfully with other databases in different versions, e.g.:

  • IBM DB2
  • MariaDB
  • MySQL
  • Microsoft SQL Server
  • Oracle
  • PostgreSQL

A detailed list of known compatible database systems can be found here.

Not supported:

  • IBM DB2 <= 9.4

© 2005 - 2020 e-Spirit AG | All rights reserved. | FirstSpirit 2020-03 | Data privacy | Imprint | Contact us