McDATA Network Card OPENconnectors Command Line Interace User Manual |
McDATA OPENconnectors
Command Line Interface
USER MANUAL
P/N 620-000134-500
REV B
McDATA Corporation
380 Interlocken Crescent Broomfield, CO 80021-3464
Corporate Headquarters: 800.545.5773
Web: www.mcdata.com
Sales E-mail: [email protected]
Download from Www.Somanuals.com. All Manuals Search And Download.
Contents
Preface ............................................................................................................................ix
Handling Command Line Interface Errors .................................1-14
Using the Command Line Interface Help ...................................1-15
Commenting Scripts.......................................................................1-16
ED-5000 Director.............................................................................1-17
Telnet Session...................................................................................1-18
Ethernet Connection Loss.......................................................1-18
iii
P/N 620-000134-500
McDATA OPENconnectors Command Line Interface USER MANUAL
Download from Www.Somanuals.com. All Manuals Search And Download.
Contents
config..................................................................................................2-2
config.system.contact..............................................................2-40
config.system.date...................................................................2-41
config.system.location ............................................................2-42
config.system.name.................................................................2-42
config.system.show.................................................................2-43
iv
McDATA OPENconnectors Command Line Interface USER MANUAL
Download from Www.Somanuals.com. All Manuals Search And Download.
P/N 620-000134-500
show.loginServer .................................................................... 2-71
show.nameServer .................................................................... 2-72
show.port.config...................................................................... 2-75
show.port.info ......................................................................... 2-76
show.port.nodes...................................................................... 2-77
v
P/N 620-000134-500
McDATA OPENconnectors Command Line Interface USER MANUAL
Download from Www.Somanuals.com. All Manuals Search And Download.
Contents
show.security.fabricBinding ..................................................2-83
show.security.switchBinding.................................................2-85
show.switch ..............................................................................2-86
show.system .............................................................................2-88
show.zoning .............................................................................2-89
Appendix A Error Messages
Glossary ........................................................................................................................g-1
Index ...............................................................................................................................i-1
vi
McDATA OPENconnectors Command Line Interface USER MANUAL
Download from Www.Somanuals.com. All Manuals Search And Download.
P/N 620-000134-500
Tables
1-1
1-2
1-3
CLI Command Tree Navigation Conventions .......................................... 1-3
CLI Command Tree ...................................................................................... 1-5
CLI Command Tree for the ED-5000 Director ........................................ 1-17
vii
P/N 620-000134-500
McDATA OPENconnectors Command Line Interface USER MANUAL
Download from Www.Somanuals.com. All Manuals Search And Download.
Tables
viii
McDATA OPENconnectors Command Line Interface USER MANUAL
Download from Www.Somanuals.com. All Manuals Search And Download.
P/N 620-000134-500
3UHIDFH
This publication is part of the documentation suite that supports the
McDATA® Sphereon™ 3016 Fabric Switch, Sphereon 3032 Fabric
Switch, Sphereon 3216 Fabric Switch, Sphereon 3232 Fabric Switch,
Sphereon 4500 Fabric Switch, Intrepid™ 6064 Director, and Intrepid
6140 Director.
Who Should Use This
Manual
This publication describes the commands that can be entered through
the Command Line Interface for the Intrepid 6064 Director, Intrepid
6140 Director, Sphereon 4500 Switch, Sphereon 3016 Switch,
Sphereon 3032 Switch, Sphereon 3216 Switch, and the Sphereon 3232
Switch. (A limited number of these commands are available on the
ED-5000 Director.) Access through a Telnet client is presumed.
This publication is intended for data center administrators and
customer support personnel, who can either enter the commands
manually or write a script containing them. However, the primary
purpose of the Command Line Interface is for scripts written by these
administrators and personnel for use in a host-based scripting
environment. Therefore, this publication presumes that the user is
familiar with:
•
•
•
•
Establishing and using a Telnet session
Using the command line of a terminal
Writing scripts
Networking, SAN, and zoning concepts
ix
P/N 620-000134-500
McDATA OPENconnectors Command Line Interface USER MANUAL
Download from Www.Somanuals.com. All Manuals Search And Download.
Preface
•
The publications listed in Related Publications provide considerable
Organization of This
Manual
This publication is organized as follows:
Chapter 1, Introduction, provides an introduction and overview of
Chapter 2, CLI Commands, describes the Command Line Interface
well as examples of their usage and any output that they
generate.
Appendix A, lists and explains error messages that may appear
while using the Command Line Interface.
The Glossary defines terms, abbreviations, and acronyms used in
this manual.
An Index is also provided.
Manual Updates
Check the McDATA web site at www.mcdata.com for possible
updates or supplements to this manual.
Related Publications
Other publications that provide additional information about the
products mentioned in this manual are:
•
•
•
•
•
•
•
McDATA Enterprise Fabric Connectivity Manager User Manual
(620-005001)
McDATA Products in a SAN Environment - Planning Manual
(620-000124)
McDATA ED-5000 Enterprise Fibre Channel Director Installation
Manual (620-005003)
McDATA ED-5000 Enterprise Fibre Channel Director Service Manual
(620-005004)
McDATA ED-5000 Enterprise Fibre Channel Director User Manual
(620-005002)
McDATA Intrepid 6064 Director Installation and Service Manual
(620-000108)
McDATA Intrepid 6140 and 6064 Director Product Manager User
Manual (620-000153)
x
McDATA OPENconnectors Command Line Interface USER MANUAL
Download from Www.Somanuals.com. All Manuals Search And Download.
P/N 620-000134-500
Preface
•
McDATA Intrepid 6140 Director Installation and Service Manual
(620-000157)
•
•
•
McDATA OPENconnectors SNMP Support Manual (620-000131)
McDATA SANpilot User Manual (620-000160)
McDATA Sphereon 3016 and 3216 Fabric Switch Product Manager
User Manual (620-000151)
•
•
•
•
•
•
•
•
•
•
•
McDATA Sphereon 3016 Switch Installation and Service Manual
(620-000112)
McDATA Sphereon 3016 Switch Product Manager User Manual
(620-000121)
McDATA Sphereon 3032 and 3232 Fabric Switch Product Manager
User Manual (620-000152)
McDATA Sphereon 3032 Switch Installation and Service Manual
(620-000116)
McDATA Sphereon 3032 Switch Product Manager User Manual
(620-000122)
McDATA Sphereon 3216 Switch Installation and Service Manual
(620-000139)
McDATA Sphereon 3216 Switch Product Manager User Manual
(620-000136)
McDATA Sphereon 3232 Switch Installation and Service Manual
(620-000142)
McDATA Sphereon 3232 Switch Product Manager User Manual
(620-000137)
McDATA Sphereon 4500 Switch Installation and Service Manual
(620-000159)
McDATA Sphereon 4500 Switch Product Manager User Manual
(620-000158)
xi
P/N 620-000134-500
McDATA OPENconnectors Command Line Interface USER MANUAL
Download from Www.Somanuals.com. All Manuals Search And Download.
Preface
Manual Conventions
The following notational conventions are used in this document:
Convention
Bold
Meaning
Keyboard keys, buttons and switches on hardware products,
and screen prompts for the Command Line Interface.
Italic
Outside book references, names of user interface windows,
buttons, and dialog boxes.
Monospaced
Command syntax, examples of commands, output.
A note presents important information that is not hazard-related.
Where to Get Help
For technical support, McDATA end-user customers should call the
phone number located on the service label attached to the front or
rear of the hardware product.
McDATA’s “Best in Class” Solution Center provides a single point of
contact for customers seeking help. The Solution Center will research,
explore, and resolve inquires or service requests regarding McDATA
products and services. The Solution Center is staffed 24 hours a day,
7 days a week, including holidays.
To expedite warranty entitlement, please have your product serial number
available.
McDATA Corporation
380 Interlocken Crescent
Broomfield, CO 80021
Phone: (800) 752-4572 or (720) 566-3910
Fax: (720) 566-3851
E-mail: [email protected]
Customers who purchased the hardware product from a company other than
support.
xii
McDATA OPENconnectors Command Line Interface USER MANUAL
Download from Www.Somanuals.com. All Manuals Search And Download.
P/N 620-000134-500
Preface
Forwarding
Publication
Comments
We sincerely appreciate any comments about this publication. Did
you find this manual easy or difficult to use? Did it lack necessary
information? Were there any errors? Could its organization be
improved?
Please send your comments via e-mail, our home page, or FAX.
Identify the manual, and provide page numbers and specific detail.
Thank you.
❏
❏
❏
E-mail:
Home Page: http://www.mcdata.com
Fax: Technical Communications Manager
(303) 465-4996
Ordering Publications
Trademarks
To order a paper copy of this manual, contact your McDATA
representative, or use the contact information listed below.
Phone: (800) 545-5773 and select the option for information on
McDATA’s complete family of enterprise-to-edge SAN solutions.
Fax: (720) 566-3860
The following terms, indicated by a registered trademark symbol (®)
or trademark symbol (™) on first use in this publication, are
trademarks of McDATA Corporation in the United States, other
countries, or both:
Registered Trademarks Trademarks
McDATA®
ED-5000 Director™
OPENconnectors™
Fibre Channel Director™
Intrepid™
Fabricenter®
SANpilot™
SANtegrity™
Sphereon™
All other trademarked terms, indicated by a registered trademark
symbol (®) or trademark symbol (™) on first use in this publication,
countries, or both.
xiii
P/N 620-000134-500
McDATA OPENconnectors Command Line Interface USER MANUAL
Download from Www.Somanuals.com. All Manuals Search And Download.
Preface
xiv
McDATA OPENconnectors Command Line Interface USER MANUAL
Download from Www.Somanuals.com. All Manuals Search And Download.
P/N 620-000134-500
,QWURGXFWLRQ
This chapter introduces the Command Line Interface (CLI) and
Section
Page
Command Line Interface Overview
Entering Command Line Interface Commands
Logging In and Logging Out
Using the commaDelim Command
Handling Command Line Interface Errors
Using the Command Line Interface Help
ED-5000 Director
1-2
1-3
1-11
1-13
1-14
1-15
1-17
1-18
Telnet Session
1-1
Introduction
Download from Www.Somanuals.com. All Manuals Search And Download.
Introduction
1
8hqꢀGvrꢀDrꢁshprꢀPrꢁvr
The Command Line Interface (CLI) is a feature that provides an
alternative to McDATA’s Enterprise Fabric Connectivity Manager
(EFCM) and SANpilot interface products for director and switch
management capabilities.
The CLI can only be used through a Telnet client session in an
out-of-band management environment, using the Ethernet port in the
director or switch. Although the primary use of the CLI is in
host-based scripting environments, the CLI commands can also be
entered directly at a command line. Any hardware platform that
supports the Telnet client software can be used.
The primary purpose of the CLI is to automate management of a
large number of switches with the use of scripts.
Because the CLI is not an interactive interface, no prompts are
displayed to guide the user through a task. If an interactive interface
is needed, the EFCM or SANpilot interface should be used instead of
the CLI.
1-2
McDATA OPENconnectors Command Line Interface USER MANUAL
Download from Www.Somanuals.com. All Manuals Search And Download.
P/N 620-000134-500
1
@rꢁvtꢀ8hqꢀGvrꢀDrꢁshprꢀ8hq
The CLI commands can be entered directly at the command line of a
terminal or coded in a script.
Note that the CLI commands are not case sensitive.
Throughout this publication, periods are used to separate the
'RFXPHQWDWLRQꢀ
&RQYHQWLRQV
components of a command name. However, the periods cannot be
included when the command is actually entered at the terminal or
coded in a script. (How to enter the commands is explained in
Navigation of the CLI Command Tree on page 1-8.)
Even though the commands cannot be entered with the periods, the
command line prompts do include the periods.
Config.Port>
Basic command line navigation conventions are supported. The
following table includes the asynchronous commands that are
recognized by the CLI.
1DYLJDWLRQꢀ
&RQYHQWLRQV
Table 1-1
CLI Command Tree Navigation Conventions
Character Sequence
Common Name
Action or Description
<CR>
Carriage Return
Pass a completed line to the
parser.
<DEL>
<NL>
Delete
Backspace one character
and delete the character.
New Line
Pass a completed line to the
parser.
<SP>
#
Space
Used to separate keywords.
Pound Sign
Used to designate
comments in a script.
?
“
Question Mark
Quotation Mark
Provide help information.
Used to surround a single
token.
^A
Control-A
Position the cursor to the
start of the line.
1-3
Entering Command Line Interface Commands
Download from Www.Somanuals.com. All Manuals Search And Download.
Introduction
1
Table 1-1
CLI Command Tree Navigation Conventions (continued)
Character Sequence
Common Name
Action or Description
^B
Control-B
Position the cursor left one
character.
^D
^E
Control-D
Control-E
Delete the current character.
Position the cursor to the
end of the line.
^F
^H
^I
Control-F
Control-H
Tab
Position the cursor right one
character.
Backspace one character
and delete the character.
Complete the current
keyword.
^K
^L
^N
Control-K
Control-L
Control-N
Delete to the end of the line.
Redraw the line.
Move down one line in the
command history.
^P
Control-P
Move up one line in the
command history.
^R
^U
Control-R
Control-U
Redraw the line.
Clear the input and reset the
line buffer.
^X
Control-X
Clear the input and reset the
line buffer.
<ESC>[A
<ESC>[B
<ESC>[C
<ESC>[D
Up Arrow
Move up one line in the
command history.
Down Arrow
Right Arrow
Left Arrow
Move down one line in the
command history.
Position the cursor right one
character.
Position the cursor left one
character.
1-4
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-500
Download from Www.Somanuals.com. All Manuals Search And Download.
1
The command tree of the CLI begins from the root. The commands in
the four extended branches (config, maint, perf, and show) are
&RPPDQGꢀ7UHH
described in Chapter 2, CLI Commands.
There are three additional commands (login, logout, and
commaDelim) that are globally available commands. These
commands are described in this chapter.
The hierarchy from the root, reading from left to right, is as follows.
Table 1-2
CLI Command Tree
config -------------------- features ----------------- installKey
enterpriseFabMode
ficonms
OpenSysMS
show
ip-------------------------- ethernet
show
port ----------------------- blocked
extDist
fan
name
speed
type
show
security ----------------- fabricBinding ----------- activatePending
addMember
clearMemList
deleteMember
replacePending
setFabBindState
showActive
showPending
portBinding ------------- bound
wwn
show
switchBinding ---------- addMember
deleteMember
setSwitchBindState
1-5
Entering Command Line Interface Commands
Download from Www.Somanuals.com. All Manuals Search And Download.
Introduction
1
Table 1-2
CLI Command Tree (continued)
show
userRights -------------- administrator
operator
show
snmp --------------------- addCommunity
authTraps
deleteCommunity
show
switch -------------------- bbCredit
domainRSCN
edTOV
insistDomainId
interopMode
prefDomainId
priority
raTOV
rerouteDelay
speed
show
system ------------------ contact
date
description
location
name
show
zoning ------------------- setDefZoneState
activateZoneSet
deactivateZoneSet
replaceZoneSet
clearZoneSet
addZone
deleteZone
renameZoneSet
addWwnMem
addPortMem
clearZone
1-6
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-500
Download from Www.Somanuals.com. All Manuals Search And Download.
1
Table 1-2
CLI Command Tree (continued)
deleteWwnMem
deletePortMem
renameZone
showPending
showActive
maint --------------------- port ----------------------- beacon
reset
system ------------------ beacon
clearSysError
ipl
resetConfig
setOnlineState
perf ----------------------- class2
class3
clearStats
errors
link
traffic
show --------------------- eventLog
features
frus
ip -------------------------- ethernet
loginServer
nameServer
nameServerExt
port ----------------------- config
info
nodes
status
technology
security ----------------- fabricBinding
portBinding
switchBinding
switch
system
zoning
1-7
Entering Command Line Interface Commands
Download from Www.Somanuals.com. All Manuals Search And Download.
Introduction
1
Note that the commands are shown, with the exception of the zoning
commands, in alphabetical order to make them easier to locate.
Although the commands can be entered in any order, depending on
on page 1-5 for the zoning commands is a typical order in which the
zoning commands are entered.
Note that the order in which commands are entered determines the
order in which the show commands display the values. Refer to
Chapter 2, CLI Commands for examples of show commands output.
prompt, the CLI commands are accessed by navigating up and down
the CLI command tree.
1DYLJDWLRQꢀRIꢀWKHꢀ
&/,ꢀ&RPPDQGꢀ7UHH
To move from the root through the any of the four extended branches,
enter the name of the next branch as shown in Table 1-2, CLI
Command Tree, on page 1-5. For example, to use the config.port.name
command to configure the name for port 4 on the switch, this series of
commands is entered:
Root> config
Config> port
Config.Port> name 4 "Sam’s Tape Drive"
At this point, to enter the maint.port.beacon command to set the
beaconing state of port 4, the following series of commands is
entered:
Config.Port> ..
Config> ..
Root> maint
Maint> port
Maint.Port> beacon 4 true
Note that you must return all the way to the root of the tree to
transition to another extended branch. When traversing back to the
root, the name of each branch cannot be used. Instead use the
double-dot command (two periods) to move back towards the root.
Note that only one double-dot command may be entered at a time.
One approach to making the navigation more concise is to use the
root command to jump directly to the root of the CLI command tree.
the double-dot command, is simplified as follows:
Config.Port> root
Root> maint
1-8
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-500
Download from Www.Somanuals.com. All Manuals Search And Download.
1
Maint> port
Maint.Port> beacon 4 true
Another approach to making the navigation more concise is to use
the complete command syntax from the Root> prompt each time. For
example, to issue the config.port.name command and then the
maint.port.beacon command, the commands are entered as follows:
Root> config port name 4 "Sam’s Tape Drive"
Root> maint port beacon 4 true
As shown in this example, use of the complete command syntax
avoids navigating up and down the branches of the CLI command
tree, and the prompt stays at the root. The use of complete command
syntax is particularly useful when writing scripts.
When coding a script, remember to code the appropriate character
sequences, which are described in Navigation Conventions on page 1-3.
Root> config port name 4 "Sam’s Tape Drive"<CR>
Root> maint port beacon 4 true<CR>
Gvvhvꢀ
Hrr
As the commands are entered, they are recorded in a history log.
Note these limitations on movement that result from use of the
history log:
•
If a command has more than 60 characters, the command runs,
but the command is not recorded in the history log, and the
position in the tree does not change, as shown in the following
example. Because the command is not recorded in the history, a
subsequent asynchronous command (navigation command)
cannot depend on it.
Root> config zoning addWwnMem TheUltimateZone 10:00:00:00
:C9:22:9B:64
Root>
•
Whenever the position in the CLI command tree moves to a new
branch (for example, config to maint, config to config.port, or
config.port to config), the history log is cleared. In this case, any
asynchronous commands (for example, the up-arrow command
<ESC>[A or the up-arrow keyboard symbol) cannot move the
position back towards the root, as shown in this example:
Root> config
Root.Config> port
Root.Config.Port> <ESC>[A
Root.Config.Port>
1-9
Entering Command Line Interface Commands
Download from Www.Somanuals.com. All Manuals Search And Download.
Introduction
1
Some command parameters accept character strings that include
spaces. Quotation marks are required when a string includes spaces.
3DUDPHWHUV
Config.System> location Building_24_Room_16
Config.System> location "Building 24 Room 16"
If spaces are not included in a parameter that accepts a string, the
quotation marks are not required around that string.
To include quotation marks in a string, use the escape character (\)
before the quotation marks.
Config.System> location "Building 24 \"Joe’s PlayLab\""
A null string can be created by using the quotation marks without
any space between them.
Config.System> location ""
All output from the CLI commands is limited to the standard 80
columns supported by most Telnet interfaces. The output is
left-justified.
2XWSXW
1-10
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-500
Download from Www.Somanuals.com. All Manuals Search And Download.
1
GttvtꢀDꢀhqꢀGttvtꢀP
The CLI allows a single Telnet client to be connected to the switch. If a
Telnet client logs out, or if after 15 minutes of inactivity the client’s
access times out, another Telnet client may log in. Also note that the
Telnet client (user) must log in any time the director or switch is
restarted because the current user’s access is lost. Examples of a
restart include an IPL and any power-off situation.
The CLI supports two user access rights: administrator and operator.
A user who logs in with administrator access rights can use all of the
commands described in this publication. However, operator access
rights grant permission to use only the perf and show branches of the
CLI command tree (for example, the perf.traffic and show.system
commands), as well as the globally available commands (login,
logout, and commaDelim).
8VHUꢀ$FFHVVꢀ5LJKWV
ORJLQ
Th login
Qꢁr
9rpꢁvv
This command allows a Telnet client to connect to the switch.
This command allows the user to log in with either administrator or
operator access rights. The default passwords are password.
The login command is called automatically by the CLI each time a
new Telnet session is activated, as well as each time new
administrator access rights are configured.
After the login command is issued, the Username: prompt
automatically displays. After a valid user name is entered, the
Password: prompt automatically displays. After the corresponding
valid password is entered, the Root> prompt displays. At this
prompt the user may enter any of the commands included in
Table 1-2, CLI Command Tree, on page 1-5.
A user name and password can be set by the administrator through
the config.security.userRights.administrator command or through the
config.security.userRights.operator command.
1-11
Logging In and Logging Out
Download from Www.Somanuals.com. All Manuals Search And Download.
Introduction
1
The access rights chosen for the CLI are completely independent of
the other product interfaces, for example, SNMP or McDATA product
interfaces.
Qhꢁhrrꢁ
This command has no parameters.
8hqꢀ@hyr login
Username: Administrator
Password: password
login
Username: Operator
Password: password
ORJRXW
Th logout
Qꢁr
This command allows a Telnet client to disconnect from the switch.
9rpꢁvv
This command logs out the single Telnet client connected to the
switch. This command can be entered at any point in the command
tree.
Qhꢁhrrꢁ
This command has no parameters.
8hqꢀ@hyr
Root> logout
Config> logout
Config.Port> logout
1-12
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-500
Download from Www.Somanuals.com. All Manuals Search And Download.
1
Vvtꢀurꢀph9ryvꢀ8hq
Note that the output examples shown in the other sections of this
publication presume that commaDelim is off.
FRPPD'HOLP
Th commaDelim enable
Qꢁr
This command enables the user to obtain displayed information in
comma-delimited, rather than tabular, format. Tabular format is the
default.
9rpꢁvv
Qhꢁhrrꢁ
This command can be entered at any point in the command tree.
This command has one parameter
enable
Specifies the comma-delineated state for
output. Valid values are true and false. Boolean 1
and 0 may be substituted as values.
8hqꢀ@hyr
Root> commaDelim true
Config> commaDelim 1
Config.Port> commaDelim false
Pꢀ@hyr
Output displayed in commaDelim mode is as follows:
Root> show eventLog
Date/Time,Code,Severity,FRU,Event Data,
04/12/01 10:58A,375,Major,CTP-0,00010203 04050607 08090A0B 0C0D0E0F,
04/12/01 10:58A,375,Major,CTP-0,00010203 04050607 08090A0B 0C0D0E0F,
04/12/01 9:58A,385,Severe,CTP-0,00010203 04050607 08090A0B 0C0D0E0F,
04/11/01 7:18P,395,Severe,CTP-0,00010203 04050607 08090A0B 0C0D0E0F,
1-13
Using the commaDelim Command
Download from Www.Somanuals.com. All Manuals Search And Download.
Introduction
1
Chqyvtꢀ8hqꢀGvrꢀDrꢁshprꢀ@ꢁꢁꢁ
Two types of errors detected by the CLI are:
•
An error associated with the interface. For example, a keyword is
misspelled or does not exist.
Root> confg
Error 234: Invalid Command
•
An error associated with fabric or switch issues. For example, a
parameter error is detected by the switch, where port 24 is
entered for a switch that supports only 16 ports.
Error 248: Invalid Port Number
In either case, the command is ignored. The CLI remains at the point
it was before the command was entered.
The error messages, including error number and error, are listed in
Appendix A, Error Messages.
1-14
McDATA OPENconnectors Command Line Interface USER MANUAL
Download from Www.Somanuals.com. All Manuals Search And Download.
P/N 620-000134-500
1
Vvtꢀurꢀ8hqꢀGvrꢀDrꢁshprꢀCry
The question mark (?) can be used within a command to obtain
certain information:
•
If the question mark is used in place of a command keyword, all
the keywords at that level of the CLI command tree display.
Root> config system ?
Command identified
contact
- Set the system contact attribute
date
- Set the system date and time
description
location
name
- Set the system description attribute
- Set the system location attribute
- Set the system name attribute
- Display the system configuration
show
•
If the question mark is used at the end of a recognized command,
any parameters for that command display.
Root> config port name ?
- name <portNumber> <portName>
•
If the question mark is used after one or more characters of a
keyword, any keywords at that level of the CLI command tree
display.
Root> config s?
security snmp switch system
1-15
Using the Command Line Interface Help
Download from Www.Somanuals.com. All Manuals Search And Download.
Introduction
1
8rvtꢀTpꢁv
The pound sign (#) can be used to add comments in a script file. The
pound sign must be the first character in the line; the CLI ignores
everything after the pound sign in that line. The following lines are
valid:
Root> #Change port 3 to an E_Port<CR>
Root> config port<CR>
config.port> ##################<CR>
config.port> ## Begin Script ##<CR>
config.port> ##################<CR>
The pound sign cannot be used after any other characters (a
command, for example) to start a comment. The following is an
invalid script line:
Root> maint system beacon true # Turn on beaconing<CR>
To correct the previous script line, move the comment either before or
after the line with the command. For example, the following
examples are both valid:
Root> # Turn on beaconing<CR>
Root> maint system beacon true<CR>
Root> maint system beacon true<CR>
Root> # Turn on beaconing<CR>
Comments of over 200 characters in length may cause unpredictable system
behavior. Limit comments to 200 characters per line.
1-16
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-500
Download from Www.Somanuals.com. All Manuals Search And Download.
1
@9ꢂ$ꢃꢃꢃꢀ9vꢁrpꢁ
A subset of the CLI commands described in this publication are
available on the ED-5000 Director™. The globally available
commands (login, logout, and commaDelim) are described
previously in this chapter. The following config, maint, and show
commands are described in Chapter 2, CLI Commands.
Table 1-3
CLI Command Tree for the ED-5000 Director
config -------------------- security ----------------- userRights -------------- administrator
operator
show
maint --------------------- system ------------------ resetConfig
show --------------------- ip -------------------------- ethernet
port ----------------------- config
info
status
switch
system
zoning
1-17
ED-5000 Director
Download from Www.Somanuals.com. All Manuals Search And Download.
Introduction
1
UryrꢀTrv
The CLI can only be used through a Telnet client session in an
out-of-band management environment, using the Ethernet port in the
director or switch. Although the primary use of the CLI is in
host-based scripting environments, the CLI commands can also be
entered directly at a command line. Any hardware platform that
supports the Telnet client software can be used.
If you have the Enterprise Fabric Connectivity Manager (EFC Manager) and a
Product Manager for a director or switch installed, you can use the Configure
option in these products to enable/disable Telnet access. You can also
enable/disable Telnet access by using the Configure option of the SANpilot
interface.
Telnet access is enabled by default. Any changes to the enabled state of the
Telnet server are retained through system resets and power cycles.
If the Ethernet cable is disconnected from the director or switch
during a Telnet session, one of three scenarios is possible:
(WKHUQHWꢀ&RQQHFWLRQꢀ
/RVV
•
•
•
Replace the Ethernet cable before the client connection times out,
and the Telnet session will continue.
Wait 15 minutes until the client connection times out; then replace
the Ethernet cable and restart the connection.
If the client connection has already timed out, replace the
Ethernet cable. Open a SANpilot interface window or Enterprise
Fabric Connectivity Manager (EFCM) Product Manager window.
Toggle the enabled state of the CLI, thereby clearing the client
connection. Restart the client connection.
Once the client connection is reestablished, verify your
configuration’s completeness and accuracy.
1-18
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-500
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
8hqꢀPrꢁvr
Most of the commands in this chapter are listed in alphabetical order
to make them easy to locate. Although the commands can be entered
in any order, depending on the results desired (so long as the tree
structure is followed), the order used herein for the zoning
commands follows a typical order of entry. The various show
commands are usually entered at the end of a group of other
commands to verify configuration changes.
psvt
The config branch of the CLI command tree contains commands that
set parameter values on the switch or director. These values are not
temporary (session) values, but are retained across power cycles.
The commands in the config branch can only be accessed by a user
with administrator level user rights.
CLI commands are activated on the switch immediately, except as
noted.
In general, the config naming commands (except for the
config.zoning commands) use the USASCII character set. All of the
characters in this 128-character set (the first 7-bit subset of the
ISO-8859-1 Latin-1 character set) are valid. Any exceptions are noted
in the specific command descriptions.
2-2
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
FRQILJꢁIHDWXUHVꢁHQWHUSULVH)DE0RGH
Th enterpriseFabMode enterpriseFabModeState
Qꢁr
This command sets the Enterprise Fabric Mode state for the fabric.
The McDATA SANtegrity™ feature key must be installed to activate
the Enterprise Fabric Mode state.
Qhꢁhrrꢁ
This command has one parameter.
enterpriseFabModeState
Specifies whether enterpriseFabMode is
active. Valid values are activate and
deactivate. Boolean 1 and 0 may be
substituted as values.
8hqꢀ@hyr
Root> config features enterpriseFabMode 1
FRQILJꢁIHDWXUHVꢁILFRQPV
Th ficonms ficonmsState
Qꢁr
This command sets the enabled state of the FICON Management
Server. The FICON Management Server feature key must be installed
in order to enable the FICON Management Server State. (The
Sphereon 4500 does not accept this command.)
Qhꢁhrrꢁ
This command has one parameter.
ficonmsState
Specifies whether the FICON Management
Server is enabled. Valid values are enable and
disable. Boolean 1 and 0 may be substituted as
values.
8hqꢀ@hyr
Root> config features ficonms 1
2-3
config
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
FRQILJꢁIHDWXUHVꢁLQVWDOO$H\
Th installKey featureKey
Qꢁr
This command allows the user to install a feature set that is enabled
by the provided feature key. The switch can be either offline or online
when this command is executed.
Qhꢁhrrꢁ
This command has one parameter.
featureKey
Specifies the key you have received to enable
optional software feature on a specific product.
A feature key is a string of case-sensitive,
alphanumeric ASCII characters.
The number of characters may vary in the
format; however, the key must be entered
exactly, including the hyphens. An example of a
feature key format is XxXx-XXxX-xxXX-xX.
8hqꢀ@hyr
Root> config features installKey AaBb-CCdD-eeFF-gH
FRQILJꢁIHDWXUHVꢁ2SHQ6\V06
Th OpenSysMS osmsState
Qꢁr
This command sets the enabled state of the Open Systems
Management Server. The Open Systems Management Server feature
key must be installed in order to enable the OSMS State.
Qhꢁhrrꢁ
This command has one parameter.
osmsState
Specifies whether the Open Systems
Management Server is enabled. Valid values are
enable and disable. Boolean 1 and 0 may be
substituted as values.
8hqꢀ@hyr
Root> config features OpenSysMS 1
2-4
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
FRQILJꢁIHDWXUHVꢁVKRZ
Th show
Qꢁr
This command shows the product feature information configured for
this switch.
Qhꢁhrrꢁ
8hqꢀ@hyr
P
This command has no parameters.
Root> config features show
The product feature data is displayed as a table that includes the
following property.
Installed Feature The feature set installed using a feature key.
Set
Only installed keys are displayed.
Feature
Individual features within each set. In many
cases, there is only one feature within each
feature set.
State
The state of the individual feature. Fabric-wide
features are displayed as Active/Inactive.
Switch-centric features are displayed as
Enabled/Disabled.
Pꢀ@hyr
The output from the config.features.show command displays as
follows.
Installed Feature Set
------------------------------
Open Systems Management Server
Flex Ports
Feature
State
------------------ -----
OSMS
Enabled
8 Flex Ports
Fabric Binding
Switch Binding
Enabled
Active
SANtegrity
SANtegrity
SANtegrity
Enabled
Enterprise Fabrics Active
2-5
config
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
FRQILJꢁLSꢁHWKHUQHW
Th ethernet ipAddress gatewayAddress subnetMask
Qꢁr
This command sets the Ethernet network settings.
9rpꢁvv
The Telnet connection can be lost when these Ethernet network settings are
changed.
If the IP address is reconfigured, your Telnet client must be reconnected to
the new IP address. A new login will be requested.
Qhꢁhrrꢁ
This command has three parameters.
ipAddress
Specifies the new IP address for the director or
switch. The address must be entered in dotted
decimal format (for example, 10.0.0.0).
gatewayAddress Specifies the new gateway address for the
Ethernet interface. The address must be entered
in dotted decimal format (for example, 0.0.0.0).
subnetMask
Specifies the new subnet mask for the Ethernet
interface. The address must be entered in dotted
decimal format (for example, 255.0.0.0).
8hqꢀ@hyr
Root> config ip ethernet 10.0.0.0 0.0.0.0 255.0.0.0
FRQILJꢁLSꢁVKRZ
Th show
Qꢁr
Qhꢁhrrꢁ
This command shows the LAN configuration.
This command has no parameters.
Root> config ip show
8hqꢀ@hyr
2-6
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
P
The LAN configuration data is displayed as a table that includes the
following properties.
IP Address
The IP address.
Gateway
Address
The gateway address.
Subnet Mask
The subnet mask.
Pꢀ@hyr
The output from the config.ip.show command displays as follows.
IP Address: 10.0.0.0
Gateway Address: 0.0.0.0
Subnet Mask: 255.0.0.0
FRQILJꢁSRUWꢁEORFNHG
Th blocked portNumber blockedState
Qꢁr
This command sets the blocked state for a port.
This command has two required parameters.
Qhꢁhrrꢁ
portNumber
blockedState
Specifies the port number. Valid values are:
0–15 for the Sphereon 3016 and 3216
0–23 for the Sphereon 4500
0–31 for the Sphereon 3032 and 3232
0–63 for the Intrepid 6064
0–127 and 132–144 for the Intrepid 6140
Specifies the blocked state for the port. Valid
values are true and false. Boolean 1 and 0 may be
substituted as values.
8hqꢀ@hyr
Root> config port blocked 4 false
Root> config port blocked 4 0
2-7
config
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
FRQILJꢁSRUWꢁH[W'LVW
Th extDist portNumber extDistOn
Qꢁr
This command sets the extended distance state for a port. (The
Sphereon 4500 does not accept this command.)
9rpꢁvv
Qhꢁhrrꢁ
When the extended distance field is true, the port is configured for 60
buffer credits, which supports a distance of up to 100 km for a
1 gigabits per second (Gbps) port.
This command has two required parameters.
portNumber
Specifies the port number. Valid values are:
0–15 for the Sphereon 3016 and 3216
0–31 for the Sphereon 3032 and 3232
0–63 for the Intrepid 6064
0–127 and 132–144 for the Intrepid 6140
extDistOn
Specifies the extended distance state for the
port. Valid values are true and false. Boolean 1
and 0 may be substituted as values.
8hqꢀ@hyr
Root> config port extDist 4 false
Root> config port extDist 4 0
2-8
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
FRQILJꢁSRUWꢁIDQ
Th fan portNumber fanOn
Qꢁr
This command sets the fabric address notification (FAN) state for a
port (Sphereon 4500 only). This configuration can be applied to any
port regardless of its current configuration. The FAN value is applied
at the time the port is configured and operated in a loop.
Qhꢁhrrꢁ
This command has two required parameters.
portNumber
fanOn
Specifies the port number. Valid values are:
0–23 for the Sphereon 4500
Specifies the FAN state for the port. Valid values
are true and false. Boolean 1 and 0 may be
substituted as values.
8hqꢀ@hyr
Root> config port fan 4 1
2-9
config
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
FRQILJꢁSRUWꢁQDPH
Th name portNumber “portName”
Qꢁr
Qhꢁhrrꢁ
This command sets the name for a port.
This command has two required parameters.
portNumber
Specifies the port number. Valid values are:
0–15 for the Sphereon 3016 and 3216
0–23 for the Sphereon 4500
0–31 for the Sphereon 3032 and 3232
0–63 for the Intrepid 6064
0–127 and 132–144 for the Intrepid 6140
portName
Specifies the name for the port. The port name
must not exceed 24 characters in length.
8hqꢀ@hyr
Root> config port name 4 “Sam’s tape drive”
2-10
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
FRQILJꢁSRUWꢁVSHHG
Th speed portNumber portSpeed
This command sets the speed for a port.
Qꢁr
9rpꢁvv
A port can be configured to operate at 1 Gbps, 2 Gbps, or a negotiated
speed. The port speed can be set only to 1 Gbps if the switch speed is
1 Gbps. An attempt to set the port speed to 2 Gbps or to negotiate in a
switch with a 1 Gbps switch speed results in an error message.
If the port speed is set to negotiate, the port and the device to which it
is attached negotiate the data speed setting to either 1 Gbps or
2 Gbps.
Port speed changes temporarily disrupt port data transfers.
This command has two required parameters.
Qhꢁhrrꢁ
portNumber
portSpeed
Specifies the port number. Valid values are:
0–15 for the Sphereon 3016 and 3216
0–23 for the Sphereon 4500
0–31 for the Sphereon 3032 and 3232
0–63 for the Intrepid 6064
0–127 and 132–144 for the Intrepid 6140
Specifies the speed of the port. Valid values are
1g, 2g, and negotiate.
8hqꢀ@hyr
Root> config port speed 4 2g
Root> config port speed 6 negotiate
2-11
config
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
FRQILJꢁSRUWꢁW\SH
Th type portNumber portType
Qꢁr
This command sets the allowed type for a port.
9rpꢁvv
A port can be configured as an F_Port, an E_Port, or a G_Port. On a
Sphereon 4500, a port can also be an Fx_port or Gx_port. The port
configurations function as follows:
•
F_Port—cannot be used as an interswitch link, but may attach to a
device with an N_Port.
•
•
E_Port—only other switches may attach to this type of port.
G_Port—either a device or another switch may attach to this type
of port.
•
•
Fx_Port — allows Arbitrated Loop operation in addition to the
functionality of an F_Port. (Sphereon 4500 only.)
Gx_Port—allows Arbitrated Loop operation in addition to the
functionality of an F_Port or an E_Port. (Sphereon 4500 only.)
Qhꢁhrrꢁ
This command has two required parameters.
portNumber
portType
Specifies the port number. Valid values are:
0–15 for the Sphereon 3016 and 3216
0–23 for the Sphereon 4500
0–31 for the Sphereon 3032 and 3232
0–63 for the Intrepid 6064
0–127 and 132–144 for the Intrepid 6140
Specifies the type of the port. Valid values are:
•
•
•
•
•
eport
fport
gport
fxport (Sphereon 4500 only)
gxport (Sphereon 4500 only)
8hqꢀ@hyr
Root> config port type 4 fport
2-12
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
FRQILJꢁSRUWꢁVKRZ
Th show portNumber
Qꢁr
This command displays the port configuration for a single port.
9rpꢁvv
This show command, on the config.port branch, displays the current
configuration for the specified port.
Qhꢁhrrꢁ
This command has one parameter.
portNumber
Specifies the port number. Valid values are:
0–15 for the Sphereon 3016 and 3216
0–23 for the Sphereon 4500
0–31 for the Sphereon 3032 and 3232
0–63 for the Intrepid 6064
0–127 and 132–144 for the Intrepid 6140
8hqꢀ@hyr
P
Root> config port show 4
The port configuration is displayed as a table that includes the
following properties.
Port Number
Name
The port number.
The port name.
Blocked
The blocked state. Valid values are true and
false.
Extended
Distance
The extended distance configuration state. Valid
values are true and false. (This field is not valid
on the Sphereon 4500.)
FAN
The fabric address notification (FAN) state.
Valid values are true and false. (Sphereon 4500
only.)
2-13
config
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
Type
The port type. Valid values are:
•
•
•
•
•
F Port
E Port
G Port
Fx Port (Sphereon 4500 only)
Gx Port (Sphereon 4500 only)
Speed
The port speed. Valid values are 1 Gb/sec,
2 Gb/sec, and Negotiate.
Pꢀ@hyr
The output from the config.port.show command displays as follows.
Port Number:
Name:
Blocked:
4
Sam’s tape drive
false
Extended distance: false
Type:
Speed:
F Port
2 Gb/sec
FRQILJꢁVHFXULW\ꢁIDEULF%LQGLQJ
Note that the config.security.fabricBinding commands function in a
different way from most CLI commands, which are single action
commands that take effect immediately. The first Fabric Binding
command entered invokes a work-area editor. The commands take
effect on a temporary copy of a Fabric Member List in the work area
until the temporary copy in the work area is activated to the fabric--or
is discarded.
Because not all the verification of the Fabric Member List can occur
on the temporary copy in the work area, it is possible, however
unlikely, that the copy of the list encounters no errors until the list is
activated to the fabric.
config.security.fabricBinding.activatePending
Th activatePending
Qꢁr
This command activates the fabric binding configuration contained in
the pending work area to the fabric.
2-14
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
This command takes effect immediately. The CLI verifies the list before
activating it to the fabric and adds the managed switch to the list if it is not
already present.
Qhꢁhrrꢁ
This command has no parameters.
Root> config security fabricBinding activatePending
config.security.fabricBinding.addMember
Th addMember wwn domainId
Qꢁr
This command adds a new member to the Fabric Member List in the
pending fabric binding work area. The number of entries is limited to
the maximum available domain ID’s for the fabric (31).
Changes from this command are not activated to the fabric until the
activatePending command is issued.
Qhꢁhrrꢁ
This command has two parameters:
wwn
Specifies the world wide name (WWN) of the
member to be added to the fabric membership
list. The value of the WWN must be in
colon-delimited hexadecimal notation (for
example, AA:00:AA:00:AA:00:AA:00).
domainId
The domain ID of the member to be added to
the fabric membership list. Valid domain ID’s
range from 1 to 31.
Root> config security fabricBinding addMember
AA:99:23:23:08:14:88:C1 2
2-15
config
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
config.security.fabricBinding.clearMemList
Th clearMemList
Qꢁr
This command clears the fabric membership list for the pending
fabric binding working area.
This information is not saved to the fabric until the activatePending
command is issued. When the list is cleared, the CLI automatically adds the
managed switch to the fabric membership list.
Qhꢁhrrꢁ
This command has no parameters.
config.security.fabricBinding.deleteMember
Th deleteMember wwn domainId
Qꢁr
This command removes a member from the Fabric Member List in
the pending fabric binding work area.
Changes are not activated to the fabric until the activatePending command is
issued.
Qhꢁhrrꢁ
This command has two parameters:
wwn
Specifies the WWN of the member to be
removed from the fabric membership list. The
value of the WWN must be in colon-delimited
hexadecimal notation (for example,
AA:00:AA:00:AA:00:AA:00).
domainId
The domain ID of the member to be removed
from the fabric membership list. Valid domain
ID’s range from 1 to 31.
Root> config security fabricBinding deleteMember
AA:99:23:23:08:14:88:C1
Root> config security fabricBinding deleteMember 2
2-16
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
config.security.fabricBinding.replacePending
Th replacePending
Qꢁr
This command replaces the pending working area with the fabric
binding configuration that is currently loaded on the fabric.
Qhꢁhrrꢁ
This command has no parameters.
Root> config security fabricBinding replacePending
config.security.fabricbinding.setState
Th setState fabricBindingState
Qꢁr
This command sets the fabric binding state for the pending fabric
binding configuration work area.
This state is not saved to the fabric until the activatePending command is
issued.
Qhꢁhrrꢁ
This command has one parameter:
fabricBindingState Specifies the fabric binding state for the
pending fabric binding configuration work
area. Valid values are:
inactive - Deactivate fabric binding. Switches
and directors are allowed to join the fabric
without restriction. The fabric membership list
is empty in this state and as such, the fabric
membership list is cleared when this state is
requested.
restrict - Activate fabric binding and restrict
connections. Only switches identified in the
fabric membership list may join the fabric in
this state. The fabric membership list is
automatically populated with devices attached
prior to activation, but all new members must
be manually added before connecting. The
switch must be online to complete this request.
Root> config security fabricBinding setstate restrict
2-17
config
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
config.security.fabricBinding.showActive
Th showActive
Qꢁr
This command displays the fabric binding configuration saved on the
fabric. It performs the same function as show.security.fabricBinding.
Qhꢁhrrꢁ
P
This command has no parameters.
This command displays the following fabric binding configuration
data:
Fabric Binding
State
The active fabric binding state: Inactive or
Active Restricting
Fabric
Membership List
The active fabric membership list.
Pꢀ@hyr
The output from the config.security.fabricBinding.showActive
command displays as follows.
Fabric Binding State: Active Restricting
Domain 1 (00:11:22:33:44:55:66:77
Domain 2 (88:99:AA:BB:CC:DD:EE:FF)
Domain 14 (11:55:35:45:24:78:98:FA)
2-18
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
config.security.fabricBinding.showPending
Th showPending
Qꢁr
This command displays the fabric binding configuration in the
pending working area and has not yet been activated to the fabric. If
no changes have been made to the pending environment, the CLI
displays the Active membership list.
Qhꢁhrrꢁ
P
This command has no parameters.
The fabric binding configuration data is displayed as a table that
includes the following properties.
Fabric Binding
State
The pending fabric binding state: Inactive or
Active Restricting
Fabric
Membership List
The pending fabric membership list.
Pꢀ@hyr
The output from the config.security.fabricBinding.showPending
command displays as follows.
Fabric Binding State: Active Restricting
Domain 1 (00:11:22:33:44:55:66:77)
Domain 2 (88:99:AA:BB:CC:DD:EE:FF)
Domain 14 (11:55:35:45:24:78:98:FA)
2-19
config
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
FRQILJꢁVHFXULW\ꢁSRUW%LQGLQJ
config.security.portBinding.bound
Th bound portNumber portBindingState
Qꢁr
This command sets the port binding state for a given port.
This command has two parameters.
Qhꢁhrrꢁ
portNumber
Specifies the port number for which the port
binding state is being set. Valid port number
values are:
0–15 for the Sphereon 3016 and 3216
0–23 for the Sphereon 4500
0–31 for the Sphereon 3032 and 3232
0–63 for the Intrepid 6064
0–127 and 132–144 for the Intrepid 6140
portBindingState
Specifies the port binding state as active or
inactive. Valid values are true and false.
true sets the port binding to active. The
specified port is bound to the WWN configured
with the config.security.portBinding.wwn
command. If no WWN has been configured, no
devices can log in to that port.
false sets the port binding to inactive. Any
device is free to connect to the specified port in
this state, regardless of the WWN setting.
Boolean 1 and 0 may be substituted as values.
8hqꢀ@hyr
Root> config security portBinding bound 4 true
Root> config security portBinding bound 4 1
2-20
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
config.security.portBinding.wwn
Th wwn portNumber boundWwn
Qꢁr
This command configures the single device WWN to which a port is
bound.
Qhꢁhrrꢁ
This command has two parameters.
portNumber
Specified the port number for which the bound
WWN is being set. Valid port number values
are:
0–15 for the Sphereon 3016 and 3216
0–23 for the Sphereon 4500
0–31 for the Sphereon 3032 and 3232
0–63 for the Intrepid 6064
0–127 and 132–144 for the Intrepid 6140
boundWwn
Specifies the WWN of the device that is being
bound to the specified port. The value must be
entered in colon-delimited hexadecimal
notation (for example, 11:22:33:44:55:66:AA:BB).
If the boundWwn is configured and the
portBindState is:
Active—only the device described by
boundWwn is able to connect to the specified
port.
Inactive—the WWN is retained, but any device
can connect to the specified port.
Instead of the WWN, either of two values can
be entered in this parameter:
attached automatically configures the currently
attached device WWN as the bound WWN.
remove changes the WWN to the default value,
00:00:00:00:00:00:00:00. Even though this
removes the WWN-port association, if the
portBindingState value set with the
config.security.portBinding.bound command is
still true (the port binding is active), other
devices are prevented from logging in to this
port. To allow other devices to log in to this
port, use the config.security.portBinding.bound
command to set the portBindingState parameter
to false.
2-21
config
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
8hqꢀ@hyr
Root> config security portBinding wwn 4
AA:99:23:23:08:14:88:C1
Root> config security portBinding wwn 4 attached
Root> config security portBinding wwn 4 remove
config.security.portBinding.show
Th show portNumber
Qꢁr
This command shows the port binding configuration for a single
port.
Qhꢁhrrꢁ
This command has one parameter.
portNumber
Specifies the port number for which the port
binding configuration will be shown. Valid
values are:
0–15 for the Sphereon 3016 and 3216
0–23 for the Sphereon 4500
0–31 for the Sphereon 3032 and 3232
0–63 for the Intrepid 6064
0–127 and 132–144 for the Intrepid 6140
8hqꢀ@hyr
P
Root> config security portBinding show 4
The port binding configuration date is displayed as a table that
includes the following properties.
Port Number
The port number.
WWN Binding
The state of port binding for the specified port,
either active or inactive.
Bound WWN
The WWN of the device that is bound to the
specified port. If this field is blank, no device
has been bound to the specified port.
Pꢀ@hyr
The output from the config.security.portBinding.show command
displays as follows.
Port Number:
WWN Binding:
Bound WWN:
4
Active
AA:99:23:23:08:14:88:C1
2-22
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
FRQILJꢁVHFXULW\ꢁVZLWFK%LQGLQJ
config.security.switchBinding.addMember
Th addMember wwn
Qꢁr
This command adds a new member to the Switch Membership List.
A maximum number of 256 members may be added to the switch
membership list.
Qhꢁhrrꢁ
This command has one parameter:
wwn
Specifies the switch or N-Port device WWN of
the member to be added to the switch
membership list. The value of the WWN must
be in colon-delimited hexadecimal notation (for
example, AA:00:AA:00:AA:00:AA:00).
Root> config security switchBinding addMember
AA:99:23:23:08:14:88:C1
config.security.switchBinding.deleteMember
Th deleteMember wwn
Qꢁr
This command removes a member from the Switch Member List. The
user cannot remove a member that is currently logged into the
switch.
Qhꢁhrrꢁ
This command has one parameter:
wwn
Specifies the switch or N-Port device WWN of
the member to be removed from the switch
membership list. The value of the WWN must
be in colon-delimited hexadecimal notation (for
example, AA:00:AA:00:AA:00:AA:00). The user
may also enter all for this argument to clear the
switch membership list completely. Note that
the user cannot clear a WWN that is currently
logged into the switch.
Root> config security switchBinding deleteMember
AA:99:23:23:08:14:88:C1
2-23
config
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
config.security.switchBinding.setState
Th setState switchBindingState
Qꢁr
This command sets the switch binding state on the switch.
This command has one parameter:
Qhꢁhrrꢁ
switchBindingState
Sets the switch binding state for the switch.
Valid values are:
disable - Disable switch binding. Devices
(servers, storage, and other switches) are
allowed to connect to the switch without
restrictions.
eRestrict - Enable switch binding and restrict
E_Port connections. E_Ports are prevented
from forming ISL connections unless
explicitly identified in the switch
membership list. F_Port connections are
allowed without restriction.
fRestrict - Enable switch binding and restrict
F_Port connections. Server and (or) storage
devices are prevented from forming F_Port
connections with the switch unless explicitly
identified in the switch membership list.
E_Ports are allowed to form ISL connections
without restriction.
allRestrict - Enable switch binding and
restrict E_Port and F_Port connections. Both
E_Ports and F_Ports prohibit connections
with all devices unless explicitly identified
in the switch membership list.
Root> config security switchBinding setState allRestrict
2-24
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
config.security.switchBinding.show
Th show
Qꢁr
Qhꢁhrrꢁ
P
This command displays the switch binding configuration.
This command has no parameters.
This command displays the following switch binding configuration
data:
switchBindingState
Disabled, Enabled and Restricting F_Ports,
Enabled and Restricting E_Ports, or Enabled
and Restricting All Ports.
Switch Membership The switch membership list saved on the
List switch.
Pꢀ@hyr
The output from the config.security.portBinding.show command
displays as follows.
Switch Binding State: Enabled and Restricting E Ports
00:11:22:33:44:55:66:77
88:99:AA:BB:CC:DD:EE:FF
11:55:35:45:24:78:98:FA
2-25
config
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
FRQILJꢁVHFXULW\ꢁXVHU5LJKWV
config.security.userRights.administrator
Th administrator “username” “password”
Qꢁr
9rpꢁvv
Qhꢁhrrꢁ
This command sets the name and password for administrator-level
access.
Immediately after the name and password for the administrator is
set, you are prompted to log in with the new access rights.
This command has two parameters.
username
password
Specifies the new user name for
administrator-level login. Default is set to
Administrator. This parameter is 1–15 characters.
Valid characters include all characters in the
USASCII character set, excluding control
characters and spaces. Spaces are not valid even
though quotation marks are used.
Specifies the password for administrator-level
login. Default is set to password. This parameter
is 1–15 characters. Valid characters include all
characters in the USASCII character set,
excluding control characters and spaces. Spaces
are not valid even though quotation marks are
used.
8hqꢀ@hyr
Root> config security userRights administrator
“Administrator” “newpassword”
2-26
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
config.security.userRights.operator
Th operator “username” “password”
Qꢁr
This command sets the name and password for operator-level access.
This command has two parameters.
Qhꢁhrrꢁ
username
Specifies the new user name for operator-level
login. Default is Operator. This parameter is 1–15
characters. Valid characters include all
characters in the USASCII character set,
excluding control characters and spaces. Spaces
are not valid even though quotation marks are
used.
password
Specifies the password for operator-level login.
Default is password. This parameter is 1–15
characters. Valid characters include all
characters in the USASCII character set,
excluding control characters and spaces. Spaces
are not valid even though quotation marks are
used.
8hqꢀ@hyr
Root> config security userRights operator “Operator”
“newpassword”
2-27
config
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
config.security.userRights.show
Th show
Qꢁr
Qhꢁhrrꢁ
This command shows the user rights for the CLI access levels.
This command has no parameters.
8hqꢀ@hyr
P
Root> config security userRights show
The user rights configuration data is displayed as a table that
includes the following properties.
Operator
The username for operator privileges.
The password for operator privileges.
The username for administrator privileges.
The password for administrator privileges.
Username
Operator
Password
Administrator
Username
Administrator
Password
Pꢀ@hyr
The output from the config.security.userRights.show command
displays as follows.
Operator Username: Operator
Operator Password: **************
Administrator Username: Administrator
Administrator Password: ***************
2-28
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
FRQILJꢁVQPSꢁDGG&RPPXQLW\
Th addCommunity commIndex "commName" writeAuthorization
trapRecipient udpPortNum
Qꢁr
This command adds an SNMP community to the SNMP
configuration.
Qhꢁhrrꢁ
This command has five parameters. Up to six community names and
trap recipients may be defined.
commIndex
commName
Specifies the community to be created or edited.
Valid values are integers in the range 1–6.
Specifies the community name of the
community specified by commIndex. The
community name must not exceed 32 characters
in length. Valid characters include all those in
the ISO Latin-1 character set. Duplicate
community names are allowed, but the
corresponding writeAuthorization values must
match.
writeAuthorization
Specifies the write authorization state of the
community. Valid values are enabled and
disabled. Boolean 1 and 0 may be substituted as
values.
trapRecipient
udpPortNum
Specifies the trap recipient. Values must be
4 bytes in dotted-decimal format.
Specifies the user datagram protocol (UDP) port
number to which the director sends traps for
each recipient. The value can be a decimal
number or default. The default value is 162.
Valid values include all legal UDP port
numbers.
8hqꢀ@hyr
Root> config snmp addCommunity 1 "CommunityName1" enabled
123.123.123.123 162
2-29
config
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
FRQILJꢁVQPSꢁDXWK7UDSV
Th authTraps enabledState
Qꢁr
This command enables or disables the authorization traps to be sent
to SNMP management stations when unauthorized stations try to
access SNMP information from the director or switch.
Qhꢁhrrꢁ
This command has one parameter.
enabledState
Specifies whether the authorization traps are
enabled. Valid values are true and false. Boolean
1 and 0 may be substituted as values.
8hqꢀ@hyr
Root> config snmp authTraps true
Root> config snmp authTraps 1
FRQILJꢁVQPSꢁGHOHWH&RPPXQLW\
Th deleteCommunity commIndex
Qꢁr
This command entirely deletes a community from the SNMP.
This command has one parameter.
Qhꢁhrrꢁ
commIndex
Specifies the community to be deleted. Valid
values are integers in the range 1–6. This value
was set in the commIndex parameter of the
config.snmp.addCommunity command. Valid
values are integers in the range 1–6.
8hqꢀ@hyr
Root> config snmp deleteCommunity 5
2-30
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
FRQILJꢁVQPSꢁVKRZ
Th show
Qꢁr
Qhꢁhrrꢁ
This command shows the switch SNMP configuration.
This command has no parameters.
8hqꢀ@hyr
P
Root> config snmp show
The switch configuration data is displayed as a table that includes the
following properties.
Authorization
Traps
The state of the authorization traps (for
example, enabled) that are sent to SNMP
management stations when unauthorized
stations attempt to access SNMP information
from the switch.
Index
The community index number.
The name of the community.
The write authorization state.
The address of the trap recipient.
Community Name
WriteAuth
Trap Recipient
UDP Port
The user datagram protocol (UDP) port number
to which the director will send traps for each
recipient.
Pꢀ@hyr
The output from the config.snmp.show command displays as
follows.
Authorization Traps: Enabled
Index Community Name
WriteAuth Trap Recipient UDP Port
----- -------------------------------- --------- --------------- --------
1
2
3
4
5
6
CommunityName1
CommunityName2
CommunityName3
public
Enabled
Enabled
123.123.123.123 162
10.25.25.10
144
162
162
Disabled 132.44.85.224
Enabled
2-31
config
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
FRQILJꢁVZLWFK
Some of the config.switch commands require that the switch be set
offline. (Use the maint.system.setOnlineState to set the switch
offline.) If these commands are entered while the switch is online, an
error message results.
FRQILJꢁVZLWFKꢁEE&UHGLW
Th bbCredit bbCreditValue
Qꢁr
This command sets the buffer-to-buffer credit value for all ports,
except those ports configured for extended distance. (The Sphereon
4500 does not accept this command.)
9rpꢁvv
Qhꢁhrrꢁ
The switch must be set offline before this command is entered.
This command has one parameter.
bbCreditValue
Specifies the new buffer-to-buffer credit value.
This parameter must be an integer in the range
1–60.
8hqꢀ@hyr
Root> config switch bbCredit 2
FRQILJꢁVZLWFKꢁGRPDLQ56&1
Th domainRSCN domainRSCNState
Qꢁr
This command sets the domain RSCN state for the switch. The switch
can be either offline or online when this command is executed.
Qhꢁhrrꢁ
This command has one parameter.
domainRSCNState Specifies whether the domain RSCN state is
enabled. Valid values are enable and disable.
Boolean 1 and 0 may be substituted as values.
8hqꢀ@hyr
Root> config switch domainRSCN 1
2-32
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
FRQILJꢁVZLWFKꢁLQVLVW'RPDLQ,G
Th insistDomainId insistentDomainIdState
Qꢁr
This command sets the insistent domain ID state for the switch.
Qhꢁhrrꢁ
This command has one parameter.
insistentDomainIdState Specifies whether the insistent domain ID
state is enabled. Valid values are enable and
disable. Boolean 1 and 0 may be substituted
as values.
8hqꢀ@hyr
Root> config switch insistDomainId 1
FRQILJꢁVZLWFKꢁHG729
Th edTOV timeoutValue
Qꢁr
This command sets the E_D_TOV for the switch.
9rpꢁvv
The switch must be set offline before this command is entered.
Special care should be used when scripting this command due to its
relationship with R_A_TOV.
Qhꢁhrrꢁ
This command has one parameter.
timeoutValue
Specifies the new E_D_TOV value. The units for
this value are tenths of a second. This parameter
must be an integer in the range 2–600
(0.2 second to 60 seconds), and it must be
smaller than the R_A_TOV.
8hqꢀ@hyr
Root> config switch edTOV 4
2-33
config
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
FRQILJꢁVZLWFKꢁLQWHURS0RGH
Th interopMode interopMode
Qꢁr
This command sets the interoperability mode for the switch. The
switch must be offline to complete this command.
9rpꢁvv
Qhꢁhrrꢁ
The switch must be set offline before this command is entered.
This command has one parameter.
interopMode
Specifies the interoperability mode. Valid
values are mcdata and open:
mcdata — McDATA Fabric 1.0
open — Open Fabric 1.0
8hqꢀ@hyr
Root> config switch interopMode open
FRQILJꢁVZLWFKꢁSUHI'RPDLQ,G
Th prefDomainId domainId
Qꢁr
This command sets the preferred domain ID for the switch. The
switch must be offline to complete this command.
9rpꢁvv
Qhꢁhrrꢁ
The switch must be set offline before this command is entered.
This command has one parameter.
domainId
Specifies the new preferred domain ID value.
This parameter must be an integer in the range
1–31.
8hqꢀ@hyr
Root> config switch prefDomainId 1
2-34
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
FRQILJꢁVZLWFKꢁSULRULW\
Th priority switchPriority
Qꢁr
9rpꢁvv
Qhꢁhrrꢁ
This command sets the switch priority.
The switch must be set offline before this command is entered.
This command has one parameter.
switchPriority
Specifies the switch priority. Valid values are:
principal, default, or neverprincipal.
principal — sets the numerical switch priority
to 1. The switch with a priority of 1 becomes the
principal switch; however, if two or more
switches have a priority of 1, the switch with
the lowest WWN becomes the principal switch.
default — sets the numerical switch priority
to 254. If no switch is set to principal, the switch
with a priority 254 becomes the principal
switch; however, if two or more switches have a
priority of 254, the switch with the lowest
WWN becomes the principal switch.
neverprincipal — sets the numerical switch
priority to 255. This switch is not able to become
the principal switch.
At least one switch in a multiswitch fabric must
have a switch priority value of principal or
default.
The number codes 2–253 are not now in use.
8hqꢀ@hyr
Root> config switch priority principal
2-35
config
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
FRQILJꢁVZLWFKꢁUD729
Th raTOV timeoutValue
Qꢁr
This command sets the R_A_TOV for the switch.
9rpꢁvv
The switch must be set offline before this command is entered.
Special care should be used when scripting this command due to its
relationship with E_D_TOV.
Qhꢁhrrꢁ
This command has one parameter.
timeoutValue
Specifies the new R_A_TOV value. The units for
this value are tenths of a second. This parameter
must be an integer in the range 10–1200
(1 second to 120 seconds), and it must be larger
than the E_D_TOV.
8hqꢀ@hyr
Root> config switch raTOV 20
2-36
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
FRQILJꢁVZLWFKꢁUHURXWH'HOD\
Th rerouteDelay rerouteDelayState
Qꢁr
This command enables or disables rerouting delay for the switch.
9rpꢁvv
The switch can be either offline or online when this command is
executed.
This command is only applicable if the configured switch is in a
multiswitch fabric. Enabling the rerouting delay ensures that frames
are delivered in order through the fabric to their destination.
If there is a change to the fabric topology that creates a new path (for
example, a new switch is added to the fabric), frames may be routed
over this new path if its hop count is less than a previous path with a
minimum hop count. This may result in frames being delivered to a
destination out of order because frames sent over the new, shorter
path may arrive ahead of older frames still in route over the older
path.
If rerouting delay is enabled, traffic ceases in the fabric for the time
specified in the config.switch.edTOV command. This delay allows
frames sent on the old path to exit to their destination before new
frames begin traversing the new path. Note that during this delay
period, frames addressed to the destinations that are being rerouted
are discarded if they are Class 3 frames and rejected if they are Class 2
or Class F frames.
Qhꢁhrrꢁ
This command has one parameter.
rerouteDelayState
Specifies whether rerouting delay is enabled.
Valid values are true and false. Boolean 1 and 0
may be substituted as values.
8hqꢀ@hyr
Root> config switch rerouteDelay true
Root> config switch rerouteDelay 1
2-37
config
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
FRQILJꢁVZLWFKꢁVSHHG
Th speed switchSpeed
Qꢁr
This command sets the speed for the switch.
This command is only applicable for the Intrepid 6064. Sphereon products
cannot change switch speed.
9rpꢁvv
The switch must be set offline before this command is entered.
A switch can be configured to operate at 1 Gbps or 2 Gbps.
If the switch has FPM cards, configuring the switch speed to 2 Gbps
makes all the ports on the FPM cards inactive, and their operational
state will be set to inactive. FPM ports do not support 2 Gbps and,
therefore, will remain inactive after the switch is returned to the
online state.
Qhꢁhrrꢁ
This command has one required parameter.
switchSpeed
Specifies the speed of the switch. Valid values
are 1g (for 1 Gbps) or 2g (for 2 Gbps).
8hqꢀ@hyr
Root> config switch speed 2g
2-38
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
FRQILJꢁVZLWFKꢁVKRZ
Th show
Qꢁr
Qhꢁhrrꢁ
9rpꢁvv
This command shows the switch configuration.
This command has no parameters.
The switch can be either offline or online when this command is
executed.
8hqꢀ@hyr
P
Root> config switch show
The switch configuration data is displayed as a table that includes the
following properties.
BB Credit
The maximum number of outstanding frames
that can be transmitted without causing a buffer
overrun condition at the receiver. (This is not
valid for the Sphereon 4500.)
R_A_TOV
E_D_TOV
Resource Allocation Time Out Value.
This value is set in tenths of a second.
Error Detect Time Out Value.
This value is set in tenths of a second.
Preferred
Domain Id
The preferred domain ID of the switch.
Switch Priority
The switch priority. Values are Principal,
Default, or Never Principal.
Speed
The switch speed. (This is not valid for the
Sphereon 4500.)
Rerouting Delay The rerouting delay that ensures that frames are
delivered in order through the fabric to their
destination. Values are Enabled or Disabled.
Interop Mode
Interoperability mode for the switch.
2-39
config
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
Insistent Domain When enabled, ensures that the embedded
Id
firmware cannot change a switch’s preferred
domain ID.
Domain RSCN
When enabled, allows domain RSCNs to be sent
to registered members of the fabric.
Pꢀ@hyr
The output from the config.switch.show command displays as
follows.
BB Credit:
R_A_TOV:
E_D_TOV:
2
20
4
Preferred Domain Id: 1
Switch Priority:
Speed:
Principal
2 Gb/sec
Rerouting Delay:
Interop Mode:
Enabled
Open Fabric 1.0
Insistent Domain Id: Disabled
Domain RSCN: Enabled
FRQILJꢁV\VWHPꢁFRQWDFW
Th contact “systemContact”
Qꢁr
This command sets the system contact attribute.
This command has one parameter.
Qhꢁhrrꢁ
systemContact
Specifies the new system contact string for the
director or switch. The contact can contain
0–255 characters.
8hqꢀ@hyr
Root> config system contact “Joe”
2-40
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
FRQILJꢁV\VWHPꢁGDWH
Th date sysDate sysTime
Qꢁr
This command sets the system date and time.
This command has two required parameters.
Qhꢁhrrꢁ
sysDate
sysTime
Specifies the new system date. The format of the
date parameter must be mm:dd:yyyy or
mm/dd/yyyy. Valid date values include:
mm: 1–12
dd: 1–31
yyyy: >1980
Specifies the new system time. The format of
the time parameter must be hh:mm:ss. Valid
time values include:
hh: 0–23
mm: 0–59
ss: 0–59
8hqꢀ@hyr
Root> config system date 04:16:2001 10:34:01
Root> config system date 10/09/2001 14:07:55
FRQILJꢁV\VWHPꢁGHVFULSWLRQ
Th description “systemDescription”
Qꢁr
This command sets the system description string.
This command has one parameter.
Qhꢁhrrꢁ
systemDescription Specifies the new system description string for
the director or switch. The name can contain
0–255 characters.
8hqꢀ@hyr
Root> config system description “McDATA Intrepid 6064
Fibre Channel Director”
2-41
config
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
FRQILJꢁV\VWHPꢁORFDWLRQ
Th location “systemLocation”
Qꢁr
This command sets the system location attribute.
This command has one parameter.
Qhꢁhrrꢁ
systemLocation
Specifies the new system location for the
director or switch. The location can contain
0–255 characters.
8hqꢀ@hyr
Root> config system location “Everywhere”
FRQILJꢁV\VWHPꢁQDPH
Th name “systemName”
Qꢁr
This command sets the system name attribute.
This command has one required parameter.
Qhꢁhrrꢁ
systemName
Specifies the new system name for the director
or switch. The name can contain 0–24
characters.
8hqꢀ@hyr
Root> config system name “Joe’s Switch”
2-42
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
FRQILJꢁV\VWHPꢁVKRZ
Th show
Qꢁr
Qhꢁhrrꢁ
This command shows the system configuration.
This command has no parameters.
Root> config system show
8hqꢀ@hyr
P
The system configuration is displayed as a table that includes the
following properties.
Name
The system name.
Description
Contact
The system description.
The system contact.
Location
Date/Time
The system location.
The system date and time.
Pꢀ@hyr
The output from the config.system.show command displays as
follows.
Name:
Joe’s Switch
Description: McDATA Intrepid 6064 Fibre Channel
Director
Contact:
Location:
Date/Time:
Joe
Everywhere
04/16/2001 10:34:01
2-43
config
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
FRQILJꢁ]RQLQJ
Note that the config.zoning commands function in a different way
from most CLI commands, which are single action commands that
take effect immediately. A zoning configuration is typically too
complicated to be described by a single command, so the first zoning
command entered invokes a work-area editor. The commands take
effect on a temporary copy of a zone set in the work area until the
temporary copy in the work area is activated to the fabric--or is
discarded.
Because not all the verification of the zone set can occur on the
temporary copy in the work area, it is possible, however unlikely, that
the copy of the zone set encounters no errors until the zone set is
activated to the fabric.
Port numbers cannot be used for zone members if the interoperability mode
for the switch or director is set to Open Fabric 1.0 mode. In this case, you
must use node WWNs as zone members.
FRQILJꢁ]RQLQJꢁVHW'HI=RQH6WDWH
Th setDefZoneState defaultZoneState
Qꢁr
This command enables or disables the default zone and takes effect
immediately fabric wide.
9rpꢁvv
Qhꢁhrrꢁ
This command takes effect immediately in the fabric.
This command has one parameter.
defaultZoneState
Specifies whether the default zone is enabled.
Valid values are true and false. Boolean 1 and 0
may be substituted as values.
8hqꢀ@hyr
Root> config zoning setDefZoneState false
Root> config zoning setDefZoneState 0
2-44
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
FRQILJꢁ]RQLQJꢁDFWLYDWH=RQH6HW
Th activateZoneSet
Qꢁr
This command activates the zone set contained in the work area to
the fabric and takes effect immediately.
9rpꢁvv
This command takes effect immediately in the fabric.
Qhꢁhrrꢁ
This command has no parameters.
8hqꢀ@hyr
Root> config zoning activateZoneSet
If the interoperability mode for the switch or director is set to Open Fabric 1.0
mode when the zone is activated, any zone members specified by port
number are ignored.
FRQILJꢁ]RQLQJꢁGHDFWLYDWH=RQH6HW
Th deactivateZoneSet
Qꢁr
This command places all attached devices in the default zone and
takes effect immediately fabric wide.
9rpꢁvv
The default zone must be activated independently of this command.
This command takes effect immediately in the fabric.
Qhꢁhrrꢁ
This command has no parameters.
8hqꢀ@hyr
Root> config zoning deactiveZoneSet
2-45
config
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
FRQILJꢁ]RQLQJꢁUHSODFH=RQH6HW
Th replaceZoneSet
Qꢁr
This command replaces the work area with the active zone set that is
currently loaded on the fabric.
Qhꢁhrrꢁ
This command has no parameters.
8hqꢀ@hyr
Root> config zoning replaceZoneSet
FRQILJꢁ]RQLQJꢁFOHDU=RQH6HW
Th clearZoneSet
Qꢁr
This command clears the zone set contained in the work area,
removing all zones, and takes effect immediately.
9rpꢁvv
Qhꢁhrrꢁ
This command does not change the zone set name.
This command has no parameters.
8hqꢀ@hyr
Root> config zoning clearZoneSet
2-46
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
FRQILJꢁ]RQLQJꢁDGG=RQH
Th addZone “zoneName”
Qꢁr
This command adds a new (empty) zone to the zone set in the work
area.
9rpꢁvv
Changes are not activated on the switch until the
config.zoning.activateZoneSet command is issued. The CLI supports
the number of zones per zone set specified for a given product.
Qhꢁhrrꢁ
This command has one parameter.
zoneName
Specifies the name of the new zone. The
zoneName must contain 1–64 characters. Valid
characters are:
ABCDEFGHIJKLMNOPQRSTUVWXYZabcdef
ghijklmnopqrstuvwxyz0123456789$-^_
Spaces are not permitted, and the first character
must be alphabetical.
8hqꢀ@hyr
Root> config zoning addZone TheUltimateZone
FRQILJꢁ]RQLQJꢁGHOHWH=RQH
Th deleteZone “zoneName”
Qꢁr
This command deletes a zone from the zone set in the work area.
9rpꢁvv
Changes are not activated on the switch until the
config.zoning.activeZoneSet command is issued.
Qhꢁhrrꢁ
This command has one parameter.
zoneName
Specifies the name of the zone to be deleted.
8hqꢀ@hyr
Root> config zoning deleteZone TheLeastUltimateZone
2-47
config
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
FRQILJꢁ]RQLQJꢁUHQDPH=RQH6HW
Th renameZoneSet “zoneSetName”
Qꢁr
This command changes the name of the zone set in the work area.
9rpꢁvv
Changes are not activated on the switch until the
config.zoning.activateZoneSet command is issued.
Qhꢁhrrꢁ
This command has one parameter.
zoneSetName
Specifies the new name for the zone set. The
zoneSetName must contain 1–64 characters.
Valid characters are:
ABCDEFGHIJKLMNOPQRSTUVWXYZabcdef
ghijklmnopqrstuvwxyz0123456789$-^_
Spaces are not permitted, and the first character
must be alphabetical.
8hqꢀ@hyr
Root> config zoning renameZoneSet TheUltimateZoneSet
FRQILJꢁ]RQLQJꢁDGG:ZQ0HP
Th addWwnMem “zoneName” wwn
Qꢁr
9rpꢁvv
Qhꢁhrrꢁ
This command adds a WWN zone member to the specified zone in
the work area.
The CLI supports the number of zones members per zone specified
for a given product.
This command has two parameters.
zoneName
wwn
Specifies the name of the zone.
The WWN of the member to be added to the
zone. The value of the WWN must be in
colon-delimited hexadecimal notation (for
example, AA:00:AA:00:AA:00:AA:00).
8hqꢀ@hyr
Root> config zoning addWwnMem TheUltimateZone
10:00:00:00:C9:22:9B:64
2-48
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
FRQILJꢁ]RQLQJꢁDGG3RUW0HP
Th addPortMem “zoneName” domainId portNumber
Qꢁr
This command adds the domain ID and port number of a zone
member to the specified zone in the work area.
Port numbers cannot be used for zone members if the interoperability mode
for the switch or director is set to Open Fabric 1.0 mode.
9rpꢁvv
Qhꢁhrrꢁ
The CLI supports the number of zones members per zone specified
for a given product.
This command has one parameter.
zoneName
domainId
Specifies the name of the zone.
Specifies the domain ID of the member to be
added to the zone. Valid values are in the range
1–31.
portNumber
Specifies the port number of the member to be
added to the zone. Valid port number values are:
0–15 for the Sphereon 3016 and 3216
0–23 for the Sphereon 4500
0–31 for the Sphereon 3032 and 3232
0–31 for the ED-5000
0–63 for the Intrepid 6064
0–127 and 132–144 for the Intrepid 6140
8hqꢀ@hyr
Root> config zoning addPortMem TheUltimateZone 10 6
2-49
config
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
FRQILJꢁ]RQLQJꢁFOHDU=RQH
Th clearZone “zoneName”
Qꢁr
This command clears all zone members for the specified zone in the
work area.
9rpꢁvv
Qhꢁhrrꢁ
This command does not change the zone name.
This command has one parameter.
zoneName
Specifies the name of the zone to be cleared.
8hqꢀ@hyr
Root> config zoning clearZone TheNotUltimateAtAllZone
FRQILJꢁ]RQLQJꢁGHOHWH:ZQ0HP
Th deleteWwnMem “zoneName” wwn
Qꢁr
This command removes a WWN member from a zone that is in the
work area.
Qhꢁhrrꢁ
This command has two parameters.
zoneName
wwn
Specifies the name of the zone that contains the
member to be deleted.
Specifies the WWN of the member to be deleted
from the zone. The value of the WWN must be
in colon-delimited hexadecimal notation (for
example, AA:00:AA:00:AA:00:AA:00).
8hqꢀ@hyr
Root> config zoning deleteWwnMem TheNotSoUltimateZone
10:00:00:00:C9:22:9B:AB
2-50
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
FRQILJꢁ]RQLQJꢁGHOHWH3RUW0HP
Th deletePortMem “zoneName” domainId portNumber
Qꢁr
This command deletes a domain ID and port number for a zone
member in the specified zone in the work area.
Qhꢁhrrꢁ
This command has three parameters.
zoneName
domainId
Specifies the name of the zone that contains the
member to be deleted.
Specifies the domain ID of the member that to
be deleted from the zone. Valid domain IDs are
in the range 1–31.
portNumber
Specifies the port number of the member to be
deleted from the zone. Valid port numbers
values are:
0–15 for the Sphereon 3016 and 3216
0–23 for the Sphereon 4500
0–31 for the Sphereon 3032 and 3232
0–31 for the ED-5000
0–63 for the Intrepid 6064
0–127 and 132–144 for the Intrepid 6140
8hqꢀ@hyr
Root> config zoning deletePortMem TheUltimateZone 10 5
2-51
config
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
FRQILJꢁ]RQLQJꢁUHQDPH=RQH
Th renameZone “oldZoneName” “newZoneName”
Qꢁr
This command renames a zone in the work area.
This command has two parameters.
Qhꢁhrrꢁ
oldZoneName
newZoneName
Specifies the current zone name of the zone to
be renamed.
Specifies the new zone name. The
newZoneName must contain 1–64 characters.
Valid characters are:
ABCDEFGHIJKLMNOPQRSTUVWXYZabcdef
ghijklmnopqrstuvwxyz0123456789$-^_
Spaces are not permitted, and the first character
must be alphabetical.
8hqꢀ@hyr
Root> config zoning renameZone TheOldUltimateZone
TheUltimateZone
2-52
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
FRQILJꢁ]RQLQJꢁVKRZ3HQGLQJ
Th showPending
Qꢁr
This command shows the zoning configuration in the work area of
the zone set that has not yet been activated.
Qhꢁhrrꢁ
8hqꢀ@hyr
P
This command has no parameters.
Root> config zoning showPending
The zoning configuration data is displayed as a table that includes
the following properties.
Local ZoneSet
The enabled status, name, and member zones of
the zone set.
Pꢀ@hyr
The output from the config.zoning.showPending command displays
as follows.
Pending Zone Set
Default Zone Enabled: False
ZoneSet: TheNewUltimateZoneSet
Zone: TheNewUltimateZone
ZoneMember: Domain 10, Port 6
ZoneMember: Domain 15, Port 2
Zone: TheNewNotSoUltimateZone
ZoneMember: 10:00:00:00:C9:22:9B:AB
ZoneMember: 10:00:00:00:C9:22:9B:C6
ZoneMember: 10:00:00:00:C9:22:9B:AB
Zone: TheNewNotUltimateAtAllZone
ZoneMember: Domain 2, Port 63
2-53
config
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
FRQILJꢁ]RQLQJꢁVKRZ$FWLYH
Th showActive
Qꢁr
Qhꢁhrrꢁ
This command shows the zoning configuration saved on the fabric.
This command has no parameters.
8hqꢀ@hyr
P
Root> config zoning showActive
The zoning configuration data is displayed as a table that includes
the following properties.
Active ZoneSet
The enabled status, name, and member zones of
the zone set.
Pꢀ@hyr
The output from the config.zoning.showActive command displays as
follows.
Active Zone Set
Default Zone Enabled: False
ZoneSet: TheUltimateZoneSet
Zone: TheUltimateZone
ZoneMember: Domain 10, Port 6
ZoneMember: Domain 15, Port 2
ZoneMember: Domain 2, Port 63
ZoneMember: 10:00:00:00:C9:22:9B:64
ZoneMember: 10:00:00:00:C9:22:9B:BD
Zone: TheNotSoUltimateZone
ZoneMember: 10:00:00:00:C9:22:9B:AB
ZoneMember: 10:00:00:00:C9:22:9B:C6
ZoneMember: 10:00:00:00:C9:22:9B:AB
Zone: TheNotUltimateAtAllZone
ZoneMember: Domain 2, Port 63
2-54
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
hv
The maint branch of the CLI command tree contains commands that
relate to maintenance activities.
The commands in the maint branch can be used only by the
administrator.
Note that the maint.system.resetConfig command resets all
configuration data and non-volatile settings, including network
information, to their default values (factory settings). Management
access may be lost until the network information is restored.
PDLQWꢁSRUWꢁEHDFRQ
Th beacon portNumber beaconState
Qꢁr
This command enables or disables port beaconing for a port.
This command has two required parameters.
Qhꢁhrrꢁ
portNumber
beaconState
Specifies the port number. Valid values are:
0–15 for the Sphereon 3016 and 3216
0–23 for the Sphereon 4500
0–31 for the Sphereon 3032 and 3232
0–63 for the Intrepid 6064
0–127 and 132–144 for the Intrepid 6140
Specifies whether unit beaconing is enabled.
Valid values are true and false. Boolean 1 and 0
may be substituted as values.
8hqꢀ@hyr
Root> maint port beacon 4 false
Root> maint port beacon 4 0
2-55
maint
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
PDLQWꢁSRUWꢁUHVHW
Th reset portNumber
Qꢁr
This command resets a port.
9rpꢁvv
This command resets an individual port without affecting any other
ports. However, if a device is attached to the port and the device is
online, the reset causes a link reset to occur. If the port is in a failed
state (that is, after failing a loopback test), the reset restores the port to
an operational state. The reset also clears all statistics counters and
disables port beaconing for the specified port.
Qhꢁhrrꢁ
This command has one parameter.
portNumber
Specifies the port number to be reset. Valid
values are:
0–15 for the Sphereon 3016 and 3216
0–23 for the Sphereon 4500
0–31 for the Sphereon 3032 and 3232
0–63 for the Intrepid 6064
0–127 and 132–144 for the Intrepid 6140
8hqꢀ@hyr
Root> maint port reset 4
PDLQWꢁV\VWHPꢁEHDFRQ
Th beacon beaconState
Qꢁr
This command enables or disables unit beaconing.
This command has one parameter.
Qhꢁhrrꢁ
beaconState
Specifies whether unit beaconing is enabled.
Valid values are true and false. Boolean 1 and 0
may be substituted as values.
8hqꢀ@hyr
Root> maint system beacon false
Root> maint system beacon 0
2-56
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
PDLQWꢁV\VWHPꢁFOHDU6\V(UURU
Th clearSysError
Qꢁr
Qhꢁhrrꢁ
This command clears the system error light.
This command has no parameters.
8hqꢀ@hyr
Root> maint system clearSysError
PDLQWꢁV\VWHPꢁLSO
Th ipl
Qꢁr
This command IPLs the switch.
9rpꢁvv
Connection to the CLI is lost when this command runs.
Qhꢁhrrꢁ
This command has no parameters.
8hqꢀ@hyr
Root> maint system ipl
2-57
maint
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
PDLQWꢁV\VWHPꢁUHVHW&RQILJ
Th resetConfig
Qꢁr
This command resets all NV-RAM configuration parameters to their
default values, including feature keys and IP addresses.
9rpꢁvv
This command IPLs the switch. Connection from the CLI to the
switch is lost when this command runs.
This command resets all configuration data and non-volatile settings,
including network information, to their default values (factory settings).
Management access may be lost until the network information is restored.
The default values are set in the firmware of the director or switch.
For information about the default values, refer to the service manual
for your director or switch.
Qhꢁhrrꢁ
This command has no parameters.
8hqꢀ@hyr
Root> maint system resetConfig
PDLQWꢁV\VWHPꢁVHW2QOLQH6WDWH
Th setOnlineState onlineState
Qꢁr
This command sets the switch online or offline.
This command has one parameter.
Qhꢁhrrꢁ
onlineState
Specifies whether the switch is online. Valid
values are true and false. Boolean 1 and 0 may be
substituted as values.
8hqꢀ@hyr
Root> maint system setOnlineState true
Root> maint system setOnlineState 1
2-58
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
rꢁs
The perf branch of the CLI command tree contains commands that
relate to performance services.
The commands in the perf branch can by used by either the
administrator or the operator.
Note that the counters in perf command output are 32-bit values that
wrap at 4,294,967,296. To calculate the full value of a counter,
multiply 4,294,967,296 by the value in the wrap field, and add the
resulting product to the value in the count field. For example, if a
TxFrames statistic has a count value of 1842953 and a wrap value of
12, the full value of the counter is:
(4,294,967,296 x 12) + 1842953 = 51,541,450,505.
SHUIꢁFODVVꢂ
Th class2 portNumber
Qꢁr
This command displays port Class 2 counters for a single port.
This command has one parameter.
Qhꢁhrrꢁ
portNumber
Specifies the port number. Valid values are:
0–15 for the Sphereon 3016 and 3216
0–23 for the Sphereon 4500
0–31 for the Sphereon 3032 and 3232
0–63 for the Intrepid 6064
0–127 and 132–144 for the Intrepid 6140
8hqꢀ@hyr
P
Root> perf class2 2
The port Class 2 counter data is displayed as a table that includes the
following statistics, along with a wrap count for each corresponding
counter.
Port
The port number.
RxFrames
The number of Fibre Channel Class 2 frames
that the port has received.
2-59
perf
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
TxFrames
RxWords
The number of Fibre Channel Class 2 frames
that the port has transmitted.
The number of Class 2 4-byte words within
frames that the port has received.
TxWords
The number of Class 2 4-byte words within
frames that the port has transmitted.
Busied Frms
The number of times that FBSY (Fabric Busy
link response) was returned to this port as a
result of a Class 2 frame that could not be
delivered to the other end of the link. This
occurs if either the fabric or the destination port
is temporarily busy.
Rjct Frames
The number of times that FRJT (Frame Reject
link response) was returned to this port as the
result of a Class 2 frame that was rejected by the
fabric.
Pꢀ@hyr
The output from the perf.class2 command displays as follows.
Port 2 Statistic Wrap
Count
-----------
RxFrames
---------- ----------
23
12
65
32
0
2953184
1842953
2953184
1842953
2953184
1842953
TxFrames
RxWords
TxWords
Busied Frms
Rjct Frames
0
SHUIꢁFODVVꢃ
Th class3 portNumber
This command displays port Class 3 counters for a single port.
Qꢁr
2-60
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
Qhꢁhrrꢁ
This command has one parameter.
portNumber
Specifies the port number. Valid values are:
0–15 for the Sphereon 3016 and 3216
0–23 for the Sphereon 4500
0–31 for the Sphereon 3032 and 3232
0–63 for the Intrepid 6064
0–127 and 132–144 for the Intrepid 6140
8hqꢀ@hyr
P
Root> perf class3 2
The port Class 3 counter data is displayed as a table that includes the
following statistics, along with a wrap count for each corresponding
counter.
Port
The port number.
RxFrames
The number of Fibre Channel Class 3 frames
that the port has received.
TxFrames
RxWords
The number of Fibre Channel Class 3 frames
that the port has transmitted.
The number of Class 3 4-byte words within
frames that the port has received.
TxWords
The number of Class 3 4-byte words within
frames that the port has transmitted.
Disc Frames
The number of Class 3 frames that have been
discarded upon receipt by this port. There are
no FBSYs (Fabric Busy link response) or FRJTs
(Frame Reject link response) generated for Class
3 frames.
Pꢀ@hyr
The output from the perf.class3 command displays as follows.
Port 2
Statistic
----------- ----------
Wrap
Count
----------
2953184
1842953
2953184
1842953
2953184
RxFrames
TxFrames
RxWords
TxWords
3
2
65
32
Disc Frames 26
2-61
perf
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
SHUIꢁFOHDU6WDWV
Th clearStats portNumber
This command resets all port statistics for an individual port or for all
Qꢁr
ports.
Qhꢁhrrꢁ
This command has one parameter.
portNumber
Specifies the port number. Valid values are:
0–15 for the Sphereon 3016 and 3216
0–23 for the Sphereon 4500
0–31 for the Sphereon 3032 and 3232
0–63 for the Intrepid 6064
0–127 and 132–144 for the Intrepid 6140
all for every port on the director or switch
8hqꢀ@hyr
Root> perf clearStats 4
Root> perf clearStats all
SHUIꢁHUURUV
Th errors portNumber
Qꢁr
This command displays port error counters for a single port.
This command has one parameter.
Qhꢁhrrꢁ
portNumber
Specifies the port number. Valid values are:
0–15 for the Sphereon 3016 and 3216
0–23 for the Sphereon 4500
0–31 for the Sphereon 3032 and 3232
0–63 for the Intrepid 6064
0–127 and 132–144 for the Intrepid 6140
8hqꢀ@hyr
Root> perf errors 2
2-62
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
P
The port error counter data is displayed as a table that includes the
following statistics.
Port
The port number.
Prim Seq Err
The number of state machine protocol errors
detected by the port hardware.
Disc Frms
The number of received frames discarded due
to a frame size of less than size words or to
frames dropped because the BB credit was zero.
This number is counted during the first round
of frame verification and applies to both Class 2
and Class 3 traffic.
Inv Tx Wrds
The number of 10-bit transmission words that
the port is unable to map to 8-bit bytes because
of disparity errors or misaligned K characters
while in the OL2 or OL3 state.
CRC Errs
The number of frame CRC errors detected by
the port.
Delim Errs
Addr Id Errs
The number of invalid frame delimiters (SOF or
EOF) received by the port.
The number of frames received with unknown
addressing.
Pꢀ@hyr
The output from the perf.errors command displays as follows.
Port 2
Statistic
Count
----------- ----------
Prim Seq Err 753452
Disc Frms
Inv Tx Wrds 2953184
CRC Errs 1842953
351269
Delim Errs 2953184
Addr Id Errs 1842953
2-63
perf
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
SHUIꢁOLQN
Th link portNumber
Qꢁr
This command displays port link counters for a single port.
This command has one parameter.
Qhꢁhrrꢁ
portNumber
Specifies the port number. Valid values are:
0–15 for the Sphereon 3016 and 3216
0–23 for the Sphereon 4500
0–31 for the Sphereon 3032 and 3232
0–63 for the Intrepid 6064
0–127 and 132–144 for the Intrepid 6140
8hqꢀ@hyr
P
Root> perf link 2
The port link counter data is displayed as a table that includes the
following statistics.
Port
The port number.
OLS In
The number of offline sequences initiated by the
attached N_Port.
OLS Out
Reset In
Reset Out
LIPS In
The number of offline sequences initiated by
this director or switch port.
The number of link resets initiated by the
attached N_Port.
The number of link resets initiated by this
director or switch.
The number of Loop Initialization Primitives
(LIPS) detected on this switch loop port.
LIPS Out
Link Flrs
The number of LIPS generated on this switch
loop port.
The number of times the port has detected a
link error resulting from an invalid link state
transition or timeout.
2-64
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
Sync Losses
Sig Losses
The number of times the port has detected a
loss of synchronization timeout while not in an
offline or LF2 state.
The number of times the port has detected a
loss of signal while not in an offline or LF2 state.
Pꢀ@hyr
The output from the perf.link command displays as follows.
Port 2
Statistic
Count
----------- ----------
OLS In
OLS Out
Reset In
Reset Out
Link Flrs
753452
351269
2953184
1842953
2953184
Sync Losses 1842953
Sig Losses 35246
SHUIꢁWUDIILF
Th traffic portNumber
Qꢁr
This command displays port traffic counters for a single port.
This command has one parameter.
Qhꢁhrrꢁ
portNumber
Specifies the port number. Valid values are:
0–15 for the Sphereon 3016 and 3216
0–23 for the Sphereon 4500
0–31 for the Sphereon 3032 and 3232
0–63 for the Intrepid 6064
0–127 and 132–144 for the Intrepid 6140
8hqꢀ@hyr
Root> perf traffic 2
2-65
perf
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
P
The port traffic counter data is displayed as a table that includes the
following statistics, along with a wrap count for each corresponding
counter.
Port
The port number.
Rx%
The received link utilization percentage.
The transmitted link utilization percentage.
Tx%
RxFrames
The number of Fibre Channel Class 2 and Class
3 frames that the port has received.
TxFrames
RxWords
TxWords
The number of Fibre Channel Class 2 and Class
3 frames that the port has transmitted.
The number of 4-byte words in Class 2 and
Class 3 frames that the port has received.
The number of 4-byte words in Class 2 and
Class 3 frames that the port has transmitted.
Pꢀ@hyr
The output from the perf.traffic command displays as follows.
Port 2
Wrap
Count
Statistic
----------- ----------
----------
75
Rx%
Tx%
RxFrames
TxFrames
RxWords
TxWords
N/A
N/A
23
30
2953184
1842953
2953184
1842953
12
65
32
2-66
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
u
The show branch of the CLI command tree contains commands that
display, but do not change, stored data values. The displayed output
that results from these commands is not necessarily identical with the
output from the show commands that are within the other CLI
command tree branches, for example, config.port.show.
The commands in the show branch can by used by either the
administrator or the operator.
VKRZꢁHYHQW/RJ
Th eventLog
Qꢁr
This command shows the contents of the event log as maintained in
NV-RAM on the director or switch.
Qhꢁhrrꢁ
8hqꢀ@hyr
P
This command has no parameters.
Root> show eventLog
The event log data are displayed as a table that includes the following
properties.
Date/Time
Code
The date and time when the event occurred.
The event reason code.
Severity
The severity of the event. The values are:
Major—Unit operational (major failure).
Minor—Unit operational (minor failure).
Severe—Unit not operational. The causes are
either that the switch contains no operational
SBAR cards or that the system shuts down due
to CTP thermal threshold violations.
Info—Unit operational (information only).
FRU
The FRU and FRU position, where applicable.
Event Data
The 32-byte hexadecimal description of the
event in words.
2-67
show
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
Pꢀ@hyr
The output from the show.eventLog command displays as follows.
Date/Time
Code Severity FRU
Event Data
---------------- ---- -------- ----- -----------------------------------
04/12/01 10:58A 375
04/12/01
04/11/01
Major
CTP-0 00010203 04050607 08090A0B 0C0D0E0F
CTP-0 00010203 04050607 08090A0B 0C0D0E0F
CTP-0 00010203 04050607 08090A0B 0C0D0E0F
9:58A 385
7:18P 395
Severe
Severe
VKRZꢁIHDWXUHV
Th features
Qꢁr
This command displays a table of all installed feature sets and their
states. The output is exactly the same as the output to
config.features.show.
Qhꢁhrrꢁ
This command has no parameters.
8hqꢀ@hyr
P
Root> show features
The features data is displayed as a table that includes the following
properties.
Installed Feature The feature set installed using a feature key.
Set
Only installed keys are displayed.
Feature
Individual features within each set. In many
cases, there is only one feature within each
feature set.
State
The state of the individual feature. Fabric-wide
features are displayed as Active/Inactive.
Switch-centric features are displayed as
Enabled/Disabled.
Pꢀ@hyr
The output from the show.features command displays as follows.
Installed Feature Set
------------------------------
Open Systems Management Server
Flex Ports
Feature
State
-----------------
OSMS
----
Enabled
Enabled
Active
Enabled
8 Flex Ports
Fabric Binding
Switch Binding
SANtegrity
SANtegrity
SANtegrity
Enterprise Fabrics Active
2-68
McDATA OPENconnectors Command Line Interface USER MANUAL
Download from Www.Somanuals.com. All Manuals Search And Download.
P/N 620-000134-300
2
VKRZꢁIUXV
Th frus
Qꢁr
This command displays information about all FRUs.
Qhꢁhrrꢁ
This command has no parameters.
8hqꢀ@hyr
P
Root> show frus
The FRU information is displayed as a table that includes the
following properties.
FRU
The FRU name.
• If a FRU is not installed on a Sphereon 3016,
3216, 3032, 3232, or an Intrepid 6064, the
output in this column is NotInstalled.
• If a FRU is not installed on a Sphereon 4500
or an Intrepid 6140, the output in this column
is the name of the missing FRU or Unknown.
Position
State
The relative position of the FRU, that is, its slot.
The state of the FRU. Values are:
Active—the current module is active.
Backup—this module is not currently being
used, but it is available for immediate failover.
NotInst—the module is not currently installed.
Failed—the current module is failed.
Serial Num
The serial number of the FRU. (This field is
blank for power supply modules of the
Sphereon 4500.)
Part Num
Beacon
The part number of the FRU.
The beaconing state of the FRU (On or Off).
The power-on hours value for the FRU.
Pwr On Hrs
2-69
show
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
Pꢀ@hyr
The output from the show.frus command displays as follows.
FRU
Position State
Serial Num
Part Num
Beacon
Pwr On Hrs
----- -------- ------ -------------- --------- --------- ----------
CTP
CTP
SBAR
SBAR
FPM
FPM
UPM
0
1
0
1
1
3
4
Active 470-000399-700 123456789 Off
Backup 470-000399-700 223456789 On
Active 470-000399-700 223456789 Off
Failed 470-000399-700 223456789 Off
Active 470-000399-700 223456789 Off
Active 470-000399-700 223456789 Off
Active 470-000399-700 223456789 Off
Active 470-000399-700 223456789 Off
Active 470-000399-700 223456789 Off
2800
2801
2801
2801
2801
831
831
Power 0
Fan
831
831
0
VKRZꢁLSꢁHWKHUQHW
Th ethernet
Qꢁr
This command displays ethernet attributes.
This command has no parameters.
Root> show ip ethernet
Qhꢁhrrꢁ
8hqꢀ@hyr
P
The Ethernet attributes data is displayed as a table that includes the
following properties.
IP Address
The IP address for the Ethernet adapter as set in
the config.ip.ethernet command.
Gateway
Address
The gateway address for the Ethernet adapter
as set in the config.ip.ethernet command.
Subnet Mask
The subnet mask for the Ethernet adapter as set
in the config.ip.ethernet command.
Pꢀ@hyr
The output from the show.ip.ethernet command displays as follows.
LAN Information
IP Address:
Gateway Address: 144.49.10.1
Subnet Mask: 255.255.255.0
144.49.10.15
2-70
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
VKRZꢁORJLQ6HUYHU
Th loginServer
Qꢁr
This command displays information from the login server database
for devices attached to this switch. Note that it is possible to have
more than one device per port for any public loop devices attached to
an FL Port.
Qhꢁhrrꢁ
8hqꢀ@hyr
P
This command has no parameters.
Root> show loginServer
The device information is displayed as a table that includes the
following properties.
Port
The port number where the device is attached.
BB Crdt
The maximum number of remaining frames
that can be transmitted without causing a buffer
overrun condition at the receiver.
RxFldSz
COS
The buffer-to-buffer receive data field size from
the FLOGI received from the attached N_Port.
The class of service (for example, 1; 2; 3; 4; 5; 6;
F; 1,2; 2,3).
Port Name
The port WWN of the attached device.
The node WWN of the attached device.
Node Name
Pꢀ@hyr
The output from the show.loginServer command displays as follows.
Port BB Crdt RxFldSz COS Port Name
Node Name
---- ------- ------- --- ----------------------- -----------------------
0
10
10
10
10
10
10
10
10
10
10
2,3 00:11:22:33:44:55:00:77 20:11:22:33:44:55:66:77
1
2
00:11:22:33:44:55:00:78 20:11:22:33:44:55:66:78
4
2,3 00:11:22:33:44:55:00:79 20:11:22:33:44:55:66:79
2,3 00:11:22:33:44:55:00:80 20:11:22:33:44:55:66:80
7
8
10
11
12
13
15
2
00:11:22:33:44:55:00:81 20:11:22:33:44:55:66:81
2,3 00:11:22:33:44:55:00:82 20:11:22:33:44:55:66:82
2,3 00:11:22:33:44:55:00:83 20:11:22:33:44:55:66:83
3
00:11:22:33:44:55:00:84 20:11:22:33:44:55:66:84
2,3 00:11:22:33:44:55:00:85 20:11:22:33:44:55:66:85
2,3 00:11:22:33:44:55:00:86 20:11:22:33:44:55:66:86
2-71
show
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
VKRZꢁQDPH6HUYHU
Th nameServer
Qꢁr
This command displays information from the name server database
for devices attached to this switch. Note that it is possible to have
more than one device per port for any public loop devices attached to
an FL Port.
Qhꢁhrrꢁ
This command has no parameters.
8hqꢀ@hyr
P
Root> show nameServer
The device information data is displayed as a table that includes the
following properties.
Type
The type (N, NL, F/NL, F, FL, E, B).
The 24-bit Fibre Channel address.
The port WWN of the attached device.
The node WWN of the attached device.
Port Id
Port Name
Node Name
COS
The class of service (for example, 1; 2; 3; 4; 5; 6;
F; 1,2; 2,3).
FC4 Types
The FC4 types registered for this device. One or
more numbers display in this field. The
numbers in this field correspond to the list at
the bottom of the output example below.
2-72
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
Pꢀ@hyr
The output from the show.nameServer command displays as follows.
Type Port Id Port Name
Node Name
COS FC4 Types
---- ------- ----------------------- ----------------------- --- ---------
N
N
N
N
N
N
N
N
N
N
N
N
010400
010500
010600
010700
010800
010900
010C00
010D00
010E00
010F00
011200
011300
00:11:22:33:44:55:66:77 20:11:22:33:44:55:66:77 2,3 2
00:11:22:33:44:55:66:78 20:11:22:33:44:55:66:78 2,3 0
00:11:22:33:44:55:66:79 20:11:22:33:44:55:66:79 2,3 2
00:11:22:33:44:55:66:80 20:11:22:33:44:55:66:80 2
00:11:22:33:44:55:66:81 20:11:22:33:44:55:66:81 3
00:11:22:33:44:55:66:82 20:11:22:33:44:55:66:82 3
2
2
2
00:11:22:33:44:55:66:83 20:11:22:33:44:55:66:83 2,3 2
00:11:22:33:44:55:66:84 20:11:22:33:44:55:66:84 2,3 2
00:11:22:33:44:55:66:85 20:11:22:33:44:55:66:85 2
00:11:22:33:44:55:66:86 20:11:22:33:44:55:66:86 2
5
4
00:11:22:33:44:55:66:87 20:11:22:33:44:55:66:87 2,3 2
00:11:22:33:44:55:66:88 10:11:22:33:44:55:66:88 2,3 2
FC4 Types
0: ISO/IEC 8802-2 LLC
1: ISO/IEC 8802-2 LLC/SNAP
2: SCSI-FCP
3: SCSI-GPP
4: IPI-3 Master
5: IPI-3 Slave
6: IPI-3 Peer
7: CP IPI-3 Master
8: CP IPI-3 Slave
9: CP IPI-3 Peer
10: SBCCS-Channel
11: SBCCS-Control Unit
12: FC-SB-2 Channel to Control Unit
13: FC-SB-2 Control Unit to Channel
14: Fibre Channel Service
15: FC-FG
16: FC-SW
17: FC-AL
18: SNMP
19: HIPPI-FP
20: Vendor Unique
VKRZꢁQDPH6HUYHU([W
Th nameServerExt
Qꢁr
This command displays extended information from the name server
database for devices attached to this switch. The command provides
Symbolic Nameserver information, as well as the same information
as the show.nameServer command. Multiple devices per port are
possible for any public loop device attached to an FL Port.
Because it contains symbolic nameserver information that can be lengthy, the
CLI output wraps several times per node. For this reason, this command is
supported only in comma-delimited mode.
Qhꢁhrrꢁ
This command has no parameters.
8hqꢀ@hyr
Root> show nameServerExt
2-73
show
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
P
The device information data is displayed as a table that includes the
following properties.
Type
The type (N, NL, F/NL, F, FL, E, B).
The 24-bit Fibre Channel address.
The port WWN of the attached device.
The node WWN of the attached device.
Port Id
Port Name
Node Name
COS
F; 1,2; 2,3).
FC4 Types
The FC4 types registered for this device. One or
more numbers display in this field. The
numbers in this field correspond to the list in
the output example for show.nameServer on
page 2-72.
SymNodeName
SymPortName
255-character representation of the Symbolic
Node Name.
255-character representation of the Symbolic
Port Name.
Pꢀ@hyr
The output from the show.nameServerExt command displays as
follows.
Type, Port Id, Port Name, Node Name, COS, FC4 Types,
SymNodeName, SymPortName,
N, 010400, 00:11:22:33:44:55:00:77,
20:11:22:33:44:55:66:77, 2-3, 2, Node Name A, Port
Name A,
N, 010500, 00:11:22:33:44:55:01:77,
20:11:22:33:44:55:66:77, 2-3, 0, This Is Symbolic Node
Name B, Symbolic Port Name B Is Slightly Longer
N, 010600, 00:11:22:33:44:55:66:02,
20:11:22:33:44:55:66:77, 2-3, 2, , ,
FL, 000001, 00:11:22:33:44:55:66:03,
20:11:22:33:44:55:66:77, 2, 0, Loop Node 1, Loop Port
7
FL, 000002, 00:11:22:33:44:55:66:04
20:11:22:33:44:55:66:77, 3, 2, Loop Node 2, Loop Port
7,
2-74
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
VKRZꢁSRUWꢁFRQILJ
Th config
Qꢁr
Qhꢁhrrꢁ
This command shows the port configuration for all ports.
This command has no parameters.
8hqꢀ@hyr
P
Root> show port config
The port configuration attributes are displayed as a table that
includes the following properties.
Port
The port number.
Name
The name of the port as set in the
config.port.name command.
Blocked
Ext Dist
The blocked state of the port as set in the
config.port.blocked command.
The extended distance state as set in the
config.port.extDist command. (This does not
apply to the Sphereon 4500.)
FAN
The configured fabric address notification
(FAN) state. (Sphereon 4500 only.)
Type
Speed
The port type as set in the config.port.type
command.
The port speed as set in the config.port.speed
command.
Pꢀ@hyr
The output from the show.port.config command displays as follows.
Port Name
Blocked Ext Dist Type
Speed
---- ------------------------ ------- -------- ----- ---------
0
Port 1
Port 2
Port 3
Port 4
Port 5
Port 6
Port 7
Port 8
Port 9
Port A
Port B
Port C
Port D
Port E
Port F
Port X
false
true
Off
On
fPort 1 Gb/sec
fPort 1 Gb/sec
gPort 1 Gb/sec
fPort 2 Gb/sec
fPort 2 Gb/sec
fPort 2 Gb/sec
fPort 1 Gb/sec
fPort Negotiate
fPort 1 Gb/sec
fPort 1 Gb/sec
fPort 2 Gb/sec
fPort 2 Gb/sec
fPort 1 Gb/sec
fPort 1 Gb/sec
fPort 1 Gb/sec
fPort 1 Gb/sec
1
2
false
false
true
Off
Off
On
3
4
5
false
true
Off
On
6
7
false
false
false
false
false
false
false
false
false
Off
On
8
9
Off
Off
Off
Off
Off
Off
Off
10
11
12
13
14
15
2-75
show
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
VKRZꢁSRUWꢁLQIR
Th info
Qꢁr
This command displays port information for all ports.
This command has no parameters.
Root> show port info
Qhꢁhrrꢁ
8hqꢀ@hyr
P
The port information data is displayed as a table that includes the
following properties.
Port
The port number.
WWN
OpSpeed
The WWN of the port.
The current operating speed (1 Gb/sec,
2 Gb/sec, or Not Established).
SpeedCap
The current transceiver capability speed
(1 Gb/sec or 2 Gb/sec).
Pꢀ@hyr
The output from the show.port.info command displays as follows.
Port WWN OpSpeed SpeedCap
---- ----------------------- -------- --------
0
10:00:80:00:11:22:33:44 1 Gb/sec 2 Gb/sec
10:00:80:01:11:22:33:44 1 Gb/sec 2 Gb/sec
10:00:80:02:11:22:33:44 1 Gb/sec 2 Gb/sec
10:00:80:03:11:22:33:44 1 Gb/sec 2 Gb/sec
10:00:80:04:11:22:33:44 2 Gb/sec 2 Gb/sec
10:00:80:05:11:22:33:44 2 Gb/sec 2 Gb/sec
10:00:80:06:11:22:33:44 2 Gb/sec 2 Gb/sec
10:00:80:07:11:22:33:44 2 Gb/sec 2 Gb/sec
10:00:80:08:11:22:33:44 2 Gb/sec 2 Gb/sec
10:00:80:09:11:22:33:44 2 Gb/sec 2 Gb/sec
10:00:80:10:11:22:33:44 1 Gb/sec 2 Gb/sec
10:00:80:11:11:22:33:44 1 Gb/sec 2 Gb/sec
10:00:80:12:11:22:33:44 1 Gb/sec 2 Gb/sec
10:00:80:13:11:22:33:44 1 Gb/sec 2 Gb/sec
10:00:80:14:11:22:33:44 1 Gb/sec 2 Gb/sec
10:00:80:15:11:22:33:44 1 Gb/sec 2 Gb/sec
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
2-76
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
VKRZꢁSRUWꢁQRGHV
Th nodes portNumber
Qꢁr
This command displays the loop node list for a specified port. This
command is valid only on the Sphereon 4500.
Qhꢁhrrꢁ
This command has one parameter.
portNumber
Specifies the port number. Valid values are:
0–23 for the Sphereon 4500
8hqꢀ@hyr
P
Root> show port nodes portNumber
The port nodes data is displayed as a table that includes the following
properties.
FC Addr
The Fibre Channel address of nodes attached to
this port. Private devices are assigned address
strings of 0000 followed by the two-digit
hexadecimal Arbitrated Loop Physical Address
(ALPA), instead of the 6 digit hexadecimal
number presented for public devices.
Attached WWN
The WWN of nodes attached to this port, or the
string NOT LOGGED IN for a private loop
device.
Class
The Class value for public devices. This field is
left blank for private devices.
Data Field Size
The Data Field Size value for public devices.
This field is left blank for private devices.
2-77
show
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
Pꢀ@hyr
The show.port.nodes command output for a mix of public and
private nodes on a loop appears as follows:
FC Addr Attached WWN
Class Data Field Size
------- ----------------------- ----- ---------------
610A01 33:00:00:00:00:00:00:03 1
610A02 33:00:00:00:00:00:00:04 1
610A04 33:00:00:00:00:00:00:05 1
610A08 33:00:00:00:00:00:00:02 1
610A0F 33:00:00:00:00:00:00:0A 1
610A10 33:00:00:00:00:00:00:10 1
000017 NOT LOGGED IN
2112
2112
2112
2112
2112
2112
000018 NOT LOGGED IN
00001B NOT LOGGED IN
If no nodes are on the loop, a message displays saying that no loop
nodes are on the port.
2-78
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
VKRZꢁSRUWꢁVWDWXV
Th status
Qꢁr
Qhꢁhrrꢁ
This command displays port status for all ports.
This command has no parameters.
Root> show port status
8hqꢀ@hyr
P
The port status data is displayed as a table that includes the following
properties.
Port
The port number.
State
The port state (for example, Segmented E_Port,
Invalid Attachment, Not Installed, Online,
Offline, Not Operational, No Light, Testing,
Port Failure, Link Reset, or Inactive).
Type
The operational port type. If the configured port
type is F_Port or E_Port, this value will match
the configured type. If the configured type is
G_Port, this value can be E_Port, F_Port, or
G_Port, depending on what is connected to the
port.
On the Sphereon 4500, if the configured port
type is Fx_Port, the operational port type can
include FL_Port in addition to the values noted
above for F_Port. If the configured port type is
Gx_Port, then the operational port type can
include FL_Port in addition to the values noted
above for G_Port.
Attached WWN
Beaconing
The WWN of the device or switch attached to
the port, if one is attached.
The beaconing state for the port (Off or On).
2-79
show
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
Reason
An optional message number that indicates if
the port has a segmented ISL, if a port binding
violation has occurred, or if the port is inactive.
The message description for this message
number is provided at the bottom of the table.
If the operational state is Segmented E_Port, only
the following messages can be generated:
• 00 Segment Not Defined
• 01 Incompatible Operating Parameters
• 02 Duplicate Domain ID(s)
• 03 Incompatible Zoning Configurations
• 04 Build Fabric Protocol Error
• 05 No Principal Switch
• 06 No Response from Attached Switch
• 07 ELP Retransmission Failure Timeout
If the operational state is Invalid Attachment only
the following messages can be generated:
• 08 None
• 09 Unknown
• 10 ISL connection not allowed on this port
• 11 ELP rejected by the attached switch
• 12 Incompatible switch at other end of the ISL.
• 13 External loopback adapter connected to the
port
• 14 N_Port connection not allowed on this port
• 15 Non-McDATA switch at other end of the ISL.
• 16 ISL connection not allowed on this port
• 17 ISL connection not allowed to external Fabrics
• 18 Port binding violation—unauthorized WWN
• 19 Unresponsive node connected to port
• 20 Incompatible security attributes
• 21 Fabric Binding violation
• 22 Authorization failure
•
23 Switch Binding violation
If the operational state is Inactive only the
following messages can be generated:
• 24 Inactive – RC 0
• 25 No Serial Number
• 26 Feature Not Enabled
2-80
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
Pꢀ@hyr
The output from the show.port.status command displays as follows.
Port State
Type
Attached WWN
Beaconing Reason
---- ----------------
----- ----------------------- --------- ------
fPort 10:00:80:00:11:22:33:44 Off
gPort 10:00:80:00:11:22:33:45 On
fPort 10:00:80:00:11:22:33:55 On
ePort 10:00:80:00:11:22:33:00 Off
gPort 10:00:80:00:11:22:33:57 Off
fPort 10:00:80:00:11:22:33:46 Off
gPort 10:00:80:00:11:22:33:63 Off
0
Online
1
Online
2
No Light
Offline
Online
3
4
5
Port Failure
Link Reset
Segmented E_Port
Online
6
7
ePort 10:00:80:00:11:22:33:47 Off
ePort 10:00:80:00:11:22:33:88 Off
fPort 10:00:80:00:11:22:33:49 Off
ePort 10:00:80:00:11:22:33:50 Off
fPort 10:00:80:00:11:22:33:53 Off
fPort 10:00:80:00:11:22:33:56 Off
fPort 10:00:80:00:11:22:33:59 Off
02
8
9
Offline
10
11
12
13
14
15
Inactive
Online
26
No Light
Online
Invalid Attachment fPort 10:00:80:00:11:22:33:64 Off
15
Online
fPort 10:00:80:00:11:22:33:66 Off
02: Duplicate Domain ID(s)
03: Switch Speed Conflict
07: ISL connection not allowed on this port
2-81
show
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
VKRZꢁSRUWꢁWHFKQRORJ\
Th technology
Qꢁr
Qhꢁhrrꢁ
This command displays port technology information for all ports.
This command has no parameters.
8hqꢀ@hyr
P
Root> show port technology
The port technology data is displayed as a table that includes the
following properties.
Port
The port number.
Connectr
The port connector type (LC, MT_RJ, MU,
Internal).
Transcvr
Distance
Media
The transceiver type (Long LC, Short, Short
OFC, Long LL, Long Dist).
The distances supported (Short, Intermediate,
Long, Very Long).
The media type (M-M 62.5um, M-M 50um,
M-M 50,62.5um, S-M 9um, Copper).
Pꢀ@hyr
The output from the show.port.technology command displays as
follows.
Port Connectr Transcvr Distance
Media
---- -------- --------- ------------ -----------
0
LC
LC
Long LC
Long LC
Long LC
Long LC
Long LC
Long LC
Long LC
Long LC
Long LC
Long LC
Long LC
Long LC
Long LC
Long LC
Long LC
Long LC
Long
Long
Long
Long
Long
Long
Long
Long
Long
Long
Long
Long
Long
Long
Long
Long
M-M 50um
M-M 50um
M-M 50um
M-M 50um
M-M 50um
M-M 50um
M-M 50um
M-M 50um
M-M 50um
M-M 50um
M-M 50um
M-M 50um
M-M 50um
M-M 50um
M-M 50um
M-M 50um
1
2
LC
3
MT_RJ
MT_RJ
MT_RJ
LC
4
5
6
7
LC
8
LC
9
LC
10
11
12
13
14
15
LC
LC
LC
LC
LC
LC
2-82
McDATA OPENconnectors Command Line Interface USER MANUAL
Download from Www.Somanuals.com. All Manuals Search And Download.
P/N 620-000134-300
2
VKRZꢁVHFXULW\ꢁIDEULF%LQGLQJ
Th fabricBinding
Qꢁr
This command displays the fabric binding configuration saved on the
fabric. The command performs the same function as
config.security.fabricBinding.showActive.
Qhꢁhrrꢁ
8hqꢀ@hyr
P
This command has no parameters.
Root> show security fabricBinding
The fabric binding configuration data is displayed as a table that
includes the following properties.
Fabric Binding
State
The active fabric binding state: Inactive or Active
Restricting
Fabric
Membership List
The active fabric membership list.
Pꢀ@hyr
The output from the show.security.fabricBinding command displays
as follows.
Fabric Binding State: Active Restricting
Domain 1 (00:11:22:33:44:55:66:77)
Domain 2 (88:99:AA:BB:CC:DD:EE:FF)
Domain 14 (11:55:35:45:24:78:98:FA)
2-83
show
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
VKRZꢁVHFXULW\ꢁSRUW%LQGLQJ
Th portBinding
Qꢁr
Qhꢁhrrꢁ
This command shows the port binding configuration for all ports.
This command has no parameters.
8hqꢀ@hyr
P
Root> show security portBinding
The port binding configuration data is displayed as a table that
includes the following properties.
Port
The port number.
WWN Binding
The state of port binding for the specified port
(active or inactive).
Bound WWN
The WWN of the device that is bound to the
specified port. If this field is blank, no device is
bound to the specified port.
Pꢀ@hyr
The output from the show.security.portBinding command displays as
follows.
Port
----
0
WWN Binding
-----------
Active
Inactive
Inactive
Active
Inactive
Inactive
Inactive
Inactive
Inactive
Inactive
Inactive
Inactive
Inactive
Inactive
Inactive
Inactive
Bound WWN
-----------------------
AA:00:AA:00:AA:00:AA:00
00:00:00:00:00:00:00:00
CC:33:44:55:CC:33:44:55
00:00:00:00:00:00:00:00
00:00:00:00:00:00:00:00
00:00:00:00:00:00:00:00
00:00:00:00:00:00:00:00
00:00:00:00:00:00:00:00
00:00:00:00:00:00:00:00
00:00:00:00:00:00:00:00
00:00:00:00:00:00:00:00
00:00:00:00:00:00:00:00
00:00:00:00:00:00:00:00
00:00:00:00:00:00:00:00
00:00:00:00:00:00:00:00
00:00:00:00:00:00:00:00
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
2-84
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
VKRZꢁVHFXULW\ꢁVZLWFK%LQGLQJ
Th switchBinding
Qꢁr
Qhꢁhrrꢁ
This command displays the switch binding configuration.
This command has no parameters.
8hqꢀ@hyr
P
Root> show security switchBinding
The switch binding configuration data is displayed as a table that
includes the following properties.
Switch Binding
State
Disabled, Enabled and Restricting F_Ports,
Enabled and Restricting E_Ports, or
Enabled and Restricting All Ports
Switch
Membership List
The active switch membership list.
Pꢀ@hyr
The output from the show.security.switchBinding command displays
as follows.
Switch Binding State: Enabled and Restricting E Ports
00:11:22:33:44:55:66:77
88:99:AA:BB:CC:DD:EE:FF
11:55:35:45:24:78:98:FA
2-85
show
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
VKRZꢁVZLWFK
Th switch
Qꢁr This command displays switch attributes.
Qhꢁhrrꢁ
This command has no parameters.
8hqꢀ@hyr
P
Root> show switch
The switch attributes data is displayed as a table that includes the
following properties.
State
The state of the switch (for example, online or
offline).
BB Credit
The BB credit as set in the
config.switch.bbCredit command. (This does
not apply to the Sphereon 4500.)
R_A_TOV
E_D_TOV
The R_A_TOV as set in the config.switch.raTov
command.
The E_D_TOV as set in the config.switch.edTov
command.
Preferred
Domain Id
The domain ID as set in the
config.switch.domainId command.
Switch Priority
Speed
The switch priority as set in the
config.switch.priority command.
The switch speed as set in the
config.switch.speed command. (This does not
apply to the Sphereon 4500.)
Rerouting Delay The rerouting delay as set in the
config.switch.rerouteDelay command.
Operating Mode The operating mode (Open Systems or S/390).
This attribute cannot be configured through the
CLI.
Interop Mode
The interoperability mode as set in the
config.switch.interopMode command.
2-86
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
Active Domain
Id
The active domain ID of the switch. This ID
may or may not be the same as the preferred
domain ID.
World Wide
Name
The WWN for the switch.
Insistent Domain Configured Insistent domain ID state as set in
Id
the config.switch.insistDomainId command.
Domain RSCN
Configured Domain RSCN state as set in the
config.switch.domainRSCN command.
Pꢀ@hyr
The output from the show.switch command displays as follows.
Switch Information
State:
Online
BB Credit:
R_A_TOV:
E_D_TOV:
2
20
4
Preferred Domain Id: 1
Switch Priority:
Speed:
Default
2 Gb/sec
Rerouting Delay:
Operating Mode:
Interop Mode:
Active Domain Id:
World Wide Name:
Enabled
Open Systems
Open Fabric 1.0
1
10:00:08:00:88:00:21:07
Insistent Domain Id: Enabled
Domain RSCN: Enabled
2-87
show
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
VKRZꢁV\VWHP
Th system
Qꢁr This command displays a set of system attributes.
Qhꢁhrrꢁ
This command has no parameters.
8hqꢀ@hyr
P
Root> show system
The system attributes are displayed as a table that includes the
following properties.
Name
The system name as set in the
config.system.name command.
Description
Contact
The system description as set in the
config.system.description command.
The system contact as set in the
config.system.contact command.
Location
Date/Time
The system description as set in the
config.system.description command.
The system date and time as set in the
config.system.date command.
Serial Number
Type Number
Model Number
The serial number for the system.
The type number for the system.
The model number for the system (for example,
Intrepid 6064).
EC Level
The engineering change level installed.
The current firmware version installed.
Firmware
Version
Beaconing
The enabled state of unit beaconing (enabled or
disabled) as set in the maint.system.beacon
command.
2-88
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-300
Download from Www.Somanuals.com. All Manuals Search And Download.
2
Pꢀ@hyr
The output from the show.system command displays as follows.
System Information
Name:
Joe’s Switch
McDATA Intrepid 6064 Fibre Channel
Description:
Director
Contact:
Location:
Joe
Everywhere
Date/Time:
Serial Number:
Type Number:
Model Number;
EC Level:
04/16/2001 10:34:01AM
123456789
1
Intrepid 6064
1
Firmware Version: 01.03.00 34
Beaconing: Disabled
VKRZꢁ]RQLQJ
Th zoning
Qꢁr
Qhꢁhrrꢁ
This command shows the zoning configuration saved on the fabric.
This command has no parameters.
8hqꢀ@hyr
P
Root> show zoning
The zoning configuration data is displayed as a table that includes
the following properties.
Active ZoneSet
The enabled status, name, and member zones of
the zone set.
Pꢀ@hyr
The output from the show.zoning command displays as follows.
Active Zone Set
Default Zone Enabled: False
ZoneSet: TheUltimateZoneSet
Zone: TheUltimateZone
ZoneMember: Domain 10, Port 6
ZoneMember: Domain 15, Port 2
ZoneMember: Domain 2, Port 63
ZoneMember: 10:00:00:00:C9:22:9B:64
ZoneMember: 10:00:00:00:C9:22:9B:BD
Zone: TheNotSoUltimateZone
ZoneMember: 10:00:00:00:C9:22:9B:AB
ZoneMember: 10:00:00:00:C9:22:9B:C6
ZoneMember: 10:00:00:00:C9:22:9B:AB
Zone: TheNotUltimateAtAllZone
ZoneMember: Domain 2, Port 63
2-89
show
Download from Www.Somanuals.com. All Manuals Search And Download.
CLI Commands
2
2-90
McDATA OPENconnectors Command Line Interface USER MANUAL
Download from Www.Somanuals.com. All Manuals Search And Download.
P/N 620-000134-300
$
(UURUꢀ0HVVDJHV
This appendix lists and explains error messages for the Command
Line Interface (CLI). Any error numbers that are not listed are
reserved for future use.
The message that is returned is a string that includes the error
number and the text of the message.
Message
Description
Action
Error 05: Busy
The switch is busy processing another request.
After a few seconds, re-issue the request.
Message
Description
Action
Error 08: Invalid Switch Name
The value entered for the switch name is invalid.
The name for the director or switch may contain 0–24 characters.
Enter a name with 0–24 characters and re-submit. If spaces are used,
enclose the name in quotation marks.
A-1
Error Messages
Download from Www.Somanuals.com. All Manuals Search And Download.
Error Messages
A
Message
Description
Action
Error 09: Invalid Switch Description
The value entered for the switch description is invalid.
The description for the director or switch may contain 0–255
characters. Enter a description with 0–255 characters and re-submit. If
spaces are used, enclose the description in quotation marks.
Message
Description
Action
Error 10: Invalid Switch Location
The value entered for the switch location is invalid.
The location for the director or switch may contain 0–255 characters.
Enter a location with 0–255 characters and re-submit. If spaces are
used, enclose the location in quotation marks.
Message
Description
Action
Error 11: Invalid Switch Contact
The value entered for the switch contact is invalid.
The contact for the director or switch may contain 0–255 characters.
Enter a contact with 0–255 characters and re-submit. If spaces are
used, enclose the contact in quotation marks.
Message
Description
Action
Error 13: Invalid Port Number
The value entered for the port number is invalid.
Enter a port number within the range supported by your director or
switch. Valid values are:
0–15 for the Sphereon 3016 and Sphereon 3216
0–31 for the Sphereon 3032 and Sphereon 3232
0–31 for the ED-5000
0–63 for the Intrepid 6064
A-2
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-500
Download from Www.Somanuals.com. All Manuals Search And Download.
Error Messages
A
Message
Description
Action
Error 14: Invalid Port Name
The value entered for the port name is invalid.
The port name for the individual port may contain 0–24 characters.
Enter a name with 0–24 characters and re-submit. If spaces are used,
enclose the name in quotation marks.
Message
Description
Action
Error 15: Invalid BB Credit
The value entered for the buffer-to-buffer credit is invalid.
The buffer-to-buffer credit must be an integer in the range of 1–60.
Message
Error 16: Invalid R_A_TOV
Description
The value entered for the resource allocation time-out value is
invalid.
Action
The R_A_TOV is entered in tenths of a second and must be entered as
an integer in the range 10–1200 (1 second to 120 seconds). The
R_A_TOV value must be larger than the E_D_TOV value. Check to be
sure that all conditions are met and re-submit.
Message
Description
Action
Error 17: Invalid E_D_TOV
The value entered for the error detection time-out value is invalid.
The E_D_TOV is entered in tenths of a second and must be entered as
an integer in the range 2–600 (0.2 second to 60 seconds). The
E_D_TOV must be smaller than the R_A_TOV. Check to be sure that
all conditions are met and re-submit.
Message
Description
Action
Error 18: Invalid TOV
The E_D_TOV and R_A_TOV values are not compatible.
Enter a valid E_D_TOV / R_A_TOV combination. The E_D_TOV
must be smaller than the R_A_TOV.
A-3
Error Messages
Download from Www.Somanuals.com. All Manuals Search And Download.
Error Messages
A
Message
Error 20: Invalid Preferred Domain ID
Description
The value entered for the preferred domain ID for the director or
switch is invalid.
Action
The preferred domain ID must be an integer in the range 1–31. Enter
an appropriate value and re-submit.
Message
Description
Action
Error 21: Invalid Switch Priority
The value entered for the switch priority is invalid.
The switch priority entered for the director or switch must be one of
the following: principal, neverprincipal, or default. Enter an appropriate
value and re-submit. (Refer to the description of the command in
config.switch.priority on page 2-35.)
Message
Description
Action
Error 29: Invalid Gateway Address
The value entered for the gateway address is invalid.
The new gateway address for the Ethernet interface must be entered
in dotted decimal format (e.g. 0.0.0.0). Enter an appropriate gateway
address and re-submit.
Message
Description
Action
Error 30: Invalid IP Address
The value entered for the IP Address is invalid.
The new IP address for the Ethernet interface must be entered in
dotted decimal format (e.g. 10.0.0.0). Enter an appropriate IP address
and re-submit.
A-4
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-500
Download from Www.Somanuals.com. All Manuals Search And Download.
Error Messages
A
Message
Description
Action
Error 31: Invalid Subnet Mask
The value entered for the subnet mask is invalid.
The new subnet mask for the Ethernet interface must be entered in
dotted decimal format (e.g. 255.0.0.0). Enter an appropriate subnet
mask and re-submit.
Message
Description
Action
Error 32: Invalid SNMP Community Name
The value entered for the SNMP community name is invalid.
The community name must not exceed 32 characters in length.
Duplicate community names are allowed, but corresponding write
authorizations must match. Enter an appropriate SNMP community
name and re-submit.
Message
Description
Action
Error 33: Invalid SNMP Trap Address
The value entered for the SNMP trap address is invalid.
The new SNMP trap address for the SNMP interface must be entered
in dotted decimal format (e.g. 10.0.0.0). Enter an appropriate SNMP
trap address and re-submit.
Message
Error 34: Duplicate Community Names Require Identical Write
Authorization
Description
Two or more community names have been recognized as being
identical, but their corresponding write authorizations are not
identical.
Action
Enter unique SNMP community names or force write authorizations
for duplicate community names to be identical and re-submit.
A-5
Error Messages
Download from Www.Somanuals.com. All Manuals Search And Download.
Error Messages
A
Message
Description
Action
Error 37: Invalid Month
The value of the month entered for the new system date is invalid.
The format of the date parameter must be mm:dd:yyyy or
mm/dd/yyyy. The month must contain an integer in the range 1–12.
Enter an appropriate date and re-submit.
Message
Description
Action
Error 38: Invalid Day
The value of the day entered for the new system date is invalid.
The format of the date parameter must be mm:dd:yyyy or
mm/dd/yyyy. The day must contain an integer in the range 1–31.
Enter an appropriate date and re-submit.
Message
Description
Action
Error 39: Invalid Year
The value of the year entered for the new system date is invalid.
The format of the date parameter must be mm:dd:yyyy or
mm/dd/yyyy. The year must contain an integer greater than 1980.
Enter an appropriate date and re-submit.
Message
Description
Action
Error 40: Invalid Hour
The value of the hour entered for the new system time is invalid.
The format of the time parameter must be hh:mm:ss. The hour can
contain an integer in the range 0–23. Enter an appropriate time and
re-submit.
Message
Description
Error 41: Invalid Minute
The value of the minute entered for the new system time is invalid.
contain an integer in the range 0–59. Enter an appropriate time and
re-submit.
A-6
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-500
Download from Www.Somanuals.com. All Manuals Search And Download.
Error Messages
A
Message
Description
Action
Error 42: Invalid Second
The value of the second entered for the new system time is invalid.
The format of the time parameter must be hh:mm:ss. The second can
contain an integer in the range 0–59. Enter an appropriate time and
re-submit.
Message
Error 44: Max SNMP Communities Defined
Description
A new SNMP community may not be defined without removing an
existing community from the list.
Action
A total of 6 communities may be defined for SNMP. A new
community can be added only after a current community is removed.
Make the appropriate changes and re-submit.
Message
Error 45: Not Allowed While Switch Online
Description
The entered command requires that the director or switch be set
offline.
Action
Set the switch offline and re-submit the command.
Message
Description
Action
Error 55: Invalid Zone Name
The value entered for the zone name is invalid.
The zone name must be unique and contain 1–64 characters. The
valid character set for the zone name can be found under
config.zoning.addZone on page 2-47. Make the appropriate changes to
the zone name and re-submit.
A-7
Error Messages
Download from Www.Somanuals.com. All Manuals Search And Download.
Error Messages
A
Message
Description
Action
Error 57: Duplicate Zone
Two or more zone names in the zone set are identical.
All zone names must be unique. Make the appropriate changes and
re-submit.
Message
Description
Action
Error 59: Zone Name in Use
Two or more zone names in the zone set are identical.
All zone names must be unique. Make the appropriate changes and
re-submit.
Message
Error 60: Invalid Number of Zone Members
Description
The entered command tried to add more zone members than the zone
can hold.
Action
Reduce the number of zone members in the zone and re-submit the
command.
Message
Error 61: Invalid Zone Member Type
Description
Port pair.
Action
Zone members must be expressed in WWN format or as a Domain,
Port pair. Make the appropriate changes and re-submit. For more
information, see config.zoning.addWwnMem on page 2-48 and
config.zoning.addPortMem on page 2-49.
Message
Description
The value entered for the zone set name is invalid.
character set for the zone name can be found in config.zoning.addZone
on page 2-47. Make the appropriate changes to the zone set name and
re-submit.
A-8
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-500
Download from Www.Somanuals.com. All Manuals Search And Download.
Error Messages
A
Message
Description
Action
Error 69: Duplicate Port Name
Two or more port names are identical.
Port names must be unique. Make appropriate changes and
re-submit. For more information, see config.port.name on page 2-10.
Message
Description
Action
Error 70: Invalid FRU Type
The specified FRU does not exist on this product
Consult the installation/service manual for this product to find
appropriate FRU names.
Message
Description
Action
Error 71: FRU Not Installed
The specified FRU is not installed.
Consult the installation/service manual for this product for
appropriate action.
Message
Description
Action
Error 72: No Backup FRU
The FRU cannot be swapped because a backup FRU is not installed.
Insert a backup FRU and re-submit the request or consult the
installation/service manual for this product for appropriate action.
Message
Description
Action
Error 73: Port Not Installed
The port specified is not installed on this product.
Consult the installation/service manual on installing a port optic.
A-9
Error Messages
Download from Www.Somanuals.com. All Manuals Search And Download.
Error Messages
A
Message
Error 74: Invalid Number of Zones
Description
The specified zone set contains less than one zone or more than the
maximum number of zones allowed for this product.
Action
A zone set must contain at least one zone to be considered valid. Add
or remove zones accordingly to meet specified requirements.
Message
Description
Action
Error 75: Invalid Zone Set Size
The zone set entered exceeds switch NVRAM limitations.
Reduce the size of the zone set to meet specified requirements. This
can be a reduction in the number of zones in the zone set, a reduction
of members in a zone, or a reduction of zone name lengths.
Message
Error 76: Invalid Number of Unique Zone Members
Description
The zone entered contains more than the maximum number of zone
members allowed per zone set for this product.
Action
Reduce the number of members in one or more zones and re-submit
the command.
Message
Error 77: Not Allowed While Port Is Failed
Description
The port selected is in a failed or inactive state, or is in need of
service.
Action
Consult the installation/service manual for appropriate action.
Message
Description
Action
Error 78: System Error Light On
This unit is not able to beacon because the system error light is on.
You must clear the system error light before unit beaconing may be
action.
A-10
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-500
Download from Www.Somanuals.com. All Manuals Search And Download.
Error Messages
A
Message
Description
Action
Error 79: FRU Failed
The specified FRU has failed.
Consult the installation/service manual for appropriate action.
Message
Description
Action
Error 81: Default Zone Enabled
The request cannot be completed because the default zone is enabled
Disable the default zone and re-submit the command.
Message
Description
Action
Error 82: Invalid Interop Mode
The value entered for the interoperability mode is not valid.
The interoperability mode for the director or switch must be mcdata
(McDATA Fabric 1.0) or open (Open Fabric 1.0). Make the
appropriate changes and re-submit the command.
Message
Error 83: Not Allowed in Open Fabric Mode
Description
This request cannot be completed while this switch is operating in
Open Fabric 1.0 mode.
Action
Configure the interop mode to McDATA Fabric 1.0 mode.
Message
Description
Action
Error 88: Invalid Feature Key Length
The feature key installed is longer than the maximum length allowed.
Be sure that the key has been entered correctly and re-submit. Contact
your sales representative with any further problems.
A-11
Error Messages
Download from Www.Somanuals.com. All Manuals Search And Download.
Error Messages
A
Message
Description
Action
Error 89: Not Allowed in S/390 Mode Without the SANtegrity (TM)
Feature
Cannot configure port types in S/390 mode without installing
SANtegrity.
This command is only supported when the switch is in Open Systems
mode or in S/390 with SANtegrity. The switch will need to be taken
out of S/390 Mode in order to complete this command or SANtegrity
will need to be purchased and installed. The switch cannot be taken
out of S/390 Mode via the Command Line Interface. The EFC
Manager application must be used to change the switch operating
mode.
Message
Description
Action
Error 90: Invalid Port Type
The port type configured is invalid.
A port may be configured to be an eport, gport, or fport. Be sure the
port is configured appropriately and re-submit the command.
Message
Description
Action
Error 91: E_Port Type Configured
Ports are not allowed to be configured as E_Ports in S/390 mode.
Configure the port as either a fport or gport and resubmit the
command.
Message
Description
Action
Error 92: Not Allowed While Port Is Unblocked
The port must be blocked to complete this request.
Block the port and re-submit the command.
Message
Error 93: Not Allowed While FICON MS Is Installed
Description
This request cannot be completed because FICON Management
Server is installed.
Action
This operation is not supported. No action necessary.
A-12
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-500
Download from Www.Somanuals.com. All Manuals Search And Download.
Error Messages
A
Message
Error 94: Invalid Feature Combination
Description
The features requested cannot be installed at the same time on one
director or switch.
Action
Contact your sales representative.
Message
Error 99: Preferred Domain ID Cannot Be Zero
Description
This product cannot be configured to have a preferred domain ID
equal to zero (0).
Action
Ensure that the ID is expressed as an integer in the range 1–31 and
re-submit.
Message
Description
Action
Error 101: Command Not Supported on This Product
This product does not support the requested command.
Command not supported. No action necessary.
Message
Error 102: Switch Not Operational
Description
The request cannot be completed because the switch is not
operational.
Action
Consult the installation/service manual and contact your service
representative.
Message
Error 115: Invalid Switch Speed
Description
The request cannot be completed because the switch is not capable of
operating at the configured speed.
Action
Consult the installation/service manual to determine the speed
capabilities of your product.
A-13
Error Messages
Download from Www.Somanuals.com. All Manuals Search And Download.
Error Messages
A
Message
Error 116: Switch Not Capable of 2 Gb/sec
Description
The request cannot be completed because the switch is not capable of
operating at 2 Gbps.
Action
Consult the installation/service manual to determine the speed
capabilities of your product.
Message
Description
Action
Error 117: Port Speeds Cannot be Set at Higher Data Rate than
Switch Speed
This request cannot be completed because the requested port speed is
The switch speed should first be configured to accommodate changes
in the configured port speed. The ports can not operate at a faster rate
than the switch, itself. Update the switch speed and re-submit the
request. For more information, see config.switch.speed on page 2-38
and config.port.speed on page 2-11.
Message
Error 118: Invalid Port Speed
Description
This request cannot be completed because the requested port speed is
not recognized for this product.
Action
Port speeds may be set to 1 Gbps or 2 Gbps. Update the port speed
and re-submit the request.
Message
Error 119: Switch Speed Not 2 Gb/sec
Description
This request cannot be completed because the switch speed has not
been set to 2 Gbps.
Action
The switch speed must be set to 2 Gbps in order to accommodate a
port speed of 2 Gbps. Update the switch speed and re-submit the
request.
A-14
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-500
Download from Www.Somanuals.com. All Manuals Search And Download.
Error Messages
A
Message
Error 134: Invalid Membership List
Description
Generic message to indicate a problem in either the switch binding or
fabric binding membership list.
Action
Be sure that the membership list submitted does not isolate a switch
already in the fabric. If this is not the case, the user needs to be aware
of all fabric security rules and make sure that the list submitted
adheres appropriately.
Message
Error 135: Invalid Number of Fabric Membership List Entries
Description
The number of fabric members submitted exceeds the maximum
allowable entries of 31.
Action
The number of entries in the fabric membership list is limited to the
total number of domain ID’s available to the fabric. Make sure that
the list (including the managed switch) contains no more than 31
entries.
Message
Error 136: Invalid Number of Switch Membership List Entries
Description
The number of switch members submitted exceeds the maximum
allowable entries of 256.
Action
The number of entries in the switch membership list is limited to 256.
Make sure that the list (including the managed switch) contains no
more than 256 entries.
Message
Description
Action
Error 137: Invalid Fabric Binding State
The fabric binding state submitted is not recognized by the CLI.
The fabric binding state must be set to either inactive or restrict. For
more information, see config.security.fabricBinding on page 2-14.
A-15
Error Messages
Download from Www.Somanuals.com. All Manuals Search And Download.
Error Messages
A
Message
Description
Action
Error 138: Invalid Switch Binding State
The switch binding state submitted is not recognized by the CLI.
The switch binding state must be set to one of the following: disable,
erestrict, frestrict, or allrestrict. For more information, see
config.security.switchBinding on page 2-23.
Message
Description
Action
Error 139: Insistent Domain ID’s Must Be Enabled When Fabric
Binding Active
The user attempted to disable insistent domain ID’s while fabric
binding was active.
Insistent domain ID’s must remain enabled while fabric binding is
active. If fabric binding is set to inactive, the insistent domain ID state
may be changed. It should be noted, however, that this can be
disruptive to the fabric.
Message
Error 140: Invalid Insistent Domain ID State
Description
The request cannot be completed because an invalid insistent domain
ID state has been submitted.
Action
The insistent domain ID state must be set to either enable or disable.
For more information, see config.switch.insistDomainId on page 2-33.
Message
Error 141: Invalid Enterprise Fabric Mode
Description
The request cannot be completed because an invalid enterprise fabric
mode has been submitted.
Action
The enterprise fabric mode must be set to either activate or deactivate.
For more information, see config.features.enterpriseFabMode on
page 2-3.
A-16
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-500
Download from Www.Somanuals.com. All Manuals Search And Download.
Error Messages
A
Message
Error 142: Invalid Domain RSCN State
Description
The request cannot be completed because an invalid domain RSCN
state has been submitted.
Action
The domain RSCN state must be set to either enable or disable. For
more information, see config.switch.domainRSCN on page 2-32.
Message
Description
Action
Error 143: Domain RSCNs Must Be Enabled When Enterprise
Fabric Mode Active
The user attempted to disable domain RSCN’s while enterprise fabric
mode was active.
Domain RSCN’s must remain enabled while the enterprise fabric
mode is active. If enterprise fabric mode is set to inactive, the domain
RSCN state may be changed. It should be noted, however, that this
can be disruptive to the fabric.
Message
Error 144: The SANtegrity Feature Has Not Been Installed
Description
The user attempted to activate a change to the fabric security
configuration without first installing the SANtegrity feature key.
Action
If this key has not been installed, contact your sales representative.
Message
Description
Action
Error 146: Fabric Binding May Not Be Deactivated While Enterprise
Fabric Mode Active
The user attempted to deactivate fabric binding while enterprise
fabric mode was active.
Fabric binding must be active while operating in enterprise fabric
mode. The fabric binding state may be changed if enterprise fabric
mode is deactivated. It should be noted, however, that this can be
disruptive to the fabric.
A-17
Error Messages
Download from Www.Somanuals.com. All Manuals Search And Download.
Error Messages
A
Message
Description
Action
Error 148: Not Allowed While Switch Offline
The switch must be online to complete this request.
Change the state of the switch to ONLINE and re-submit the request.
Message
Description
Action
Error 149: Not Allowed While Enterprise Fabric Mode Enabled and
Switch Active
The request cannot be completed while the switch is online and
enterprise fabric mode is Active.
This operation will be valid if the switch state is set to offline and
enterprise fabric mode to inactive. It should be noted, however, that
this can be disruptive to the fabric.
Message
Error 151: Invalid Open Systems Management Server State
Description
The request cannot be completed because the OSMS state submitted
is invalid.
Action
The OSMS state may be set to either enable or disable. For more
information, see config.features.OpenSysMS on page 2-4.
Message
Error 152: Invalid FICON Management Server State
Description
The request cannot be completed because the FICON MS state
submitted is invalid.
Action
The FICON MS state may be set to either enable or disable. For more
information, see config.features.ficonms on page 2-3.
Message
Error 153: Feature Key Not Installed
Description
The request cannot be completed because the required feature key
Action
Contact your sales representative.
A-18
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-500
Download from Www.Somanuals.com. All Manuals Search And Download.
Error Messages
A
Message
Error 154: Invalid Membership List WWN
Description
The request cannot be completed because the WWN does not exist in
the switch binding membership list.
Action
Make sure that the WWN deleted matches the WWN in the switch
membership list. Make appropriate changes and re-submit the
request.
Message
Error 155: Cannot Remove Active Member From List
Description
This member cannot be removed from the fabric security list because
it is currently logged in.
Action
Fabric security rules prohibit any device or switch from being
isolated from the fabric via a membership list change. If it is truly the
intention of the user to remove the device in question from the
membership list, then there are several approaches to take. This
request may be completed most non-disruptively by blocking the
port (or physically removing the device from the managed switch) to
which this device is attached and resubmitting the request.
Message
Description
Action
Error 156: Cannot Disable Fabric Binding while Switch is Online
The switch must be offline before Fabric Binding can be deactivated.
Deactivating fabric binding is disruptive to Fabric operations. Set the
switch offline before deactivating this feature.
Message
Description
Action
Error 201: Change Authorization Request Failed
The switch did not accept the request to make a change to NVRAM.
Be sure all parameters have been entered correctly and re-submit.
Contact your service representative with further problems.
A-19
Error Messages
Download from Www.Somanuals.com. All Manuals Search And Download.
Error Messages
A
Message
Error 202: Invalid Change Authorization ID
Description
The switch will not accept a change request from this particular
client.
Action
Be sure all parameters have been entered correctly and re-submit.
Contact your service representative with further problems.
Message
Description
Action
Error 203: Another Client Has Change Authorization
Another user is currently making changes to this switch.
Be sure all parameters have been entered correctly and re-submit.
Message
Description
Action
Error 207: Change Request Failed
The switch did not accept the request.
Be sure all parameters have been entered correctly and re-submit.
Contact your service representative with further problems.
Message
Description
Action
Error 208: Change Request Timed Out
Authorization time to make NVRAM changes has expired.
Be sure all parameters have been entered correctly and re-submit.
Contact your service representative with further problems.
Message
Description
Action
Error 209: Change Request Aborted
The switch did not accept the request.
Be sure all parameters have been entered correctly and re-submit.
Contact your service representative with further problems.
A-20
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-500
Download from Www.Somanuals.com. All Manuals Search And Download.
Error Messages
A
Message
Error 210: Busy Processing Another Request
Description
A different switch in the Fabric was busy processing another request
and could not complete the command.
Action
Be sure all parameters have been entered correctly and re-submit.
Contact your service representative with continued problems.
Message
Description
Action
Error 211: Duplicate Zone
Two or more zone names in the local zone set are identical.
All zone names must be unique. Make the appropriate changes and
re-submit.
Message
Description
Action
Error 212: Duplicate Zone Member
A member was added that already exists in the zone.
No action necessary.
Message
Description
Action
Error 213: Number of Zones Is Zero
You are attempting to activate and empty zone set.
The zone set must have at least one zone to be considered valid. Add
a valid zone to the zone set and re-submit.
Message
Error 214: A Zone Contains Zero Members
Description
You are attempting to activate a zone set that contains at least one
zone with zero members.
Action
Each zone in the zone set must contain at least one member. Add a
valid member to the empty zone and re-submit.
A-21
Error Messages
Download from Www.Somanuals.com. All Manuals Search And Download.
Error Messages
A
Message
Error 215: Zone Set Size Exceeded
Description
The local work area zone set has outgrown the size limitations
imposed by the Command Line Interface.
Action
Reduce the size of the zone set to meet CLI requirements. This can be
a reduction in the number of zones in the zone set, a reduction of
members in a zone, or a reduction of zone name lengths.
Message
Description
Action
Error 218: Invalid Port Number
The value entered for the port number is invalid
Enter a port number within the range supported by your director or
switch. Valid values are:
0–15 for the Sphereon 3016 and Sphereon 3216
0-23 for the Sphereon 4500
0–31 for the Sphereon 3032 and Sphereon 3232
0–31 for the ED-5000
0–63 for the Intrepid 6064
0–127 and 132–144 for the Intrepid 6140
Message
Description
Action
Error 219: Invalid Port Type
The port type configured is invalid.
A port may be configured to be an eport, gport, or fport. Be sure the
port is configured appropriately and re-submit the command. On the
Sphereon 4500 only, fxport and gxport types are also supported.
Message
Description
Error 222: Invalid SNMP Community Index
The value entered for the SNMP community index is invalid.
Make the appropriate changes and re-submit the command.
A-22
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-500
Download from Www.Somanuals.com. All Manuals Search And Download.
Error Messages
A
Message
Description
Action
Error 223: Unknown Error
The switch did not accept the request
Contact your service representative.
Message
Description
Action
Error 224: Invalid Argument
One or more parameters are invalid for this command.
For the appropriate parameters, see the section of the manual that
corresponds to the attempted command. Parameters must be typed
exactly to specification to be recognized correctly by the CLI.
Message
Description
Action
Error 225: Argument Does Not Contain All USASCII Characters
The CLI received non-USASCII characters.
For the appropriate parameters, see the section of the manual that
corresponds to the attempted command. Parameters must be typed
exactly to specification to be recognized correctly by the CLI.
Message
Description
Action
Error 226: Argument Is Too Long
One or more parameters are invalid for this command.
For the appropriate parameters, see the section of the manual that
corresponds to the attempted command. Parameters must be typed
exactly to specification to be recognized correctly by the CLI.
Message
Description
Action
Error 227: Invalid SNMP Community Name
The value entered for the SNMP community name is invalid
The community name must not exceed 32 characters in length.
Duplicate community names are allowed, but corresponding write
authorizations must match. Enter an appropriate SNMP community
name and re-submit.
A-23
Error Messages
Download from Www.Somanuals.com. All Manuals Search And Download.
Error Messages
A
Message
Description
Action
The writeAuthorization parameter does not contain a valid value.
Parameters must be typed exactly to specification to be recognized
correctly by the CLI. For more information, see
config.snmp.addCommunity on page 2-29.
Message
Description
Action
Error 229: Invalid UDP Port Number
The udpPortNum parameter does not contain a valid value.
Parameters must be typed exactly to specification to be recognized
correctly by the CLI. For more information, see
config.switch.insistDomainId on page 2-33.
Message
Description
Action
Error 230: Invalid WWN
The wwn parameter does not contain a valid value.
For the appropriate parameters, see the section of the manual that
corresponds to the attempted command. Parameters must be typed
exactly to specification to be recognized correctly by the CLI.
Message
Description
Action
Error 231: Invalid Port number
The portNum parameter does not contain a valid value.
For the appropriate parameters, see the section of the manual that
corresponds to the attempted command. Parameters must be typed
exactly to specification to be recognized correctly by the CLI.
Message
Description
Error 232: Invalid Domain ID
The domainID parameter does not contain a valid value.
corresponds to the attempted command. Parameters must be typed
exactly to specification to be recognized correctly by the CLI.
A-24
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-500
Download from Www.Somanuals.com. All Manuals Search And Download.
Error Messages
A
Message
Description
Action
Error 233: Invalid Member
The zone member added is not valid.
For the appropriate parameters, see the section of the manual that
corresponds to the attempted command. Parameters must be typed
exactly to specification to be recognized correctly by the CLI.
Message
Error 234: Invalid Command
Description
The CLI cannot associate an action with the submitted command. The
command may be misspelled, required parameters may be missing,
or the request may not be applicable to the branch of the CLI tree
from which it was submitted.
Action
Consult the documentation for the command to be sure this
command was entered correctly, all parameters are valid and present,
and that the syntax is correct.
Message
Error 235: Unrecognized Command
Description
The CLI does not recognize the command and cannot perform the
help ’?’ command as requested.
Action
The entered command is misspelled or the prompt is not positioned
at the right place in the CLI command tree for this command. For the
appropriate syntax, see the section of the manual that corresponds to
the attempted command.
Message
Description
Action
Error 236: Ambiguous Command
The CLI does not recognize the command issued.
The CLI cannot interpret the command because a unique match
cannot be identified. For the appropriate syntax, see the section of the
manual that corresponds to the attempted command. Enter the
complete command and re-submit.
A-25
Error Messages
Download from Www.Somanuals.com. All Manuals Search And Download.
Error Messages
A
Message
Description
Action
Error 237: Invalid Zoning Database
There was an unidentifiable problem in the local zone set work area.
Verify all parameters are entered correctly and re-submit. Otherwise,
the pending zone set should be cleared and reconstructed.
Message
Description
Action
Error 238: Invalid Feature Key
The feature key entered is invalid.
Verify that the feature key was entered correctly and re-submit.
Contact your service representative with further difficulties.
Message
Error 239: Fabric binding entry not found
Description
The user requested to remove a fabric binding entry that is not in the
pending fabric membership list.
Action
Verify that the correct entry (both WWN and Domain ID) is being
requested for removal from the list and re-submit the request.
Message
Error 240: Duplicate fabric binding member
Description
The user requested to add an entry to the fabric binding list that is
already a member of the list.
Action
Verify that the correct entry (both WWN and Domain ID) is being
requested for addition to the list and re-submit the request.
Message
Description
Action
Error 241: Comma-delimited mode must be active
Comma-delimited mode must be active to execute this command
Some commands require that comma-delimited mode be active (e.g.
show.nameserverExt). Enable comma-delimited mode and re-issue
A-26
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-500
Download from Www.Somanuals.com. All Manuals Search And Download.
Error Messages
A
Message
Description
Action
Error 242: Open trunking threshold % value must be 0–99
An invalid threshold percentage has been entered.
The Open trunking threshold must be in the range 0–99. Make sure
all values are valid and re-submit the request.
Message
Description
Action
Error 243: Not allowed while S/390 Mode is Enabled
This operation is not allowed while S/390 mode is enabled.
This command is not valid for the S/390 environment.
A-27
Error Messages
Download from Www.Somanuals.com. All Manuals Search And Download.
Error Messages
A
A-28
McDATA OPENconnectors Command Line Interface USER MANUAL
Download from Www.Somanuals.com. All Manuals Search And Download.
P/N 620-000134-500
*ORVVDU\
The following cross-references are used in this glossary:
Contrast with. This refers to a term that has an opposite or
substantively different meaning.
See. This refers the reader to another keyword or phrase for the same
term.
See also. This refers the reader to definite additional information
contained in another entry.
A
active zone set
The single zone set that is active in a multiswitch fabric. It is created
when you enable a specified zone set. This zone set is compiled by
checking for undefined zones or aliases.
ALPA
Arbitrated Loop Physical Address.
B
for all logic cards.
g-1
P/N 620-000134-500
McDATA OPENconnectors Command Line Interface USER MANUAL
Download from Www.Somanuals.com. All Manuals Search And Download.
Glossary
backup FRU
beaconing
When an active FRU fails, an identical backup FRU takes over
operation automatically (failover) to maintain director and Fibre
Channel link operation.
The use of light-emitting diodes on ports, port cards, hardware
components, and directors to aid in the fault-isolation process; when
enabled, active beaconing will cause LEDs to flash for selected
components.
BB_Credit
blocked port
buffer
Also known as Buffer-to-Buffer Credit. The maximum number of
frames a port can transmit without receiving a receive ready signal
from the receiving device.
Devices communicating with the port are prevented from logging
into the director or communicating with other devices attached to the
director. A blocked port continuously transmits the offline sequence.
A storage area for data in transit. Buffers compensate for differences
in processing speeds between devices. See also BB_Credit.
C
channel
A point-to-point link that transports data from one point to the other.
class of Fibre Channel
service
Defines the level of connection dedication, acknowledgment, and
other characteristics of a connection.
Class F Fibre Channel
service
Used by switches to communicate across interswitch links (ISLs) to
configure, control, and coordinate a multiswitch fabric.
Class 2 Fibre Channel
service
Provides a connectionless (not dedicated) service with notification of
delivery or nondelivery between two N_Ports.
Class 3 Fibre Channel
service
Provides a connectionless (not dedicated) service without notification
of delivery or nondelivery between two N_Ports. Also known as
datagram.
community profile
configuration data
Information that specifies which management objects are available to
Configuration data includes: identification data, port configuration
data, operating parameters, SNMP configuration, and zoning
g-2
McDATA OPENconnectors Command Line Interface USER MANUAL
Download from Www.Somanuals.com. All Manuals Search And Download.
P/N 620-000134-500
Glossary
configuration. A configuration backup file is required to restore
configuration data if the CTP card in a nonredundant Intrepid 6064 is
removed and replaced.
connectionless
connector
Nondedicated link. Typically used to describe a link between nodes
which allows the switch to forward Class 2 or Class 3 frames as
resources (ports) allow. Contrast this to the dedicated bandwidth that
is required in a Class 1 Fibre Channel Service point-to-point link.
See optical fiber connector.
control processor
card
Circuit card that contains the director microprocessor. The CTP card
also initializes hardware components of the system after power-on. A
10 Mbps RJ-45 twisted pair connector is located on the CTP card to
connect to the Ethernet LAN and communicate with the EFC Server
or a specific management station.
control unit
A hardware unit that controls the reading, writing, or displaying of
data at one or more input/output units.
CRC
CTP
See cyclic redundancy check.
See control processor card.
cyclic redundancy
check
System of error checking performed at both the sending and
receiving station using the value of a particular character generated
by a cyclic algorithm. When the values generated at each station are
identical, data integrity is confirmed.
D
datagram
See Class 3 Fibre Channel service.
default
default zone
device
Pertaining to an attribute, value, or option that is assumed when none
is explicitly specified.
Contains all attached devices that are not members of a separate
zone.
Product, connected to a managed director, connected to a switch or
director, that is not controlled by the switch or director’s management
software. See also node.
g-3
P/N 620-000134-500
McDATA OPENconnectors Command Line Interface USER MANUAL
Download from Www.Somanuals.com. All Manuals Search And Download.
Glossary
dialog box
director
A window containing informational messages or data fields to be
modified or filled in with desired options.
An intelligent, high-availability Fibre Channel switching device
providing any-to-any port connectivity between nodes (end devices)
on a switched fabric. The director sends data transmissions (data
frames) between nodes in accordance with the address information
present in the frame headers of those transmissions.
domain ID
The number that uniquely identifies a switch in a multiswitch fabric.
A distinct domain ID is automatically allocated to each switch in the
fabric by the principal switch.
E
E_Port
See expansion port.
E_D_TOV
EFC
See error-detect time-out value.
Enterprise fabric connectivity.
EFC Server
PC shipped with a product to run the EFC Manager, EFC Product
Manager, and EFC Fabric Manager applications.
embedded web
server
With director firmware Version 1.2 (or later) installed, administrators
or operators with a browser-capable PC and an Internet connection
can monitor and manage the director through an embedded web
server interface, called the SANpilot interface. The interface provides
a GUI similar to the Product Manager application, and supports
director configuration, statistics monitoring, and basic operation.
Enterprise Fabric
Connectivity
Manager
Software application that is the system management framework
providing the user interface for managing McDATA Fibre Channel
connectivity products. The EFC Manager can run both locally on the
EFC Server and remotely on a user workstation.
error detect time out
value
The value that defines the time the switch waits for an expected
response before declaring an error condition.
error message
Indication that an error has been detected. See also information
message; warning message.
g-4
McDATA OPENconnectors Command Line Interface USER MANUAL
Download from Www.Somanuals.com. All Manuals Search And Download.
P/N 620-000134-500
Glossary
Ethernet
A widely implemented local area network (LAN) protocol that uses a
bus or star topology and served as the basis for the IEEE 802.3
standard, which specifies the physical and software layers. Baseband
LAN allows multiple station access to the transmission medium at
will without prior coordination and which avoids or resolves
contention.
event log
Record of significant events that have occurred on the director, such
as FRU failures, degraded operation, and port problems.
expansion port
The physical interface on a Fibre Channel switch within a fabric, that
attaches to an expansion port (E_Port) on another Fibre Channel
switch to form a multiswitch fabric. See also segmented E_Port.
F
F_Port
See fabric port.
fabric
Entity that interconnects N_Ports and is capable of routing
(switching) Fibre Channel frames using the destination ID
information in the Fibre Channel frame header accompanying the
frames.
fabric port
failover
Physical interface within the fabric that connects to an N_Port
through a point-to-point full duplex connection.
The automatic and nondisruptive transition of functions from an
active FRU that has failed to a backup FRU.
FAN
FCP
Fabric address notification.
A standard Fibre Channel protocol used to run SCSI over Fibre
Channel.
fiber
Physical media types supported by the Fibre Channel specification,
such as optical fiber, twisted pair, and coaxial cable.
Fibre Channel
Integrated set of standards recognized by ANSI which defines
point-to-point serial data channel, structured for high performance.
g-5
P/N 620-000134-500
McDATA OPENconnectors Command Line Interface USER MANUAL
Download from Www.Somanuals.com. All Manuals Search And Download.
Glossary
Fibre Channel
Address
There are two types of Fibre Channel addresses:
•
An address for a public device, comprised of the domain ID, port
address, and its AL_PA
•
An address for a private device, comprised of 0000 followed by its
AL_PA.
In both cases, the Fibre Channel address is represented as a six-digit
hexadecimal string.
field-replaceable unit
firmware
An assembly removed and replaced in its entirety when any one of its
components fails.
The embedded program code that resides and executes on, for
example, directors, switches, and hubs.
FL_Port
Fabric Port currently operating in Arbitrated Loop. Only the
Sphereon 4500 Switch supports the operation of Arbitrated Loop.
FX_Port
A port configuration allowing a port to transition operationally to
either an F_Port or an FL_Port. Only the Sphereon 4500 Switch
supports the configuration of this port type.
FRU
See field-replaceable unit.
G
G_Port
See generic port.
gateway
A multi-homed host used to route network traffic from one network
to another, and to pass network traffic from one protocol to another.
gateway address
A unique string of numbers (in the format xxx.xxx.xxx.xxx) that
identifies a gateway on the network.
Gbps
Gigabits per second.
generic port
Also known as G_Port. Physical interface on a director that can
depending on the port type to which it connects.
g-6
McDATA OPENconnectors Command Line Interface USER MANUAL
Download from Www.Somanuals.com. All Manuals Search And Download.
P/N 620-000134-500
Glossary
Gx_Port
A port configuration allowing a port to transition operationally to
FL_Port as well as to the port operational states described for a
G_Port. Only the Sphereon 4500 Switch supports the configuration of
this port type.
H
hop
Data transfer from one node to another node.
hop count
hub
The number of hops a unit of information traverses in a fabric.
In Fibre Channel, a device that connects nodes into a logical loop by
using a physical star topology.
I
information message
A message telling a user that a function is performing normally or has
completed normally. See also error message; warning message.
initial program load
Process of initializing the device and causing the operating system to
start. Initiated through a menu in the Product Manager, this option
performs a hardware reset on the active CTP only.
interface
Hardware, software, or both, linking systems, programs, or devices.
Internet protocol
address
A unique string of numbers (in the format xxx.xxx.xxx.xxx) that
identifies a device on a network.
interoperability
The ability to communicate, execute programs, or transfer data
between various functional units over a network.
interswitch link
Also known as ISL. Physical E_Port connection between two directors
in a fabric.
IP address
See Internet protocol address.
See initial program load.
See interswitch link.
IPL
ISL
g-7
P/N 620-000134-500
McDATA OPENconnectors Command Line Interface USER MANUAL
Download from Www.Somanuals.com. All Manuals Search And Download.
Glossary
L
LIN
See link incident.
link
link incident
LIPS
Physical connection between two devices on a switched fabric.
Interruption to link due to loss of light or other causes.
Loop Initialization Primitives.
loopback test
Test that checks attachment or control unit circuitry, without checking
the mechanism itself, by returning the output of the mechanism as
input.
M
managed product
A hardware product that can be managed by the CLI. This usually
refers to the switch or director that has an established connection to
the telnet client. For example, the Intrepid 6064 is a managed product.
See also device.
multiswitch fabric
A Fibre Channel fabric created by linking more than one director or
fabric switching device within a fabric.
N
N_Port
See node port.
name server
(1) In TCP/IP, a program that translates names from one form into
another. Domain name servers (DNS) translate domain names into IP
addresses. (2) In Fibre Channel, a server that allows N_Ports to
register information about themselves. This information allows
N_Ports to discover and learn about one another by sending queries
to the Name Server.
network. The network address can be either an IP address in
dotted-decimal notation containing four three-digit octets in the
g-8
McDATA OPENconnectors Command Line Interface USER MANUAL
Download from Www.Somanuals.com. All Manuals Search And Download.
P/N 620-000134-500
Glossary
format xxx.xxx.xxx.xxx), or a domain name (as administered on a
customer network).
node
In Fibre Channel terminology, node refers to an end device (server or
storage device) that is or can be connected to a switched fabric.
node port
Physical interface within an end device which can connect to an
F_Port on a switched fabric or directly to another N_Port (in
point-to-point communications).
O
offline sequence
The sequence sent by the transmitting port to indicate that it is offline.
See offline sequence.
OLS
operating state
(director)
The operating states are described as follows:
Online - when the director is set online, an attached device can
log in to the director if the port is not blocked. Attached devices
can communicate with each other if they are configured in the
same zone.
Offline - when the director is set offline, all ports are set offline.
The director transmits the offline sequence (OLS) to attached
devices, and the devices cannot log in to the director.
operating state (port)
Valid states are:
•
•
•
•
•
•
Online, offline, or testing.
Beaconing.
Invalid attachment.
Link incident or link reset.
No light, not operational, or port failure.
Segmented E_Port.
connector
optical fibers or bundles and is designed to be repeatedly connected
and disconnected.
g-9
P/N 620-000134-500
McDATA OPENconnectors Command Line Interface USER MANUAL
Download from Www.Somanuals.com. All Manuals Search And Download.
Glossary
out-of-band
management
Transmission of management information using frequencies or
channels other than those routinely used for information transfer.
P
password
Unique string of characters known to the computer system and to a
user who must specify it to gain full or limited access to a system and
to the information stored within it.
path
port
In a network, any route between any two ports.
Receptacle on a device to which a cable leading to another device can
be attached.
port card
Field-replaceable hardware component that provides the port
connections for fiber cables and performs specific device-dependent
logic functions.
port name
Name that the user assigns to a particular port through the Product
Manager.
preferred domain ID
Domain ID that a switch is assigned by the principal switch in a
switched fabric. The preferred domain ID becomes the active domain
ID except when configured otherwise by the user.
principal switch
In a multiswitch fabric, the switch that allocates domain IDs to itself
and to all other switches in the fabric. There is always one principal
switch in a fabric. If a switch is not connected to any other switches, it
acts as its own principal switch.
Product Manager
The EFCM application that implements the management user
interface for the director or switch.
R
redundancy
Performance characteristic of a system or product whose integral
components are backed up by identical components to which
g-10
McDATA OPENconnectors Command Line Interface USER MANUAL
Download from Www.Somanuals.com. All Manuals Search And Download.
P/N 620-000134-500
Glossary
operations will automatically failover in the event of a component
failure. Redundancy is a vital characteristic of virtually all
high-availability (24 hr./7 days per week) computer systems and
networks.
resource allocation
time out value
R_A_TOV is a value used to time out operations that depend on the
maximum possible time that a frame could be delayed in a fabric and
still be delivered.
S
SAN
See storage area network.
SANpilot interface
With director firmware Version 1.2 (or later) installed, administrators
or operators with a browser-capable PC and an Internet connection
can monitor and manage the director through an embedded web
server interface, called the SANpilot interface. The interface provides
a GUI similar to the Product Manager application, and supports
director configuration, statistics monitoring, and basic operation.
SBAR
See serial crossbar assembly.
segmented E_Port
An E_Port that has ceased to function as an E_Port within a
multiswitch fabric due to an incompatibility between the fabrics that
it joins. See also expansion port.
SEL
System error light.
serial crossbar
assembly
The serial crossbar assembly (SBAR) is responsible for Fibre Channel
frame transmission from any director port to any other director port.
Connections are established without software intervention.
Simple Network
Management
Protocol
A protocol that specifies a mechanism for network management that
is complete, yet simple. Information is exchanged between agents,
which are the devices on the network being managed, and managers,
which are the devices on the network through which the
management is done.
g-11
P/N 620-000134-500
McDATA OPENconnectors Command Line Interface USER MANUAL
Download from Www.Somanuals.com. All Manuals Search And Download.
Glossary
SNMP community
Also known as SNMP community string. SNMP community is a
cluster of managed products (in SNMP terminology, hosts) to which
the server or managed product running the SNMP agent belongs.
SNMP community
name
The name assigned to a given SNMP community. Queries from an
SNMP management station to a device running an SNMP agent will
only elicit a response if those queries are addressed with the correct
SNMP community name.
storage area network
subnet mask
A high-performance data communications environment that
interconnects computing and storage resources so that the resources
can be effectively shared and consolidated.
Used by a computer to determine whether another computer with
which it needs to communicate is located on a local or remote
network. The network mask depends upon the class of networks to
which the computer is connecting. The mask indicates which digits to
look at in a longer network address and allows the router to avoid
handling the entire address.
switch priority
Value configured into each switch in a fabric that determines its
relative likelihood of becoming the fabric’s principal switch.
T
topology
The logical, physical, or both arrangement of stations on a network.
trap
The unsolicited notification of an event originating from a SNMP
managed device and directed to an SNMP network management
station.
U
UPM
See universal port module.
contains four generic ports (G_Ports).
g-12
McDATA OPENconnectors Command Line Interface USER MANUAL
Download from Www.Somanuals.com. All Manuals Search And Download.
P/N 620-000134-500
Glossary
W
warning message
Indication that a possible error has been detected. See also error
message; information message.
world wide name
WWN
Eight byte identifier uniquely assigned to a switch or to a node (end
device), even on global networks.
See world wide name.
Z
zone
A set of devices that can access one another. All connected devices
may be configured into one or more zones. Devices in the same zone
can see each other. Those devices that occupy different zones cannot.
zone member
The specification of a device to be included in a zone. A zone member
can be identified by the port number of the director to which it is
attached or by its world-wide name. In multiswitch fabrics,
identification of end-devices and nodes by world-wide name is
preferable.
zone set
zoning
A collection of zones that may be activated as a unit.
Grouping of several devices by function or by location. All devices
connected to a connectivity product, such as the director, may be
configured into one or more zones. See also zone.
g-13
P/N 620-000134-500
McDATA OPENconnectors Command Line Interface USER MANUAL
Download from Www.Somanuals.com. All Manuals Search And Download.
Glossary
g-14
McDATA OPENconnectors Command Line Interface USER MANUAL
Download from Www.Somanuals.com. All Manuals Search And Download.
P/N 620-000134-500
Index
character set 2-2
Symbols
" 1-10
# 1-16
class 2 counters 2-59
CLI 1-2
.. 1-8
ED-5000 Director 1-17
help 1-15
logging in or out 1-11
lost 2-57
? 1-15
Numerics
80-column output 1-10
navigation conventions 1-3
output 1-10
parameters 1-10
purpose 1-2
root> prompt 1-8
using 1-2
A
access rights
administrator, setting 2-26
operator, setting 2-27
relationship to other products 1-12
active zoning configuration 2-54
commaDelim command 1-13
command line interface 1-2
ED-5000 1-17
B
help 1-15
backslash 1-10
bbCredit 2-32
beaconing, unit 2-56
blocked state for port 2-7
buffer-to-buffer credit 2-32
logging in or out 1-11
lost 2-57
navigation conventions 1-3
parameters 1-10
purpose 1-2
root> prompt 1-8
C
cable, replacing 1-18
case sensitivity 1-3
i-1
P/N 620-000134-500
McDATA OPENconnectors Command Line Interface USER MANUAL
Download from Www.Somanuals.com. All Manuals Search And Download.
Index
using 1-2
enabling Telnet 1-18
enabling Telnet 1-18
command tree 1-5
Enterprise Fabric Mode
commands
setting 2-3
asynchronous 1-3
config 2-2
error light, system, clearing 2-57
escape character 1-10
ED-5000 1-17
ethernet attributes 2-70
login 1-11
logout 1-12
maint 2-55
ethernet connection, loss of 1-18
event log 2-67
perf 2-59
periods in 1-3
show 2-67
F
commands that take effect immediately 2-14, 2-44
commenting scripts 1-16
config command 2-2
connection loss, ethernet 1-18
conventions
documentation 1-3
navigation 1-3
used in manual xii
F_port, setting 2-12
Fabric Binding
active configuration
show 2-18
pending configuration
activate 2-14
replace 2-17
show 2-19
security 2-14
fabric binding
show 2-83
state 2-17
fabric membership list
D
date and time, system 2-41
default values, resetting 2-58
default zone 2-44
add 2-15
clear 2-16
delete 2-16
directors, See switches
documentation conventions 1-3
documentation, related x
domain ID, port member
adding 2-49
feature
list 2-68
SANtegrity 2-3
show 2-68
deleting 2-51
feature keys 2-4
resetting 2-58
ficonms 2-3
E
e_d_tov 2-33
E_port, setting 2-12
ED-5000 Director 1-17
EFCM 1-2
FRU information 2-69
i-2
McDATA OPENconnectors Command Line Interface USER MANUAL
Download from Www.Somanuals.com. All Manuals Search And Download.
P/N 620-000134-500
using this x
McDATA
G
G_port, setting 2-12
ordering xiii
technical support xii
web site x
H
membership list
help command 1-15
help, technical support xii
history log 1-9
clearing 1-9
fabric 2-15, 2-16
N
names, for ports 2-10
faster methods 1-9
limitations 1-9
I
inactive state reasons 2-80
insistent Domain ID
state
navigation conventions 1-3
state 2-33
interactive interfaces 1-2
interoperability mode 2-34
IPL 2-57
null strings 1-10
NV-RAM configuration parameters, resetting
2-58
O
Open Systems Management Server 2-4
operator access, setting 2-27
ordering product publications xiii
OSMS state 2-4
K
keys
resetting 2-58
output 1-10
order of displayed values 1-8
L
Latin-1 character set 2-2
link counters 2-64
logging in 1-11
P
parameters 1-10
perf command 2-59
performance services 2-59
port beaconing, port 2-55
port binding 2-84
port binding state 2-20
port error counters 2-62
port link counters 2-64
port nodes 2-77
logging out 1-11
login command 1-11
globally available 1-5
login server 2-71
logout command 1-12
globally available 1-5
M
maint command 2-55
manual
port number, zone member
adding 2-49
conventions xii
i-3
P/N 620-000134-500
McDATA OPENconnectors Command Line Interface USER MANUAL
Download from Www.Somanuals.com. All Manuals Search And Download.
Index
deleting 2-51
root> prompt 1-8
port statistics, resetting 2-62
port status 2-79
S
ports
SANpilot 1-2
SANtegrity
Enterprise Fabric Mode 2-3
bbCredit 2-32
scripting environments 1-2
scripts, commenting 1-16
setting online or offline 2-58
show commands
error counters 2-62
link counters 2-64
name 2-10
port beaconing 2-55
port information 2-76
port statistics 2-62
resetting 2-56
speed 2-11
statistics, clearing 2-62
ethernet attributes 2-70
event log 2-67
fabric binding 2-83
features 2-5
features list 2-68
FRU information 2-69
order of output 1-8
port binding for all ports 2-84
port configuration 2-75
port information 2-76
port nodes 2-77
port status 2-79
show branch 2-67
status 2-79
traffic counters 2-65
type 2-12
WWN, binding 2-21
pound sign 1-16
preferred domain ID 2-34
product managers
enabling Telnet 1-18
publications
SNMP configuration 2-31
switch attributes 2-86
switch binding 2-85
related x
updates x
switch configuration 2-39
zoning configuration 2-89
SNMP community
Q
adding 2-29
deleting 2-30
spaces, quotation marks required 1-10
speeds, port 2-11
speeds, switches 2-38
statistics, port, clearing 2-62
R
r_a_tov 2-36
related documentation x
rerouting delay 2-37
root, transitioning through 1-8
i-4
McDATA OPENconnectors Command Line Interface USER MANUAL
Download from Www.Somanuals.com. All Manuals Search And Download.
P/N 620-000134-500
strings, null 1-10
subnet mask 2-6
connection, loss of 1-18
time, system 2-41
Switch Binding
traffic counters 2-65
types, port 2-12
add new member 2-23
configuration 2-23
delete member 2-23
set state 2-24
U
UDP 2-29, 2-31
unit beaconing 2-56
Switch Member List
up-arrow command 1-9
user access rights 1-11
administrator, setting 2-26
operator, setting 2-27
user datagram protocol 2-29, 2-31
using this manual x
show 2-25
switches 2-58
configuring, set offline 2-32
e_d_tov 2-33
event log 2-67
IPL 2-57
W
web site, McDATA x, xiii
work area 2-44
principal 2-35
priority 2-35
r_a_tov 2-36
world-wide name members
adding 2-48
deleting 2-50
wrap count 2-59, 2-60
WWN members
adding 2-48
rerouting delay 2-37
speed 2-38
deleting 2-50
WWN, port binding 2-21
system contact 2-40
system description 2-41
system location 2-42
system name 2-42
Z
zone members
clearing 2-50
domain ID
system contact attribute 2-40
system date and time 2-41
system description 2-41
system location 2-42
system name 2-42
adding 2-49
deleting 2-51
zone set
activating to fabric 2-44, 2-45
clearing 2-46
deactivating 2-45
replacing 2-46
temporary copy 2-44
zones
T
tabular output 1-13
technical support xii
technical support center xii
deleting 2-47
i-5
P/N 620-000134-500
McDATA OPENconnectors Command Line Interface USER MANUAL
Download from Www.Somanuals.com. All Manuals Search And Download.
Index
members
deleting by port 2-51
renaming 2-52
zoning configuration
active, display 2-54
displaying 2-89
pending, display 2-53
zoning, configuring 2-44
i-6
McDATA OPENconnectors Command Line Interface USER MANUAL
P/N 620-000134-500
Download from Www.Somanuals.com. All Manuals Search And Download.
|