Changing system settings

This topic provides information about managing the system settings.


The system settings are applied to all users in the system.

The following system settings can be modified by navigating to Administration > System Settings.

  • General Settings
  • Index Block Settings
  • Data Archive Settings

To modify general settings

Navigate to Administration > System Settings> General Settings, provide the following information, and click Save to apply the settings to all users in the system.

Enable Data Access Control

Use this setting to apply access permissions to the user groups specified at the time of creating data collectors, for accessing and viewing data.

Note: By default, this check box is already selected. If you disable this setting and then later enable it after creating a data collector, the access permissions might not be applied.
Default Enable Agent

Use this setting to enable or disable data collection by using the Collection Agent at the time of adding a host.

By default, this check box is already selected.

This setting controls the Enable Agent check box selection at the time of adding a host.

No. of search results to export

This value indicates the maximum number of search results that you can export from the Searching for data.

By default, this value is set to 10000.

Default User Password

This value indicates the default password for all users.

Normally, when you create a new user, the password for that user is sent via email. But if you have not set up emails by creating an external configuration, then an email cannot be sent. In this scenario, the new user can use the default password for logging on to the product.

Note: This password is not functional if you have already created an external configuration to setup your emails. For more information, see Setting up emails.

Self Health Monitoring Events Destination

Use this setting to add a destination for sending Self Health Monitoring events.

By default, this value is set to None.

Note: You will be able to see the destination for sending the Self Health Monitoring events if you have already created external configurations of the types TSIM Configuration or TSIM Cell Configuration. For more information, see Setting up external configurations.

For more information on self-health monitoring, see Monitoring self-health of TrueSight IT Data Analytics.

Tag names

Enter a value and click Add Tag  to add tags for the system. Use these tags when you are adding a data collector.

Select a tag from the list of tags and click Delete Tag  to remove the tag from the system.

To modify Index Block Settings:

Navigate to Administration > System Settings> Index Block Settings, provide the following information. Click Done to apply the settings to the selected Index Block.

Index Block Name

Lists the index blocks that you want to configure. The different index blocks that are listed by default are:

  • Small
  • Medium
  • Large
  • Metrics

The index block names are editable.

Custom Index blocks defined by your Administrator are also listed here and only an Administrator can modify them. For more information on how to create custom index blocks, see manageindexblock CLI command.

Retention Days

Indicates the number of days for which indexed data must be retained in the system before getting purged.

This is configurable. However, the number of days that the data can be retained cannot be more than 30 days.

To change the maximum retention days limit, you need to add the property and its new value. This property needs to be added with the new values at %BMC_ITDA_HOME%\custom\conf\server\

After changing the property value, you need to restart the Search component to apply the change.

For example, if this value is set to 30 (number of days), then the data collector cannot read past data that was indexed more than 30 days ago. Data older than the retention days is not available for search.

For more information, see Understanding data retention and deletion.


Indicates whether archiving is on or off.


You can toggle the switch to set archive to on or off from here, however the data archive settings that have been set from Administration > System Settings> Data Archive Settings override these settings, which means that if you haven't enabled archive in the Data Archive Settings tab, you cannot enable archive for an index block.


Clicking Edit makes the fields editable. Once you change the values, click on Done to apply the changes . Click Cancel to cancel the changes.

To modify Data Archive Settings:

Navigate to Administration > System Settings> Data Archive Settings. 

  1. Toggle the Enable Archive switch  ().
  2. When the Enable Archive switch is turned on, you get an option to add an archival path. Enter the path where you want the data to be archived. You can add any number of archival paths, however, only one path can be active at a time.


    -An active path is one where the data will be archived. However, if a path is not set as active and you delete it, you will not be able to restore data from it later until you add the path again.

  3. Select the option in front of a path to set it as the active path.
  4. Click Apply.

    Clicking Apply restarts all Indexers.
Was this page helpful? Yes No Submitting... Thank you