Dell EMC SmartFabric OS10 User Guide Release 10.5.0

gRPC Network Management Interface agent

The gNMI agent, available with OS10 release 10.5.0.1 and later, provides a new interface to configure OS10 device. It uses gNMI protocol and Openconfig Yang models to support Create, Read, Update and Delete (CRUD) operations, life-cycle management through gNOI and configuration of streaming telemetry.

The gNMI agent listens to the SmartFabric director to receive remote configuration-change requests or upgrade and downgrade instructions. As a part of these remote configuration changes, the gNMI agent enables the telemetry agent to transmit pre-configured sensor groups data in the OpenConfig format to the SmartFabric director. For more information about pre-configured sensor groups, see Configure telemetry.

Set security profile to gNMI agent

Before establishing a connection to the gNMI client in SmartFabric director, set a valid application-specific security profile for the gNMI agent. Also, configure an FQDN or an IP address for entry to the SmartFabric director server; assign client and CA certificates. A user role in SmartFabric director with Super Admin privileges can be used to access the agent. The security profile that is assigned to the gNMI agent must be pre-configured on the switch. The security profile is configured using the crypto security-profile command.

To set a security profile for the gNMI agent, enter the following command in CONFIGURATION mode:

OS10(config)#gnmi-security-profile profile-name

Activate gNMI agent

To activate gNMI agent, set the switch-operating-mode to SmartFabric director mode.

NOTE Changing the switch mode takes effect only after you reload the device.

To set the SmartFabric director mode, enter the following command in CONFIGURATION mode:

OS10# configure terminal
OS10(config)# switch-operating-mode sfd

After running the command, the system displays:

Manual reboot required for this command to take effect. Continue(yes/no)?:yes
OS10(config)# exit
OS10# write memory
OS10# reload

Proceed to reboot the system? 
[confirm yes/no]:yes

When the gNMI agent is active, SmartFabric director establishes a connection with the agent using TLS verification and username-password based authentication. After successful authentication, SmartFabric director gains access to the gNMI agent. The gNMI client in SmartFabric director sends a set request to the gNMI agent.

The gNMI agent configures the telemetry agent parameters to stream telemetry data in the OpenConfig format.

NOTE Only SmartFabric director user roles with Super Admin privileges can connect to the gNMI agent. All other user roles are rejected. As a result, users roles that successfully pass authentication gain complete access to the system.

View switch mode

To determine whether the switch is operating in the SmartFabric director mode or not, you can view the current mode that the switch is operating in.

To view the operating mode of the switch, enter the following command:

OS10# show switch-operating-mode.

OS10# show switch-operating-mode

Switch-Operating-Mode : SmartFabric director Mode

OpenConfig supported Telemetry data

The gNMI agent configures the telemetry agent to map the pre-configured sensor profiles to the OpenConfig format.

Following tables list the supported OpenConfig models:

Table 1. Openconfig deviceOpenconfig device
Sensor group name	YANG container
oc-device	openconfig-platform/components/component openconfig-network-instance/network-instances/network-instance

Table 2. Openconfig systemOpenconfig system
Sensor group name	YANG container
oc-system	openconfig-system/system openconfig-platform/components/component

Table 3. Openconfig environmentOpenconfig environment
Sensor group name	YANG container
oc-environment	openconfig-platform/components/component

Table 4. Openconfig interfaceOpenconfig interface
Sensor group name	YANG container
oc-interface	openconfig-interfaces/interfaces/interface

Table 5. Openconfig buffer statisticsOpenconfig buffer statistics
Sensor group name	YANG container
oc-buffer	openconfig-qos/qos/interfaces/interface

Table 6. Openconfig LAG distributionOpenconfig LAG distribution
Sensor group name	YANG container
oc-lag	openconfig-interfaces/interfaces/interface

Table 7. Openconfig BGP statisticsOpenconfig BGP statistics
Sensor group name	YANG container
oc-bgp	openconfig-bgp/bgp/neighbors/neighbor

Table 8. Openconfig BFDOpenconfig BFD
Sensor group name	YANG container
oc-bfd	openconfig-bfd/bfd

Table 9. Openconfig LACPOpenconfig LACP
Sensor group name	YANG container
oc-lacp	openconfig-lacp/lacp

Table 10. Openconfig LLDPOpenconfig LLDP
Sensor group name	YANG container
oc-lldp	openconfig-lldp/lldp

Table 11. Openconfig STPOpenconfig STP
Sensor group name	YANG container
oc-stp	openconfig-spanning-tree/stp

Table 12. Vendor UFD Vendor UFD
Sensor group name	YANG container
oc-vendor-ufd	ufd/uplink-state-group-stats/ufd-groups

Table 13. Vendor VXLAN Vendor VXLAN
Sensor group name	YANG container
oc-vendor-vxlan	vxlan/vxlan-state/remote-endpoint/stats

Table 14. Openconfig VLANOpenconfig VLAN
Sensor group name	YANG container
oc-vlan	openconfig-interfaces/interfaces/interface

Table 15. Openconfig VRRPOpenconfig VRRP
Sensor group name	YANG container
oc-vrrp	openconfig-interfaces/interfaces/interface/subinterfaces/subinterface

Welcome

Welcome to Dell