Command Reference > infacmd dis Command Reference > UpdateServiceOptions
  

UpdateServiceOptions

Updates Data Integration Service properties. To view current properties run the infacmd dis ListServiceOptions command.
You can change the properties while the service is running, but you must recycle the service for the changed properties to take effect.
The infacmd dis UpdateServiceOptions command uses the following syntax:
UpdateServiceOptions

<-DomainName|-dn> domain_name

<-ServiceName|-sn> service_name

<-UserName|-un> user_name

<-Password|-pd> password

[<-SecurityDomain|-sdn> security_domain]

[<-ResilienceTimeout|-re> timeout_period_in_seconds]

[<-Options|-o> options]

[<-NodeName|-nn> node_name | <-GridName|-gn> grid_name]

[<-BackupNodes|-bn> node_name1,node_name2,...]
The following table describes infacmd dis UpdateServiceOptions 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.
-ServiceName
-sn
service_name
Required. Name of the Data Integration Service that the application is deployed to.
-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.
-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. You can set the resilience timeout period with the -re option or the environment variable INFA_CLIENT_RESILIENCE_TIMEOUT. If you set the resilience timeout period with both methods, the -re option takes precedence.
-Options
-o
options
Optional. Enter each option separated by a space. To view options, run the infacmd dis ListServiceOptions command.
-NodeName
-nn
-GridName
-gn
node_name
grid_name
Optional. Enter the node or grid where the Data Integration Service will run. The Data Integration Service can run on a node or grid.
-BackupNodes
-bn
node_name1,node_name2,...
Optional. Nodes on which the service can run if the primary node is unavailable. You can configure backup nodes if you have high availability.

Data Integration Service Options

Use the Data Integration Service options with the infacmd dis UpdateServiceOptions command.
Enter Data Integration Service options in the following format:
... -o option_type.option_name=value
To enter multiple options, separate them with a space. To enter a value that contains a space or other non-alphanumeric character, enclose the value in quotation marks.
The following table describes Data Integration Service options:
Option
Description
LoggingOptions.LogLevel
Level of error messages that the Data Integration Service writes to the Service log. Choose one of the following message levels: Fatal, Error, Warning, Info, Trace, or Debug.
ExecutionOptions.OutOfProcessExecution
Runs jobs in the Data Integration Service process, in separate DTM processes on the local node, or in separate DTM processes on remote nodes. Configure the property based on whether the Data Integration Service runs on a single node or a grid and based on the types of jobs that the service runs.
Enter one of the following options:
  • - IN_PROCESS. Runs jobs in the Data Integration Service process. Configure when you run SQL data service and web service jobs on a single node or on a grid where each node has both the service and compute roles.
  • - OUT_OF_PROCESS. Runs jobs in separate DTM processes on the local node. Configure when you run mapping, profile, and workflow jobs on a single node or on a grid where each node has both the service and compute roles.
  • - OUT_OF_PROCESS_REMOTE. Runs jobs in separate DTM processes on remote nodes. Configure when you run mapping, profile, and workflow jobs on a grid where nodes can have a different combination of roles. If you configure this option when the Data Integration Service runs on a single node, then the service runs jobs in separate local processes.
