How do I uninstall MDM adaptor artifacts?

Purpose

An NSP MDM adaptor suite may include many adaptor artifacts; 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

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.


1	Log in as the root or NSP admin 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