Saving and restoring NetIM settings
NetIM includes scripts that permit you to save and restore a limited set of configuration settings. This is useful for recovery in the event of failure on NetIM, and when moving the NetIM software to a new VM.
A limited set of NetIM settings can be exported and imported, including:
• Device and Platform Information
• User Authentication Settings
• Global Discovery Settings
• Trap Receiver Credentials
• Groups and Device Sets
• Auto Grouping Rules
• Workflow Settings (chosen during basic setup)
• Default Time Zone
• Business Hours Settings
• Device Drivers
• IP Detection Service Settings
• Rollup Settings
• Polling Profiles
• Alerts and Notification Settings
• User-Defined Metrics Settings (definitions, not stored metrics)
• Synthetic Testing Settings
• Network Intelligence Settings
• Dashboard Events
• Locked Links
When you export settings, NetIM creates a zip file that can be imported at a later time to restore those settings.
Exported settings are specific to the NetIM release and build and operating system and cannot be imported into a NetIM that is configured differently. To use the save/restore settings feature the following must be the identical for the NetIM exporting the settings and the NetIM importing the settings:
• Operating system (Windows to Windows)
• Database schema
• NetIM version
• Server ID
• “dssuser” database password
Perform one of the following procedures to export NetIM settings.
Exporting NetIM configuration settings (user interface method)
To export NetIM configuration settings
1. Log in to NetIM core as netimadmin.
2. Navigate to the NetIM installation directory, by entering a command like the following:
cd /data1/riverbed/NetIM/<install_dir>
3. Open the export settings user interface by entering the following commands:
This is a UI-based utility. You must use X or an xrdp session.
Windows: bash
./app.sh SETTINGS_MIG_GUI export
Linux: ./app.sh SETTINGS_MIG_GUI export
4. Choose an alternate output directory, if desired.
5. Click Export. You are reminded not to modify settings during this export process, and you are asked to confirm to continue.
6. Click Yes to export settings.
– In the specified output directory, NetIM creates a time-stamped subdirectory containing a zip file named configExport.zip.
– A notification appears when the export of settings is complete.
7. Click OK to close the notification.
To view the progress log, open <install dir>/migrationLog/configExport.log (for example, /data1/riverbed/NetIM/latest/migrationLog/configExport.log) in a text editor.
8. Click Exit to close the setting export window.
9. Save a copy of the zip file on a different host so you can restore settings in the event of a catastrophic failure on this host.
Exporting NetIM configuration settings (command line method)
1. Log in to NetIM core as netimadmin.
2. Navigate to the NetIM installation directory, by entering a command like the following:
cd /data1/riverbed/NetIM/<install_dir>
3. Enter the following commands:
bash
./Windows: app.sh SETTINGS_MIG export <output_dir>
Linux: ./app.sh SETTINGS_MIG export <output_dir>
where <output_dir> is the full path to the output directory where the configExport.zip file is written.
For example:
./app.sh SETTINGS_MIG export /data1/riverbed/NetIM/op_admin/tmp/vne/configExport
Progress messages are written to the command window as NetIM stops services and exports settings. During export, NetIM creates a time-stamped subdirectory containing a zip file named configExport.zip in the specified output directory.
4. During export, do not modify settings. When export is complete, the command prompt returns.
To view the progress log, open /data1/riverbed/NetIM/latest/migrationLog/configExport.log in a text editor.
5. Save a copy of the zip file on a different host so you can restore settings in the event of a catastrophic failure on this host.
Perform one of the following procedures to restore the NetIM configuration from a backup settings file.
Importing NetIM configuration settings (user interface method)
A NetIM configuration backup (configExport.zip) is specific to the release and build that created the backup. DO NOT attempt to restore a configuration that was created using a different version or build of NetIM.
1. Log in to NetIM core as netimadmin.
2. Navigate to the NetIM installation directory, by entering a command like the following:
cd /data1/riverbed/NetIM/<install_dir>
3. Open the import settings user interface by entering the following commands:
This is a UI-based utility. You must use X or an xrdp session.
bash
./Windows: app.sh SETTINGS_MIG_GUI import
Linux: ./app.sh SETTINGS_MIG_GUI import
You are warned that services will be stopped and asked to confirm to continue.
4. Click Browse, and select the zip file that you want to import. After you select the zip file, the interface displays the data to be imported.
5. Click Import to restore settings from the specified backup settings file.
Before importing settings, NetIM shuts down (all services stop). The web UI is inaccessible during this time. In addition, the database is cleaned before settings are imported.
A confirmation dialog appears.
6. If you want to save the database before it is cleaned, select the Save database before cleaning check box in the confirmation dialog.
7. Click Yes in the confirmation dialog when you are ready to continue with the import.
NetIM notifies you when the import is complete by displaying a notification dialog.
8. Click OK to close the notification.
To view the progress log, choose File > View Process Log in the settings import window, or open <install_dir>/log/ConfigImport.log in a text editor.
9. Click Exit to close the settings import window.
10. Start the NetIM services by entering the following command:
./app.sh -c start ALL
Importing NetIM configuration settings (command line method)
A NetIM configuration backup (configExport.zip) is specific to the release and build that created the backup. DO NOT attempt to import a configuration that was created using a different version or build of NetIM.
1. Log in to NetIM core as netimadmin.
2. Navigate to the NetIM installation directory, by entering a command like the following:
cd /data1/riverbed/NetIM/<install_dir>
3. Using a utility like putty or WINscp, copy the configExport.zip settings file you want to import to the <install> directory.
4. Enter the following commands:
bash
./Windows: app.sh SETTINGS_MIG import <input_dir>/<filename>.zip
Linux: ./app.sh SETTINGS_MIG import <input_dir>\<filename>.zip
where <input_dir>/<filename>.zip is the full path and name of the settings file to be imported. (When multiple files are detected, the most recent one is imported.)
For example:
./app.sh SETTINGS_MIG IMPORT /data1/riverbed/NetIM/latest/configExport.zip
Before importing settings, NetIM shuts down (all services stop). The web UI is inaccessible during this time. In addition, the database is cleaned before settings are imported.
5. When import is complete, the command prompt returns.
To view the progress log, open /data1/riverbed/NetIM/latest/migrationLog/configImport.log in a text editor.
6. Start all NetIM services by entering the following command:
./app.sh -c start ALL