Runtime cloud system requirements

The instructions for setting up a runtime cloud are for systems engineers with an intermediate level of experience configuring a wide array of operating system features such as NFS, Samba, networking, firewalls, and file systems.

A runtime cloud consists of multiple runtime cloud clusters that you install on multiple local machines. Boomi recommends that you install no more than 10 runtime cloud clusters in a runtime cloud. Boomi recommends that you install a minimum of three nodes per runtime cloud cluster. Installing three nodes per runtime cloud cluster allows the primary node to properly distribute the runtime workload across two secondary nodes without overloading the first secondary node.

caution

Antivirus programs that scan the installation folder of your runtimes, runtime clusters, or runtime clouds might conflict with their operation. For example, if the antivirus program attempts to access the files while your runtimes, runtime clusters, or runtime clouds are running, it can cause conflicts. Also, the antivirus program could cause permission issues by being seen as a different user. Therefore, disable the antivirus program from running against the basic runtime, runtime cluster, or runtime cloud installation folders during planned maintenance windows. Additionally, after running the antivirus program, check the quarantine folder for any valid files quarantined incorrectly.

Supported operating systems

Operating system	Version
Linux 32-bit	Red Hat Enterprise Linux 7 and later Suse Enterprise Linux Server 12 and later Any other Linux distribution that supports the Java 8 Runtime
Linux 64-bit	Any Linux distribution that supports the Java 8 or 11 Runtime
Windows 32-bit	All versions of Windows that support the Java 8 Runtime, from Windows Vista to the most recent version.*
Windows 64-bit	All versions of Windows that support the Java 8 or 11 Runtime, from Windows Vista to the most recent version. *

* The stability of private runtime clusters and runtime clouds can be unpredictable in Windows environments. This behavior is typically due to a communication disruption between runtime cluster Node(s) and the file system through the network file path due to the following:

File system backups
Virus scanning utilities
Automated patching of the file system

As such, Boomi recommends the Linux operating system in support of Production environments.

Unsupported operating systems

Boomi does not officially support installations on Unix operating systems. Because Unix is not officially tested or supported by Boomi, the Boomi Support team cannot troubleshoot or support any Unix-related issues.

Minimum hardware requirements

A single runtime, runtime cluster node, or runtime cloud cluster within a runtime cloud can run on hardware ranging from business-class workstations to dedicated servers.

Processor - 1.8 GHz or higher Pentium 4 (or equivalent)
Memory - 2 GB RAM (minimum 1 GB dedicated to runtime, runtime cluster node, or runtime cloud cluster)
Hard Disk - 50 MB for runtime and configuration, 10 GB for data archiving

Minimum hardware requirements for high volumes of data

The requirements for a single runtime, runtime cluster node, runtime cloud cluster node, or runtime cloud cluster within a runtime cloud that must process high volumes of data are:

Processor
- Dual 64-bit processors or higher
- More processors allow for increased, simultaneous process runs
Memory
- 4 GB of RAM (minimum 2 GB dedicated to the runtime, runtime cluster node, or runtime cloud cluster)
- More RAM allows for increased, simultaneous process runs
Hard Disk
- 100-200 GB of hard disk space
- Increase purging levels to minimize runtime, runtime cluster node, or runtime cloud cluster disk space

Minimum software requirements for Windows and Linux

Java (for Windows and Linux)
- Requires Java 8 or 11. Boomi recommends Java 11.
- Boomi internally tests each Java version prior to their release.
Java runtime (for Windows and Linux)

This is a Java application and requires Java 8 or 11 to run.
- For Java 8, Boomi supports the Oracle Java and Amazon Corretto OpenJDK. The installer automatically downloads a private copy of the Java 8 JDK for the runtime, runtime cluster, or runtime cloud's use.
- For Java 11, Boomi supports only the Amazon Corretto OpenJDK. When you install a new runtime and download the JDK, it automatically includes the Java 11 runtime.
Note: The runtime, runtime cluster, or runtime cloud Java 11 installer downloads a private copy of the JDK. You can continue to use Java 8 installer files previously downloaded on your local drive to install runtimes on Java 8. Depending on which version you install, the Java 8 JRE or the Java 11 JDK are in your runtimes’s or runtime clusters’s jre directory. The private JRE or JDK will not interfere with a shared JRE or JDK (one that you, not the installer, installed). It is not integrated into browsers and does not write registry entries.

