In some cases, There might be cases where DPOD users wants would like the ability to remove DPODs DPOD related configuration from a monitored device (IDG). Example : One such case would be a requirement for temporary monitoring of a non-production device for product demonstration.
The user has two basic ways There are two methods available to remove DPODs DPOD related configuration from monitored IDG devices:
- Manually, as describe in the in the in How to Uninstall DPOD from DataPower
- Using the DPOD IDG configuration tool
The DPOD IDG configuration tool is a simple tool that enables the user users to backup DPODs the DPOD related configuration of IDG before starting to monitor the IDG using DPOD.
If neededrequired, the tool can also be used remove the DPOD configuration from IDG monitored device.
Backing up the IDG configurationUse configuration
To perform an IDG configuration backup, use the app_idg_pre_conf_bck.sh script located in the directory /app/scripts directory.
The script will back up the following IDG objects configuration:
...
The script parameters are :
Operation | Purpose |
-i, --idg-ip |
...
IDG xml management interface IP address or host name | |
-p, --idg-port |
...
IDG xml management interface port | |
-u, --idg- |
...
user | IDG xml management interface |
...
username |
-s, --idg-pass |
...
IDG xml management interface user password |
The script's backup directory and log file will be displayed in a message at the end of execution.
Example of the script execution :
| Code Block | ||||
|---|---|---|---|---|
| ||||
app_idg_pre_conf_bck.sh -i 192.168.65.80 -p 5550 -u admin -s 123456 |
Removing DPOD configuration and restoring IDG objects based on the backup information
To remove the DPOD configuration from an IDG monitored device use the script app_idg_pre_conf_restore.sh located in the /app/scripts. directory.
| Info |
|---|
If you did not run app_idg_pre_conf_bck.sh before installing DPOD - you can still remove some of the configuration automatically by running it now, and letting it backup the current configuration. |
The script will restore the following IDG objects configuration based on the backup file :
- XML management interface
- WS-M agent configuration
- Certificate monitor
Furthermore, the script will remove the following DPOD related configuration:
- DPOD related host aliases
- DPOD log targets
- DPOD log category
- Disable statistics
- Remove two XSLT files deployed by DPOD to store directory
The script parameters are :
Operation | Purpose |
-i, --idg-ip | IDG xml management interface IP address or host name |
-p, --idg-port | IDG xml management interface port |
-u, --idg-user |
View DPOD system services status (running/stopped)
Start Service
Start DPOD system services.
The command lets you start either single service or a list of several services.
Stop Service
Stop DPOD system services.
The command lets you stop either a single service or a list of several services.
MustGather
Create and export DPOD MustGather logs.
(This operation may be requested of you by product support)
In order to run the command see following link
Reboot Device
Restart the DPOD device (physical or VM)
Shutdown Device
Shutdown the DPOD device (physical or VM)
Upgrade/Update
Upgrade the DPOD installation to a newer version.
This requires an update file (Fix file) to be uploaded to the system
Exit
Exit the CLI
...
IDG xml management interface username | |||
-s, --idg-pass | IDG xml management interface user password | ||
| -d, --backup-dir | source backup directory
|
As the original backed up configuration might have changed between the period of the backup and the restore, the script displays the backup data and provides the user with an opportunity to change the configuration to restore.
This is an example of the XML management interface restore menu:
The script's log file will be displayed in a message at the end of executionexample of the script execution :.
| Info |
|---|
If multiple DPODs are installed, and one of them still needs to monitor the DataPower device, the script may have removed objects that belong to it. |
| Info |
|---|
| The script does not remove the following objects, and the user will have to remove them manually, unless there is another DPOD monitoring the device: Log Category - msc-mon Host Alias - MonTier_LogTarget_Source Only in API Connect domains - Log Category - api-mon |