Versions Compared

Old Version 2

changes.mady.by.user Ashhad Alam

Saved on

compared with

New Version Current

changes.mady.by.user Ashhad Alam

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Corrected links that should have been relative instead of absolute.

After you've created the export.zip file, you can import the objects using import.xml file. A successful import completes the migration process, and you'll be able to access all the exported objects in your new environment. 

Info
If you want to retain the activities while importing the objects, you need to configure the parameters in the retain.xml that you want to retain. The objects can be retained at service and field level. You will find retain.xml in the <shared>/migration/template folder. For more information, refer to Structure of Retain XML.

Pre-requisite

  • Ensure that you have followed the the required steps to avoid the creation of rollback zip file while importing the objects at the target.

...

  1. Copy the exported zip file to a Kubernetes shared location in the PVC.

  2. Copy the import.xml file from PVC shared location <shared>/migration/template, and paste it to another folder.
    For example, shared/migration/custom/import.xml.

  3. Open import.xml in a text editor and do the followings.

    1. In the <SourceZipLoc>, type the location (shared path of exported zip file in PVC) of the exported zip file that you want to import.

    2. Type the location of retain.xml file in the <RetainXMlLocation>. 

    3. Anchor
      DisableRollback
      DisableRollback
      Enter the User Id of the an IT user to whom you want to provide the ownership of the objects that you are deploying from the source environment in the <OverrideUser>.

    4. Add <CreateRecovery>false</CreateRecovery> tag to disable the creation of rollback zip.

      Info
      Alternatively, you can set the environment variable RECOVERY_ENABLED to false in the values.yaml file.


    5. Save the file.
  4. Go to migration 4.0.0 · adeptiainc/adeptia-connect-migration (artifacthub.io) to helm artifactHUB repository.

  5. Select the appropriate version of the helm chart to view the details of migration helm package.

  6. Add migration repo using following command:

    Code Block
    languagecss
    themeMidnight
    helm repo add adeptia-connect-migration https://adeptia.github.io/adeptia-connect-migration/charts/


  7. Click DEFAULT VALUES.
    Image Added

  8. On the Default values screen, click Image Added to download the values.yaml file.
    Image Removed

  9. Provide values for the following properties and environment variables in values.yaml file as shown in the table below.

    Variable/Property

    Value

    BACKEND_DB_URL<URL of the backend database server>
    BACKEND_DB_USERNAME<Username of your backend database server>
    BACKEND_DB_PASSWORD<Password for your backend database server>
    BACKEND_DB_DRIVER_CLASS<Backend database driver class name>
    BACKEND_DB_TYPE<Type of the backend database server> For example, SQL-server.
    SHARED_PATH<Environment variable in the values.yaml file that contains the configured shared path> The default value for this variable is /shared. This is the folder created at the root level in the PVC when you deploy Adeptia Connect.
    MIGRATION_XML_FILE_PATH<Path of the import.xml in PVC> For example, shared/migration/custom/import.xml.

    Anchor
    rollback
    rollback
    RECOVERY_ENABLED

    		true (default).


  10. Navigate to the migration directory, and run the below command to import the objects.

    Code Block
    languagecss
    themeMidnight
    helm install migration adeptia-connect-migration/migration -f <Path of the values.yaml>


    Info
    The Migration job does not get deleted automatically after the migration is complete. You need to manually delete it before you start a new migration process.