Editing the system short-term instances group
When you upgrade the Presentation Server to version 11.3.03, 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
property can be modified using the tsps.shortterm.group.scan.interval.minutes
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:
- Go to Configuration > Groups.
The Group Configuration page is displayed and the System: Short-Term Instances is listed under the Manual groups tab. 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.
(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:
(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:
Click Save to save the changes.
To view the system short-term instances group details
- Go to Configuration > Groups.
The Group Configuration page is displayed and the System: Short-Term Instances is listed under the Manual groups tab. 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
- Log into the Presentation Server host machine.
- 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
- Run the following command for the settings to take effect:
tssh properties reload
To modify the scheduler frequency for the short-term instances group
- Log into the Presentation Server host machine.
- 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
- 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.
Comments
Log in or register to comment.