6.5.2 Editing an automatic maintenance policy file

An automatic maintenance policy file collectively defines the automatic maintenance policies for several ID groups and several host groups.

If you want to use any of the single-byte symbols listed in the table below in the file, you need to replace them with a specific character string.

Table 6‒2: Single-byte symbols requiring replacement
Single-byte symbols requiring replacement	String that replaces symbol
`<`	`<`
`>`	`>`
`&`	`&`
`"`	`"`
`'`	`'`

The following figure shows the structure of an automatic maintenance policy file:

Figure 6‒37: Structure of automatic maintenance policy file

The tag on the first line indicates that the file is an XML file. The file is read according to the character encoding specified for the encoding parameter in this tag. If you omit this tag, the system assumes the file is encoded in UTF-8.

You must include the tags that indicate the file is an automatic maintenance policy file.

The List of automatic maintenance policy definitions (ID groups) and the List of automatic maintenance policy definitions (host groups) are each described below.

Organization of this subsection

(1) List of automatic maintenance policy definitions (ID groups)
(2) List of automatic maintenance policy definitions (host groups)

(1) List of automatic maintenance policy definitions (ID groups)

Format

Each definition has the format shown below. The line indentation indicates the relationship between parent and child tags. You must define a child tag within the appropriate parent.

<IDPolicyList>
  <IDPolicy>
    <IDName>ID-group-name</IDName>
    <IDPolicyKind>policy-type</IDPolicyKind>
    [<CondAssetFieldDefinitionValue>
      <AssetFieldDefinitionValue assetItem="asset-management-item">
        <AssetFieldDefinitionName>asset-management-item-name</AssetFieldDefinitionName>
        <AssetFieldDefinitionValue>asset-management-item-value</AssetFieldDefinitionValue>
      </AssetFieldDefinitionValue>
    </CondAssetFieldDefinitionValue>]
  </IDPolicy>
</IDPolicyList>

Description

The following table describes each tag, the values you can specify, and whether the tag can be omitted.

