Uninstalling a monitoring agent

Use the procedures in this section to uninstall a Response Time monitoring agent from your computer.

Note: When you uninstall a monitoring agent, the uninstallation process might leave behind directories or files that have been added or modified by users. You must manually delete the following files: \IBM\Rational and ..\IBM\SDP70Shared.

Procedure - uninstalling monitoring agents

Use the following procedures to uninstall the monitoring agent:

For Windows operating systems:
1. Stop all Internet Service Monitoring processes.
2. From the desktop, click Start > Settings > Control Panel (for Windows 2000) or Start > Control Panel (for Windows 2003).
3. Click Add or Remove Programs.
4. Do one of the following things depending on what type of image you used to install the specific agent most recently.
  - If the agent is installed with the agent-specific image, click the agent name, such as IBM® Tivoli® Composite Application Manager Console and IBM Tivoli Composite Application Manager for Robotic Response Time.
  - If the agent is installed with the integrated image, click ITCAM for Transactions - Response Time Agents.
    Remember: One integrated image to install all Response Time agents is provided by ITCAM for Transactions Version 7.2, instead of separate images for each agent in previous versions. For example, if you installed a previous version of Robotic Response Time and upgrade it to version 7.2 with the integrated image, you should select ITCAM for Transactions: Response Time Agents in this step.
  - If the agent is installed or upgraded in IBM Tivoli Monitoring version 6.2.1 or later, you might not find agent-specific entries listed under Add or Remove Programs. In this case, select IBM Tivoli Monitoring and follow the on-screen prompts to select the specific agent or agents to uninstall.
5. Click Change/Remove.
6. Select Remove and click Next.
  Important: If you select ITCAM for Transactions - Response Time Agents in the previous step, selecting Remove in this step will uninstall all the Response Time agents that are installed with the integrated image; if you only want to uninstall some specific agent, select Modify in this step and clear the check box next to the agent on the following Add or Remove Features window.
7. Click OK to confirm the uninstallation.
8. Click Finish.
To perform a silent uninstall, modify the silent.txt file by commenting all the lines, except for the following:
[ACTION TYPE] REMOVEALL=Yes
For more information on silent.txt, see Performing a silent installation.
For UNIX or Linux operating systems:
1. Stop all Internet Service Monitoring processes.
2. From a command prompt, run the following command to change to the appropriate /bin directory:
```
cd install_dir/bin
```
  where install_dir is the path for the home directory for the agent.
3. Run the following command:
```
./uninstall.sh
```
  A numbered list of product codes, architecture codes, version and release numbers, and product titles is displayed for all installed products.
4. Type the number for the monitoring agent you want to uninstall. Repeat this step for each additional installed product you want to uninstall.

Verifying removal of monitoring agents

The following instructions describe how to verify the removal (uninstallation) of a monitoring agent from Windows, UNIX, or Linux systems.

Verify monitoring agent removal from Windows	Verify monitoring agent removal from UNIX and Linux
Verify that the service, including processes, are removed. Select Control Panel > Administrative Tools > Services and ensure that the agent does not exist in the Services list. Select Windows Task Manager and verify that the agent is not running. For Web Response Time, you need to verify that the Web Response Time Analyzer (KFCMServer) process is not running. Verify that the related files are removed. Verify that the agent node on the Tivoli Enterprise Portal is removed. If the agent node is still installed on the Tivoli Enterprise Portal, you will see it in the navigator pane in the Tivoli Enterprise Portal. If the agent node is offline, manually remove it. Right-click the node in the anavigator pane and select Remove.	Verify that the service, including processes, are removed. From the command line, run `CANDLE_HOME/bin/cinfo -r` or run `ps -ef \| grep ktagent` where t is the product code. Verify that the related files are removed. Verify that the agent node on the Tivoli Enterprise Portal is removed. If the agent node is still installed on the Tivoli Enterprise Portal, you will see it in the navigator pane in the Tivoli Enterprise Portal. If the agent node is offline, manually remove it. Right-click the node in the anavigator pane and select Remove.

Verify monitoring agent removal from Windows

Verify monitoring agent removal from UNIX and Linux

Verify that the service, including processes, are removed.
1. Select Control Panel > Administrative Tools > Services and ensure that the agent does not exist in the Services list.
2. Select Windows Task Manager and verify that the agent is not running. For Web Response Time, you need to verify that the Web Response Time Analyzer (KFCMServer) process is not running.
Verify that the related files are removed.
Verify that the agent node on the Tivoli Enterprise Portal is removed.
- If the agent node is still installed on the Tivoli Enterprise Portal, you will see it in the navigator pane in the Tivoli Enterprise Portal.
- If the agent node is offline, manually remove it. Right-click the node in the anavigator pane and select Remove.

Verify that the service, including processes, are removed.
- From the command line, run CANDLE_HOME/bin/cinfo -r or run ps -ef | grep kt*agent where t* is the product code.
Verify that the related files are removed.
Verify that the agent node on the Tivoli Enterprise Portal is removed.
- If the agent node is still installed on the Tivoli Enterprise Portal, you will see it in the navigator pane in the Tivoli Enterprise Portal.
- If the agent node is offline, manually remove it. Right-click the node in the anavigator pane and select Remove.