Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The patch will automatically recover if any error occurs. In case, you want to recover the patch manually, follow the steps described later in this section.  

This section lists the prerequisites and steps for recovering the patch.

Prerequisites

Ensure that you have:

  • You have Read and Write permissions on all sub-folders and files of .../AdeptiaConnect-<Version>
  • Stopped the services, i.e., Kernel, WebRunner, and AIMap.

Recovering the patch

Expand
titlePrerequisites for MySQL database

This section is applicable only when MySQL is being used as a backend or log database. In case you are using MS SQL or Oracle as backend or log database then you can skip this step.

Steps to remove the manual changes from server-config.properties file:

Info
You need to perform the below steps for Log, Backend, and Archival database.
  1. Go to .../<AdeptiaInstallFolder>/AdeptiaServer/ServerKernel/etc location.
  2. Open server-configure.properties file.
  3. Go to Database Configuration section and do the following changes:
    • Update the property 'abpm.jdo.driver' value as com.mysql.jdbc.Driver.
    • Update the property 'abpm.jdo.url' by removing the value ?useSSL=false&serverTimezone=<time zone> at the end of the URL.
  4. Go to Database Appender section and do the following changes:
    • Update the property 'log4j.appender.jdbc.dbclass' value as com.mysql.jdbc.Driver.
    • Update the property 'abpm.jdo.url' by removing the value ?useSSL=false&amp;serverTimezone=<time zone> at the end of the URL.

  5. Save the file.

Steps to remove the manual changes from qaurtz.properties file:

  1. Go to .../<AdeptiaInstallFolder>/AdeptiaServer/ServerKernel/etc location.
  2. Open quartz.properties file.
  3. Go to Configure Datasources section and do the following changes:
    • Update the property 'org.quartz.dataSource.aBPM.driver' value as com.mysql.jdbc.Driver.
    • Update the property 'abpm.jdo.url' by removing the value ?useSSL=false&serverTimezone=<time zone> at the end of the URL.

  4. Save the file.


Expand
titleFor Windows
  1. Open the Command Prompt.
  2. Go to the folder from where you applied the patch.
  3. Run the following command to recover the patch:

    Recover-Patch.bat “<Path where Adeptia Connect is installed till AdeptiaServer folder>”

    For example:
    Recover-Patch.bat "C:/Program Files/AdeptiaConnect/AdeptiaConnect-x.x/ ConnectServer/AdeptiaServer"  

  4. Once the patch is recovered, a confirmation message will be displayed.
  5. Start the services, i.e. Kernel, WebRunner, and AIMap.


Expand
titleFor Linux
  1. Open the Terminal.
  2. Go to the directory from where you applied the patch.
  3. Run the following command to recover the patch:

    ./Recover-Patch.sh <Path where Adeptia Connect is installed till AdeptiaServer folder> 

    For example:
    ./Recover-Patch.sh /mnt/AdeptiaConnect-x.x/AdeptiaServer 

  4. Once the patch is recovered, a confirmation message will be displayed. 
  5. Start the services, i.e. Kernel, WebRunner, and AIMap.


Info
Remove all the changes done manually at the time of deploying the patch.

Post Recovery Steps

After recovery of this patch, you will have to manually perform these steps:

  1. Paste the backup web.xml (that you had saved as a backup) at the …<ConnectServerInstallFolder>\AdeptiaServer\ServerKernel\web\WEB-INF location.
  2. Paste the backup jetty.xml (that you had saved as a backup) at the …<ConnectServerInstallFolder>\AdeptiaServer\ServerKernel\etc\jetty location. 
  3. In case you are using MySQL as Backend and Log database and you have done the manual changes, then follow the below step:
    Paste the backup quartz.properties (that you had saved as a backup) at the …<ConnectServerInstallFolder>\AdeptiaServer\ServerKernel\etc location.
  4. In case you are using MySQL as Backend and Log database and you have done the manual changes, then follow the below step:
    Paste the backup server-configure.properties (that you had saved as a backup) at the  …<ConnectServerInstallFolder>\AdeptiaServer\ServerKernel\etc location. 
  5. If you have enabled Lucene in Adeptia Connect then go to …<ConnectServerInstallFolder>\AdeptiaServer\ServerKernel location and open the indexes folder. 

    Info
    You can perform this post recovery step only after applying the Connect Portal patch.


    • Delete the list of files from each sub-folder of the indexes folder.
    • To use the Lucene (Search Functionality) after applying the patch:
      • Go to Account > My Company
      • Click Indexing
      • On Indexing screen, click Index Now.