Requirements¶
Server Requirements¶
User and Privileges¶
For installing Digital Process Factory, administrator privileges are required.
No DNS Server¶
-
No DNS server is active on the server.
Hint - Consul DNS
In an on-premise installation, the configuration of Digital Output Factory is kept in a Consul key value store. In a cloud environment, the container orchestration system is used for this. Consul provides its own DNS server.
-
On RHEL, disable the DNSmasq service with:
sudo systemctl stop dnsmasqsudo systemctl disable dnsmasq
Java¶
A Java Runtime Environment equal or higher than Java version 21 is installed on the server. The JAVA_HOME environment variable is set accordingly.
Install Java and set JAVA_HOME for all users:
-
SLES 15 SP7:
sudo zypper install -y java-21-openjdkecho "setenv JAVA_HOME /usr/lib64/jvm/java-21-openjdk-21" | sudo tee /etc/profile.d/seal.cshecho "export JAVA_HOME=/usr/lib64/jvm/java-21-openjdk-21" | sudo tee /etc/profile.d/seal.sh -
RHEL 9 and 10:
sudo dnf install -y java-21-openjdkIf an older Java version is active, select Java 21:
sudo alternatives --config javaecho "setenv JAVA_HOME /etc/alternatives/jre" | sudo tee /etc/profile.d/seal.cshecho "export JAVA_HOME=/etc/alternatives/jre" | sudo tee /etc/profile.d/seal.sh
Log off and on again, so that JAVA_HOME is set. A new shell is not sufficient.
User seal¶
Before installing Frozen Master Convert, create the user seal with primary group users and a login shell. The DPF services run as this user, and the DPF environment is set up for it.
sudo useradd -m -d /opt/seal -s /bin/csh -g users seal
Frozen Master Convert¶
Before installing Frozen Master Convert, install the following operating system packages as root. Frozen Master Convert uses the Apache Web Server of the operating system, httpd.
-
SLES 15 SP7:
sudo zypper install -y tcsh libapr1 apache2 libgthread-2_0-0 apache2-utils perl-Archive-Zip -
RHEL 9 and 10:
sudo dnf install -y tcsh apr-util httpd mod_ssl dos2unix openssl libpqOn RHEL 9, also install
mod_jk:sudo dnf install -y mod_jk
Download and install Frozen Master Convert 2026-1 from the SEAL Systems delivery platform:
- Download in a Web browser: Frozen Master Convert 2026-1
-
WebDAV path:
https://delivery.sealsystems.de/remote.php/webdav/FM%20Linux/Convert/convert-2026-1/ -
Install Frozen Master as an administrator with
sudoin a normal shell.sudodoes not pass onJAVA_HOME, so specify it in the call:-
SLES 15 SP7:
sudo JAVA_HOME=/usr/lib64/jvm/java-21-openjdk-21 sh sealsetup.sh -
RHEL 9:
sudo JAVA_HOME=/etc/alternatives/jre sh sealsetup.sh
-
-
In the component selection, select the following components:
- Apache Web-Server
- DPF
- DPF Java WorkingUnit
- DPF4Convert
-
In the ELK service selection, select
seal-dpf-filebeatif you want to forward the log files of the DPF services and the accounting data to Elastic Stack. For more information, refer to Configure SEAL Elastic Stack.
Install MongoDB, SEAL NATS, and SEAL Logrotate only after Frozen Master Convert. At the end of its installation, Frozen Master Convert makes seal the owner of all files below /opt/seal. A MongoDB installed before then can no longer read its data in /opt/seal/data/seal-mongodb and does not start.
MongoDB¶
Install the SEAL-specific MongoDB before installing Digital Process Factory. We recommend MongoDB 8.0.4 or higher. Configure a replica set and initialize the database. For more information refer to Configuring SEAL MongoDB.
Hint - cluster installation
In a cluster installation, install and configure MongoDB as a cluster before installing Digital Process Factory.
SEAL NATS¶
The SEAL NATS message broker as of version 2.9.2 has to be installed on the DPF server before installing Digital Process Factory. For more information about the SEAL NATS installation, refer to the SEAL NATS documentation.
SEAL Logrotate (Optional)¶
SEAL Logrotate cleans up outdated log files of the DPF services to free up storage space and prevent performance and memory issues. You can run Digital Process Factory without Logrotate, but we strongly recommend to install it. When running a cluster, install it on each server. For more information, refer to the SEAL Logrotate documentation.
Elastic Stack (Optional)¶
The DPF log, statistics, audit and accounting data is administrated and visualized by means of Elastic Stack (Elasticsearch and Kibana). The installation is optional. For more information, refer to SEAL Elastic Stack documentation.
As of DPF 4.3.0, Elastic Stack 7 is no longer supported. The configuration files for Filebeat, Kibana and Elasticsearch ship with Digital Process Factory. For more information, refer to Configure SEAL Elastic Stack.
Next Step¶
Continue with: Installation