ARD 3.2 Hub: new migration algorithm

book

Article ID: 221024

calendar_today

Updated On:

Products

CA Agile Requirements Designer

Issue/Introduction

 
 

With the release of ARD 3.2 Hub there is a new Migration Algorithm being released>
This is set with the checkFlowPath flag.
How is this enabled and checked?

Cause

 

Agile Requirements Designer ARD
3.2

Environment

 

 

Resolution

 
 

Hub: new migration algorithm

Current algorithm (default)

For each flow added to migration job:
      1) CREATE new flow in FlowStorage
      2) If failed because the same ArdGuid already exists in FlowStorage
             a) get Flow model from Flow storage
             b) check IF flow’s file version in FS is older or the same 
                   i) UPDATE flow

New algorithm (enabled by toggler)

Changes in FlowStorage: Update Flow model to contain  full file path (AbsoluteFilePath >> RelativeFilePath >> ARDRepositoryUrl).

For each flow added to migration job:
       1) CREATE new flow in FlowStorage
       2) If failed because the same ArdGuid already exists in FlowStorage
              a) Use ArdGuid to find if we have guid-path mapping for this flow
              b) IF found AND  flow’s path is different from stored in mapping
                     i) GENERATE new ArdGuid
                     ii) CREATE flow in FlowStorage
              c) ELSE get Flow model from Flow storage
                     i) IF flow’s file version in FS is older or the same 
                          1)UPDATE flow

How to enable the new Migration Feature

Non-dockerized setup:

1. Connect to the server running ARD Hub (SSH/RDP)
2. Navigate to the home folder of the user that is running tomcat (e.g.: "/home/tomcat/", or "C:\Users\Administrator")
3. In that home folder, open the Hub settings file:
.ard/conf/settings.properties

for editing and add the following:
           ard.migrate.checkFlowPath=true
4. Save the settings.properties file and restart the Tomcat service.

Dockerized setup

1) SSH to the server running ARD Hub container

2) Get container ID
         docker ps -a

3) Copy Hub settings file from the container
         docker cp CONTAINER_ID:/home/tomcat/.ard/conf/settings.properties settings.properties

4) Open settings file in editor and add there following:
         ard.migrate.checkFlowPath=true

5) Copy settings file back to container
         docker cp settings.properties CONTAINER_ID:/home/tomcat/.ard/conf/settings.properties

6) Restart the container
         docker restart CONTAINER_ID

 

How to check the feature flag status

1) Login to Web UI. For example
         http://muntest001405.bpc.broadcom.net/ard/ui

2) Copy Auth header form the browser’s console

 

3) Use copied Auth header in ModHeader extension

 

4) Go to Migration service environment endpoint
          http://muntest001405.bpc.broadcom.net/ard/api/migration/actuator/env

5) Find there ard.migrate.checkFlowPath it should be set to true

Additional Information