Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Corrected links that should have been relative instead of absolute.

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  Read and Write permissions  permissions on all subfolders sub-folders and files of 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-configure.properties file:

Info

You need to perform the below steps for the backend and log database. If you have configured a separate database for archiving the logs then you need to perform the same steps for the Archival log database.

  1. Go to …<ConnectServerInstallFolder>\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 'log4j.appender.jdbc.url' by removing the value ?useSSL=false&amp;serverTimezone=<time zone> at the end of the URL.

  1. Save the file.

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

  1. Go to <ConnectServerInstallFolder>\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 'org.quartz.dataSource.aBPM.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 jettybackup web.xmlfile  (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 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 the indexes folder folder.
    • To use the Lucene (Search Functionality) after applying the patch:
      • Go to to Account >  > My Company
      • Click Indexing
      • On Indexing screen, click click Index Now.