Steps to import the objects
- Go to .../<AdeptiaInstalledFolder>/AdeptiaServer/ServerKernel/MigrationUtility folder.
Open import.xml and do the following:
For more information on import.xml, refer to Structure of Import XML.
Ensure that Webrunner is running, before importing rich form objects.- Provide the location where you have placed "export.zip" in the <SourceZipLoc>.
- Provide the location of the target Adeptia Suite in the <TargetInstallDir>.
- Provide the location of “retain.xml” located inside migration utility folder of AdeptiaSuite in the <RetainXMlLocation>.
- Provide the Group Id copied from the Source environment in the <OverrideGroup>. If you want to move the objects in the admin group then no need to provide the Group ID.
- Provide the User Id copied from the Source environment in the <OverrideUser>. If you want to move the objects in the admin user then no need to provide the User ID.
Provide the User Id copied from the Source environment (in case you have copied the User ID above) in the <OverrideModifiedByUser>.
To override project group, add new tag <OverrideProjectGroup> and provide the Group ID. For example,
<OverrideProjectGroup comment="Group Id which will be reflected in the project group field of project after
deployment"></OverrideProjectGroup>
You have to manually add this tag.
To retain some of the activities, open retain.xml located .../<AdeptiaInstalledFolder>/AdeptiaServer/ServerKernel folder and change the required parameters. For more information, refer to Structure of Retain XML.
- Open Command Prompt and change the directory to .../<AdeptiaInstallFolder>/AdeptiaServer/ServerKernel.
- Run the following command:
- For Windows:
migrationutility.bat –import <path of the import.xml file>
- For Linux:
./migrationutility.sh –import <path of the import.xml file>
The migration utility runs in the console mode and deploys the objects at the target environment. By default, it imports the objects as per the parameters defined in the import.xml file and deploys the exported zip from the path defined there. If you want to define the installed build path and object zip location at run-time, without considering the values defined in import.xml file, then run the migration utility using the following command:
For Windows:
migrationutility.bat –import <path of the import.xml file> <path of AdeptiaInstalledFolder till Adeptia Server> <path of the Source location with the zip file name>
For example, migrationutility.bat –import MigrationUtility\import.xml "C:\Program Files\AdeptiaSuite\AdeptiaSuite-6.2\AdeptiaServer" "D:\ExportedObjects.zip"
For Linux:
./migrationutility.sh –import <path of the import.xml file> <path of AdeptiaInstalledFolder till Adeptia Server> <path of the Source location with the zip file name>
For example, ./migrationutility.sh -import MigrationUtility/import.xml "/home/AdeptiaSuite-6.2/AdeptiaServer" "/home/AdeptiaSuite-6.2/AdeptiaServer/ExportedObjects.zip"
Here:
- "Migration Utility" is the folder within which import.xml file is located.
- "/home/AdeptiaSuite-6.2/AdeptiaServer" is the path of the build location till Adeptia Server.
- "/home/AdeptiaSuite-6.2/AdeptiaServer/ExportedObjects.zip" is the source location with zip file name.
For information on how to omit version control fields while importing objects, refer to Migrating objects in version control.