Cisco ASR1002 - ASR 1002 Router User manual

Cisco Network Positioning System Configuration Guide for the
Cisco ASR 1000 Router, Release 1.0
Americas Headquarters
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-1706
USA
http://www.cisco.com
Tel: [phone]
800 553-NETS (6387)
Fax: [phone]
Text Part Number: OL-25794-01

THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS,
INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.
THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH
THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY,
CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.
The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB's public domain version
of the UNIX operating system. All rights reserved. Copyright ©1981, Regents of the University of California.
NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS" WITH ALL FAULTS.
CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE.
IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT
LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS
HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: http://
www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership
relationship between Cisco and any other company. (1110R)
Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the document are shown
for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental.
©2011 Cisco Systems, Inc. All rights reserved.

CONTENTS
Preface Preface v
Changes to This Document v
Obtaining Documentation and Submitting a Service Request v
CHAPTER 1 General Configuration of the Network Positioning System 1
Configuring Basic Networking on a PE 1
CHAPTER 2 Configuring the XMPP Server 3
Configuring the XMPP Server 3
CHAPTER 3 Configuring Service Placement 5
Information About the Service Resolution Engine 5
Service Resolution Engine Ranking Requirements 6
Service Resolution Engine Configuration 6
Service Resolution Configuration Examples 7
show service-resolution dc command: example 7
show service-resolution service-requests command: example 8
CHAPTER 4 Configuring the Capability Directory 9
Configuring the Capability Directory 9
CHAPTER 5 Configuring Performance Metrics to Select a Service 11
Prerequisites for the Performance Manager 11
Performance Manager Limitations 11
Information About the Performance Manager 11
Extensible Messaging and Presence Protocol Client Registration 12
Performance Manager Message Processing 13
Cisco Network Positioning System Configuration Guide for the Cisco ASR 1000 Router, Release 1.0
OL-25794-01 iii

How to Configure the Performance Manager 14
Configuring the Performance Manager on a DC-Facing PE 14
Configuring the Performance Manager on a CE-Facing PE 15
CHAPTER 6 Configuring the Routing Protocols Used for Network Proximity 19
Information About Network Routing Proximity 19
PXE Data Elements 20
PXE Peering and Ranking 20
How to Configure Routing Protocols 21
Configuring OSPF for Proximity Calculations 21
Configuring BGP for Proximity Calculations 22
Configuring IS-IS for Proximity Calculations 24
CHAPTER 7 NPS Configuration Examples 27
CE-Facing PE Configuration Example 27
DCE-Facing PE Configuration: Example 28
Cisco Network Positioning System Configuration Guide for the Cisco ASR 1000 Router, Release 1.0
iv OL-25794-01
Contents

Preface
This book presents configuration information and examples for the Network Positioning System for the
Cisco ASR 1000 Router. The preface consists of these sections:
•Changes to This Document, page v
•Obtaining Documentation and Submitting a Service Request, page v
Changes to This Document
This table lists the technical changes made to this document since it was first printed.
Table 1: Changes to This Document
Change SummaryDateRevision
Initial release of this document.November 2011OL-25794-01
Obtaining Documentation and Submitting a Service Request
For information on obtaining documentation, submitting a service request, and gathering additional information,
see the monthly What's New in Cisco Product Documentation, which also lists all new and revised Cisco
technical documentation, at:
http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html
Subscribe to the What's New in Cisco Product Documentation as a Really Simple Syndication (RSS) feed
and set content to be delivered directly to your desktop using a reader application. The RSS feeds are a free
service and Cisco currently supports RSS version 2.0.
Cisco Network Positioning System Configuration Guide for the Cisco ASR 1000 Router, Release 1.0
OL-25794-01 v

Cisco Network Positioning System Configuration Guide for the Cisco ASR 1000 Router, Release 1.0
vi OL-25794-01
Preface
Obtaining Documentation and Submitting a Service Request

