Prerequisites

Overview

Refer the "Planning " page before proceeding with the next steps. Plan out the entities to be migrated and set the prerequisites for execution of IGI Migration Tool.

Folder structure

IVIG 11.0.0.1 IF1 onwards, the IGI Migration Tool is available on all three form factors of IVIG i.e., Software Stack, Container and Virtual Appliance. Each form factor has a different method to access the components in the IGI Migration Tool. The IGIMigration directory will basically contain below sub-directories.

• config: This directory contains multiple properties files which are required to configure the migration tooling utility.

• bin: This directory contains executable scripts to perform the migration.

• logs: This directory contains the logs related to execution of the migration utility.

• jar: This directory contains the binaries.

• result: After the utility execution, the success and failure results are uploaded here.

• csv: If the csv file creation path is not specified explicitly in the config file, this directory stores all the extracted CSV files from ISVG-Gov system.

• json : If the json file creation path is not specified explicitly in the config file, this directory stores all the json files. These json files contain data parsed from CSV file and converted into JSON format for further loading it into IVIG system.

This directory structure can be accessed on the different form factors in different ways as follows.

• IVIG Software Stack: Access the directory present at location: <Liberty_Home>/usr/servers/defaultServer/bin/IGIMigration

• IVIG Container : To access the container file system, execute the following commands:

  kubectl exec -it <PODNAME> bash -n <NameSpace>
  cd /work/IGIMigration

• IVIG Virtual Appliance : Login to the Virtual Appliance Local Management Interface (LMI) and navigate to Configure → Custom File Management panel. The IGIMigration directory is available here.

Prerequisites

1. Ensure the ISVG-Gov database is accessible from the IVIG setup from where the migration needs to be performed.

2. Obtain the IGI DB credentials to connect to the IGI database.

3. Plan the steps in the migration before executing the utility. These steps could include a combination of below operations, entities and configurations. Pick an operation along with one or more entities and configurations for each step of the migration. Refer Planning section for more details about each operation, entity and configuration.

Operations:

1. Read

2. Convert

3. Load

4. Retry

Entities:

Configurations:

1. User configurations

2. Application configurations

3. Account configurations

4. OU configurations

5. Role configurations

6. Provisioning rules

7. Campaign configurations

8. Email notifications

1. Ensure that the Java Runtime Environment is installed and accessible from the path where migration utility is executed in IVIG - Software Stack setup.

2. Update the following configuration files as per requirement.

   1. application.properties file

   2. igisql.properties file

   3. mapping.properties file