User Account

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 aaa class <class-id>

Command Syntax

Syntax Description
<class-id> The name of the class.

Version History

Introduced in Cumulus Linux 5.7.0

Example

nv set system aaa class class1

nv set system aaa class <class-id> action

Configures the allow or deny action for the specified class.

Command Syntax

Syntax Description
<class-id> The name of the class.

Version History

Introduced in Cumulus Linux 5.7.0

Example

cumulus@switch:~$ nv set system aaa class class2 action allow

nv set system aaa class <class-id> command-path <command-path-id>

Configures the command path for the specified class.

Command paths, which Cumulus Linux bases on the objects in the NVUE declarative model and, which are the same as URI paths; for example; you can use the /vrf/ command path to allow or deny a user access to all VRFs, or /system/nat to allow or deny a user access to NAT configuration. Use the tab key to see available command paths (nv set system aaa class <class-name> command-path / <<press tab>>).

Command Syntax

Syntax Description
<class-id> The name of the class.
<command-path-id> The command path.

Version History

Introduced in Cumulus Linux 5.7.0

Example

cumulus@switch:~$ nv set system aaa class class1 command-path /interface/ 

nv set system aaa class <class-id> command-path <command-path-id> permission

Configures the permissions for the command path for the specified class.

You can specify ro to run show commands, rw to run set, unset, and apply commands, act to run action commands, or all to run all commands. The default permission setting is all.

Command Syntax

Syntax Description
<class-id> The name of the class.
<command-path-id> The name of the class.

Version History

Introduced in Cumulus Linux 5.7.0

Example

cumulus@switch:~$ nv set system aaa class class1 command-path /interface/*/acl/ permission ro

nv set system aaa role <role-id>

Configues a role. A role is a virtual identifier for multiple classes (groups). You can assign only one role for a user. For example, for a user that can manage interfaces, you can create a role called IFMgr.

Command Syntax

Syntax Description
<role-id> The name of the role.

Version History

Introduced in Cumulus Linux 5.7.0

Example

cumulus@switch:~$ nv set system aaa role ROLE1

nv set system aaa role <role-id> class <class-id>

Assigns the specified class to the role.

Command Syntax

Syntax Description
<role-id> The name of the role.
<class-id> The name of the class.

Version History

Introduced in Cumulus Linux 5.7.0

Example

cumulus@switch:~$ nv set system aaa role ROLE1 class class1

nv set system aaa user <user-id> state

Turns the user account for the switch on or off. You can specify enabled or disabled.

In Cumulus Linux 5.10 and earlier, this command is nv set system aaa user <user-id> enable on or nv set system aaa user <user-id> enable off.

Command Syntax

Syntax Description
<user-id> The user account.

Version History

Introduced in Cumulus Linux 5.4.0

Example

cumulus@switch:~$ nv set system aaa user admin2 state enabled

nv set system aaa user <user-id> full-name <value>

Configures the full name for the specified user account. If the full name includes more than one name, either separate the names with a hyphen (FIRST-LAST) or enclose the full name in quotes (“FIRST LAST”).

Command Syntax

Syntax Description
<user-id> The user account.

Version History

Introduced in Cumulus Linux 5.4.0

Example

cumulus@switch:~$ nv set system aaa user admin2 full-name "FIRST LAST"

nv set system aaa user <user-id> hashed-password

Configures a hashed text password for the specified user account. You must specify the hashed password in Linux crypt format; the password must be a minimum of 15 to 20 characters long and must include special characters, digits, lower case alphabetic letters, and more.

Command Syntax

Syntax Description
<user-id> The user account.

Version History

Introduced in Cumulus Linux 5.4.0

Example

cumulus@switch:~$ nv set system aaa user admin2 hashed-password '$1$/ETjhZMJ$P73qhBZEYP20mKnRkhBol0'

nv set system aaa user <user-id> password

Configures a plain text password for the specified user account by prompting you to enter a new password and to confirm the password.

You can also run the nv set system aaa user <user-id> password <plain-text-password> command to specify the plain text password inline. This command bypasses the Enter new password and Confirm password prompts but displays the plain text password as you type it.

NVUE hashes the plain text password and stores the value as a hashed password.

Command Syntax

Syntax Description
<user-id> The user account.

Version History

Introduced in Cumulus Linux 5.4.0

Example

cumulus@switch:~$ nv set system aaa user admin2 password

nv set system aaa user <user-id> role

Configures the role for the user accounts configured on the switch and the groups to which they belong. You can specify system-admin, nvue-admin, and nvue-monitor.

Command Syntax

Syntax Description
<user-id> The user account.

Version History

Introduced in Cumulus Linux 5.4.0

Example

cumulus@switch:~$ nv set system aaa user admin2 nvue-monitor