Table Of Contents

U Commands

use-profile

username

U Commands

---

The commands in this chapter apply to the Cisco MDS 9000 Family of multilayer directors and fabric switches. All commands are shown here in alphabetical order regardless of command mode. See the "Command Modes" section to determine the appropriate mode for each command. For more information, refer to the Cisco MDS 9000 Family Configuration Guide.

•use-profile

•username

use-profile

To bind a profile to the FCIP interface, use the use-profile option. To disable a configured profile, use the no form of the option.

use-profile profile-id

no use-profile profile-id

Syntax Description

use-profile	Configures the interface using an existing profile.
profile-id	Enters the profile ID to be used from 1 to 255.

Defaults

None.

Command Modes

Configuration mode

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.1(1).

Usage Guidelines

Access this command from the switch(config-if)# submode.

Binds the profile with the FCIP interface.

Examples

switch# config t

switch(config)# interface fcip 50

switch(config-if)# use-profile 100

switch(config-if)# no use-profile 100

Related Commands

Command	Description
show interface fcip	Displays an interface configuration for a specified FCIP interface.
show fcip	Displays information about the FCIP profile.

username

To define a user, use the username command in configuration mode. Use the no form of a command to undo the configuration or revert to factory defaults.

username name [expire date] [iscsi ] [role rolename] [sshkey key_content] [password [0 | 5 user-password] [update-snmpv3]

no username name [expire date] [iscsi ] [role rolename] [sshkey key_content] [password [0 | 5 user-password] [update-snmpv3]

Syntax Description

name	Specifies the name of the user. Maximum length is 32 characters.
expire	Configures the date when this user account expires (in YYYY-MM-DD format).
date	Specifies the expiration date.
iscsi	Identifies an iSCSI user.
password	Configures a password for the user. The password is limited to 64 characters.
user-password	Enters the password. Maximum length is 32 characters.
0	Specifies a clear text password for the user.
5	Specifies a strongly encrypted password for the user.
role	Configures a role which the user is to be assigned.
rolename	Specifies the role name of the user. Maximum length is 32 characters.
sshkey	Updates the SSH key to authenticate a SSH user.
key_content	Specifies the actual contents of the SSH public key.
update-snmpv3	Updates the local CLI password and the SNMPv3 password. The password is limited to a minimum of 8 characters and a maximum of 64 characters.

Defaults

None.

Command Modes

Configuration mode.

Command History

This command was introduced in Cisco MDS SAN-OS Release 1.0(2).

Usage Guidelines

To change the SNMP password, a clear text CLI password is required. You must know the SNMPv3 password to change the password using the CLI. Use the CLI password to synchronize the SNMP password.

Examples

The following example shows how to define a user.

switch(config)# username knuckles password testpw role bodega

switch(config)# do show user-account 

user:admin

        this user account has no expiry date

        roles:network-admin 

user:knuckles

        this user account has no expiry date

        roles:bodega

The following example configures the name and password for a a user to login using iSCSI authentication:.

switch(config)# username iscsiuser password ffsffsfsffs345353554535 iscsi

he following example places you in the mode for the specified role (techdocs). The role submode prompt indicates that you are now in the role submode. This submode is now specific to the techdocs group.

switch(config)# role name techdocs 

switch(config-role)# 

The following example deletes the role called techdocs.

switch(config)# no role name techdocs 

The following example assigns a description to the new role. The description is limited to one line and can contain spaces.

switch(config-role)# description Entire Tech. Docs. group	

The following example resets the description for the Tech. Docs. group.

switch(config-role)# no description 

The following example creates or updates the user account (usam) along with a password (abcd) that is set to expire on 2003-05-31.

switch(config)# username usam password abcd expire 2003-05-31	

The following example creates or updates the user account (msam) along with a password (abcd) specified in clear text (indicated by 0).

switch(config)# username msam password 0 abcd role network-operator 

The following example specifies an encrypted (specified by 5) password (!@*asdsfsdfjh!@df) for the user account (user1).

switch(config)# username user1 password 5 !@*asdsfsdfjh!@df

The following example adds the specified user (usam) to the network-admin role.

switch(config)# username usam role network-admin

The following example deletes the specified user (usam) from the vsan-admin role.

switch(config)# no username usam role vsan-admin

The following example identifies the contents of the SSH key for the specified user (usam).

switch(config)# username usam sshkey fsafsd2344234234ffgsdfg	 

The following example deletes the SSH key content identification for the user (usam).

switch(config)# no username usam sshkey fsafsd2344234234ffgsdfgffsdfsfsfssf	

The following example updates the SNMPv3 password for the specified user (joe). The local CLI password and the SNMP password are updated. If user Joe does not exist, the command fails.

switch(config)# username joe password wxyz6789 update-snmpv3 abcd1234