Table of Contents

Search

  1. Preface
  2. Command Line Programs and Utilities
  3. Installing and Configuring Command Line Utilities
  4. Using the Command Line Programs
  5. Environment Variables for Command Line Programs
  6. Using infacmd
  7. infacmd as Command Reference
  8. infacmd aud Command Reference
  9. Infacmd bg Command Reference
  10. infacmd cms Command Reference
  11. infacmd dis Command Reference
  12. Infacmd es Command Reference
  13. infacmd ihs Command Reference
  14. infacmd ipc Command Reference
  15. infacmd isp Command Reference
  16. infacmd ldm Command Reference
  17. infacmd mrs Command Reference
  18. infacmd ms Command Reference
  19. infacmd oie Command Reference
  20. infacmd ps Command Reference
  21. infacmd pwx Command Reference
  22. infacmd rms Command Reference
  23. infacmd rtm Command Reference
  24. infacmd sch Command Reference
  25. infacmd search Command Reference
  26. infacmd sql Command Reference
  27. infacmd tdm Command Reference
  28. infacmd wfs Command Reference
  29. infacmd ws Command Reference
  30. infacmd xrf Command Reference
  31. infacmd Control Files
  32. infasetup Command Reference
  33. pmcmd Command Reference
  34. pmrep Command Reference
  35. Working with pmrep Files

CreateIntegrationService

CreateIntegrationService

Creates a PowerCenter Integration Service in a domain.
By default, the PowerCenter Integration Service is enabled when you create it.
The infacmd isp CreateIntegrationService command uses the following syntax:
CreateIntegrationService <-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] <-ServiceName|-sn> service_name [<-FolderPath|-fp> full_folder_path] <<-NodeName|-nn> node_name|<-GridName|-gn> grid_name> [<-BackupNodes|-bn> node1 node2 ...] <-RepositoryService|-rs> repository_service_name [<-RepositoryUser|-ru> repository_user] [<-RepositoryPassword|-rp> repository_password] [<-RepositoryUserSecurityDomain|-rsdn> repository_user_security_domain] [<-ServiceDisable|-sd>] [<-ServiceOptions|-so> option_name=value ...] [<-ServiceProcessOptions|-po> option_name=value ...] [<-EnvironmentVariables|-ev> name=value ...] [<-LicenseName|-ln> license_name]
For infacmd isp CreateIntegrationService, you must not use the -ru, -rp, and the -rsdn options in Kerberos authentication. If you use these options in Kerberos mode, the command will fail.
The following table describes infacmd isp CreateIntegrationService 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 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.
-ServiceName
-sn
service_name
Required. Name of the PowerCenter Integration Service.
The name is not case sensitive and must be unique within the domain. The characters must be compatible with the code page of the associated repository. The name cannot have leading or trailing spaces, include carriage returns or tabs, exceed 79 characters, or contain the following characters:
/ * ? < > " |
-FolderPath
-fp
full_folder_path
Optional. Full path, excluding the domain name, to the folder in which you want to create the Integration Service. Must be in the following format:
/
parent_folder
/
child_folder
Default is “/” (the domain).
-NodeName
-nn
node_name
Required if you do not specify the grid name. Name of the node where you want the PowerCenter Integration Service process to run. If the PowerCenter environment is configured for high availability, this option specifies the name of the primary node.
To apply changes, restart the Integration Service.
-GridName
-gn
grid_name
Required if you do not specify the node name. Name of the grid where you want the PowerCenter Integration Service process to run.
To apply changes, restart the PowerCenter Integration Service.
-BackupNodes
-bn
node1 node2 ...
Optional. Nodes on which the service can run if the primary node is unavailable. You can configure backup nodes if you have high availability.
-RepositoryService
-rs
repository_service_name
Required. Name of the PowerCenter Repository Service that the PowerCenter Integration Service depends on.
To enter a name that contains a space or other non-alphanumeric character, enclose the name in quotation marks.
To apply changes, restart the PowerCenter Integration Service.
-RepositoryUser
-ru
repository_user
Required for native or LDAP authentication. User name used to connect to the PowerCenter repository.
To enter a name that contains a space or other non-alphanumeric character, enclose the name in quotation marks.
To apply changes, restart the PowerCenter Integration Service.
-RepositoryPassword
-rp
repository_password
Required for native or LDAP authentication. User password. You can set a password with the -rp option or the environment variable INFA_REPOSITORY_PASSWORD. If you set a password with both methods, the password set with the -rp option takes precedence.
To apply changes, restart the PowerCenter Integration Service.
-RepositoryUserSecurityDomain
-rsdn
repository_user_security_domain
Required for LDAP. Optional if the domain uses native authentication. Name of the security domain to which the PowerCenter repository user belongs.
The security domain name is case sensitive. If you do not specify this option, the command sets the repository user security domain to native.
-ServiceDisable
-sd
-
Optional. Creates a disabled service. You must enable the service before you can run it.
-ServiceOptions
-so
option_name=value
Optional. Service properties that define how the PowerCenter Integration Service runs.
‑ServiceProcessOptions
-po
option_name=value
Optional. Service process properties for the PowerCenter Integration Service. In a grid or multi-node environment, infacmd applies these properties to the primary node, grid, and backup node.
-EnvironmentVariables
-ev
name=value
Optional. Specify environment variables as PowerCenter Integration Service process options. You may want to include additional variables that are unique to your PowerCenter environment.
To apply changes, restart the node.
-LicenseName
-ln
license_name
Required if you create an enabled service. Name of the license you want to assign to the PowerCenter Integration Service.
To apply changes, restart the PowerCenter Integration Service.


Updated April 22, 2019