Command Reference > infasetup Command Reference > BackupDomain
  

BackupDomain

Backs up the configuration metadata for the domain. infasetup stores the backup domain metadata in a backup file with an extension of .mrep.
You must shut down the domain before you run this command.
When you run this command, infasetup backs up the domain configuration database tables to restore the domain to another database. You must back up the ISP_RUN_LOG table contents manually 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 BackupDomain command uses the following syntax:
BackupDomain

<<-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> overwrite_file]

[<-Tablespace|-ts> tablespace_name]

[<-SchemaName|-sc> schema_name (used for Microsoft SQL Server only)]

<-DomainName|-dn> domain_name

[<-DatabaseTlsEnabled|-dbtls> database_tls_enabled]

[<-DatabaseTruststorePassword|-dbtp> database_truststore_password]

[<-TrustedConnection|-tc> trusted_connection (used for Microsoft SQL Server only)]

[<-EncryptionKeyLocation|-kl> encryption_key_location]

[<-DatabaseTruststoreLocation|-dbtl> database_truststore_location]
The following table describes infasetup BackupDomain 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
-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 backup file if a file with the same name already exists.
-DomainName
-dn
domain_name
Required. Name of the domain.
-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 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
Directory that contains the current encryption key. The name of the encryption file is sitekey.
-DatabaseTruststoreLocation
-dbtl
database_truststore_location
Path and file name of the truststore file for the secure domain repository database. Required if you configure a secure domain repository database for the domain.