Page tree

Use this command to delete duplicate instances of components that are displayed on the Administration > Components tab. You can also use this command to delete instances of components that are uninstalled or removed from the deployment.

This command only removes the component from the database; it does not uninstall the component. So if you restart the service for the BMC TrueSight IT Data Analytics Server, the deleted component is again visible on the product UI.

To understand the syntax and examples, see:

Related topics

Syntax

Note

Prefix this command with the following, as appropriate:

  • For Windows: itda.bat
  • For Linux: ./itda.sh

deletecomponents -t <Identifier-Type> -n <Identifier> -d <hostName> -p <portNumber> -u <userName>
-w <password> [-l <locale>] [-v] [-s]

  • Angle brackets (< >) indicate a variable value that needs to be user defined.

  • Square brackets ([ ]) indicate optional parameters.

The following table describes the parameters used in the syntax:

ParameterDescription
-t

Identifier type used for selecting component types to delete.

The identifier can be one of the following:

  • NAME
  • TYPE

Examples:

  • -t NAME
  • -t TYPE
-n

Identifier used as a criterion to delete components.

The identifier can be either the component name or type as displayed in the Name or Type columns on the Administration > Components tab, as follows:

  • -n <List-Of-Component-Names>
  • -n <List-Of-Component-Types>

To delete multiple components, you need to specify a comma-separated list of items.

Example:

  • -n COLLECTION_STATION-clm-18.bmc.com-8080,
    COLLECTION_STATION-clm-19.bmc.com-8080
  • -n COLLECTION_STATION, INDEXER

Note: If you specify the component type only, then all the components with the same type are deleted. For example, -n INDEXER.

-d
Host name of the Console Server
-p
Port number of the Console Server.
-u
User name to use to connect with the Console Server.
-w
Password corresponding to the user name to use to connect with the Console Server.
-l

(Optional) Indicates the locale in which you want to display messages when the command is run.

You can set one of the following locales:

  • English
  • Simplified Chinese
  • German
  • French

By default, the messages are displayed in the locale of the system on which the CLI is run.

The value can be set to one of the following depending on the locale you choose:

  • English: en
  • Simplified Chinese: chs
  • German: de
  • French: fr

Example: If you want to set the locale as Simplified Chinese, you need to specify, l=chs.

-v
(Optional) Version of the IT Data Analytics product.
-s
(Optional) Indicates an HTTPS connection.

Example inputs

The following example provides the input for deleting all instances of the Indexer component:

deleteComponents -t TYPE -n INDEXER –d localhost –p 9797 –u admin –w admin12345

The following example provides the input for deleting the specified component names:

deleteComponents -t NAME -n COLLECTION_STATION-clm-005518.bmc.com-8080,
SEARCH-clm-005518.bmc.com-9797 –d localhost –p 9797 –u admin –w admin12345
  • No labels