configure netlogin local-user

configure netlogin local-user user-name {vlan-vsa [[{tagged | untagged} [vlan_name | vlan_tag]] | none]}

Description

Configures an existing local network login account.

Syntax Description

user-name Specifies the name of an existing local network login account.
tagged Specifies that the client be added as tagged.
untagged Specifies that the client be added as untagged.
vlan_name Specifies the name of the destination VLAN.
vlan_tag Specifies the VLAN ID, tag, of the destination VLAN.
none Specifies that the VSA 211 wildcard (*) is applied, only if you do not specify tagged or untagged.

Default

N/A.

Usage Guidelines

Use this command to modify the attributes of an existing local network login account. You can update the following attributes associated with a local network login account:
  • Password of the local network login account.

  • Destination VLAN attributes including: adding clients tagged or untagged, the name of the VLAN, and the VLAN ID.
    Note

    Note

    Passwords are case-sensitive and must have a minimum of 1 character and a maximum of 32 characters.

You must create a local network login account before using this command. To create a local network login user name and password, use the following command:

create netlogin local-user user-name {encrypted} {password} {vlan-vsa [[{tagged | untagged} [vlan_name] | vlan_tag]]} {security-profilesecurity_profile}

If the switch displays a message similar to the following:

* Switch # configure netlogin local-user purplenet
^
%% Invalid input detected at '^' marker.

You might be attempting to modify a local network login account that is not present or the switch, or you might have incorrectly entered the account name. To confirm the names of the local network login accounts on your switch, use the following command:

show netlogin local-users

Additional Requirements

This command applies only to the web-based and MAC-based modes of network login. 802.1X network login does not support local database authentication.

You must have administrator privileges to use this command. If you do not have administrator privileges, the switch displays a message similar to the following:

This user does not have permissions for this command.

Passwords are case-sensitive. Passwords must have a minimum of 0 characters and a maximum of 32 characters. If you attempt to create a password with more than 32 characters, the switch displays the following message after you re-enter the password:

Password cannot exceed 32 characters

Example

This section contains the following examples:
  • Updating the password.

  • Modifying destination VLAN attributes.

Updating the Password

The following command updates the password of an existing local network login account:

configure netlogin local-user megtest

After you enter the local network login user name, press [Enter]. The switch prompts you to enter a password; however, the switch does not display the password. At the prompt enter the new password:

password:

After you enter the new password, press [Enter]. The switch then prompts you to re-enter the password:

Reenter password:

Updating VLAN Attributes

You can add a destination VLAN, change the destination VLAN, or remove the destination from an existing local network login account. This example changes the destination VLAN for the specified local network login account:

configure netlogin local-user megtest vlan-vsa green

History

This command was first available in ExtremeXOS 11.3.

Platform Availability

This command is available on ExtremeSwitching 5320, 5420, 5520, and 5720 series switches.