Default is OUT_OF_PROCESS.
ExecutionOptions.MaxHadoopBatchExecutionPoolSize
Maximum number of deployed jobs that can run concurrently in the Hadoop environment. The Data Integration Service moves Hadoop jobs from the queue to the Hadoop job pool when enough resources are available. Default is 100.
ExecutionOptions.MaxNativeBatchExecutionPoolSize
Maximum number of deployed jobs that can run concurrently in the native environment. The Data Integration Service moves native mapping jobs from the queue to the native job pool when enough resources are available. Default is 10.
ExecutionOptions.MaxOnDemandExecutionPoolSize
Maximum number of on-demand jobs that can run concurrently. Jobs include data previews, profiling jobs, REST and SQL queries, web service requests, and mappings run from the Developer tool. The Data Integration Service immediately runs on-demand jobs if enough resources are available. Otherwise, the Data Integration Service rejects the job. Default is 10.
ExecutionOptions.MaxMemorySize
Maximum amount of memory, in bytes, that the Data Integration Service can allocate for running all requests concurrently when the service runs jobs in the Data Integration Service process. When the Data Integration Service runs jobs in separate local or remote processes, the service ignores this value. If you do not want to limit the amount of memory the Data Integration Service can allocate, set this property to 0.
If the value is greater than 0, the Data Integration Service uses the property to calculate the maximum total memory allowed for running all requests concurrently. The Data Integration Service calculates the maximum total memory as follows:
Maximum Memory Size + Maximum Heap Size + memory required for loading program components
Default is 0.
Note: If you run profiles or data quality mappings, set this property to 0.
ExecutionOptions.MaxMappingParallelism
Maximum number of parallel threads that process a single mapping pipeline stage.
When you set the value greater than one, the Data Integration Service enables partitioning for mappings and for mappings converted from profiles. The service dynamically scales the number of partitions for a mapping pipeline at run time. Increase the value based on the number of CPUs available on the nodes where mappings run.
In the Developer tool, developers can change the maximum parallelism value for each mapping. When maximum parallelism is set for both the Data Integration Service and the mapping, the Data Integration Service uses the minimum value when it runs the mapping.
Default is 1. Maximum is 64.
ExecutionOptions.DisHadoopPrincipal
Service Principal Name (SPN) of the Data Integration Service to connect to a Hadoop cluster that uses Kerberos authentication.
ExecutionOptions.DisHadoopKeytab
The file path to the Kerberos keytab file on the machine on which the Data Integration Service runs.
ExecutionOptions.TemporaryDirectories
Directory for temporary files created when jobs are run. Default is <home directory>/disTemp.
Enter a list of directories separated by semicolons to optimize performance during profile operations and during cache partitioning for Sorter transformations.
You cannot use the following characters in the directory path:
* ? < > " | , [ ]
ExecutionOptions.DISHomeDirectory
Root directory accessible by the node. This is the root directory for other service directories. Default is <Informatica installation directory>/tomcat/bin. If you change the default value, verify that the directory exists.
You cannot use the following characters in the directory path:
* ? < > " | ,
ExecutionOptions.CacheDirectory
Directory for index and data cache files for transformations. Default is <home directory>/cache.
Enter a list of directories separated by semicolons to increase performance during cache partitioning for Aggregator, Joiner, or Rank transformations.
You cannot use the following characters in the directory path:
* ? < > " | ,
ExecutionOptions.SourceDirectory
Directory for source flat files used in a mapping. Default is <home directory>/source.
If the Data Integration Service runs on a grid, you can use a shared directory to create one directory for source files. If you configure a different directory for each node with the compute role, ensure that the source files are consistent among all source directories.
You cannot use the following characters in the directory path:
* ? < > " | ,
ExecutionOptions.TargetDirectory
Default directory for target flat files used in a mapping. Default is <home directory>/target.
Enter a list of directories separated by semicolons to increase performance when multiple partitions write to the flat file target.
If the Data Integration Service runs on a grid, you can use a shared directory to create one directory for target files. If you configure a different directory for each node with the compute role, ensure that the target files are consistent among all target directories.
You cannot use the following characters in the directory path:
* ? < > " | ,
ExecutionOptions.RejectFilesDirectory
Directory for reject files. Reject files contain rows that were rejected when running a mapping. Default is <home directory>/reject.
You cannot use the following characters in the directory path:
* ? < > " | ,
ExecutionOptions.EnableOSProfile
Indicates that the Data Integration Service can use operating system profiles for mapping execution. You can enable operating system profiles if the Data Integration Service runs on UNIX or Linux.
Default is false.
ExecutionOptions.HadoopInfaHomeDir
The PowerCenter Big Data Edition home directory on every data node created by the Hadoop RPM install. Type /<PowerCenterBigDataEditionInstallationDirectory>/Informatica.
ExecutionOptions.HadoopDistributionDir
The directory containing a collection of Hive and Hadoop JARS on the cluster from the RPM Install locations. The directory contains the minimum set of JARS required to process Informatica mappings in a Hadoop environment. Type /<PowerCenterBigDataEditionInstallationDirectory>/Informatica/services/shared/hadoop/[Hadoop_distribution_name].
ExecutionOptions.DisHadoopDistributionDir
The Hadoop distribution directory on the Data Integration Service node. The contents of the Data Integration Service Hadoop distribution directory must be identical to Hadoop distribution directory on the data nodes. Type <Informatica Installation directory/Informatica/services/shared/hadoop/[Hadoop_distribution_name].
RepositoryOptions.RepositoryServiceName
Service that stores run-time metadata required to run mappings and SQL data services.
RepositoryOptions.RepositoryUserName
User name to access the Model repository. The user must have the Create Project privilege for the Model Repository Service.
RepositoryOptions.RepositoryPassword
User password to access the Model repository.
RepositoryOptions.RepositorySecurityDomain
LDAP security domain name if you are using LDAP. If you are not using LDAP the default domain is native.
DataObjectCacheOptions.CacheRemovalTime
The number of milliseconds the Data Integration Service waits before cleaning up cache storage after a refresh. Default is 3,600,000.
DataObjectCacheOptions.CacheConnection
The database connection name for the database that stores the data object cache. Enter a valid connection object name.
DataObjectCacheOptions.MaxConcurrentRefreshRequests
Maximum number of cache refreshes that can occur at the same time.
DataObjectCacheOptions.EnableNestedLDOCache
Indicates that the Data Integration Service can use cache data for a logical data object used as a source or a lookup in another logical data object during a cache refresh. If false, the Data Integration Service accesses the source resources even if you enabled caching for the logical data object used as a source or a lookup.
For example, logical data object LDO3 joins data from logical data objects LDO1 and LDO2. A developer creates a mapping that uses LDO3 as the input and includes the mapping in an application. You enable caching for LDO1, LDO2, and LDO3. If you enable nested logical data object caching, the Data Integration Service uses cache data for LDO1 and LDO2 when it refreshes the cache table for LDO3. If you do not enable nested logical data object caching, the Data Integration Service accesses the source resources for LDO1 and LDO2 when it refreshes the cache table for LDO3.
Default is false.
DeploymentOptions.DefaultDeploymentMode
Determines whether to enable and start each application after you deploy it to a Data Integration Service.
Enter one of the following options:
  • - EnableandStart. Enable the application and start the application.
  • - EnableOnly. Enable the application but do not start the application.
  • - Disable. Do not enable the application.
