����Document Type Definition�iDTD�j���g�p���āACSM �� xml�C���^�[�t�F�C�X�̐ݒ� �ɋL�q����Ă���悤�ɐݒ肷�邱�Ƃ��ł��܂��B
* cisco_csm.dtd - XML DTD for CSM 3.2
* Copyright (c) 2002, 2003 by cisco Systems, Inc.
Each element refers to a particular IOS CLI command.
Each attribute refers to a command parameter.
Except where noted, all "name" attributes are strings of length
IP address and mask attributes use standard "x.x.x.x" format.
*************************************************************
Elements and attributes required by various other elements
*************************************************************
<!ELEMENT inservice_standby EMPTY>
backup_name is a string of length 1 to 15
<!ELEMENT serverfarm_ref EMPTY>
backup_sticky (yes | no) #IMPLIED
value is between 1 and 4294967295
<!ELEMENT reverse_sticky EMPTY>
*************************************************************
Elements and attributes required for env_variable
*************************************************************
name is a string of length 1 to 31
expression is a string of length 0 to 127
*************************************************************
Elements and attributes required for owner
*************************************************************
<!ELEMENT owner (maxconns?, billing_info?, contact_info?)>
*************************************************************
Elements and attributes required for vlan
*************************************************************
gateway uses standard x.x.x.x format
Maximum of 7 gateways per vlan
Maximum of 4095 routes per vlan
Maximum of 255 aliases per vlan
Global maximum of 255 unique vlan_addresses
Global maximum of 255 vlan gateways (including routed gateways)
<!ELEMENT vlan (vlan_address?, gateway*, route*, alias*)>
type (client | server) #REQUIRED
*************************************************************
Elements and attributes required for script_file and script_task
*************************************************************
url is a string of length 1 to 200
name is a string of length 1 to 31
arguments is a string of length 0 to 199
*************************************************************
Elements and attributes required for probe
*************************************************************
value is between 2 and 65535 (default is 300)
value is between 2 and 65535 (default is 120)
<!ELEMENT probe_interval EMPTY>
value is between 0 and 65535 (default is 3)
<!ELEMENT probe_retries EMPTY>
value is between 1 and 65535 (default 10)
value is between 1 and 65535 (default 10)
<!ELEMENT probe_receive EMPTY>
<!ELEMENT probe_address EMPTY>
mode (transparent | routed) "transparent"
<!ELEMENT probe_expect_address EMPTY>
<!ATTLIST probe_expect_address
expression is a string of length 1 to 200
user is a string of length 1 to 15
password is a string of length 1 to 15
<!ELEMENT probe_credentials EMPTY>
url is a string of length 1 to 200
<!ELEMENT probe_request EMPTY>
max_code default is match min_code
<!ELEMENT probe_expect_status EMPTY>
name is a string of length 1 to 31
arguments is a string of length 0 to 199
secret is a string of length 1 to 32
Maximum of 255 probe_headers per http_probe
probe_address must use mode "routed"
<!ELEMENT http_probe (probe_failed?, probe_interval?, probe_retries?,
probe_open?, probe_receive?, probe_port?, probe_address?,
probe_request?, probe_credentials?, probe_header*,
Maximum of 255 probe_expect_addresses per dns_probe
probe_address must use mode "routed"
<!ELEMENT dns_probe (probe_failed?, probe_interval?, probe_retries?,
probe_receive?, probe_port?, probe_address?, probe_domain?,
probe_address must use mode "transparent"
<!ELEMENT icmp_probe (probe_failed?, probe_interval?, probe_retries?,
probe_receive?, probe_address?)
<!ELEMENT tcp_probe (probe_failed?, probe_interval?, probe_retries?,
<!ELEMENT udp_probe (probe_failed?, probe_interval?, probe_retries?,
<!ELEMENT smtp_probe (probe_failed?, probe_interval?, probe_retries?,
probe_open?, probe_receive?, probe_port?,
<!ELEMENT telnet_probe (probe_failed?, probe_interval?, probe_retries?,
probe_open?, probe_receive?, probe_port?,
<!ELEMENT ftp_probe (probe_failed?, probe_interval?, probe_retries?,
probe_open?, probe_receive?, probe_port?,
<!ELEMENT script_probe (probe_failed?, probe_interval?, probe_retries?,
probe_open?, probe_receive?, probe_port?, script_ref?)
probe_address must use mode "routed"
<!ELEMENT kalap_udp_probe (probe_failed?, probe_interval?, probe_retries?,
probe_receive?, probe_port?, probe_address?,
probe_address must use mode "routed"
<!ELEMENT kalap_tcp_probe (probe_failed?, probe_interval?, probe_retries?,
probe_open?, probe_receive?, probe_port?,
probe_address?, probe_secret?)
<!ELEMENT probe (http_probe | dns_probe | icmp_probe | tcp_probe | udp_probe |
smtp_probe | telnet_probe | ftp_probe | script_probe |
kalap_udp_probe | kalap_tcp_probe)
type (http | dns | icmp | tcp | udp |
smtp | telnet | ftp | script |
kal-ap-udp | kal-ap-tcp) #REQUIRED
*************************************************************
Elements and attributes required for natpool
*************************************************************
Global maximum of 255 natpool addresses
*************************************************************
Elements and attributes required by maps
*************************************************************
url is a string of length 1 to 200
method is a string of length 1 to 15 (e.g. GET)
name is a string of length 1 to 63
expression is a string of length 1 to 127
name is a string of length 1 to 63
expression is a string of length 1 to 127
min_code and max_code are between 100 and 599
threshold is between 1 and 4294967295, no effect for count action
reset is between 0 and 4294967295 (0 means no reset)
action (count | log | remove) #REQUIRED
domain is a string of length 1 to 127
Maximum of 1023 url_rules per map
<!ELEMENT url_map (url_rule*)>
Maximum of 5 cookie_rules per map
<!ELEMENT cookie_map (cookie_rule*)>
Maximum of 5 header_rules per map
<!ELEMENT header_map (header_rule*)>
Maximum of 100 retcodes (not ranges) per map
<!ELEMENT retcode_map (retcode_rule*)>
Maximum of 16 dns_rules per map
<!ELEMENT dns_map (dns_rule*)>
*************************************************************
Elements and attributes required for redirect_server
*************************************************************
<!ELEMENT redirect_relocate EMPTY>
<!ELEMENT redirect_backup EMPTY>
<!ELEMENT redirect_server (ssl_port?, redirect_relocate?, redirect_backup?,
*************************************************************
Elements and attributes required for named_real_server
*************************************************************
<!ELEMENT named_real_server (real_address?, location?)>
*************************************************************
Elements and attributes required for real_server
*************************************************************
value is between 1 and 4294967295
value is between 2 and 254 (default is 254)
<!ELEMENT load_threshold EMPTY>
tag is a string of length 0 to 32
<!ELEMENT real_probe_ref EMPTY>
either ipaddress or named_real_server_ref is required
port is between 0 and 65535 (0 means no port translation)
<!ELEMENT real_server_backup EMPTY>
named_real_server_ref CDATA #IMPLIED
either ipaddress or named_real_server_ref is required
port is between 0 and 65535 (0 means no port translation)
Global maximum of 4095 real_servers
<!ELEMENT real_server (weight?, minconns?, maxconns?, load_threshold?,
real_probe_ref?, real_server_backup?, inservice?,
named_real_server_ref CDATA #IMPLIED
*************************************************************
Elements and attributes required for serverfarm
*************************************************************
<!ELEMENT retcode_map_ref EMPTY>
retries is between 0 and 65534
value (purge | reassign) #REQUIRED
hash_ip_type and ipmask valid only when value = hash_ip
value (roundrobin | leastconns |
hash_ip | hash_url | forward) #REQUIRED
hash_ip_type (source | destination | both) "both"
ipmask NMTOKEN "255.255.255.255"
<!ELEMENT dns_predictor EMPTY>
value (roundrobin | ordered-list |
hash_ip | hash_ip_domain) #REQUIRED
<!ELEMENT serverfarm (predictor?, natpool_ref?, server_nat?, health?,
bind_id?, retcode_map_ref?, failaction?,
redirect_server*, real_server*, probe_ref*)
real_server "port" attribute is ignored
<!ELEMENT dns_serverfarm (dns_predictor?, real_server*)>
type (dns-vip | dns-ns) #REQUIRED
*************************************************************
Elements and attributes required for sticky_group
*************************************************************
src_ip and dest_ip are necessary for IP-based sticky_groups
expression is necessary for SSL, cookie, and header-based sticky_groups
expression is a string of length 0 to 127
<!ELEMENT static_sticky EMPTY>
This only applies to cookie and header-based sticky_groups
<!ELEMENT sticky_offset EMPTY>
This only applies to cookie-based sticky_groups
name is a string of length 1 to 63
<!ELEMENT cookie_secondary EMPTY>
timeout is between 1 and 65535
cookie is a string of length 1 to 63, req for type=cookie or cookie_insert
header is a string of length 1 to 63, req for type=header
<!ELEMENT sticky_group (sticky_offset?, cookie_secondary?, static_sticky*)>
ip_src | ip_dest | ip_src_dest |
cookie_insert | header) #REQUIRED
*************************************************************
Elements and attributes required for policy
*************************************************************
<!ELEMENT cookie_map_ref EMPTY>
<!ELEMENT header_map_ref EMPTY>
order is between 1 and 3 (corresponds to "primary", "secondary", "tertiary")
ttl is between 1 and 604800 (default is 20)
response_count is between 1 and 8 (default is 1)
<!ELEMENT dns_serverfarm_ref EMPTY>
response_count NMTOKEN #IMPLIED
Reference to an IOS standard IP access list
Specify either the id (range 1 to 99) or name
name is a string of length 1 to 200
<!ELEMENT client_group_ref EMPTY>
<!ELEMENT sticky_group_ref EMPTY>
<!ELEMENT policy (serverfarm_ref?, client_group_ref?, sticky_group_ref?,
reverse_sticky?, dscp?, url_map_ref?, cookie_map_ref?,
Maximum of 3 dns_serverfarm_refs per dns_policy (one for each order)
<!ELEMENT dns_policy (dns_serverfarm_ref*, client_group_ref?, dns_map_ref?)>
*************************************************************
Elements and attributes required for vserver
*************************************************************
protocol is between 0 and 255 (0 = any, 1 = icmp, 6 = tcp, 17 = udp)
port is between 0 and 65535 (0 means any)
ftp and termination service valid only for tcp protocol
rtsp service valid for tcp and udp protocol
per-packet service valid only for non-tcp protocols
ipmask NMTOKEN "255.255.255.255"
termination | per-packet) "none"
ipmask NMTOKEN "255.255.255.255"
timeout is between 1 and 65535
group is between 0 and 255 (if nonzero, refers to an ip sticky_group)
ipmask NMTOKEN "255.255.255.255"
<!ELEMENT dns_policy_ref EMPTY>
begin and end are strings, 0-length ok
total length of begin and end should not exceed 200
<!ELEMENT replicate_csrp EMPTY>
value (sticky | connection) #REQUIRED
value (always | active) #REQUIRED
<!ELEMENT unidirectional EMPTY>
sense (yes | no | default) #IMPLIED
<!ELEMENT ssl_sticky_offset EMPTY>
Maximum of 1023 domains per vserver
<!ELEMENT vserver (virtual?, vlan_id?, unidirectional?, owner_ref?,
maxconns?, ssl_sticky_offset?, idle?, pending?,
replicate_csrp?, advertise?, persistent?, parse_length?,
inservice?, url_hash?, policy_ref*, domain*,
serverfarm_ref?, sticky?, reverse_sticky?, client*)
<!ELEMENT dns_vserver (inservice?, dns_policy_ref*)>
*************************************************************
Elements and attributes required for dfp
*************************************************************
timeout is between 0 and 65535
retry is between 0 and 65535 (must specify timeout)
interval is between 1 and 65535 (must specify retry)
password is a string of length 1 to 64
timeout is between 0 and 65535
<!ELEMENT dfp (dfp_manager?, dfp_agent*)>
*************************************************************
Elements and attributes required for udp_capp
*************************************************************
secret is a string of length 1 to 32
<!ELEMENT udp_capp (capp_port?, capp_secure?, capp_options*)>
*************************************************************
Elements and attributes required for ft
*************************************************************
vlan_id is between 2 and 4094, and must *not* match id of
existing client or server vlan configured for csm_module
<!ELEMENT ft (ft_preempt?, ft_priority?, ft_failover?, ft_heartbeat?)>
*************************************************************
Elements and attributes required for static_nat
*************************************************************
ipmask NMTOKEN "255.255.255.255"
ipaddress is required for type=ip
Global maximum of 16383 static_reals
<!ELEMENT static_nat (static_real*)>
type (drop | ip | virtual) #REQUIRED
*************************************************************
Elements and attributes required for static_arp
*************************************************************
macaddress has the form "hhhh.hhhh.hhhh", where h is a hex digit
*************************************************************
root definition for csm_module
*************************************************************
slot is between 1 and MAXSLOT (depends on chassis)
Maximum of 4095 serverfarms and dns_serverfarms
Maximum of 255 sticky_groups (including those id=0 groups created
Maximum of 4000 vservers and dns_vservers
Maximum of 16383 static_arp entries
<!ELEMENT csm_module (env_variable*, owner*, vlan*, script_file*, script_task*,
probe*, natpool*, url_map*, cookie_map*, header_map*,
retcode_map*, dns_map*, named_real_server*,
serverfarm*, dns_serverfarm*, sticky_group*,
policy*, dns_policy*, vserver*, dns_vserver*,
dfp?, udp_capp?, ft?, static_nat*, static_arp*)
*************************************************************
*************************************************************
error_tolerance is a 32-bit value, specified
in hex or decimal, which acts as a bitmask
for specifying which error types should be
ignored. valid error types below. Default is 0x0048.
dtd_version is a string that specifies the set of
configurable CSM features, and should match the CSM version
specified at the top of this DTD. Default is "2.2".
Note that if the version is higher than the CSM can
handle, an error may be returned. In most cases,
the CSM will do its best to interpret the document,
even if dtd_version is missing or higher than expected.
<!ELEMENT config (csm_module)>
error_tolerance NMTOKEN #IMPLIED
In case of error, the response document will include an "error" child element
in the offending element. The error element takes the form:
The body of the error element is a description string.
Attribute "code" is a hex value representing a mask of possible error codes:
XML_ERR_INTERNAL = 0x0001 /* internal memory or coding error */
XML_ERR_COMM_FAILURE = 0x0002 /* communication failure */
XML_ERR_WELLFORMEDNESS = 0x0004 /* not a wellformed XML document */
XML_ERR_ATTR_UNRECOGNIZED = 0x0008 /* found an unrecognized attribute */
XML_ERR_ATTR_INVALID = 0x0010 /* found invalid value in attribute */
XML_ERR_ATTR_MISSING = 0x0020 /* required attribute missing */
XML_ERR_ELEM_UNRECOGNIZED = 0x0040 /* found an unrecognized element */
XML_ERR_ELEM_INVALID = 0x0080 /* found invalid element */
XML_ERR_ELEM_MISSING = 0x0100 /* required element missing */
XML_ERR_ELEM_CONTEXT = 0x0200 /* valid element found in wrong place */
XML_ERR_IOS_PARSER = 0x0400 /* IOS unable to parse command */
XML_ERR_IOS_MODULE_IN_USE = 0x0800 /* Another user is configuring CSM */
XML_ERR_IOS_WRONG_MODULE = 0x1000 /* Tried to configure unavailable CSM */
