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.
For example, if you perform a custom installation of the Collection Station on a computer and then you uninstall it and later reinstall it on the same computer, the Administration > Components page displays a duplicate entry for the Collection Station with the status green. In this scenario, you can run this command to delete the duplicate entry of the Collection Station.
This command only removes the component from the database; it does not uninstall the component. So if you restart the service for the TrueSight IT Data Analytics Server, the deleted component is again visible on the product UI.
To understand the syntax and examples, see:
Note
Before you run the command, note the following points:
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:
Parameter | Description |
---|---|
-t | Identifier type used for selecting component types to delete. The identifier can be one of the following:
Examples:
|
| 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:
To delete multiple components, you need to specify a comma-separated list of items. Example:
Note: If you specify the component type only, then all the components with the same type are deleted. For example, |
-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:
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:
Example: If you want to set the locale as Simplified Chinese, you need to specify, |
-v | (Optional) Version of the IT Data Analytics product. |
-s | (Optional) Indicates an HTTPS connection. |
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