PingAM

Export configuration data

Amster can export configuration data from an AM instance. Export configuration data using the export-config command.

The exported configuration data is written to a number of JSON-formatted files. The files are arranged in a hierarchy of global and realm configuration data.

To export encrypted password values in the configuration files you must generate and install a transport key. Learn more in Create transport keys to export configuration data.

Usage:

am> export-config --path Path [options]
--path Path

The path to the directory where Amster should save the exported configuration files.

Existing files are overwritten if they exist. The path is created if it doesn’t exist.

Options:

--realms "Realm" […​]

Space-separated list of realms to export. Specify the full path of each realm, and enclose the list in quotation marks. Use a single forward-slash (/) to represent the top-level root realm.

Example: export-config --realms "/ /subRealm1 /subRealm2"

Default: all

--realmEntities Entity […​]

Space-separated list of realm-based entities to export.

Use a space character in single-quotes (' ') to exclude realm-based entities from the export.

Find a list of the available entities in the Entity reference.

Default: all

--globalEntities Entity […​]

Space-separated list of global entities to export.

Use a space character in single-quotes (' ') to exclude global entities from the export.

Find a list of the available entities in the Entity reference.

Default: all

--failOnError [true|false]

If specified, the export process stops if an error occurs.

Default: false

--listPasswords [true|false]

If specified, the export process creates a listing of entities that contain password data. The listing is stored in a file in the root of the specified export directory.

Default: false

Examples

Before trying the following examples, start the Amster command-line interface, and connect to the AM instance from which to export data.

Find information on connecting to AM instances in Connect to AM.

Export entire configuration

This example exports all configuration data, and fails immediately if an error occurs.

am> export-config --path /tmp/myExportedConfigFiles --failOnError true
Export completed successfully

Export selected configuration

This example exports the configuration for the DataStoreDecision, Scripts, and OAuth2Provider entities in a subrealm of the root realm named mySubRealm.

Configuration data for global entities isn’t exported.

am> export-config --path /tmp/myExportedConfigFiles --realms '/mySubRealm' \
  --realmEntities 'DataStoreDecision Scripts OAuth2Provider' --globalEntities ' '
Export completed successfully