IBM Support

How To Remove AIX IBM Systems Director Filesets

How To


Summary

The IBM Systems Director Product was withdrawn from marketing in April 2018, but customers with an oslevel less than AIX 7.1.5 may prefer to remove the related filesets.

Objective

The withdrawal announcement can be found here:

https://www-01.ibm.com/common/ssi/rep_ca/4/897/ENUS915-204/ENUS915-204.PDF

Since the IBM Knowledge Center reference pages were disabled, this document provides steps to uninstall Director filesets from AIX.

Steps

1) To uninstall the following Director agent or server filesets:

  •     DirectorServer (if Director server was installed)
  •     DirectorCommonAgent
  •     DirectorPlatformAgent

 
   Run the following script 

 /opt/ibm/director/bin/diruninstall

2) To uninstall the following filesets (which might exist on AIX, independent of Director Server filesets) 
   Run the following commands:

installp -gu cas.agent # Uninstall common agent services (i)
installp -gu tivoli.tivguid # Uninstall Tivoli Guide
installp -gu sysmgt.cim.*providers* # Uninstall all CIM providers
installp -gu sysmgt.cimserver.pegasus.rte # Uninstall Pegasus CIM server (ii)
 

You might notice  "Starting cimserver..." messages during the uninstall process.  These messages are generated by the installer scripts for each provider, so you can ignore them. Once the last provider is removed, the CIM server will be removed.

 i: The following subagents have a dependency on cas.agent and will be uninstalled (by the installp -g option) before cas.agent is uninstalled:

  •     artex.base.agent - AIX Profile Manager subagent 
  •     vios.agent.rte - VIOS SSP subagent (VIOS only)

 ii: On a VIOS, the IVM CIM providers installed by ios.lparmgr.cim.rte fileset, depend on the CIM server. Uninstalling the IVM CIM providers to uninstall the CIM server fileset impacts IVM functionality.

 
3) To recover from a failed installation

    If Director Server filesets are installed, but there is no diruninstall script, you can manually uninstall the Director filesets:
   
    3.1) Run the following commands:

installp -C # Clean up possible unfinished install
installp -gu DirectorServer # Uninstall Director server - Only if the server is installed
installp -gu DirectorCommonAgent # Uninstall Director subagents (Also known as Common Agent)
installp -gu DirectorPlatformAgent # Uninstall Director Platform agent

    3.2) Next, uninstall the remaining agent, provider, and CIM server filesets following the instructions in #2 

    3.3) After all Director filesets are uninstalled, /opt/ibm/director and /opt/ibm/icc should be empty.
            EXCEPTION for AIX 6.1: The following files are installed with the sysmgt.pconsole.rte fileset:
                /opt/ibm/director/classes/pConsoleLaunch.jar
                /opt/ibm/director/classes/extensions/pConsole.TWGExt
                /opt/ibm/director/classes/extensions/pConsole.TWGSubagent

    3.4) Remaining directories and their files can be removed.
    
    To check contents of the directories:

ls -Ral \
/opt/ibm/director \
/opt/ibm/icc \
/var/opt/tivoli \
/usr/lpp/cas.agent \
/var/opt/tivoli/ep \
/usr/pegasus \
/opt/freeware/cimom

To check Software Vital Product Data (SWVPD) database:

lslpp -w \
/opt/ibm/director \
/opt/ibm/icc \
/var/opt/tivoli \
/usr/lpp/cas.agent \
/var/opt/tivoli/ep \
/usr/pegasus \
/opt/freeware/cimom

    To remove the directories:

(remove the 'i" option and use -r if you don't want to be prompted)
 *** EXCEPTION for AIX 6.1: Do not remove /opt/ibm/director/ unless you uninstall sysmgt.pconsole.rte

rm -ir \
/opt/ibm/director \
/opt/ibm/icc  \
/var/opt/tivoli \
/usr/lpp/cas.agent \
/var/opt/tivoli/ep \
/usr/pegasus \
/opt/freeware/cimom
 
 
SUPPORT:

IMPORTANT NOTICE:  Effective April 2018, IBM no longer supports IBM System Director.  Limited assistance is available to help remove the product from supported AIX systems.  

If fileset removal assistance is required after completing all of the provided instructions, use the following step-by-step instructions to contact IBM to open a case for software with an active and valid support contract.  The technical support specialist assigned to your case will confirm that you have completed these steps.

a.  Document (or collect screen captures) of all symptoms, errors, and messages that might have occurred

b.  Capture any logs or data relevant to the situation

c.  Contact IBM to open a case:

   -For electronic support, visit the IBM Support Community:
     https://www.ibm.com/mysupport
   -If you require telephone support, visit the web page:
      https://www.ibm.com/planetwide/

d.  Provide a good description of your issue and reference this technote

e.  Upload all of the details and data to your case

   -You can attach files to your case in the IBM Support Community
   -Or upload to the IBM Enhanced Customer Data Repository
      https://www.secure.ecurep.ibm.com/app/upload_sf

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SWG10","label":"AIX"},"Component":"Install;Systems Director","Platform":[{"code":"PF002","label":"AIX"}],"Version":"All Versions","Edition":"","Line of Business":{"code":"LOB08","label":"Cognitive Systems"}}]

Document Information

Modified date:
28 October 2020

UID

ibm10739295