6.4.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 automatic maintenance policy file shown in Figure 6-33 includes the List of automatic maintenance policy definitions (ID groups) followed by the List of automatic maintenance policy definitions (for host groups). However, automatic maintenance policy files can be imported successfully regardless of the order of the two lists. When automatic maintenance policy definitions are exported to a file, firstly the list of host group policy definitions is written to the 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.
The tags must be written in the following order:
<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>] [<CondInventoryInfoValue> <CondInventoryInfoName>device-information-policy-name</CondInventoryInfoName> <CondInventoryInfoList> [<ComputerInfo> [<Model filterType="comparison condition">model</Model>] [<Manufacturer filterType="comparison condition">manufacturer</Manufacturer>] </ComputerInfo>] [<NetworkInfo> <FromIpAddress>lower-IP-address-limit</FromIpAddress> <ToIpAddress>upper-IP-address-limit</ToIpAddress> </NetworkInfo>] [<SoftwareInfo installStatus="installation-status"> <SoftwareName filterType="comparison condition">software-name</SoftwareName> [<Version filterType="comparison condition"> <VersionValue1>version</VersionValue1> [<VersionValue2>version</VersionValue2>] </Version>] </SoftwareInfo>] [<AssetFieldDefinitionInfo> <AssetFieldDefinitionName>asset-management-item-name </AssetFieldDefinitionName> <FieldValue filterType="comparison condition"> <FieldValue1>asset-management-item-value</FieldValue1> [<FieldValue2>asset-management-item-value</FieldValue2>] </FieldValue> </AssetFieldDefinitionInfo>] </CondInventoryInfoList> </CondInventoryInfoValue>] </IDPolicy> </IDPolicyList>
Description
The following table describes each tag, the values you can specify, and the allowed number of occurrences of the tag. When the allowed number of occurrences is zero, you can omit the tag unless there is a child element.
Tag |
Description |
Specifiable values |
Allowed number of occurrences of the tag |
---|---|---|---|
<IDPolicyList> |
Indicates that the following information is a list of definitions for automatic ID group maintenance policies. |
-- |
0 times or once |
<IDPolicy> |
Indicates that the following information is a definition of an automatic ID group maintenance policy. |
-- |
More than once |
<IDName> |
Specifies the name of the ID group. |
Any character string of up to 32 bytes (including single-byte and/or double-byte characters) 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 |
Once |
<IDPolicyKind> |
Specifies the policy type. |
|
Once |
<CondAssetFieldDefinitionValue> |
Indicates that the following information defines ID group registration based on asset management items. Use this tag when assetFieldDefinition is specified in the <IDPolicyKind> tag. |
-- |
0 times or once |
<AssetFieldDefinitionValue assetItem="asset-management-item"> |
Indicates that the following information defines a condition on an asset management item. 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. |
-- |
More than once |
<AssetFieldDefinitionName> |
Specifies the asset management item.# |
|
Once |
<AssetFieldDefinitionValue> |
Specifies the value of the asset management item.# |
The selection item of the asset management item specified in <AssetFieldDefinitionName>. |
Once |
<CondInventoryInfoValue> |
Indicates that the following information defines ID group registration based on device information. Use this tag when inventoryInfo is specified in the <IDPolicyKind> tag. |
-- |
0 times or once |
<CondInventoryInfoName> |
Specifies a device information policy name. |
Any character string with a length of at least one character (up to 64 bytes) |
Once |
<CondInventoryInfoList> |
Indicates that the following information is a list of device information conditions. A policy has up to 10 device information conditions (that is, a <CondInventoryInfoList> node has up to 10 child nodes). |
-- |
Once |
<ComputerInfo> |
Indicates that the following information defines a condition on computer details. |
-- |
0 times or once |
<Model filterType="comparison condition"> |
Specifies a model. filterType specifies a comparison condition for the specified model. Omitting this tag means that there is no model condition. |
|
0 times or once |
<Manufacturer filterType="comparison condition"> |
Specifies a manufacturer. filterType specifies a comparison condition for the specified manufacturer. Omitting this tag means that there is no manufacturer condition. |
|
0 times or once |
<NetworkInfo> |
Indicates that the following information defines a condition on network details. |
-- |
0 times or once |
<FromIpAddress> |
Specifies the start address of an IP address range. |
An IP address in IPv4 format (xxx.xxx.xxx.xxx) |
Once |
<ToIpAddress> |
Specifies the end address of an IP address range. |
An IP address in IPv4 format (xxx.xxx.xxx.xxx) |
Once |
<SoftwareInfo installStatus="installation-status"> |
Indicates that the following information defines a condition on software details. installStatus specifies whether the software program is installed. |
Omitting installStatus has the same effect as setting it to false. |
0 times or once |
<SoftwareName filterType="comparison condition"> |
Specifies a software name. filterType specifies a comparison condition for the specified software name. |
|
Once |
<Version filterType="comparison condition"> |
Indicates that the following information defines a condition on the version. filterType specifies a comparison condition for the specified version. Omitting this tag means that there is no version condition. |
|
0 times or once |
<VersionValue1> |
Specifies a specific version, or the start value of a range of versions. |
Any character string with a length of at least one character (up to 256 bytes) |
Once |
<VersionValue2> |
Specifies the end value of a range of versions. This tag can be specified when a range is specified (that is, the filterType attribute of the Version tag is set to between). |
Any character string with a length of at least one character (up to 256 bytes) |
0 times or once |
<AssetFieldDefinitionInfo> |
Indicates that the following information defines a condition on an asset management item. You can specify different conditions for different asset management items (that is, you cannot specify multiple conditions for the same asset management item). |
-- |
More than 0 times or once |
<AssetFieldDefinitionName> |
Specifies the name of an asset management item.# You can specify a user-defined text item that is an additional management item of hardware asset information. |
-- |
Once |
<FieldValue filterType="comparison condition"> |
Indicates that the following information defines a condition on the value of an asset management item. filterType specifies a comparison condition for the asset management item value. |
|
Once |
<FieldValue1> |
Specifies a specific value of the asset management item, or the start value of a range of the asset management item values. |
Any character string with a length of at least one character (up to 512 bytes) |
Once |
<FieldValue2> |
Specifies the end value of a range of the asset management item values. This can be specified when a range is specified (that is, the filterType attribute of the FieldValue tag is set to between). |
Any character string with a length of at least one character (up to 512 bytes) |
0 times or once |
(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.
The tags must be written in the following order:
<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 the allowed number of occurrences of the tag. When the allowed number of occurrences is zero, you can omit the tag unless there is a child element.
Tag |
Description |
Specifiable values |
Allowed number of occurrences of the tag |
---|---|---|---|
<DestGroupPolicyList> |
Indicates that the following information is a list of definitions for automatic maintenance of destination group policies. |
-- |
0 times or once |
<DestGroupPolicy> |
Indicates that the following information is a definition of an automatic maintenance of destination group policy. |
-- |
More than once |
<DestGroupPolicyKind> |
Specifies the policy type. |
|
Once |
<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. |
-- |
0 times or once |
<FromIpAddress> |
Specifies the start address of the IP address range. |
An IP address in IPv4 format. |
Once |
<ToIpAddress> |
Specifies the end address of the IP address range. |
An IP address in IPv4 format. |
Once |
<CondOSKind> |
Indicates that the following information defines conditions for grouping by OS type. Use this tag when osType is specified in the <DestGroupPolicyKind> tag. |
-- |
0 times or once |
<OsKind> |
Specifies the OS type. |
|
Once |
<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. |
-- |
0 times or once |
<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 |
More than once |
<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.# |
-- |
0 times or once |
<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. |
-- |
0 times or once |
<TargetGroupRange> |
Specifies the tiers to be grouped by department or installation location. |
1 to 6 |
Once |
<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:
|
Any character string of up to 32 bytes (including single-byte and/or double-byte characters) 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 |
0 times or once |
<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 of up to 32 bytes (including single-byte and/or double-byte characters) 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 |
0 times or once |
<DestGroupTargetHostKind> |
Specifies the type of host to subject to automatic maintenance. If you omit this tag, the policy applies to all hosts. |
|
0 times or once |
<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. |
-- |
0 times or once |
<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. |
|
0 times or once |
<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. |
|
0 times or once |