Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nleiva/clus2019
CLUS 2019 Demo example
https://github.com/nleiva/clus2019
cisco grpc iosxr
Last synced: 8 days ago
JSON representation
CLUS 2019 Demo example
- Host: GitHub
- URL: https://github.com/nleiva/clus2019
- Owner: nleiva
- License: bsd-3-clause
- Created: 2019-06-10T07:41:56.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2019-06-12T22:38:04.000Z (over 5 years ago)
- Last Synced: 2023-02-26T20:42:26.458Z (almost 2 years ago)
- Topics: cisco, grpc, iosxr
- Language: Go
- Size: 5.56 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# clus2019
CLUS 2019 Demo examples
1. GetConfig
```bash
$ 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)
```bash
$ 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)
```bash
$ 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
```bash
$ 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
```bash
$ 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)
```bash
$ 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)
```bash
$ 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)
```bash
$ 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
```bash
$ 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
```bash
$ 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 [1](#myfootnote1).
```
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](https://github.com/openconfig/reference/blob/master/rpc/gnmi/gnmi.proto) 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](example/input) folder. You can find the file in the router on either `/misc/config/grpc/` or `/var/xr/config/grpc`.
- /var/xr/config/grpc
```console
$ 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
```