7 Uninstalling and Unconfiguring Oracle Enterprise Manager Ops Center

These procedures describe unconfiguring and uninstalling Agent, Proxy Controller, and Enterprise Controller software.

Check with Oracle Support for any additional scripts that might be available to ensure a clean removal of Enterprise Controller or Proxy Controller software.

Uninstalling and Unconfiguring Agents

You can uninstall and unconfigure Agents to remove them from Oracle Enterprise Manager Ops Center. This will also remove the assets managed by the Agents from Oracle Enterprise Manager Ops Center.

To Uninstall and Unconfigure Agents

  1. Select Assets from the Navigation pane. The All Managed Assets list in the Managed Assets tab shows the list of currently managed assets.

  2. From the All Managed Assets list, select the managed OS instance that is currently installed on the system from which you want to remove the agent software. Selecting the managed OS allows you to uninstall the Oracle Enterprise Manager Ops Center agent that is currently installed.

  3. Click the Unmanage/Delete Assets icon. The Introduction pane of the Unmanage and Delete Assets wizard is displayed.

  4. Click Next. The Enter Server Credential pane is displayed.

  5. For this example, select Use the Same SSH Credentials for All Assets Listed Below.

  6. Enter the access credentials using the following fields:

    • SSH Username – Enter either the root user, or the name of the non-root administrative user to use for ssh access.

    • SSH Password – Enter the password for the user you specified in the SSH Username field.

    • Root Username – If you specified the root user in the SSH Username field, leave this field blank. If you specified a non-root administrative user in the SSH Username field, enter the root user name.

    • Root Password – Enter the password for the user you specified in the Root Username field.

  7. Click Next. The Unmanage/Delete pane is displayed.

  8. In the Unmanage/Delete pane, verify that the correct system to unmanage is listed.

  9. Click Next. The Summary pane is displayed.

  10. Click Close to close the Unmanage and Delete Assets wizard.

Unconfiguring and Uninstalling a Proxy Controller

Unconfiguring and uninstalling a Proxy Controller breaks its connection with the Enterprise Controller and removes the Proxy Controller software. All Assets discovered or managed by the Proxy Controller are removed as well. The Agents installed on systems managed by the Proxy Controller are not removed.

Three methods are available for unconfiguring and uninstalling a Proxy Controller. The first two options are performed through the user interface.

  • Connect to the Proxy Controller through SSH, then command it to unregister and uninstall itself. You can only take this action if the Proxy Controller is reachable.

  • Remove the Proxy Controller from Ops Center. This option does not uninstall the Proxy Controller. You can remove a Proxy Controller even if it is unreachable.

  • Unconfigure the Proxy Controller from the command line. The Proxy Controller software must then be uninstalled from the command line.

To Unconfigure and Uninstall a Proxy Controller

  1. Click a Proxy Controller in the Administration section of the Navigation pane.

  2. Click Unconfig/uninstall Proxy in the Actions pane. The Unconfigure/Uninstall Proxy Controller window is displayed.

  3. Select an Unconfiguration/Uninstallation option.

    • Send Job to Remote Proxy – This option sends a command to the Proxy to unconfigure and uninstall itself.

      Enter the privileged user name and password for the Proxy Controller. If root logon is not permitted on the Proxy Controller, enter a non-root user name and password followed by the root user name and password.

    • Force the Removal of the Proxy from Ops Center – This will remove the Proxy Controller from Ops Center, but will not uninstall the Proxy Controller software.

  4. Click Unconfigure/Unregister.

To Unconfigure a Proxy Controller From the Command Line

  1. From the command line, log in to the Proxy Controller.

  2. Use the proxyadm command and the stop subcommand to stop the Proxy Controller. The proxyadm command resides in the /opt/SUNWxvmoc/bin directory on an Oracle Solaris system, and in the /opt/sun/xvmoc/bin on a Linux system. The example below uses the following option: -w – Wait for services to complete stopping.

    /opt/SUNWxvmoc/bin/proxyadm stop -w
    
  3. Use the proxyadm command and the unconfigure subcommand to unconfigure the Proxy Controller. The example below uses the following option: -s – Unregisters the Proxy Controller from the Enterprise Controller.

    /opt/SUNWxvmoc/bin/proxyadm unconfigure -s
    

    The Proxy Controller is now unconfigured from the Enterprise Controller.

Unconfiguring a Proxy Controller from the Command Line

Unconfiguring a Proxy Controller breaks its connection with the Enterprise Controller.

To Unconfigure a Proxy Controller from the Command Line

  1. From the command line, log in to the Proxy Controller.

  2. Use the proxyadm command and the stop subcommand to stop the Proxy Controller. The proxyadm command resides in the /opt/SUNWxvmoc/bin directory on an Oracle Solaris system, and in the /opt/sun/xvmoc/bin on a Linux system. The example below uses the following option: -w – Wait for services to complete stopping.

    /opt/SUNWxvmoc/bin/proxyadm stop -w
    
  3. Use the proxyadm command and the unconfigure subcommand to unconfigure the Proxy Controller. The example below uses the following option: -s – Unregisters the Proxy Controller from the Enterprise Controller.

    /opt/SUNWxvmoc/bin/proxyadm unconfigure -s
    

    The Proxy Controller is now unconfigured from the Enterprise Controller.

