quilliup multi Tomcat installation tutorial (Windows)

Welcome to quilliup multi Tomcat installation tutorial for Windows

This guide will introduce you to the quilliup multi Tomcat instances install instructions for Windows server.

Multi-tomcats instances installation process is made by the standard installation process for the first instance and by manual configurations for the other instances

1.standard quilliup installation

Install quilliup using the installation guide in the following link: https://quilliup.zendesk.com/hc/en-us/articles/207578779-Installation-guide-Windows-

2.License key

Copy the quilliupLicense.xml file to the C:\ folder or the folder of the user who is running the tomcat win service.

3.Command line execution

Verify that the file run_qp.exe exists and that you have execution permission on the following folder: Application Folder\webapps\ROOT\utils.

4.Tomcat service

As part of the installation, tomcat will be installed as windows service. The name of windows service will be Apache Tomcat X quilliup, as X is the Tomcat version number.

If you are changing the default configuration, stop the service prior to your changes, and don’t forget to start the service after you finish performing the changes.

Destination folder: Application Folder\quilliup\bin.

Stop quilliup service by running net stop quilliup

Start quilliup service by running net start quilliup.

In case the service does not respond, restart the service directly from the windows services. You will find the service "Apache Tomcat 7.0 quilliup" on the services list.

5.Duplicate the existing tomcat instance

Create new instance's folder:

Under location C:\Program Files\ create new folder with the name of your instance. For example: quilliup_prod

Copy existing instance (standard installation):

Copy the existing tomcat instance quilliup folder which installed using the standard installation process (normally under c:\program files\quilliup) to the new instance's folder created in the previous step

6.Define the new tomcat instance ports

Tomcat uses port number for authenticate with the application web server therefore, there is need to define new port (7070) for the new instance's, HTTP port. Open server.xml file located under C:\Program Files\ quilliup_prod \conf and replace all port numbers from 8080 to 7070.

Also, change the shutdown port from 8005 to 8006

and the AJP port from 8009 to 8008

7.Define the new tomcat instance properties

Open the config.properties file located at: Application Folder\webapps\ROOT\WEB-INF\classes

Port number:

Chnge the port number from 8080 to 7070

Installation folder:

Change the installation folder from C:\Program Files\quilliup to C:\Program Files\quilliup_prod

And from C:\Program Files\quilliup to C:\Program Files\quilliup_prod

8.Define the new tomcat instance repository

Tomcat use DB as a repository to store all its object's metadata and there is need to define the new DB repository for the new instance.

For quilliup versions up to 2.6.1.9.1 (include):

 Open the data-jpa-config.xml file, located under C:\Program Files\ quilliup_prod \webapps\ROOT\WEB-INF\classes\spring and edit the new repository details -

jpaVendorAdapter:

Choose the relevant repository type under the property name="jpaVendorAdapter" enty by unmark the <!-- sign

bean dataSource:

Define the relevant repository user, password, DB Band server details under the <bean id="dataSource" enty by unmark the <!-- sign

Starting from quilliup version 2.6.1.9.2:

File 'data-jpa-config.xml' doesn't contain repository DB details. Instead DB details are  located in 'connection.properties' file.

Open 'connection.properties' file (location: ../quilliup/webapps/ROOT/WEB-INF/classes/').

Uncomment your repository Database details (remove '#').

Comment all irrelevant data and define your repository DB details.

*Preferable to encrypt your DB password:

Pay attention: if you choose to encrypt your password, please make sure you have a copy of your password in your passwords manager.

Open "quilliup Encrypt AES.jar" file, located in: "..\quilliup\webapps\ROOT\utils\quilliup Encrypt AES.jar'"

Encrypt your password and copy string form "Result" field into 'connection.properties' file. Save changes.

For example (MySQL repository):

9. Restart the quilliup service Apache Tomcat 7.0 quilliup

Destination folder: Application Folder\quilliup_prod\bin

Stop quilliup service: net stop quilliup

Start quilliup service: net start quilliup

10. Create windows service

1. Open the command line as administrator and go to the location C:\Program Files\quilliup_prod\bin*
2. Run the following command to create windows service which will be in charge of the new quilliup instance: "service.bat install quilliup_prod"
3. Open windows services, edit the startup type to Automatic and start it

This is it!