PassThroughSecurityOptions.AllowCaching
Allows data object caching for all pass-through connections in the Data Integration Service. Populates data object cache using the credentials in the connection object.
Note: When you enable data object caching with pass-through security, you might allow unauthorized access to some data.
HttpProxyServerOptions.HttpProxyServerHost
Name of the HTTP proxy server.
HttpProxyServerOptions.HttpProxyServerPort
Port number of the HTTP proxy server.
Default is 8080.
HttpProxyServerOptions.HttpServerUser
Authenticated user name for the HTTP proxy server. This is required if the proxy server requires authentication.
HttpProxyServerOptions.HttpProxyServerPassword
Password for the authenticated user. The Service Manager encrypts the password. This is required if the proxy server requires authentication.
HttpProxyServerOptions.HttpProxyServerDomain
Domain for authentication.
HttpConfigurationOptions.AllowedIPAddresses
List of constants or Java regular expression patterns compared to the IP address of the requesting machine. Use a space to separate multiple constants or expressions.
If you configure this property, the Data Integration Service accepts requests from IP addresses that match the allowed address pattern. If you do not configure this property, the Data Integration Service uses the Denied IP Addresses property to determine which clients can send requests.
HttpConfigurationOptions.AllowedHostNames
List of constants or Java regular expression patterns compared to the host name of the requesting machine. The host names are case sensitive. Use a space to separate multiple constants or expressions.
If you configure this property, the Data Integration Service accepts requests from host names that match the allowed host name pattern. If you do not configure this property, the Data Integration Service uses the Denied Host Names property to determine which clients can send requests.
HttpConfigurationOptions.DeniedIPAddresses
List of constants or Java regular expression patterns compared to the IP address of the requesting machine. Use a space to separate multiple constants or expressions.
If you configure this property, the Data Integration Service accepts requests from IP addresses that do not match the denied IP address pattern. If you do not configure this property, the Data Integration Service uses the Allowed IP Addresses property to determine which clients can send requests.
HttpConfigurationOptions.DeniedHostNames
List of constants or Java regular expression patterns compared to the host name of the requesting machine. The host names are case sensitive. Use a space to separate multiple constants or expressions.
If you configure this property, the Data Integration Service accepts requests from host names that do not match the denied host name pattern. If you do not configure this property, the Data Integration Service uses the Allowed Host Names property to determine which clients can send requests.
HttpConfigurationOptions.HTTPProtocolType
Security protocol that the Data Integration Service uses. Enter one of the following values:
  • - HTTP. Requests to the service must use an HTTP URL.
  • - HTTPS. Requests to the service must use an HTTPS URL.
  • - Both. Requests to the service can use either an HTTP or an HTTPS URL.
