A.8 Polling Service Setting File

Editing this setting file can customize the following operations controlled by polling service.
This setting file is described in XML.

Items That Can Be Customized	Explanation	Default Value
Thin Provisioning Pool threshold monitoring	The monitoring interval for the Thin Provisioning Pool threshold can be changed.	1 hour (3,600 seconds)
Capacity management for the Thin Provisioning Pool, TPV, and NAS file system	The execution time for the capacity information collection can be changed. However, the NAS file system information may be obtained 10 minutes earlier than the specified time.	1:00 A.M.
Capacity management for the Tier pool and FTV	The execution time for the capacity information collection can be changed.	1:30 A.M.
Event notification setting of SNMP Traps	The monitoring interval for the event notification setting of SNMP Traps can be changed.	1 hour (3,600 seconds)

Reflecting File

If the setting file is changed, execute re-read definition file by using Web Console, or reactivate the Manager. This reflects the settings on this software.

Customization

Note

Do not delete the file, even if no items are specified.
To customize the polling service, edit the file in the customization directory (not the one in the installation directory).

File Path and Name

When the Manager is installed or upgraded, the configuration file is stored in the directory below:

Manager OS	Absolute Path Name
Windows	$INS_DIR\ESC\Manager\opt\FJSVssmgr\lib\polling\pollingService.xml, where $INS_DIR is the "executable directory" specified during Manager installation.
Solaris OS, Linux	/opt/FJSVssmgr/lib/polling/pollingService.xml

To customize the polling service, copy the configuration file in the directory above to the customization directory below, then edit it:

Manager OS	Absolute Path Name (for Customization)
Windows	$ENV_DIR\ESC\Manager\etc\opt\FJSVssmgr\current\polling\pollingService.xml, where $ENV_DIR is the "environment directory" specified during Manager installation.
Solaris OS, Linux	/etc/opt/FJSVssmgr/current/polling/pollingService.xml

If there is a configuration file in the customization directory, then the Manager uses it, otherwise it uses the default configuration file in the installation directory.

File Format

Contents

Item	Content
Polling interval	This item specifies the following operation interval: Monitoring interval for the Thin Provisioning Pool threshold Monitoring interval for the event notification setting of SNMP Traps The following operations also can be stopped: Thin Provisioning Pool threshold monitoring Capacity management for the Thin Provisioning Pool, TPV, and NAS file system Capacity management for the Tier pool and FTV
Polling execution time specification	This item specifies the following execution time: Execution time of the capacity information collection for the Thin Provisioning Pool, TPV, and NAS file system Execution time of the capacity information collection for the Tier pool and FTV

Item

Content

Polling interval

This item specifies the following operation interval:

Monitoring interval for the Thin Provisioning Pool threshold
Monitoring interval for the event notification setting of SNMP Traps

The following operations also can be stopped:

Thin Provisioning Pool threshold monitoring
Capacity management for the Thin Provisioning Pool, TPV, and NAS file system
Capacity management for the Tier pool and FTV

Polling execution time specification

This item specifies the following execution time:

Execution time of the capacity information collection for the Thin Provisioning Pool, TPV, and NAS file system
Execution time of the capacity information collection for the Tier pool and FTV

Node Hierarchy

The tag node hierarchy for is displayed below:

Tags and Attribute Types

Request Tag

Attribute Name	Content
interval	Polling interval in seconds (in decimal format). The minimum value is 30 - specifying shorter values results in this value being used. The maximum value is 9,223,372,036,854,775 - specifying larger values results in this value being used. Note that values larger than 9,223,372,036,854,775,807 causes an error. Specifying 0 causes the polling to not be executed. If the "exectime" attribute is specified at the same time, polling is executed by default.
exectime	Polling execution time (in hh:mm:ss format - example: 21:15:00) hh has a valid range of 0 to 23, and mm and ss have a valid range of 0 to 59. If the "interval" attribute is specified at the same time, polling is executed by default.

