Installation and Handling

The following chapters describe the basic conditions for installing and operating Fabasoft Folio.

Fabasoft Reference Architecture

The Fabasoft reference architecture shows the exemplified infrastructure of a web based Fabasoft Folio installation:

Terminology

The terms of the reference architecture are explained in this chapter.

• Client
  Device or PC with graphical user interface.
• Client firewall
  The client firewall is designed to protect the client LAN from the corporate network.
• Corporate network
  A corporate network contains the whole network of a company.
• Connection point
  The connection point represents the handover point for the application and the location for service level measurements.
• Server firewall
  The server firewall is designed to protect the data center from the connection point.
• Load balancer, content switch
  The load balancer distributes requests from the user to the web server farm and thus to the Fabasoft Folio Web Services.
• DMZ firewall
  A DMZ firewall separates the portal server farm from data center.
• Portal server farm
  A portal server farm handles incoming HTTP requests from the Internet.
• Internet firewall
  An Internet firewall separates the portal server farm from the Internet.
• AT servers (Automated Tasks)
  AT servers run Fabasoft Folio AT Services for executing automated tasks in the context of a user without requiring user interaction.
• Mail server
  A mail server is responsible for sending e-mails in the background without any user interaction. On the mail server a SMTP mail server third-party product is installed.
• Web server farm
  The Web server farm consists of servers running Fabasoft Folio Web Services (business logic for applications and generation of on-screen representation).
• Conversion server farm
  The conversion server farm consists of servers running Fabasoft Folio Conversion Services (format conversion of documents).
• Frontend LAN
  The frontend LAN connects the load balancer to the web server farm.
• Backend LAN
  The backend LAN connects the web server with the backend server clusters and the conversion servers, plus the backend server cluster with the database server clusters. The backend LAN also connects the servers for basic services with the other servers.  
• Backend server cluster
  The backend server cluster manages the persistence of business objects using Fabasoft Folio COO Services for structured data (in relational databases) and Fabasoft Folio MMC Services for unstructured data (documents, graphics, multimedia files in the file system).
• Database server cluster
  Relational database systems running on the database server cluster stores structured data in a database for each Fabasoft Folio COO Service.
• Storage area network (SAN)
  The SAN connects the backend cluster (saving documents in the file system) and the database cluster (saving database files) with the storage system.
• Storage system
  The (enterprise) storage system represents a highly available array of hard disks (capacity in the terabyte range).
• Tape library
  The tape library (tape robot) makes use of fast and reliable tape drives for saving data.

Fabasoft Folio Tenants

Fabasoft Folio Tenants allow a logical division of a Fabasoft Folio Domain, for example, to separate individual companies of a corporate group.

• With tenant-specific configurations, the behavior of the individual tenants can be customized.
• Tenants can be considered in the Fabasoft Folio permission system (ACLs). Thus, objects can be easily protected against access by users who only have roles for another tenant. However, it is also possible to grant a user access to objects of different tenants.  

In order to use the functionality of Fabasoft Folio Tenants a multi-tenant license is required.

Conditions of Use

• All statements contained in this software product information concerning the intended use and conditions of operation of the program are understood as information only on principle. To ensure and guarantee the intended use and conditions of operation in everyday use of the program, expert training by specially qualified staff is recommended in any case.  
• Performance and reaction time of Fabasoft software products significantly depend on the used infrastructure. For layout, configuration and sizing of the infrastructure we refer to the information, recommendations and specifications of the particular manufacturers.  
• Without a suitable infrastructure for online backups a consistent backup of Fabasoft Folio resources is only possible within dedicated backup time slots (planned downtime). In both cases functionality for backup, restore and disaster recovery has to be implemented according to a separately defined concept.  
• This program is intended for customary commercial use. This does not include usage that demands special requirements (like controlling of vehicles, machines and facilities, real-time applications).

Supported Platforms (Microsoft Windows Environment)

The following third-party products are supported in a Microsoft Windows environment.

Fabasoft Folio Management

If Fabasoft Folio Services have been installed on Microsoft Windows, for administering the Fabasoft Folio Services by means of Fabasoft Folio Server Management the following third-party products are supported.

Fabasoft Folio Backend Services

In General

• The Fabasoft Folio Backend Services are supported and tested with the reference system environments for database services according to the configurations listed below.
• Cluster operation of the system environments supported by Fabasoft Folio Backend Services is supported.
• When using an Oracle Database: Oracle Database can also be operated on system environments (operating systems) that do not correspond to the reference system environments listed below, if this is supported by Oracle.

Fabasoft Folio Backend Services

Database Services

