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.
Single-byte symbols requiring replacement |
String that replaces symbol |
---|---|
< |
< |
> |
> |
& |
& |
" |
" |
' |
' |
The following figure shows the structure of an 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)
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. |
|
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:
You can specify a maximum of 10 sets of <AssetFieldDefinitionValue> tags per policy. |
-- |
No |
<AssetFieldDefinitionName> |
Specifies the asset management item.# |
|
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.
(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. |
|
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. |
|
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:
|
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:
|
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. |
|
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. |
|
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. |
|
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.