Uninstalling a Proxy Controller from the Command Line

Uninstalling a Proxy Controller removes the Proxy Controller software and all Oracle Enterprise Manager Ops Center data. All Assets discovered or managed by the Proxy Controller are removed as well. The Agents installed on systems managed by the Proxy Controller are not removed.

You can uninstall a Proxy Controller from the command line. This may be necessary if the Proxy Controller is not responding to remote commands.

Note:

The co-located Proxy Controller that is installed with the Enterprise Controller cannot be uninstalled without uninstalling the Enterprise Controller.

To Uninstall a Proxy Controller from the Command Line

  1. Use the proxyadm command to stop the Proxy Controller services.

    • Oracle Solaris OS: Use the /opt/SUNWxvmoc/bin/proxyadm command.

    • Linux OS: Use the /opt/sun/xvmoc/bin/proxyadm command. For example:

      # /opt/SUNWxvmoc/bin/proxyadm stop
      
  2. Use the install -e command to uninstall the Proxy Controller software components from your system. Within the parent installation directory, the install command exists in the dvd subdirectory. The example parent installation directory used throughout the installation procedures is /var/tmp/OC. For example:

    # cd /var/tmp/OC/dvd
    # ./install -e
    Invoking uninstall
    

    The install script displays a list of uninstallation tasks that automatically updates as the uninstallation proceeds. For example:

    Ops Center Proxy Controller Uninstall
    (version 11.1.0.0.0 on SunOS)
    
    1. Restore file system configuration. [Not Uninstalled]
    2. Uninstall Expect. [Not Uninstalled]
    3. Uninstall IPMI tool. [Not Uninstalled]
    4. Uninstall Agent components. [Not Uninstalled]
    5. Uninstall application packages. [Not Uninstalled]
    6. Uninstall Core Channel components. [Not Uninstalled]
    7. Uninstall Proxy Core components. [Not Uninstalled]
    8. Uninstall UCE Http proxy. [Not Uninstalled]
    9. Uninstall OS provisioning components. [Not Uninstalled]
    10. Stop and delete services. [Uninstalled]
    (1 of 10 Uninstalled)
    
    Executing current step: Uninstall OS provisioning components...
    

    When complete, the install script indicates that the Ops Center Proxy Controller has been uninstalled.

Unconfiguring an Enterprise Controller

Unconfiguring an Enterprise Controller removes user, authentication, and configuration data and unregisters the Enterprise Controller from Oracle. Data about Proxy Controllers and managed systems is retained. If you unconfigure your Enterprise Controller, you must reconfigure it before using Oracle Enterprise Manager Ops Center.

You can unconfigure an Enterprise Controller to reconfigure it or as a precursor to uninstalling.

To Unconfigure an Enterprise Controller

  1. Click the Enterprise Controller in the Administration section of the Navigation pane.

  2. Click Unconfigure in the Actions pane. A confirmation page is displayed.

  3. Click Unconfigure. The Enterprise Controller is unconfigured.

Uninstalling an Enterprise Controller

You can uninstall the Enterprise Controller. This removes the Enterprise Controller software and all Oracle Enterprise Manager Ops Center data.

To Uninstall an Enterprise Controller

  1. Use the satadm command to stop the Enterprise Controller services.

    • On Oracle Solaris systems, this command is in the /opt/SUNWxvmoc/bin/ directory.

    • On Linux systems, this command is in the /opt/sun/xvmoc/bin/ directory. For example:

      # /opt/SUNWxvmoc/bin/satadm stop
      satadm: Shutting down satellite using SMF...
      #
      
  2. Use the install -e command to uninstall the Enterprise Controller software components from your system. Within the parent installation directory, the install command exists in the xvmoc_full_bundle subdirectory. The example parent installation directory used throughout the installation procedures is /var/tmp/OC. For example:

    # cd /var/tmp/OC/xvmoc_full_bundle
    # ./install -e
    Invoking uninstall
    

    The install script displays a list of uninstallation tasks that automatically updates as the uninstallation proceeds. For example:

    Ops Center Enterprise Controller Uninstall
    (version 11.1.0.0.0 on SunOS)
    
    1. Restore file system configuration. [Not Uninstalled]
    ..........................
    5. Remove users. [Not Uninstalled]
    6. Uninstall application packages. [Not Uninstalled]
    7. Run preremove tasks. [Not Uninstalled]
    8. Uninstall Expect. [Not Uninstalled]
    9. Uninstall IPMI tool. [Not Uninstalled]
    10. Destroy database. [Not Uninstalled]
    11. Uninstall Service container components. [Not Uninstalled]
    12. Uninstall Core Channel components. [Not Uninstalled]
    13. Uninstall Proxy Core components. [Not Uninstalled]
    14. Uninstall Enterprise Controller components. [Not Uninstalled]
    15. Uninstall Update Connection - Enterprise. [Not Uninstalled]
    16. Uninstall Ops Center BUI components. [Not Uninstalled]
    17. Uninstall OS provisioning components. [Not Uninstalled]
    18. Stop and delete services. [Not Uninstalled]
    (0 of 18 Uninstalled)
    
    Executing current step: Stop and delete services...
    

    When complete, the install script indicates that the Ops Center Enterprise Controller has been uninstalled.