2.1.5 Multi Tomcat installation for Windows

This guide explains how to install and configure multiple Tomcat instances for Quilliup on a Windows server.

Multi-instance setup uses the standard Quilliup installation for the first Tomcat instance. All additional instances must be configured manually.

⚠️ Recommendation: Before starting, create a system snapshot to ensure you can restore the environment if required.

 

1. Standard Installation

Perform a standard Quilliup installation, either:

• Manually

• By following the installation guide: Quilliup Windows Installation Guide

2. Tomcat service

During installation, a Tomcat service is registered in Windows Services.

• The service name format is: Apache Tomcat X quilliup (where X = Tomcat version number) .

• Service Management:

  • Stop the service before making any configuration changes.

  • Restart the service once changes are complete.

Destination folder: <Application Folder>\quilliup\bin

Open CMD and run:

1. Stop quilliup service:  net stop quilliup
2. Start quilliup service: net start quilliup

If the service does not respond, open Windows Services and restart the service manually Apache Tomcat X quilliup

 

3. Duplicating an Existing Tomcat Instance

To set up an additional Tomcat instance:

1. Stop the Quilliup service from Task Manager.
   
   
    

2. To create an additional Tomcat instance, duplicate the existing Quilliup installation:

(1) Navigate to the installation directory (default: C:\Program Files\)

(2) Copy the existing quilliup folder (created during the standard installation, usually located at C:\Program Files\quilliup).

(3) Paste the copied folder into the same directory and rename it to the desired instance name.
* Example: C:\Program Files\quilliup_prod

(4) Before copying, ensure that unnecessary data is removed from the source folder:

• Executions: Delete all contents under: quilliup\AppData\executions

• Logs: Delete all log files under: quilliup\logs

4. Define New Tomcat Instance Ports

Each Tomcat instance requires unique port numbers. Update the configuration as follows:

1. Open the file:..\quilliup_prod\conf\server.xml

2. Replace all occurrences of the default HTTP port (8080) with a new port, e.g., 7070.
   

3. Update the following additional ports:

   • Shutdown port: change from 8005 → 8006
     
     
      

   • AJP port: change from 8009 → 8008
     

 

5. Define New Tomcat Instance Properties

1. Open the file: ..\quilliup_prod\webapps\ROOT\WEB-INF\classes\config.properties

2. Update the following parameters:

   • Change the port from 8080 to 7070 (or the port defined in Step 4).

   • Update all file system paths from: ..\quilliup to ..\quilliup_prod

This ensures the new instance references the correct installation folder.

6. Define New Tomcat Instance Repository Database

Starting from Quilliup version 2.6.1.9.2 and above, repository DB connection details are managed in the connection.properties file.

1. Open the file: 
   ..\quilliup_prod\webapps\ROOT\WEB-INF\classes\connection.properties

2. Configure the repository:

   • Uncomment the relevant DB details (remove # from the beginning of required rows).

   • Comment out all unused repositories (add # to irrelevant rows).

   • Enter correct connection details for your repository DB.

For example - MySQL DB repository details:

⚠️ Password Encryption (Recommended):

• If encrypting the DB password, first back it up in a secure password manager.

• Run the utility: ..\quilliup_prod\webapps\ROOT\utils\quilliup Encrypt AES.jar

• Copy the encrypted string from the Result field and paste it into the db.password field in connection.properties.

• Save changes.

7. Create Windows Service for the New Instance

To run the new Quilliup instance as a Windows service:

1. Open Command Prompt as Administrator.

2. Navigate to the bin directory of the new instance:
   cd "C:\Program Files\quilliup_prod\bin"

3. Install the service by running: service.bat install quilliup_prod
   
   
    

4. Open Windows services, edit the startup type to Automatic and start the service
   
   Important: Ensure you are logged in with a Windows user account that has READ + WRITE permissions for all Quilliup directories. For example:

   
   
    

That's it!