Uninstalling Client Management OnDemand

If you need to uninstall some of the Client Management components that were installed on your infrastructure, you have the following options:

• Manually uninstalling
• Uninstalling via rollout

Be aware that uninstalling an agent from a device does not automatically remove the device from the CM database ; it must be removed manually from there via the console. If you do not delete the device in the database, it is still displayed in all its groups with the connection status Lost and a red icon ( ) after the device lost time defined in the system variables.

Manually uninstalling Client Management components from Windows devices

CM agents (relays as well as simple clients) can only be uninstalled manually if they also were installed manually. If they were installed by rollout, they also must to be uninstalled by rollout.

1. Select the Start menu and then the Control Panel .
2. Open the Add/Remove Programs window of the Control Panel .
3. Find the component to uninstall (BMC Client Management Client or BMC Client Management Console) in the list of programs and select it.
4. Click Remove .
5. A confirmation window appears. Click Yes in the _MESSAGEBOXTITLE_CONFIRMATION dialog box.
    The uninstallation starts immediately.

When uninstallation is complete, you can see that the respective BMC Client Management component was removed from the list of programs in the Add/Remove Programs list and the agent icon in the systray has disappeared.

Manually uninstalling Client Management components from Linux devices

To uninstall BMC Client Management components, proceed as follows:

1. Open a terminal window.
2. Type the following command:
   • bmc-client-management-console-uninstall to uninstall the console, or

   • bmc-client-management-client-uninstall to uninstall a client agent.

     Warning

     Note:

     You can only manually uninstall an agent that was manually installed. Agents that were rolled out must be uninstalled via rollout.

3. Press the Enter key.

   Warning

   Note:

   Be aware that any files which are generated during the use of BMC Client Management , such as log files, data files, and so on, are not automatically deleted during the uninstall of the components. They must be deleted manually.

Uninstalling client agents via rollout from all platforms

Agents that were installed via a rollout must also be uninstalled by rollout. The uninstallation procedure by rollout is similar to the installation procedure by rollout.

The following example procedure uninstalls the agent from Linux devices

1. Select Wizards > Agent Rollout .
2. Select the Uninstall option from the Select the action to perform for this rollout list.
3. Click Next .
4. Define the following parameters for your uninstall rollout and leave all others with their predefined values:
   • Enter the name for the rollout configuration, for example, Linux RedHat Uninstall in the Name box.
   • If the uninstallation is to be also available for download on the Rollout Server browser interface, enter the name for the auto-extractable file in the Auto-extractable Name box, for example, Bcm_LinuxUninstall.sh .
   • If the installation is to be executed silently, that is, without any user input on the target (Windows devices only) check the Silent mode Installation box.
   • Select the target operating system group in the Operating System box.
   • If the agent was not installed in the default directory enter its installation directory in the Installation Directory box.
   • If the agent was not installed with its default service name enter its name in the Agent Service Name box.
5. Click Next .
    The Rollout Server window appears. It provides the list of all defined rollout servers.
6. Select the rollout server you want to use.
7. Click OK to confirm and close the window.
8. Click Next .
    The Targets & Accounts window appears. Here the devices on which the agent is to be uninstalled must be selected and the administrator accounts to access them. To select the target devices there are several methods available. Because all targets have an agent installed the easiest method is to select them from the device list.
9. Select Edit > Add Device .
10. Select the devices to be uninstalled from one of the tabs of the Select a Device dialog box.
11. Click OK to confirm and close the window.
     The devices are now added to the target list.

12. To add a new account, click Add Administrator .

    InformationThe access to the devices must be defined in the same way as for the installation before you can schedule the deployment.The Properties dialog box appears on the screen.

13. Enter the following data for a new account login in the respective boxes:
    1. Enter the name of the domain to which the rollout is going in the Administrator Domain box. If the rollout is going to all domains, you can use an asterisk 🟡️.

    2. Enter the login name of the administrator as which the deployment tries to log on to the remote target to install the agent in the Administrator Login box.

       Warning

       Note:

       If you are not sure that your local administrator login has the same passwords for all targets, use the domain logon. For domain logons to work correctly, the necessary domain trust relationships must already were set up between the different domain controllers.

    3. Enter the password of the previously entered administrator in the Password box. For security reasons the passwords is only displayed in the form of asterisks 🟡️.
    4. Confirm the previously entered the password into this text box.
    5. Click OK to confirm the new account and add it.
        It is now shown in the list box of the wizard window.
14. When you defined all targets and accounts click Finish to confirm all settings.
     A confirmation window appears now on the screen.
15. Check the Go to Rollout box, to move the focus of the console to the newly created rollout.
16. Click OK to launch the uninstallation process.

Verifying the uninstallation

1. Under the node Global Settings > Rollouts > Global Settings > Your Uninstallation Rollout > Server > Your Rollout Server click the Targets tab. All defined target devices are listed.
2. Monitor the progress of the rollout under Status . The first status of the rollout when it is preparing to execute is Initial .
3. When the status value displays Executing , select the Targets tab to follow progress of each individual target through the Status column (initial status is Initial and the final status should be Uninstalled ).

In the more general status information, the final status may be either Successful for a successfully executed rollout, Processing if the rollout has not yet finished executing, or At least one device failed , if an error of any type occurred on at least one target.