Document toolboxDocument toolbox

Restoring Databases

Note

Should you need to perform a database reset, you can run the reset database command from the administrative shell. This operation should only be performed when absolutely necessary. Performing a database reset retains the appliance’s user-defined configuration, settings, and license entitlements. A database reset removes all discovered device data, including all previously discovered devices from user-configured Discovery Ranges, and all data associated with devices in those ranges. A reset database command forces all devices and all previously collected information to be re-discovered and re-collected from scratch. Resetting the database preserves the appliance configuration.

You can restore the NetMRI network database from a previously generated archive (that is stored on your local management computer) by using the administrative shell restore command.

When the database is restored, the system restores all previous configuration settings for the network along with all low-level data, all issues, and all summary results. Results will show a gap of inactivity starting at the time that the database archive was made and ending at the time the restore was performed. From that point forward, NetMRI processing proceeds normally.

The restore command restores a sequence of archive files in the order given. The command’s syntax is:

restore <archive_files> [option]

Additional restore options include:

  • -https_certs: Only restores HTTPS certificates from the archive.
  • -skip_scan_interfaces_config: Disables the restoration of scan interface configuration.

Because the archive command backs up only part of the data (see description above), you may need to restore multiple daily backup files to reconstruct a complete data set. Thus, the restore command enables you to specify multiple archive files (if you restored just the last file, you would reconstruct data for the last day or last 750MB, whichever is greater). As shown above, wildcards can be used to specify multiple archive files. If you list files separately, enter the oldest file first, then enter the rest in chronological order.

If previously enabled, data collection is automatically re-enabled when the restoration is complete. Otherwise, you will need to manually enable data collection on the Settings icon > Setup section > Collection and Groups > Global page.
After restoring the database, NetMRI resumes most normal operations.

Note

Restoring archives overwrites current data. Example: on December 15 you restore archives through December 1. Data for December 2 through 14 would be lost.

Note

If you migrate from an older NetMRI appliance to a newer model, after restoring the database from the old appliance to the new one, discovery data collection will be disabled on the appliance. You must then enable data collection on the Settings icon > Setup section > Collection and Groups > Global page.

Note

Before restoring a database backup, make sure you have sufficient space on your Backup Storage partition. Free space on the partition should be more than the uncompressed backup space. To estimate the size of the uncompressed backup, run the following on a Linux machine:

gzip -l PATH_TO_DB_BACKUP

The "uncompressed" field of the output is the minimum free space on the Backup Storage partition in bytes.