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