Upload
others
View
19
Download
0
Embed Size (px)
Citation preview
Configuring Manageability
This module describes the configuration required to enable the Extensible Markup Language (XML) agentservices. The XML Parser Infrastructure provides parsing and generation of XML documents with DocumentObject Model (DOM), Simple Application Programming Interface (API) for XML (SAX), and DocumentType Definition (DTD) validation capabilities:
• DOM allows customers to programmatically create, manipulate, and generate XML documents.• SAX supports user-defined functions for XML tags.• DTD allows for validation of defined document types.
• Information about XML Manageability, on page 1• How to Configure Manageability, on page 1• Configuration Examples for Manageability, on page 2
Information about XML ManageabilityThe Cisco IOS XR ExtensibleMarkup Language (XML) API provides a programmable interface to the routerfor use by external management applications. This interface provides a mechanism for router configurationand monitoring utilizing XML formatted request and response streams. The XML interface is built on top ofthe Management Data API (MDA), which provides a mechanism for Cisco IOS XR components to publishtheir data models through MDA schema definition files.
Cisco IOS XR software provides the ability to access the router via XML using a dedicated TCP connection,Secure Socket Layer (SSL), or a specific VPN routing and forwarding (VRF) instance.
How to Configure Manageability
Configuring the XML AgentThis explains how to configure the XML agent.
Configuring Manageability1
Procedure
PurposeCommand or Action
Enables Extensible Markup Language (XML)requests over a dedicated TCP connection and
xml agent [ssl]
Example:
Step 1
enters XML agent configuration mode. Use theRP/0/RP0/CPU0:router(config)# xml agent ssl keyword to enable XML requests over
Secure Socket Layer (SSL).
Configures the iteration size for large XMLagent responses in KBytes. The default is 48.
iteration on size iteration-size
Example:
Step 2
RP/0/RP0/CPU0:router(config-xml-agent)#iteration on size 500
Configures an idle timeout for the XML agentin minutes. By default, there is no timeout.
session timeout timeout
Example:
Step 3
RP/0/RP0/CPU0:router(config-xml-agent)#session timeout 5
Configures the XML agent processingcapabilities.
throttle{memory size | process-rate tags}
Example:
Step 4
• Specify the memory size in Mbytes.Values can range from 100 to 600. In IOS
RP/0/RP0/CPU0:router(config-xml-agent)#throttle memory 300
XR 64 bit, the values range from 100 to1024. The default is 300.
• Specify the process-rate as the number oftags that the XML agent can process persecond. Values can range from 1000 to30000. By default the process rate is notthrottled.
Configures the dedicated agent or SSL agent toreceive and send messages via the specifiedVPN routing and forwarding (VRF) instance.
vrf { vrfname | ipv4} [access-listaccess-list-name]
Example:
Step 5
RP/0/RP0/CPU0:router(config-xml-agent)#vrf mgmt-vrf
Configuration Examples for Manageability
Enabling VRF on an XML Agent: Examples
The following example illustrates how to configure the dedicated XML agent to receive and sendmessages via VRF1, VRF2 and the default VRF:
Configuring Manageability2
Configuring ManageabilityConfiguration Examples for Manageability
RP/0/RP0/CPU0:router(config)# xml agentRP/0/RP0/CPU0:router(config-xml-agent)# vrf VRF1RP/0/RP0/CPU0:router(config-xml-agent)# vrf VRF2
The following example illustrates how to remove access to VRF2 from the dedicated agent:RP/0/RP0/CPU0:router(config)# xml agent sslRP/0/RP0/CPU0:router(config-xml-ssl)# vrf VRF1RP/0/RP0/CPU0:router(config-xml-ssl-vrf)# vrf VRF2
RP/0/RP0/CPU0:router(config)# xml agentRP/0/RP0/CPU0:router(config-xml-agent)# no vrf VRF1
The following example shows how to configure the XML SSL agent to receive and send messagesthrough VRF1, VRF2 and the default VRF:RP/0/RP0/CPU0:router(config)# xml agent sslRP/0/RP0/CPU0:router(config-xml-agent)# vrf VRF1RP/0/RP0/CPU0:router(config-xml-agent)# vrf VRF2
The following example removes access for VRF2 from the dedicated XML agent:RP/0/RP0/CPU0:router(config)# xml agent sslRP/0/RP0/CPU0:router(config-xml-agent)# no vrf VRF2
Configuring Manageability3
Configuring ManageabilityEnabling VRF on an XML Agent: Examples
Configuring Manageability4
Configuring ManageabilityEnabling VRF on an XML Agent: Examples