Top
ETERNUS SF Storage Cruiser V16.1 Operation Guide
FUJITSU Storage

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.

Reflecting File

If the setting file is changed, execute re-read definition file by using the 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

Specify the following operation interval:

  • Monitoring interval of Thin Provisioning Pool threshold

The following operations also can be stopped:

  • Thin Provisioning Pool threshold monitoring

  • Thin Provisioning Pool capacity management

  • Tier pool capacity management

Polling execution time specification

Specify the following execution time:

  • Time of collecting Thin Provisioning Pool capacity information

  • Time of collecting Tier pool capacity information

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 will result in this value being used.

The maximum value is 9223372036854775 - specifying larger values will result in this value being used.
Note that values larger than 9223372036854775807 will cause an error.

Specifying 0 will cause 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" />
</PollingControl>

Example

Modification 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

Modification Method at Acquisition Time of Capacity Information on Thin Provisioning Pool:

Change the following part when you change acquisition time of capacity information on Thin Provisioning Pool.

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 Thin Provisioning Pool capacity information, delete the exectime attribute and add the interval attribute as "0".

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

Example

How to change the time of collecting Tier pool capacity information

When changing the time of collecting Tier pool capacity information, 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 Tier pool capacity information, delete the exectime attribute and add the interval attribute as "0".

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