IBM Tivoli Monitoring, Version 6.3

tacmd removeSystem

Description

The removeSystem command removes one or more instances of an agent or uninstalls an agent from a managed system. By using the bulk deployment option, the agents specified in the bundle group are removed on the managed systems specified in the deployment group. This command is also available for non-agent bundles.

The no execute option is intended to allow the user to determine which managed systems are uninstalled on specific nodes.

Note: Remote Deployment is not supported in environments with a z/OS Tivoli Enterprise Monitoring Server. This restriction includes this command.

CLI syntax

Removing single IBM® Tivoli® Monitoring Agent, MSN option:

tacmd removeSystem
{-m|--system} SYSTEM ...
[{-f|--force }]

Removing single IBM Tivoli Monitoring Agent, Node and Product Type option:

tacmd removeSystem
                     {-t|--type} TYPE
                     {-n|--node} MANAGED-OS
                     [{-p|--property|--properties} SECTION.NAME=VALUE ...]
                     [{-f|--force}]

Removing System Service Monitors agent:

tacmd removeSystem
                     {-h|--host} [ {smb|ssh|rexec|rsh}:// ] ]
                     {-u|--username} USERNAME
                     {-w|--password} PASSWORD
                     [{-d|--dir|--directory} INSTALLDIR]
                     [{-f|--force}]

Removing one or more System Service Monitors patches from a System Service Monitors agent:

tacmd removeSystem
                     {-h|--host} [ {smb|ssh|rexec|rsh}:// ] HOST [:PORT]
                     {-l|--patchlist} PATCH_LIST
                     [{-p|--property|--properties} SECTION.NAME=VALUE ...]
                     [{-d|--dir|--directory} INSTALLDIR]
                     [{-f|--force}]

Removing IBM Tivoli Monitoring agent in bulk:

tacmd removeSystem
                     {-g|--deploygroup}DEPLOY_GROUP_NAME
                     {-b|--bundlegroup} BUNDLE_GROUP_NAME
                     [{-f|--force}|{-x|--noexecute}]

Removing a System Service Monitors agent in bulk:

tacmd removeSystem
                     {-g|--deploygroup}DEPLOY_GROUP_NAME
                     {-b|--bundlegroup} BUNDLE_GROUP_NAME
                     [{-u|--username} USERNAME]
                     [{-w|--password} PASSWORD]
                     [{-s|--serverlist} SERVER_LIST]
                     [{-f|--force}|{-x|--noexecute}]

Removing one or more System Service Monitors patches from a System Service Monitors agent in bulk:

tacmd removeSystem
                     {-g|--deploygroup}DEPLOY_GROUP_NAME
                     {-b|--bundlegroup} BUNDLE_GROUP_NAME
                     [{-s|--serverlist} SERVER_LIST]
                     [{-f|--force}|{-x|--noexecute}]

where:

-m|--system: Specifies the management system name to uninstall.
-t|--type: Specifies the type of agent to uninstall.
-n|--node: Identifies the node on which the agent type will be uninstalled.
-h|--host: Specifies the host from which to remove the System Service Monitors agent. Optionally, a specific connection protocol and a port can be specified.
-u|--username: Specifies a valid user log in ID on the specified host.
-w|--password: Specifies the password for the specified username.
-p|--property|--properties: Specifies one or more SECTION.NAME=VALUE pairs that identify configuration properties, where SECTION specifies the configuration section containing the configuration property, NAME specifies the name of the configuration property, and VALUE specifies the property value. Specify the instance name of the system to be configured through the INSTANCE property for systems that can have multiple instances.
-s|--serverlist: Specifies one or more server names separated by spaces.
-d|--dir|--directory: Specifies the location on the specified host where the agent is installed, if the agent is not installed in the default location. This location must be specified as a directory, in absolute path format.
-l|--patchlist: List of one or more patch names (separated by spaces) that will be removed from the System Service Monitors agent.
-g|--deploygroup: Specifies the name of the deployment group in which the agents in the bundle group will be uninstalled.
-b|--bundlegroup: Specifies the name of the bundle group containing the agents that will be uninstalled from the managed systems in the deployment group.
-f|--force: Removes the specified system without asking for confirmation.
-x|--noexecute: Causes the command to display which managed systems will be removed.

CLI example

The following command removes the specified LA1 patch on the specified host "lever2":

tacmd removesystem -h smb://lever2 -l LA1 -f

The following command removes all UA (Universal Agent) type agents from the managed node Primary:HDCHASDSTC0540:NT:

tacmd removesystem -t UM -n Primary:HDCHASDSTC0540:NT

The following command removes a System Service Monitors agent from the specified host:

tacmd removesystem -h HDCHASDSTC0540 -u root -w ****** -d /ibm/itm/

The following command removes IBM Tivoli Monitoring agents in bulk:

tacmd removesystem -g UnixGroup -b ULBundle

The following command removes System Service Monitors agents in bulk on all specified servers:

tacmd removesystem -g UnixGroup -b ULBundle -u root -w ****** 
-s HDCHASDSTC0540 HDCHASDSTC0452 HDCHASDSTC0061 -f

The following command removes an instance of the UNIX Log Agent (KUL):

tacmd removeSystem -m nc118215_FP5:KUL

Return values

See Table 1.

Related commands

Return to Table 1.

Feedback