Set Up Device Configuration File Management
- Make Sure Devices Are Configured Correctly
- Control How Archiving is Triggered
- Set Up Event-Triggered Archiving
- Specify Items to Be Excluded When Configuration Files Are Checked for Changes
- Control the Timeouts for Configuration Archive Operations
- Control How Often the Archive Summary Is Updated
- Control How Many Files Can Be Archived In Parallel
- Control Whether Configuration File Content Is Masked During Exports
- Control When Device Configuration Files are Purged from the Database
Make Sure Devices Are Configured Correctly
Before you start using the Configuration Archive features, make sure devices are configured according to the settings in Configure Devices So They Can Be Modeled and Monitored.
Control How Archiving is Triggered
By default, Cisco EPN Manager saves device configuration files to the archive when:
-
A new device is added to Cisco EPN Manager
-
When a device change notification is received
Users with Administrator privileges can change those settings.
Procedure
Step 1 |
Choose , then choose . |
||||||||
Step 2 |
Adjust the archiving settings depending on the following criteria.
|
||||||||
Step 3 |
To schedule regular archiving for groups of devices (or single devices): |
Set Up Event-Triggered Archiving
By default, Cisco EPN Manager backs up a device’s configuration file whenever it receives a change notification event. This function will work only if devices are configured properly; see How Is Inventory Collected? For example, for devices running Cisco IOS XR and Cisco IOS XE, the following setting must be configured:
logging server-IP
When Cisco EPN Manager receives a configuration change event, it waits 10 minutes (by default) before archiving in case more configuration change events are received. This prevents multiple collection processes from running at the same time. To check or change this setting, choose , then choose and adjust the Hold Off Timer.
Note |
The Hold Off Timer may be set to a shorter period for certain events, called expedited events. For more information, see Change the Behavior of Expedited Events. |
To turn off event-triggered archiving, choose Archive configuration on receiving configuration change events? check box.
, then choose and uncheck theSpecify Items to Be Excluded When Configuration Files Are Checked for Changes
Some lines in device configuration files should be excluded when Cisco EPN Manager compares different versions to identify changes. Cisco EPN Manager excludes some lines by default, such as clock settings for routers and switches. If you have Administrator privileges, you can check which lines are excluded, and add more lines to be excluded.
Procedure
Step 1 |
Choose , then choose . |
Step 2 |
Click the Advanced tab. |
Step 3 |
In the Product Family list, choose the devices or groups to which you want to apply the command exclusions. |
Step 4 |
In the Command Exclude List, enter a comma-separated list of configuration commands you want to exclude for that selection. These are the parameters Cisco EPN Manager will ignore when checking devices for configuration changes. |
Step 5 |
Click Save. |
Control the Timeouts for Configuration Archive Operations
By default, Configuration Archive operations such as archiving, rolling back, and fetching configurations from devices will time out if a device does not respond for 6 minutes (360s). To adjust this setting, choose Timeout field.
, then choose and change the setting in theControl How Often Alarms are Triggered
By default, Cisco EPN Manager saves device configuration files to the archive based on the configured settings. However when these jobs fail, you can choose to generate an alarm notification.
When a Configuration Archive job fails, Cisco EPN Manager waits for 7 days or for more than 5 (by default) configuration files before triggering an alarm. The alarm has information about the cause for the trigger of the alarm and other related details associated with the configuration archives. To change the default settings for how often the alarms are generated, choose , then choose and adjust the Alarm Threshold parameter for maximum number of configuration files (exceeding which an alarm is generated) and the number of days to wait before the alarm is triggered.
Control How Often the Archive Summary Is Updated
When you choose Cisco EPN Manager lists the configuration archives that it has collected. This summary data is updated whenever a new archive is collected. It is also updated by default at least every 30 minutes according to a summary refresh timer. You can change the time setting by choosing , then choose and adjust the Summary refresh hold-off timeSummary refresh Hold off timer.
,Control How Many Files Can Be Archived In Parallel
Cisco EPN Manager uses 10 thread pools for copying configuration files to the archive. A larger number may be helpful when archiving of changes involving more than 1,000 devices; however, making the number too large can negatively impact system performance. To change this number, choose , then choose and adjust the Thread Pool Count value.
Control Whether Configuration File Content Is Masked During Exports
Cisco EPN Manager supports exporting startup and running configuration files to a local file system. By default, the contents of these files are masked when they are exported. To export configuration files, see Export Configuration Files to a Local File System. If you want to change the mask setting, choose Mask security content while exporting option. , then choose and adjust the
Control When Device Configuration Files are Purged from the Database
Device configuration files cannot be automatically deleted from the database (you can manually delete the files); they can be periodically purged by Cisco EPN Manager based on your settings. Users with Administrator privileges can adjust when configuration files are purged as follows. If you do not want any configuration files purged, follow this procedure but leave both fields blank.
Note |
For a description of how to manually delete a configuration file, see Delete Archived Device Configuration Files. |
Procedure
Step 1 |
Choose , then choose . |
||||||
Step 2 |
Adjust the archiving settings depending on the following criteria.
|