Table Of Contents
U Commands
undebug all
update license
use-profile
username
username (iSCSI initiator mode)
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
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.
Related Commands
Command
|
Description
|
no debug all
|
Also disables all debug commands configured on the switch.
|
show debug
|
Displays 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
# 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> \
with bootflash:/sanextn2.lic:
# 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> \
Do you want to continue? (y/n) y
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)# 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}]
username name [expire date | iscsi | password [0 | 5 | 7] user-password [expire date] [role
rolename] | role rolename | sshkey {key-content | file filename}]
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
Release
|
Modification
|
1.0(2)
|
This command was introduced.
|
2.0(1b)
|
•Removed the update_snmpv3 option.
•Added level 7 for passwords.
|
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.
The password specified in the username command is synchronized as the auth and priv passphrases for SNMP user.
Deleting a user using either command results in the user being deleted for both SNMP and CLI.
User-role mapping changes are synchronized in SNMP and CLI.
Examples
The following example shows how to define a user.
switch(config)# username knuckles password testpw role bodega
switch(config)# do show user-account
this user account has no expiry date
this user account has no expiry date
The following example configures the name for a user to login using iSCSI authentication:.
switch(config)# username iscsi
The 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
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
Related Commands
Command
|
Description
|
role
|
Configures user roles.
|
show username
|
Displays user name information.
|
username (iSCSI initiator mode)
To assigns a username for iSCSI login authentication, use the username command in iSCSI initiator configuration submode. To disable this feature, use the no form of the command.
username username
no username username
Syntax Description
username
|
Specifies the username for iSCSI login authentication.
|
Defaults
None.
Command Modes
iSCSI initiator configuration submode.
Command History
Release
|
Modification
|
1.3(2)
|
This command was introduced.
|
Usage Guidelines
None.
Examples
The following example assigns the username iSCSIloginUsername for iSCSI login authentication.
Enter configuration commands, one per line. End with CNTL/Z.
switch(config)# iscsi initiator name iqn.1987-02.com.cisco.initiator
switch(config-iscsi-init)# username iSCSIloginUsername
switch(config-iscsi-init)#
Related Commands
Command
|
Description
|
iscsi initiator name
|
Assigns an iSCSI name and changes to iSCSI initiator configuration submode.
|
show iscsi initiator
|
Displays information about configured iSCSI initiators.
|