gNMI

The nv unset commands remove the configuration you set with the equivalent nv set commands. This guide only describes an nv unset command if it differs from the nv set command.

nv set system gnmi-server mtls ca-certificate <ca-cert-id>

Sets the CA certificate you want to use to validate the client during mTLS.

Command Syntax

Syntax	Description
`<ca-cert-id>`	The CA-certificate ID.

Version History

Introduced in Cumulus Linux 5.13.0

Example

cumulus@switch:~$ nv set system gnmi-server mtls ca-certificate CERT

nv set system gnmi-server mtls crl <crl>

Sets the CRL you want to use to validate the client during mTLS.

Command Syntax

Syntax	Description
`<crl>`	The Certificate Revocation List.

Version History

Introduced in Cumulus Linux 5.13.0

Example

cumulus@switch:~$ nv set system gnmi-server mtls crl abcdefghijklmnop

nv set system gnmi-server certificate <cert-id>

Binds the certificate to the gNMI server when you configure the gRPC tunnel client package.

Command Syntax

Syntax	Description
`<cert-id>`	The certificate ID.

Version History

Introduced in Cumulus Linux 5.13.0

Example

cumulus@switch:~$ nv set system gnmi-server certificate CERT1

nv set system gnmi-server listening-address <address>

Sets the listening address for the gNMI server.

Command Syntax

Syntax	Description
`<address>`	The gNMI server listening address.

Version History

Introduced in Cumulus Linux 5.13.0

Example

cumulus@switch:~$ nv set system gnmi-server listening-address localhost

nv set system gnmi-server port <port-id>

Sets the gNMI server listening port.

Command Syntax

Syntax	Description
`<port-id>`	The port number.

Version History

Introduced in Cumulus Linux 5.13.0

Example

cumulus@switch:~$ nv set system gnmi-server port 9339

nv set system gnmi-server state

Enables and disables the gNMI server. You can specify enabled or disabled.

Version History

Introduced in Cumulus Linux 5.13.0

Example

cumulus@switch:~$ nv set system gnmi-server state enabled

nv set system grpc-tunnel server <server-id> address <address>

Configures the IP address of the gRPC tunnel server to which you want to connect.

Command Syntax

Syntax	Description
`<server-id>`	The gRPC tunnel server ID.
`<address>`	The IP address or hostname of the gRPC tunnel server.

Version History

Introduced in Cumulus Linux 5.13.0

Example

cumulus@switch:~$ nv set system grpc-tunnel server SERVER1 address 10.1.1.10

nv set system grpc-tunnel server <server> ca-certificate <ca-cert-id>

Sets the CA certificate you want to use for the gRPC tunnel server.

Command Syntax

Syntax	Description
`<server-id>`	The gRPC tunnel server ID.
`<ca-cert-id>`	The CA-certificate ID for the gRPC tunnel server.

Version History

Introduced in Cumulus Linux 5.13.0

Example

cumulus@switch:~$ nv set system grpc-tunnel server SERVER1 ca-certificate CERT1

nv set system grpc-tunnel server <server> certificate self-signed

Configures the self-signed certificate you want to use for the gRPC tunnel server.

Command Syntax

Syntax	Description
`<server-id>`	The gRPC tunnel server ID.

Version History

Introduced in Cumulus Linux 5.13.0

Example

cumulus@switch:~$ nv set system grpc-tunnel server SERVER1 certificate self-signed

nv set system grpc-tunnel server <server> port

Configures the port number for the gRPC tunnel server to which you want to connect.

Command Syntax

Syntax	Description
`<server-id>`	The gRPC tunnel server ID.
`<port>`	The gRPC tunnel server port.

Version History

Introduced in Cumulus Linux 5.13.0

Example

cumulus@switch:~$ nv set system grpc-tunnel server SERVER1 port 443

nv set system grpc-tunnel server <server> retry-interval

Configures the retry interval for grpc tunnel. You can specify a value between 10 and 300, The default value is 30.

Command Syntax

Syntax	Description
`<server-id>`	The gRPC tunnel server ID.

Version History

Introduced in Cumulus Linux 5.13.0

Example

cumulus@switch:~$ nv set system grpc-tunnel server SERVER1 retry-interval 20

nv set system grpc-tunnel server <server> target-name <target-name>

Configures the target name for the gRPC tunnel server to which you want to connect.

Command Syntax

Syntax	Description
`<server-id>`	The gRPC tunnel server ID.
`<target-name>`	The gRPC tunnel server target name.

Version History

Introduced in Cumulus Linux 5.13.0

Example

cumulus@switch:~$ nv set system grpc-tunnel server SERVER1 target-name TARGET1

nv set system grpc-tunnel server <server> target-type <target-type>

Configures the target type for the gRPC tunnel server to which you want to connect.

Command Syntax

Syntax	Description
`<server-id>`	The gRPC tunnel server ID.
`<target-type>`	The gRPC tunnel server target type.

Version History

Introduced in Cumulus Linux 5.13.0

Example

cumulus@switch:~$ nv set system grpc-tunnel server SERVER1 target-type gnmi-gnoi

nv set system grpc-tunnel server <server> state

Enables and disables the gRPC tunnel server.

Command Syntax

Syntax	Description
`<server-id>`	The gRPC tunnel server ID.

Version History

Introduced in Cumulus Linux 5.13.0

Example

cumulus@switch:~$ nv set system grpc-tunnel server SERVER1 state enabled