How do I uninstall MDM adaptors?
Purpose
| WARNING Network Management Degradation |
After you remove an MDM adaptor, you cannot re-install or reinstantiate the adaptor using a restart of any pod in the local NSP cluster, or a DR switchover. Consequently, NSP network management may be severely compromised.
Before you attempt to remove an adaptor, you must ensure that no dependencies on the adaptor exist.
An NSP MDM adaptor suite may include many adaptors; for example, a large number of adaptors that are common to all software versions and chassis types of a device. However, only some of the adaptors may be relevant to your network management needs, while the others unnecessarily consume system resources.
Perform this procedure to permanently remove one or more individual MDM adaptors from the NSP for the purpose of resource optimization.
Note: To remove one or more MDM adaptor suites, see How do I uninstall MDM adaptor suites?.
Note: In a DR deployment, you perform the uninstallation only on the primary NSP cluster, which then replicates the adaptor configuration on the standby cluster.
Note: release-ID in a file path has the following format:
R.r.p-rel.version
where
R.r.p is the NSP release, in the form MAJOR.minor.patch
version is a numeric value
Steps
1 |
Log in as the root user on the NSP deployer host in the standalone or primary data center. |
2 |
Open a console window. |
3 |
Enter the following: # cd /opt/nsp/NSP-CN-DEP-release-ID/NSP-CN-release-ID/tools/mdm/bin ↵ |
4 |
Enter the following to verify that the RESTCONF token for the NSP cluster is valid: # ./adaptor-suite.bash --list ↵ Enter the NSP admin user credentials when prompted. Messages like the following are displayed if the token is valid. Using log file: log_file INFO: timestamp -> Listing MDM adaptors suites ... INFO: timestamp -> Token requested... INFO: timestamp -> Token acquired INFO: timestamp -> Listing adaptor suites... Installed adaptor suites: list_of_adaptor_suites INFO: timestamp -> Done. |
5 |
It is strongly recommended that you list the adaptors and check the artifact guide for network management dependencies before any adaptor is removed. To list the adaptors on the file system, enter the following: Note: The --list-adaptors option queries the installed adaptors on the MDM server; by contrast, the --list option displays the adaptor suites in the PostgreSQL database. Consequently, until the next periodic NSP cluster data synchronization, an adaptor that you remove may be temporarily shown in the --list option output. Note: To filter the command output for a specific vendor, pipe the output to grep; for example, the following lists only adaptors whose name includes ‘sros’: adaptor-suite.bash --list-adaptors | grep sros ↵ # ./adaptor-suite.bash --list-adaptors ↵ Enter the NSP admin user credentials when prompted. |
6 |
Enter the following to remove one or more individual adaptors: # ./adaptor-suite.bash --remove-adaptor file_1 file_2 . . . file_n ↵ where file_1 to file_n are adaptor file names; each must include the absolute path Enter the NSP admin user credentials when prompted. |
7 |
Enter the NSP admin user credentials. The adaptors are removed from each running MDM instance. Note: It may take 30 minutes or more for adaptors to be removed. |
8 |
Close the console window. End of steps |