Editing the system short-term instances group

When you upgrade the Presentation Server to version 11.3.03 or later, an out-of-the-box short-term instances group is created in the TrueSight console with the label System: Short-Term Instances. You cannot create a new or delete the short-term instances group. This group can only be edited.

Editing this group is optional. You can edit this group and add devices and monitoring instances marked for deletion using the selection criteria. This group is effective only if you add the device or monitoring instance selection criteria. This group works like any rule-based group.

Note

Only the default tenant (*) administrator can edit this group to add selection criteria for devices and monitoring instances, or change the properties using CLI commands.

When configured, this group deletes only the devices and instances that are marked for deletion along with their historical data from the system. The default short-term period for deletion is set at 2880 minutes (48 hours). The tsps.shortterm.device.instance.cleanuptime.minutes property can be modified using the tssh properties set command. 

When to use system short-term instances group?

Use this group only when needed and with caution. There is no way to recover after you delete the devices, instances, and historical data.

BMC recommends that you use this group only if you have to clean up the devices and monitoring instances marked for deletion within a short term. For example, if you have to commission or decommission the cloud-based VMs within 1 or 2 days.

However, if the short-term instances group criteria for filtering the devices or monitoring instances is not configured, the clean up automatically happens based on the time configured in the Infrastructure Management server pronet.conf file properties. If you have not modified the pronet.conf settings, the default value is 7 days. Take advantage of these functionalities based on your short-term and long-term requirements to clean up the devices and monitoring instances that are marked for deletion.

Scheduler

An inbuilt scheduler run is triggered to check for the modifications to the short-term instances group. The scheduler run is initiated after 10 minutes from the time when the Presentation Server has been restarted and is up and running. The scheduler periodically scans for any modifications to the group once every 720 minutes (12 hours) after the initial run. The tsps.shortterm.group.scan.interval.minutes property can be modified using the tssh properties set command. 

To edit the system short-term instances group

To start using the system short-term instances group, you must edit the group details and add device and monitoring instance selection criteria rules. Do the following:

  1. Go to Configuration > Groups.
    The Group Configuration page is displayed and the System: Short-Term Instances is listed under the Manual groups tab.
  2. From the System: Short-Term Instances page, click action menu and click Edit Group.




    The Edit Rule-Based Group page is displayed with the following information:

    • Type: The type is non-editable and the value is Rule-Based Group.

    • Group Name: The name is non-editable and the value is System: Short-Term Instances.

    • Description: The description is non-editable and the value is This group is automatically created to manage the short-term instances.


  3. (Optional) Create a device selection criteria using drop-down list of rules selection fields. You can set multiple conditions to select devices. Specify rules as per the following instructions:

     Step-by-step instructions to select devices

    The values that you enter for the properties are not case-sensitive.


    1. Select one of the following properties:
      • (Optional) One of the opening Parenthesis from the list
        • (
        • ((
        • (((
      • Device Name
      • Device DNS Name
      • Device IP Address
      • (Applicable only to 11.3.03 and later) Tag Name
      • Tenant Name
    2. Select an operator to create the condition. The available operators depend on the property that you select.
    3. (Optional) One of the closing Parenthesis from the list
      • )
      • ))
      • )))
    4. (Optional) Click the  to add one or more rules to select devices and perform the earlier steps (a to d).
    5. (Optional) To group the conditions, use the Boolean operators from their corresponding lists:
      • AND
      • OR
    6. (Optional) To remove any existing condition, click the 
    7. To view the list of devices that are selected based on the specified criteria, click Preview
      Note: The Preview option is enabled only after you specify values for the selected conditions.
    8. Click Save.
  4. (Optional) Create a monitor selection criteria using drop-down list of rules selection fields. You can set multiple conditions to select monitor instances. Specify rules as per the following instructions:

     Step-by-step instructions to select monitor instances

    The values that you enter for the properties are not case-sensitive.

    1. Select one of the following properties:
      • (Optional) One of the opening Parenthesis from the list
        • (
        • ((
        • (((
      • Monitor Name
      • Monitor Type
      • Device Name
      • Device DNS Name
      • Device IP Address
      • (Applicable only to 11.3.03 and later) Tag Name
      • Tenant Name
    2. Select an operator to create the condition. The available operators depend on the property that you select.
    3. (Optional) One of the closing Parenthesis from the list
      • )
      • ))
      • )))
    4. (Optional) Click the  to add one or more rules to select devices and perform the earlier steps (a to d).
    5. (Optional) To group the conditions, use the following parentheses and Boolean operators from their corresponding lists:
      • AND
      • OR
    6. (Optional) To remove any existing condition, click the 
    7. To view the list of monitors that are selected based on the specified criteria, click Preview
      Note: The Preview option is enabled only after you specify values for the selected conditions.
    8. Click Save.
  5. Click Save to save the changes.

To view the system short-term instances group details

  1. Go to Configuration > Groups.
    The Group Configuration page is displayed and the System: Short-Term Instances is listed under the Manual groups tab.
  2. Click on System: Short-Term Instances.
    The System: Short-Term Instances group is displayed.

To modify the clean-up time periods for the short-term instances group

  1. Log into the Presentation Server host machine.
  2. From the command line, run the following command and specify the time in minutes.
    tssh properties set tsps.shortterm.device.instance.cleanuptime.minutes <value>
    For example, tssh properties set tsps.shortterm.device.instance.cleanuptime.minutes 2880
  3. Run the following command for the settings to take effect:
    tssh properties reload

To modify the scheduler frequency for the short-term instances group

  1. Log into the Presentation Server host machine.
  2. From the command line, run the following command and specify the time in minutes.
    tssh properties set tsps.shortterm.group.scan.interval.minutes <value>
    For example, tssh properties set tsps.shortterm.group.scan.interval.minutes 360
  3. Run the following command for the settings to take effect:
    tssh server start

To monitor the system short-term instances group

You can monitor the system short-term instances group from the TrueSight console. You can go to Monitoring > Groups.

The monitoring groups page is displayed with the System: Short-Term Instances group listed. For more information, see  Monitoring groups.


Was this page helpful? Yes No Submitting... Thank you

Comments