Fabasoft Folio Web Services

Fabasoft Folio Conversion Services

The prerequisites for Fabasoft Folio Web Services as well as the following additional requirements have to be considered for the operation of a Fabasoft Folio Web Service as a Fabasoft Folio Conversion Service.

Fabasoft Folio AT Services

Fabasoft iArchiveLink Services

Fabasoft iArchive

Note: For the integration for Dell EMC ECS, the Centera SDK Version 3.4 is used.

Fabasoft Folio Web Client

Limits

• A maximum of 10000 entries should be stored in an object list.
• The import of files in the attribute editor is carried out in a single transaction (also if several objects are selected and contents are sequentially imported in these objects via „Edit Properties“). The overall size of the imported data in Base64 coding has to be smaller than the configured maximum size of the request limit.

Fabasoft Integration for Mindbreeze

Please note the specifications of Mindbreeze regarding system requirements.

Note:

• For the integration, the Mindbreeze SDK 2024 is used. According to the Mindbreeze software product information, versions can be used, that are supported by this SDK.
• The kernel-based integration for Mindbreeze is no longer supported.

Fabasoft Integration for Fabasoft app.telemetry

Please note the specifications of Fabasoft app.telemetry regarding system requirements.

Note: For the integration, the Fabasoft app.telemetry SDK 2025 is used. According to the Fabasoft app.telemetry software product information, Fabasoft app.telemetry versions can be used, that are supported by this SDK.

Support of Full-Text Search

Fabasoft E-Services

Fabasoft E-Services support following portal server system environments:

Additionally to the listed reference system environments portal servers are supported that support JSR 168 compliant portlets as well as the Java servlet 2.4 specification (or higher if backwards compatible to version 2.4).

Fabasoft E-Services support following client system environments:

Supported Platforms (Linux Environment)

The following third-party products are supported in a Linux environment.

Fabasoft Folio Management

Fabasoft Folio Web Management

If Fabasoft Folio Services have been installed on Linux, for administering the Fabasoft Folio Services by means of Fabasoft Folio Web Management the following third-party products are supported.

Fabasoft Folio Server Management

If Fabasoft Folio Services have been installed on Linux, for administering the Fabasoft Folio Services by means of Fabasoft Folio Server Management the following third-party products are supported.

Fabasoft Folio Backend Services

In General

• The Fabasoft Folio Backend Services are supported and tested with the reference system environments for database services according to the configurations listed below.
• When using an Oracle database: Oracle Database can also be operated on system environments (operating systems) that do not correspond to the reference system environments listed below, if this is supported by Oracle.

Fabasoft Folio Backend Services

Database Services

Fabasoft Folio Web Services

Fabasoft Folio Conversion Services

The prerequisites for Fabasoft Folio Web Services as well as the following additional requirements have to be considered for the operation of a Fabasoft Folio Web Service as a Fabasoft Folio Conversion Service.

Fabasoft Folio AT Services

Fabasoft iArchiveLink Services

Fabasoft iArchive

Note: For the integration for Dell EMC ECS, the Centera SDK Version 3.4 is used.

Fabasoft Folio Web Client

The following optional third-party products are supported.

Limits

• A maximum of 10000 entries should be stored in an object list.
• The import of files in the attribute editor is carried out in a single transaction (also if several objects are selected and contents are sequentially imported in these objects via „Edit Properties“). The overall size of the imported data in Base64 coding has to be smaller than the configured maximum size of the request limit.

Fabasoft Integration for Mindbreeze

Please note the specifications of Mindbreeze regarding system requirements.

Note:

• For the integration, the Mindbreeze SDK 2024 is used. According to the Mindbreeze software product information, versions can be used, that are supported by this SDK.
• The kernel-based integration for Mindbreeze is no longer supported.

Fabasoft Integration for Fabasoft app.telemetry

Note: For the integration, the Fabasoft app.telemetry SDK 2025 is used. According to the Fabasoft app.telemetry software product information, Fabasoft app.telemetry versions can be used, that are supported by this SDK.

Support of Full-Text Search

Fabasoft E-Services

Fabasoft E-Services support following portal server system environments:

Additionally to the listed reference system environments portal server are supported that support JSR 168 compliant portlets as well as the Java servlet 2.4 specification (or higher if backwards compatible to version 2.4).

Fabasoft E-Services support following client system environments:

Supported Platforms (Apple macOS Environment)

The following third-party products are supported in an Apple macOS environment.

Fabasoft Folio Web Client

The following optional third-party products are supported.

Supported Platforms (Mobile Devices)

The following third-party products are supported on mobile devices.

Fabasoft Folio Web Client on Mobile Devices