CHAPTER 1
GeneralConfigurationoftheNetworkPositioning
System
Configuration of the Network Positioning System (NPS) involves these tasks:
1Configure your router so that it can communicate with the NPS. This includes assigning a hostname to
the router.
2Configure the Extensible Messaging and Presence Protocol (XMPP) server on one data center (DC)-facing
provider edge router (PE).
3Configure the Service Resolution Engine (SRE) on one DC-facing PE.
4Configure the Capability Directory (CD) on the same DC-facing PE on which the SRE is configured.
5Configure the Performance Manager (PFM) running on your router. This configuration changes depending
on whether you are configuring a DC-facing or customer edge router (CE)-facing PE.
6Configure the routing protocols on your router so that the Proximity Engine (PXE) can use these for
proximity calculations.
This module covers the basic configuration required so that your router can communicate with the NPS.
Refer to the remaining modules in this book for information on other configuration tasks.
•Configuring Basic Networking on a PE, page 1
Configuring Basic Networking on a PE
To enable the XMPP server to access each CE-facing and DC-facing PE in the system, you must perform this
configuration:
Cisco Network Positioning System Configuration Guide for the Cisco ASR 1000 Router, Release 1.0
OL-25794-01 1

SUMMARY STEPS
1. hostname hostname
2. ip host hostname ip-address
3. ip name-server ip-address
4. interface interface-name
5. ip address ip-address mask
6. no shutdown
DETAILED STEPS
PurposeCommand or Action
Configures a hostname for the router.
hostname hostname
Example:
server(config)# hostname ccnsr.com
Step 1
Specifies the IP address of the running XMPP server.
ip host hostname ip-address
Example:
server(config)# ip host ccnsr.com 172.16.0.2
Step 2
Specifies the address of the name server. This
command is required only if the ip host command is
not used.
ip name-server ip-address
Example:
server(config)# ip name-server
Step 3
Enters interface configuration mode to enable an
interface.
interface interface-name
Example:
server(config)# interface eth0
server(config-if)#
Step 4
Configures the IP address of the interface.
ip address ip-address mask
Example:
server(config-if)# ip address 172.17.0.3
255.255.255.0
Step 5
Enables the interface.no shutdown
Example:
server(config-if)# no shutdown
Step 6
What to Do Next
Configure the XMPP server.
Cisco Network Positioning System Configuration Guide for the Cisco ASR 1000 Router, Release 1.0
2OL-25794-01
General Configuration of the Network Positioning System
Configuring Basic Networking on a PE

CHAPTER 2
Configuring the XMPP Server
The Extensible Messaging and Presence Protocol (XMPP) is an open, XML-based standard for near real-time
communication. Because XMPP provides near real-time communication among different platforms for
information distribution, it is the primary communications and transport protocol used between NPS
components.
Jabber is the implementation of XMPP that is installed with the NPS software. The configuration of Jabber
is described in this module.
•Configuring the XMPP Server, page 3
Configuring the XMPP Server
Jabber is used to facilitate communication between PE routers for the purposes of service resolution. Use this
task to configure the Jabber server on one of the PE routers in your system. It is also used by the capability
directory (CD) to get device capabilities through the XMPP pubsub protocol. Generally, the Jabber server is
installed on the DCE-facing PE where the service resolution engine (SRE) is installed.
SUMMARY STEPS
1. jabber server
2. domain domain-name
3. ipaddr ipv4 ip-address
4. log-level level
DETAILED STEPS
PurposeCommand or Action
Enters Jabber configuration mode to configure the XMPP
server on the router.
jabber server
Example:
switch(config)# jabber server
Step 1
Cisco Network Positioning System Configuration Guide for the Cisco ASR 1000 Router, Release 1.0
OL-25794-01 3

PurposeCommand or Action
Specifies the domain name of the Jabber server.
domain domain-name
Example:
switch(config-jabber)# domain ccnsr.com
Step 2
Specifies the IP address to use for the Jabber server.
ipaddr ipv4 ip-address
Example:
switch(config-jabber)# ipaddr ipv4 172.16.0.2
Step 3
Specifies the notifications to display. Possible options are:
log-level level
Step 4
Example:
switch(config-jabber)# log-level info
•debug
•error
•info
•verbose
•warn
What to Do Next
Configure the SRE.
Cisco Network Positioning System Configuration Guide for the Cisco ASR 1000 Router, Release 1.0
4OL-25794-01
Configuring the XMPP Server
Configuring the XMPP Server