Command Reference > infacmd isp Command Reference > ImportDomainObjects
  

ImportDomainObjects

Imports native users, native groups, roles, and connections from an XML file into an Informatica domain.
If you do not want to import all objects in the file, use an infacmd import control file to filter the objects that you want to import.
Use the ExportDomainObjects and ImportDomainObjects commands to migrate objects between two different domains of the same version. To import native users and groups from domains of different versions, use the infacmd isp ImportUsersAndGroups command.
When you import a group, you import all subgroups and users in the group.
If the command fails with a Java memory error, increase the system memory available for infacmd. To increase the system memory, set the -Xmx value in the ICMD_JAVA_OPTS environment variable.
The infacmd isp ImportDomainObjects command uses the following syntax:
ImportDomainObjects

<-DomainName|-dn> domain_name

<-UserName|-un> user_name

<-Password|-pd> password

[<-SecurityDomain|-sdn> security_domain]

[<-Gateway|-hp> gateway_host1:port gateway_host2:port...]

[<-ResilienceTimeout|-re> timeout_period_in_seconds]

<-ImportFilePath|-fp> import_file_path

[<-ImportControlFile|-cp> import_control_file]

[<-ConflictResolution|-cr> resolution_type]
The following table describes infacmd isp ImportDomainObjects options and arguments:
Option
Argument
Description
-DomainName
-dn
domain_name
Required. Name of the Informatica domain. You can set the domain name with the -dn option or the environment variable INFA_DEFAULT_DOMAIN. If you set a domain name with both methods, the -dn option takes precedence.
-UserName
-un
user_name
Required if the domain uses Native or LDAP authentication. User name to connect to the domain. You can set the user name with the -un option or the environment variable INFA_DEFAULT_DOMAIN_USER. If you set a user name with both methods, the -un option takes precedence.
Optional if the domain uses Kerberos authentication. To run the command with single sign-on, do not set the user name. If you set the user name, the command runs without single sign-on.
-Password
-pd
password
Required if you specify the user name. Password for the user name. The password is case sensitive. You can set a password with the -pd option or the environment variable INFA_DEFAULT_DOMAIN_PASSWORD. If you set a password with both methods, the password set with the -pd option takes precedence.
-SecurityDomain
-sdn
security_domain
Required if the domain uses LDAP authentication. Optional if the domain uses native authentication or Kerberos authentication. Name of the security domain to which the domain user belongs. You can set a security domain with the -sdn option or the environment variable INFA_DEFAULT_SECURITY_DOMAIN. If you set a security domain name with both methods, the -sdn option takes precedence. The security domain name is case sensitive.
If the domain uses native or LDAP authentication, the default is Native. If the domain uses Kerberos authentication, the default is the LDAP security domain created during installation. The name of the security domain is the same as the user realm specified during installation.
-Gateway
-hp
gateway_host1:port gateway_host2:port ...
Required if the gateway connectivity information in the domains.infa file is out of date. The host names and port numbers for the gateway nodes in the domain.
-ResilienceTimeout
-re
timeout_period_in_seconds
Optional. Amount of time in seconds that infacmd attempts to establish or re-establish a connection to the domain. If you omit this option, infacmd uses the timeout value specified in the INFA_CLIENT_RESILIENCE_TIMEOUT environment variable. If no value is specified in the environment variable, the default of 180 seconds is used.
-ImportFilePath
-fp
import_file_path
Required. Path and file name of the XML file from which you import the objects.
-ImportControlFile
-cp
import_control_file
Optional. Path and file name of the import control file that filters the objects that are imported.
-ConflictResolution
-cr
resolution_type
Optional. Conflict resolution strategy. You can specify one of the following options:
  • - rename
  • - replace
  • - reuse
The option is ignored if you specify a conflict resolution strategy in the import control file. If you do not define a conflict resolution strategy and a conflict occurs, the import fails.