Skip to main content
Version: 3

This section lists the prerequisites and steps for applying and verifying this patch.

InformationThough every release of Adeptia comes with seamless upgrades and bug-free patches, for customer's complex use cases, we recommend applying the patch in a non-production environment first followed by testing. After the use cases run successfully without any errors or warnings, you can apply the patch in the production environment.

Prerequisites​

Before you start applying the Connect Server patch, ensure that the following prerequisites are met:

  • You have Read and Write permissions on all sub-folders and files under .../AdeptiaConnect-<Version>.
  • You have taken the backup of:
    • The web.xml file located at ...<ConnectServerInstallFolder>\AdeptiaServer\ServerKernel\ConnectServer\web\WEB-INF for future use.
    • The cacerts from ConnectServer\ServerKernel\etc\truststore location.
  • Services such as Kernel, WebRunner, and AIMap are stopped.
  • No Process Flow or Transaction is in running, waiting, or queued state.
  • At least 2048 MB of free disc space is available on your system.
  • You have the necessary database permissions.

Applying the patch​

[+] For Windows [-] Hide

  1. Download the latest patch from the provided URL.
  2. Extract the downloaded zip file in a folder.
  3. Open the Command Prompt.
  4. Go to the folder where you have extracted the zip file.
  5. Run the following command to apply the patch:
Apply-Patch.bat “<Path where Connect Server is installed till AdeptiaServer folder>” 

For example:

Apply-Patch.bat   
"C:/Program Files/AdeptiaConnect-x.x/ConnectServer/AdeptiaServer"
or 
Apply-Patch.bat  
"C:/Program Files/AdeptiaSuite-x.x/AdeptiaServer"

Once the patch is applied, a confirmation message will be displayed.

| Warning | While applying the patch you may come across following warning messages that you should ignore.

• Not deploying connect2.0 accelerator because no change list is present.
• Not deploying EDI accelerator because no change list is present. | | --- | --- | [+] For Linux [-] Hide Before you apply this patch on Linux, ensure that you take back up of your existing startup.sh and stop.sh files.

  1. Open the Terminal.
  2. Download the latest patch from the provided URL.
  3. Extract the downloaded zip file in a directory.
  4. Go to the directory where you have extracted the zip file.
  5. Run the following command to apply the patch:
./Apply-Patch.sh <Path where Connect Server is installed till AdeptiaServer folder> 

For example:

./Apply-Patch.sh /mnt/AdeptiaConnect-x.x/ConnectServer/AdeptiaServer

or

./Apply-Patch.sh /mnt/AdeptiaSuite-x.x/AdeptiaServer

Once the patch is applied, a confirmation message will be displayed.

| Warning | While applying the patch you may come across following warning messages that you should ignore.

• Not deploying connect2.0 accelerator because no change list is present.
• Not deploying EDI accelerator because no change list is present. | | --- | --- |

After you have applied the patch, PatchApplicationLog_<Date>.log file is created inside the logs folder. The logs folder is available in the same folder from where you have applied the patch. PatchApplicationLog_<Date>.log file contains the logs generated during patch application and can be used to troubleshoot any issue related to the patch application.

Patch application may take some time, in case there are a large number of records in the backend and log database.

The patch will automatically rollback, in case of any error during the deployment.

After applying this patch, perform the post patch deployment steps discussed in the following section.

Post patch deployment steps​

After you have applied the Server patch, update the web.xml file and cacerts in Connect Server.

Updating the web.xml file in Connect Server​

Follow the steps given below to update the web.xml file in Connect Server.

  1. Copy the web.xmlfile from patch location, and paste it at the following location: <ConnectServerInstallFolder>\AdeptiaServer\ServerKernel\ConnectServer\web\WEB-INF.
  2. Open the copied file and replicate the manual changes that you may have done in your previous web.xml file (that you had saved as a backup).
  3. Save the file.

Updating the cacerts in Connect Server​

Follow the steps given below to update the cacerts in Connect Server.

  1. Copy the cacertsfile from patch location, and paste it at ConnectServer\ServerKernel\etc\truststorelocation replacing the existing cacerts file.
  2. Restore the certificates that you may have had in the older cacerts file as replacing the existing cacerts file removes the existing certificates.
SuccessAfter you have followed the post patch deployment steps, start the Connect Server.

Verifying Connect Server patch​

To verify whether the patch is applied successfully:

  1. Go to …<ConnectServerInstallFolder>\AdeptiaServer\ServerKernel\etc\CVSlocation.
  2. Open the Tag file.
  3. Check the Build Tag. If the build tag matches the tag of the Connect Server, it indicates that the Connect Server patch is deployed successfully.

To recover the patch, refer to this page.