clus2019

CLUS 2019 Demo examples

1. GetConfig

$ cd getconfig
$ go run main.go

config from [2001:420:2cff:1204::5502:1]:57344
 {
 "data": {
  "openconfig-interfaces:interfaces": {
   "interface": [
    {
     "name": "Loopback60",
     "config": {
      "name": "Loopback60",
      "type": "iana-if-type:softwareLoopback",
      "enabled": true
     },
...

2. Show Command output (text)

$ cd showcmd
$ go build
$ ./showcmd -cli "show isis database" -enc text

output from [2001:420:2cff:1204::5502:2]:57344

----------------------------- show isis database ------------------------------

IS-IS BB2 (Level-2) Link State Database
LSPID                 LSP Seq Num  LSP Checksum  LSP Holdtime/Rcvd  ATT/P/OL
mrstn-5502-1.cisco.com.00-00  0x0000033a   0xe092        3126 /4000         0/0/0
mrstn-5502-2.cisco.com.00-00* 0x00000118   0xbf45        2023 /*            0/0/0
...

3. Set config (text)

$ cd setconfig
$ go build
$ ./setconfig -cli "interface Lo11 ipv6 address 2001:db8::/128"

config applied to [2001:420:2cff:1204::5502:2]:57344

2019/06/10 14:43:28 This process took 2.17090586s

4. Merge config

$ cd mergeconfig
$ go build
$ ./mergeconfig

config merged on [2001:420:2cff:1204::5502:2]:57344 -> Request ID: 1, Response ID: 1

2019/06/10 16:41:16 This process took 2.08032828s

5. Delete config

$ cd deleteconfig
$ go build
$ ./deleteconfig

config deleted on [2001:420:2cff:1204::5502:2]:57344 -> Request ID: 1, Response ID: 1

6. Subscribe to Telemetry stream (process self-describing GPB)

$ cd telemetrykv
$ go build
$ ./telemetrykv
******************************************************************************************
Time 06:19:49PM, Path: Cisco-IOS-XR-ethernet-lldp-oper:lldp/nodes/node/neighbors/details/detail
******************************************************************************************
  node-name: 0/0/CPU0
  interface-name: HundredGigE0/0/0/0
  device-id: mrstn-5502-1.cisco.com
   receiving-interface-name: HundredGigE0/0/0/0
   device-id: mrstn-5502-1.cisco.com
   chassis-id: 008a.9646.6cd9
   port-id-detail: HundredGigE0/0/0/0
   header-version: 0
   ...

7. Subscribe to Telemetry stream (self-describing GPB)

$ cd telemetry
$ go build
$ ./telemetry
Time 1560205882119, Path: Cisco-IOS-XR-ethernet-lldp-oper:lldp/nodes/node/neighbors/details/detail
{
  "NodeId": {
    "NodeIdStr": "mrstn-5502-2.cisco.com"
  },
  "Subscription": {
    "SubscriptionIdStr": "LLDP"
  },
  "encoding_path": "Cisco-IOS-XR-ethernet-lldp-oper:lldp/nodes/node/neighbors/details/detail",
  "collection_id": 5,
  "collection_start_time": 1560205882119,
  "msg_timestamp": 1560205882119,
  ...

8. Subscribe to Telemetry stream (GPB)

$ cd telemetrygpb
$ go build
$ ./telemetrygpb
Time 1560265990393, Path: Cisco-IOS-XR-ethernet-lldp-oper:lldp/nodes/node/neighbors/details/detail
Decoded Keys:
{
  "node_name": "0/0/CPU0",
  "interface_name": "HundredGigE0/0/0/0",
  "device_id": "mrstn-5502-1.cisco.com"
}
Decoded Content:
{
  "lldp_neighbor": [
    {
      "receiving_interface_name": "HundredGigE0/0/0/0",
      "device_id": "mrstn-5502-1.cisco.com",
      "chassis_id": "008a.9646.6cd9",
      "port_id_detail": "HundredGigE0/0/0/0",
      "hold_time": 15,
      ...

9. Set IPv6 route

$ cd setroute
$ go build
$ ./setroute -nh 2001:f00:2122::1
2019/06/11 12:20:15 This process took 1.306517467s

10. Trigger an action

$ cd action
$ go build
$ ./action

output from [2001:420:2cff:1204::5502:2]:57344
 {
 "Cisco-IOS-XR-ping-act:output": {
  "ping-response": {
   "ipv6": {
    "destination": "2001:420:2cff:1204::1",
    "repeat-count": "2",
    "data-size": "1350",
    "timeout": "1",
    "pattern": "abcd",
    "rotate-pattern": false,
    "replies": {
     "reply": [
      {
       "reply-index": "1",
       "result": "!"

Pyang

pyang -f tree test.yang

gRPC

• Go

protoc --go_out=plugins=grpc:. user.proto

• Python

protoc --python_out=plugins=grpc:. user.proto

gRPC config on router

grpc
 port 57344
 address-family ipv6
 service-layer
 !
!

Telemetry subscription ID

It has to be preconfigured on the device ¹.

telemetry model-driven
 sensor-group LLDPNeighbor
  sensor-path Cisco-IOS-XR-ethernet-lldp-oper:lldp/nodes/node/neighbors/details/detail
 !
 subscription LLDP
  sensor-group-id LLDPNeighbor sample-interval 15000
 !
!

[1]: gNMI defines a variant where you do not need this config.

Certificate files

You need to retrive the ems.pem file from the IOS XR device (after enabling gRPC/TLS) and put it in the input folder. You can find the file in the router on either /misc/config/grpc/ or /var/xr/config/grpc.

• /var/xr/config/grpc

$ ls -la
total 20
drwxr-xr-x  3 root root 4096 Jul  5 17:47 .
drwxr-xr-x 10 root root 4096 Jul  3 12:50 ..
drwx------  2 root root 4096 Jul  3 12:50 dialout
-rw-------  1 root root 1675 Jul  5 17:47 ems.key
-rw-rw-rw-  1 root root 1513 Jul  5 17:47 ems.pem