Attribute Name

Content

interval

Polling interval in seconds (in decimal format).

The minimum value is 30 - specifying shorter values results in this value being used.

The maximum value is 9,223,372,036,854,775 - specifying larger values results in this value being used.
Note that values larger than 9,223,372,036,854,775,807 causes an error.

Specifying 0 causes the polling to not be executed.

If the "exectime" attribute is specified at the same time, polling is executed by default.

exectime

Polling execution time (in hh:mm:ss format - example: 21:15:00)

hh has a valid range of 0 to 23, and mm and ss have a valid range of 0 to 59.

If the "interval" attribute is specified at the same time, polling is executed by default.

Param Tag: None.

Sample Configuration File

<?xml version="1.0" encoding="UTF-8" ?>
<PollingControl name="Default" ver="1.0">
  <Request name="WatchAlarm" className="com.fujitsu.storagesoft.services.polling.method.WatchPoolAlarm" interval="3600" />
    <param key="Warning" value="pool status changed: Warning" />
    <param key="Caution" value="pool status changed: Caution" />
    <param key="Normal" value="pool status changed: Normal" />
  <Request name="WatchCapacity" className="com.fujitsu.storagesoft.services.polling.method.WatchPoolCapacity" exectime="01:00:00" />
  <Request name="WatchTierPoolCapacity" className="com.fujitsu.storagesoft.services.polling.method.WatchTierPoolCapacity" exectime="01:30:00" />
  <Request name="DeviceSetting" className="com.fujitsu.storagesoft.services.polling.method.DeviceSetting" interval="3600" />
</PollingControl>

Example

Change Method at Intervals That Observes Threshold of Thin Provisioning Pool:

Change the following part when you change the threshold watch interval of Thin Provisioning Pool.

The name attribute changes the interval attribute of the Request tag of "WatchAlarm". It specifies it at the second. Interval attribute is changed to "1800" when changing every 30 minutes.

<Request name="WatchAlarm" className="com.fujitsu.storagesoft.services.polling.method.WatchPoolAlarm" interval="1800" />

To stop monitoring Thin Provisioning Pool threshold, change the interval attribute to "0".

<Request name="WatchAlarm" className="com.fujitsu.storagesoft.services.polling.method.WatchPoolAlarm" interval="0" />

Example

Change Method of Capacity Information Acquisition Time for Thin Provisioning Pool, TPV, and NAS file system:

Change the following part when you change acquisition time of capacity information on Thin Provisioning Pool, TPV, and NAS file system.

The name attribute changes the exectime attribute of the Request tag of "WatchCapacity". The value is time (hh): (mm): It specifies it by second (ss). The exectime attribute is changed to "12:00:00" when changing at 12:00.

<Request name="WatchCapacity" className="com.fujitsu.storagesoft.services.polling.method.WatchPoolCapacity" exectime="12:00:00" />

To stop collecting the capacity information for the Thin Provisioning Pool, TPV, and NAS file system, delete the exectime attribute and add an interval attribute with "0".

<Request name="WatchCapacity" className="com.fujitsu.storagesoft.services.polling.method.WatchPoolCapacity" interval="0" />

Example

How to change Capacity Information Collection for Tier pool and FTV

When changing the capacity information collection time for the Tier pool and FTV, change the following locations:

For the Request tag whose name attribute is "WatchTierPoolCapacity", change the exectime attribute. Specify the value in hour (hh): minute (mm): second (ss). When changing to 23:00, change the exectime attribute to 23:00:00.

<Request name="WatchTierPoolCapacity" className="com.fujitsu.storagesoft.services.polling.method.WatchTierPoolCapacity" exectime="23:00:00" />

To stop collecting the capacity information for the Tier pool and FTV, delete the exectime attribute and add an interval attribute with "0".

<Request name="WatchTierPoolCapacity" className="com.fujitsu.storagesoft.services.polling.method.WatchTierPoolCapacity" interval="0" />