How do I uninstall MDM adaptor suites?
Purpose
Perform this procedure to permanently remove one or more MDM adaptor suites from the NSP.
Note: If you are currently upgrading a Release 22.3 or earlier NSP system, you may need to uninstall an adaptor suite from the older system as an upgrade requirement. The procedure steps include release-specific references to support such upgrade-related activity.
Note: In a DR deployment, you perform the adaptor-suite uninstallation in the primary data center; the NSP file-service-app subsequently synchronizes the primary and standby adaptor configurations.
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 suite, you cannot re-install or reinstantiate the adaptor suite using a restart of any pod in the local NSP cluster, or a DR switchover. Consequently, network management may be severely compromised.
Before you attempt to remove an MDM adaptor suite, you must ensure that there are no dependencies on any adaptor in the adaptor suite.
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 |
Perform one of the following.
| ||
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 to list the adaptor suites and check for network management dependencies before any adaptor suite is removed. To list the adaptor suites 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 adaptor suites whose name includes ‘sros’: adaptor-suite.bash --list | grep sros ↵ # ./adaptor-suite.bash --list ↵ Enter the NSP admin user credentials when prompted. | ||
6 |
Enter the following to remove one or more adaptor suites: # ./adaptor-suite.bash --remove zipfile_1 zipfile_2 . . . zipfile_n ↵ where zipfile_1 to zipfile_n are adaptor-suite zip-file specifications; 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 |
If the NSP system is at Release 22.3 or later, enter the following to display the adaptor suites that the --cleanup option in Step 10 removes: Note: The --list-cleanup option displays the adaptor suites that are uninstalled from the MDM servers but still available in the PostgreSQL database and file-service-app pod. # ./adaptor-suite.bash --list-cleanup ↵ Enter the NSP admin user credentials when prompted. | ||
9 |
If the NSP system is a DR deployment, verify that the primary and standby file-service-app pods are communicating.
| ||
10 |
In a DR NSP deployment, performing this step when the adaptors on the primary and standby clusters do not match may severely degrade network management and require a cluster redeployment. Before you perform the step in a DR deployment, you must be certain that the list of installed adaptors on the standby MDM servers matches the list of installed adaptors on the primary MDM servers. Enter the following to delete all references to all uninstalled adaptor suites from the PostgreSQL database and file-service-app: # ./adaptor-suite.bash --cleanup ↵ Enter the NSP admin user credentials when prompted. All references to the uninstalled adaptor suites are removed. | ||
11 |
Close the console window. End of steps |