Restoring Business Directory

TIBCO Data Virtualization® > Business Directory API and System Tables > Backing Up and Restoring Business Directory Information > Restoring Business Directory

You can restore Business Directory metadata (custom properties, catalogs, and other data) by importing a previously exported CAR file. You must know the password that was used to protect the backup file.

To restore Business Directory

1. Select Help > REST API.

A new browser tab opens with a list of REST methods, grouped by what they act on and what they do.

2. Scroll down to the “metadata: System Metadata” group and click “Import full metadata from a file.”

3. Make sure you have the required rights.

4. Type values for required parameters.

5. Copy the cURL command that is the closest to what you think you will need.

6. Open a command window and run the cURL command. See Using cURL Commands to Run the REST API Methods.

Import as Admin user Example

Here is an example of the CURL invocation you would use as the Admin user.

curl -u "admin:admin" -i -F "encryptionPassword=testPassword" -F "overwrite=true" -F "file=@export001.car" -F PUT "https://localhost:9502/rest/v2/metadata"

Import as Admin user, with method override Example

Here is an example of the CURL invocation you would use as the Admin user, using the X-HTTP-Method-Override option. (See Method Overrides.)

curl -u "admin:admin" -i -H "X-HTTP-Method-Override:PUT" -F "encryptionPassword=testPassword" -F "overwrite=true" -F "file=@export001.car" -X POST "https://localhost:9502/rest/v2/metadata"

Import as an LDAP user Example

Here is an example of the CURL invocation you would use as an LDAP user with BD_ADMIN and ACCESS_DIRECTORY rights.

curl -u "user@ldapDomain:password" -i -F "encryptionPassword=testPassword" -F "overwrite=true" -F "file=@export001.car" -X PUT "https://localhost:9502/rest/v2/metadata"

Import as Admin user (ignoring encryption errors) Example

Here is an example of the CURL invocation you would use as the Admin user (ignoring the encryption errors)

curl -u "admin:admin" -i -F "encryptionPassword=testPassword" -F "overwrite=true" -F "ignoreEncryption=true" -F "file=@export001.car" -X PUT "https://localhost:9502/rest/v2/metadata"

Note: If -ignoreEncyption option is used, then all backup data will be imported regardless of whether a valid encryption key was provided. This means that the import will not fail. This option can be used to allow partially importing any backed up data. However, the import process will only import data that is not encrypted or can be decrypted using the provided encryption key. All encrypted portions of the backup data that cannot be decrypted will be imported as empty values and the import will otherwise succeed.

This affects all encrypted values in the backup data, which includes, but is not limited to data source and LDAP domain connection passwords.