Number of machines required

The minimum number of machines required for operation is two:

One shared file server
One runtime cluster node or runtime cloud cluster

The minimum number of machines required for full failover is four:

One shared file server
One backup shared file server
Two runtime cluster nodes or runtime cloud clusters

note

To prepare for failover, keep one runtime cluster offline but mirror the primary runtime cluster or the secondary one on a regular basis. For more information about backup and disaster recovery best practices, review the following resources in the Boomi Community:

Operating system requirements

All nodes in a runtime cluster, or runtime cloud clusters in a runtime cloud, must be running on the same operating system. For example, you cannot run one of the runtime cluster's nodes on Windows and another node on Linux.

Boomi recommends that all nodes in a runtime cluster, or runtime cloud clusters in a runtime cloud, use the same operating system architecture. For example, run all nodes on a Windows 32-bit or a Windows 64-bit machine.

Hardware requirements

You do not have to install each node in a runtime cluster, or runtime cloud cluster in a runtime cloud, on computers with the same hardware configuration. The machines can have different amounts of RAM, CPU types, and so on.

File system requirements

The primary requirement for running a runtime cluster or runtime cloud is that all nodes or runtime cloud clusters must use the same installation directory.

The primary use for clustering is to allow multiple machines to work together, which means that there is some form of a shared file system. Due to the implementation of the runtime cluster and runtime cloud support within the runtime, this file system must support file locking. Common examples of this are:

An NFS file system with NFS locking enabled (NLM support)

Note: NLM allows the client on host to lock the range of bytes or files, as required by Boomi runtime clusters, to ensure data consistency during simultaneous access across processes.
A Windows network share or drive

note

The file system must have the same operating system and architecture as all nodes in a runtime cluster, or runtime cloud clusters in a runtime cloud in an otherwise file locking issues may occur. Boomi recommends SMB or CIFS for Windows machines. Boomi recommends NFS for Linux machines.

Network recommendations

For best performance, the various machines in a runtime cluster or runtime cloud must have multicast (UDP) available between them. However, this is not a requirement, because you can configure the clustering protocol to work in a unicast-only (TCP) environment. See more information about network configuration for runtime clusters and runtime clouds.

Java requirements

If you are installing a runtime cloud cluster or a runtime cluster node that uses forked execution, you must install a JDK or use the Boomi-provided Java from installation. The current supported versions for Linux or Windows are:
- Oracle Java SE Development Kit 8u382
- Amazon Coretto Open Java Development Kit 11.0.20.8.1
Boomi recommends that all machines in the runtime cluster or runtime cloud have the same version of Java installed. Also, Java must be in the same directory on each machine (such as C:/Program Files/Java/jre8 for Windows or /usr/local/java for Linux).
Java 11 installations and upgrades automatically provide the full JDK complete with the JRE. If you use runtime clusters or Clouds with forked executions and manage your own Java 8 version, keep the following in mind:
- If you do not want to upgrade to Java 11, you do not need to install a separate JDK to use forked executions, as the Boomi-supplied JDK contains them.
- If you do not want to upgrade to Java 11 and choose to use a version of Java not provided by Boomi, ensure that you download the JDK and not the JRE.

Firewall rules

The nodes need to communicate with each other to cluster successfully.

If you are using multicast defaults, open port 45588.
If you are using unicast defaults, open port 7800.

Host setup

Ensure that the host names of the machines resolve to valid IP addresses, not to the localhost adapter, which is 127.0.0.1.

Enable Clouds

Ensure that you enable clouds. When you click the Manage menu a Clouds option appears if they are enabled.

If your system meets all of these requirements, you can download the runtime cloud cluster installer.