Configure Multiple Tomcat Deployments

Robi AI requires two additional Tomcat deployments alongside your existing Universal Controller deployment: one for the AI Service and one for the AI MCP Server. Just as the Controller runs as a Tomcat application, both the AI Service and the AI MCP Server must each run in their own Tomcat instance.

The standard approach for running multiple Tomcat instances from a single Tomcat installation is to use separate CATALINA_BASE directories, one per instance, while sharing a single CATALINA_HOME (the Tomcat binaries). Each CATALINA_BASE directory contains its own conf, logs, webapps, work, and temp folders.

For detailed instructions on this approach, refer to the official Tomcat documentation:

• Tomcat Introduction
• Tomcat Setup
• Tomcat Configuration Reference

For more advanced information on running multiple Tomcat instances, see RUNNING.txt

Port Layout

Each Tomcat instance must use unique port numbers to avoid conflicts. We recommend using the following ports for each service:

Component	HTTP Port	Shutdown Port
Universal Controller	8080	8005
AI Service	8081	8015
AI MCP Server	8082	8025

Configure the HTTP connector port and server shutdown port for each instance in the instance's conf/server.xml.

info

Each Tomcat instance also includes an AJP connector by default. If you are not using a reverse proxy that requires AJP, you may disable the AJP connector in server.xml for each instance to avoid port conflicts.

Once your Tomcat instances are in place, proceed to set up the AI Service.