Import Process
You can use the command line to import domain objects from an export file into a domain.
Perform the following tasks to import domain objects:
- 1. Run the infacmd xrf generateReadableViewXML command to generate a readable XML file from an export file. Review the domain objects in the readable XML file and determine the objects that you want to import.
- 2. If you do not want to import all domain objects in the export file, create an import control file to filter the objects that are imported.
- 3. Run the infacmd isp importDomainObjects command to import the domain objects into the specified domain.
- 4. After you import the objects, you may still have to create other domain objects such as application services and folders.
Rules and Guidelines for Importing Domain Objects
Review the following rules and guidelines before you import domain objects:
- •When you import a group, you import all sub-groups and users in the group.
- •To import native users and groups from domains of different versions, use the infacmd isp importUsersAndGroups command.
- •After you import a user or group, you cannot rename the user or group.
- •You import roles independently of users and groups. Assign roles to users and groups after you import the roles, users, and groups.
- •You cannot import the Administrator group, the Administrator user, the Administrator role, the Everyone group, or LDAP users or groups.
Conflict Resolution
A conflict occurs when you try to import an object with a name that exists for an object in the target domain. Configure the conflict resolution to determine how to handle conflicts during the import.
You can define a conflict resolution strategy through the command line or control file when you import the objects. The control file takes precedence if you define conflict resolution in the command line and control file. The import fails if there is a conflict and you did not define a conflict resolution strategy.
You can configure one of the following conflict resolution strategies:
- Reuse
- Reuses the object in the target domain.
- Rename
- Renames the source object. You can provide a name in the control file, or else the name is generated. A generated name has a number appended to the end of the name.
- Replace
- Replaces the target object with the source object.
- Merge
- Merges the source and target objects into one group. For example, if you merge groups with the same name, users and sub-groups from both groups are merged into the group in the target domain.
You cannot define the merge conflict resolution strategy through the command line. Use a control file to define the merge conflict resolution strategy. You must include the group object type section with merge as the conflict resolution policy with reuse, replace, or rename for all conflicting users in the control file.
For example, specify the merge conflict resolution strategy for the following groups:
- - Group A with users a1, a2, b1, b2 in the source domain.
- - Group A with users a1, a2, a3 b1, b2 in the target domain
You get the following results in the group after merge in the target domain:
- - a1, a2, b1, b2 if you choose reuse or replace
- - a1, a2, a3, b1, b2 if you choose rename.