Following use cases are supported on the mentioned mobile devices:

• Read and edit meta data of objects
• Read contents

Fabasoft App

The Fabasoft App 8.11.0 (Android) or 8.11.0 (iOS) can be used with the Folio versions from 2023 to 2025. The full functionality of the app is available with the current Folio version.

Additional Conditions

• The minimum hardware and software requirements for any future versions of this product may differ from the requirements of this version. 
• A certain version of a third-party product integrated into any Fabasoft software product is supported by Fabasoft as long as the software product itself is supported by the third-party itself. For instance, a particular version of an integrated Microsoft software product is only supported by Fabasoft until the date on which the Microsoft “Extended Support Phase” for this product version ends.
• Third-party products that are required or supported by Fabasoft products, proper licensing and installation of them, necessary tests for product release as well as corresponding manufacturer support are not included in the scope of supply and services and therefore they are not subject to warranty of Fabasoft regarding functionality, mode of operation or features. Fabasoft is not responsible for errors or malfunction, which are caused by third-party software products and/or products that are not included in the scope of supply and services.
• Fabasoft software products are only supported and tested on the mentioned reference system environments. In addition to the third-party product editions listed in the reference system environments the editions listed in chapter “Supported Editions of Third-Party Products” are supported but not tested.
• The values for CPU, available RAM and free disk space are minimum requirements for a demo installation.
• Fabasoft Folio Services are supported and tested in virtual environments.
• The installation of Fabasoft Folio Services of different versions on a single computer is not supported.
• A mixed environment of different versions of Fabasoft Folio Services and Fabasoft Folio client components is not supported.
• A mixed environment of Fabasoft Folio Services on operating systems from different vendors (Microsoft Windows, Red Hat Enterprise Linux or AlmaLinux) is not supported.
  Fabasoft Folio Conversion Services are an exception. These have to run on Microsoft Windows or Linux corresponding to the document formats used and the third-party products necessary for it.
• Fabasoft Folio defines an SELinux policy (for RHEL and AlmaLinux) that provides access controls on operating system resources for Fabasoft Folio Services. The rules defined for a standard installation may need to be extended accordingly for project-specific use cases and configurations.
• When using Fabasoft Folio Services (x64), OpenJDK has to be installed in a 64 bit version, too.
• A conversion from PDF to PDF/A generates PDF/A-3b compatible documents.
• A conversion to PDF/A with Microsoft Office or LibreOffice Writer generates PDF/A compatible documents corresponding to the third-party product.
• A conversion with Adobe Acrobat can either only generate PDF documents or only generate PDF/A documents.
• Only watched folders are supported for the conversion with Adobe Acrobat.
• Fabasoft DTS Gateway version 4.15 is supported.
• Opening documents via Citrix Virtual Apps and Desktops 7 1903 is supported as long as all applications are running on the server (incl. Fabasoft Folio Client, Explorer, web browser etc.) or all applications are running on the client.
• Editing of Microsoft Office documents with LibreOffice and editing LibreOffice documents with Microsoft Office is not supported.
• The integration in Microsoft Office (buttons) is only available under Microsoft Windows.
• The contact synchronization requires Microsoft Outlook 2021 or 2024.
• The drag and drop functionality is only partially available for Microsoft Edge, Mozilla Firefox, Google Chrome and Apple Safari.
• The copy and paste functionality is not available in Ubuntu when using SMB shares.
• Video and audio files are not playable on all supported web browsers depending on the format.
• The BPMN editor provides only a read-only mode on mobile devices.
• The Fabasoft Folio client components are only supported on operating systems for which they were developed. If a client component is provided for multiple operating systems, the functionality may vary depending on the operating system.

Supported Editions of Third-Party Products

Following editions of third-party products are supported. Explicitly tested are only those editions that are listed in the reference system environments.

• The third-party product Microsoft Windows Server 2019 is supported in the following editions: Essentials and Standard. The Datacenter edition is only supported in projects (the following values for CPU, available RAM and free disk space do not apply for Datacenter Edition).
• The third-party product Microsoft Windows Server 2022 is supported in the following editions: Essentials and Standard. The Datacenter edition is only supported in projects (the following values for CPU, available RAM and free disk space do not apply for Datacenter Edition).
• The third-party product Microsoft SQL Server 2019 is supported in the following editions: Standard and Enterprise.
• The third-party product Microsoft SQL Server 2022 is supported in the following editions: Standard and Enterprise.
• The third-party product Microsoft Windows 10 is supported in the following editions: Pro and Enterprise.
• The third-party product Microsoft Windows 11 is supported in the following editions: Pro and Enterprise.

