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.
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
# 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} | 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
this user account has no expiry date
this user account has no expiry date
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
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