Patch Application for Dedicated JRE & Tomcat

If you have installed Adeptia Connect UI through Adeptia Connect v2.9.2 and earlier, JRE and Tomcat were installed manually. Follow the below steps to apply patch for dedicated JRE and Tomcat.

Prerequisites

• Take the backup of existing Tomcat Application (i.e. Adeptia Connect UI).
• Ensure that you have applied Connect Server v3.0 patch on Adeptia Suite.
• Ensure that Adeptia Suite (Connect Server) is started and accessible on HTTP port.
• Read and Write permissions to the folder where you will setup the Connect Portal.

For this patch application, you must install Connect Portal to upgrade the Tomcat and JRE instead of upgrading it manually.

1. Stop Tomcat Application.

2. Install Connect Portal only using the latest Adeptia Connect 3.0 installer.  

   Use existing Tomcat port for HTTP/HTTPS protocol while installing Connect Portal.
3. Import all the required settings from existing Tomcat application to the new Connect Portal application. These settings are as follows:
   1. Import existing resource config directory to the new Connect portal application. 
      
      1. Go to the location where Tomcat (Adeptia Connect UI) is installed (Exp, C:/Program Files/Apache Software Foundation/Tomcat 9.0/webapps/Working_Directory/resources_config) and copy these files application.properties, application-system.properties, apps.properties, config.xml, logback.xml, and xeroapps.p12. 
      2. Go to …/<ConnectPortalInstallFolder>/resources_config and replace the files.
   2. Setup SSL configuration to the new Connect Portal application.
      
      1. Import existing SSL certificates (SSL Certificate Keystore) to new Connect Portal application.
      2. Go to the location where Tomcat (Adeptia Connect UI) is installed (Exp, C:/Program Files/Apache Software Foundation/Tomcat 9.0). Copy the existing Keystore (certs.jks) file from the certs folder.
      3. Go to …/<ConnectPortalInstallFolder>/keystore and paste the Keystore file (certs.jks).

      4. Go to …/<ConnectPortalInstallFolder>/conf and open server.xml file in the Text Editor.

      5. Register the Keystore entry in the server.xml file and add the path of Keystore and Keystore password (password chosen while creating Keystore). 
         
         
         
         

   3. Import existing truststore file to new Connect Portal application.
      
      1. Go to the location where Tomcat (Adeptia Connect UI) is installed (Exp, C:/Program Files/Apache Software Foundation/Tomcat 9.0). Copy the existing truststore (cacerts) file from the certs folder.
      2. Go to …/<ConnectPortalInstallFolder>/truststore and paste the truststore file (cacerts).

      3. Go to …/<ConnectPortalInstallFolder>/conf and open launcher.properties file in the Text Editor.

      4. Register the truststore entry in the launcher.properties file and add the path of truststore and truststore password (password chosen while creating truststore). 
         
         
         
         

   4. If you have configured security constraint in Tomcat web.xml file then you need to configure it by uncommenting the below security constraint.  

      In case, you have modified any other properties in web.xml file then you need to update those properties in new web.xml file.

      
      
      
      

   5. In case, you need to import the existing saml Configuration then
      

      1.  Go to …/<TomcatWorkingDirectory>/resources_config/saml and copy the samlKeystore.jks file.

      2. Replace the file at …/<ConnectPortalInstallFolder>/resource_config/saml.

      3. Update the securityContext.xml file as per the existing configuration.

   6. Configure existing tomcat tuning parameters in the new Connect Portal application. Click here for Performance Tuning of Connect Portal.
   7. Configure existing JVM memory settings to the new Connect Portal application.

      1. Go to …/<ConnectPortalInstallFolder>/conf and open launcher.properties file in the Text Editor.

      2. You can set the value according to your requirement. For minimum memory -Xms1024M and maximum memory -Xmx2048M.
      3. Save the file.
   8. Start Connect Portal application.
   9. Import any other custom changes.