Controller Installer
Installation Guidelines
Tomcat Directory
Specify the full path to your Tomcat installation directory. The installer will deploy the Universal Controller WAR file to this location.
Linux: /opt/tomcat (use), /usr/local/tomcat (use), or /usr/share/tomcat10 (use)
Windows: C:\Program Files\Apache Software Foundation\Tomcat 10.1 (use)
Note: Ensure Tomcat is stopped before running the installation.
Controller File
The Universal Controller WAR file name. Use the exact filename including version and build number.
Latest version: universal-controller-7.9.0.0-build.108.war (use)
Older versions: universal-controller-7.2.1.3-build.2.war (use)
Note: The WAR file must be present in the same directory as the installation script.
Database Configuration
Select your database type first - the Database URL will be automatically populated. Supported databases include MySQL, PostgreSQL, Oracle, and SQL Server.
Database Name: Typically uc or uac
Database User: A dedicated user with full privileges on the Controller database
Note: Ensure the database exists and the user has appropriate permissions before installation.
Database Password
For security, enter <dbpass> in the command. You'll be prompted to enter the actual password during installation.
Security Best Practice: Never include actual passwords in command-line arguments or scripts.
JVM Memory (setenv)
Creates a setenv.sh (Linux) or setenv.bat (Windows) file in the Tomcat bin/ directory to configure JVM memory settings.
The file sets CATALINA_OPTS with -Xms (initial heap) and -Xmx (maximum heap) values.
Default: -Xms512m -Xmx2048m
Note: Adjust these values based on your environment. For production, refer to the Sizing Calculator for recommended JVM heap sizes.
Port Configuration
The default port is 8080. Change this only if you need the Controller to run on a different port.
Note: Ensure the selected port is not in use by another application.