The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
Your software release may not support all the features documented in this module. For the latest caveats and feature information, see Bug Search Tool and the release notes for your platform and software release. To find information about the features documented in this module, and to see a list of the releases in which each feature is supported, see the feature information table.
Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to www.cisco.com/go/cfn. An account on Cisco.com is not required.
To ensure that a router has Capabilities Manager available, enter the showservice-routingplugincapman command. To enable a router to distribute its capabilities information, configure a SAF Forwarder on the router.
To view capabilities information present on other routers in the network, configure a SAF Forwarder.
Capabilities Manager is enabled by default at system startup. At startup, it registers as a Service Routing Client and proceeds to discover various capabilities of the hardware and software platform.
Capabilities Manager only discovers whether a capability is supported on the local system. It does not discover whether the capability is configured or enabled or discover any other information about the capability for other routers in the network.
Capabilities information will be installed into the local Network Information Base (NIB) as service routing data and made available for advertisement by any SAF Forwarder to the Service Routing network. Capabilities information is passed to the Service Routing infrastructure in XML format and stored in the local NIB.
Capabilities Manager does not advertise capabilities information to the Service Routing network. A SAF Forwarder performs the functions to distribute capabilities information. However, a SAF Forwarder is not required for Capabilities Manager to function. If a SAF Forwarder is not configured, the capabilities information is bound to the local router and is not distributed to other routers in the network. When a SAF Forwarder is configured, it will distribute all capabilities information by default.
Capabilities information is installed in the Network Information Base (NIB) as service routing data. It is identified by a SAF address in the form of:
service ID—Capabilities Manager uses service ID 100.
subservice ID—Capability group ID. The subservice ID indicates the group ID of the capabilities data type.
Instance number—Unique identifier for the local router. It is assigned in order of the hardware serial number, default MAC address, IPv4 router ID, or IPv6 router ID.
Capabilities Manager classifies capabilities by group to facilitate query and retrieval, and assigns each group a unique ID. Capabilities Manager provides the following capability groups:
Hardware information is designated as group ID 1. Group 1 provides the following capabilities information, when available. All hardware information may not be available on each platform that supports Capabilities Manager.
Software information is designated as group ID 2. Group 2 provides the following capabilities information, when available. All software information may not be available on each platform that supports Capabilities Manager.
If you have an Extensible Messaging Client Protocol (XMCP) client (external client) connected to a SAF Forwarder, you can subscribe to the Capabilities Manager, which is service ID 100. The data can be interpreted using the following XML schema:
<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs='http://www.w3.org/2001/XMLSchema'>
<xs:element name="Capabilities" type="CapabilitiesType" />
<xs:complexType name="CapabilitiesType">
<xs:sequence>
<xs:element ref="Group" minOccurs="1" maxOccurs="unbounded" />
</xs:sequence>
</xs:complexType>
<xs:element name="Group" type="GroupType" />
<xs:complexType name="GroupType">
<xs:sequence>
<xs:element ref="Capability" minOccurs="1" maxOccurs="unbounded" />
</xs:sequence>
<xs:attribute name="Name" type="xs:normalizedString" use="required" />
</xs:complexType>
<xs:element name="Capability" type="CapabilityType" />
<xs:complexType name="CapabilityType">
<xs:sequence>
<xs:element name="Value" type="xs:normalizedString" />
</xs:sequence>
<xs:attribute name="Name" type="xs:normalizedString" use="required" />
</xs:complexType>
</xs:schema>
Example:
<Capabilities>
<Group Name="HARDWARE">
<Capability Name="HostName">
<Value>R100</Value>
</Capability>
<Capability Name="Platform">
<Value>Solaris Unix (Sparc) processor</Value>
</Capability>
<Capability Name="MainMemorySize">
<Value>63683Kbytes</Value>
</Capability>
</Group>
<Group Name="SOFTWARE">
<Capability Name="HostName">
<Value>R100</Value>
</Capability>
<Capability Name="Software">
<Value>Cisco IOS Software</Value>
</Capability>
<Capability Name="Image">
<Value>Solaris Software (UNIX-ADVENTERPRISE-M)</Value>
</Capability>
<Capability Name="Version">
<Value>Experimental Version 15.1(20110323:093227)</Value>
</Capability>
<Capability Name="ipmulticast">
<Value>Subsystem loaded</Value>
</Capability>
<Capability Name="eigrp_ipv4">
<Value>Subsystem loaded</Value>
</Capability>
</Group>
</Capabilities>
Capabilities Manager is enabled by default. You can disable and reenable Capabilities Manager at any time.
Disabling Capabilities Manager will remove all the capabilities information that is installed in the local Network Information Base (NIB) and unregister the information from Service Routing.
Re-enabling Capabilities Manager will rediscover capabilities and provide information to the local NIB and to the Service Routing network.
Perform this task to disable and reenable Capabilities Manager.
1.
enable
2.
configure
terminal
3.
no service-routing
capabilities-manager
4.
service-routing capabilities-manager
To display information about Capabilities Manager, use the following commands in privileged EXEC mode.
1.
show service-routing plugins plugin-name
2.
show service-routing plugins capabilities-manager internal
3.
show service-routing capabilities-manager
4.
show service-routing capabilities-manager [group group-id] [local]
Perform this task to clear current capabilities information from the NIB. Once the NIB is cleared, Capabilities Manager will automatically rediscover new capabilities.
1.
enable
2.
clear service-routing
capabilities-manager
Related Topic |
Document Title |
---|---|
Cisco IOS commands |
|
Service Advertisement Framework commands |
Cisco IOS Service Advertisement Framework Technology Command Reference |
Description |
Link |
---|---|
The Cisco Support and Documentation website provides online resources to download documentation, software, and tools. Use these resources to install and configure the software and to troubleshoot and resolve technical issues with Cisco products and technologies. Access to most tools on the Cisco Support and Documentation website requires a Cisco.com user ID and password. |