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.

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

Table of Contents
maxLevel3

Prerequisites

Before applying the patch, ensure that you have:

...

    • In case, any other database is used as the backend database, you need to follow the backup instructions given by that Database Server. To know, which database is used as the back end database, refer to Appendix A: Identify Backend Database.
  • Take backup of export.xml file from  from <AdeptiaInstallFolder>\AdeptiaServer\ServerKernel\MigrationUtility location. This backup file will help you replicate the manual changes in case you have done earlier in this file before applying this patch.  

  • Take the backup of applicationconfigsecurityContext.xml file from …<AdeptiaInstallFolder><AdeptiaInstallFolder>\AdeptiaServer\ServerKernel\etc location\saml location. This  This backup file will help you replicate the manual changes in case you have done earlier in this file that you may have done in this file in the past before applying this patch. 

  • Ensure that you have followed the Prerequisites' instructions given on the Installing Adeptia Suite page.

Applying the patch

For Windows

  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 Adeptia Suite is installed till AdeptiaServer folder>" 

    For example:

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

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

  6. Start Kernel and WebRunner. 

...

After applying this patch, refer to post patch deployment section for manual changes.

Anchor
Patch Deployment Steps
Patch Deployment Steps
Post Patch Deployment Steps

In this release, some manual changes are required in Server.

Changes in export.xml

  1. Go to <AdeptiaInstallFolder>\AdeptiaServer\ServerKernel\MigrationUtility locationNavigate to .../<AdeptiaInstallFolder>/AdeptiaServer/ServerKernel/MigrationUtility folder.
  2. Open export.xml file in a text editor.
  3. Search for the Activities tag containing the activityId="003" and add the following activities within this tag:
    <activity name="PDFSchema" />

    Image Removed
    Image Removed

    Add the following code snippet just after the tag </ExportType>. 

    Code Block
    languagecss
    themeMidnight
    <!--Possible value of comparison operator (">",">=","<","<=")-->
    <!--<ModifiedDate
    comment="Specify the date(YYYY-MM-DD hh:mm:ss) along with comparison operator"><![CDATA[> 2021-05-24 16:39:10]]></ModifiedDate>-->


  4. Save the file.

Changes

...

in securityContext.xml

...

Note
You need to follow these instructions only if you have made changes to your previous applicationconfig.xml file.

There are some properties that need to change after you finish the deployment. These changes can be done through the Adeptia Suite GUI. Following the steps below to change the four properties being discussed hereunder.

...

Update the values of the following properties from the backup of applicationconfig.xml file as explained below.

...

Old Property Name (applicationconfig.xml backup)

...

New Property Name (Settings UI)

...

  1. Go to <AdeptiaInstallFolder>\AdeptiaServer\ServerKernel\etc\saml location.

  2. Open securityContext.xml file.

  3. Update the xsi:schemaLocation attribute as shown in the following code snippet. 

    Code Block
    languagecss
    themeMidnight
    xsi:schemaLocation="http://www.springframework.org/schema/beans classpath:org/springframework/beans/factory/xml/spring-beans.xsd
    http://www.springframework.org/schema/security classpath:org/springframework/security/config/spring-security-5.6.xsd
    http://www.springframework.org/schema/context classpath:org/springframework/context/config/spring-context.xsd">


  4. Save the file.
  5. Restart the Server.


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