Upgrade Java and Tomcat

Check that your existing Tomcat instance configuration matches the current recommendation, which is:

1. Create at least two separate Tomcat instances that use the Java and Tomcat versions included in the latest Zylinc release. Don’t upgrade to newer versions of Tomcat or Java via third-party downloads.
2. One of the instances must support HTTPS via a self-signed certificate. The other instances doesn’t need support for HTTPS.
3. In Max Memory (MB), enter at least 2048 for all instances

If you existing configuration doesn't match the current Zylinc recommendation, Alternative B in the following describes how to set up the recommended configuration.

This is how to use Deployment Manager to set up the first Tomcat instance:

1. In the Deployment Manager menu, select Deployment > Application Administration > Apache Tomcat Administration

2. In Instances, click New instance

3. In Apache, select the most recent Tomcat version available in the list

4. In Java, select the most recent Java version available in the list

5. In Initial Memory (MB), enter 512

6. In Max Memory (MB), enter 2048

7. In Name, enter ZyTomcat1-8080-8443

8. In User, enter admin

9. In Password, enter the password for Windows Tomcat 8080 user admin

10. Click Save instance

11. A new instance with the name ZyTomcat1-8080-8443 should be visible in the Instances list

12. In Connector(s), click New connector

    1. In Port, enter 8443

    2. In Protocol, select Http11NioProtocol

    3. Select SSL Enabled

    4. Select Secure

    5. In Scheme, select https

    6. In SSL Protocol, select TLS

    7. Click Generate certificate

       1. In Common name, enter the hostname of the Zylinc Windows Application Server, for example: WinAppServer

       2. In Organizational unit, enter 2

       3. In Organization, enter 3

       4. In Locality name, enter 4

       5. In State name, enter 5

       6. In Country code, enter 6

       7. In Alias, enter tomcat

       8. In Password, enter the password for Java keytool -genkey keystore

       9. In Destination path, enter C:\ProgramData\Zylinc\.keystore

       10. Click Apply

           If you see an error: Failed to generate certificate, do the following

           1. Rename the file in the path C:\ProgramData\Zylinc\.keystore to old.keystore

           2. Click Apply

    8. In Do you want to import the generated certificate, answer Yes

    9. Click Save connector

13. Click Save instance

14. In the Deployment Manager menu, select Deployment > Windows Services

15. Click Refresh Services

16. A new service with a name that ends with ZyTomcat1-8080-8443 should be visible in the Deployed Services list

17. Start the service

1. Go to the following address in a web browser: http://<WinAppServer>:8080/

   Example: The complete URL could be http://WinAppServer:8080/

2. You should see a Tomcat welcome page that says If you're seeing this, you've successfully installed Tomcat. Congratulations!

3. Click Manager App

4. In User name, enter Admin

5. In Password, enter the password for Windows Tomcat 8080 user admin

6. You should see a list of Applications, for example /docs and /examples

Now you know that HTTP works.

1. Go to the following address in a web browser: https://<WinAppServer>:8443/

   Example: The complete URL could be https://WinAppServer:8443/

2. Because the certificate is self-signed and hasn't been imported into Trusted Root Certification Authorities, you'll see a warning about a problem with the website’s security certificate:

   1. If you use Internet Explorer, click Continue to this website (not recommended).

   2. If you use Chrome, click ADVANCED, and then click Proceed to <WinAppServer> (unsafe).

3. You should see a Tomcat welcome page that says If you're seeing this, you've successfully installed Tomcat. Congratulations!

4. Click Manager App

5. In User name, enter Admin

6. In Password, enter the password for Windows Tomcat 8080 user admin

7. You should see a list of Applications, for example /docs and /examples

Now you know that HTTPS works.

Now, set up a second Tomcat instance, start it, and test it:

1. In the Deployment Manager menu, select Deployment > Application Administration > Apache Tomcat Administration

2. In Instances, click New instance

3. In Apache, select the most recent Tomcat version available in the list

4. In Java, select the most recent Java version available in the list

5. In Initial Memory (MB), select 512

6. In Max Memory (MB), select 2048

7. In Name, enter ZyTomcat2-8081

8. In Server port, change 8005 to 8006

9. In User, enter admin

10. In Password, enter the password for Windows Tomcat 8081 user admin

11. Click Save instance

12. A new instance with the name ZyTomcat2-8081 should be visible in the Instances list

13. In Connector(s), click Port=8080, Protocol=Http11

    1. In Port, change 8080 to 8081

    2. Click Save connector

14. In Connector(s), click Port=8009, Protocol=Ajp13

    1. In Port, change 8009 to 8010

    2. Click Save connector

15. Click Save instance

16. In the Deployment Manager menu, select Deployment > Windows Services

17. Click Refresh Services

18. A new service with a name that ends with ZyTomcat2-8081 should be visible in the Deployed Services list

19. Start the service

1. Go to the following address in a web browser: http://<WinAppServer>:8081/

   Example: The complete URL could be http://WinAppServer:8081/

2. You should see a Tomcat welcome page that says If you're seeing this, you've successfully installed Tomcat. Congratulations!

3. Click Manager App

4. In User name, enter Admin

5. In Password, enter the password for Windows Tomcat 8081 user admin

6. You should see a list of Applications, for example /docs and /examples

Now you know that HTTP works. There's no HTTPS connector for this instance, so there's no need to test that.

To avoid network port conflicts between the two Tomcat instances, inspect the Tomcat instance configuration manually:

1. In the Deployment Manager menu, select Deployment > Application Administration > Apache Tomcat Administration
2. In Instances, select ZyTomcat1-8080-8443 and verify the following:
   1. Server port is 8005
   2. A connector exists with Port=8080, Protocol=Http11
   3. A connector exists with Port=8009, Protocol=Ajp13
   4. A connector exists with Port=8443, Protocol=Http11NioProtocol
   5. No other connectors exist
3. In Instances, select ZyTomcat2-8081 and verify the following:
   1. Server port is 8006
   2. No connectors exist with Port=8080
   3. No connectors exist with Port=8009
   4. No connectors exist with Port=8443
   5. A connector exists with Port=8081, Protocol=Http11
   6. A connector exists with Port=8010, Protocol=Ajp13
   7. No other connectors exist