Restoring the objects

Owned by Ashhad Alam
Last updated: Oct 13, 2022Version comment
2 min read

Once you have created the zip file containing the exported objects, you can use it to restore the objects in the AC v4.0 environment. To restore the objects, perform the following steps.

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

  2. Open the restore.xml located at <shared>/migration/template/restore.xml.

    shared is the folder created at the root level in the PVC when you deploy Adeptia Connect.
  3. Provide the path of the exported zip file in the <SourceZipLoc> tag of the restore.xml as illustrated below.
  4. Go to migration 4.0.0 · adeptiainc/adeptia-connect-migration (artifacthub.io) to view the details of migration helm package.

  5. Add migration repo using following command:

    helm repo add adeptia-connect-migration https://adeptia.github.io/adeptia-connect-migration/charts/

  6. Click DEFAULT VALUES to download the values.yaml file.

  7. Open the values.yaml file.
  8. Enter the path of the restore.xml file in the environment variable MIGRATION_XML_FILE_PATH.

  9. Run the following command to restore the objects.

    helm install migration adeptia-connect-migration/migration -f <Path of the values.yaml>
    A variable from the AC v3.x environment is available as an environment variable in AC v4.x environment. Once the migration has completed successfully, you need to manually update the values for the environment variables in the values.yaml file for the respective microservice. For example, the values of the variables from the AC v3.x ldapConfiguration.xml file need to be manually updated in the values.yaml file for the portal microservice.

  10. Restart all the running pods.

  11. Redeploy all the accelerators (the bundled accelerators, and the drivers).

In AC v4.0 environment, the server-configure.properties, and other properties files do not exist. These properties coming from the AC v3.5 environment are handled in the following manner in AC v4.0 (microservice) environment:

  • Some of the properties have become environment variables.

    You can find the list of these environment variables in a .csv file that is generated by the system after performing the restore operation. You can refer to this file to make the changes in the values of these environment variables (converted properties) in values.yaml file. The file is created with the name Config_Report_<name of the exported ZIP>. This file is created in the same folder where the exported ZIP file is located in the PVC. following is an excerpt from the file.
  • Some properties are moved to database with the same name or different names.
  • A few properties are deleted.
  • Some of the properties have been handled internally by the application.