Authentication Possibilities

Microsoft Windows System Environment

Following authentication possibilities are provided for Fabasoft Folio Web Services:

• Kerberos (Microsoft Active Directory)
• LDAP
• Project-specific authentication (REMOTE_USER server variable)
  Note: Use cases that require password verification are not supported with project-specific authentication (e.g. electronic signature).
• SAML 2.0
  When using this authentication method third-party products have to transfer the cookies for each request to the web server. Therefore, the access via WebDAV is not supported. This authentication method implements the “SAML Web Browser SSO Profile”. “SAML AuthnRequest responses” must be signed.
  The following SAML identity providers are supported:
  • Shibboleth IdP 5.1.2 (http://shibboleth.net/: new window)
• OAuth 2.0 Draft 25, Bearer Tokens Draft 18
  “Refresh Tokens” are not supported.

Linux System Environment

Following authentication possibilities are provided for Fabasoft Folio Web Services:

• Kerberos (Microsoft Active Directory or MIT Key Distribution Center)
• LDAP
• Project-specific authentication (REMOTE_USER server variable)
  Note: Use cases that require password verification are not supported with project-specific authentication (e.g. electronic signature).
• SAML 2.0
  When using this authentication method third-party products have to transfer the cookies for each request to the web server. Therefore, the access via WebDAV is not supported. This authentication method implements the “SAML Web Browser SSO Profile”. “SAML AuthnRequest responses” must be signed.
  The following SAML identity providers are supported:
  • Shibboleth IdP 5.1.2 (http://shibboleth.net/: new window)
• OAuth 2.0 Draft 25, Bearer Tokens Draft 18
  “Refresh Tokens” are not supported.

Minimum Requirements

Fabasoft Folio Services

Fabasoft Clients

Limits

Server Limits

• A Fabasoft Folio Domain or tenant can consist of a maximum of 255 Fabasoft Folio COO Stores.
• A Fabasoft Folio Backend Service can run a maximum of 10000 client connections at the same time.
• A maximum of 16 million objects can be created in a Fabasoft Folio Store.
• A maximum of 65534 tenants can be created in a Fabasoft Folio Domain.
• A maximum of 120 worker-threads can be created in a Fabasoft Folio Backend Service.

The specified limits can be reduced by operating system limitations.

Fabasoft Folio Kernel Limits

• A Fabasoft Folio Kernel can run a maximum of 1000 service connections at the same time.
• A Fabasoft Folio Kernel can process a maximum of 1000 open connections.
• In one process a maximum of one Fabasoft Folio Kernel can run.
• A Fabasoft Folio Kernel can run a maximum of 1024 threads.
• A Fabasoft Folio Kernel can connect directly to a maximum of one Fabasoft Folio Domain.

The specified limits can be reduced by operating system limitations.

Limits

• A maximum of 10000 entries should be stored in an object list.
• A maximum of 10000 hits can be displayed at once in the Fabasoft Folio search GUI.

Updates

An existing installation of Fabasoft Folio 2013 or higher is required to perform an update.

Application Performance Management

With Fabasoft app.telemetry a powerful tool for effective application service level management is provided.

Fabasoft app.telemetry collects detailed performance data from data flows and response time behavior (performance) for distributed software applications and facilitates the analysis of these data in the context of the respective operating steps (use cases). Fabasoft app.telemetry reproduces a user enquiry through servers and locations and collects detailed information about each involved application (service). Such information is, e.g., the execution time, the retention time within a service or item (query) and the duration of a database query. Thereby Fabasoft app.telemetry details the respective system path. This enables the service team to immediately identify critical points in terms of time.

Fabasoft app.telemetry also provides users with the possibility to report unsatisfactory system queries. The most recent queries are then automatically summarized and made available for immediate analysis.

Fabasoft app.telemetry raises the level of corporate efficiency through immediate identification of bottlenecks in the IT systems. Particularly complex and service-oriented architectures profit from the Fabasoft app.telemetry targeted identification of performance and resource bottlenecks, as they can be rapidly isolated and repaired.

The software also provides a complete overview of all performed queries. Data such as the query execution time are prepared jointly with application specific information and are available immediately for an analysis of the overall situation.

Fabasoft app.telemetry also performs classic system management functions. The software monitors cluster resources or services as well as observes SNMP values (Simple Network Management Protocol), performance data or availability checks.

Fabasoft app.telemetry SDK

Fabasoft app.telemetry SDK (Software Development Kit) provides a simple and quick-to-use interface for applications. It enables software developers to easily integrate their applications into the Fabasoft app.telemetry.