Uninstalling the IBM Integration Administration feature: z/OS

Learn how to uninstall IBM® Integration Administration for WebSphere® Application Server on z/OS®.

Before you begin

Before uninstalling the IBM Integration Administration feature, you must unaugment or delete any profiles that you augmented or created for the feature.

For example, run the following command to unaugment a profile called AppSrv01:
manageprofiles -unaugment -profileName AppSrv01 
If more than one template has been applied to the profile, you might need to take additional steps. See the documentation on unaugmenting and deleting profiles by using the command line in the WebSphere Application Server documentation.

About this task

Uninstall the IBM Integration Administration feature from your WebSphere Application Server system by running a script that is provided with the feature installation:

Procedure

  1. Stop all of the WebSphere Application Server servers that were started from the relevant WebSphere Application Server installation.

    Navigate to the was_install_root/bin directory, where was_install_root is the root installation directory for WebSphere Application Server. On a command line, enter the following command:

    stopServer server1 -profileName profileName

    server1 is the name of the application server.

    profileName identifies the profile of the server process in a multi-profile installation. This parameter is not required for a single-profile installation.

  2. Navigate to the location into which you extracted the IBM Integration Administration for WebSphere Application Server feature.
    For example, run the following command:
    cd /tmp/unpack
  3. If the WebSphere Application Server installation directory is read-only, use the chmount command to make the directory writable.
    For example, as a user with administrative authorities, run the following command:
    chmount -w was_install_root
    where was_install_root is the root installation directory for WebSphere Application Server.
  4. As a user with administrative authorities, run the script uninstallBrokerPlugin.sh.
    For example:
    ./uninstallBrokerPlugin.sh -u extract_location -d was_install_root
    • extract_location is the full path to the directory into which you extracted the IBM Integration Administration for WebSphere Application Server feature.
    • was_install_root is the location of your WebSphere Application Server installation

    The script returns information about any running WebSphere Application Server processes that are preventing the uninstallation from completing. These processes must be stopped before the script is run again.

  5. As a user with administrative authorities, use the chmount command to make the WebSphere Application Server installation directory read-only.
  6. Restart your WebSphere Application Server server.