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 dnsmasq

sudo systemctl disable dnsmasq

Java¶

A Java Runtime Environment equal or higher than Java version 11 is installed on the server. The JAVA_HOME environment variable is set accordingly.

Frozen Master Convert¶

Download Frozen Master Convert 2024-1 or later.

When installing FM-Convert for DPF you have to do the following adjustments:

Install MongoDB, SEAL NATS and SEAL Logrotate first.

Stop the services mongodb and seal-nats.

sudo systemctl stop mongodb
sudo systemctl stop seal-nats

Edit sealsetup.sh, set OS_USER and OS_GROUP to seal.
```
export OS_USER="seal"
export OS_GROUP="seal"
```
Caution - FM Convert 2023-2

When using FM Convert 2023-2 make sure, that sealsetup.h is prepared for the Convert bundle:
```
#export BUNDLE="Complete"
export BUNDLE="Convert"
```
Hint - DPF environment for user seal

This will create the DPF environment for the seal user. Use su - seal to enter and exit to leave it.
Activate Apache Web Server.
After the installation is finished, start the Apache Web server.

Start the services mongodb and seal-nats.

sudo systemctl start mongodb
sudo systemctl start seal-nats

MongoDB¶

MongoDB has to be installed prior to the installation of Digital Process Factory. We recommend to use MongoDB as of version 7.0.0. A replica set has to be defined. For how to install and configure MongoDB, refer to the SEAL-specific MongoDB documentation.

A replica set has to be configured in MongoDB and the database initiatlized. For more information refer to Configuring a Shared Replica Set and Initializing the Database.

Hint - cluster installation

In case of a cluster installation, we recommend installing and configuring MongoDB in a cluster before installing Digital Process Factory. For more information about the MongoDB installation, refer to the SEAL-specific MongoDB documentation.

SEAL NATS¶

The SEAL NATS message broker as of version 2.9.2 has to be installed on the Output Engine server before installing Digital Process Factory. For more information about the SEAL NATS installation, refer to the SEAL NATS documentation.

SEAL Logrotate (optional)¶

Logrotate cleans up outdated SEAL Systems-specific log files to free up storage space and prevent performance and memory issues. You can run the Digital Process Factory without Logrotate, but we strongly recommend to install it. When running a cluster, this should be done on each server. For more information, refer to 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.

Next Step¶

Continue with: Installation