User manual

ManualsBrandsEMC ManualsSoftwareSwitch ED-12000B

EMC Corporation

171 South Street

Hopkinton, MA 01748-9103

Corporate Headquarters: (508) 435-1000, (800) 424-EMC2

Fax: (508) 435-5374 Service: (800) SVC-4EMC

EMC Connectrix

Departmental Switch DS-32B2

and Enterprise Director ED-12000B

Fabric OS

Version 4.0.2

REFERENCE MANUAL

P/N 300-000-637

REV A02

Summary of content (574 pages)

PAGE 1
EMC Connectrix Departmental Switch DS-32B2 and Enterprise Director ED-12000B Fabric OS Version 4.0.
PAGE 2
Copyright © 2000 - 2002 EMC Corporation. All rights reserved. Printed November, 2002 EMC believes the information in this publication is accurate as of its publication date. The information is subject to change without notice. THE INFORMATION IN THIS PUBLICATION IS PROVIDED "AS IS." EMC CORPORATION MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND WITH RESPECT TO THE INFORMATION IN THIS PUBLICATION, AND SPECIFICALLY DISCLAIMS IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
PAGE 3
This equipment generates, uses, and may emit radio frequency energy. The equipment has been type tested and found to comply with the limits for a Class A digital device pursuant to Part 15 of FCC rules, which are designed to provide reasonable protection against such radio frequency interference. Operation of this equipment in a residential area may cause interference in which case the user at his own expense will be required to take whatever measures may be required to correct the interference.
PAGE 4
iv EMC Connectrix DS-32B2 and ED-12000B Fabric OS Reference Manual
PAGE 5
Contents Preface.......................................................................................................................... xiii Chapter 1 Telnet Commands agtcfgDefault .................................................................................... 1-8 agtcfgSet .......................................................................................... 1-11 agtcfgShow...................................................................................... 1-15 aliasDelete .................
PAGE 6
Contents cfgEnable......................................................................................... 1-60 cfgRemove ...................................................................................... 1-61 cfgSave............................................................................................. 1-63 cfgShow ........................................................................................... 1-64 cfgTransAbort........................................................................
PAGE 7
Contents fabricShow.................................................................................... fabStatsShow................................................................................ fanDisable..................................................................................... fanEnable ...................................................................................... fanShow ........................................................................................ fastboot ...............
PAGE 8
Contents iodShow ........................................................................................ 1-220 ipAddrSet...................................................................................... 1-221 ipAddrShow ................................................................................. 1-224 islShow .......................................................................................... 1-226 licenseAdd ..................................................................................
PAGE 9
Contents perfCfgSave.................................................................................. perfClrAlpaCrc ............................................................................ perfDelEEMonitor....................................................................... perfDelFilterMonitor .................................................................. perfHelp........................................................................................ perfSetPortEEMask .........................
PAGE 10
Contents qloopRemove................................................................................ 1-381 qloopShow .................................................................................... 1-383 ramTest .......................................................................................... 1-385 reboot............................................................................................. 1-387 routeHelp ..................................................................................
PAGE 11
Contents syslogdIpShow ............................................................................ systemtest ..................................................................................... tempShow..................................................................................... timeOut ......................................................................................... topologyShow.............................................................................. trackChangesSet ...............
PAGE 12
Contents Chapter 5 Control Processor Commands Active CP Commands..................................................................... 5-2 Standby CP Commands.................................................................. 5-3 Appendix A Customer Support Overview of Detecting and Resolving Problems ...................... A-2 Troubleshooting the Problem ....................................................... A-3 Before Calling the Customer Support Center ............................
PAGE 13
Preface As part of its effort to continuously improve and enhance the performance and capabilities of the EMC product line, EMC periodically releases new versions of the EMC Connectrix Departmental Switch DS-32B2 and Enterprise Director ED-12000B Fabric OS. Therefore, some functions described in this guide may not be supported by all versions of Fabric OS currently in use. For the most up-to-date information on product features, see the product release notes.
PAGE 14
Preface Chapter 3, Fabric OS Version Comparison, summarizes the commands available in v3.0 and v4.0. Chapter 4, Fabric and Switch Management, explains the different methods used to manage a SAN for DS-32B2 and ED-12000B switches. Chapter 5, Control Processor Commands, lists the commands available when logged into the Active CP and Standby CP in an ED-12000B.
PAGE 15
Preface Conventions Used in this Guide EMC uses the following conventions for notes, cautions, warnings, and danger notices. A note presents information that is important, but not hazard-related. ! CAUTION A caution contains information essential to avoid data loss or damage to the system or equipment. The caution may apply to hardware or software.
PAGE 16
Preface Courier System prompts and displays and specific filenames or complete paths. For example: working root directory [/user/emc]: c:\Program Files\EMC\Symapi\db Where to Get Help Courier, bold User entry. For example: AVANT GARDE Keystrokes symmpoll -p Obtain technical support by calling your local sales office. For service, call: United States: (800) 782-4362 (SVC-4EMC) Canada: (800) 543-4782 (543-4SVC) Worldwide: (508) 497-7901 and ask for Customer Support.
PAGE 17
1 Invisible Body Tag Telnet Commands This chapter describes the following commands: ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ agtcfgDefault ......................................................................................1-8 agtcfgSet ............................................................................................ 1-11 agtcfgShow........................................................................................1-15 aliasDelete ...........................................
PAGE 18
Telnet Commands 1 ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ 1-2 cfgRemove ........................................................................................ 1-61 cfgSave............................................................................................... 1-63 cfgShow ............................................................................................. 1-64 cfgTransAbort.....................................................................
PAGE 19
Telnet Commands ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ fabStatsShow .................................................................................. 1-146 fanDisable ....................................................................................... 1-147 fanEnable ........................................................................................ 1-148 fanShow ........................................................................................
PAGE 20
Telnet Commands 1 ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ 1-4 ipAddrSet........................................................................................ 1-221 ipAddrShow ................................................................................... 1-224 islShow ............................................................................................ 1-226 licenseAdd ..............................................................................
PAGE 21
Telnet Commands ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ perfClrAlpaCrc .............................................................................. 1-293 perfDelEEMonitor ......................................................................... 1-295 perfDelFilterMonitor..................................................................... 1-297 perfHelp ..........................................................................................
PAGE 22
Telnet Commands 1 ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ 1-6 qloopShow ...................................................................................... 1-383 ramTest ............................................................................................ 1-385 reboot ............................................................................................... 1-387 routeHelp ........................................................................
PAGE 23
Telnet Commands ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ timeOut ........................................................................................... 1-459 topologyShow ................................................................................ 1-460 trackChangesSet............................................................................. 1-463 trackChangesShow ........................................................................ 1-465 trunkDebug ............................................
PAGE 24
Telnet Commands 1 agtcfgDefault Reset the SNMP agent configuration to default value. Syntax agtcfgDefault Availability Admin Description Use this command to reset the configuration of the SNMP agent to default values. There is one agent per logical switch. This command is specific to the logical switch you are logged into. ◆ sysDescr — The system description. The default value is Fibre Channel Switch. ◆ sysLocation — The location of the system. The default value is End User Premise.
PAGE 25
Telnet Commands There are six communities and respective trap recipients supported by the agent. The first three communities are for read-write access (rw) and the last three are for read-only access (ro). Note that the factory default value for the trap recipient of each community is "0.0.0.0".
PAGE 26
Telnet Commands 1 Example To set the SNMP agent configuration parameters to the default values, and verify the default values are set: sw5:admin> agtcfgDefault ***** This command will reset the agent’s configuration back to factory default ***** Current SNMP Agent Configuration Customizable MIB-II system variables: sysDescr = Fibre Channel Switch.
PAGE 27
Telnet Commands agtcfgSet Modify the SNMP agent configuration. Syntax agtcfgSet Availability Admin Description Use this command to modify the configuration of the SNMP agent in the switch. Set the values for the following items. There is one agent per logical switch. This command is specific to the logical switch you are logged into. ◆ sysDescr — The system description. The default value is Fibre Channel Switch. ◆ sysLocation — The location of the system. The default value is End User Premise.
PAGE 28
Telnet Commands 1 There are six communities and respective trap recipients supported by the agent. The first three communities are for read-write access (rw) and the last three are for read-only access (ro). Note that the factory default value for the trap recipient of each community is "0.0.0.0".
PAGE 29
Telnet Commands sysDescr: [FC Switch] sysLocation: [End User Premise] sysContact: [Field Support] swEventTrapLevel: (0..5) [0] 3 authTrapsEnabled (true, t, false, f): [false] t SNMP community and trap recipient configuration: Community (rw): [Secret C0de] Trap Recipient’s IP address in dot notation: [192.168.1.51] Community (rw): [OrigEquipMfr] Trap Recipient’s IP address in dot notation: [192.168.1.26] Community (rw): [private] Trap Recipient’s IP address in dot notation: [0.0.0.0] 192.168.64.
PAGE 30
Telnet Commands 1 No trap Community No trap Community No trap Community No trap Community No trap recipient configured 3: private (rw) recipient configured 4: public (ro) recipient configured 5: common (ro) recipient configured 6: FibreChannel (ro) recipient configured yet yet yet yet yet SNMP access list configuration: Entry 0: No access host configured Entry 1: No access host configured Entry 2: No access host configured Entry 3: No access host configured Entry 4: No access host configured Entry 5: No
PAGE 31
Telnet Commands agtcfgShow Display the SNMP agent configuration. Syntax agtcfgShow Availability All users Description Use this command to display the configuration of the SNMP agent in the switch. The following information is displayed: There is one agent per logical switch. This command is specific to the logical switch you are logged into. ◆ sysDescr — The system description. The default value is Fibre Channel Switch. ◆ sysLocation — The location of the system.
PAGE 32
Telnet Commands 1 The factory default value for the trap recipient of each community is "0.0.0.0". The factory default values for the community strings are: Community 1: Secret Code Community 2: OrigEquipMfr Community 3: private Community 4: public Community 5: common Community 6: FibreChannel In order for an SNMP Management Station to receive a trap generated by the agent, the administrator must configure a trap recipient value to correspond to the IP address of the Management Station.
PAGE 33
Telnet Commands Community 5: common (ro) No trap recipient configured yet Community 6: FibreChannel (ro) No trap recipient configured yet SNMP access list configuration: Entry 0: Access host subnet area 192.168.64.0 (rw)] Entry 1: Access host subnet area 192.168.1.
PAGE 34
Telnet Commands 1 aliasDelete Delete a port from all local groups. Syntax aliasDelete portID Availability Admin Description Use this command to delete a local port from all local groups. The group is deleted if it becomes empty after deleting the local port. Use the aliasShow command to show the existing groups with their corresponding N_Ports. Operands This command has the following operand: Specify in hexadecimal the port ID to be deleted from an alias group. This operand is required.
PAGE 35
Telnet Commands aliasJoin Create or add a member to a group of N_Ports. Syntax aliasJoin Availability Admin Description Use this command to create an alias group of N_Ports or to add N_Ports to an existing group. Any online N_Port defined in the fabric can be part of a group. An N_Port can be added from any switch that is part of the fabric. To get a list of online ports currently defined in the fabric, use the nsAllShow command.
PAGE 36
Telnet Commands 1 See Also 1-20 aliasShow aliasDelete aliasPurge EMC Connectrix DS-32B2 and ED-12000B Fabric OS Reference Manual
PAGE 37
Telnet Commands aliasPurge Remove an alias group. Syntax aliasPurge groupID Availability Admin Description Use this command to remove an alias group. The alias group must be identified by its hexadecimal value. Operands This command has the following operand: groupID Example Specify in hexadecimal the alias group to be removed. This operand is required.
PAGE 38
Telnet Commands 1 aliasShow Display alias server information. Syntax aliasShow Availability All users Description Use this command to display local alias server information. If there is no local alias group, the following message is displayed: There is no entry in the Local Alias Server. If there are multiple entries in the local alias group, they are displayed.
PAGE 39
Telnet Commands Example To display the entries in the local alias server: switch:admin> aliasShow Alias ID Creator Token [rb, type, grptype, qlfr] Member List fffb01 fffffd [00, 05, 10, 10000060 69800228] { 019c00 } The Local Alias Server has 1 entry switch:admin> Exit Status 0 Non Zero See Also Indicates successful operation. Indicates that the operation has failed.
PAGE 40
Telnet Commands 1 aliAdd Add a member to a zone alias. Syntax aliAdd aliName, member; member Availability Admin Description Use this command to add one or more members to an existing zone alias. The alias member list cannot contain another zone alias. This command changes the Defined Configuration. For the change to be preserved across switch reboots, it must be saved to non-volatile memory using the cfgSave command.
PAGE 41
Telnet Commands aliCreate Create a zone alias. Syntax aliCreate aliName, member; member Availability Admin Description Use this command to create a new zone alias. The zone alias member list must have at least one member (empty lists are not allowed). The alias member list cannot contain another zone alias. Zone Alias members can be specified using the Area number to represent a specific port and slot combination. Area numbers are automatically assigned to a port by the Fabric OS.
PAGE 42
Telnet Commands 1 Example To add zone aliases using member names: switch:admin> aliCreate "array1", "32; 33; 34" switch:admin> aliCreate "array2", "21:00:00:20:37:0c:66:23" switch:admin> aliCreate "loop1", "0x02; 0xEF; 5,4" See Also 1-26 aliAdd aliDelete aliRemove aliShow EMC Connectrix DS-32B2 and ED-12000B Fabric OS Reference Manual
PAGE 43
Telnet Commands aliDelete Delete a zone alias. Syntax aliDelete aliName Availability Admin Description Use this command to delete a zone alias. This command changes the defined configuration. For the change to become effective, an appropriate zone configuration must be enabled using the cfgEnable command. For the change to be preserved across switch reboots, it must be saved to flash memory using the cfgSave command. This command requires a Zoning License.
PAGE 44
Telnet Commands 1 aliRemove Remove a member from a zone alias. Syntax aliRemove aliName, member; member Availability Admin Description Use this command to remove one or more members from an existing zone alias. If all members are removed, the zone alias is deleted. This command changes the defined configuration. For the change to become effective, an appropriate zone configuration must be enabled using the cfgEnable command.
PAGE 45
Telnet Commands Example To remove a member from array1: switch:admin> aliRemove "array1", "3,5" switch:admin> aliRemove "array1", "21:00:00:20:37:0c:76:8c" switch:admin> aliRemove "array1", "0xEF" See Also aliAdd aliCreate aliDelete aliShow aliRemove 1-29 1
PAGE 46
Telnet Commands 1 aliShow Display zone alias information. Syntax aliShow "pattern" Availability All users Description Use this command to display zone configuration information. If no parameters are specified, all zone configuration information (both defined and enabled) is displayed. See cfgShow for a description of this display. If a parameter is specified, it is used as a pattern to match zone alias names; those that match in the defined configuration are displayed.
PAGE 47
Telnet Commands Example To show all zone aliases beginning with arr: switch:admin> aliShow "arr*" alias: array1 21:00:00:20:37:0c:76:8c alias: array2 21:00:00:20:37:0c:66:23 See Also aliAdd aliCreate aliDelete aliRemove aliShow 1-31 1
PAGE 48
Telnet Commands 1 backplanetest Run Backplane connection test for multiple blade configured system. Syntax Availability Admin Description Use this command to verify the function of the backplane connection of the blades through the back-end external ports. This command is for the ED-12000B only. This command is not part of blade diagnostics; it is used to verify backplane connection by using the blade’s frame transmitter/receiver features.
PAGE 49
Telnet Commands -pat type Specify the test pattern type used in the test frame payload. The default test is 17(jCRPAT). The following test patterns can be specified: • • • • • • • • • • • • • • • • • • • -ports list 1 byte fill 2 word fill 3 quad fill 4 byte not 5 word not 6 quad not 7 byte ramp 8 word ramp 9 quad ramp 10 byte lfsr 11 random 12 crpat 13 cspat 14 chalf sq 15 cqtr sq 16 rdram pat 17 jCRPAT (default) 18 jCJTPAT 19 jCSPAT Specify the blade port number(s).
PAGE 50
Telnet Commands 1 Example To run a backplane connection test: switch:admin> backplanetest -ports 2/16 2/18 2/20 -payload 2048 -verbose 1 Running Backplane Conn Test ..... Test frame info for Backplane Connection Test: # of frames: 1 sid data: 0xfffffd did data: 0xfffffd payload size: 2048 bytes passed. Test Complete: "backplanetest" Pass 1 of 1 Duration 0 hr, 0 min & 1 sec (0:0:1:705).
PAGE 51
Telnet Commands backPort Run test for back-end miniswitch-to-miniswitch links. Syntax backport [-nframes num][-ports list][-lb_mode mode][-fr_type type] [-extonly enable] Availability Admin Description Use this command to test the backplane routing and VC allocation. This test applies to single blade as well as multi-blade systems. The following items are tested: ◆ Proper back-end port domain routing setup such that every user port has a valid path to every other user port.
PAGE 52
Telnet Commands 1 -lb_mode mode Specify the loopback mode for source and destination standard meanings. The default mode is 5. The valid modes are: • • • • -fr_type type 0 1 2 5 cable loopback plug loopback external loopback (SERDES) internal loopback (ASIC) Specify the frame types to send. The default type is 1. The valid types are: • 0 single frame • 1 spinFab frames • 2 spinFab 1 K frames -extonly enable Specify 1 to enable external-test-only mode. The default value is 0.
PAGE 53
Telnet Commands Example To test for back-end miniswitch to miniswitch links: switch:admin> backport Running Backport Test .....
PAGE 54
Telnet Commands 1 bcastshow Display broadcast routing information. Syntax bcastShow Availability All users Description Use this command to display the broadcast routing information for all ports in the switch. The broadcast routing information indicates all ports that are members of the broadcast distribution tree that is, ports that are able to send and receive broadcast frames. Normally, all F_Ports and FL_Ports are members of the broadcast distribution tree.
PAGE 55
Telnet Commands See Also mcastShow portRouteShow bcastshow 1-39 1
PAGE 56
Telnet Commands 1 bladeBeacon Set blade beaconing mode on or off. Syntax bladeBeacon [blade] mode Availability Admin Description Use this command to set the blade beaconing mode on or off. Specify mode 1 to enable beaconing mode, or specify mode 0 to disable beaconing. When beaconing mode is enabled, the port LEDs will flash amber in a running pattern from port 0 through port 15 and back again. The pattern continues until the user turns it off. This can be used to locate a physical unit.
PAGE 57
Telnet Commands Example To turn the blade in slot 2 beaconing mode On and then Off: switch:admin> bladeBeacon 2 1 See Also switchShow bladeBeacon 1-41 1
PAGE 58
Telnet Commands 1 bladeDiag Run diagnostics on a switch blade. Syntax bladediag [[-slot] slot] Availability Admin Description Use this command to run a suite of diagnostics tests on the specified switch blade. To run this command you must install loopback plugs on every port.
PAGE 59
Telnet Commands Example To run a suite of diagnostics on blade 7: switch:admin> bladediag -slot 7 Testing slot: 7, user ports: 3 2 1 0 7 6 5 4 11 10 9 8 15 14 13 12 PortRegTest Running Port Register Test .... passed. Test Complete: "portregtest" Pass 1 of 1 Duration 0 hr, 2 min & 23 sec (0:2:23:443). passed. Test return status: 0 CentralMemoryTest Running centralmemorytest ............ passed. Test Complete: "centralmemorytest" Pass 1 of 1 Duration 0 hr, 0 min & 19 sec (0:0:19:611). passed.
PAGE 60
Telnet Commands 1 bladeDiagShort Run diagnostics on a switch blade. Syntax bladediagshort [[-slot] slot] Availability Admin Description Use this command to run a suite of diagnostics tests on the specified switch blade. To run this command you must install loopback plugs on every port.
PAGE 61
Telnet Commands Example To run a suite of diagnostics on blade 7: switch:admin> bladediagshort -slot 7 Testing slot: 7, user ports: 3 2 1 0 7 6 5 4 11 10 9 8 15 14 13 12 PortRegTest Running Port Register Test .... passed. Test Complete: "portregtest" Pass 1 of 1 Duration 0 hr, 2 min & 23 sec (0:2:23:443). passed. Test return status: 0 CentralMemoryTest Running centralmemorytest ............ passed. Test Complete: "centralmemorytest" Pass 1 of 1 Duration 0 hr, 0 min & 19 sec (0:0:19:611). passed.
PAGE 62
Telnet Commands 1 bladePropShow Display blade property. Syntax bladePropShow [[-slot] slot] Availability All users Description Use this command to display the properties of a blade. Operands This command has the following operand: -slot slot Example Specify the slot number of the blade you which you want to run diagnostics. This operand is optional.
PAGE 63
Telnet Commands camTest To test the functionality of Content Addressable Memory (CAM). Syntax camtest [-passcnt count][-txport list] Availability Admin Description Use this command to verify that Content Addressable Memory (CAM) is functionally correct. The CAM is used by QuickLoop to translate the SID. When a CAM is presented with a data, it checks if the data is present in its memory. A hit means the data is found in the CAM. A miss means the data is not found.
PAGE 64
Telnet Commands 1 Example To verify that Content Addressable Memory (CAM) is functioning correctly: switch:admin> camTest Running CAM Test .............. Test Completed: "camtest" Pass 1 of 1. Duration 0 hr, 0 min & 58 sec (0:0:58:796) passed.
PAGE 65
Telnet Commands centralMemoryTest Perform a bit write/read test of the ASIC central memory. Syntax centralMemoryTest [passCount, dataType, dataSeed] Availability Admin Description Use this command to verify the address and data bus of the ASIC SRAMs that serve as the central memory. This command may not be executed on an enabled switch. You must first disable the switch using the switchDisable command.
PAGE 66
Telnet Commands 1 Subtest 3 is not available on 2 G based switches. The test method is as follows: 1. Fill the Central Memory of all ASICs with unique frames. 2. Set up the hardware such that each ASIC is read by all of the MAX number of ports in the switch. Data received is compared against the frame written into the ASIC.
PAGE 67
Telnet Commands Subtest 5 The forced bad buffer number error subtest verifies that the bad buffer number in the data packet can be detected, its error flag and interrupt bits are set. The test method is as follows: 1. Clear the error and interrupt bits of all ASICs. 2. Set up the hardware so that transmission of data includes a bad buffer number. 3. For each ASIC X in the switch, do: For each of the 11 possible offsets, do: a. Write a 64 byte pattern in the Central Memory. b.
PAGE 68
Telnet Commands 1 c. Check that all ASIC Y has its: – interrupt bits are set. – error type is chip number error. – the port number in error is the receiver port (which is the base port of asic Y). d. Reading the error register clears the CMEM interrupt bit; ready for the next offset to test. Operands This command has the following operands. If all are omitted, the default values used are 1 for passCount,QUAD_RAMP for dataType, and a random value for dataSeed.
PAGE 69
Telnet Commands Diagnostics When this command detects failure(s), each subtest may report one or more of the following error messages: Subtest 2 0x20 LCMEM_ERR 0x22 LCMRS_ERR 0x23 LCMTO_ERR Subtest 3 0x2c CM_NO_BUF 0x24 LCMTO_ERR 0x22 LCMRS_ERR 0x21 LCMEMTX_ERR Subtest 4 0x2e TIMEOUT 0x26 BAD_INT 0x28 CM_ERR_TYPE 0x29 CM_ERR_PTN Subtest 5 0x2e TIMEOUT 0x26 BAD_INT 0x28 CM_ERR_TYPE 0x29 CM_ERR_PTN Subtest 6 0x2e TIMEOUT 0x26 BAD_INT 0x28 CM_ERR_TYPE 0x29 CM_ERR_PTN See Also camTest cmemRetentionTest cmiT
PAGE 70
Telnet Commands 1 cfgAdd Add a member to a zone configuration. Syntax cfgAdd "cfgName", "member; member" Availability Admin Description Use this command to add one or more members to an existing zone configuration. This command changes the Defined Configuration. For the change to be preserved across switch reboots, it must be saved to non-volatile memory using the cfgSave command. For the change to become effective, an appropriate zone configuration must be enabled using the cfgEnable command.
PAGE 71
Telnet Commands cfgClear Clear all zone configurations. Syntax cfgClear Availability Admin Description This command clears all zone information in the transaction buffer. All defined zone objects in the transaction buffer are deleted. If you attempt to commit the empty transaction buffer while a zone configuration is enabled, a warning displays, to first disable the enabled zone configuration or to provide a valid configuration with the same name.
PAGE 72
Telnet Commands 1 cfgCreate Create a zone configuration. Syntax cfgCreate "cfgName", "member; member" Availability Admin Description Use this command to create a new zone configuration. A zone configuration name must begin with a letter and can be followed by any number of letters, digits, and underscore characters. Names are case-sensitive, for example Cfg_1 and cfg_1 are different zone configurations. Blank spaces are ignored.
PAGE 73
Telnet Commands Example To create a configuration containing three zones: switch:admin> cfgCreate "Test_cfg", "redzone; bluezone; greenzone" See Also cfgAdd cfgClear cfgDelete cfgDisable cfgEnable cfgRemove cfgSave cfgShow cfgCreate 1-57 1
PAGE 74
Telnet Commands 1 cfgDelete Delete a zone configuration. Syntax cfgDelete cfgName Availability Admin Description Use this command to delete a zone configuration. This command changes the defined configuration. For the change to become effective, an appropriate zone configuration must be enabled using the cfgEnable command. For the change to be preserved across switch reboots, it must be saved to flash memory using the cfgSave command. This command changes the Defined Configuration.
PAGE 75
Telnet Commands cfgDisable Disables an effective zone configuration. Syntax cfgDisable Availability Admin Description Use this command to disable the current zone configuration. The fabric returns to nonzoning mode where all devices see each other. It also commits the zone configuration in the transaction buffer to volatile and nonvolatile memory. This command ends the current zoning transaction.
PAGE 76
Telnet Commands 1 cfgEnable Enables a zone configuration. Syntax cfgEnable cfgName Availability Admin Description This command commits the zone configuration in the transaction buffer to the volatile and nonvolatile memory and enables the specified zone configuration. This command ends the current zoning transaction.
PAGE 77
Telnet Commands cfgRemove Remove a member from a zone configuration. Syntax cfgRemove "cfgName", "member; member" Availability Admin Description Use this command to remove a member from an existing zone configuration. The member list is located by an exact string match, therefore, it is important to maintain the order when removing multiple members. For example, if a zone configuration contains cfg2; cfg3; cfg4 then removing cfg3; cfg4 succeeds, but removing cfg4; cfg3 fails.
PAGE 78
Telnet Commands 1 Example To remove a zone from a configuration: switch:admin> cfgRemove "Test_cfg", "redzone" See Also 1-62 cfgAdd cfgClear cfgCreate cfgDelete cfgDisable cfgEnable cfgSave cfgShow cfgTransAbort EMC Connectrix DS-32B2 and ED-12000B Fabric OS Reference Manual
PAGE 79
Telnet Commands cfgSave Save zone configuration to flash memory. Syntax cfgSave Availability Admin Description Use this command to save the current zone configuration. The defined configuration and the name of the enabled configuration are written to flash memory in all switches in the fabric.
PAGE 80
Telnet Commands 1 cfgShow Display zone configuration information. Syntax cfgShow ["pattern"[, transflag] Availability All users Description Use this command to display zone configuration information. If no operand is specified, all zone configuration information (both defined and enabled) is displayed. If an operand is specified, it is used as a pattern to match zone configuration names in the defined configuration; those that match the pattern are displayed.
PAGE 81
Telnet Commands Operands This command has the following operands: "pattern" Specify a POSIX-style regular expression enclosed in quotation marks and used to match zone configuration names. Patterns can contain: Question mark (?) that matches any single character. ◆ Asterisk (*) that matches any string of characters. ◆ Ranges that match any character within the range. For example, [0-9] or [a-f]. This operand is optional.
PAGE 82
Telnet Commands 1 To show only configuration names: switch:admin> cfgShow "*" cfg: Test1bluezone cfg: Test_cfgredzone; blue_zone See Also 1-66 cfgAdd cfgClear cfgCreate cfgDelete cfgDisable cfgEnable cfgRemove cfgSave EMC Connectrix DS-32B2 and ED-12000B Fabric OS Reference Manual
PAGE 83
Telnet Commands cfgTransAbort Abort the current zoning transaction. Syntax cfgTransAbort Availability Admin Description Use this command to abort the current zoning transaction without committing it. All changes made since the transaction was started are removed and the zone configuration database restored to the state before the transaction was started. If a transaction is open on a different switch in the fabric when this command is run, the transaction on the other switch remains open.
PAGE 84
Telnet Commands 1 cfgTransShow Print information about the current transaction. Syntax cfgTransShow Availability Admin Description Use this command to show the ID of the current transaction. It will indicate whether or not the transaction is abortable. The transaction is not abortable if it is an internal zoning transaction.
PAGE 85
Telnet Commands chassisName Display or set the chassis name for an ED-12000B. Syntax Availability chassisName [name] Admin (set) All users (display) Description Use this command to change the name associated with the chassis ED-12000B. In the ED-12000B, there are two logical switches associated with a single chassis. Enter this command with no parameter to display the current name. Enter this command with a name specified to set the chassis name to the new value.
PAGE 86
Telnet Commands 1 chassisShow Display all field replaceable units (FRUs). Syntax Availabiity Description chassisShow All users Use this command to inventory and display the field replaceable unit (FRU) header content for each object in the chassis. On some platforms for certain FRU types, a few items may not be available. In these cases the lines will be suppressed. Possibly affected are lines 2, 3, 4, 5, 6, 8, and 10 through 13.
PAGE 87
Telnet Commands Table 1-2 Operands ChassisShow Line Numbers (continued) 6 Displays the date the FRU was manufactured. Manufacture: Day:
Month: Year: 7 Displays the date the FRU header was last updated. Update: Day:
Month: Year: 8 Displays cumulative time, in days, that the FRU has been powered on. Time Alive: days 9 Displays the current time, in days, since the FRU was last powered on.
PAGE 88
Telnet Commands 1 Example To display all Field Replaceable Units for a switch: switch12k:admin> chassisShow SW BLADE Slot: 3 Header Version: 1 Power Consume Factor: -180 Brocade Part Num: 60-0001532-03 Brocade Serial Num: 1013456800 Manufacture: Day: 12 Month: Update: Day: 15 Month: Time Alive: 28 days Time Awake: 16 days ID: 555-374757 Part Num: 234-294-12345 Serial Num: 2734658 Revision Num: A.
PAGE 89
Telnet Commands chippropshow Display ASIC chip property contents. Syntax chippropshow [slot/]chip | [slot] -all Availability All users Description Use this command to display the ASIC chip property contents for the specified chip on the specified blade slot. If the slot operand is not specified, then the slot defined using the setslot command is used. Operands Example This command has the following operands: slot Specify the slot number for the blade for which you want to view the chip properties.
PAGE 90
Telnet Commands 1 See Also 1-74 ptpropshow minispropshow EMC Connectrix DS-32B2 and ED-12000B Fabric OS Reference Manual
PAGE 91
Telnet Commands chipregshow Display port registers of a given chip number. Syntax chipregshow [slot/]chip [filter] Availability All users Description Use this command to display the ASIC register contents for the specified chip on the specified blade slot. Operands Example This command has the following operands: slot Specify the slot number of the blade that houses the chip you want to test. chip Specify the index of the chip within the blade to be displayed. filter Specify a filter string.
PAGE 92
Telnet Commands 1 cmemRetentionTest Run data retention test of the central memory SRAMs. Syntax cmemRetentionTest [passCount] Availability Admin Description Use this command to verify for data retention in the central memory SRAMs in the ASIC. This command may not be executed on an enabled switch. You must first disable the switch using the switchDisable command. Operand This command has the following operand: passCount Example Specify the number of times to execute this test.
PAGE 93
Telnet Commands cmiTest Test the quad connections between two ASIC connections. Syntax cmitest [-passcnt passcnt][-txport list][-rxport list][-skip mask] Availability Admin Description Use this command to verify that the multiplexed four-bit Control Message Interface (CMI) point-to-point connection between two ASICs is functioning properly.
PAGE 94
Telnet Commands 1 Errors When it detects failure(s), the subtest may report one or more of the following error messages: DIAG-CMISA1 DIAG-CMINOCAP DIAG-CMICKSUM DIAG-CMIINVCAP DIAG-CMIDATA DIAG-INTNIL DIAG-BADINT See Also 1-78 camTest centralMemoryTest cmemRetentionTest crossPortTest portLoopbackTest portRegTest ramTest spinSilk sramRetentionTest EMC Connectrix DS-32B2 and ED-12000B Fabric OS Reference Manual
PAGE 95
Telnet Commands configDefault Restore system configuration to default settings. Syntax configDefault Availability Admin Description Use this command to reset system configuration to default values.
PAGE 96
Telnet Commands 1 configDownload Download the switch configuration from a host file. Syntax configDownload [host,user,file[,passwd]] Availability Admin Description Use this command to download the switch configuration file from a host system. The configuration file is ASCII text and may have been generated using configUpload, or it may have been created by a user to download specific configuration changes. The download process uses FTP. In Fabric OS v3.0, RSHD protocol is also supported.
PAGE 97
Telnet Commands Operands Example This command has the following operands: host Specify a host name or IP address in quotation marks; for example, "citadel" or "192.168.1.48". The configuration file is downloaded from this host system. This operand is optional. user Specify a username in quotation marks; for example, "jdoe". This username is used to gain access to the host. This operand is optional. file Specify a file name in quotation marks; for example, "config.txt".
PAGE 98
Telnet Commands 1 configShow Display system configuration settings. Syntax configShow ["filter"] Availability All users Description Use this command to view system configuration settings set by the configure command. Operand This command has the following operand: filter Example Specify a text string, in quotation marks, that limits the output of the command to only those entries that contain the text string. This operand is optional.
PAGE 99
Telnet Commands See Also agtcfgShow configure diagDisablePost diagEnablePost ipAddrShow licenseShow syslogdIpShow configShow 1-83 1
PAGE 100
Telnet Commands 1 configUpload Create a backup file of switch configuration information on a host workstation. Syntax configUpload ["host", "user" ,"file" [,"passwd"]] Availability Admin Description Use this command to upload the switch configuration to a host file. The upload process uses FTP. If the command is entered without operands, it becomes interactive and prompts the user for input. The configuration file is written as three sections. The first section contains the switch boot parameters.
PAGE 101
Telnet Commands Example file Specify a filename in quotation marks; for example, "config.txt". Absolute pathnames may be specified using forward slash (/). Relative pathnames create the file in the user’s home directory on UNIX hosts, and in the directory where the FTP server is running on Windows hosts. This operand is optional. passwd Specify a password in quotation marks. This operand is optional.
PAGE 102
Telnet Commands 1 configure Modify system configuration settings. Syntax configure Availability Admin Description Use this command to change the following system configuration settings: ◆ Fabric parameters ◆ Virtual channel settings ◆ Switch Operating Mode ◆ Zoning Operation parameters ◆ RSCN Transmission Mode ◆ NS Pre-zoning Mode ◆ Arbitrated Loop parameters ◆ System services ◆ Portlog events enable Do not run this command on an operational switch.
PAGE 103
Telnet Commands End-of-file (control-D)* When entered at a prompt with no preceding input, terminates the command and saves changes made. * However, on many computers the settings could be different. Fabric Parameters There are a number of settings that control the overall behavior and operation of the fabric. Some of these values, such as the domain, are assigned automatically by the fabric and may differ from one switch to another in the fabric.
PAGE 104
Telnet Commands 1 Descriptions of the switch fabric setting fields are as follows: Domain The domain number uniquely identifies the switch in a fabric. This value is automatically assigned by the Fabric. The range of valid values varies depending on the switch model and other system parameter settings (refer to VC Encoded Address Mode). BB Credit The buffer-to-buffer (BB) credit represents the number of buffers available to attached devices for frame receipt.
PAGE 105
Telnet Commands Sequence Level Switching When sequence level switching is set to 1, frames of the same sequence from a particular source are transmitted together as a group. When this feature is set to 0, frames are transmitted interleaved among multiple sequences. Under normal conditions, sequence level switching should be disabled for better performance. However, some host adapters have performance issues when receiving interleaved frames from multiple sequences.
PAGE 106
Telnet Commands 1 Core Switch PID Format This is used to set the 256 port PID format that is used for core switches. Per-frame Route Priority In addition to the eight virtual channels used in frame routing priority, support is also available for per-frame based prioritization when this value is set. When this mode is set to 1, the virtual channel ID is used in conjunction with a frame header to form the final virtual channel ID.
PAGE 107
Telnet Commands The Virtual Channel Setting fields as show in Table 1-4: Table 1-4 Configure Command Virtual Channel Settings Field Default Range VC Priority 2 2 2 to 3 VC Priority 3 2 2 to 3 VC Priority 4 2 2 to 3 VC Priority 5 2 2 to 3 VC Priority 6 3 2 to 3 VC Priority 7 3 2 to 3 Switch Operating Mode The functionality of this parameter is currently not supported.
PAGE 108
Telnet Commands 1 NS Pre-zoning Mode The NS Prezoning Mode field is as follows: Pre-zoned responses Mode Specify 0 for Standard Mode, or 1 for Pre-zoning On. The default value is 0.
PAGE 109
Telnet Commands Do Not Allow AL_PA 0x00? This option disallows ALPA values from being 0. Initialize All Looplets? When this is set, all looplets including the ones not in the same zone are always re-initialized. This is required for certain RAID subsystems to work properly during failover.
PAGE 110
Telnet Commands 1 rusersd Dynamically enables or disables a server that returns information about the user logged into the system through remote procedure calls (RPCs). The information returned includes user login name, the system name, login protocol or type, login time, idle time, and remote login location (if applicable). The retrieval of this information is supported by a number of operating systems that support RPC. On most UNIX-based systems (HP-UX, Irix, Linux, Solaris, etc.
PAGE 111
Telnet Commands Portlog Events Enable Table 1-7 Use these parameters to specify which events create an entry in the port log.
PAGE 112
Telnet Commands 1 Table 1-7 1-96 Configure Command Portlog Events Parameters (continued) Field (Valid Values) Default Value nbrfsm: neighbor state transition (on, off): [on] timer: timer (on, off): [on] sn: speed negotiation state (on, off): [on] fcin: Fibre Channel input (on, off): [on] fcout: Fibre Channel ouput (on, off): [on] read: Fibre Channel read (on, off): [on] write: Fibre Channel write (on, off): [on] err: Fibre Channel error (on, off): [on] frame: Fibre Channel frame payloa
PAGE 113
Telnet Commands Example To set the configuration parameters for a switch: switch:admin> configure Configure... Fabric parameters (yes, y, no, n): [no] yes Domain: (1..239) [1] R_A_TOV: (4000..120000) [10000] E_D_TOV: (1000..5000) [2000] 5000 Data field size: (256..2112) [2112] Sequence Level Switching: (0..1) [0] Disable Device Probing: (0..1) [0] Suppress Class F Traffic: (0..1) [0] 1 SYNC IO mode: (0..1) [0] VC Encoded Address Mode: (0..1) [0] 1 Core Switch PID Format: (0..
PAGE 114
Telnet Commands 1 crossPortTest Test the functional operation of the switch. Syntax crossPortTest [passCount,loopbackmode, speedmode] Availability Admin Description Use this command to verify the functional operation of the switch. This command verifies operation by sending frames from port M’s transmitter and looping the frames back through an external fiber cable into another port N’s receiver.
PAGE 115
Telnet Commands 6. Check if any of the 8 statistic error counters are non-zero: ENC_in, CRC_err, TruncFrm, FrmTooLong, BadEOF, Enc_out, BadOrdSet, DiscC3. 7. Check if the transmit, receive or class 3 receiver counters are stuck at some value. 8. Check if the number of frames transmitted is not equal to the number of frames received. 9. Repeat steps 3 through 8 for all ports present until: a. Number of frames requested is reached b.
PAGE 116
Telnet Commands 1 To run the crossPortTest command successfully the test must find at least one port (if singlePortAlso loopback mode is active) or two ports (if singlePortAlso loopback mode is not active) cable loopbacked to each other.
PAGE 117
Telnet Commands Operands This command has the following operands: passCount Specify the number of times to execute this test. The default value is 1. This operand is optional. lbmode Select the loopback point for the test. By default, crossporttest uses cable loopback as described above.
PAGE 118
Telnet Commands 1 sp Select the speed mode for the test. This parameter is only used for 2 Gb/s capable products where it controls the speed at which each port is operated. For 1 Gb/s only products it is ignored. The exact operation of modes 3-6 depends upon the loopback mode selected. When speed modes 3-6 are used with cables, they must be connected even to odd or the test will fail.
PAGE 119
Telnet Commands -gbic_mode mode The gbic_mode parameter may be used to override the global GBIC mode described above for the duration of this test. Specify 1 enable gbic_mode, and the testing is limited to user ports with GBICs or SFPs installed. -no_restore nr_mode The nr_mode parameter may be set in order to force the test to skip part of the post-test cleanup normally performed. This may be helpful during debug. This parameter should normally be left at the default value of 0.
PAGE 120
Telnet Commands 1 0x2f PORT_WRONG 0x30 ERR_STATS_ENCIN 0x31 ERR_STATS_CRC 0x32 ERR_STATS_TRUNC 0x33 ERR_STATS_2LONG 0x34 ERR_STATS_BADEOF 0x35 ERR_STATS_ENCOUT 0x36 ERR_STATS_BADOS 0x37 ERR_STATS_C3DISC 0x38 ERR_STATS 0x3a INIT 0x3b DATA 0x3c NO_SEGMENT 0x39 TIMEOUT 0x3d STATS_FTX 0x3e STATS_FRX 0x3f STATS_C3FRX 0x40 STATS 0x41 MBUF_STATE_ERR 0x42 FINISH_MSG_ERR 0x43 RXQ_RAM_PERR 0x44 RXQ_FRAME_ERR 0x45 FDET_PERR 0x46 MBUF_STATUS_ERR 0x47 EPI1_STATUS_ERR 0x48 LESSN_STATUS_ERR 0x49 FTPRT_STATUS_ERR See Als
PAGE 121
Telnet Commands dataTypeShow Display sample data stream types used in some diagnostic commands. Syntax dataTypeShow Availability All users Description Displays sample data streams types used in diagnostic commands. There are 19 different sample data types. The command displays an example of each data stream.
PAGE 122
Telnet Commands 1 date Display or set system date and time. Syntax Availability date ["newdate"] All users (display) Admin (set) Description Use this command with no operands to display date and time. Use the newdate operand to set the date and time. Date and time are specified as a quoted string in the format: "mmddhhmmyy" where: mm is the month 01-12 dd is the day 01-31 hh is the hour 00-23 mm is minutes 00-59 yy is the year 00-99 Year values greater than 69 are interpreted as 1970-1999.
PAGE 123
Telnet Commands See Also errLogShow portLogShow uptime date 1-107 1
PAGE 124
Telnet Commands 1 diagClearError Clear the diag software flag to allow for retest. Syntax diagclearerror [[-slot] slot][-switch switch] | -all Availability Admin Description Use this command to clear the diag software flag that indicates whether a port is BAD or OK. The current flag settings are displayed by using the diagShow command. This command resets the flag to allow the bad port to be retested; otherwise the test will skip the port. This command does not clear the error log entry.
PAGE 125
Telnet Commands diagCommandShow Display a list of diagnostic commands. Syntax diagCommandShow Availability Admin Description Use this command to display a list of diagnostic commands for v4.0. Operands Example None To display a list of v4.0 diagnostic commands: switch:admin> diagcommandshow diagCommandShow - Display diagnostics command parameter and error info.
PAGE 126
Telnet Commands 1 turboramtest statstest portledtest filtertest backplanetest switch:admin> 1-110 Turbo speed asic SRAM diagnostic Statistics counter diagnostic User Ports LED exerciser Frame filter diagnostic Backplane connection diagnostic EMC Connectrix DS-32B2 and ED-12000B Fabric OS Reference Manual
PAGE 127
Telnet Commands diagDisablePost Disable POST execution at reboot. Syntax diagDisablePost Availability Admin Description Use this command to disable power nn self test (POST) execution at switch reboot. This mode is saved in flash memory and POST remains disabled until it is enabled using the diagEnablePost command.
PAGE 128
Telnet Commands 1 diagEnablePost Enable POST execution at next reboot. Syntax diagEnablePost Availability Admin Description Use this command to enable power on self test (POST) execution at the next switch reboot. This mode is saved in flash memory and POST remains enabled until it is disabled using the diagDisablePost command. Operands Example None To enable the POST during future power ups: switch:admin> diagEnablePost Config update Succeeded Post disable is now 0 (Enabled).
PAGE 129
Telnet Commands diagesdports Set ESD skip ports list. Syntax diagesdports [list | -show] Availability Admin Description Use this command to set the ESD IDLE PORTS list. The list is saved in nonvolatile memory and stays in that mode until the next execution of diagesdports. The ESD IDLE ports are used by several of the functional test methods to disable testing on the specified list of ports when ESD mode is enabled (see setesdmode).
PAGE 130
Telnet Commands 1 diagfaillimit Set diagnostics fail limit. Syntax diagfaillimit [limit | -show] Availability Admin Description Use this command to set the diagnostics fail limit to a specified value. The fail limit is saved in nonvolatile memory and stays set until the next execution of diagfaillimit. The mode becomes active as soon as this command is executed. It does not require a reboot to take effect.
PAGE 131
Telnet Commands diagHelp Display diagnostic commands information. Syntax diagHelp Availability All users Description Use this command to display a list of the diagnostic help commands for troubleshooting switch problems. Operands Example None To display information about diagnostic commands: switch:admin> diagHelp diagCommandShow - Display diagnostics command parameter and error info.
PAGE 132
Telnet Commands 1 turboramtest statstest portledtest filtertest backplanetest See Also 1-116 Turbo speed asic SRAM diagnostic Statistics counter diagnostic User Ports LED exerciser Frame filter diagnostic Backplane connection diagnostic diagcommandshow EMC Connectrix DS-32B2 and ED-12000B Fabric OS Reference Manual
PAGE 133
Telnet Commands diagloopid Set the diagnostics loop ID. Syntax diagloopid [id | -show] Availability Admin Description Use this command to select the loop ID to be used by FL mode diagnostics. The value entered will be converted from a loop ID to the corresponding ALPA and used as the port address for any diagnostics that operate in FL port mode. The mode becomes active as soon as this command is executed. It does not require a reboot to take effect.
PAGE 134
Telnet Commands 1 diagmodepr Enable or disable mode messages. Syntax diagmodepr [mode | -show] Availability Admin Description Use this command to enable print mode. The mode is saved in nonvolatile memory and stays in that mode until the next execution of diagmodepr. The mode becomes active as soon as this command is executed. It does not require a reboot to take effect. Print mode when enabled will cause extra messages to be displayed in the burn-in and post scripts.
PAGE 135
Telnet Commands diagpost Enable or disable POST testing. Syntax diagpost [mode | -show] Availability Admin Description Use this command to enable or disable POST testing. The mode is saved in non-volatile memory and stays in that mode until the next execution of diagpost. The mode becomes active as soon as this command is executed. It does not require a reboot to take effect.
PAGE 136
Telnet Commands 1 diagretry Enable or disable retry mode. Syntax diagretry [mode | -show] Availability Admin Description Use this command to enable or disable retry mode. The mode is saved in nonvolatile memory and stays in that mode until the next execution of diagretry. The mode becomes active as soon as this command is executed. It does not require a reboot to take effect. When enabled, retry mode modifies the behavior of the diagnostic test methods, POST, and burn-in scripts.
PAGE 137
Telnet Commands diagsetburinin Initializes the blade for a burn-in run. Syntax diagsetburnin [-slot [slot]] scriptname Availability Admin Description Use this command to set up the blade burn-in parameters for the registered burn-in script. Once this is known, then the blade parameters are initialized. The errors and activity logs are stored in nonvolatile memory. The errors produced are available from burninerrshow command on a per blade basis.
PAGE 138
Telnet Commands 1 diagsetcycle Set diagnostic script parameters. Syntax diagSetCycle [-show|-default|<-keyword value>..] Availability Admin Description Use this command to update diagnostic command parameters. With only the script operand specified, this command displays all configuration variables used by the specified script. Each variable can be modified. For each variable, the current value, default value, and description of purpose of the variable are displayed.
PAGE 139
Telnet Commands Example To view the parameters for a script: switch:admin> diagsetcycle -show Syntax: diagSetCycle [ -show | -default | <-keyword value>.. ] -show Outputs the values of the variables (No editing) -default Sets the values to the default value -keyword value Sets the value of a specific keyword (-number_of_runs 3) Please specify what diag cycles to set. Choices are: 0) EXIT 1) switchburnin.sh Make selection (0-1) 1 script selection: switchburnin.
PAGE 140
Telnet Commands 1 diagShow Print diagnostic results since the last boot. Syntax Availability All users Description Use this command to display the diagnostics status for the specified list of blade or user ports. Operands 1-124 diagshow [-slot slot][-uports itemlist][-bports itemlist] [-use_bports value] This command has the following operands: nSeconds Specify the repeat interval (in seconds) between executions of diagShow.
PAGE 141
Telnet Commands Example To display diagnostic status on switch blade 7: switch:admin> diagshow -slot 7 Diagnostics Status: Wed Feb 13 16:12:27 2002 Slot: 7 UPORTS Port BPort 0 15 1 14 2 13 3 12 4 31 5 30 6 29 7 28 8 47 10 45 11 44 12 63 13 62 14 61 15 60 Diag OK OK OK OK OK OK OK OK OK OK OK OK OK OK OK Active DN DN DN UP UP UP UP UP DN DN DN DN DN DN DN Speed 2G 2G 2G 2G 2G 2G 2G 2G 2G 2G 2G 2G 2G 2G 2G FrTX Auto -Auto -Auto -Auto 39 Auto 2175 Auto 2169 Auto 2193 Auto 2168 Auto -Auto -Auto -Auto -Au
PAGE 142
Telnet Commands 1 diagshowtime Enable or disable elapsed time messages. Syntax diagshowtime [mode | -show] Availability Admin Description Use this command to enable or disable show time mode. The mode is saved in nonvolatile memory and stays in that mode until the next execution of diagshowtime. The mode becomes active as soon as this command is executed. It does not require a reboot to take effect. Show time mode when enabled causes each test to display elapsed time messages.
PAGE 143
Telnet Commands diagsilkworm Enable or disable silkworm mode. Syntax diagsilkworm [mode | -show] Availability Admin Description Use this command to enable or disable silkworm mode. The mode is saved in nonvolatile memory and stays in that mode until the next execution of diagsilkworm. The mode becomes active as soon as this command is executed. It does not require a reboot to take effect.
PAGE 144
Telnet Commands 1 diagskiptests Enable or disable diagnostics skip test flags. Syntax diagskiptests [limit | -show] Availability Admin Description Use this command to enable or disable the diagnostics skip test flags. The skip test flags are saved in nonvolatile memory and stay set until the next execution of diagskiptests. The mode becomes active as soon as this command is executed. It does not require a reboot to take effect.
PAGE 145
Telnet Commands diagstopburnin Terminate a blade burn-in run. Syntax diagstopburnin [-slot slot] Availability Admin Description This determines which PID is running burn-in on a blade and terminates that activity. It is expected that the burn-in script handles the logging cleanup. This command does not require a reboot to take effect. Operand This command has the following operand: -slot slot Example Specify the slot to stop burn-in.
PAGE 146
Telnet Commands 1 dlsReset Turn off dynamic load sharing option. Syntax dlsReset Availability Admin Description Use this command to turn off DLS when a fabric change occurs. Routing is generally based on the incoming port and the destination domain. This means that all the traffic coming in from a port (either E_Port or Fx_Port) directed to the same remote domain is routed through the same output E_Port.
PAGE 147
Telnet Commands Examples To disable the dynamic load sharing option: switch:admin> dlsReset Committing configuration...done.
PAGE 148
Telnet Commands 1 dlsSet Turn on dynamic load sharing option. Syntax dlsSet Availability Admin Description Use this command to enable dynamic load sharing when a fabric change occurs. Routing is done on a per-source-port basis. This means that all the traffic coming in from a port (either E_Port or Fx_Port) directed to the same remote domain is routed through the same output E_Port.
PAGE 149
Telnet Commands Example To enable the dynamic load sharing option: switch:admin> dlsSet Committing configuration...done.
PAGE 150
Telnet Commands 1 dlsShow Display the state of the dynamic load sharing (DLS) option. Syntax dlsShow Availability All users Description Use this command to display whether DLS is on or off. There can be two messages displayed: DLS is set The DLS option is turned on. Load sharing is reconfigured with every change in the fabric. DLS is not set The DLS option is turned off. Load sharing is only reconfigured when the switch is rebooted or an Fx_Port comes up.
PAGE 151
Telnet Commands errDump Display the error log without page breaks. Syntax errDump [-s swinst] [-p] [-a] Availability Admin Description Use this command to display the error log without page breaks. This command displays the same information as errShow, but errShow enables you to scroll through the entries using ENTER. See errShow for a description of the error log.
PAGE 152
Telnet Commands 1 Operands This command has the following operand: -s swinst Specify a non-zero value to display the saved error log from the previous switch system reboot. This operand is optional. This operand is only available in v4.0. -p This is an optional parameter to specify a switch instance number in an ED-12000B switch. This parameter is required on the Standby CP. This parameter should not be used on the Active CP.
PAGE 153
Telnet Commands errShow Scroll through the error log. Syntax errShow [-s swinst] [-p] [-a] Availability Admin Description Use this command to display the error log. This command enables you to scroll through the entries using the ENTER key. Use errDump to display the same information without line breaks.
PAGE 154
Telnet Commands 1 Table 1-8 lists the errShow entries: Table 1-8 errShow Entries Entry Description Error Number Beginning at one. If the number of errors exceeds the size of the log, the most recent errors are shown. Task ID (Task Name) The ID and name of the task recording the error. Time Stamp The date and time of the first occurrence of the error. Error Count For errors that occur multiple times, the repeat count is shown in parenthesis. The maximum count is 999.
PAGE 155
Telnet Commands Table 1-9 Entry Error Codes for v4.
PAGE 156
Telnet Commands 1 Table 1-9 Entry Error Codes for v4.
PAGE 157
Telnet Commands Table 1-9 Entry Error Codes for v4.
PAGE 158
Telnet Commands 1 Table 1-9 Error Codes for v4.0 (continued) Entry Description 3844 3845 3846 3847 384F 385F 3870 3871 3874 Operands Example This command has the following operands: -s swinst This is an optional parameter to specify a switch instance number in a Silkworm 12000 switch. This parameter is required on the Standby CP. This parameter should not be used on the Active CP. You must follow -s with the switch instance number where the command is to be executed.
PAGE 159
Telnet Commands Type to continue, Q to stop: See Also errDump firmwareDownload reboot uptime errShow 1-143 1
PAGE 160
Telnet Commands 1 fabricShow Displays fabric membership information. Syntax fabricShow Availability All users Description Use this command to display information about switches and multicast alias groups in the fabric. Multicast alias groups are created on demand by request from N_Ports attached to the alias server; typically, no groups are listed. If the switch is initializing, or disabled, the message no fabric is displayed. If the fabric is reconfiguring, some or all switches may not be shown.
PAGE 161
Telnet Commands Example The following example shows a fabric of four switches. sw180 is the principal switch. Three of the switches are configured to run IP over Fibre Channel. There is one multicast alias group. switch:admin> fabricShow Switch ID Worldwide Name Enet IP Addr FC IP Addr Name ------------------------------------------------------------------------3: fffc43 10:00:00:60:69:10:60:1f 192.168.64.187 0.0.0.0 "sw187" 2: fffc42 10:00:00:60:69:00:05:91 192.168.64.60 192.168.65.
PAGE 162
Telnet Commands 1 fabStatsShow Display the fabric statistics information. Syntax fabStatsShow Availability All users Description Use this command to display the statistics information of fabric.
PAGE 163
Telnet Commands fanDisable Disable a fan unit. Syntax fanDisable unit Availability Admin Description Use this command to disable a nonfaulty fan unit by setting the RPM speed to 0. Operand This command has the following operand: unit Example Specify the fan’s unit number. View the fan unit numbers using the fanShow command. This operand is required.
PAGE 164
Telnet Commands 1 fanEnable Enable a fan unit. Syntax fanEnable unit Availability Admin Description Use this command to set the fan unit back to the default RPM speed only if the fan unit has been previously disabled using the fanDisable command. Operand This command has the following operand: unit Example Specify the fan’s unit number. View the fan unit numbers using the fanShow command. This operand is required.
PAGE 165
Telnet Commands fanShow Display fan status. Syntax fanShow Availability All users Description Use this command to display the current status of the switch fans. The format of the display varies according to the number of fans installed. Some switch models show fan speed measured in RPM. Fan status is shown as: OK Fan is functioning correctly. absent Fan is not present. below minimum Fan is present but rotating too slowly or stopped. unknown Unknown fan unit installed.
PAGE 166
Telnet Commands 1 fastboot Reboot the switch, bypassing POST. Syntax fastboot Availability Admin Description Use this command to reboot the switch, bypassing POST. The reboot takes effect immediately as the switch resets and executes normal power-up booting sequence. However, power on self test (POST) is skipped. This reduces boot time significantly. If POST has been disabled using the diagDisablePost command, then fastboot is the same as reboot.
PAGE 167
Telnet Commands fazoneAdd Add a member to a Fabric Assist zone. EMC does not support this command. Syntax fazoneAdd “fazoneName”,“member; member” Availability Admin Description Use this command to add one or more members to an existing Fabric Assist zone. This command does not change the defined configuration (which you can view using the cfgShow command) until the cfgSave command is issued.
PAGE 168
Telnet Commands 1 Example To add aliases for some disk arrays to “Blue_fazone”: switch:admin> fazoneAdd “Blue_fazone”, “array3; array4; array5” To add a Fabric Assist host member to “Blue_fazone”: switch:admin> fazoneAdd “Blue_fazone”, “H{5,6}” See Also 1-152 fazoneCreate fazoneDelete fazoneRemove fazoneShow EMC Connectrix DS-32B2 and ED-12000B Fabric OS Reference Manual
PAGE 169
Telnet Commands fazoneCreate Create a Fabric Assist zone. EMC does not support this command. Syntax fazoneCreate “fazoneName”,“member; member” Availability Admin Description Use this command to create a new Fabric Assist zone. You must specify a name and member list for a Fabric Assist zone. The FA zone name must be unique from any previously used Fabric Assist zone object. The member list must be enclosed in quotation marks and each member must be separated by a semicolon.
PAGE 170
Telnet Commands 1 A Fabric Assist host member is defined by wrapping the physical fabric port or a physical device (a WWN) between “H{” and “}”. For example, “H{5,6}” or “H{10:00:00:60:69:00:00:8a}” is a Fabric Assist host. The type of Fabric Assist zone members used to define a Fabric Assist zone may be mixed and matched.
PAGE 171
Telnet Commands Example To create three Fabric Assist zones using a mixture of port numbers and Fabric Assist zone aliases: switch:admin> fazoneCreate “fazone1”, “H{1,0}; loop1” switch:admin> fazoneCreate “fazone2”, “H{1,1}; array1; 1,2; array2” switch:admin> fazoneCreate “fazone3”, “1,0; loop1; H{1,2}; array2” See Also fazoneAdd fazoneDelete fazoneRemove fazoneShow fazoneCreate 1-155 1
PAGE 172
Telnet Commands 1 fazoneDelete Delete a Fabric Assist mode zone. EMC does not support this command. Syntax fazoneDelete “fazoneName” Availability Admin Description Use this command to delete an existing Fabric Assist mode zone on a fabric. This command does not change the defined configuration (which you can view using the cfgShow command) until the cfgSave command is issued.
PAGE 173
Telnet Commands fazoneRemove Remove members from a Fabric Assist mode zone. EMC does not support this command. Syntax fazoneRemove “fazoneName”, “member; member” Availability Admin Description Use this command to remove one or more members from an existing Fabric Assist zone. Each deleted member must be found by an exact string match. Order is important when removing multiple members of a Fabric Assist zone.
PAGE 174
Telnet Commands 1 Operands The following operands are required: fazoneName Specify a name for the Fabric Assist zone in quotation marks. This operand is required. member Specify a member or list of members to remove from a Fabric Assist zone. The list must be enclosed in quotation marks, and each member must be separated by a semicolon. A member can be specified by one or more of the following methods: ◆ ◆ ◆ ◆ Enter a fabric domain and area number pair.
PAGE 175
Telnet Commands fazoneShow Display fazone information. EMC does not support this command. Syntax fazoneShow ["pattern"[, transflag]] Availability All users Description Use this command to display fazone information. Specifying this command with no parameters or with the second parameter set to zero displays all fazone configuration information for both defined and effective configurations. Defined configuration information is shown from the transaction buffer.
PAGE 176
Telnet Commands 1 transflag Example Specify 0 to display the information from the current transaction, or specify 1 to display information from the original buffer. This operand must be preceded by a pattern.
PAGE 177
Telnet Commands filterTest Run frame filter test for 3000 ASICs.
PAGE 178
Telnet Commands 1 Table 1-10 Operands Diagnostics Filtering Conditions (continued) Number Filter Definition 7 Zone A match and ALPA match 8 Zone B match and ALPA match 9 Zone A&B match and ALPA match 10 Zone A|B match and ALPA match 11 Zone A|B match and ALPA match This command has the following operands: -passcnt passcnt Specify the number of times to execute this test. The default value is 1. This operand is optional. -txports list Specify the user port number(s) to perform this test.
PAGE 179
Telnet Commands Example To run the filterTest: switch:admin> filterTest Running Filter Test ........... passed.
PAGE 180
Telnet Commands 1 firmwareCommit Commit switch firmware update. Syntax firmwareCommit Availability Admin Description Use this command to propagate an updated firmware image in the primary partition to the secondary partition in an individual CP blade. For the ED-12000B, each CP has two partitions. The firmwaredownload command will always load the image into the secondary partition of a CP and then will swap the secondary to be the new primary.
PAGE 181
Telnet Commands firmwareDownload Download a switch firmware file from a host. Syntax firmwareDownload [[-sbni] host,user,pfile [, passwd]] Availability Admin Description Use this command to download switch firmware from a remote host or from a local directory to the switch’s non-volatile storage area. Fabric OS v4.x supports only FTP protocol for firmware downloads. Both theDS-32B2 and each CP of the ED-12000B have a primary and secondary partition.
PAGE 182
Telnet Commands 1 Operands 1-166 This command has the following operands: -s Specify this option to enable Single CP Mode. This option is available in v4.0 only. In the ED-12000B, by default, firmwareDownload will upgrade both CPs. This mode enables the users to upgrade a single CP in the switch. In the DS-32B2, this mode has no effect. -b Specify this operand to activate auto-reboot mode. This operand is only available in v4.0. After downloading firmware the system must be rebooted.
PAGE 183
Telnet Commands user Specify a user name in quotation marks; for example, "jdoe". This user name is used to gain access to the host computer or directory where the firmware package resides. This operand is required. file Specify a path and file name in quotation marks; for example, "/pub/dist/v2.6.0". Absolute pathnames may be specified using forward slash (/).
PAGE 184
Telnet Commands 1 Errors See Also 1-168 The following can cause the download to fail: ◆ The host name is not known to the switch. ◆ The host IP address cannot be contacted. ◆ The user does not have permission on the host. ◆ The user runs a script that prints something at login. ◆ The file does not exist on the host. ◆ The file is not a switch firmware file. ◆ The file is corrupted. ◆ The RSHD (v3.0) or FTP (v3.0 and v4.0) server is not running on the host.
PAGE 185
Telnet Commands firmwareRestore Restore old active firmware image from the secondary partition. Syntax firmwareRestore Availability Admin Description Use this command to restore the old active firmware image. This is only possible if the last firmwaredownload was not committed. After a firmwaredownload and a reboot, the downloaded firmware will become active. If you then do not want to commit the firmware, and instead want to restore the old firmware, run firmwareRestore.
PAGE 186
Telnet Commands 1 fspfShow Display FSPF protocol information. Syntax fspfShow Availability All users Description Use this command to display the Fibre-Channel Shortest Path First (FSPF) protocol information, and internal data structures. FSPF is implemented by a single task, called tFspf. Table 1-11 shows the fields displayed: Table 1-11 1-170 fspfShow Fields Field Description version Version of FSPF protocol. domainID Domain number of local switch. switchOnline State of the local switch.
PAGE 187
Telnet Commands Table 1-11 fspfShow Fields Field Description agingTID Ager timer ID. agingTo Ager time out value, in milliseconds. lsrDlyTID Link State Record delay timer ID. lsrDelayTo Link State Record delay time out value, in milliseconds.
PAGE 188
Telnet Commands 1 See Also 1-172 bcastShow mcastShow topologyShow uRouteShow EMC Connectrix DS-32B2 and ED-12000B Fabric OS Reference Manual
PAGE 189
Telnet Commands fwAlarmsFilterSet Show which alarms are enabled for Fabric Watch. Syntax fwAlarmsFilterSet [mode] Availability Admin Description Use this command to configure alarm filtering. By turning off the alarms, all nonenvironment class alarms are suppressed. By turning on the alarms, all class alarms are generated. This command requires a Fabric Watch License. Operand The following operand is optional: mode Example Specify 1 to enable the alarms, 0 to disable the alarms.
PAGE 190
Telnet Commands 1 fwAlarmsFilterShow Show alarm filtering for Fabric Watch. Syntax fwAlarmsFilterShow Availability All users Description Use this command to show alarm filtering status for Fabric Watch. This command requires a Fabric Watch license.
PAGE 191
Telnet Commands fwClassInit Initialize all classes under Fabric Watch. Syntax fwClassInit Availability Admin Description Use this command to initialize all classes under Fabric Watch. This command requires a Fabric Watch license. Operands Example None To initialize all clases under Fabric Watch: switch:admin> fwClassInit fwClassInit: Fabric Watch is updating...
PAGE 192
Telnet Commands 1 fwConfigReload Reload the Fabric Watch configuration. Syntax fwConfigReload Availability Admin Description Use this command to initialize reload the Fabric Watch configuration. This command should only be used after downloading a new Fabric Watch configuration file from a host. This command requires a Fabric Watch license. Operands Example None To reload the saved Fabric Watch configuration: switch:admin> fwConfigReload fwConfigReload: Fabric Watch configuration reloaded.
PAGE 193
Telnet Commands fwConfigure Display and modify the Fabric Watch configuration and status. Syntax fwConfigure Availability Admin Description Use this command to display and modify threshold information for the Fabric Watch configuration. Switch elements monitored by Fabric Watch are divided into classes, which are further divided into areas. In addition, each area can include multiple thresholds. This command requires a Fabric Watch license.
PAGE 194
Telnet Commands 1 Table 1-12 Fabric Watch Classes and Areas (continued) Class Area Fabric class Loss of E_Port Fabric reconfigure Segmentation changes Domain ID changes Zoning changes Fabric to QuickLoop changes. v3.0 only.
PAGE 195
Telnet Commands Table 1-12 Fabric Watch Classes and Areas (continued) Class Area Fabric class Loss of E_Port Fabric reconfigure Segmentation changes Domain ID changes Zoning changes Fabric to QuickLoop changes. v3.0 only.
PAGE 196
Telnet Commands 1 Table 1-12 Operands Example Fabric Watch Classes and Areas (continued) Class Area Alpa Performance Monitor class (This class is available in v4.0 only.) Invalid CRCS EE Performance Monitor class (This class is available in v4.0 only. ) Invalid CRCS RXPerformance TXPerformance Filter Performance Monitor class (This class is available in v4.0 only.
PAGE 197
Telnet Commands 3 5 inBetween envTemp003 inBetween envTemp005 inBetween Thu Aug Thu Aug Thu Aug 1 10:49:44 2002 enabled 1 10:49:44 2002 enabled 1 10:49:44 2002 30 42 47 38 43 C C C C C Normal Normal Normal 1 : refresh 2 : disable a threshold 3 : enable a threshold 4 : advanced configuration 5 : return to previous page Select choice => : (1..
PAGE 198
Telnet Commands 1 fwFruCfg Display or modify FRU state alert configuration. Syntax fwFruCfg Availability Admin Description Use this command to configure FRU states and actions. Based on these configuration settings, Fabric Watch generates action when the FRU state changes. To configure email alerts, use fwMailCfg. This command requires a Fabric Watch license.
PAGE 199
Telnet Commands 1 2 3 4 1 2 3 4 Slot Slot Slot Slot : : : : change change change change #1 #2 #3 #4 enable enable enable enable fru alarm state fru alarm level alarm frequency fru timebase See Also 32 8 16 48 5 6 7 8 : : : : 17 16 16 17 5 1 1 5 Minute Minute Minute Minute change fru status apply fru configuration cancel fru configuration changes return to previous page fwMailCfg fwConfigure fwFruCfg 1-183 1
PAGE 200
Telnet Commands 1 fwHelp Display Fabric Watch command information. Syntax fwHelp Availability All users Description Use this command to display commands used to configure Fabric Watch.
PAGE 201
Telnet Commands fwMailCfg Configure email alerts in Fabric Watch. Syntax fwMailCfg Availability Admin Description Use this command to configure email alerts in Fabric Watch. This command requires a Fabric Watch License. When this command is executed, a menu of configuration tasks is displayed.
PAGE 202
Telnet Commands 1 When configuring an email alert for a specific class, you must specify the following information: Mail Server Specify the IP address of the mail server. Domain Name Specify the domain name of the mail server. For example, emc.com. Mail Recipients Specify the name of the users who will be notified. The format should be user@domain.com. For example, johndoe@emc.com. You must choose option 3 to enable email alert.
PAGE 203
Telnet Commands Example To configure an email address recipient in Fabric Watch: switch:admin> fwMailCfg 1 : Show Mail Configuration Information 2 : Disable Email Alert 3 : Enable Email Alert 4 : Send Test Mail 5 : Set Recipient Mail Address for Email Alert 6 : Set Domain Name and Name Server 7 : Show Domain Name and Name Server 8 : quit Select an item => : (1..
PAGE 204
Telnet Commands 1 fwSetToCustom Set boundary and alarm levels to custom values. Syntax fwSetToCustom Availability Admin Description Use this command to set boundary and alarm levels to custom values for all classes and areas for Fabric Watch. This command requires a Fabric Watch License. Operands Example None To set alarm levels to custom values: sw:admin> fwSetToCustom Committing configuration...done.
PAGE 205
Telnet Commands fwSetToDefault Set boundary and alarm levels to the default values. Syntax fwSetToDefault Availability Admin Description Use this command to set boundary and alarm levels to default values for all classes and areas for Fabric Watch. This command requires a Fabric Watch License. Operands Example None To set alarm levels to default values: switch:admin> fwSetToDefault Committing configuration...done.
PAGE 206
Telnet Commands 1 fwshow Display the thresholds monitored by Fabric Watch. Syntax fwShow Availability All users Description Use this command to display the thresholds monitored by Fabric Watch. In v3.0, this command displays the name, label, and last value for each Fabric Watch area. In v4.0, this command can display a synopsis of thresholds for a particular class, or more detailed information for an individual threshold. This command requires a Fabric Watch License.
PAGE 207
Telnet Commands Counter: Access via: Function call Address: 0x100187dc Argument: 0x00000002 Previous: 0x00000bc5 (3013) Current: 0x00000bc5 (3013) Events: Style: Triggered Event 0 occurred 1 time, last at 19:08:31 on 12/03/1999 Event 1 occurred 80 times, last at 19:47:06 on 12/03/1999 * Event 5 occurred 1 time, last at 19:08:37 on 12/03/1999 Callbacks: No callbacks are registered. 1 : Show class thresholds 2 : Detail threshold information 3 : Quit Select an item => : (1..
PAGE 208
Telnet Commands 1 gbicShow Display serial ID GBIC information. Syntax Availability gbicShow [slotnumber/][portnumber] All users References to GBIC also apply to SFP. Description Use this command to display information about Serial Identification GBICs (also known as module definition 4 GBICs). These GBICs provide extended information that describes the GBICs capabilities, interfaces, manufacturer, and other information. GBICs are polled by a background process.
PAGE 209
Telnet Commands Operand This command has the following operand: slotnumber Specify the slot number in an ED-12000B switch. The slot number must be followed by a slash ( / ) and the port number. The ED-12000B has a total of 10 slots counted from 1 to 10. Slot number 5 and 6 are control processor cards, and slot 1 through 4 and 7 through 10 are switch cards. On each switch card, there are 16 ports counted from the bottom 0 to 15.
PAGE 210
Telnet Commands 1 Example To display GBIC summary information, followed by detailed information for a single GBIC: switch12k:admin> gbicshow Area Area Area Area Area Area Area Area Area Area Area Area Area Area Area Area Area Area Area Area Area Area Area Area Area Area Area Area Area Area Area 1-194 0: 1: 2: 3: 4: 5: 6: 7: 8: 9: 10: 11: 12: 13: 14: 15: 16: 17: 18: 19: 20: 21: 22: 23: 24: 25: 27: 28: 29: 30: 31: id id id id id id id id --------id id id id id id id id -------- (id) (sw) (sw) (sw) (sw)
PAGE 211
Telnet Commands switch12k:admin> gbicshow 1/3 Identifier: 3 GBIC Connector: 7 LC Transceiver: 050c402000000000 100,200_MB/s M5,M6 sw Inter_dist Encoding: 1 8B10B Baud Rate: 21 (units 100 megabaud) Length 9u: 0 (units 100 meters) Length 50u: 30 (units 10 meters) Length 625u: 13 (units 10 meters) Length Cu: 0 (units 1 meter) Vendor Name: FINISAR CORP. Vendor OUI: 00:90:65 Vendor PN: FTRJ-8519-3-2.
PAGE 212
Telnet Commands 1 h Display shell history. Syntax h Availability All users Description The shell history mechanism is similar to the UNIX Korn shell history facility. It has a built-in line editor similar to UNIX vi that allows previously typed commands to be edited. The command h displays the 20 most recent commands typed into the shell; old commands fall off the top as new ones are entered. To edit a command, press ESC to access edit mode, then use vi commands.
PAGE 213
Telnet Commands haDisable Disable the high-availability feature in the switch. Syntax haDisable Availability Admin Description Use this command to disable the high-availability (HA) feature in the switch. If the HA feature is already disabled, this command is ignored. Operands Example None To disable the high availability feature: switch:admin> haDisable Disabling HA ... Done.
PAGE 214
Telnet Commands 1 haEnable Enable the high-availability feature in the switch. Syntax haEnable Availability Admin Description Use this command to enable the high-availability (HA) feature in the Switch. If the HA feature is already enabled, this command is ignored. Operands Example None To enable the high-availability feature in the switch: switch:admin> haEnable Enabling HA ... Done.
PAGE 215
Telnet Commands haFailover Force the failover mechanism so that the standby CP becomes the active CP. Syntax haFailover Availability Admin Description Use this command to force the failover mechanism to occur so that the standby CP becomes the active CP. Because hafailover results in CP reboot, a warning mesage and a confirmation are displayed. If the user answers positively, then the failover takes place.
PAGE 216
Telnet Commands 1 haShow Display control processor (CP) status.
PAGE 217
Telnet Commands help Display help information for commands. Syntax help [command] Availability All users Description Use this command without an operand to display an alphabetical list of commands that provide help information. At the end of the list are additional commands that display groups of commands, for example diagHelp displays a list of diagnostic commands.
PAGE 218
Telnet Commands 1 historyLastShow Display last history record. Syntax historyLastShow Availability All users Description Use this command to display the contents of the last history log record. A history record contains three lines of information: The first line of each record contains the following data-sets: . ◆ Object type: CHASSIS, FAN, POWER SUPPLY, SW BLADE (switch), CP BLADE (control processor), WWN (world wide name), or UNKNOWN.
PAGE 219
Telnet Commands historyShow Display the history log. Syntax historyShow Availability All users Description Use this command to display the history log. Each history record contains three lines of information: ◆ The first line of each record contains the following data sets: • Object type: CHASSIS, FAN, POWER SUPPLY, SW BLADE (switch), CP BLADE (control processor), WWN (world wide name), or UNKNOWN. • Object number: Slot (for blades), Unit (for everything else).
PAGE 220
Telnet Commands 1 Example To display the entire contents of the history file: switch:admin> historyShow FAN Unit 3 Brocade Part Number: Brocade Serial Number: Removed at Tue Aug 14 10:05:37 1970 20-123456-12 1013456800 POWER SUPPLY Unit 1 Brocade Part Number: Brocade Serial Number: Inserted at Tue Aug 14 10:52:10 1970 60-0001536-02 Unknown FAN Unit 3 Brocade Part Number: Brocade Serial Number: Inserted at Tue Aug 14 10:23:45 2001 20-123456-12 1013456800 WWN Unit 1 Brocade Part Number: Brocade Seria
PAGE 221
Telnet Commands i Display task summary. Syntax i [taskId] Availability All users Description This command displays information of all of the processes or of a specific process if a process ID is supplied. One line is displayed per process.
PAGE 222
Telnet Commands 1 Table 1-13 Operands i Fields (continued) Field Description PPID The process ID of the parent process. C Processor utilization for scheduling. PRI Priority number of the process. Higher numbers mean lower priority. NI Nice value used in priority computation. ADDR Memory address of the process. SZ The total size of the process in virtual memory in pages. WCHAN The address of an event for which process is sleeping (if blank, the process is running.).
PAGE 223
Telnet Commands ifModeSet Set the link operating mode for a network interface. Syntax ifModeSet ["eth0"] Availability Admin Description Use this command to set the link operating mode for the ethernet interface. Use ifShow to list network interfaces available on the system. An operating mode is confirmed with a y or yes at the prompt. If the operating mode selected differs from the current mode, the change is saved and the command exits. The system must be rebooted for changes to take effect.
PAGE 224
Telnet Commands 1 Example To force the link for the eth0 Ethernet interface to auto negotiate and to advertise all possible operating modes: switch:admin> ifModeSet "eth0" Exercise care when using this command. Forcing the link to an operating mode not supported by the network equipment to which it is attached may result in an inability to communicate with the system through its ethernet interface. It is recommended that you only use this command from the serial console port.
PAGE 225
Telnet Commands ifModeShow Display the link operating mode for a network interface. Syntax ifModeShow ["eth0"] Availability All users Description Use this command to display the link operating mode for a network interface. Operand This command has the following operand: eth0 Example Specify the Ethernet interface in quotation marks. For example, "eth0", where eth is the ethernet network interface, and 0 is the physical unit.
PAGE 226
Telnet Commands 1 interfaceShow Display FSPF interface information. Syntax interfaceShow [slotnumber/][portnumber] Availability All users Description Use this command to display data structures associated with FSPF interfaces (E_Ports) on the switch. There are two data structures: ◆ The permanently allocated Interface Descriptor Block (IDB) and ◆ The neighbor data structure that is allocated when a switch port becomes an E_Port.
PAGE 227
Telnet Commands Table 1-14 interfaceShow Fields (continued) Field Description delay: Conventional delay incurred by a frame transmitted on this ISL. A fixed value required by the FSPF protocol. lastScn: Type of the last State Change Notification received on this interface. lastScnTime: Time the last State Change Notification was received on this interface. upCount: Number of times this interface came up, with respect to FSPF. lastUpTime: Last time this interface came up.
PAGE 228
Telnet Commands 1 Table 1-14 1-212 interfaceShow Fields (continued) Field Description &dbRetransList: Pointer to the database retransmission list. &lsrRetransList: Pointer to the Link State Records (LSR) retransmission list. &lsrAckList: Pointer to the Link State Acknowledgements (LSA) retransmission list. inactTID: Inactivity timer ID. helloTID: Hello timer ID. dbRtxTID: Database retransmission timer ID. lsrRtxTID: LSR retransmission timer ID.
PAGE 229
Telnet Commands Table 1-14 interfaceShow Fields (continued) Field Description nInvHlo: Number of invalid Hello frames (Hello frames with invalid parameters) received from the neighbor switch. nLsuIn: Number of LSUs received from the neighbor switch. nLsaIn: Number of LSAs received from the neighbor switch. attHloOut: Number of attempted transmissions of Hello frames to the neighbor switch. nHloOut: Number of Hello frames transmitted to the neighbor switch.
PAGE 230
Telnet Commands 1 Operands This command has the following operands: slotnumber Specify the slot number in an ED-12000B switch. The slot number must be followed by a slash ( / ) and the port number. The ED- 12000B has a total of 10 slots counted from 1 to 10. Slot number 5 and 6 are control processor cards, and slot 1 through 4 and 7 through 10 are switch cards. On each switch card, there are 16 ports counted from the bottom 0 to 15.
PAGE 231
Telnet Commands See Also portShow switchShow interfaceShow 1-215 1
PAGE 232
Telnet Commands 1 interopmode Enable or disable switch interoperability with switches from other manufacturers. Syntax interopMode [mode] Availability Admin Description Use this command to enable or disable interoperability mode for individual switches. This feature enables other manufacturers’ switches to be used in a fabric. This command must be executed on all switches in the fabric. The switch must be rebooted after changing interoperability mode.
PAGE 233
Telnet Commands Example To view and then enable interoperability mode: switch:admin> interopmode InteropMode: Off Usage: InteropMode 0|1 0: to turn it off 1: to turn it on switch:admin> interopmode 1 done. Interopmode is enabled.
PAGE 234
Telnet Commands 1 iodReset Turn off the in-order delivery (IOD) option. Syntax iodReset Availability Admin Description Use this command to turn off the IOD option. The IOD option is turned off by default. If the IOD option was turned on using iodSet, this command can be used to turn it off again. Setting the IOD option to its default value will result in fast re-routing after a fabric topology change. This command may cause out-of-order delivery of frames during fabric topology changes.
PAGE 235
Telnet Commands iodSet Turn on in-order delivery option. Syntax iodSet Availability Admin Description Use this command to enforce in-order delivery of frames during a fabric topology change. In a stable fabric, frames are always delivered in order, even when the traffic between switches is shared among multiple paths. However, when topology changes occur in the fabric (for instance, a link goes down), traffic is rerouted around the failure.
PAGE 236
Telnet Commands 1 iodShow Display the state of the in-order Delivery (IOD) option. Syntax iodShow Availability All users Description Use this command to display whetherthe in-order delivery option during topology changes is on or off.
PAGE 237
Telnet Commands ipAddrSet Set Ethernet and FC IP addresses. Syntax ipAddrSet [option] Availability Admin Description For v4.0 you must set values for both logical switches and both CP cards in the ED- 12000B chassis. The option operand is available in v4.0. If the option operand is not specified, the command becomes interactive. In v4.
PAGE 238
Telnet Commands 1 ◆ cp0 = hostname cp0, ip 10.77.77.75, subnet 255.0.0.0, gateway 0.0.0.0 ◆ cp1 = hostname cp1, ip 10.77.77.74, subnet 255.0.0.0, gateway 0.0.0.0 After each prompt the current value is shown. You may: ◆ Press RETURN to retain the current value. ◆ Enter an IP address in conventional dot (’.’) notation. ◆ Enter NONE. ◆ Press CTRL-C to cancel changes. ◆ Press CTRL-D to accept changes and end input.
PAGE 239
Telnet Commands Example To set the IP address details for logical switch number 1: switch:admin> ipAddrSet 1 Ethernet IP Address [0.0.0.0]: 192.168.166.148 Ethernet Subnetmask [0.0.0.0]: 255.255.255.0 Fibre Channel IP Address [0.0.0.0]: 192.168.58.135 Fibre Channel Subnetmask [0.0.0.0]: 192.168.166.134 Committing configuration...Done... switch:admin> You cannot have a Fibre Channel IP address on the same network as an Ethernet IP address.
PAGE 240
Telnet Commands 1 ipAddrShow Display ethernet and FC IP addresses. Syntax ipAddrShow [option] Availability All users Description In an ED-12000B, this command shows the Ethernet IP Address, Ethernet Subnetmask, Fibre Channel IP Address and Fibre Channel Subnetmask for logical switches. It shows the Ethernet IP Address, Ethernet Subnetmask, Hostname and Gateway IP address for the CPs. In the ED-12000B, the CPs communicate to each other through an Ethernet in the backplane.
PAGE 241
Telnet Commands Operands This command has the following operand: option Specify the option you would like to view. The option operand is not availabe in v3.0. Valid option values for v4.0 are: ◆ ◆ ◆ ◆ ◆ Example Option 0 means display information for switch0. Option 1 means display information for switch1. Option 2 means display information for cp0. Option 3 means display information for cp1. option 4 means display information all IP addresses in the system.
PAGE 242
Telnet Commands 1 islShow Display ISL information. Syntax islShow Availability All users Description Use this command to display the current connections and status of the ISL of each port on this switch.
PAGE 243
Telnet Commands licenseAdd Add license key to switch. Syntax licenseAdd "license" Availability Admin Description Use this command to add a license key to a switch. Some features of the switch and of the fabric to which it is connected are optional licensed products. Without a license installed for such products, the services are not available. A license key is a string of approximately 16 upper and lower case letters and numbers.
PAGE 244
Telnet Commands 1 licenseHelp Display commands used to administer license keys. Syntax licenseHelp Availability Admin Description Use this command to display a list of the commands used to administer license keys.
PAGE 245
Telnet Commands licenseIdShow Display system license ID. Syntax licenseIdShow Availability All users Description Some features of the ED-12000B and the fabric are optional, licensed products. Without a license installed for such products, the services provided by these features are not available. Other switch products require the WWN to generate a license. A single license allows both logical switches in an ED-12000B chassis to use these products.
PAGE 246
Telnet Commands 1 licenseRemove Remove the license key from a switch. Syntax licenseRemove "license" Availability Admin Description Use this command to remove an existing license key from a switch. The existing license key must be entered exactly as shown by licenseShow, including case. When the key has been entered, use the licenseShow command to check that the key has been removed and the licensed product uninstalled. Once the license key has been removed, the switch must be rebooted.
PAGE 247
Telnet Commands licenseShow Display current license keys. Syntax licenseShow Availability All users Description Use this command to display current license keys along with a list of licensed products enabled by these keys; None is displayed if no license keys are installed. Operands Example None In this example, the switch has two keys.
PAGE 248
Telnet Commands 1 linkCost Set or print the FSPF cost of a link. Syntax linkCost [slotnumber/][portnumber][, cost] Availability Admin Description Use this command to set or display the cost of an inter-switch link (ISL). The cost of a link is a dimensionless positive number. It is used by the FSPF path selection protocol to determine the path that a frame takes going from the source to the destination switch. The chosen path is the path with minimum cost.
PAGE 249
Telnet Commands Operands This command has the following operands:. slotnumber Specify the slot number in an ED-12000B switch. The slot number must be followed by a slash ( / ) and the port number. This operand is optional. The ED-12000B has a total of 10 slots counted from 1 to 10. Slot number 5 and 6 are control processor cards, and slot 1 through 4 and 7 through 10 are switch cards. On each switch card, there are 16 ports counted from the bottom 0 to 15.
PAGE 250
Telnet Commands 1 Examples To display the cost of a link, and reset the cost: switch:admin> linkCost Slot Interface Cost ------------------------------------2 0 500 (STATIC) 2 1 1000 2 2 500 (STATIC) 2 3 200 (STATIC) 2 4 1000 2 5 1000 2 6 1000 2 7 1000 2 8 1000 2 9 1000 2 10 1000 2 11 (E_PORT) 2000 (STATIC) 2 12 1000 2 13 1000 2 14 1000 2 15 1000 switch:admin> linkCost 2/4 500 switch:admin> linkcost 2/4 Slot 2 Interface 4 switch:admin> linkcost 2/4 0 Slot 2 Interface 4 See Also 1-234 Cost Cost interf
PAGE 251
Telnet Commands login Log in as a new user. Syntax login Availability All users Description Use this command to log in to the switch with another username and password, without first logging out from the original session. If the user was originally connected using aTelnet or rlogin session, that session is left open. This command allows you to access commands that you cannot access at your current user level.
PAGE 252
Telnet Commands 1 logout Log out from aTelnet, rlogin, or serial port session. Syntax logout Availability All users Description Use this command to log out from a Telnet, rlogin, or serial port session. Telnet and rlogin connections are closed, the serial port returns to the login: prompt. The commands exit and quit are accepted as synonyms for logout, as is CONTROL-D entered at the beginning of a line.
PAGE 253
Telnet Commands loopdiagStart Start loopdiag application. Syntax loopdiagStart port Availability Admin Description Use this command to start the loopdiag application at the port specified. It will isolate the loop device before running diagnostics and report the test result. Error/failure and statistics will be reported. The port must be online prior to initiating the command. The command will place the port in testing mode and put the port back online at the end of the test.
PAGE 254
Telnet Commands 1 LSDbShow Display the FSPF link state database. Syntax LSDbShow [domain] Availability All users Description Use this command to display a link state database record for switches in the fabric. There are two data structures: the permanently allocated link state database entry and the link state record (LSR) that is allocated when a switch is connected to the fabric. The LSR for domain ’n’ describes the links between the switch with domain number ’n’ and its neighbor switches.
PAGE 255
Telnet Commands Table 1-16 LSDbShow Display Fields (continued) Field Description uOutIfs Internal variable. uPathCost Internal variable. uOldHopCount Internal variable. uHopsFromRoot Internal variable. mOutIfs Internal variable. parent Internal variable. mPathCos Internal variable. mHopsFromRoot Internal variable. lsAge Age, in seconds, of this LSR. An LSR is removed from the database when its age exceeds 3600 seconds. reserved Reserved for future use. type Type of the LSR.
PAGE 256
Telnet Commands 1 Table 1-16 Operands LSDbShow Display Fields (continued) Field Description LinkId ID of this link. It is the domain number of the switch on the other side of the link. out port Port number on the local switch. rem port Port number of the port on the other side of the link. cost Cost of this link. The default cost for a 1 Gb/s link is 1000. costCnt Always 0. type Always 1.
PAGE 257
Telnet Commands Link State Record: Link State Record pointer lsAge= 138 reserved= 0 type= 1 options= 0x0 lsId= 7 advertiser= 7 incarn= 0x80000217 length= 92 chksum= 0x2fdd linkCnt = 4,flags = 0x0 LinkId = 4, out port = 3, LinkId = 5, out port = 5, LinkId = 5, out port = 6, LinkId = 5, out port = 7, See Also = 0x1035bb30 rem rem rem rem port port port port = = = = 2, 5, 3, 4, cost cost cost cost = = = = 1000, 1000, 1000, 1000, costCnt costCnt costCnt costCnt = = = = 0, 0, 0, 0, type type type t
PAGE 258
Telnet Commands 1 lutil Run the license administration utility. Syntax lutil [-h-v][[-i]|[[-a|-r]key ... ]] Availability Admin Description Use this command to add, display, and remove license keys. Some features of the switch and of the fabric to which it is connected are optional, licensed products. Without a license installed for such products, the services provided by them will not function. Operands Example This command has the following operands: -h Display the command syntax help.
PAGE 259
Telnet Commands See Also licenseAdd licenseHelp licenseIdShow licenseRemove licenseShow lutil 1-243 1
PAGE 260
Telnet Commands 1 mcastShow Display multicast routing information. Syntax mcastShow [group_ID] Availability All users Description Use this command to display the multicast routing information, as it is known by the FSPF path selection and routing task, for all ports in the switch. The multicast routing information indicates, for each multicast group, all the ports that are members of that group, that is ports that are able to send and receive multicast frames on that group.
PAGE 261
Telnet Commands Operand This command has the following operand: group_ID Examples Specify the multicast group to be displayed. This operand is optional.
PAGE 262
Telnet Commands 1 memshow Display the amount of free and used memory in switch. Syntax memshow [ -b | -k | -m ] Availability All Users Description Use this command to display free and used memory on the system, as well as the shared memory and buffers used by the kernel. Operands This command has the following operands: -b Specify this operand to display memory usage in bytes. -k Specify this operand to display memory usage in kilobytes.
PAGE 263
Telnet Commands minispropshow Display the properties of the miniswitches. Syntax minispropshow {slot/] minis | {slot] -all Availability All users Description Use this command to display the ASIC miniswitch properties for the specified minis on the specified blade slot. Operands This command has the following operands: [slot] /minis Specify the slot and the index of the mini within the blade to be displayed. This operand is optional.
PAGE 264
Telnet Commands 1 Example To view the miniswitch properties on blade 8: switch12k:admin> minispropshow 8 -all Looking for miniS 0 in path: /proc/fabos/blade/8 slot: 8, miniS: 0 [2/16] <0,1657/0001 1,1657/0001> (be,5) (be,4) (be,3) (be,2) (be,1) (be,0) (bi,55) (bi,54) (bi,25) (bi,24) (bi,41) (bi,40) (fe,3) (fe,2) (fe,1) (fe,0) slot: 8, miniS: 1 [2/16] <2,1657/0001 3,1657/0001> (be,11) (be,10) (be,9) (be,8) (be,7) (be,6) (bi,39) (bi,38) (bi,9) (bi,8) (bi,57) (bi,56) (fe,7) (fe,6) (fe,5) (fe,4) slot: 8, min
PAGE 265
Telnet Commands minisregshow Display port registers for a specified miniswitch. Syntax minisregshow [slot/]mini_switch {filter} Availability All users Description Use this command to display the ASIC register contents for the specified miniswitch on the specified blade shot. Operands Example This command has the following operands: slot Specify the slot of the blade for which you want to view the port registers for. This operand is optional.
PAGE 266
Telnet Commands 1 msCapabilityShow Display the management server capability. Syntax msCapabilityShow Availability All users Description Use this command to query a fabric for the Management Server capability. Based on the result of this command, you can then decide whether to activate the Platform service on all switches in the fabric. When this command is issued, information is gathered from every switch of the fabric, and each switch’s ability to handle the Platform service is displayed.
PAGE 267
Telnet Commands See Also msPlMgmtActivate msPlMgmtDeactivate msPlatShow msPlClearDB msTdEnable msTdDisable msTdReadConfig msCapabilityShow 1-251 1
PAGE 268
Telnet Commands 1 msConfigure Configure the Management Server. Syntax msConfigure Availability Admin Description Use this command to display and configure parameters used to access the Management Server. The Management Server allows an enterprise storage network (ESN) management application to retrieve and administer fabric and interconnect elements such as switches. It is located at the Fibre Channel address, FFFFFAh.
PAGE 269
Telnet Commands Example To display the Management Server access control list: switch:admin> msConfigure 0 Done 1 Display the access list 2 Add member based on its Port/Node WWN 3 Delete member based on its Port/Node WWN select : (0..
PAGE 270
Telnet Commands 1 msPlatShow Display the Management Server platform database. Syntax msPlatShow Availability Admin Description Use this command to display the Management Server platform database. It displays the platform name and associated attributes of each platform object in the database. Limitations Platform database management is available in firmware version 2.3 and above. Lower-level firmware releases do not support Platform Database Management.
PAGE 271
Telnet Commands msPlClearDB Clear the Management Server platform database on all switches in the fabric. Syntax msPlClearDB Availability Admin Description Use this command to clear the entire Management Server platform database on all switches in the fabric. Since this operation is non-recoverable (once issued, the database will be erased), it should not be used unless it is intended to resolve a database conflict between two joining fabrics or to establish an entire new fabric with an empty database.
PAGE 272
Telnet Commands 1 msPlMgmtActivate Activate the Platform Database Management service on all switches in the fabric. Syntax msPlMgmtActivate Availability Admin Description Use this command to activate the Management Server Platform Database Management Service on all switches in the fabric. It is recommended that the admin user run the msPlCapabilityShow command before issuing this command. If any switch within the fabric cannot handle the Platform Management service, this command is rejected.
PAGE 273
Telnet Commands msPlMgmtDeactivate Deactivates the Platform Database Management service on all switches in the fabric. Syntax msPlMgmtDeactivate Availability Admin Description Use this command to deactivate the Platform Database Management service. This command deactivates the Platform Database Management service of each switch in the fabric and commits the changes to the nonvolatile storage of each switch.
PAGE 274
Telnet Commands 1 msTDDisable Disable the Management Server Topology Discovery Management service. Syntax msTdDisable ["ALL"] Availability Admin Description Use this command to disable the Management Server Topology Discovery Management Service locally or fabric-wide. This command will disable the Topology Discovery Management Service of the local switch and commit the changes to flash memory of the local switch.
PAGE 275
Telnet Commands msTDEnable Enable the Management Server Topology Discovery Management service. Syntax msTdEnable ["ALL"] Availability Admin Description Use this command to enable the Management Server Topology Discovery Management Service locally or fabric-wide. This command enables the Topology Discovery Management Service on the local switch and commits the change to the flash memory of the local switch. If the optional operand ALL is given, then the command is executed on the entire fabric.
PAGE 276
Telnet Commands 1 msTDReadConfig Display the status of Management Server Topology Discovery service. Syntax msTdReadConfig Availability All users Description Use this command to check whether the Management Server Topology Discovery service is enabled. Operands Example None To display the status of the Topology Discovery service: switch:admin> msTdReadConfig *MS Topology Discovery is Enabled.
PAGE 277
Telnet Commands myid Display the current login session details. Syntax myid Availability Admin Description Use this command to display the status of the system and the login session details. The status shows whether the system is Redundant, Non-Redundant, or Unknown.
PAGE 278
Telnet Commands 1 nbrStatsClear Reset FSPF interface counters. Syntax nbrStatsClear [slotnumber/][portnumber] Availability All users Description Use this command to reset the counters of FSPF frames transmitted and received on an interface. Use this command with no operand to reset counters on all interfaces. Operands This command has the following operands: slotnumber Specify the slot number in an ED-12000B switch. The slot number must be followed by a slash ( / ) and the port number.
PAGE 279
Telnet Commands Example To display how to reset the counters on port 4: switch:admin> nbrstatsclear 1/4 See Also interfaceShow portShow switchShow nbrStatsClear 1-263 1
PAGE 280
Telnet Commands 1 nbrStateShow Display FSPF neighbor’s state. Syntax nbrStateShow [slotnumber/][portnumber] Availability All users Description Use this command to display information about neighbors to the local switch, or information about a specific neighbor if a port number is supplied. A neighbor is a switch that is directly attached to the local switch.
PAGE 281
Telnet Commands Operands This command has the following operands: slotnumber Specify the slot number in an ED-12000B switch. The slot number must be followed by a slash ( / ) and the port number. The ED-12000B has a total of 10 slots counted from 1 to 10. Slot number 5 and 6 are control processor cards, and slot 1 through 4 and 7 through 10 are switch cards. On each switch card, there are 16 ports counted from the bottom 0 to 15.
PAGE 282
Telnet Commands 1 nsAllShow Display global Name Server information. Syntax nsAllShow [type] Availability All users Description Use this command to display the 24-bit Fibre Channel addresses of all devices in all switches in the fabric. If the operand type is supplied, only devices of specified FC-PH type are displayed. If type is omitted, all devices are displayed. Specifying the type operand causes the switch to send out a query to every switch in the fabric.
PAGE 283
Telnet Commands See Also nsShow switchShow nsAllShow 1-267 1
PAGE 284
Telnet Commands 1 nsShow Display local Name Server information. Syntax nsShow Availability All users Description Use this command to display local Name Server information, including information about devices connected to this switch, and cached information about devices connected to other switches in the fabric. The following message is displayed if there is no information in this switch: There is no entry in the Local Name Server There still may be devices connected to other switches in the fabric.
PAGE 285
Telnet Commands There may be additional lines if the device has registered any of the following information (the switch automatically registers SCSI inquiry data for FCP target devices): Operands Example ◆ FC4s supported ◆ IP address ◆ IPA ◆ Port and node symbolic names ◆ Fabric port name ◆ Hard address and/or port IP address None To display local name server information: switch:admin> nsShow }The Local Name Server has 1 entry { Type Pid COS PortName NodeName TTL(sec) N 060300; 2,3;10:00:00:
PAGE 286
Telnet Commands 1 passwd Change system login name and password. Syntax passwd [-o] ["user"] Availability All users Description Use this command to change the system passwords. The login names cannot be modified in v4.0. To change the password for a specific user, enter the command with the optional "user" operand. The password must have 6 to 8 characters. If more than 8 characters are entered, only the first 8 characters are used for password validation at user login.
PAGE 287
Telnet Commands Use the following options to control input: ENTER When entered at a prompt with no preceding input, accepts the default value (if applicable) and moves to the next prompt. CONTROL-D When entered at a prompt with no preceding input, terminates the command and saves changes made. This key combination may be different on your system. (end of file) Operands Example This command has the following operands: -o Specify this operand to turn off simplicity checks on the new password.
PAGE 288
Telnet Commands 1 Errors Table 1-19 All error messages are preceded by the command name with one of the messages appended as shown in Table 1-19: Error Messages Error Message Description User is not a valid user name. You have not specified a username that is a valid, recognized use name on the system. Permission denied. You do not have permission to change the login name or password specified. That user name is You cannot change the username to that of already being used.
PAGE 289
Telnet Commands perfAddEEMonitor Add end-to-end monitor to a port. Syntax perfAddEEMonitor [slotnumber/]portnumber, "SourceID", "DestID" Availability Admin Description Use this command to add an end-to-end monitor to a port. The monitor counts the number of words received, number of words transmitted, and number of CRC errors detected with frames qualified using either of following two conditions.
PAGE 290
Telnet Commands 1 After a successful execution of this command, a monitor number is displayed. The monitor number is provided for easy manipulation of these performance monitors. This command requires a Performance Monitoring license. Operands This command has the following operands: slotnumber Specify the slot number in an ED-12000B switch. The slot number must be followed by a slash ( / ) and the port number. The ED-12000B has a total of 10 slots counted from 1 to 10.
PAGE 291
Telnet Commands Example To add an end-to-end monitor to blade 7, pot 2: switch:admin> perfAddEEMonitor 7/2, "0x058e0f", "0x1182ef" End-to-End monitor number 0 added.
PAGE 292
Telnet Commands 1 perfAddIPMonitor Add a filter-based monitor for IP frame count. Syntax perfAddIPMonitor [slotnumber/]portnumber[, "alias"] Availability Admin Description Use this command to define filter-based monitors to count the number of IP traffic frames. After a successful execution of this command, a monitor number is displayed. The monitor number is provided for easy manipulation of these filter-based performance monitors.
PAGE 293
Telnet Commands Example portnumber Specify the port number where you want to add an IP frame monitor. Valid values for port numbers vary depending on the switch type. This operand is required. alias Specify a name for this monitor. This character string can be a maximum of 10 characters long and must be enclosed in quotation marks. This operand is optional. The default alias is IPFRAME.
PAGE 294
Telnet Commands 1 perfAddReadMonitor Add a filter-based monitor for the SCSI Read command. Syntax perfAddReadMonitor [slotnumber/]portnumber[, "alias"] Availability Admin Description Use this command to define filter-based monitors to count the number of SCSI FCP Read commands in Fibre Channel frames. After a successful execution of this command, a monitor number is displayed. The monitor number is provided for easy manipulation of these filter-based performance monitors.
PAGE 295
Telnet Commands portnumber Specify the port number where you want to add a SCSI Read frame monitor. Valid values port numbers vary depending on the switch type. This operand is required alias Specify a name for this monitor. This character string can be a maximum of 10 characters long and is truncated if more characters are specified. This operand must be enclosed in quotation marks. This operand is optional. The default alias is SCSI_RD.
PAGE 296
Telnet Commands 1 perfAddRWMonitor Add a monitor for the SCSI Read and Write commands. Syntax perfAddRWMonitor [slotnumber/]portnumber[, "alias"] Availability Admin Description Use this command to define filter-based monitors to count the number of SCSI FCP Read and Write commands in Fibre Channel frames. After a successful execution of this command, a monitor number is displayed. The monitor number is provided for easy manipulation of these filter-based performance monitors.
PAGE 297
Telnet Commands Example portnumber Specify the port number where you want to add a SCSI Read and Write frame monitor. Valid values for port numbers vary depending on the switch type. This operand is required. alias Specify a name for this monitor. This character string can be a maximum of 10 characters long and is truncated if more characters are specified. This operand must be enclosed in quotation marks. This operand is optional. The default alias is SCSI_RW.
PAGE 298
Telnet Commands 1 perfAddSCSIMonitor Add a monitor for SCSI frame count. Syntax perfAddSCSIMonitor [slotnumber/]portnumber[, "alias"] Availability Admin Description Use this command to define filter-based monitors to count the number of SCSI traffic frames. After a successful execution of this command, a monitor number is displayed. The monitor number is provided for easy manipulation of these filter-based performance monitors. The optional user-defined alias is also displayed if one was specified.
PAGE 299
Telnet Commands Example portnumber Specify the port number where you want to add a SCSI traffic frame monitor. Valid values for port numbers vary depending on the switch type. This operand is required. alias Specify a name for this monitor. This character string can be a maximum of 10 characters long and is truncated if more characters are specified. This operand must be enclosed in quotation marks. This operand is optional. The default alias is SCSI_Frame.
PAGE 300
Telnet Commands 1 perfAddUserMonitor Add a user-defined filter-based monitor. Syntax perfAddUserMonitor [slotnumber/]portnumber, "grouplist"[,"alias"] Availability Admin Description Use this command to define a special mechanism to qualify frames for statistics gathering to fit your own special need. Each group of elements with the same offset will have their comparison result (OR-ed) together before the combined result of each group gets (AND-ed) together for final comparison result.
PAGE 301
Telnet Commands Operands This command has the following operands: slotnumber Specify the slot number in an ED-12000B switch. The slot number must be followed by a slash ( / ) and the port number. The ED-12000B has a total of 10 slots counted from 1 to 10. Slot number 5 and 6 are control processor cards, and slot 1 through 4 and 7 through 10 are switch cards. On each switch card, there are 16 ports counted from the bottom 0 to 15.
PAGE 302
Telnet Commands 1 grouplist Specify up to 6 sets of Offset, Mask, and ValueList separated by a semicolon (;). The entire grouplist operand must be enclosed in quotation marks. This operand is required. The grouplist operand must be specified in the following format: "offset, Mask, ValueList; offset, Mask, ValueList" For example: "4, 0xff, 0x22; 12, 0xff, 0x01" The grouplist component values are as follows: Offset - Specify the offset within the frame.
PAGE 303
Telnet Commands alias Example Specify a name for this monitor. This character string can be a maximum of 10 characters long and is truncated if more characters are specified. This operand must be enclosed in quotation marks. This operand is optional.
PAGE 304
Telnet Commands 1 perfAddWriteMonitor Add a filter-based monitor for the SCSI Write command. Syntax perfAddWriteMonitor [slotnumber/]portnumber[, "alias"] Availability Admin Description Use this command to define filter-based monitors to count the number of SCSI FCP Write commands in Fibre Channel frames. After a successful execution of this command, a monitor number is displayed. The monitor number is provided for easy manipulation of these filter-based performance monitors.
PAGE 305
Telnet Commands Example portnumber Specify the port number where you want to add a SCSI Write command monitor. Valid values for port numbers vary depending on the switch type. This operand is required. alias Specify a name for this monitor. This character string can be a maximum of 10 characters long and is truncated if more characters are specified. This operand must be enclosed in quotation marks. This operand is optional. The default alias is SCSI_Write.
PAGE 306
Telnet Commands 1 perfCfgClear Clear the previously saved performance monitoring configuration settings from flash memory. Syntax perfCfgClear Availability Admin Description Use this command to clear the previously saved end-to-end and filter configuration settings (data structures) of performance monitoring from flash memory. This command requires a Performance Monitoring license.
PAGE 307
Telnet Commands perfCfgRestore Restore performance monitoring configuration settings from flash memory. Syntax perfCfgRestore Availability Admin Description Use this command to restore the performance monitoring configuration information from flash memory. This command requires a Performance Monitoring license.
PAGE 308
Telnet Commands 1 perfCfgSave Save performance monitoring configuration settings to flash memory. Syntax perfCfgSave Availability Admin Description Use this command to save the current end-to-end and filter configuration settings (data structures) of performance monitoring into flash memory. This enables the performance monitoring configuration to be saved over power off cycles. This command requires a Performance Monitoring license.
PAGE 309
Telnet Commands perfClrAlpaCrc Clear an ALPA device’s CRC count by the port and ALPA. Syntax perfClrAlpaCrc [slotnumber/]portnumber[, ALPA] Availability Admin Description Use this command to clear specific ALPA device's CRC error counter. If the ALPA is provided as an operand, only the counters for that device are reset; if no ALPA is specified this command clears the CRC counters for all ALPA devices on the specified port. This command requires a Performance Monitoring license.
PAGE 310
Telnet Commands 1 Example To clear CRC count on a particular ALPA on port 15, and then clear CRC count for all ALPAs on blade 2, port 15: switch:admin> perfClrAlpaCrc 2/15, 0x59 CRC error count at ALPA 0x59 on port 15 is cleared. switch:admin> switch:admin> perfClrAlpaCrc 2/15 This will clear all ALPA CRC Counts on port 15 Do you want to continue? [y|n]y Please wait ... All alpa CRC counts are cleared on port 15.
PAGE 311
Telnet Commands perfDelEEMonitor Delete an end-to-end monitor on port. Syntax perfDelEEMonitor [slotnumber/]portnumber[, monitorId] Availability Admin Description Use this command to delete an end-to-end monitor on a port. This command requires a Performance Monitoring license. Operands This command has the following operands: slotnumber Specify the slot number in an ED-12000B switch. The slot number must be followed by a slash ( / ) and the port number.
PAGE 312
Telnet Commands 1 Example To delete an end-to-end monitor on blade 7, port 2: switch:admin> perfDelEEMonitor 7/2, 5 End-to-End monitor number 5 deleted switch:admin> See Also 1-296 perfShowEEMonitor perfAddEEMonitor EMC Connectrix DS-32B2 and ED-12000B Fabric OS Reference Manual
PAGE 313
Telnet Commands perfDelFilterMonitor Delete a filter-based monitor. Syntax perfDelFilterMonitor [slotnumber/]portnumber[, monitorId] Availability Admin Description Use this command to delete a filter-based monitor. After a successful execution of this command, the telnet shell confirms that this monitor has successfully been deleted.
PAGE 314
Telnet Commands 1 Example portnumber Specify the port number where you want to remove a filter monitor. Valid values for port numbers vary depending on the switch type. This operand is required. monitorId Specify the monitor number you want to delete. Monitor numbers are defined when you create the monitor on a port. This operand is optional. If not specified, all monitors on the port are deleted.
PAGE 315
Telnet Commands perfHelp Display performance monitoring help information. Syntax perfHelp Availability All users Description Use this command to display the available performance monitoring help commands. This command requires a Performance Monitoring license.
PAGE 316
Telnet Commands 1 perfSetPortEEMask Set overall mask for end-to-end (EE) monitors. Syntax perfSetPortEEMask [slotnumber/]portnumber, "TxSIDMsk","TxDIDMsk","RxSIDMsk","RxDIDMsk" Availability Admin Description Use this command to set the mask for the EE monitors of a port. This command enables a user to selectively choose the kind of Fibre Channel frames in which the number of words are to be counted. EE monitors are defined by the perfAddEEMonitor command using SID and DID pairs.
PAGE 317
Telnet Commands Operands This command has the following operands: slotnumber Specify the slot number in an ED-12000B switch. The slot number must be followed by a slash ( / ) and the port number. The ED-12000B has a total of 10 slots counted from 1 to 10. Slot number 5 and 6 are control processor cards, and slot 1 through 4 and 7 through 10 are switch cards. On each switch card, there are 16 ports counted from the bottom 0 to 15.
PAGE 318
Telnet Commands 1 Example STxDIDMsk Specify the destination ID mask in dd:aa:pp format. This operand must be enclosed in quotation marks. This operand is required. RxSIDMsk Specify the source ID mask in dd:aa:pp format. This operand must be enclosed in quotation marks. This operand is required. RxDIDMsk Specify the destination ID mask in dd:aa:pp format. This operand must be enclosed in quotation marks. This operand is required.
PAGE 319
Telnet Commands perfShowAlpaCrc Display the ALPA CRC count by port or by ALPA. Syntax perfShowAlpaCrc [slotnumber/]portnumber[, ALPA] Availability Admin Description Use this command to display a specific ALPA device CRC error count by the port or ALPA. If the ALPA operand is specified, only the CRC count for that ALPA device is displayed. If the ALPA operand is not specified, the CRC count for all the ALPA devices on a specified port are displayed. CRC count is a 64-bit counter.
PAGE 320
Telnet Commands 1 Example portnumber Specify the port number where you want to count the CRC errors. Valid values for port numbers vary depending on the switch type. This operand is required. ALPA Specify the ALPA address if you want to get the CRC errors for a particular device. This operand is optional.
PAGE 321
Telnet Commands perfShowEEMonitor Display end-to-end monitor information and frame traffic on a port. Syntax perfShowEEMonitor [slotnumber/]portnumber[, interval] Availability Admin Description Use this command to display end-to-end monitor information and frame traffic on a port.
PAGE 322
Telnet Commands 1 Operands This command has the following operands: slotnumber Specify the slot number in an ED-12000B switch. The slot number must be followed by a slash ( / ) and the port number. The ED-12000B has a total of 10 slots counted from 1 to 10. Slot number 5 and 6 are control processor cards, and slot 1 through 4 and 7 through 10 are switch cards. On each switch card, there are 16 ports counted from the bottom 0 to 15.
PAGE 323
Telnet Commands Example To display end to end monitor frame traffic on blade 4, port 5 at an interval of every 6 seconds: switch:admin> perfShowEEMonitor 4/5, 6 perfShowEEMonitor 4 1: Tx/Rx are # of bytes and crc is # of crc errors 0 1 2 3 4 ------------ ------------------------------------------------crc Tx Rx crc Tx Rx crc Tx Rx crc Tx Rx crc Tx Rx ============= ============= ============= ============= ============= 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 53m 4.9m 0 53m 4.9m 0 53m 4.9m 0 53m 4.9m 0 53m 0 53m 4.
PAGE 324
Telnet Commands 1 perfShowFilterMonitor Display filter-based monitor information and frame traffic for a port. Syntax perfShowFilterMonitor [slotnumber/]portnumber[, interval] Availability Admin Description Use this command to display all the filter-based monitors defined on the specified port and the traffic count values.
PAGE 325
Telnet Commands Operands This command has the following operand: slotnumber Specify the slot number in an ED-12000B switch. The slot number must be followed by a slash ( / ) and the port number. The ED-12000B has a total of 10 slots counted from 1 to 10. Slot number 5 and 6 are control processor cards, and slot 1 through 4 and 7 through 10 are switch cards. On each switch card, there are 16 ports counted from the bottom 0 to 15.
PAGE 326
Telnet Commands 1 Example To display filter monitor traffic on blade 2, port 5 at an interval of every 6 seconds: switch:admin> perfshowfiltermonitor 2/5, 6 perfShowFilterMonitor 5 1 0 1 2 3 4 5 6 #Frames #CMDs #CMDs #Frames #Frames #CMDs #CMDs --------------------------------------------------------------0 0 0 0 0 0 0 26k 187 681 682 682 494 187 26k 177 711 710 710 534 176 26k 184 734 734 734 550 184 26k 182 649 649 649 467 182 26k 188 754 755 755 567 184 26k 183 716 716 717 534 183 26k 167 657 656 655
PAGE 327
Telnet Commands perfShowPortEEMask Displays the current end-to-end mask of a port. Syntax perfShowPortEEMask [slotnumber/]portnumber Availability Admin Description Use this command to display the current end-to-end mask of a port. There are only two commands that can modify the value of EE mask: perfSetPortEEMask and perfCfgRestore.
PAGE 328
Telnet Commands 1 Operands This command has the following operands: slotnumber Specify the slot number in an ED-12000B switch. The slot number must be followed by a slash ( / ) and the port number. The ED-12000B has a total of 10 slots counted from 1 to 10. Slot number 5 and 6 are control processor cards, and slot 1 through 4 and 7 through 10 are switch cards. On each switch card, there are 16 ports counted from the bottom 0 to 15.
PAGE 329
Telnet Commands portCfgEport Enable or disable a port from becoming an E_Port. Syntax portCfgEport [slotnumber/]portnumber, mode Availability Admin Description This command allows a user to enable/disable a port from becoming an E_Port. The E_Port capability is enabled by default unless this command is used to disable it. When a port is configured as a non-E_Port through this command, an ISL connected to this port will be segmented.
PAGE 330
Telnet Commands 1 portnumber Specify the port number to be configured. Valid values for port number vary depending on the switch type. This operand is required. mode Specify 1 to enable the port to become an E_Port. This is the default port state. Specify 0 to disable the port from becoming an E_Port. When the port operand is present, this operand must also be present. This operand is required. When no operands are specified, the command reports a list of ports that are disabled from becoming E_Ports.
PAGE 331
Telnet Commands portCfgGport Designates a port as a locked G_Port. Syntax portCfgEport [slotnumber/]portnumber, mode Availability Admin Description This command enables a user to designate a port as a locked G_Port. Once this is done, the switch attempts to initialize that port as an F_Port only, and does not attempt loop initialization (FL_Port) on the port.
PAGE 332
Telnet Commands 1 Example portnumber Specify the port number to be configured. Valid values for port number vary depending on the switch type. This operand is required. mode Specify a value of 1 to designate the port as a G_Port. Specify a value of 0 to remove the G_Port designation from the port. This is the default port state. This operand is required. The following example configures sblade 2, port 3 as a locked G_Port: switch:admin> portCfgGport 2/3, 1 done.
PAGE 333
Telnet Commands portCfgLongDistance Configure a port to support long distance links. Syntax portCfgLongDistance [slot/]port [, distance_level] [, VC_translation_link_init] Availability Admin Description Use this command to specify the allocation of enough full-size frame buffers on a particular port to support a long-distance link of up to 100 km. The port can be used as either an Fx_Port or an E_Port.
PAGE 334
Telnet Commands 1 level 1 long distance, and long for level 2 long distance. In the switchShow output, the format is Lx, where x is the long distance level number, except for level 0, which is not displayed in switchShow. Operands This command has the following operands: slotnumber Specify the slot number in an ED-12000B switch. The slot number must be followed by a slash ( / ) and the port number. The ED-12000B has a total of 10 slots counted from 1 to 10.
PAGE 335
Telnet Commands Limitations Since the total number of frame buffers is limited in quad, when one of the ports in the quad is configured as a long distance port, all remaining ports must be level zero ports only (that is, none of the remaining ports in the quad can be a long distance port). Further more, if one port is configured as a level 2 long distance port, none of the remaining ports in the quad can be used as an E_Port.
PAGE 336
Telnet Commands 1 portCfgLport Lock a port as an L_PORT. Syntax portCfgLport [slotnumber/]portnumber, lockmode[, privatemode] Availability Admin Description Use this command to designate a port as an L_PORT. The switch will then only attempt to initialize that port as an FL_PORT. The switch never attempts point-to-point (F_PORT) initialization on the port.
PAGE 337
Telnet Commands Example lockmode Specify 1 to configure the specified port as a locked L_PORT. Specify 0 to de-configure the specified port from its previous role as a locked L_PORT. This operand is required. privatemode Specify 1 to configure the L_PORT as a private L_PORT (then FLOGI will be rejected). Specify 0 to configure the L_PORT as a normal public L_PORT. The default value is 0. This operand is optional.
PAGE 338
Telnet Commands 1 portcfgMcastLoopback Configure a port to receive multicast frames. Syntax portCfgMcastLoopback port, mode Availability Admin Description Use this command to configure a port to receive multicast frames. This command allows a user to dedicate an unused port in a leaf (edge) switch, with no F_Port belonging to a multicast group, to receive multicast frames.
PAGE 339
Telnet Commands ◆ The comment field of switchShow will show that it is looped back to itself like so: port ◆ 3: sw No_Light The portFlags line of portShow will display the F_PORT and INT_LB flags like so: portFlags: 0x20249 ◆ Loopback->3 PRESENT F_PORT U_PORT INT_LB LED mcastShow will show the port as a member in its Member Ports column. Operands Example This command has the following operands: portnumber Specify the port number to be configured.
PAGE 340
Telnet Commands 1 portCfgShow Display port configuration settings. Syntax portCfgShow [slotnumber/][portnumber] Availability All users Description Use this command to display the current configuration of all ports. The following configuration information is displayed: 1-324 ◆ Port Speed is displayed as 1 G, 2 G, or AN (when in Auto speed Negotiation mode). This value is set by the portCfgSpeed command. ◆ Trunk Port is displayed as ON when port is set for trunking or blank (..
PAGE 341
Telnet Commands Operands This command has the following operands: slotnumber Specify the slot number in an ED-12000B switch. The slot number must be followed by a slash ( / ) and the port number. The ED-12000B has a total of 10 slots counted from 1 to 10. Slot number 5 and 6 are control processor cards, and slot 1 through 4 and 7 through 10 are switch cards. On each switch card, there are 16 ports counted from the bottom 0 to 15.
PAGE 342
Telnet Commands 1 portCfgSpeed Configure the port speed level. Syntax portCfgSpeed [slotnumber/]portnumber, speed_level Availability Admin Description Use this command to configure the speed of a port to a particular level. After this command is issued, the port is disabled and enabled so that the port comes up with the new speed setting. The configuration is saved in the nonvolatile memory and is persistent across switch reboot or power cycle.
PAGE 343
Telnet Commands speed_level Specify the speed of a port. This operand is optional. Valid values are one of the following: 0 Auto-sensing mode. The port automatically configures for the highest speed. 1 1 Gb/s mode. The port will be at fixed speed of 1 Gb/s. 2 2 Gb/s mode. The port will be at fixed speed of 2 Gb/s. Example To configure the speed of blade 2, port 5 to 2 Gb/s: switch:admin> portCfgSpeed 2/5, 2 done.
PAGE 344
Telnet Commands 1 portCfgTrunkport Configure a port to be enabled or disabled for trunking. Syntax portCfgTrunkport [slotnumber/]portnumber, mode Availability Admin Description Use this command to configure a port to be enabled or disabled for trunking. This command requires a Trunking license. Operands This command has the following operands: slotnumber Specify the slot number in an ED-12000B switch. The slot number must be followed by a slash ( / ) and the port number.
PAGE 345
Telnet Commands Example To enable blade 2, port 5 for trunking: switch:admin> portCfgTrunkport 2/5, 1 done.
PAGE 346
Telnet Commands 1 portDisable Disable a switch port. Syntax portDisable [slotnumber/]portnumber Availability Admin Description Use this command to disable a switch port. If the port is connected to another switch, the fabric may reconfigure. If the port is connected to one or more devices, the devices can no longer communicate with the fabric. If the port was on line before being disabled, the following indicate a state transition: RSCN, SNMP trap, Web pop-up window.
PAGE 347
Telnet Commands Example To disable blade 2, port 4: switch:admin> portDisable 2/4 switch:admin See Also portEnable portShow switchShow portDisable 1-331 1
PAGE 348
Telnet Commands 1 portEnable Enable a switch port. Syntax portEnable [slotnumber/]portnumber Availability Admin Description Use this command to enable a switch port. If the port is connected to another switch, the fabric may reconfigure. If the port is connected to one or more devices, the devices can communicate with the fabric. For ports that come on line after being enabled, the following indications may be sent to indicate a state transition: RSCN, SNMP trap, Web pop-up window.
PAGE 349
Telnet Commands Example To enable port 4: switch:admin> portEnable 2/4 switch:admin See Also portDisable portShow switchShow portEnable 1-333 1
PAGE 350
Telnet Commands 1 portErrShow Display port error summary. Syntax portErrShow Availability All users Description Use this command to display an error summary for all ports. The display contains one output line per port and shows error counters in ones, thousands (K), or millions (M). The following fields are displayed as shown in Table 1-21: Table 1-21 Operands 1-334 portErrShow Fields Fields Description frames tx Frames transmitted. frames rx Frames received.
PAGE 351
Telnet Commands Example The following example shows an eight-port switch.
PAGE 352
Telnet Commands 1 portLEDTest Exercise the user port LEDs. Syntax portLEDTest [-npass count | -port portlist] Availability Admin Description Use this command to exercise the LEDs on a switch blade. This command flashes the switch User Ports LEDs on and off by setting the ATTN LEDs to green for on condition and black for off condition. The SPEED LEDs are initially set to black before the command is executed. The SPEED LEDs are set to green once the command is executed.
PAGE 353
Telnet Commands portLogClear Clear the port log. Syntax portLogClear Availability Admin Description Use this command to clear the port log. You may want to clear the port log before triggering an activity so that the log displays only the activity related to that activity. See portLogShow for a description of the port log. If the port log is disabled, portLogClear enables it.
PAGE 354
Telnet Commands 1 portLogDump Display the port log without page breaks. Syntax portLogDump [count[, saved[, portid]]] Availability All users Description Use this command to display the port log, listing all entries in the log without page breaks. This command displays the same information as portLogShow, but portLogShow prompts the user to press ENTER between each page. Refer to portLogShow for a description of the port log.
PAGE 355
Telnet Commands Example To display the port log: switch:admin> portlogdump 10 May 1 task event port cmd args ---------------------------------------------16:51:15.499 tShell ioctl 7 de 10f9bb90,0 16:51:15.499 tShell ioctl 8 de 10f9bb90,0 16:51:15.499 tShell ioctl 9 de 10f9bb90,0 16:51:15.499 tShell ioctl 10 de 10f9bb90,0 16:51:15.499 tShell ioctl 11 de 10f9bb90,0 16:51:15.499 tShell ioctl 12 de 10f9bb90,0 16:51:15.499 tShell ioctl 13 de 10f9bb90,0 16:51:15.499 tShell ioctl 14 de 10f9bb90,0 16:51:15.
PAGE 356
Telnet Commands 1 portLogShow Display the port log. Syntax portLogShow [count[, saved, portid]] Availability All users Description Use this command to display the port log; 22 entries are displayed at a time. The portLogShow command displays the same information as portLogDump, but it allows you to press ENTER after each page of output. If the port log is disabled, the following message appears as the first line. Refer to portLogClear on page 1-337 command for more information.
PAGE 357
Telnet Commands Table 1-22 portLogShow Command Field Descriptions (continued) Field Possible Values Description Event Possible events are: start disable enable ioct Tx Rx scn pstate rejec busy ctin ctout errlog loopscn create debug nbrfsm sn fcin fcout read write err frame nsRemQ rscn xalloc xfree xerr xstate payload switch start or re-start event port is disabled port is enabled lport I/O control is executed frame is transmitted (class is indicated) frame is received (class is indicated) state chan
PAGE 358
Telnet Commands 1 Table 1-22 portLogShow Command Field Descriptions (continued) Field Possible Values Cmd Command value description depends on event type: ioctl Tx & Rx scn pstate ctin ctout errlog loopscn 1-342 Description debug message frame payload size new state (see state codes below) new physical state. Refer to Table 1-24 for a list of pstate code values.
PAGE 359
Telnet Commands Table 1-22 portLogShow Command Field Descriptions (continued) Field Possible Values Args The command arguments description depends on event type: Description start start type: 0 = enable ports, 100 = disable ports disablestate can be one of the following: 1 - Online, 2 - Offline, 3 - Testing, 4 - Faulty, 5 - E_Port, 6 - F_Port, 7 - Segmented. enablemode: 0 = normal, non-zero = loopback ioct lI/O control arguments. v.3.0 only.
PAGE 360
Telnet Commands 1 Table 1-23 State Code Description 1 Online 2 Offline 3 Testing 4 Faulty 5 E_Port 6 F_Port 7 Segmented Table 1-24 1-344 State Codes Pstate Codes Pstate Code Description LR1 Link Reset: LR Transmit State LR2 Link Reset: LR Receive State LR3 Link Reset: LRR Receive State LF1 Link Failure: NOS Transmit State LF2 Link Failure: NOS Receive State OL1 Offline: OLS Transmit State OL2 Offline: OLS Receive State OL3 Offline: Wait for OLS State EMC Connectrix D
PAGE 361
Telnet Commands Table 1-25 Table 1-26 Speed Negotiation States Speed Negotiation State Description ITIT start negotiation NM negotiate master WS wait for signal NF negotiation follow NC negotiation complete Lip Reason Codes LIP Reason Code Description 8001 Retry loop init 8002 Start loop after gaining sync 8003 Restart loop after port reset 8004 LIP when a loop hangs 8005 Restart loop if LIP received when sending out ARB(F0) 8006 LIP when an OPN returns 8007 Restart loop when L
PAGE 362
Telnet Commands 1 Operands Example This command has the following operands: count Specify the maximum number of lines to display. Only the most recent count entries are displayed. This operand is optional. saved Specify a nonzero value to display the saved port log from the last switch fault. See uptime for a list of conditions that cause a fault. count is ignored when displaying the saved log. This operand is optional. portid Specify the area number of ports to be displayed.
PAGE 363
Telnet Commands 17:05:31.775 17:05:31.775 17:05:31.777 17:05:31.778 17:05:31.779 17:05:31.
PAGE 364
Telnet Commands 1 portLoopbackTest Run functional test of port N->N path. Syntax portLoopbackTest [passCount] Availability Admin Description Use this command to verify the functional operation of the switch by sending frames from the port N transmitter, and looping the frames back into the same port N receiver. The loopback is done at the parallel loopback path. The path exercised in this test does not include the GBIC nor the fiber cable. Only one frame is transmitted and received at any one time.
PAGE 365
Telnet Commands At each pass, the frame is created from a different data type. If seven passes are requested, seven different data types are used in the test. If eight passes are requested, the first seven frames use unique data types, and the eighth is the same as the first. The seven data types are: 1. CSPAT: 0x7e, 0x7e, 0x7e, 0x7e, ... 2. BYTE_LFSR: 0x69, 0x01, 0x02, 0x05, ... 3. CHALF_SQ: 0x4a, 0x4a, 0x4a, 0x4a, ... 4. QUAD_NOT: 0x00, 0xff, 0x00, 0xff, ... 5. CQTR_SQ: 0x78, 0x78, 0x78, 0x78, .
PAGE 366
Telnet Commands 1 See Also 1-350 ramTest portRegTest centralMemoryTest cmiTest sramRetentionTest turboRamTest camTest statsTest filterTest spinSilk EMC Connectrix DS-32B2 and ED-12000B Fabric OS Reference Manual
PAGE 367
Telnet Commands portPerfShow Display port throughput performance in bytes, kilobytes, or megabytes. Syntax portPerfShow [interval] Availability All users Description Use this command to display throughput information for all ports on the switch (8 or 16 columns depending on the switch model). One output line is displayed per interval until ENTER, CONTROL-C, OR CONTROL-D is entered. Shown are the number of bytes received plus the number of bytes transmitted per interval.
PAGE 368
Telnet Commands 1 portRegTest Bit write/read test of the ASIC SRAMs and registers. Syntax portRegTest [-ports list][-skiptests mask] Availability Admin Description Use this command to verify that SRAM and register data bits in each ASIC can be independently written and read. To verify the data bits, write a walking 1 pattern to each location — write a pattern of 0x00000001 to register N, read, and compare to be sure that the pattern is the same.
PAGE 369
Telnet Commands Operands This command has the following operands: -ports list Specify a list of ports to test. By default all of the ports on the current blade will be tested. This option may be used to restrict the testing to specific ports. skiptests masks Specify a bit mask that defines which of the register test subtests to skip. By default all subtests will be performed. Valid mask values include one or more of the following: 0x2) Skip retry register test. 0x4) Skip statistics register test.
PAGE 370
Telnet Commands 1 portRouteShow Display routing tables for a port. Syntax portRouteShow [slotnumber/]portnumber Availability All users Description Use this command to display the port address ID and the contents of the port routing tables as shownin Table 1-27: Table 1-27 Port Routing Table Port Address ID Description External unicast routing table Shows unicast frame routing to another switch element in the fabric.
PAGE 371
Telnet Commands Table 1-27 Port Routing Table (continued) Port Address ID Description External unicast routing table Shows unicast frame routing to another switch element in the fabric. Output format is domain_number: ports_bitmap where: domain_number is the switch element number that a unicast frame can reach from the portnumber port. ports_bitmap contains all output ports, in bitmap hex format, that can forward unicast frames from port number to domain number.
PAGE 372
Telnet Commands 1 Operands This command has the following operands: slotnumber Specify the slot number in an ED-12000B switch. The slot number must be followed by a slash ( / ) and the port number. The ED-12000B has a total of 10 slots counted from 1 to 10. Slot number 5 and 6 are control processor cards, and slot 1 through 4 and 7 through 10 are switch cards. On each switch card, there are 16 ports counted from the bottom 0 to 15.
PAGE 373
Telnet Commands portShow Display port status. Syntax portShow [slotnumber/]portnumber Availability All users Description Use this command to display status information for a port. Information varies with the switch model and port type. The display is shown in Table 1-28: Table 1-28 PortShow Display Fields Field Description portFlags Bitmap of port status flags. portType Port type and revision numbers.
PAGE 374
Telnet Commands 1 Table 1-28 PortShow Display Fields (continued) Field Description portRegs Address of the port hardware registers. portData Address of the port driver private data. portId 24-bit D_ID for port. portWwn Port W orldWide Name. Distance The port’s long-distance level. Speed The port’s fixed speed level or negotiated speed level: 1 Gb/s - fixed speed of 1 Gb/s. N1 Gb/s - negotiated speed of 1 Gb/s. 2 Gb/s - fixed speed of Gb/s. N2 Gb/s - negotiated speed of 2 Gb/s.
PAGE 375
Telnet Commands Table 1-28 PortShow Display Fields (continued) Field Description Overrun Buffer overrun interrupts. Suspended Transmission suspended interrupts. Parity_err Real Tx data parity error. 2ndary_parity_err Secondary Tx data parity error. These are not real Tx data parity errors but rather forced by the ASIC due to certain central memory errors so that the transmitter will abort the frame. This field will only be displayed when there are errors.
PAGE 376
Telnet Commands 1 Example To display the status for a specified E_Port: switch:admin> portShow 2/15 portCFlags: 0x0 portFlags: 0x20001 PRESENT DISABLED LED portType: 1.
PAGE 377
Telnet Commands portStatsShow Display port hardware statistics. Syntax portStatsShow [slotnumber/]portnumber Availability All users Description Use this command to display port hardware statistics counters. Table 1-29 portStatsShowHardware Statistics stat_wtx 4-byte words transmitted. stat_wrx 4-byte words received. stat_ftx Frames transmitted. stat_frx Frames received. stat_c2_frx Class 2 frames received. stat_c3_frx Class 3 frames received. stat_lc_rx Link control frames received.
PAGE 378
Telnet Commands 1 Table 1-29 1-362 portStatsShowHardware Statistics (continued) fl_open Number of OPNyx sent. fl_opened Number of OPNyx received. fl_openfr Number of OPNfr sent. fl_cls_idle CLS sent due to loop idle. fl_cls_rx CLS received when OPEN. fl_bb_stall OPN/CLS BB_Credit stalls. fl_cf_alloc Number of CFIFOs allocated. fl_cf_opn CFIFOs delivered when OPENED. fl_cf_full Number of CFIFOs full stalls. fl_cf_na CFIFO not available stalls. fl_trig_age Number of age count triggers.
PAGE 379
Telnet Commands Operands This command has the following operand: slotnumber Specify the slot number in an ED-12000B switch. The slot number must be followed by a slash ( / ) and the port number. The ED-12000B has a total of 10 slots counted from 1 to 10. Slot number 5 and 6 are control processor cards, and slot 1 through 4 and 7 through 10 are switch cards. On each switch card, there are 16 ports counted from the bottom 0 to 15.
PAGE 380
Telnet Commands 1 Example To display the basic set of statistics for blade 2, port 3: switch:admin> portStatsShow 2/3 stat_wtx stat_wrx stat_ftx stat_frx stat_c2_frx stat_c3_frx stat_lc_rx stat_mc_rx stat_mc_to stat_mc_tx tim_rdy_pri tim_txcrd_z er_enc_in er_crc er_trunc er_toolong er_bad_eof er_enc_out er_disc_c3 open transfer opened starve_stop fl_tenancy nl_tenancy switch:admin> See Also 1-364 1181994 4-byte words transmitted 1188458 4-byte words received 95830 Frames transmitted 15564 Frames recei
PAGE 381
Telnet Commands powerOffListSet Set slot power off list order Syntax powerOffListSet Availability Admin Description Use this command to set the physical power off slot order. The system available power is compared to the system demand power to determine if there is enough power to operate. If there is less power available than the demand, then the power off list is processed until there is enough power for the system to operate.
PAGE 382
Telnet Commands 1 Example To modify the power off list order: switch12k:admin> powerOffListSet Slot Current POL ------------------10 1st 9 2nd 8 3rd 7 4th 4 5th 3 6th 2 7th 1 8th 1st 2nd 3rd 4th 5th 6th 7th 8th slot slot slot slot slot slot slot slot to to to to to to to to be be be be be be be be powered powered powered powered powered powered powered powered off: off: off: off: off: off: off: off: (1..10) [10] 1 (2..10) [9] 2 (3..10) [8] 3 (4..10) [7] 4 (7..10) [7] 10 (7..9) [8] 9 (7..
PAGE 383
Telnet Commands powerOffListShow Syntax powerOffListShow Availability All users Description Use this command to display the order in which the physical slots will be powered off. The system available power is compared to the system demand power to determine if there is enough power to operate. If there is less power available than the demand, then the power off list is processed until there is enough power for the system to operate.
PAGE 384
Telnet Commands 1 psShow Display power supply status. Syntax psShow Availability All users Description Use this command to display the switch power supply status. The display format varies with the number of power supplies present. Optionally, depending upon switch model, the OEM Serial ID Data is displayed after each power supply status line. The status of each supply is shown as: OK Power supply present and functioning correctly. absent Power supply not present.
PAGE 385
Telnet Commands See Also fanShow tempShow psShow 1-369 1
PAGE 386
Telnet Commands 1 ptdatashow Display port data structure. Syntax ptdatashow [slot]/port Availability All users Description Use this command to display the ASIC data structure contents for the specified port. Operands Example This command has the following operands: slot Specify the slot number of the blade where you want to view the port data structure. This operand is optional. port Specify the port within the blade to be displayed. Valid values for port number vary depending on switch type.
PAGE 387
Telnet Commands ptphantomshow Display port routing tables. Syntax ptphantomshow [slot/]port Availability All Users Description Use this command to display the ASIC routing table contents for the specified port. If the slot is not specified, then the slot specified with setslot is used. Operands Example This command has the following operands: slot Specify the slot number of the blade where you want to view the port routing tables. This operand is optional.
PAGE 388
Telnet Commands 1 ptpropshow Display port properties. Syntax ptpropshow [slot/]port | [slot] -all Availability All Users Description Use this command to display the ASIC port properties for the specified port. If the slot is not specified, then the slot specified with setslot is used. Operands Example This command has the following operands: [slot/]port Specify the slot number and port area number where you want to view the port properties. This operand is optional.
PAGE 389
Telnet Commands ptregshow Display ASIC port registers. Syntax ptpropshow [slot]/port Availability All Users Description Use this command to display the ASIC register contents for the specified port. If the slot is not specified, then the slot specified with setslot is used. Operands Example This command has the following operands: slot Specify the slot number of the blade where you want to view the ASIC register contents. This operand is optional.
PAGE 390
Telnet Commands 1 ptrouteshow Display port routing properties. Syntax ptrouteshow [slot]/port Availability All Users Description Use this command to display the ASIC port routing properties for the specified port. If the slot is not specified, then the slot specified with setslot is used. Operands Example This command has the following operands: slot Specify the slot number of the blade where you want to view the port routing properties. This operand is optional.
PAGE 391
Telnet Commands ptstatsshow Display port statistics properties. Syntax ptstatsshow [slot]/port Availability All Users Description Use this command to display the ASIC port statistic properties for the specified port. If the slot is not specified, then slot specified with setslot is used. Operands This command has the following operands: slot Specify the slot number of the blade where you want to view the port statistic properties. port Specify the port within the blade to be displayed.
PAGE 392
Telnet Commands 1 Example To view port statistics properties on port 1 on slot 8: switch:admin> portstatsshow 8/1 stat_wtx 8657 4-byte words transmitted stat_wrx 10118 4-byte words received stat_ftx 557 Frames transmitted stat_frx 566 Frames received stat_c2_frx 0 Class 2 frames received stat_c3_frx 2 Class 3 frames received stat_lc_rx 284 Link control frames received stat_mc_rx 1 Multicast frames received stat_mc_to 0 Multicast timeouts stat_mc_tx 0 Multicast frames transmitted tim_rdy_pri 0 Time R_RDY
PAGE 393
Telnet Commands qloopAdd Add a member to a QuickLoop. EMC does not support this command. Syntax qloopAdd "qloopname", "member;member" Availability Admin Description Use this command to add one or more members to an existing QuickLoop. When a configuration is enabled, all QuickLoops defined in the configuration must resolve to one or two switch worldwide names. Zone alias names entered as members of this QuickLoop must be defined with WWNs.
PAGE 394
Telnet Commands 1 qloopCreate Create a QuickLoop. EMC does not support this command. Syntax qloopCreate "qloopname", "member;member" Availability Admin Description Use this command to create a QuickLoop. A QuickLoop name must begin with a letter and be followed by any number of letters, digits, and underscore characters. Names are case sensitive, for example “Qloop_1” indicates a different QuickLoop than “qloop_1”. Blank spaces are ignored.
PAGE 395
Telnet Commands Example To create two QuickLoops, a single switch and one dual switch: switch:admin> qloopCreate "qlp1", "10:00:00:60:69:00:60:11" switch:admin> qloopCreate "qlp2", "wwn2; wwn3" See Also qloopAdd qloopDelete qloopRemove qloopShow qloopCreate 1-379 1
PAGE 396
Telnet Commands 1 qloopDelete Delete a QuickLoop. EMC does not support this command. Syntax qloopDelete "qloopName" Availability Admin Description Use this command to delete a QuickLoop. This command changes the Defined Configuration. For the change to be preserved across switch reboots, it must be saved to non-volatile memory using the cfgSave command. For the change to become effective, an appropriate zone configuration must be enabled using the cfgEnable command.
PAGE 397
Telnet Commands qloopRemove Remove a member from a QuickLoop. EMC does not support this command. Syntax qloopRemove "qloopName", "member;member" Availability Admin Description Use this command to remove one or more members from a QuickLoop. The member list is identified through an exact string match; therefore, when removing multiple members, order is important. For example, if a QuickLoop contains “wwn3; wwn4”, removing “wwn3; wwn4” succeeds, but removing “wwn4; wwn3” fails.
PAGE 398
Telnet Commands 1 Example To remove member “wwn2” from “qlp1”: switch:admin> qloopRemove "qlp1", "wwn2" See Also 1-382 qloopAdd qloopCreate qloopDelete qloopShow EMC Connectrix DS-32B2 and ED-12000B Fabric OS Reference Manual
PAGE 399
Telnet Commands qloopShow Display QuickLoop information. EMC does not support this command. Syntax qloopShow [pattern][, mode] Availability All users Description Use this command to display QuickLoop configuration information. If no parameters are specified, all zone configuration information (defined and enabled) is displayed. See cfgShow for a description of this display.
PAGE 400
Telnet Commands 1 Operands The following operands are optional: pattern Specify a POSIX style expression used to match QuickLoop names. Patterns may contain the following special characters: ◆ Question mark “?” that matches any single character ◆ Asterisk “*” that matches any string of characters ◆ Ranges “[0-9a-f]” that match any character within the range This operand is optional. mode Example Specify 1 to display the contents of RAM; specify 0 to display the contents of the transaction buffer.
PAGE 401
Telnet Commands ramTest Bit write and read test of SDRAMs in the switch. Syntax ramTest [patternSize] Availability Admin Description Use this command to verify the address and data bus of the SDRAMs that serve as CPU memory in the switch. The test consists of two subtests: ◆ The address subtest verifies that SDRAM locations can be uniquely accessed. The method used is to write a unique pattern to each location in the SDRAMs.
PAGE 402
Telnet Commands 1 Since the test requires the operating system to operate, and the operating system is loaded in the same memory, the test does not and cannot test all 16 MB of the memory. Instead, it tests the largest portion as given by the OS, which is typically about 13 MB. Operand This command has the following operand: patternSize Example Specify a number from 0 to 9 to determine the number of patterns used for the data subtest. The default value is 0 which runs all nine patterns.
PAGE 403
Telnet Commands reboot Reboot the switch. Syntax reboot Availability Admin Description The reboot command will reboot both logical switches and both CPs.Use this command to reboot both logical switches and both CPs. The reboot takes effect immediately as the switch resets, and then executes the normal power-on booting sequence. While the switch is rebooting, the telnet session is closed and all Fibre Channel ports are inactive. If the switch was part of a fabric, the remaining switches reconfigure.
PAGE 404
Telnet Commands 1 routeHelp Display routing help commands. Syntax routeHelp Availability Admin Description Use this command to display routing help commands.
PAGE 405
Telnet Commands savecore Save or remove core files created by daemons. Syntax savecore Availability Admin Description Use this command to transfer (by way of FTP) or remove core files that were created by daemons during signal processing such as SIGSEGV, SIGILL, etc. This command is menu driven so no operands are required. Operands Example None To remove core files from the current switch: switch:admin> savecore Welcome to core files management utility. Menu 1. Remove core files 2.
PAGE 406
Telnet Commands 1 sensorShow Display sensor readings. Syntax sensorShow Availability All users Description Use this command to display the current temperature, fan and power supply status and readings from sensors located on the switch. The actual location of the sensors varies depending on the switch type.
PAGE 407
Telnet Commands Example The output of this command is different between v3.0 and v4.0. Below is an example of the output of this command from v4.
PAGE 408
Telnet Commands 1 setesdmode Enable or disable ESD mode. Syntax setesdmode [mode | -show] Availability Admin Description Use this command to enable or disable ESD mode. The mode is saved in nonvolatile memory and stays in that mode until the next execution of setesdmode. The mode becomes active as soon as this command is executed. It does not require a reboot to take effect. When enabled, ESD mode modifies the behavior of the diagnostic test methods and post scripts.
PAGE 409
Telnet Commands setgbicmode Enable or disable GBIC mode. SSyntax setgbicmode [mode | -show] Availability Admin Description Use this command to enable or disable the GBIC mode. If the mode operand is 1, GBIC mode is enabled; if the mode operand is 0, GBIC mode is disabled. The mode is saved in flash memory and stays in the GBIC remains in that mode until the next execution of setGbicMode. The mode becomes active as soon as this command is executed. It does not require a reboot to take effect.
PAGE 410
Telnet Commands 1 setmfgmode Enable or disable Mfg mode. Syntax setmfgmode [mode | -show] Availability Admin Description Use this command to enable or disable Mfg mode. The mode is saved in non-volatile memory and stays in that mode until the next execution of setmfgmode. The mode becomes active as soon as this command is executed. It does not require a reboot to take effect. When enabled, Mfg mode modifies the behavior of the diagnostic test methods and post scripts.
PAGE 411
Telnet Commands setsfpmode Enable or disable SFP mode. Syntax setsfpmode [mode | -show] Availability Admin Description Use this command to enable or disable the SFP mode. If the mode operand is 1, SFP mode is enabled; if the mode operand is 0, SFP mode is disabled. The mode is saved in nonvolatile memory and the SFP remains in that mode until the next execution of setsfpmode. The mode becomes active as soon as this command is executed. It does not require a reboot to take effect.
PAGE 412
Telnet Commands 1 setSlot Set the default slot number for diagnostic commands. Syntax setslot slot Availability Admin Description Use this command to set the default slot number for diagnostic commands. This command will set the current slot, which will affect the default slot number for diagnostic commands until the next issue of this command. This command is for multi-blade systems, and should not be used in nonmulti-blade systems.
PAGE 413
Telnet Commands setSplbMode Enable or disable two port loopback. Syntax setSplbMode [mode | -show] Availability Admin Description Use this command to enable or disable SPLB mode. The mode is saved in flash memory and stays in that mode until the next execution of setSplbMode. The mode becomes active as soon as this command is executed. It does not require a reboot to take effect. When enabled, the SPLB mode forces the spinSilk command to disable two-port loopback for M-to-M connected ports.
PAGE 414
Telnet Commands 1 Example To enable or disable a two-port loopback: switch:admin> setSplbMode 1 Config update Succeded. SPLB mode is now 1 (Enabled). switch:admin> setSplbMode 0 Config update Succeded. SPLB mode is now 0 (disabled).
PAGE 415
Telnet Commands sfpShow Display serial ID SFP information. Syntax sfpShow [slotnumber/][portnumber] Availability All users Description Use this command to display information about serial identification SFPs (also known as module definition "4" SFPs). These SFPs provide extended information that describes the SFPs capabilities, interfaces, manufacturer, and other information. Use this command with no operand to display a summary of all SFPs in the switch.
PAGE 416
Telnet Commands 1 portnumber Example Specify a port number. Valid values for port number vary depending on the switch type. This operand is optional.
PAGE 417
Telnet Commands switch12k:admin> sfpshow 1/3 Identifier: 3 SFP Connector: 7 LC Transceiver: 050c402000000000 100,200_MB/s M5,M6 sw Inter_dist Encoding: 1 8B10B Baud Rate: 21 (units 100 megabaud) Length 9u: 0 (units 100 meters) Length 50u: 30 (units 10 meters) Length 625u: 13 (units 10 meters) Length Cu: 0 (units 1 meter) Vendor Name: FINISAR CORP. Vendor OUI: 00:90:65 Vendor PN: FTRJ-8519-3-2.
PAGE 418
Telnet Commands 1 slotOff Disable a blade slot. Syntax slotOff slot Availability Admin Description Use this command to disable a nonfaulty blade unit while leaving the blade unit powered on. Operand This command has the following operand: slot Example Specify the physical slot number of the blade to be disabled. This operand is required. To power off blade unit 3: switch:admin> slotOff 3 Slot 3 is being disabled.
PAGE 419
Telnet Commands slotOn Enable a blade slot. Syntax slotOn slot Availability Admin Description Use this command to reenable a blade unit that was previously disabled. Operand This command has the following operand: slot Example Specify the physical slot number of the blade to be enabled. This operand is required. To reenable blade unit 3: switch:admin> sloton 3 Slot 3 is being enabled.
PAGE 420
Telnet Commands 1 slotpoweroff Power off a blade unit. Syntax slotPowerOff slot Availability Admin Description Use this command to turn off the power to a blade unit. The slot must have a valid blade unit present and the blade unit must be of a type that can be powered off. Operand This command has the following operand: slot Example Specify the physical slot number of the blade to be powered down. This operand is required.
PAGE 421
Telnet Commands slotpoweron Power on a blade unit. Syntax slotPowerOn slot Availability Admin Description Use this command to turn on the power to a blade unit. The slot must have a valid blade unit present and the blade unit must be currently powered off. Operand This command has the following operand: slot Example Specify the physical slot number of the blade to be powered on. This operand is required. To power on blade unit 3: switch:admin> slotPowerOn 3 Powering on slot 3.
PAGE 422
Telnet Commands 1 slotShow Display slot status. Syntax slotShow Availability All users Description Use this command to inventory and display the current status of each slot in the system. The format of the display includes a header and four fields for each slot. The fields and their possible values are as follows: slot The physical slot number. Blade Type The blade type: ◆ ◆ ◆ ID 1-406 SW BLADE The blade is a Switch. CP BLADE The blade is a control processor.
PAGE 423
Telnet Commands Status The status of the blade: ◆ ◆ ◆ ◆ ◆ ◆ ◆ ◆ Operands Example VACANT The slot is empty. INSERTED, NOT POWERED ON The blade is present in the slot but is turned off. DIAG RUNNING POST1 The blade is present, powered on, and running the post initialization power-on self tests. DIAG RUNNING POST2 The blade is present, powered on, and running the POST (power-on self tests). ENABLED The blade is on and enabled. DISABLED The blade is powered on but disabled.
PAGE 424
Telnet Commands 1 See Also 1-408 chassisShow slotOn slotOff slotPowerOn slotPowerOff EMC Connectrix DS-32B2 and ED-12000B Fabric OS Reference Manual
PAGE 425
Telnet Commands snmpMibCapSet View and modify options for configuring SNMP MIB/Trap capability. Syntax snmpMibCapSet Availability Admin Description Use this command to turn on or off certain MIBs and TRAPs. This command also enables a user to turn on or off group information and SSN in SW trap messages. It first displays current settings and then prompts the user to change the values for each parameter.
PAGE 426
Telnet Commands 1 spinFab Test for Cascaded switch ISLs. Syntax spinfab [-nmegs nmill][-ports list][-setfail failmode] [-domain domain] Availability Admin Description Use this command to verify the intended functional operation of the ISLs between switches at the maximum speed of 2 Gb/s by setting up the routing hardware such that test frames received by each E_Port retransmitted on the same E_Port. Several frames are then sent to the neighbor port attached to each active E_Port specified.
PAGE 427
Telnet Commands Operands This command has the following operands: nmil The number of million frames per port to execute this test. If omitted, the default value used is 100. This operand is optional. ePortBeg First port to test, if omitted 0 will be used. This operand is optional. ePortEnd The last port to test. The test will be performed on ePortBeg to ePortEnd inclusive. If ePortEnd is omitted then the default will be to test all ports. This operand is optional. This operand is only used in v3.0.
PAGE 428
Telnet Commands 1 Examples This example is for v4.0. To run spinFab on ports 0-4: switch:admin> spinfab -nmegs 3 -ports 0-4 spinfab running... spinfab: Completed 3 megs, status: port 0 test status: 0x00000000 -port 1 test status: 0x00000000 -port 2 test status: 0x00000000 -port 3 test status: 0x00000000 -port 4 test status: 0x02000000 -Test... Diagnostics passed. passed. passed. passed. passed.
PAGE 429
Telnet Commands 0x3f 0x40 0x41 0x42 0x43 See Also STATS_C3FRX STATS MBUF_STATE_ERR FINISH_MSG_ERR RXQ_RAM_PERR crossPortTest portLoopbackTest spinSilk setDbg spinFab 1-413 1
PAGE 430
Telnet Commands 1 spinSilk Run functional test of port-to-port path at maximum switch speed. Syntax spinSilk [-nmegs nmill][-gbic_mode gbicmode][-lb_mode lbmode] [-spd_mode spdmode][-ports list] Availability Admin Description Use this command to verify the functional operation of the switch components. The spinsilk command may not be executed on an operational switch. You must first disable the switch using the switchDisable command.
PAGE 431
Telnet Commands At each pass, the frame is created from a different data type. There are seven data types: 1.CSPAT: 0x7e, 0x7e, 0x7e, 0x7e, ... 2.BYTE_LFSR: 0x69, 0x01, 0x02, 0x05, ... 3.CHALF_SQ: 0x4a, 0x4a, 0x4a, 0x4a, ... 4.QUAD_NOT: 0x00, 0xff, 0x00, 0xff, ... 5.CQTR_SQ: 0x78, 0x78, 0x78, 0x78, ... 6.CRPAT: 7.RANDOM: 0xbc, 0xbc, 0x23, 0x47, ... 0x25, 0x7f, 0x6e, 0x9a, ... If seven passes are requested, the seven different data types are used in the test.
PAGE 432
Telnet Commands 1 The connections between pairs of M-to-M ports are chosen to exercise the connections between as many ASICs as possible subject to the availability of pairs of M-to-M ports. ◆ ◆ ◆ In mode 1 with SPLB mode disabled, the spinsilk command only circulates frames within each single port and none of the ASIC-to-ASIC connections are tested. This mode should only be used for fault isolation. 2 for external loopback mode.
PAGE 433
Telnet Commands Operands This command has the following operands: nmill Specify the number of million frames to send. The test will progress until the specified number of frames has been transmitted on each port. The default value for nmill is 10, so the number of frames sent will be at least 10 million. lb_mode Specify the loopback point for the test. By default, spinsilk uses loopback plugs as described above.
PAGE 434
Telnet Commands 1 spdmode Specify the speed mode for the test. This parameter is only used for v3.0 and v4.0 series based switches where it controls the speed at which each port is operated. For 1G only products it is ignored. The exact operation of modes 3 through 6 depends upon the loopback mode selected. When speed modes 3 through 6 are used with cables, they must be connected EVEN to ODD or the test will fail. ◆ ◆ ◆ 0: set all ports’ speed for auto-negotiate.
PAGE 435
Telnet Commands Example To run spinsilk on a switch: switch:admin> switchdisable switch:admin> spinsilk Running Spin Silk ............. One moment please ... Waiting for Port(s) to Segment.
PAGE 436
Telnet Commands 1 sramRetentionTest Run data retention test of the miscellaneous SRAMs in ASIC. Syntax sramRetentionTest [passCount] Availability Admin Description Use this command to verify that data written into the miscellaneous SRAMs in the ASIC are retained after a 10-second wait. The test method is to write a fill pattern to all SRAMs, wait 10 seconds, and then read all SRAMs checking that data read matches data previously written.
PAGE 437
Telnet Commands See Also ramTest portRegTest centralMemoryTest cmiTest turboRamTest camTest statsTest filterTest portLoopbackTest spinSilk sramRetentionTest 1-421 1
PAGE 438
Telnet Commands 1 statsTest Run a statistics counter diagnostic test. Syntax statsTest [-passcnt passcount][-ports list] Availability Admin Description Use this command to verify the bloom statistics counter logic. It can run on every base port of quadrant, and send the frame through internal loopback with no CRC data to induce the CRC error. This command is also called from camtest. This test covers following statistics counter functionality. 1.
PAGE 439
Telnet Commands Diagnostics When it detects failure(s), the subtest may report one or more of the following error messages: DIAG-STSINIT DIAG-STSNULL DIAG-STSSID DIAG-STSXMIT DIAG-STSRCV DIAG-STSFRMCNT DIAG-STSWRDCNT DIAG-STSALPACNT Example To run a statistics counter test on a switch: switch:admin> statsTest Running Statistics Cnt Test ... passed.
PAGE 440
Telnet Commands 1 supportShow Display multiple test results for customer debugging. The supportShow command is used to gather switch information for debugging purposes. Your EMC Customer Service representative may ask you to run this command and capture the output. This information will aid Customer Service in diagnosing problems that could occur on the switch.
PAGE 441
Telnet Commands Example To display switch information for debugging: switch:admin> supportShow 4/0, 15 version: Kernel: 2.4.2 Fabric OS: 4.0.0 Made on: Thu Oct 25 00:58:55 2001 Flash: Thu Oct 25 00:58:55 2001 BootProm: Unknown uptime: 11:46pm up 4:39, 3 users, load average: 1.85, 1.45, 1.15 tempshow: Index Slot State Centigrade Fahrenheit ========================================================= 1 1 Absent 2 2 Absent 3 3 Absent 4 4 Ok 40 104 5 5 Ok 27 80 6 6 Absent < ... sample output truncated ...
PAGE 442
Telnet Commands 1 switchBeacon Set switch beaconing mode on or off. Syntax switchBeacon [mode] Availability Admin Description Use this command to set the switch beaconing mode on (if the operand is 1) or off (if the operand is 0). When beaconing mode is turned on, the port LEDs flash amber in a running pattern from port 0 to port 15, and then back again. The user sees a running pattern in amber LEDs, from left to right and right to left. The pattern continues until turned off by the user.
PAGE 443
Telnet Commands switchCfgSpeed Configure all ports of the switch to a particular speed level. Syntax switchCfgSpeed speed_level Availability Admin Description Use this command to configure the speed of all the ports on a switch to a particular level. The configuration is saved in the non-volatile memory and persists across switch reboot or power cycle. If the command is specified without an operand, you are prompted to enter the speed value. An input of CTRL-D cancels the configuration update.
PAGE 444
Telnet Commands 1 switchCfgTrunk Enable or disable trunking on all the ports of a switch. Syntax switchCfgTrunk [mode] Availability Admin Description Use this command to enable or disable trunking on all the ports of a switch. This command requires the Trunking license. Operand This command has the following operand: mode Example Specify 1 to enable trunking on all the ports on this switch. Specify 0 to disable trunking on all the ports on this switch. This operand is required.
PAGE 445
Telnet Commands switchdiag Run diagnostics on aDS-32B2 switch. Syntax switchdiag Availability Admin Description Use this command to run a suite of diagnostics tests on the specified switch. To run this command you must install loopback plugs on every port.
PAGE 446
Telnet Commands 1 passed. Test return status: 0 CentralMemoryTest Running centralmemorytest ............ passed. Test Complete: "centralmemorytest" Pass 1 of 1 Duration 0 hr, 0 min & 19 sec (0:0:19:611). passed.
PAGE 447
Telnet Commands switchdiagshort Run disagnostics on a DS-32B2. Syntax switchdiagshort Availability Admin Description Use this command to run a suite of diagnostics tests on the specified switch. To run this command you must install loopback plugs on every port.
PAGE 448
Telnet Commands 1 passed. Test return status: 0 CentralMemoryTest Running centralmemorytest ............ passed. Test Complete: "centralmemorytest" Pass 1 of 1 Duration 0 hr, 0 min & 19 sec (0:0:19:611). passed.
PAGE 449
Telnet Commands switchDisable Disable the switch. Syntax switchDisable Availability Admin Description Use this command to disable the switch. All Fibre Channel ports are taken off line; if the switch was part of a fabric, the remaining switches reconfigure. The switch must be disabled before making configuration changes (using configure or configDefault) or before running many of the diagnostic tests.
PAGE 450
Telnet Commands 1 switchEnable Enable the switch. Syntax switchEnable Availability Admin Description Use this command to enable the switch. All Fibre Channel ports that passed POST are enabled. They can come on line if connected to a device, or remain off line if disconnected. A switch may need to be enabled if it was previously disabled to make configuration changes or to run diagnostics. If the switch is connected to a fabric, it rejoins the fabric.
PAGE 451
Telnet Commands switchName Display or set switch name. Syntax Availability switchName ["newName"] All users (display) Admin (set) Description Use this command without an operand to display the current switch name. This name is also shown in the Telnet prompt, under each switch icon on the Web Tools Fabric View, and in the output of many Telnet commands. Use this command with the newName operand to assign a new switch name.
PAGE 452
Telnet Commands 1 switchReboot Halt and bring down the operational switch. Syntax switchReboot Availability Admin Description Use this command to reboot the operational switch without disrupting the other switch in the ED-12000B chassis. Use this command whenyou cannot determine the problem with the switch and want to bring it back to an operational state with out disturbing the software state of the system in general. This command is equal to running switchShutdown and switchStart.
PAGE 453
Telnet Commands switchShow Display switch and port status. Syntax switchShow Availability All users Description Use this command to display switch and port status information. Information may vary by switch model. Below is the information provided. The first section provides switch summary information; it is followed by a section covering summary information by port. Table 1-30 shows switch summary information: Table 1-30 Switch Summary Switch Description switchName Switch symbolic name.
PAGE 454
Telnet Commands 1 The switch summary is followed by one line per port: port number Port number. Valid values vary depending on the switch type.
PAGE 455
Telnet Commands comment Operands The comment field may be blank, or it may display: ◆ Disabled — port is disabled ◆ Bypassed — port is bypassed (loop only) ◆ Loopback — port is in loopback mode ◆ E_Port — fabric port, shows WWN and name of attached switch ◆ F_Port — point-to-point port, shows WWN of attached N_Port ◆ G_Port — point-to-point but not yet E_Port or F_Port ◆ L_Port — loop port, shows number of NL_Ports ◆ (Trunk master) -—This port is the master port in a group of trunking port
PAGE 456
Telnet Commands 1 Example The following example shows an ED-12000B: switch12000:admin> switchshow switchName: switchType: switchState: switchRole: switchDomain: switchId: switchWwn: switchBeacon: blade7: Beacon: switch12000 10.
PAGE 457
Telnet Commands The following example shows a DS-32B2: switch3900:admin> switchshow switchName: switch3900 switchType: 12.
PAGE 458
Telnet Commands 1 See Also 1-442 switchDisable switchEnable switchName EMC Connectrix DS-32B2 and ED-12000B Fabric OS Reference Manual
PAGE 459
Telnet Commands switchShutdown Halt the operational switch. Syntax switchShutdown Availability Admin Description This command halts the switch operation without disrupting the other switch in the ED-12000B chassis. This command must be used in combination with switchStart. This command brings down all the daemons associated with the switch; frees the resources and object states associated with the switch to a clear state and disables all the ports and blades associated with the switch.
PAGE 460
Telnet Commands 1 switchStart Initialize the switch to operational. Syntax switchStart Availability Admin Description This command initializes a logical switch without disrupting the other switch in the ED-12000B chassis. This command must be used in combination with switchShutdown. This command starts all the daemons associated with the switch, initializes the object states associated with the switch to a clear state, and enables all the ports/blades associated with the switch.
PAGE 461
Telnet Commands switchStatusPolicySet Set the policy parameters that determine the overall switch status. Syntax switchStatusPolicySet Availability Admin Description Use this command to set the policy parameters for calculating the overall status of the switch enclosure. The policy parameter values determine how many failed or faulty units of each contributor are allowed before triggering a status change in the switch from HEALTHY to MARGINAL or DOWN.
PAGE 462
Telnet Commands 1 status to DOWN. If two ports were faulty, then this contributor would set the overall switch status to DOWN. This command enables you to set a threshold for each contributor, so that a certain number of failures are required to change the overall status of the switch. If the value of a policy parameter is set to 0, then this factor is not used to determine the status of the switch.
PAGE 463
Telnet Commands Example Notice that in the following example, the only parameters modified are the number of Missing SFPs allowed before the status of the switch changes to MARGINAL and DOWN.
PAGE 464
Telnet Commands 1 switchStatusPolicyShow Display the policy parameters that determine the overall switch status. Syntax switchStatusPolicyShow Availability All users Description Use this command to view the current policy parameters set for the switch. These policy parameters determine the number of failed or nonoperational units allowed for each contributor before triggering a status change in the switch. The command will print the current parameters in a three-column table format.
PAGE 465
Telnet Commands Example To display the switch status policy: switch:admin> switchStatusPolicyShow The current overall switch status policy parameters: Down Marginal ---------------------------------FaultyPorts 1 0 MissingGBICs 0 1 PowerSupplies 2 1 Temperatures 3 1 Fans 3 1 PortStatus 0 0 ISLStatus 2 1 See Also switchStatusShow switchStatusPolicySet switchStatusPolicyShow 1-449 1
PAGE 466
Telnet Commands 1 switchStatusShow Display the overall status of the switch. Syntax switchStatusShow Availability All Users Description Use this command to display the overall status of the switch.
PAGE 467
Telnet Commands Example There are two examples below. The first shows a switch with a status of MARGINAL, the second shows the same switch after all the errors have been fixed.
PAGE 468
Telnet Commands 1 switchuptime Display the amount of time the switch has been operating. Syntax switchuptime Availability All users Description Use this command to display the current time and the amount of time the switch has been operational.
PAGE 469
Telnet Commands syslogdIpAdd Add the IP address of a syslog daemon. Syntax syslogdIpAdd IPaddress Availability Admin Description Use this command to add the IP address of a syslog daemon, that is, the IP address of the server that is running the syslogd process. Syslog daemon (syslogd) is a process available on most UNIX systems that reads and forwards system messages to the appropriate log files and/or users, depending on the system configuration.
PAGE 470
Telnet Commands 1 syslogdIpRemove Remove the IP address of a syslog daemon. Syntax syslogdIpRemove IPaddress Availability Admin Description Use this command to remove the IP address of a syslog daemon, that is, the IP address of the server which is running the syslogd process. Operands This command has the following operand: IPaddress Example Specify the IP address of the server running syslogd. This operand is required. To remove the address 192.168.1.
PAGE 471
Telnet Commands syslogdIpShow Display all syslog daemon IP addresses. Syntax syslogdIpShow Availability All users Description Use this command to display all syslog daemon IP addresses in the configuration database. Operands Example None To display all syslog daemon IP addresses: switch:admin> syslogdIpShow syslog.IP.address.1: 191.168.1.60 syslog.IP.address.2: 191.168.1.88 syslog.IP.address.3: 191.168.2.
PAGE 472
Telnet Commands 1 systemtest Run diagnostics on a switch blade. Syntax systemtest [-slot slot] Availability Admin Description Use this command to run a suite of diagnostics tests on the specified switch blade. To run this command you must install loopback plugs on every port.
PAGE 473
Telnet Commands Example To run a suite of diagnostics on blade 7: switch:admin> systemtest -slot 7 Testing slot: 7, user ports: 3 2 1 0 7 6 5 4 11 10 9 8 15 14 13 12 PortRegTest Running Port Register Test .... passed. Test Complete: "portregtest" Pass 1 of 1 Duration 0 hr, 2 min & 23 sec (0:2:23:443). passed. Test return status: 0 CentralMemoryTest Running centralmemorytest ............ passed. Test Complete: "centralmemorytest" Pass 1 of 1 Duration 0 hr, 0 min & 19 sec (0:0:19:611). passed.
PAGE 474
Telnet Commands 1 tempShow Display temperature readings. Syntax tempShow Availability All users Description Use this command to display the current temperature readings from each of the five temperature sensors located on the main printed circuit board of the switch. The sensors are located, approximately, one in each corner and one at the center of the PCB.
PAGE 475
Telnet Commands timeOut Set or clear the idle Telnet connection time-out value. Syntax Availability timeOut [timeval] All users (display) Admin (show/set) Description Use this command with no operands to display the current telnet timeout value. Use this command with an operand to sets the idle timeout value to the specified minutes. Using a timeout value of zero will disable the timeout functionality so that login sessions would never be disconnected.
PAGE 476
Telnet Commands 1 topologyShow Display the unicast fabric topology. Syntax topologyShow [domainnumber] Availability All users Description Use this command to display the fabric topology, as it appears to the local switch. This includes: ◆ A list of all domains that are part of the fabric, and to each of those domains, all possible paths from the local switch.
PAGE 477
Telnet Commands Table 1-33 Operand TopologyShow Fields (continued) Field Description Out Port: Area number of the port that incoming frame will be forwarded to, in order to reach the destination domain. Use the switchshow command to view the area numbers for the switch. In Ports: Area number of the input ports that use the corresponding Out Port to reach the destination domain. This is the same information provided by portRouteShow and uRouteShow.
PAGE 478
Telnet Commands 1 Examples To display the unicast fabric topology: switch:admin> topologyShow 2 domains in the fabric; Local Domain ID: 1 Domain: 6 Metric: 500 Name: cylon218 Path Count: 4 Hops: 1 Out Port: 60 In Ports: None Total Bandwidth: 2 Gbps Bandwidth Demand: 0 % Flags: D See Also 1-462 Hops: Out Port: In Ports: Total Bandwidth: Bandwidth Demand: Flags: 1 61 None 2 Gbps 0 % D Hops: Out Port: In Ports: Total Bandwidth: Bandwidth Demand: Flags: 1 62 None 2 Gbps 0 % D Hops: Out Port: In Ports:
PAGE 479
Telnet Commands trackChangesSet Enable configuring of Track Changes feature. Syntax trackChangesSet [ mode ], [ snmptrapmode ] Availability Admin Description Use this command to enable or disable the Track Changes feature. An SNMP-TRAP mode can also be enabled. Trackable changes are: ◆ Successful login ◆ Unsuccessful login ◆ Logout ◆ Config file change from task ◆ Track Changes on ◆ Track Changes off The output from the Track Changes feature is dumped to the error log for the switch.
PAGE 480
Telnet Commands 1 Example The following example shows how to use this command in v4.0: switch12000:admin> trackchangesset 1, 1 Committing configuration...done.
PAGE 481
Telnet Commands trackChangesShow Display status of Track Changes feature. Syntax trackChangesShow Availability All users Description Use this command to display status of the Track Changes feature. It shows if the feature is turned on or off and if SNMP trap are generated. The output from the Track Changes feature is dumped to the error log for the switch. Use the errDump command or errShow command to view the error log.
PAGE 482
Telnet Commands 1 trunkDebug Debug a trunk link failure. Syntax trunkDebug port1, port2 Availability Admin Description Use this command to debug a trunk link failure.
PAGE 483
Telnet Commands trunkShow Display trunking information. Syntax trunkShow Availability All users Description Use this command to display trunking information. The fields displayed are shown in Table 1-34: Table 1-34 Operands Example trunkShow Fields Fields Description Trunking Group Number Trunking groups on a switch. All the ports that are part of this trunking group are displayed. Port to port connections Port-to-port trunking connections. WWN WWN of the connected port.
PAGE 484
Telnet Commands 1 turboRamTest Run the turbo SRAM logic test for 2Gb ASICs. Syntax turboRamTest [passcount] Availability Admin Description This command verifies the on-chip SRAM located in the 2 Gb ASIC using the Turbo-Ram BIST circuitry. These SRAMS are tested by portRegTest and sramRetentionTest using PCI operations, but for this test the BIST controller is able to perform the SRAM write and read operations at a much faster rate.
PAGE 485
Telnet Commands Example To execute this test: switch:admin> turboRamTest Running Turbo RAM Test ........ passed. Diagnostics When it detects failure(s), the subtest may report one or more of the following error messages: DIAG-WTEST — Memory fill operation failed. DIAG-IN_RWTEST — Memory r-m-w increment subtest failed. DIAG-DEC_RWTEST — Memory r-m-w decrement subtest failed. DIAG-RAMINIT_TO — Memory initialization timed out.
PAGE 486
Telnet Commands 1 uptime Display length of time the system has been operational. Syntax uptime Availability All users Description Use this command to show the current time, how long the system has been up, the number of users currently logged in, and the system load averages for the last 1, 5, or 15 minutes. Operands Example None To display the uptime for a switch: switch12000:admin> uptime 5:24pm up 43 days, 6:39, 5 users, load average: 1.62, 1.49, 1.
PAGE 487
Telnet Commands uRouteConfig Configure a static route. Syntax uRouteConfig InArea, Domain, OutArea Availability Admin Description Use this command to configure static routes. A static route is assigned a specific path; the path does not change with a topology change unless the path becomes unavailable. After this command is issued, and if OutArea is a usable port, all frames coming in from InArea port addressed to Domain will be forwarded through OutArea port.
PAGE 488
Telnet Commands 1 Examples To configure a static route for all traffic coming in from port 1 and addressed to domain 2 to go through port 5: switch:admin> uRouteConfig 1,2,5 done. switch:admin> configShow route.ucastRoute.1.2:5 route.
PAGE 489
Telnet Commands uRouteRemove Remove a static route. Syntax uRouteRemove InArea, Domain Availability Admin Description Use this command to remove a configured static route. When this command is issued, the route to Domain for InArea may or may not change. It changes if the previous static route was not along a minimum cost path. After this command is issued, the load sharing to the domain is re-evaluated. InArea can be either an F_Port or an E_Port.
PAGE 490
Telnet Commands 1 uRouteShow Display unicast routing information. Syntax uRouteShow [slotnumber/] [portnumber],[domainnumber] Availability All users Description Use this command to display the unicast routing information for a port, as it is known by the FSPF path selection and routing task. The routing information describes how a frame, that is received from a port on the local switch, is to be routed to reach a destination switch.
PAGE 491
Telnet Commands Table 1-35 uRouteShow Fields (continued) Fields Description Hops: Maximum number of hops required to reach the destination domain. Flags: Indicates if route is dynamic (D) or static (S). A dynamic route is discovered automatically by the FSPF path selection protocol. A static route is assigned using the command uRouteConfig. Next (Dom, Port): Domain and port number of the next hop. These are the domain number and the port number of the switch to which Out Port is connected.
PAGE 492
Telnet Commands 1 Examples portnumber Specify the port number you want to view the unicast routing information for. Valid values for port number vary depending on the switch type. This operand is optional. domainnumber Displays routing information for the specified port and domain. This operand is optional. This operand should only be specified when the port number is specified.
PAGE 493
Telnet Commands version Display firmware version information. Syntax version Availability All users Description Use this command to display firmware version information and build dates. The following is displayed as shown in Table 1-36: Table 1-36 Firmware Version Information Kernel: Version of switch kernel operating system. Fabric OS: Version of switch Fabric OS. Made on: Build date of firmware running in switch. Flash: Build date of firmware stored in flash proms.
PAGE 494
Telnet Commands 1 Example To display firmware version information on an ED-12000B: switch12k:admin> version Kernel: 2.4.2 Fabric OS: v4.0.0 Made on: Fri Feb 1 23:02:08 2002 Flash: Fri Feb 1 18:03:35 2002 BootProm: 3.1.
PAGE 495
Telnet Commands wwn View a switch WWN. Syntax wwn Availability All users Description Use this command to display the WWN of a switch. All switches have a numeric address that is the unique Fibre Channel address used for communicating with the switch. The WWN is shown in the output of the switchShow command.
PAGE 496
Telnet Commands 1 zoneAdd Add a member to the zone. Syntax zoneAdd "zoneName", "member/member" Availability Admin Description Use this command to add one or more members to an existing zone. This command requires a Zoning license. Operands This command has the following operands: zoneName Specify the name of an existing zone, in quotation marks. member Specify a member or list of members to be added, in quotation marks, separated by semicolons.
PAGE 497
Telnet Commands zoneCreate Create a zone. Syntax zoneCreate "zoneName", "member/member" Availability Admin Description Use this command to create a new zone. This command requires a Zoning license. A zone name is a C-style name beginning with a letter and followed by any number of letters, digits, and underscore characters. Names are case-sensitive; for example, "Zone_1" indicates a different zone thand "zone_1". Blank spaces are ignored.
PAGE 498
Telnet Commands 1 Specify a QuickLoop AL_PA as a QuickLoop name followed by a list of AL_PAs, for example "qloop1[01,02]". QuickLoop names have the same format as zone names, and are created with the qloopCreate command to define a switch or pair of switches that form the QuickLoop. Specify a zone alias name using the same format as a zone name. It is created with the aliCreate command. The alias must resolve to a list of one or more of the following: • For v3.
PAGE 499
Telnet Commands Operands This command has the following operands: zoneName Name for a zone to be created, in quotation marks. This name cannot be used for any other zone object. member Specify a member or list of members to be added, in quotation marks, separated by semicolons. Valid values can be one or more of the following: ◆ ◆ ◆ ◆ Example: A switch domain and port area number pair. For example, "2,20". View the area numbers for ports using the switchShow command. Node or port WWN.
PAGE 500
Telnet Commands 1 zoneDelete Delete a zone. Syntax zoneDelete "zoneName" Availability Admin Description Use this command to delete a zone. This command requires a Zoning license. Operand This command has the following operand: zoneName Example Name for a zone to be deleted, in quotation marks. This operand is required.
PAGE 501
Telnet Commands zoneHelp Display help information on zone commands. Syntax zoneHelp Availability All users Description Use this command to display help information on zone commands.
PAGE 502
Telnet Commands 1 cfgClear cfgDisable cfgEnable cfgSave Clear all zone configurations Disable a zone configuration Enable a zone configuration Save zone configurations in flash cfgTransAbort Abort zone configuration transaction switch:admin> See Also 1-486 zoneAdd zoneCreate zoneRemove zoneShow EMC Connectrix DS-32B2 and ED-12000B Fabric OS Reference Manual
PAGE 503
Telnet Commands zoneRemove Remove a member from a zone. Syntax zoneRemove "zoneName", "member;member" Availability Admin Description Use this command to remove one or more members from an existing zone. A member list is located by an exact string match, therefore, it is important to maintain the order when removing multiple members. For example, if a zone contains "array2; array3; array4", removing "array3; array4" succeeds, but removing "array4; array3" fails.
PAGE 504
Telnet Commands 1 zoneShow Display zone information. Syntax zoneShow ["pattern"], [, mode] Availability All users Description Use this command to display zone configuration information. If no parameters are specified, all zone configuration information (both defined and enabled) is displayed. See cfgShow for a description of this display. If a parameter is specified, it is used as a pattern to match zone configuration names, and those that match in the defined configuration are displayed.
PAGE 505
Telnet Commands Example To show all zones beginning with the letters "A" thruogh "C": switch:admin> zoneShow "[A-C]*" zone: Blue_zone 1,1; array1; 1,2; array2 See Also zoneAdd zoneCreate zoneDelete zoneRemove zoneShow 1-489 1
PAGE 506
Telnet Commands 1 1-490 EMC Connectrix DS-32B2 and ED-12000B Fabric OS Reference Manual
PAGE 507
2 Invisible Body Tag License Telnet Commands This chapter summarizes the commands that are only available with a license key. ◆ ◆ ◆ ◆ ◆ ◆ Zoning Commands ............................................................................2-2 Extended Fabric Command..............................................................2-4 Extended Fabric Command..............................................................2-4 Fabric Watch Commands ..................................................................
PAGE 508
License Telnet Commands 2 Zoning Commands The following commands are available with the purchase of a Zoning license key. For detailed information about zoning, refer to the EMC Connectrix Departmental Switch DS-32B2 and Enterprise Director ED-12000B Zoning User Guide. Table 2-1 Zoning Commands Command Description Zone Alias aliAdd Add a member to a zone alias. aliCreate Create a zone alias. aliDelete Delete a zone alias. aliRemove Remove a member from a zone alias.
PAGE 509
License Telnet Commands Table 2-1 Zoning Commands (continued) Command Description cfgDisable Disable a zone configuration. cfgEnable Enable a zone configuration. cfgSave Save zone configurations in flash memory. cfgTransAbort Abort the current zoning transaction.
PAGE 510
License Telnet Commands 2 Extended Fabric Command The following command is available with the purchase of a Extended Fabrics license key. For detailed information about Extended Fabrics refer to the EMC Connectrix Departmental Switch DS-32B2 and Enterprise Director ED-12000B Extended Fabrics User Guide. Table 2-2 2-4 Extended Fabric Command Command Description portCfgLongDistance Configure a port to support long distance links.
PAGE 511
License Telnet Commands Fabric Watch Commands The following commands are available with the purchase of a Fabric Watch license key. For detailed information about Fabric Watch, refer to the EMC Connectrix Departmental Switch DS-32B2 and Enterprise Director ED-12000B Fabric Watch User Guide. Table 2-3 Fabric Watch Commands Command Description fwAlarmsFilterSet Enable or disable alarms for Fabric Watch. fwAlarmsFilterShow Display alarm filtering for Fabric Watch.
PAGE 512
License Telnet Commands 2 Trunking Commands The following commands are available with the purchase of a Trunking license key. For more detailed information about trunking, refer to the EMC Connectrix Departmental Switch DS-32B2 and Enterprise Director ED-12000B ISL Trunking User Guide. Table 2-4 2-6 Trunking Commands Command Description portCfgTrunkport Configure a port for trunking. switchCfgTrunk Configure a switch for trunking. trunkDebug Debug a trunking connection.
PAGE 513
License Telnet Commands Performance Monitoring Commands The following commands are available with the purchase of an Advanced Performance Monitoring license key. For more detailed information about Performance Monitoring, refer to the EMC Connectrix Departmental Switch DS-32B2 and Enterprise Director ED-12000B Performance Monitoring User Guide. Table 2-5 Performance Monitoring Commands Command Description perfAddEEMonitor Add an end-to-end monitor to a port.
PAGE 514
License Telnet Commands 2 2-8 EMC Connectrix DS-32B2 and ED-12000B Fabric OS Reference Manual
PAGE 515
3 Invisible Body Tag Fabric OS Version Comparison This chapter summarizes the commands available in v3.0 and v4.0. ◆ Command Differences Between Versions.......................................
PAGE 516
Fabric OS Version Comparison 3 Command Differences Between Versions This table provides a list of which commands are available in v3.0 and in v4.0. It also provides notes on differences that may exist for a particular command between versions. Table 3-1 3-2 Fabric OS Command Version Support Command Supported in v3.0 Supported in v4.0 agtcfgDefault Yes Yes agtcfgSet Yes Yes agtcfgShow Yes Yes aliasDelete Yes No Not supported in v4.0 aliasJoin Yes No Not supported in v4.
PAGE 517
Fabric OS Version Comparison Table 3-1 Fabric OS Command Version Support (continued) Command Supported in v3.0 Supported in v4.0 Notes bsn Yes No Not supported in v4.0. Functionality was replaced by chassisshow command in v4.0.
PAGE 518
Fabric OS Version Comparison 3 Table 3-1 3-4 Fabric OS Command Version Support (continued) Command Supported in v3.0 Supported in v4.0 Notes crossPortTest Yes Yes New operands in v4.0 dataTypeShow Yes Yes date Yes Yes diagClearError Yes Yes diagCommandShow No Yes diagDisablePost Yes Yes diagEnablePost Yes Yes diagesdPorts No Yes New command for v4.0 diagfailLimit No Yes New command for v4.0 diagHelp Yes Yes diagloopid No Yes New command for v4.
PAGE 519
Fabric OS Version Comparison Table 3-1 Fabric OS Command Version Support (continued) Command Supported in v3.0 Supported in v4.0 Notes errShow Yes Yes fabricShow Yes Yes fabStatsShow Yes Yes fanDisable No Yes New command for v4.0 fanEnable No Yes New command for v4.0 fanShow Yes Yes faStatsShow Yes No fastboot Yes Yes fazoneAdd Yes Yes Specify members using area number in v4.0 fazoneCreate Yes Yes Specify members using area number in v4.
PAGE 520
Fabric OS Version Comparison 3 Table 3-1 3-6 Fabric OS Command Version Support (continued) Command Supported in v3.0 Supported in v4.0 Notes fwConfigure Yes Yes New Environmental Classes in v4.0 fwFruCfg No Yes New command for v4.
PAGE 521
Fabric OS Version Comparison Table 3-1 Fabric OS Command Version Support (continued) Command Supported in v3.0 Supported in v4.0 Notes ipAddrSet Yes Yes This command has unique parameters based on switch type ipAddrShow Yes Yes This command displays unique information based on switch type licenseAdd Yes Yes licenseHelp Yes Yes licenseIdShow No Yes licenseRemove Yes Yes licenseShow Yes Yes linkCost Yes Yes logout Yes Yes loopdiagClear Yes No Not supported in v4.
PAGE 522
Fabric OS Version Comparison 3 Table 3-1 3-8 Fabric OS Command Version Support (continued) Command Supported in v3.0 Supported in v4.0 Notes msPlCapabilityShow Yes No Renamed in v4.0 to the msCapabilityShow command msPlClearDB Yes Yes msPlMgmtActivate Yes Yes msPlMgmtDeactivate Yes Yes msTdDisable Yes Yes msTdEnable Yes Yes msTdReadConfig No Yes New command for v4.0 myid No Yes New command for v4.
PAGE 523
Fabric OS Version Comparison Table 3-1 Fabric OS Command Version Support (continued) Command Supported in v3.0 Supported in v4.
PAGE 524
Fabric OS Version Comparison 3 Table 3-1 3-10 Fabric OS Command Version Support (continued) Command Supported in v3.0 Supported in v4.0 portPerfShow Yes Yes portRegTest Yes Yes New operands for v4.0 portRouteShow Yes Yes Addition of the slot operand portShow Yes Yes Addition of the slot operand portStatsShow Yes Yes Addition of the slot operand powerOffListSet No Yes New command for 4.0 powerOffListShow No Yes New command for 4.
PAGE 525
Fabric OS Version Comparison Table 3-1 Fabric OS Command Version Support (continued) Command Supported in v3.0 Supported in v4.0 Notes qlShow Yes No Not supported in v4.0 qlStatsShow Yes No Not supported in v4.0 quietMode Yes No Not supported in v4.0 ramTest Yes No Not supported in v4.0 reboot Yes Yes Reboots entire chassis in ED-12000B routeHelp Yes Yes sensorShow Yes Yes setesdmode No Yes New command for v4.0 setmfgmode No Yes New command for v4.
PAGE 526
Fabric OS Version Comparison 3 Table 3-1 3-12 Fabric OS Command Version Support (continued) Command Supported in v3.0 Supported in v4.
PAGE 527
Fabric OS Version Comparison Table 3-1 Fabric OS Command Version Support (continued) Command Supported in v3.0 Supported in v4.0 Notes uRouteConfig Yes Yes Addition of the area parameter uRouteRemove Yes Yes Addition of the area parameter uRouteShow Yes Yes Addition of the slot operand version Yes Yes Output modified in v4.0 wwn Yes Yes zoneAdd Yes Yes Specify members using area number in v4.0 zoneCreate Yes Yes Specify members using area number in v4.
PAGE 528
Fabric OS Version Comparison 3 3-14 EMC Connectrix DS-32B2 and ED-12000B Fabric OS Reference Manual
PAGE 529
4 Invisible Body Tag Fabric and Switch Management This chapter explains the different methods used to manage a SAN for DS-32B2 and ED-12000B switches. ◆ ◆ ◆ ◆ ◆ ◆ Overview .............................................................................................4-2 User Access Level...............................................................................4-3 Fabric OS Command Line Interface ................................................4-4 Web Tools ............................................
PAGE 530
Fabric and Switch Management 4 Overview The DS-32B2 and ED-12000B switches can be managed using several local and remote access methods. In order to manage a switch, you must have access to one of the available management methods: ◆ Fabric OS command line interface ◆ Web Tools ◆ Fabric Watch ◆ Management Server Telnet, SNMP, and Web Tools require that the switch be accessible using a network connection. The network connection can be from the switch Ethernet port (out of band).
PAGE 531
Fabric and Switch Management User Access Level There are two levels of user access for the DS-32B2 and ED-12000B switches. ◆ Admin ◆ User In Fabric OS v4.0, each user access level can have the following number of simultaneous logins: Table 4-1 DS-32B2 and ED-12000B User Access Maximum Sessions User Name Maximum Number of Simultaneous Sessions Admin 2 User 4 Web Tools 4 In Fabric OS v3.0 and earlier, multiple user access to a switch is limited.
PAGE 532
Fabric and Switch Management 4 Fabric OS Command Line Interface The Fabric OS command line interface (CLI) accessed through telnet or serial console provides the user with the full range of management capability on a DS-32B2 and ED-12000B switch. The Fabric OS CLI enables an administrator to monitor and manage entire fabrics, individual switches, and ports from a standard workstation. The entire suite of Fabric OS features and capabilities is available across an entire fabric, from a single access point.
PAGE 533
Fabric and Switch Management Web Tools Web Tools provides a graphical interface that allows the administrator to monitor and manage entire fabrics and individual switches and ports from a standard workstation. It is an optionally licensed product that runs on Fabric OS. All switches in the fabric are displayed in the main window of Web Tools, including switches that do not have a Web Tools license.
PAGE 534
Fabric and Switch Management 4 Fabric Watch Fabric Watch software monitors the performance and status of Fibre Channel networks and DS-32B2 and ED-12000B switches, and can alert SAN managers when problems arise. The real-time alerts from Fabric Watch software help SAN managers solve problems before they become costly failures.
PAGE 535
Fabric and Switch Management Management Server The Management Server allows an Storage Area Network (SAN) management application to retrieve and administer the fabric and interconnect elements such as switches, servers, and storage devices. An access control list (ACL) of WWN addresses determines which systems have access to the Management Server database. If the list is empty (default), the Management Server is accessible to all systems connected in-band to the fabric.
PAGE 536
Fabric and Switch Management 4 4-8 EMC Connectrix DS-32B2 and ED-12000B Fabric OS Reference Manual
PAGE 537
5 Invisible Body Tag Control Processor Commands This chapter lists the commands available when logged into the Active CP and Standby CP in an ED-12000B. ◆ ◆ Active CP Commands .......................................................................5-2 Standby CP Commands ....................................................................
PAGE 538
Control Processor Commands 5 Active CP Commands When logged into the Active CP, the full suite of commands are supported (subject to which license keys are installed). When logged in to the Active CP, most commands are still specific to a single logical switch. That is, they are executed on one logical switch but not the other. If you are logged in to the Active CP through the console port, you are prompted to specify the logical switch on which commands are executed on.
PAGE 539
Control Processor Commands Standby CP Commands The following commands are supported when logged in to the Standby CP. Table 5-1 ED-12000B Standby CP Commands Command Notes date Print/set the system date and time. fastboot Reboot switch, bypassing the POST. firmwarecommit Commit firmware to stable storage. firmwaredownload Download firmware into the switch. h Display shell history. hashow Display high-availability status. help Display help commands available in the standby CP.
PAGE 540
Control Processor Commands 5 5-4 EMC Connectrix DS-32B2 and ED-12000B Fabric OS Reference Manual
PAGE 541
A nvisible Body Tag Customer Support This appendix reviews the EMC process for detecting and resolving software problems, and provides essential questions that you should answer before contacting the EMC Customer Support Center. This appendix covers the following topics: ◆ ◆ ◆ ◆ ◆ ◆ Overview of Detecting and Resolving Problems .........................A-2 Troubleshooting the Problem ..........................................................A-3 Before Calling the Customer Support Center .................
PAGE 542
Customer Support A Overview of Detecting and Resolving Problems EMC software products are supported directly by the EMC Customer Support Center in the United States. EMC uses the following process to resolve customer problems with its software products (Figure A-1). Problem Detection Refer to Customer Support Appendix in this Manual Collect Problem Information as Directed Contact the EMC Customer Support Center: (800) SVC-4EMC U.S.
PAGE 543
Customer Support Troubleshooting the Problem Please perform the relevant diagnostic steps before you contact the EMC Customer Support Center: 1. Read the documentation carefully. 2. Reconstruct the events leading up to the problem and describe them in writing. 3. Run some test cases to reproduce the problem.
PAGE 544
Customer Support A Before Calling the Customer Support Center Have the following information available before calling the Customer Support Center or your support representative (if one has been assigned to you): ❑ Your company name ❑ Your name ❑ Your phone number ❑ For an existing problem, the problem tracking system ID, if one was previously assigned to the problem by a support representative A-4 EMC Connectrix DS-32B2 and ED-12000B Fabric OS Reference Manual
PAGE 545
Customer Support Documenting the Problem If the EMC Customer Support Center requests information regarding the problem, please document it completely, making sure to include the following information: ❑ Your company name and address ❑ Your name ❑ Your telephone number ❑ The importance of the problem, so that it can be assigned a priority level To expedite the processing of your support request, you can photocopy this list and include it with the package.
PAGE 546
Customer Support A Reporting a New Problem For a new problem, please provide the following information: ❑ Release level of the software that you are running ❑ Software installation parameters ❑ Host type on which you are running ❑ Operating system you are running and its release number ❑ Functions of the software that you are running ❑ Whether you can reproduce the problem ❑ Previous occurrences of the problem ❑ Whether the software has ever worked correctly ❑ Time period that the software did work proper
PAGE 547
Customer Support Sending Problem Documentation Use one of the following methods to send documentation of the problem to the EMC Customer Support Center: ◆ Email ◆ FTP ◆ U.S. Mail to the following address: EMC Customer Support Center 45 South Street Hopkinton, MA 01748-9103 If the problem was assigned a number or a specific support representative, please include that information in the address as well.
PAGE 548
Customer Support A A-8 EMC Connectrix DS-32B2 and ED-12000B Fabric OS Reference Manual
PAGE 549
Glossary The terms in the glossary relate to the switch and Fibre Channel connections. Many of these terms are used in this manual. Numbers 8b/10b Encoding 16-Port Card An encoding scheme that converts each 8-bit byte into 10 bits. Used to balance ones and zeros in high speed transports. The fibre channel port card provided with ED-12000B. Contains 16 fibre channel ports and the corresponding LEDs indicating port status and speed. See also Port Card.
PAGE 550
Glossary Alias Address Identifier An address identifier recognized by a port in addition to its standard identifier. An alias address identifier may be shared by multiple ports. Alias Server A fabric software facility that supports multicast group management. AL_PA ANSI Arbitrated loop physical address. A unique 8-bit value assigned during loop initialization to a port in an arbitrated loop. American National Standards Institute. The governing body for Fibre Channel standards in the U.S.A.
PAGE 551
Glossary BB_Credit Beacon Buffer-to-buffer credit. The number of frames that can be transmitted to a directly connected recipient or within an arbitrated loop. Determined by the number of receive buffers available. See also Buffer to Buffer Flow Control and EE_Credit. When all the port LEDs on a switch are set to flash from one side of the switch to the other, to enable identification of an individual switch in a large fabric. A switch can be set to beacon by tTlnet command or through Web Tools.
PAGE 552
Glossary Buffer to Buffer Flow Control Management of the frame transmission rate in either a point-to-point topology or in an arbitrated loop. See also BB_Credit. C Cascade Chassis The metal frame in which the switch and switch components are mounted. Circuit An established communication path between two ports. Consists of two virtual circuits capable of transmitting in opposite directions. See also Link.
PAGE 553
Glossary Community (SNMP) Compact Flash Configuration A relationship between a group of SNMP managers and an SNMP agent, in which authentication, access control, and proxy characteristics are defined. See also SNMP. Flash memory that stores the run time operating system and is used like hard disk storage. Not visible within the processor’s memory space. Data is stored in file system format. How a system is set up. May refer to hardware or software.
PAGE 554
Glossary D Data Word Type of transmission word that occurs within frames. The frame header, data field, and CRC all consist of data words. See also Frame, Ordered Set, and Transmission Word. DB-9 Connector A 9-pin version of the RS-232C port interface. May be either the male or female interface. See also RS-232 Port. dBm, dBW Logarithmic units of power used in electronics. Indicates signal strength in decibels above the reference level, which is 1 milliwatt for dBm, and 1 watt for dBW.
PAGE 555
Glossary DTE Port A data terminal equipment port capable of interfacing to a transmission circuit through a connection to a DCE (data communications equipment) port. DTE devices with an RS-232 (or (EIA-232) port interface transmit on pin 3, and receive on pin 2 in a 9-pin connection (reversed in 25-pin connectors). See also DCE Port and RS-232 Port. DWDM Dense wavelength multiplexing.
PAGE 556
Glossary ESN Enterprise Storage Network. A storage network implementation that integrates products, technology, and services offering universal data access for every major computing platform, operating system, and application across any combination of SCSI, Ultra SCSI, Fibre Channel, and ESCON technologies. Exchange The highest level Fibre Channel mechanism used for communication between N_Ports. Composed of one or more related sequences, and can work in one or both directions.
PAGE 557
Glossary FCP FC-PH-1, 2, 3 FC-PI FC-PLDA Fibre Channel Protocol. Mapping of protocols onto the Fibre Channel standard protocols. For example, SCSI FCP maps SCSI-3 onto Fibre Channel. The Fibre Channel Physical and Signalling Interface standards defined by ANSI. The Fibre Channel Physical Interface standard defined by ANSI. The Fibre Channel Private Loop Direct Attach standard defined by ANSI. Applies to the operation of peripheral devices on a private loop.
PAGE 558
Glossary FLOGI Fabric Login. The process by which an N_Port determines whether a fabric is present, and if so, exchanges service parameters with it. See also PLOGI. FL_Port Fabric loop port. A port that is able to transmit under fabric protocol and also has arbitrated loop capabilities. Can be used to connect an NL_Port to a switch. See also F_Port and Fx_Port. Frame The Fibre Channel structure used to transmit data between ports.
PAGE 559
Glossary Gateway Hardware that connects incompatible networks by providing translation for both hardware and software. For example, an ATM gateway can be used to connect a Fibre Channel link to an ATM connection. GBIC Gigabit interface converter. A removable serial transceiver module that allows gigabaud physical level transport for Fibre Channel and Gigabit Ethernet.
PAGE 560
Glossary I Idle Initiator Continuous transmission of an ordered set over a Fibre Channel link when no data is being transmitted, to keep the link active and maintain bit, byte, and word synchronization. A server or workstation on a Fibre Channel network that initiates communications with storage devices. See also Target. Integrated Fabric The fabric created by connecting multiple switches with multiple ISL cables, and configuring the switches to handle traffic as a seamless group.
PAGE 561
Glossary L L_Port Loop port. A node port (NL_Port) or fabric port (FL_Port) that has arbitrated loop capabilities. An L_Port can be in one of two modes: • Fabric mode: Connected to a port that is not loop capable, and using fabric protocol. • Loop mode: In an arbitrated loop and using loop protocol. An L_Port in loop mode can also be in participating mode or nonparticipating mode . See also Nonparticipating Mode and Participating Mode.
PAGE 562
Glossary Multicast Multimode The transmission of data from a single source to multiple specified N_Ports (as opposed to all the ports on the network). See also Broadcast and Unicast. A fiber-optic cabling specification that allows up to 500 meters for 1 GB Fibre Channel and 300 meters for 2 GB Fibre Channel between devices. N N_Port Name Server Node Negotiate NL_Port Nonparticipating Mode Nx_Port Node port.
PAGE 563
Glossary P Packet A set of information transmitted across a network. See also Frame. Participating Mode A mode in which an L_Port in a loop has a valid AL_PA and can arbitrate, send frames, and retransmit received transmissions. See also L_Port and Nonparticipating Mode. Path Selection PLOGI Point-to-Point Port_Name Port Cage Port Card Port Module POST The selection of a transmission path through the fabric. EMC switches use the FSPF protocol. Port Login.
PAGE 564
Glossary Private NL_Port Protocol An NL_Port that communicates only with other private NL_Ports in the same loop and does not log in to the fabric. A defined method and a set of standards for communication. Public Device A device that supports arbitrated loop protocol, can interpret 8-bit addresses, and can log in to the fabric. Public Loop An arbitrated loop that includes a participating FL_Port, and may contain both public and private NL_Ports.
PAGE 565
Glossary Route As applies to a fabric, the communication path between two switches. May also apply to the specific path taken by an individual frame, from source to destination. See also SFP. Routing The assignment of frames to specific switch ports, according to frame destination. RS-232 Port A port that conforms to a set of EIA (Electrical Industries Association) standards. Used to connect DTE and DCE devices for communication between computers, terminals, and modems. See also DCE Port and DTE Port.
PAGE 566
Glossary SI SID/DID Sequence initiative. Source identifier/destination identifier. S_ID is a 3-byte field in the frame header that is used to indicate the address identifier of the N_Port from which the frame was sent. Single Mode A Fibre Channel optic cabling standard for use with long-wavelength lasers operating in the infrared portion of the spectrum at 1300 nonmeters (nm). SNMP Simple Network Management Protocol.
PAGE 567
Glossary Terminal Serial Port The lower serial port on the CP card. Receives error messages. Can be used to connect the CP card to a computer terminal. Has a DB-9 connector wires as a ttyS0 DTE device, and can be connected by serial cable to a DCE device. The connector has pins two and three swapped so that a straight-through cable can be used to connected to a terminal. See also DB-9 Connector, DCE Port, and Modem Serial Port. Throughput The rate of data flow achieved within a cable, link, or system.
PAGE 568
Glossary ULP ULP_TOV Upper-level Protocol. The protocol that runs on top of Fibre Channel. Typical upper-level protocols are SCSI, IP, HIPPI, and IPI. Upper-level time-out value. The minimum time that a SCSI ULP process waits for SCSI status before initiating ULP recovery. Unicast The transmission of data from a single source to a single destination. See also Broadcast and Multicast. User Account A login intended for use by the customer to monitor, but not control, switch operation.
PAGE 569
Glossary Zone Schemes Zone Set The level of zoning granularity selected. For example, zoning may be done by switch/port, WWN, or a mixture. See also Zone Configuration. See Zone Configuration.
PAGE 570
Glossary g-22 EMC Connectrix DS-32B2 and ED-12000B Fabric OS Reference Manual
PAGE 571
Index A agtcfgDefault 1-8 agtcfgSet 1-11 agtcfgShow 1-15 aliasDelete 1-18 aliasJoin 1-19 aliasPurge 1-21 aliasShow 1-22 B backplanetest 1-32 backport 1-35 bcastShow 1-38 bladeBeacon 1-40 bladediag 1-42 bladediagshort 1-44 bladePropShow 1-46 C camTest 1-47 centralMemoryTest 1-49 chassisName 1-69 chippropshow 1-73 chipregshow 1-75 cmemRetentionTest 1-76 cmiTest 1-77 configDefault 1-79 configDownload 1-80 configShow 1-82 configUpload 1-84 configure 1-86 crossPortTest 1-98 Customer support A-3 Customer Supp
PAGE 572
Index F L fabStatsShow 1-146 fanDisable 1-147 fanEnable 1-148 fanShow 1-149 fastboot 1-150 fazoneAdd 1-151 fazoneCreate 1-153 fazoneDelete 1-156 fazoneRemove 1-157 fazoneShow 1-159 filterTest 1-161 firmwareCommit 1-164 firmwareDownload 1-165 firmwarerestore 1-169 fspfShow 1-170 fwHelp 1-184 fwMailCfg 1-185 licenseAdd 1-227 licenseHelp 1-228 licenseIdShow 1-229 licenseRemove 1-230 licenseShow 1-231 linkCost 1-232 login 1-235 logout 1-236 LSDbShow 1-238 lutil 1-242 G gbicShow 1-192 H h command 1-196 haD
PAGE 573
Index portLogDump 1-338 portLogShow 1-340 portLoopbackTest 1-348 portPerfShow 1-351 portRegTest 1-352 portRouteShow 1-354 portShow 1-357 portStatsShow 1-361 psShow 1-368 ptdatashow 1-370 ptphantomshow 1-371 ptpropshow 1-372, 1-373, 1-374 ptstatsshow 1-375 Q qloopAdd 1-377 qloopCreate 1-378 qloopDelete 1-380 qloopRemove 1-381 qloopShow 1-383 R ramTest 1-385 reboot 1-387 routeHelp 1-388 S savecore 1-389 sensorShow 1-390 setesdmode 1-392 setGbicMode 1-393 setmfgmode 1-394 setslot 1-396 setSplbMode 1-397 sf
PAGE 574
Index i-4 EMC Connectrix DS-32B2 and ED-12000B Fabric OS Reference Manual