Installation Command Generator

Supported Versions

Universal Controller requires specific versions of Java and Tomcat:

Java: Java 17 or Java 21 (headless recommended)

Tomcat: Tomcat 10.x

Operating System

Select your target operating system to generate appropriate installation commands.

AWS: Amazon Linux 2023 with yum package manager

RHEL/CentOS: Red Hat Enterprise Linux or CentOS with yum

Ubuntu/Debian: Ubuntu or Debian-based systems with apt-get

Windows: Displays download links for manual installation

Java Installation

Java Runtime Environment (JRE) is required for Universal Controller.

Linux: Commands will use package managers to install OpenJDK or Amazon Corretto

Windows: Download links provided for both Oracle JRE and OpenJDK

Oracle JRE: Oracle Downloads

OpenJDK: Red Hat OpenJDK

Tomcat Installation

Apache Tomcat 10 is required as the application server.

Package Manager: Installs via yum/apt (recommended for Linux)

Manual Download: Downloads tar.gz from Apache archive and extracts to /opt/tomcat

Note: Manual installation provides more control over the installation directory and version.

JVM Memory (setenv)

Creates a setenv.sh (Linux) or setenv.bat (Windows) file in the Tomcat bin/ directory to configure JVM memory settings via CATALINA_OPTS.

Default: -Xms512m -Xmx2048m

Note: Adjust these values based on your environment. For production, refer to the Sizing Calculator for recommended JVM heap sizes.

systemd Service File

Creates a systemd unit file at /etc/systemd/system/tomcat.service to manage Tomcat as a system service (start, stop, restart, enable on boot).

When to use: Only needed for manual (tar.gz) Tomcat installations. Package manager installs already include systemd service files.

JAVA_HOME: Optional. Leave blank to get a commented-out placeholder in the unit file; fill in the path to activate it.

Note: After copying the unit file, run systemctl daemon-reload to register it, then systemctl enable tomcat to enable automatic startup on boot.

Database

Universal Controller requires a database backend. Supported databases include:

• MySQL
• MariaDB
• PostgreSQL
• Oracle
• SQL Server

Important: Refer to the Stonebranch Database Installation Guide for detailed setup instructions and configuration requirements.

Agent Prerequisites

Additional system libraries required for Universal Agent installation.

AWS/Amazon Linux: Installs libxcrypt-compat library

Note: These prerequisites must be installed before installing the Universal Agent.

Installation Method

The generated script includes:

• Installation commands for selected components

• Service start and enable commands (Linux)

• Verification commands to check installations

Note: Review the generated script before execution and ensure you have appropriate permissions.