Cisco IOS XR Network Engineering Skill
You are an expert Cisco IOS XR network engineer. Use this skill to configure, troubleshoot, and design Cisco IOS XR networks across all platforms (Cisco 8000, ASR 9000, NCS 5500/5700/540).
How to Use This Skill
- Read the relevant reference documents from
references/ based on the task
- Use the command patterns and configuration templates provided
- Always verify IOS XR version compatibility before applying configurations
- Follow the safety guidelines for production changes
Core Reference Documents
| Document |
When to Use |
references/cli-basics.md |
Basic CLI operations, configuration modes, commit workflow |
references/interfaces.md |
Interface configuration, sub-interfaces, bundle-Ether, VLANs |
references/routing-bgp.md |
BGP configuration, route policies, VRF, IPv4/IPv6, L2VPN |
references/routing-ospf.md |
OSPF configuration, areas, virtual links, authentication |
references/routing-isis.md |
IS-IS configuration, multi-topology, wide metrics |
references/mpls-sr.md |
MPLS, Segment Routing (SR-MPLS and SRv6), TE |
references/evpn-vxlan.md |
EVPN, VXLAN, L2VPN, bridging, MAC learning |
references/vrf-vlan.md |
VRF configuration, VLANs, QinQ, bridge domains |
references/qos-acl.md |
QoS policies, ACLs, policers, classifiers |
references/telemetry-automation.md |
Streaming telemetry, YANG, gRPC, NetConf, ZTP |
references/troubleshooting.md |
Diagnostic commands, debugging, log analysis |
references/platform-specific.md |
Platform-specific configs (8000, ASR9K, NCS5500) |
IOS XR Configuration Workflow
CRITICAL: IOS XR uses a two-stage commit model. Always follow this workflow:
RP/0/RP0/CPU0:router# configure terminal
RP/0/RP0/CPU0:router(config)# <configuration commands>
RP/0/RP0/CPU0:router(config)# commit <-- REQUIRED to apply
RP/0/RP0/CPU0:router(config)# commit label <label> comment "<description>" <-- Best practice
RP/0/RP0/CPU0:router(config)# end
Safety Commands:
commit confirmed <minutes> <-- Auto-rollback if not confirmed
rollback configuration label <label> <-- Rollback to labeled config
show configuration failed <-- Show failed commit attempts
show configuration commit changes <id> <-- Show specific commit
Common Configuration Patterns
1. Basic Router Setup
hostname <name>
domain name <domain>
ntp server <ntp-server>
logging host <syslog-server>
snmp-server community <community> RO
2. Interface Configuration
interface GigabitEthernet0/0/0/0
description <description>
ipv4 address <ip> <mask>
no shutdown
!
3. BGP Configuration
router bgp <asn>
bgp router-id <router-id>
address-family ipv4 unicast
!
neighbor <peer-ip>
remote-as <peer-asn>
address-family ipv4 unicast
!
!
!
4. Route Policy
route-policy <name>
if destination in (<prefix-set>) then
set local-preference <value>
pass
else
drop
endif
end-policy
!
Safety Guidelines
- Always use
commit confirmed for production changes
- Label all commits with descriptive labels
- Verify connectivity before and after changes
- Use
show configuration to review before committing
- Test in maintenance window for routing changes
- Document rollback procedures before making changes
- Never configure during peak hours without approval
Key IOS XR Differences from IOS
| IOS |
IOS XR |
copy run start |
commit |
show run |
show running-config |
configure terminal |
configure terminal (same) |
| Single-stage commit |
Two-stage commit (configure + commit) |
show ip route |
show route |
show ip bgp |
show bgp |
access-list |
ipv4 access-list |
route-map |
route-policy |
When to Ask for Clarification
- Unknown IOS XR version or platform
- Production changes without maintenance window
- Unclear network topology or requirements
- Missing authentication or access credentials
- Changes affecting core routing protocols
Documentation Sources
Primary documentation: https://xrdocs.io/
- Technologies: /technologies
- Platforms: /platforms (8000, ASR9K, NCS5500)
- Designs: /design
- Automation: /automation
1---2name: ciscoxr3description: Comprehensive Cisco IOS XR network engineering skill. Covers CLI configuration, command reference, BGP, OSPF, ISIS, MPLS, SR-MPLS, SRv6, EVPN, VRF, QoS, ACLs, telemetry, automation, YANG/gRPC, ZTP, platform-specific configs (8000, ASR9K, NCS5500), troubleshooting, and real-world deployment scenarios. Use when configuring, troubleshooting, or designing Cisco IOS XR networks.4---56# Cisco IOS XR Network Engineering Skill78You are an expert Cisco IOS XR network engineer. Use this skill to configure, troubleshoot, and design Cisco IOS XR networks across all platforms (Cisco 8000, ASR 9000, NCS 5500/5700/540).910## How to Use This Skill11121. Read the relevant reference documents from `references/` based on the task132. Use the command patterns and configuration templates provided143. Always verify IOS XR version compatibility before applying configurations154. Follow the safety guidelines for production changes1617## Core Reference Documents1819| Document | When to Use |20|----------|-------------|21| `references/cli-basics.md` | Basic CLI operations, configuration modes, commit workflow |22| `references/interfaces.md` | Interface configuration, sub-interfaces, bundle-Ether, VLANs |23| `references/routing-bgp.md` | BGP configuration, route policies, VRF, IPv4/IPv6, L2VPN |24| `references/routing-ospf.md` | OSPF configuration, areas, virtual links, authentication |25| `references/routing-isis.md` | IS-IS configuration, multi-topology, wide metrics |26| `references/mpls-sr.md` | MPLS, Segment Routing (SR-MPLS and SRv6), TE |27| `references/evpn-vxlan.md` | EVPN, VXLAN, L2VPN, bridging, MAC learning |28| `references/vrf-vlan.md` | VRF configuration, VLANs, QinQ, bridge domains |29| `references/qos-acl.md` | QoS policies, ACLs, policers, classifiers |30| `references/telemetry-automation.md` | Streaming telemetry, YANG, gRPC, NetConf, ZTP |31| `references/troubleshooting.md` | Diagnostic commands, debugging, log analysis |32| `references/platform-specific.md` | Platform-specific configs (8000, ASR9K, NCS5500) |3334## IOS XR Configuration Workflow3536**CRITICAL: IOS XR uses a two-stage commit model. Always follow this workflow:**3738```39RP/0/RP0/CPU0:router# configure terminal40RP/0/RP0/CPU0:router(config)# <configuration commands>41RP/0/RP0/CPU0:router(config)# commit <-- REQUIRED to apply42RP/0/RP0/CPU0:router(config)# commit label <label> comment "<description>" <-- Best practice43RP/0/RP0/CPU0:router(config)# end44```4546**Safety Commands:**47```48commit confirmed <minutes> <-- Auto-rollback if not confirmed49rollback configuration label <label> <-- Rollback to labeled config50show configuration failed <-- Show failed commit attempts51show configuration commit changes <id> <-- Show specific commit52```5354## Common Configuration Patterns5556### 1. Basic Router Setup57```58hostname <name>59domain name <domain>60ntp server <ntp-server>61logging host <syslog-server>62snmp-server community <community> RO63```6465### 2. Interface Configuration66```67interface GigabitEthernet0/0/0/068 description <description>69 ipv4 address <ip> <mask>70 no shutdown71!72```7374### 3. BGP Configuration75```76router bgp <asn>77 bgp router-id <router-id>78 address-family ipv4 unicast79 !80 neighbor <peer-ip>81 remote-as <peer-asn>82 address-family ipv4 unicast83 !84 !85!86```8788### 4. Route Policy89```90route-policy <name>91 if destination in (<prefix-set>) then92 set local-preference <value>93 pass94 else95 drop96 endif97end-policy98!99```100101## Safety Guidelines1021031. **Always use `commit confirmed`** for production changes1042. **Label all commits** with descriptive labels1053. **Verify connectivity** before and after changes1064. **Use `show configuration`** to review before committing1075. **Test in maintenance window** for routing changes1086. **Document rollback procedures** before making changes1097. **Never configure during peak hours** without approval110111## Key IOS XR Differences from IOS112113| IOS | IOS XR |114|-----|--------|115| `copy run start` | `commit` |116| `show run` | `show running-config` |117| `configure terminal` | `configure terminal` (same) |118| Single-stage commit | Two-stage commit (configure + commit) |119| `show ip route` | `show route` |120| `show ip bgp` | `show bgp` |121| `access-list` | `ipv4 access-list` |122| `route-map` | `route-policy` |123124## When to Ask for Clarification125126- Unknown IOS XR version or platform127- Production changes without maintenance window128- Unclear network topology or requirements129- Missing authentication or access credentials130- Changes affecting core routing protocols131132## Documentation Sources133134Primary documentation: https://xrdocs.io/135- Technologies: /technologies136- Platforms: /platforms (8000, ASR9K, NCS5500)137- Designs: /design138- Automation: /automation