Command Reference > infacmd mas Command Reference > UpdateServiceOptions
  

UpdateServiceOptions

Updates Metadata Access Service properties. To view current properties run the infacmd mas 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 mas UpdateServiceOptions command uses the following syntax:
UpdateServiceOptions

<-DomainName|-dn> DomainName

<-UserName|-un> Username

<-Password|-pd> Password

<-ServiceName|-sn> ServiceName

[<-SecurityDomain|-sdn> SecurityDomain]

[<-ResilienceTimeout|-re> ResilienceTimeout]

[<-Options|-o> options]

<-PrimaryNode|-nn> PrimaryNodeName

[<-BackupNodes|-bn> node_name1,node_name2,...]

[<-SearchIndexRoot|-si> SearchIndexRoot]
The following table describes infacmd mas 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.
-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.
-ServiceName
-sn
service_name
Required. Name of the Metadata Access Service that the application is deployed to.
-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 mas ListServiceOptions command.
-PrimaryNode
-nn
node_name
Enter the node where the Metadata Access Service will run. The Metadata Access Service can run only on a node.
-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.
-SearchIndexRoot
-si
search_index_root
Optional. Changes the directory for the search index. Enter the full path to the directory. Default is the Informatica installation directory.

Metadata Access Service Options

Use the Metadata Access Service options with the infacmd mas UpdateServiceOptions command.
Enter Metadata Access 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 Metadata Access Service options:
Option
Description
ExecutionContextOptions.HadoopDistribution
The Hadoop distribution directory on the Metadata Access Service node. The contents of the Metadata Access 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].
HttpConfigurationOptions.HTTPProtocolType
Security protocol that the Metadata Access 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.
When you set the HTTP protocol type to HTTPS, you enable Transport Layer Security (TLS) for the service.
Default is HTTP.
MASProperties.EnableOSProfile
Flag to indicate if the Metadata Access Service can use operating system profiles for metadata preview. Default is false.
MASProperties.HadoopKeytab
The file path to the Kerberos keytab file on the machine on which the Metadata Access Service runs.
Not applicable for the MapR distribution.
MASProperties.HadoopPrincipal
Service Principal Name (SPN) of the Metadata Access Service to connect to a Hadoop cluster that uses Kerberos authentication.
Not applicable for the MapR distribution.
MASProperties.LoggedInUserAsImperUser
Required if the Hadoop cluster uses Kerberos authentication.