API Guide

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:
SmartFabric Director
147