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 steps for applying and verifying this patch.

...

  • You have Read and Write permissions on all sub-folders and files of .../AdeptiaConnect-<Version>.
  • Services such as Kernel, WebRunner, and AIMap are stopped.  
  • Take backup of securityContext.xml file from …<ConnectServerInstallFolder>connect_export.xml, export.xml, and connect_import.xml files from <ConnectServerInstallFolder>\AdeptiaServer\ServerKernel\etc\saml MigrationUtility location. This  These backup file files will help you replicate the manual changes in case you have done earlier in the securityContext.xml file in these files before applying this patch.  
  • Take the backup of export.xml and connect_export.xml files from <ConnectServerInstallFolder>applicationconfig.xml file from …<ConnectServerInstallFolder>\AdeptiaServer\ServerKernel\MigrationUtility location. These etc location.These backup files will help you replicate the manual changes in case you have done earlier in these files before applying this patch.  
  • Take the backup of the objects. Refer to this page to know why and how you need to back up and restore the objects.
  • No process flow or transaction should be in running, waiting or queued state. 
  • Ensure that you have followed the Prerequisites' instructions given on the Upgrade page.

...

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

Changes

...

in connect_export.xml

...

  1. Go to to <ConnectServerInstallFolder><ConnectServerInstallFolder>\AdeptiaServer\ServerKernel\etc\samlMigrationUtility location.

  2. Open securityContextOpen connect_export.xml file.

  3. Go to Security for the administration UI section and make the following change:

    Add the below property under the security headers tag:
    <security:hsts max-age-seconds="31536000"/>
    Image Removed
    Go to Secured pages with SAML as entry point section and make the following change:
    Add the below property under the security headers tag:
    <security:hsts max-age-seconds="31536000"/>
    Image Removed

    Search for the Activities tag containing the activityRefId="002" and add the following activities within this tag:
    <activity type="PDF Schema" />
    <activity type="Connectors" />

    Image Added

    Image Added

  4. Save the file.

Changes

...

in export.xml

  1. Go to <ConnectServerInstallFolder>\AdeptiaServer\ServerKernel\MigrationUtility location.

  2. Open connect_Open export.xml file.

  3. Search for the Activities tag containing the activityRefIdcontaining the activityId="002003" and add add the following activities within this tag:
    <activity type="Email Notification Format" />
    <activity name="KafkaAccountPDFSchema" />

    <activity name="KafkaListener" />
    <activity name="KafkaTarget" />
    Image RemovedImage Added

    Image Added

  4. Save the file.

Changes in

...

connect_import.xml

  1. Copy the connect_import.xml file from the patch location.

  2. Go to <ConnectServerInstallFolder>\AdeptiaServer\ServerKernel\MigrationUtility location and paste the copied file here.

  3. Open export.xml file.

  4. Search for the Activities tag containing the activityId="003" and add the following activities within this tag:
    <activity name="KafkaAccount" />
    <activity name="KafkaListener" />
    <activity name="KafkaTarget" />
    Image Removed
    Open connect_import.xml file.
  5. Do the same manual changes in the file that you have done in your previous connect_import.xml file (that you had saved as a backup).

  6. Save the file.

  7. Restart the Connect Server.

Changes in SecureBridge Agent Manager 

After upgrading to Adeptia Connect v3.4, you need to run the SecureBridge Agent Manager Migration Utility to be able to make the older version of the SecureBridge compatible with that in AC v3.4.

Warning
This step is required only when you are a licensed user of SecureBridge Agent Manager in Adeptia Connect v3.3.

...


Changes in applicationconfig.xml file

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 Connect GUI. Following the steps below to change the four properties being discussed hereunder.

  1. Click Accounts > Settings.
  2. Expand the Server Node Settings in the left panel.
  3. Select the server node.
  4. Click Edit.
  5. Click Image Added to expand the Performance Optimization property.
    Image Added
  6. Click Image Added to expand the Spring Retry Policy Configurations.
    Image Added
  7. 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)
    maxAttemptsabpm.spring.retry.policy.maxAttempts
    initialIntervalabpm.spring.retry.backOff.policy.initialInterval
    multiplierabpm.spring.retry.backOff.policy.multiplier
    maxIntervalabpm.spring.retry.backOff.policy.maxInterval


  8. Click Save.
  9. Restart the server.

Anchor
Verifying Connect Server Patch
Verifying Connect Server Patch
Verifying Connect Server patch

...