Cisco MDS 9000 Family Command Reference, Release 1.3 (from Release 1.3(1) through Release 1.3(6)) - U Commands [Cisco MDS 9000 NX-OS and SAN-OS Software]

Table Of Contents

U Commands

undebug all

update license

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.

•undebug all

•update license

•use-profile

•username

undebug all

To disable all debugging, use the undebug all command.
undebug all
Syntax Description

This command has no arguments or keywords.

Defaults

None.

Command Modes

EXEC mode.

Command History

Release

Modification

1.0(2)

This command was introduced.

Usage Guidelines

Use this command to turn off all debugging.

Examples

The following example shows how to disable all debugging on the switch.
switch# undebug all
Related Commands

Command

Description

nodebug all

Also disables all debug commands configured on the switch.

update license

To update an existing license, use the update license command in EXEC mode.

update license {url | bootflash: | slot0: | volatile:} filename
Syntax Description

update license

Updates an installed, expiring license.

url

Specifies the URL for the license file to be uninstalled.

bootflash:

Specifies the license file location in internal bootflash memory.

slot0:

Specifies the license file in the CompactFlash memory or PCMCIA card.

volatile:

Specifies the license file in the volatile file system.

filename

Specifies the name of the license file to update.

Command Modes

EXEC mode.

Command History

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

Examples

The following example updates a specific license.
switch# update license bootflash:sanextn2.lic sanextn1.lic
Updating sanextn1.lic:
SERVER this_host ANY
VENDOR cisco
# An example fcports license
INCREMENT SAN_EXTN_OVER_IP cisco 1.000 permanent 1 HOSTID=VDH=ABCD \
        NOTICE=<LicFileID>san_extn1.lic</LicFileID><LicLineID>0</LicLineID> \
        SIGN=33088E76F668
with bootflash:/sanextn2.lic:
SERVER this_host ANY
VENDOR cisco
# An example fcports license
INCREMENT SAN_EXTN_OVER_IP cisco 1.000 permanent 1 HOSTID=VDH=ABCD \
        NOTICE=<LicFileID>san_extn2.lic</LicFileID><LicLineID>1</LicLineID> \
        SIGN=67CB2A8CCAC2
Do you want to continue? (y/n) y
Updating license ..done
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 profile-id

Specifies the profile ID to be used. The range is 1 to 255.

Defaults

None.

Command Modes

Interface configuration submode

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.

This command 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 | password [0 | 5 | 7] user-password [expire date] [role rolename] | role rolename | sshkey {key-content | file filename} | update-snmpv3]
username name [expire date | iscsi | password [0 | 5 | 7] user-password [expire date] [role rolename] | role rolename | sshkey {key-content | file filename} | update-snmpv3]
Syntax Description

name

Specifies the name of the user. Maximum length is 32 characters.

expire date

Specifies the date when this user account expires (in YYYY-MM-DD format).

iscsi

Identifies an iSCSI user.

password

Configures a password for the user. The password is limited to 64 characters. The minimum length is 8 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.

7

Specifies an encrypted password for the user.

role rolename

Specifies the role name of the user. Maximum length is 32 characters.

sshkey

Configures the SSH public key.

key_content

Specifies the actual contents of the SSH public key.

file filename

Specifies a file containing 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 