This page describes how to import and export zone, collector, and other types of configurations via Asset Manager’s graphical user (GUI), Command-Line (CLI) and application programming (API) interfaces. This is one way you can back up your valuable settings. After importing a configuration, be sure to check your interface settings.
A variety of configuration types can be successfully imported from either the Settings menu or the Admin menu:
Import from Settings Menu | Import from Admin Menu |
---|---|
|
|
Importing Configurations via the Settings Menu
- Browse to Settings > Support Tools > Import/Export System.
- Select a system configuration file on your local computer to import.
- Click Import.
The configuration imports. Stay on the web page while the import takes place to avoid disrupting the import process.
If you see the message "Not all remote systems could be imported. Collector interface, OSPF and leak configuration could be affected. Other components were successfully imported" this is likely due to remote systems being unreachable and hence not imported. Please check your configuration and verify your remote systems settings (Settings=>Asset Manager Systems). - Review the imported collector configurations in Settings > Zones > Zone Collectors and edit as needed.
Be sure to check the interface of any leak scout you've set up. See About Importing Leak Path Configurations for the procedure. - Reset collector interfaces:
- Browse to Settings > Zones.
- Select a zone name.
- Select a collector name.
- Click Edit to update a collector.
- Select an option from the Interface dropdown list.
- Enable the imported collectors.
- Select a collector name.
- Select a discovery-type tab (e.g., BGP, Path, Host)
- Click Edit to update the discovery type.
- Select the Enable checkbox to enable that type of discovery.
- Reset the passwords of imported user accounts. Existing user accounts are maintained.
- Browse to Settings > Users.
- Select a username requiring a password reset.
- Click Edit User.
- Update the Password and Confirm Password fields.
- Click Update to save your changes.
- Renew the subscription to imported notifications and reset the priority-level for each. The default notification settings are maintained. The system does not accept imported changes to the default notifications settings.
- Browse to Settings > Notifications.
- Select the Systems tab and an event type.
- Update your preferences.
- Click Update.
Repeat this update for other system event types, as needed. - Select the Devices tab and an event type.
- Update your preferences.
- Click Update.
Repeat this update for other device event types, as needed.
Importing Configurations via the Admin Menu
- On the Asset Manager GUI, browse to Admin > Settings > Import.
- Select a report, dashboard, or widget DDL configuration file from your local computer to import.
- Click Import Metadata.
The configuration imports.
Importing a Collector Configuration via CLI
- To import/restore configuration from a remote system, run:
system configuration import username@hostname:<path to file>
- To import/restore configuration from the local system, run:
system configuration import <path to file
Importing via API
Import a configuration as follows:
- Run the following curl command, replacing <exported configuration file name> with the full path of the exported configuration file name and replacing <Asset Manager-system> with the IP Address or DNS name of your Asset Manager box.
curl -k -u admin -d @<exported configuration file name> -H 'Content-Type: application/xml' 'https://<Asset Manager-system>/api/rest/config/import'
The import should complete successfully.
If, however, you encounter the following error, it means that the remote systems to which you wanted to connect were unreachable and hence not imported. To resolve, check your configuration and verify your remote systems (Settings=>Asset Manager Systems).
Not all remote systems could be imported. Collector interface, OSPF and leak configuration could be affected. Other components were successfully imported.</message><type>ApplicationException</type><detail>com.Asset Manager.api.core.client.exception.ApplicationException: Difficulty importing configuration:
Not all remote systems could be imported. Collector interface, OSPF and leak configuration could be affected. Other components were successfully imported.
This section describes how to export zone, collector, and other types of configurations via Asset Manager’s graphical user (GUI) and application programming (API) interfaces. When exporting data from one Command Center to another, user passwords are not preserved and must be reset at the new Command Center. Exporting Configurations via the Settings Menu
The following configuration types export:
The export file opens in a new tab on your preferred browser. Exporting Configurations via the Admin Menu
Exporting a Collector Configuration via CLI
system configuration export username@hostname:<path to file>s
ystem configuration export <path to file>
Exporting via API
https://<CC IP Address>/api/rest/config/export
After an Import
Collector configuration and Leak Path configuration are disabled upon import. This is by design to ensure that you first check the interface used by collectors and reset them, if necessary, to the ones you intend to use.
To check your the interface setting for a selected Collector:
- Navigate to Settings > Zones > Zone Collectors for your selected Zone.
- Click Edit > Interface.
- Select your preferred interface option from the dropdown.
- Enable the collector.
Leak Path Interface
To check your the interface setting for a selected Leak Path Collector:
- Navigate to Settings > Zones and select a Collector for which Leak Path is enabled.
- Select Zone Collectors > Edit.
Select your preferred interface option from the dropdown and enable the Leak Path collector.