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-
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.
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
Chnge the port number from 8080 to 7070
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 22.214.171.124.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 -
Choose the relevant repository type under the property name="jpaVendorAdapter" enty by unmark the <!-- sign
Define the relevant repository user, password, DB Band server details under the <bean id="dataSource" enty by unmark the <!-- sign
Starting from quilliup version 126.96.36.199.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
- Open the command line as administrator and go to the location C:\Program Files\quilliup_prod\bin*
- Run the following command to create windows service which will be in charge of the new quilliup instance: "service.bat install quilliup_prod"
- Open windows services, edit the startup type to Automatic and start it
This is it!