When you set the HTTP protocol type to HTTPS or Both, you enable Transport Layer Security (TLS) for the service.
You can also enable TLS for each web service deployed to an application. When you enable HTTPS for the Data Integration Service and enable TLS for the web service, the web service uses an HTTPS URL. When you enable HTTPS for the Data Integration Service and do not enable TLS for the web service, the web service can use an HTTP URL or an HTTPS URL. If you enable TLS for a web service and do not enable HTTPS for the Data Integration Service, the web service does not start.
Default is HTTP.
ResultSetCacheOptions.FileNamePrefix
The prefix for the names of all result set cache files stored on disk. Default is RSCACHE.
ResultSetCacheOptions.EnableEncryption
Indicates whether result set cache files are encrypted using 128-bit AES encryption. Valid values are true or false. Default is true.
MappingServiceOptions.MaxNotificationThreadPoolSize
Allocates the number of threads that send notifications to the client.
MappingServiceOptions.MaxMemPerRequest
The behavior of Maximum Memory Per Request depends on the following Data Integration Service configurations:
  • - The service runs jobs in separate local or remote processes, or the service property Maximum Memory Size is 0 (default).
  • Maximum Memory Per Request is the maximum amount of memory, in bytes, that the Data Integration Service can allocate to all transformations that use auto cache mode in a single request. The service allocates memory separately to transformations that have a specific cache size. The total memory used by the request can exceed the value of Maximum Memory Per Request.
  • - The service runs jobs in the Data Integration Service process, and the service property Maximum Memory Size is greater than 0.
  • Maximum Memory Per Request is the maximum amount of memory, in bytes, that the Data Integration Service can allocate to a single request. The total memory used by the request cannot exceed the value of Maximum Memory Per Request.
Default is 536,870,912.
ProfilingServiceOptions.ProfileWarehouseConnectionName
Connection object name for the connection to the profiling warehouse.
ProfilingServiceOptions.MaxRanks
Number of minimum and maximum values to display for a profile. Default is 5. Default is 10.
ProfilingServiceOptions.MaxPatterns
Maximum number of patterns to display for a profile.
ProfilingServiceOptions.MaxProfileExecutionPoolSize
Maximum number of threads to run profiling.
ProfilingServiceOptions.MaxExecutionConnections
Maximum number of database connections for each profiling job.
ProfilingServiceOptions.ExportPath
Location to export profile results. Enter the file system path. Default is ./ProfileExport.
AdvancedProfilingServiceOptions.MinPatternFrequency
Minimum number of patterns to display for a profile.
AdvancedProfilingServiceOptions.MaxValueFrequencyPairs
Maximum number of value/frequency pairs to store in the profiling warehouse. Default is 16,000.
AdvancedProfilingServiceOptions.MaxStringLength
Maximum length of a string that the profiling service can process.
AdvancedProfilingServiceOptions.MaxNumericPrecision
Maximum number of digits for a numeric value.
AdvancedProfilingServiceOptions.ExecutionPoolSize
Maximum number of threads to run mappings.
AdvancedProfilingServiceOptions.ColumnsPerMapping
Limits the number of columns that can be profiled in a single mapping due to save memory and disk space. Default is 5. If you profile a source with over 100 million rows decrease the value to as low as 1.
AdvancedProfilingServiceOptions.MaxParallelColumnBatches
Number of threads that can run mappings at the same time. Default is 1.
AdvancedProfilingServiceOptions.ValueFrequencyMemSize
Amount of memory to allow for value-frequency pairs. Default is 64 megabytes.
AdvancedProfilingServiceOptions.ReservedThreads
Number of threads of the Maximum Execution Pool Size that are for priority requests. Default is 1.
AdvancedProfilingServiceOptions.MaxMemPerRequest
Maximum amount of memory, in bytes, that the Data Integration Service can allocate for each mapping run for a single profile request.
Default is 536,870,912.
SQLServiceOptions.DTMKeepAliveTime
Number of milliseconds that the DTM process stays open after it completes the last request. Identical SQL queries can reuse the open process. Use the keepalive time to increase performance when the time required to process the SQL query is small compared to the initialization time for the DTM process. If the query fails, the DTM process terminates. Must be greater than or equal to 0. 0 means that the Data Integration Service does not keep the DTM process in memory. Default is 0.
You can also set this property for each SQL data service that is deployed to the Data Integration Service. If you set this property for a deployed SQL data service, the value for the deployed SQL data service overrides the value you set for the Data Integration Service.
SQLServiceOptions.TableStorageConnection
Relational database connection that stores temporary tables for SQL data services. By default, no connection is selected.
SQLServiceOptions.SkipLogFiles
Prevents the Data Integration Service from generating log files when the SQL data service request completes successfully and the tracing level is set to INFO or higher. Default is false.
SQLServiceOptions.MaxMemPerRequest
The behavior of Maximum Memory Per Request depends on the following Data Integration Service configurations:
  • - The service runs jobs in separate local or remote processes, or the service property Maximum Memory Size is 0 (default).
  • Maximum Memory Per Request is the maximum amount of memory, in bytes, that the Data Integration Service can allocate to all transformations that use auto cache mode in a single request. The service allocates memory separately to transformations that have a specific cache size. The total memory used by the request can exceed the value of Maximum Memory Per Request.
  • - The service runs jobs in the Data Integration Service process, and the service property Maximum Memory Size is greater than 0.
  • Maximum Memory Per Request is the maximum amount of memory, in bytes, that the Data Integration Service can allocate to a single request. The total memory used by the request cannot exceed the value of Maximum Memory Per Request.
