This section lists the prerequisites and explains how to apply the patch on Windows-based and Linux-based operating systems.

...

• Read and Write permissions on all sub-folders and files of ../AdeptiaSuite-<Version>.
• Stopped Kernel and Webrunner.
• Stopped process flows that are in Running or Queued state.
• Deactivated any running Mail Event.
• Take backup of web.xml file launcher.properties file from .../<AdeptiaInstallFolder>/AdeptiaServer/ServerKernel/ext location. This file will help you to update the launcher.properties file for manual changes, if you have done any.
• Take backup of jetty.xml file from .../<AdeptiaInstallFolder>/AdeptiaServer/ServerKernel\web\WEB-INF/etc/jetty location. This file will help you to update the webjetty.xml file  file for manual changes, if you have done any.
  
• Taken the backup of a backend database. 
  • In case, the embedded database is used as the backend database, follow the below steps to take the backup:

...

Upgrading Rich Form

This section is applicable for upgrading Rich Form in Adeptia Suite v6.9.6.

Follow the below steps if you have Rich Forms v7.3.2 in Adeptia Suite and want to upgrade it.

1. Stop Kernel and WebRunner. 
2. Go to the folder where you have extracted the zip file.
3. Copy these jar files to  .../<AdeptiaInstallFolder>\AdeptiaServer\ServerKernel\RichForms\WEB-INF\lib location.
   
   • hibernate-search-engine-4.4.6.Final.jar
   • hibernate-search-orm-4.4.6.Final.jar
   • lucene-core-3.6.0.jar
4. Start Kernel and WebRunner.  

Post Patch Deployment Steps

Changes in jetty.xml File

...

Post Patch Deployment Steps

Changes in jetty.xml File

1. Go to .../<AdeptiaInstallFolder>/AdeptiaServer/ServerKernel/etc/jetty location.
2. Open jetty.xml file.
3. Update the sslContextFactory bean class value by adding $Server at the end.
   
4. Add one Array type item as <Item>TLSv1.1</Item> to exclude the TLSv1.1 protocol.
   
   Image Added
   
   
5. Save the file.
   

Changes in web.xml File

1. Go to .../<AdeptiaInstallFolder>/AdeptiaServer/ServerKernel\etc\jetty /web/WEB-INF location.
2. Take backup of jettyweb.xml xml file from the above-mentioned location.
3. Go to the downloaded Adeptia Suite zip folder and copy jettycopy the renamed web.xml file.
4. Replace the existing file with the copied file at the following location: .../<AdeptiaInstallFolder>/AdeptiaServer/ServerKernel\etc\jetty.
5. In case, you have configured SSL certificate then update the jetty.xml file to configure the SSL certificate.

Changes in web.xml File

1. Go to .../<AdeptiaInstallFolder>/AdeptiaServer/ServerKernel\web\WEB-INF location/web/WEB-INF.
2. Open web.xml file.
3. Do the same manual changes in the file that you have done in your previous web.xml file (that you had saved as a backup).
4. Save the file.

Changes in server-configure.properties File

In case you are using MySQL as Backend and Log database then do these the following manual changes. These changes are required because JDBC driver has been updated for this release. 

1. Go to …<ConnectServerInstallFolder> \AdeptiaServer\ServerKernel\.../<AdeptiaInstallFolder>/AdeptiaServer/ServerKernel/etc location.
2. Open server-configure.properties file.
3. Go to Database Configuration section and do the following changes:
   1. Update the property 'abpm.jdo.driver' value as com.mysql.cj.jdbc.Driver.

   2. Update the property 'abpm.jdo.url' by appending the value ?useSSL=false&amp;serverTimezone=<time zone> at the end of the URL.

      • Append the value ?useSSL=false at the end of the URL. However, this argument is not required if SSL is configured on your MySQL database server.
      • Append the value &amp;serverTimezone=<time zone> at the end of the URL. For example, &amp;serverTimezone=UTC+3:00. This argument is required only when an error related to the time zone is displayed while starting the Connect Kernel.
        
        Here, <time zone> is the time zone of your MySQL server.
        
        Image Added

      
      

4. Go to Database Appender section and do the following changes:
   1. Update this the property 'log4j.appender.jdbc.dbclass' value as com.mysql.cj.jdbc.Driver.

   2. Update

      this

      the property '

      log4j

      abpm.

      appender

      jdo.

      jdbc.

      url' by appending the value ?useSSL=false&amp;serverTimezone=<time zone> at the end of the URL.

      • Append the value ?useSSL=false at the end of the URL. However, this argument is not required if SSL is configured on your MySQL database server.
      • Append the value &amp;serverTimezone=<time zone> at the end of the URL. For example, &amp;serverTimezone=UTC+3:00. This argument is required only when an error related to the time zone is displayed while starting the Connect Kernel.
        
        Here, <time zone> is the time zone of your MySQL server.
        
        Image Added

      
      

5. Save the file.

Changes in quartz.properties File

In case you are using MySQL as Backend and Log database then do these manual changes. 

1. Go to …<ConnectServerInstallFolder> \AdeptiaServer\ServerKernel\.../<AdeptiaInstallFolder>/AdeptiaServer/ServerKernel/etc location.
2. Open quartz.properties file.
3. Go to Configure Datasources section and do the following changes:
   
   1. Update the property 'org.quartz.dataSource.aBPM.driver' value as com.mysql.cj.jdbc.Driver.

   2. Update the property '

      org

      abpm.

      quartz.dataSource.aBPM.URL

      jdo.url' by appending the value ?useSSL=false&serverTimezone=<time zone> at the end of the URL.

      • Append the value ?useSSL=false at the end of the URL. However, this argument is not required if SSL is configured on your MySQL database server.
      • Append the value &serverTimezone=<time zone> at the end of the URL. For example, &serverTimezone=UTC+3:00. This argument is required only when an error related to time zone is displayed while starting the Connect Kernel.
        
        Here, <time zone> is the time zone of your MySQL server.
        
        Image Added

      
      

4. Save the file.

Restoring user-defined jars

With the new patch the launcher.properties file is updated and no longer has the list of jars in it. If you have defined your own jars in previous version of launcher.properties file, you need to move them to the ext folder to load them at the time of Kernel and WebRunner start up. Follow the steps below:

1. Open launcher.properties file that you had saved as a backup. 
2. Identify your jars and move those jars from their current location to the following location: .../<AdeptiaInstallFolder>/AdeptiaServer/ServerKernel/ext.

Once the post patch deployment steps are done, start the services, i.e. Kernel and WebRunner. .