Table of Contents


  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 autotune Command Reference
  10. Infacmd bg Command Reference
  11. infacmd ccps Command Reference
  12. infacmd cluster Command Reference
  13. infacmd cms Command Reference
  14. infacmd dis Command Reference
  15. Infacmd dis Queries
  16. infacmd dp Command Reference
  17. infacmd idp Command Reference
  18. infacmd edp Command Reference
  19. Infacmd es Command Reference
  20. infacmd ics Command Reference
  21. infacmd ipc Command Reference
  22. infacmd isp Command Reference
  23. infacmd ldm Command Reference
  24. infacmd mas Command Reference
  25. infacmd mi Command Reference
  26. infacmd mrs Command Reference
  27. infacmd ms Command Reference
  28. infacmd oie Command Reference
  29. infacmd ps Command Reference
  30. infacmd pwx Command Reference
  31. infacmd roh Command Reference
  32. infacmd rms Command Reference
  33. infacmd rtm Command Reference
  34. infacmd sch Command Reference
  35. infacmd search Command Reference
  36. infacmd sql Command Reference
  37. infacmd tdm Command Reference
  38. infacmd tools Command Reference
  39. infacmd wfs Command Reference
  40. infacmd ws Command Reference
  41. infacmd xrf Command Reference
  42. infacmd Control Files
  43. infasetup Command Reference
  44. pmcmd Command Reference
  45. pmrep Command Reference
  46. Working with filemanager
  47. Working with pmrep Files



Updates metadata for a gateway node on the current machine. Before you update the gateway node, run the infacmd isp ShutDownNode command to shut down the node.
The UpgradeGatewayNodeMetadata command uses the following syntax:
UpdateGatewayNode [<-LogServiceDirectory|-ld> log_service_directory (used for GatewayNode only)] [<-SystemLogDirectory|-sld> system_log_directory] [<-HttpsPort|-hs> https_port] [<-KeystoreFile|-kf> keystore_file_location] [<-KeystorePass|-kp> keystore_password] <<-DatabaseAddress|-da> database_hostname:database_port|<-DatabaseConnectionString|-cs> database_connection_string> [<-DatabaseUserName|-du> database_user_name] [<-DatabasePassword|-dp> database_password] <-DatabaseType|-dt> database_type ORACLE|DB2|MSSQLSERVER|SYBASE|POSTGRESQL [<-DatabaseServiceName|-ds> database_service_name] [<-Tablespace|-ts> tablespace_name] [<-SchemaName|-sc> schema_name (used for MSSQLServer and PostgreSQL only)] [<-TrustedConnection|-tc> trusted_connection (used for MSSQLServer only)] <-PreviousInfaHome|-ph> previous_infa_home [<-KeysDirectory|-kd> Infa_secrets_directory_location] [<-DatabaseTlsEnabled|-dbtls> database_tls_enabled] [<-DatabaseTruststorePassword|-dbtp> database_truststore_password] [<-DatabaseTruststoreLocation|-dbtl> database_truststore_location]
The following table describes
UpgradeGatewayNodeMetadata options and arguments:
Required. Shared directory path used by the Log Manager to store log event files. Verify that -ld does not match or contain the specified -sld value.
Optional. Directory path to store system log files. Verify that -ld does not match or contain the specified -sld value. Default is <INFA_home>/logs.
Optional. Port number that the node uses for communication between the Administrator tool and the Service Manager. Set this port number if you want to configure HTTPS for a node.
To disable HTTPS support for a node, set this port number to zero.
Optional. Keystore file that contains the keys and certificates required if you use the SSL security protocol.
Optional. A plain-text password for the keystore file. You can set a password with the -kp option or the environment variable INFA_PASSWORD. If you set a password with both methods, the password set with the -kp option takes precedence.
Required if you do not use -DatabaseConnectionString (-cs) option. Name and port number of the machine hosting the domain configuration database.
Required if you do not use -DatabaseAddress (-da) and -DatabaseServiceName (-ds) options. Connection string used to connect to the domain configuration database. Specify the database host, database port, and the database service name as part of the connection string. Enclose the connection string in quotes.
Required if you do not use -TrustedConnection (-tc) option. Account for the database containing the domain configuration information.
Domain configuration database password corresponding to the database user. If you omit this option,
uses the password specified in the INFA_DEFAULT_DATABASE_PASSWORD environment variable. If no value is specified in the environment variable, you must enter a password using this option.
Required. Type of database that stores the domain configuration metadata. Database types include:
  • db2
  • oracle
  • mssqlserver
  • sybase
  • postgresql
Required if you do not use -DatabaseConnectionString (-cs) option. The database service name. Required for Oracle, IBM DB2, and Microsoft SQL Server databases. Enter the SID for Oracle, the service name for IBM DB2, or the database name for Microsoft SQL Server.
Required for an IBM DB2 database. Name of the tablespace where the domain configuration database tables reside.
Optional. Name of the Microsoft SQL Server schema. Enter a schema name if you are not using the default schema.
Optional. Connect to the Microsoft SQL Server database through a trusted connection. Trusted authentication uses the Windows security credentials of the current user to connect to Microsoft SQL Server.
Required. Path to the previous Informatica home directory.
Optional. Directory where all keytab files and the encryption key for the Informatica domain are stored. Default is
Optional. Indicates whether the Informatica domain database is secure with TLS or SSL. Set this option to True for the secure database. Default is false. If you specify the ‑dbtls option without a value, the Informatica domain uses secure communication to the Informatica domain database.
Optional. Password for the database truststore file for the secure database.
Optional. Path and file name of the truststore file for the gateway node.

Updated May 05, 2021