indexertemplates CLI command
Use this command to list or update Indexer templates.
BMC recommends that you do not update the templates unless you are instructed to by BMC Customer Support.
When an index is created a suitable template is automatically applied to that index. Based on the kind of data contained in the index, a matching template is applied. The template determine how the indexed data will be analyzed and interpreted by the product.
Data indexed based on a data pattern contains fields stored with particular field types. These field types are stored in the dynamic template. Based on the field types, the product will determine if those fields need to be interpreted as aplhanumeric (STRING) or numeric (INTEGER, LONG, and so on). Similarly, other templates are applied on particular kinds of data and based on the template applied, that data is analyzed and interpreted.
The following kinds of templates are available:
- Dynamic template (named dynamic_template_1): Applied to both data index types and metrics index types.
- Metadata template (named itda_metadata): Applied to the metadata index type.
- Configuration template (named itda_config): Applied to an index containing status about the last ten polls for data collectors.
These templates are located at %BMC_ITDA_HOME%\conf\server\indexertemplates\.
For more information about the index types, see indexlist CLI command CLI command.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:
Name of the operation that you want to perform by using this command.
Depending on the kind of operation you want to perform, the value can be one of the following:
File details including the file name and complete path of the file.
This parameter is only applicable while running the
When you run the
Name of the template on which the specified operation needs to be performed.
You can choose to perform an operation on an individual template or on all the templates.
The value can be one of the following:
(Optional) A boolean value which enables or disables update of existing properties in the template.
The values can be t
When you specify the value as
|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 listing details of all the templates on a Windows machine.
The following example provides the input for updating the property, "index.codec": "best_compression" in the "dynamic_template_1" template.
Note: Before performing the update, you need to first add "index.codec": "best_compression" in the template and save the template.