Manual removal of plugins from iManager 3x

  • 7017823
  • 06-Jul-2016
  • 16-Jul-2018

Environment

NetIQ iManager 3
NetIQ eDirectory 9

Situation

iManager is not allowing a plugin to be installed via the normal iManager Configuration tab.. 

Resolution

Recommended: in iManager Configuration - Plugin Installation - Installed Plugins - select all and select uninstall.  (The base and two framework plugins will be preserved if using 3.0.1.)

If this is not possible the old plugin must be manually removed.  Below are the procedures on how to remove all plugins for a fresh start.  The Additional Information section has additional information on how to manually uninstall only one plugin.

1. It is recommended that any custom plugins first be exported and backed up.  The iManager admin guide describes how to do this.  Alternately, the entire /var/opt/novell/iManager/nps directory can be tarballed after Tomcat has been stopped.

2. Stop Tomcat: /etc/init.d/novell-tomcat8 stop

3. Remove the plugins' module directories.  When complete only the following should be left:
base
fw
iman_sp

4. Remove the npm files from the packages directory.
All that should be left are the base.npm, iManager.xml file and any support packs applied.  For example:
base.npm
iManager.npm
iman303_patch0.npm
iman303_patch1.npm
iman_mod_desc.xml

In other words if all plugins were removed in the first step then the ones above will remain. DO NOT delete these.

5. Start Tomcat: /etc/init.d/novell-tomcat8 start

Additional Information

To remove a single plugin the npm file will be examined.  An npm file is just a zip file so the unzip command will be used to verify the right plugin is removed.  This procedure will use the Certificate Server plugin as an example.

To verify the right plugin is selected navigate to the /var/opt/novell/iManager/nps/packages directory.  The pki.npm file looks promising.  Dumping the manifest should give more of a clue.

unzip -p pki.npm META-INF/MANIFEST.MF
this returns:

Manifest-Version: 1.0
Ant-Version: Apache Ant 1.7.0
Created-By: 20.6-b01 (Sun Microsystems Inc.)
Module-ID: CertServerPlugins
Implementation-Title: NetIQ Certificate Server Plug-ins for iManager
Implementation-Description: NetIQ Certificate Management in eDirectory
Implementation-Version: 9.0.1.20160610
RBS-DisplayName: NetIQ Certificate Server
Main-Class: com.novell.admin.PKI.install.PKIPluginInstall
Min-iManager-Version: 3.0.0

This appears to be the right npm  Steps below:

1. Stop Tomcat
/etc/init.d/novell-tomcat8 stop

2. Delete the npm file from the packages directory.
rm /var/opt/novell/iManager/nps/packages/pki.npm

3. Delete the plugin's module directory (This may not exist if a prior uninstall was attempted unsuccessfully.)
rm /var/opt/novell/iManager/nps/WEB-INF/modules/CertServerPlugins  (if unsure examine the MANFEST.MF file within the directory).

4. - Delete the plugin uninstaller (Again, this may not exist if a prior uninstall was attempted but failed.)
rm /var/opt/novell/iManager/nps/UninstallerData/Uninstall_CertServerPlugins

5. Restart Tomcat
/etc/init.d/novell-tomcat8 start



A list of some npms often found and their descriptions follow.  Those with an '*' should not be deleted.

BAndR.npm =  eDirectory Backup and Restore Plugin -
CSP.npm = Case Sensitive Password CSP Plugin for configuring the NDS Login Management and Password Management
EA.npm = Encrypted Attributes plugin, part of Encryption role.
EBASSLPlugin.npm - Enhanced Background Authentication Plug-in
ER.npm =  Encrypted Replication plugin, part of Encryption role.
ICEWiz.npm = eDirectory Import Convert Export (ICE) Plugin
Instrumentation.npm = eDirectory event System Instrumentation
PS.npm = Priority Sync policies and partition management plugin.
RWiz.npm = NetIQ Filtered Replica Management Plug-ins
*base.npm = iManager Base Content
dsmerge.npm = eDirectory Merge plugin contains merge, rename, and graft tree functionality
dsrepair.npm = eDirectory Repair and Logfile
eDirExtended.npm = eDirectory Extended Native Libraries
eDir_IMANPlugins.npm = eDirectory90 Plugins
*iManager.npm =  iManager Framework Content
*iman303_patch0.npm = Support Pack 3 for iManager 3.0 (20170328)
*iman303_patch1.npm = Support Pack 3 HF1 for iManager 3.0 (20170427)
indexmanager.npm = eDirectory Indexes
kerberosPlugin.npm = NetIQ Kerberos Plugin
ldap_plugin.npm = LDAP Management Plugin
nmas.npm = NetIQ Modular Authentication Services
oki.npm = NetIQ Certificate Server
servicemanager.npm = eDirectory Service Management Plugin
snmp.npm = eDirectory SNMP Plugin