Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 17 Next »

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

 Prerequisites 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:

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.

  5. 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.


 For 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.
 For 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.
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. 

    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.
  • No labels