Authored by Abhijit Timble. [Updated on 2020-11-16 with the video]
A solid backup system is one of the key elements for every organization to be prepared ahead of any disaster.
vRealize Network Insight 6.0 introduces a new framework to support backup and restore of all on-premises vRNI deployments. This helps address some of the critical use cases around setup recovery and replication, like restoring a previous configuration from a lost setup or need to replicate a similar configuration of the data retention policy, SNMP, Mail server settings, and multiple vRNI deployments within your organization. The process for backup and restores is pretty quick.
If you like watching videos more than reading, check out the YouTube video below, where Abhijit explains the concepts and demos the backup and restore functionality!
You have the flexibility to selectively choose what configurations and data need to be backed up and restored. The default settings include the below list:
- Admin Settings/Configuration data
- Online Update Status
- Data Retention Interval (Data Management)
- IP Properties & Subnet Configuration
- Identity Access Management (LDAP, VIDM, Users Management)
- Logs (Syslog Configuration, Audit Logs PII status)
- Mail Server, SNMP
- System Configuration
- User Preferences
- Data Sources
- Events (User Defined, System, Platform Health)
This list will evolve in future releases. It is currently supported on 6.0 on-premise deployments, and both setups where you are backing up and restoring needs to be on similar versions. When restoring a backup, the recommended setup should be a clean one (new deployment) to avoid inconsistencies.
The backup and restore can be configured through the CLI or API with ‘admin’ or the ‘console user,’ which have complete privileges on the setup. The Auditor user can be used to view the saved configuration. The out of the box system health alerts will monitor the backup/restore status and will alert on any failures.
Backups can be triggered immediately or scheduled (daily or weekly). The backup tar file can be uploaded to an SSH server, FTP server, or the local storage on the platform where the backup runs.
Taking backup/restore is pretty quick. So, let’s try it out!
Backup and Restore using Public API’s
vRealize Network insight introduced a new set of APIs that can be used for backup and restore.
In this example, I will be using the built-in API Explorer, that can be found by clicking the gear icon on the top right. Using the API Explorer, you can test out API calls easily. You can also use your own API tool, like Postman, or PowervRNI. Before following the steps below, make sure you’re authenticated by creating an auth token, via the same interface.
- From API Explorer, select the Configure Backup API.
Modify the parameters as per your backup requirements to decide on what configurations need to be backed up. Submit the request.
This configuration takes either the local_file_server, or ssh_file_server, or ftp_file_server; pick the one where you would like to store your backups. The data_filter determines what to backup. For example, if you would like to skip the backup of the audit logs, set audit_logs_pii_status to false.
- Check the Backup job status using ‘Get currently running or last Backup job status.’
- To restore from backup, it is always recommended to use a new setup (fresh deployment). Select the restore API, review settings/parameters before restoring.
- Check the restore job status by selecting restore status API
Backup and Restore using CLI
vRealize Network Insight 6.0 also introduced a new set of CLI options for backup and restore:
Note: For 6.0, you will be seeing additional SLF4J verbose warning messages for every command you run. This will be fixed in 6.1
- Login to Platform node using the support user and create a new backup configuration as follows:
Note: /var/lib/backup-restore is the default location for creating the backup files
In case you need backups to be created in a different location, refer below configuration:
- Configure Backup (OnDemand or Schedule)
In this example, we will create a backup in a different location under ‘/home/ubuntu/backup-dir’
backup-restore backup --action add --path /home/ubuntu/backup-dir/config-for-backup.txt
The above command will initiate the backup process and the file will get created under the same folder as seen below:
- Check the Backup Status
backup-restore backup --action status
- Fetch the existing Backup Configuration
backup-restore backup --action get
Regarding Restore from backup, it is always recommended to perform on a clean setup (fresh deployment) to avoid any data inconsistencies.
- For Restore, login to the newly setup platform node and create the restore configuration file as follows:
- Configure Restore by running the following command
backup-restore restore --action add --path /home/ubuntu/<restore-config-file-path>
- Check the Restore status by running the following command
backup-restore restore --action status
- Get the Restore configuration details by running the following command
backup-restore restore --action get
This post should give you a good understanding of how to configure the backups on vRealize Network Insight 6.0. Please make sure you do configure the backup for your instance, as you never know what might happen.