deletecomponents CLI command
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 works for all components except the indexers which are in use.The 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. When you run this command, only one component can be deleted with each CLI execution.
To understand the syntax and examples, see:
Before you run the command, note the following points:
- Set up the CLI. For more information, see Managing the product from the command line interface.
- Prefix this command with the following, as appropriate:
- For Windows: itda.bat
- For Linux: ./itda.sh
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:
Identifier type used for selecting component types to delete.
The identifier can be one of the following:
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:
Note: If you specify the component type only, then the component with the same type is deleted. For example,
|Host name of the Console Server.|
|Port number of the Console Server.|
|User name to use to connect with the Console Server.|
|Password corresponding to the user name to use to connect with the Console Server.|
(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,
|(Optional) Indicates an HTTPS connection.|
The following example provides the input for deleting an instances of the Indexer component:
The following example provides the input for deleting the specified component name:
only one component can be deleted with each CLI execution