Default is 50,000,000.
WorkflowOrchestrationServiceOptions.DBName
Connection name of the database that stores run-time metadata for workflows.
WorkflowOrchestrationServiceOptions.MaxWorkerThreads
The maximum number of threads that the Data Integration Service can use to run parallel tasks between a pair of inclusive gateways in a workflow. The default value is 10.
If the number of tasks between the inclusive gateways is greater than the maximum value, the Data Integration Service runs the tasks in batches that the value specifies. For example, if the Maximum Worker Threads value is 10, the Data Integration Service runs the tasks in batches of ten.
WSServiceOptions.DTMKeepAliveTime
Number of milliseconds that the DTM process stays open after it completes the last request. Web service requests that are issued against the same operation can reuse the open process. Use the keepalive time to increase performance when the time required to process the request is small compared to the initialization time for the DTM process. If the request fails, the DTM process terminates. Must be greater than or equal to 0. 0 means that the Data Integration Service does not keep the DTM process in memory. Default is 5000.
You can also set this property for each web service that is deployed to the Data Integration Service. If you set this property for a deployed web service, the value for the deployed web service overrides the value you set for the Data Integration Service.
WSServiceOptions.WSDLLogicalURL
Prefix for the WSDL URL if you use an external HTTP load balancer. For example,
http://loadbalancer:8080
The Data Integration Service requires an external HTTP load balancer to run a web service on a grid. If you run the Data Integration Service on a single node, you do not need to specify the logical URL.
WSServiceOptions.SkipLogFiles
Prevents the Data Integration Service from generating log files when the web service request completes successfully and the tracing level is set to INFO or higher. Default is false.
WSServiceOptions.MaxMemPerRequest
The behavior of Maximum Memory Per Request depends on the following Data Integration Service configurations:
  • - The service runs jobs in separate local or remote processes, or the service property Maximum Memory Size is 0 (default).
  • Maximum Memory Per Request is the maximum amount of memory, in bytes, that the Data Integration Service can allocate to all transformations that use auto cache mode in a single request. The service allocates memory separately to transformations that have a specific cache size. The total memory used by the request can exceed the value of Maximum Memory Per Request.
  • - The service runs jobs in the Data Integration Service process, and the service property Maximum Memory Size is greater than 0.
  • Maximum Memory Per Request is the maximum amount of memory, in bytes, that the Data Integration Service can allocate to a single request. The total memory used by the request cannot exceed the value of Maximum Memory Per Request.
Default is 50,000,000.
Modules.MappingService
Enter false to disable the module that runs mappings and previews. Default is true.
Modules.ProfilingService
Enter false to disable the module that runs profiles and generates scorecards. Default is true.
Modules.SQLService
Enter false to disable the module that runs SQL queries against a SQL data service. Default is true.
Modules.WebService
Enter false to disable the module that runs web service operation mappings. Default is true.
Modules.WorkflowOrchestrationService
Enter false to disable the module that runs workflows. Default is true.