Tag	Description	Specifiable values	Can be omitted
`<IDPolicyList>`	Indicates that the following information is a list of definitions for automatic ID group maintenance policies.	--	Yes
`<IDPolicy>`	Indicates that the following information is a definition of an automatic ID group maintenance policy.	--	No
`<IDName>`	Specifies the name of the ID group.	Any character string not exceeding the equivalent of 32 bytes in Shift-JIS encoding, and excluding the following characters: Exclamation marks (`!`), double-quotation marks (`"`), percent signs (`%`), quotation marks (`'`), asterisks (`*`), periods (`.`), forward slashes (`/`), colons (`:`), left angle brackets (`<`), right angle brackets (`>`), question marks (`?`), at marks (`@`), backslashes (`\`), vertical bars (`\|`), single-byte spaces, and control characters	No
`<IDPolicyKind>`	Specifies the policy type.	For ID group registration of new hosts: `newHost` For ID group registration based on asset management items: `assetFieldDefinition`	No
`<CondAssetFieldDefinitionValue>`	Indicates that the following information is a list of definitions of conditions for ID group registration based on asset management items. Use this tag when `assetFieldDefinition` is specified in the `<IDPolicyKind>` tag.	--	Yes
`<AssetFieldDefinitionValue assetItem="asset-management-item">`	Indicates that the following information is a definition of a condition for ID group registration based on asset management items. As the value of the `assetItem` parameter, specify one of the following values depending on the type of asset management item: For additional management items in hardware asset information whose data type is enumeration: `true` For departments and installation locations: `false` You can specify a maximum of 10 sets of `<AssetFieldDefinitionValue>` tags per policy.	--	No
`<AssetFieldDefinitionName>`	Specifies the asset management item.^#	Department Installation location Enumeration type additional management items in hardware asset information	No
`<AssetFieldDefinitionValue>`	Specifies the value of the asset management item.^#	The selection item of the asset management item specified in `<AssetFieldDefinitionName>`.	No

Legend:: --: None. Yes: Can be omitted if there are no subordinate elements. No: Cannot be omitted.
#: When specifying an asset management item that is defined in more than one language, specify the item names and values in the default language.

To Page Top

(2) List of automatic maintenance policy definitions (host groups)

Format

Each definition has the format shown below. The line indentation indicates the relationship between parent and child tags. You must define a child tag within the appropriate parent.

<DestGroupPolicyList>
  <DestGroupPolicy>
    <DestGroupPolicyKind>policy-type</DestGroupPolicyKind>
    [<CondIpAddress>
      <FromIpAddress>lower-IP-address-limit</FromIpAddress>
      <ToIpAddress>upper-IP-address-limit</ToIpAddress>
    </CondIpAddress>]
    [<CondOSKind>
      <OsKind>OS</OsKind>
    </CondOSKind>]
    [<CondOSKindOption>
      <CpuKind>CPU-type</CpuKind>
      <OsSubversion>OS-subversion</OsSubversion>
    </CondOSKindOption>]
    [<CondAssetCostumField>
      <AssetCostumFieldName>additional-management-item-of-hardware-asset-information</AssetCostumFieldName>
    </CondAssetCostumField>]
    [<CondDepartmentGroup>
      <TargetGroupRange>number-of-department-tiers</TargetGroupRange>
    </CondDepartmentGroup>]
    [<CondLocationGroup>
      <TargetGroupRange>number-of-installation-location--tiers</TargetGroupRange>
    </CondLocationGroup>]
    [<DestGroupPath>route-of-application-target-host-group</DestGroupPath>]
    [<DestGroupName>name-of-application-target-host-group</DestGroupName>]
    [<DestGroupTargetHostKind>management-type-of-target-computer</DestGroupTargetHostKind>]
  </DestGroupPolicy>
</DestGroupPolicyList>

Description

The following table describes each tag, the values you can specify, and whether the tag can be omitted.

Tag	Description	Specifiable values	Can be omitted
`<DestGroupPolicyList>`	Indicates that the following information is a list of definitions for automatic maintenance of destination group policies.	--	Yes
`<DestGroupPolicy>`	Indicates that the following information is a definition of an automatic maintenance of destination group policy.	--	No
`<DestGroupPolicyKind>`	Specifies the policy type.	To group by IP address: `ipAddress` To group by OS type: `osType` To group new hosts: `newHost` To group based on additional management items of hardware asset information: `assetCostumField` To group based on department information: `departmentGroup` To group based on installation location information: `locationGroup`	No
`<CondIpAddress>`	Indicates that the following information is the definition of an IP address group. Use this tag when `ipAddress` is specified in the `<DestGroupPolicyKind>` tag.	--	Yes
`<FromIpAddress>`	Specifies the start address of the IP address range.	An IP address in IPv4 format.	No
`<ToIpAddress>`	Specifies the end address of the IP address range.	An IP address in IPv4 format.	No
`<CondOSKind>`	Indicates that the following information defines conditions for grouping by OS type. Use this tag when `osType` is specified in the `<DestGroupPolicyKind>` tag.	--	Yes
`<OsKind>`	Specifies the OS type.	`WindowsXP` `WindowsServer2003` `WindowsVista` `WindowsServer2008` `Windows7` `WindowsServer2008R2` `Windows8` `WindowsServer2012` `Windows8_1` `WindowsServer2012R2`	No
`<CondAssetCostumField>`	Indicates that the following information defines conditions for grouping based on additional management items of hardware asset information. Use this tag when `assetCostumField` is specified in the `<DestGroupPolicyKind>` tag.	--	Yes
`<AssetCostumFieldName>`	Specifies an additional management item of hardware asset information. You can specify a maximum of 6 sets of `<AssetCostumFieldName>` tags per policy.^#	An additional management item in hardware asset information whose data type is enumeration or text	No
`<CondDepartmentGroup>`	Indicates that the following information defines conditions for grouping based on department information. Use this tag when `departmentGroup` is specified in the `<DestGroupPolicyKind>` tag.^#	--	Yes
`<CondLocationGroup>`	Indicates that the following information defines conditions for grouping based on installation location. Use this tag when `locationGroup` is specified in the `<DestGroupPolicyKind>` tag.	--	Yes
`<TargetGroupRange>`	Specifies the tiers to be grouped by department or installation location.	`1` to `6`	No
`<DestGroupPath>`	Specifies the route to the host group that is to be subject to automatic maintenance. If you omit this tag, the policy is assigned to all destinations. You can specify this tag when the following values are specified in the `<DestGroupPolicyKind>` tag: `ipAddress` `osType` `assetCostumField` `departmentGroup` `locationGroup`	A route containing the equivalent of no more than 190 bytes of Shift-JIS-encoded characters (including the delimiting character `\`), in which the host group name is a character string equivalent to no more than 32 bytes of Shift-JIS-encoded characters.	Yes
`<DestGroupName>`	Specifies the host group that is to be subject to automatic maintenance. You can specify this tag when the following values are specified in the `<DestGroupPolicyKind>` tag: `ipAddress` `osType` `newHost`	Any character string containing the equivalent of no more than 32 bytes of Shift-JIS encoded characters, and excluding the following characters: Exclamation marks (`!`), double-quotation marks (`"`), percent signs (`%`), quotation marks (`'`), asterisks (`*`), periods (`.`), forward slashes (`/`), colons (`:`), left angle brackets (`<`), right angle brackets (`>`), question marks (`?`), at marks (`@`), backslashes (`\`), vertical bars (`\|`), single-byte spaces, and control characters	Yes
`<DestGroupTargetHostKind>`	Specifies the type of host to subject to automatic maintenance. If you omit this tag, the policy applies to all hosts.	To apply the policy to all hosts (relay systems and agents): `all` To apply the policy to agents only: `agentOnly`	Yes
`<CondOSKindOption>`	Indicates that the following information defines optional detailed conditions for grouping hosts by OS type. Use this tag when `osType` is specified in the `<DestGroupPolicyKind>` tag.	--	Yes
`<CpuKind>`	Specifies whether to separate 32-bit and 64-bit hosts into different groups. If you omit this tag, 32 and 64-bit hosts are placed in the same group.	To separate hosts: `true` To not separate hosts: `false`	Yes
`<OsSubversion>`	Specifies whether to further group hosts based on their OS sub-version. If you omit this tag, hosts are not grouped by sub-version.	To group by sub-version: `true` To not group by sub-version: `false`	Yes

Legend:: --: None. Yes: Can be omitted if there are no subordinate elements. No: Cannot be omitted.
#: When specifying an asset management item that is defined in more than one language, specify the item names and values in the default language.

To Page Top