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

RestoreDomain

RestoreDomain

Restores the configuration metadata for the domain from a backup .mrep file. If you have a backup file from an earlier version of Informatica, you must use the earlier version to restore the domain.
You must shut down the domain before you run this command.
If you restore the domain into a database other than the original backup database, you must restore the ISP_RUN_LOG table contents to get the previous workflow and session logs.
If the command fails with a Java memory error, increase the system memory available for infasetup. To increase the system memory, set the -Xmx value in the INFA_JAVA_CMD_OPTS environment variable.
The RestoreDomain command uses the following syntax:
RestoreDomain <<-DatabaseAddress|-da> database_hostname:database_port| <-DatabaseConnectionString|-cs> database_connection_string> [<-DatabaseUserName|-du> database_user_name] [<-DatabasePassword|-dp> database_password] <-DatabaseType|-dt> database_type [<-DatabaseServiceName|-ds> database_service_name] <-BackupFile|-bf> backup_file_name [<-Force|-f>] [<-ClearNodeAssociation|-ca>] [<-Tablespace|-ts> tablespace_name] [<-SchemaName|-sc> schema_name (used for MSSQLServer and PostgreSQL only)] [<-DatabaseTlsEnabled|-dbtls> database_tls_enabled] [<-DatabaseTruststorePassword|-dbtp> database_truststore_password] [<-TrustedConnection|-tc> trusted_connection (used for MSSQLServer only)] [<-EncryptionKeyLocation|-kl> encryption_key_location] [<-DatabaseTruststoreLocation|-dbtl> database_truststore_location]
The following table describes
infasetup
RestoreDomain options and arguments:
Option
Argument
Description
-DatabaseAddress
-da
database_hostname:database_port
Required if you do not use -DatabaseConnectionString (-cs) option. Name and port number of the machine hosting the domain configuration database.
-DatabaseConnectionString
-cs
database_connection_string
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.
-DatabaseUserName
-du
database_user_name
Required if you do not use -TrustedConnection (-tc) option. Account for the database containing the domain configuration information.
-DatabasePassword
-dp
database_password
Domain configuration database password corresponding to the database user. If you omit this option,
infasetup
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.
-DatabaseType
-dt
database_type
Required. Type of database that stores the domain configuration metadata. Database types include:
  • db2
  • oracle
  • mssqlserver
  • sybase
  • postgresql
-DatabaseServiceName
-ds
database_service_name
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.
-BackupFile
-bf
backup_file_name
Required. Name and path for the backup file. If you do not specify a file path,
infasetup
creates the backup file in the current directory.
-Force
-f
-
Optional. Overwrites the database if a database with the same name already exists. Do not include any characters after this option.
-ClearNodeAssociation
-ca
-
Optional. Clears node associations when restoring the domain. For example, a backed up domain contains node “Node1” on machine “MyHost:9090.” If you specify this option, the connection between the node name “Node1” and the address “MyHost:9090” is broken when you restore the domain. You can then associate another node with “MyHost:9090.”
If you do not specify this option, “Node1” retains its connection to “MyHost:9090.” If you restore the domain and associate another node with “MyHost:9090,” the node does not start.
-Tablespace
-ts
tablespace_name
Required for an IBM DB2 database. Name of the tablespace where the domain configuration database tables reside.
-SchemaName
-sc
schema_name
Optional. Name of the Microsoft SQL Server or PostgreSQL schema. Enter a schema name if you are not using the default schema.
-DatabaseTlsEnabled
-dbtls
database_tls_enabled
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.
-DatabaseTruststorePassword
-dbtp
database_truststore_password
Optional. Password for the database truststore file for the secure database.
-TrustedConnection
-tc
-
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.
-EncryptionKeyLocation
-kl
encryption_key_location
Optional. Directory that contains the current encryption key. You must specify the key location if the encryption key does not exist in the isp/config/keys/sitekey file. The name of the encryption file is sitekey.
-DatabaseTruststoreLocation
-dbtl
database_truststore_location
Optional. Path and file name of the truststore file for the secure database. Required if you configure a secure domain repository database for the domain.


Updated October 22, 2020