Skip to main content
Version: 4

Restoring the objects

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.

    Informationshared 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 the ArtifactHUB page for Adeptia Connect Migration Helm Chart.

  5. Click DEFAULT VALUES, and then click  to download the values-migration.yaml file.

  6. Open the values-migration.yaml file.

  7. In the environmentVariables section, provide the values for the following variables :

    Variable
    		Value
    BACKEND_DB_URL
    • Azure SQL: jdbc:sqlserver://<DB Hostname>:<Port Number>;database=<Backend Database Name>;sendStringParametersAsUnicode=false;
    • Oracle: jdbc: oracle:thin:@<hostName>:<portNumber>:<S ID/ServiceName>
    • Azure MySQL: jdbc:mysql://<hostName>:<portNumber>/<DBName>sslMode=VERIFY_IDENTITY&fallbackToSystemKeyStore=false
    BACKEND_DB_USERNAME
    		Username for your Backend Database (To be provided by the infra team). Do not provide a value to this variable if you want to use an existing secret.
    BACKEND_DB_PASSWORD
    		Password for your Backend Database (To be provided by the infra team). Do not provide a value to this variable if you want to use an existing secret.
    LOG_DB_URL
    • Azure SQL: jdbc:sqlserver://<DB Hostname>:<Port Number>;database=<Log Database Name>;sendStringParametersAsUnicode=false;
    • Oracle: jdbc:oracle:thin:@<hostName>:<portNumber>:<S ID/ServiceName>
    • Azure MySQL: jdbc:mysql://<hostName>:<portNumber>/<DBName>?sslMode=VERIFY_IDENTITY&fallbackToSystemKeyStore=false
    LOG_DB_USERNAME
    		Username for your Log Database (To be provided by the infra team). Do not provide a value to this variable if you want to use an existing secret.
    LOG_DB_PASSWORD
    		Password for your Log Database (To be provided by the infra team). Do not provide a value to this variable if you want to use an existing secret.
    MIGRATION_XML_FILE_PATH
    		${SHARED_PATH}/migration/template/restore.xml
    InformationPath of the restore.xml file

    OPERATION
    		import
    OVERRIDE_USER
    		User ID for example, abc@xyz.com, of the user to whom you want to provide ownership of the migrated activities.
    OVERRIDE_MODIFIEDBY_USER
    		User ID for example, abc@xyz.com, of the user who will be reflected in the Modified By field of every activity after the migration.

  8. If you prefer to authenticate using an existing secret rather than specifying database credentials in the environmentVariables section, enter the name of that secret in the dbCredSecrets variable.

  9. If the target environment is an Amazon Red Hat OpenShift (ARO) cluster, do the following:

    1. In the values-migration.yaml file, go to securityContext > podSecurityContext.

    2. Remove the values set for the following variables:

      1. runAsUser

      2. runAsGroup

      3. fsGroup

  10. Add migration repo using following command:

  11. Run the following command to restore the objects.

    InformationA 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.

  12. Restart all the running pods.

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

In AC v4.x 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.x (microservice) environment:

  • Some of the properties have become environment variables.

    InformationYou 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.