Page 1 HP StorageWorks Fabric OS 5.x command reference guide Part number: AA–RVHVB–TE Second edition: September 2005...
Page 2 © Copyright 2005, Brocade Communications Systems, Incorporated. Hewlett-Packard Company makes no warranty of any kind with regard to this material, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. Hewlett-Packard shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material.
Page 3: Table Of Contents
Contents About this guide ..........13 Intended audience .
Page 4 cfgRemove..............88 cfgSave.
Page 5 fabStateShow..............192 fabStatsShow .
Page 6 historyMode ..............295 historyShow .
Page 7 perfCfgRestore ..............410 perfCfgSave.
Page 8 portStats64Show ............. . 514 portStatsClear .
Page 9 sfpShow ..............625 shellFlowControlDisable.
Page 10 turboRamTest ..............731 txdPath .
Page 11 Role permissions ............. 18 Command output descriptions .
Page 12 Contents...
Page 13: About This Guide
About this guide This reference guide provides information to help you: • Understand and use Fabric Operating System (Fabric OS) commands • Manage a switch or fabric NOTE: FICON is not supported on HP B-Series Fibre Channel switches. The FICON information in this document is included for reference only.
Page 14: Document Conventions And Symbols
Document conventions and symbols Table 1 Document conventions Convention Element Medium blue text: Figure 1 Cross-reference links and e-mail addresses Medium blue, underlined text Web site addresses (http://www.hp.com) Key names Bold font • • Text typed into a GUI element, such as into a box •...
Page 15: Hp Technical Support
HP technical support Telephone numbers for worldwide technical support are listed on the HP support web site: http://www.hp.com/support/. Collect the following information before calling: • Technical support registration number (if applicable) • Product serial numbers • Product model names and numbers •...
Page 17: Fabric Os Command Line Interface
1 Fabric OS command line interface This chapter explains the different methods used to manage HP SAN and HP StorageWorks switches. The following information is discussed: • Understanding access levels, page 17 • Using the Fabric OS command line interface, page 18 •...
Page 18: Using The Fabric Os Command Line Interface
except the ability to perform zone and security configuration and user management. See Table 3 for a high-level description of role permissions. Table 3 Role permissions Functional Area user switchAdmin admin Zone configuration View View Modify Environmental View Modify Modify Logs (RAS) View Modify...
Page 19: Using This Guide
• Access to the full range of Fabric OS features, based on which license keys you purchase • Assistance with configuration, monitoring, dynamic provisioning, and daily management of every aspect of storage area networks • A deeper view of the tasks involved in managing a StorageWorks switch or director •...
Page 20 Fabric OS command line interface...
Page 21: Fabric Os Commands
2 Fabric OS commands This chapter lists the Fabric OS commands. It also shows their syntax and operands, and provides examples of their usage. Fabric OS 5.x command reference guide...
Page 22: Aaaconfig
aaaConfig Manages RADIUS configuration information. Synopsis aaaconfig [action] [options] Availability admin Description Use this command to manage the RADIUS configuration for the authentication, authorization, and accounting (AAA) services. This command displays, adds, removes, changes, enables, or disables RADIUS configuration. When the command completes, any new configuration is saved persistently. It is effective for the next AAA request.
Page 23 The following provides a detailed description of each action type: List the current RADIUS servers, along with their parameters. --show Fabric OS 5.x command reference guide...
Page 24 --add server [-p port] [-s secret] [-t timeout] [-a chap | pap] Add the specified server to the end of the RADIUS configuration list, with the specified port number, shared secret, timeout, and if PAP or CHAP is to be used as authentication protocol.
Page 25: Agtcfgdefault
agtCfgDefault Resets the SNMP agent configuration to default values. Synopsis agtcfgdefault Availability admin Description Use this command to reset the SNMP agent configuration with the switch default values. This command prompts the user and proceeds to reset only on the user’s confirmation. All new values successfully configured by the command take effect immediately.
Page 26 are sent to the trap recipients. By default, this value is set to 0, implying that no such traps are sent. Possible values are as follows: none critical error warning informational debug for related information. errModuleShow The ACL check is as follows: there are six ACLs to restrict SNMP get/set/trap operations to hosts under a host-subnet-area.
Page 27 SNMPv1 community and trap recipient configuration: Community 1: Secret C0de (rw) Trap recipient: 192.168.15.41 Trap recipient Severity level: 4 Community 2: OrigEquipMfr (rw) No trap recipient configured yet Community 3: private (rw) No trap recipient configured yet Community 4: public (ro) No trap recipient configured yet Community 5: common (ro) No trap recipient configured yet...
Page 28 SNMPv1 community and trap recipient configuration: Community 1: Secret C0de (rw) No trap recipient configured yet Community 2: OrigEquipMfr (rw) No trap recipient configured yet Community 3: private (rw) No trap recipient configured yet Community 4: public (ro) No trap recipient configured yet Community 5: common (ro) No trap recipient configured yet Community 6: FibreChannel (ro)
Page 29: Agtcfgset
agtCfgSet Modifies the SNMP agent configuration. Synopsis agtcfgset Availability admin Description Use this command to modify the configuration of the SNMP agent in the switch. All values successfully configured by this command take effect immediately. These values are persistent across power cycles and reboots. For dual-domain systems, this command operates on the SNMP agent associated with the current switch.
Page 30 Trap recipient severity level The trap severity level is associated with each trap recipient IP address. The event trap level is in conjunction with the event's severity level. When an event occurs and if its severity level is at or below the set value, the SNMP event traps (swEventTrap, swFabricWatchTrap, and connUnitEventTrap) are sent to the trap recipients.
Page 31 To correct any input mistake: <Backspace> erases the previous character, <Control-U> erases the whole line, sysDescr: [FC Switch] sysLocation: [End User Premise] sysContact: [Field Support.] authTrapsEnabled (true, t, false, f): [true] SNMP community and trap recipient configuration: Community (rw): [Secret C0de] Trap Recipient's IP address in dot notation: [192.168.1.51] Trap recipient Severity level : (0..5) [0] 3 Community (rw): [OrigEquipMfr]...
Page 32: Agtcfgshow
agtCfgShow Displays the SNMP agent configuration. Synopsis agtcfgshow Availability all users Description Use this command to display the configuration of the SNMP agent in the switch. NOTE: On a dual-switch chassis, there is one SNMP agent per logical switch. This command is specific to the logical switch you are logged in to.
Page 33 Trap recipient severity level The event trap level in conjunction with the event's severity level. When an event occurs and if its severity level is at or below the set value, the SNMP trap, swEventTrap, is sent to configured trap recipients. By default, this value is set to 0, implying that no swEventTrap is sent.
Page 34 Community 4: public (ro) No trap recipient configured yet 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: No access host configured yet Entry 2: No access host configured yet...
Page 35: Aliadd
aliAdd Adds a member to a zone alias. Synopsis aliadd “aliName“, “member; member“ Availability admin NOTE: This command requires HP Advanced Zoning, which is included within the Base Configuration Services and bundled with each B-series switch. Description Use this command to add one or more members to an existing zone alias. The alias member list cannot contain another zone alias.
Page 36 See also aliCreate aliDelete aliRemove aliShow Fabric OS commands...
Page 37: Aliasdelete
aliasDelete Deletes a port from all local groups. Synopsis 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 command to show the existing groups with its corresponding N_Ports.
Page 38: Aliasjoin
aliasJoin Creates a multicast alias group of N_Ports. If the group already exists, the N_Ports are added to the existing group. Synopsis aliasJoin Availability admin Description Use this command to create a multicast alias group of N_Ports or to add N_Ports to an existent group. Any online N_Port defined in the fabric can be part of a group.
Page 39 Exit status Successful operation nonzero Indicates the operation has failed See also aliasDelete aliasPurge aliasShow fabricShow nsAllShow nsShow Fabric OS 5.x command reference guide...
Page 40: Aliaspurge
aliasPurge Removes an alias group. Synopsis aliasPurge groupID Availability admin Description Use this command to remove an alias group. Operands The following aliasPurge argument is required. It is the group ID in its hexadecimal representation groupID Examples To remove an alias group: switch:admin>...
Page 41: Aliasshow
aliasShow Displays local alias server information. Synopsis aliasShow Availability all users Description Use this command to display local information. If there is no local alias group, a message is displayed. If there are multiple entries in the local alias group, they are displayed. Operands none Examples...
Page 42: Alicreate
aliCreate Creates a zone alias. Synopsis alicreate “aliName“, “member; member“ Availability admin NOTE: This command requires HP Advanced Zoning, which is included within the Base Configuration Services and bundled with each B-series switch. 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).
Page 43 Examples To create a zone alias: switch:admin> alicreate "array1", "2,32; 2,33; 2,34" switch:admin> alicreate "array2", "21:00:00:20:37:0c:66:23" switch:admin> alicreate "loop1", "4,5[0x02]; 6,7[0xEF]; 5,4" See also aliAdd aliDelete aliRemove aliShow Fabric OS 5.x command reference guide...
Page 44: Alidelete
aliDelete Deletes a zone alias. Synopsis alidelete “aliName“ Availability admin NOTE: This command requires HP Advanced Zoning license, which is included within the Base Configuration Services and bundled with each B-series switch. Description Use this command to delete a zone alias. This command changes the defined configuration.
Page 45: Aliremove
aliRemove Removes a member from a zone alias. Synopsis aliremove “aliName“, “member; member“ Availability admin NOTE: This command requires HP Advanced Zoning license, which is included within the Base Configuration Services and bundled with each B-series switch. 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.
Page 46 Examples Remove a world wide name 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 Fabric OS commands...
Page 47: Alishow
aliShow Displays zone alias information. Synopsis alishow [“pattern“][, mode] Availability all users NOTE: This command requires HP Advanced Zoning license, which is included within the Base Configuration Services and bundled with each B-series switch. Description Use this command to display zone configuration information. If a parameter is specified, it is used as a pattern to match zone alias names;...
Page 48 See also aliAdd aliCreate aliDelete aliRemove Fabric OS commands...
Page 49: Aptpolicy
aptPolicy Changes or displays the Advanced Performance Tuning (APT) policy. Synopsis aptpolicy [policy] Availability admin Description Use this command, which changes several internal parameters, to change the performance algorithm on the switch. (A detailed performance-tuning discussion is beyond the scope of this manual.) The default parameters are optimal for most SAN applications;...
Page 50 • Exchange-based routing policy With this policy, the path chosen for an ingress frame is based on: Ingress port on which the frame was received • FC address of the SID for this frame • FC address of the DID for this frame •...
Page 51 See also dlsReset dlsSet dlsShow switchDisable Fabric OS 5.x command reference guide...
Page 52: Authutil
authUtil Displays and sets the authentication configuration. Synopsis authutil [--show][--set value] Availability admin Description Use this command to display and set local switch authentication parameters. Use --set to change authentication parameters, such as protocol and Diffie-Hellman group (DH group), which saves new configuration persistently.
Page 53 Examples To display authentication configuration on the switch: switch:admin> authutil --show AUTH TYPE HASH TYPE GROUP TYPE -------------------------------------- dhchap sha1,md5 0,1,2,3,4 To set DH-CHAP as authentication protocol: switch:admin> authutil --set -a dhchap Authentication is set to dhchap. To set both protocols in order of fcap,dhchap: switch:admin>...
Page 54: Backplanetest
backplaneTest Tests the backplane connection for a multiple-blade configured system. Synopsis backplanetest [--slot number][-passcnt count][-payload value][-pat type][-ports itemlist][-[-verbose mode] Availability admin Description Use this command to verify the backplane connection for each blade through the backend external (BE) ports. This command can run only on a multiple-blade configured system. It assumes that all blades available on the specified switch have passed the blade diagnostics tests.
Page 55 Examples To test backplane connections on an HP StorageWorks Director: switch:admin> backplanetest -ports 1/16, 18, 20 -payload 2048 -verbose 1 Running backplanetest ....Test frame info for Backplane Connection Test: # of frames: sid data: 0xfffffd did data: 0xfffffd payload size: 2048 bytes Test Complete: backplanetest Pass 1 of 1 Duration 0 hr, 0 min &...
Page 56: Backport
backport Tests for backend ASIC-to-ASIC links. Synopsis backport [-nframes count][-ports itemlist][-lb_mode mode][-fr_type type][-extonly mode] Availability admin Description Use this command to test the backplane routing and virtual channel (VC) allocation. This test applies to single blade as well as multiblade systems. The following items are tested: •...
Page 57 Specifies the frame type to send. The default value is 1. -fr_type type Type Description Single frame spinfab frames spinfab 1K frames Specifies external-test-only mode. The default value is 0, which disables -extonly mode this mode. This command normally sends bursts of frames from each port under test to every other port in the list.
Page 58: Bannerset
bannerSet Sets the banner on the local switch. Synopsis bannerset [banner] Availability admin Description Use this command to set the banner on the local switch. The banner is a string of alphanumeric characters. It is displayed whenever a user tries to log in to a switch.
Page 59: Bannershow
bannerShow Displays the banner text. Synopsis bannershow Availability admin Description Use this command to display the contents of the banner. Operands none Examples To display the banner for a switch: switch:admin> bannershow Banner: Do not log into this switch if you are not an authorized administrator. See also bannerSet Fabric OS 5.x command reference guide...
Page 60: Bcastshow
bcastShow Displays broadcast routing information. Synopsis 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: ports that are able to send and receive broadcast frames.
Page 61 In the previous example, from a switch with 128 ports, the member ports consist of ports 7, 13, 42, 84, 85, and 86. The final Member Ports bit set represents the embedded port (frames sent to be handled by firmware) and is typically set. See also portRouteShow Fabric OS 5.x command reference guide...
Page 62: Bladebeacon
bladeBeacon Sets blade beaconing mode on or off. Synopsis bladebeacon [slotnumber] mode Availability admin NOTE: This command is available only on the HP StorageWorks SAN Directors. Description Use this command to enable or disable blade beaconing or to display the current beaconing mode for one blade.
Page 63: Bladedisable
bladeDisable Disables all user ports on a blade. Synopsis bladedisable [slotnumber] Availability admin Description Use this command to disable all user ports on a blade. All Fibre Channel ports are taken offline. If the switch was connected to a fabric through this blade, the remaining switches reconfigure, and this switch will configure based on the other blade ports.
Page 64 Examples To disable blade 2 and then verify: switch:admin> bladedisable 2 Blade 2 is being disabled...Done switch:admin> slotshow Slot Blade Type Status --------------------------------- SW BLADE ENABLED SW BLADE ENABLED (User Ports Disabled) SW BLADE ENABLED SW BLADE ENABLED CP BLADE ENABLED CP BLADE ENABLED...
Page 65: Bladeenable
bladeEnable Enables all user ports on a blade. Synopsis bladeenable [slotnumber] Availability admin Description Use this command to enable all user ports on a blade. All Fibre Channel ports within the blade that did not fail the power-on self-test (POST) are enabled (except for persistently disabled ports); they might come online if connected to a device or remain offline if disconnected.
Page 66 UNKNOWN VACANT UNKNOWN VACANT UNKNOWN VACANT switch:admin> bladeenable 4 slBlade 4 is being enabled...Done switch:admin> slotshow Slot Blade Type Status --------------------------------- SW BLADE ENABLED UNKNOWN VACANT UNKNOWN VACANT SW BLADE ENABLED CP BLADE ENABLED CP BLADE ENABLED SW BLADE ENABLED UNKNOWN VACANT UNKNOWN...
Page 67: Burninerrclear
burninErrClear Clears errors stored in the nonvolatile storage on the slot during burn-in. Synopsis burninErrClear slotNum Availability admin Description Use this command to clear errors stored in the nonvolatile storage on the slot during burn-in. NOTE: HP StorageWorks recommends running the burninErrClear command prior to running and diagSetCycle.
Page 68: Burninerrshow
burninErrShow Displays errors stored in the nonvolatile storage on the slot during burn-in. Synopsis burninErrShow slotNum Availability all users Description Use this command to display errors stored in the nonvolatile storage on the slot during burn-in. Operands This command has the following operand: A nonzero value that specifies the slot number from which to slotNum display burn-in errors.
Page 69: Burninlevel
burninLevel Sets the diagnostics burn-in level. Synopsis burninlevel [ level | -show ] Availability admin Description Use this command to select or display the burn-in level. When the burn-in level is set to a value other than 0, the diagnostic daemon program performs burn-in testing in place of the power-on self-test (POST) phase II each time a switch blade is powered on.
Page 70: Burninstatus
burninStatus Displays the diagnostics burn-in status. Synopsis burninstatus [[ --slot ] slotnumber ] Availability admin Description Use this command to display the burn-in status of each blade in the system. The output contains the slot, state, current run number, current command in the run, total commands in a run, and the burn-in script name.
Page 71: Camtest
camTest Verifies QuickLoop's Content Addressable Memory (CAM) SID translation. Synopsis camtest [--slot slotnumber][-passcnt count][-txport itemlist] Availability admin Description Use this command to verify that the CAM is functionally OK by performing hit and miss tests. 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.
Page 72 Examples To verify CAM is functioning correctly: switch:admin> camtest -txports 1/1 Running camtest ....Test Complete: "camtest" Pass 1 of 1 Duration 0 hr, 0 min & 5 sec (0:0:5:14). passed. Diagnostics When failures are detected, the subtest might report one or more of the following error messages: DIAG-CAMFLTR DIAG-CAMINIT DIAG-CAMSID...
Page 73: Centralmemorytest
centralMemoryTest Tests ASIC-pair central memory operation. Synopsis centralmemorytest [--slot slotnumber][-passcnt count][-datatype type][-ports itemlist][-seed value] Availability admin Description Use this command to execute an address and data bus verification of the ASIC SRAMs that serve as the central memory. NOTE: This command cannot be executed on an enabled switch. You must first disable the switch using command.
Page 74 • Port 0 reads the central memory in ASIC 0. • Port 1 reads the central memory in ASIC 0. • Port 14 reads the central memory in ASIC 0. • Port 15 reads the central memory in ASIC 0. •...
Page 75 Chip number error subtest The forced bad chip number error subtest verifies that the bad buffer number in the data packet can be detected and its error flag and interrupt bits set. The test method is as follows: Clear the error and interrupt bits of all ASICs. Set up the hardware so that transmission of data includes a bad buffer.
Page 76 Examples To test the ASIC central memory: switch:admin> centralmemorytest -ports 1/0-1/15 Running centralmemorytest .... Test Complete: "centralmemorytest" Pass 1 of 1 Duration 0 hr, 0 min Duration 0 hr, 0 min Duration 0 hr, 0 min & 5 sec (0:0:5:412). 5 sec (0:0:5:412). 5 sec (0:0:5:412). passed.
Page 77 portLoopbackTest portRegTest spinSilk sramRetentionTest Fabric OS 5.x command reference guide...
Page 78: Cfgactvshow
cfgActvShow Displays current zone configuration information. Synopsis cfgactvshow Availability all users NOTE: This command requires HP Advanced Zoning, which is included within the Base Configuration Services and bundled with each B-series switch. Description Use this command to display the effective zone configuration information. The current configuration is a single zone configuration that is currently in effect.
Page 79: Cfgadd
cfgAdd Adds a member to a zone configuration. Synopsis cfgadd “cfgName“, “member; member“ Availability admin NOTE: This command requires HP Advanced Zoning, which is included within the Base Configuration Services and bundled with each B-series switch. Description Use this command to add one or more members to an existing zone. This command changes the defined configuration.
Page 80 cfgRemove cfgSave cfgShow Fabric OS commands...
Page 81: Cfgclear
cfgClear Clears all zone configurations. Synopsis cfgclear Availability admin NOTE: This command requires HP Advanced Zoning, which is included within the Base Configuration Services and bundled with each B-series switch. Description Use this command to clear all zone information in the transaction buffer. All defined zone objects in the transaction buffer are deleted.
Page 82 See also cfgDisable cfgEnable cfgSave Fabric OS commands...
Page 83: Cfgcreate
cfgCreate Creates a zone configuration. Synopsis cfgcreate “cfgName“, “member; member“ Availability admin NOTE: This command requires HP Advanced Zoning, which is included within the Base Configuration Services and bundled with each B-series switch. Description Use this command to create a new zone configuration. A zone configuration name must begin with a letter that can be followed by any number of letters, numbers, and underscores.
Page 84 See also cfgAdd cfgClear cfgDelete cfgDisable cfgEnable cfgRemove cfgSave cfgShow Fabric OS commands...
Page 85: Cfgdelete
cfgDelete Deletes a zone configuration. Synopsis cfgdelete “cfgName“ Availability admin NOTE: This command requires HP Advanced Zoning, which is included within the Base Configuration Services and bundled with each B-series switch. Description Use this command to delete a zone configuration. This command changes the defined configuration.
Page 86: Cfgdisable
cfgDisable Disables a zone configuration. Synopsis cfgdisable Availability admin NOTE: This command requires HP Advanced Zoning, which is included within the Base Configuration Services and bundled with each B-series switch. Description Use this command to disable the current zone configuration. The fabric returns to nonzoning mode, in which all devices see each other.
Page 87: Cfgenable
cfgEnable Enables a zone configuration. Synopsis cfgenable “cfgName“ Availability admin NOTE: This command requires HP Advanced Zoning, which is included within the Base Configuration Services and bundled with each B-series switch. Description Use this command to enable a zone configuration. The specified zone configuration is built by checking for undefined zone names, zone alias names, or other inconsistencies by expanding zone aliases, removing duplicate entries, and then installing the current configuration.
Page 88: Cfgremove
cfgRemove Removes a member from a zone configuration. Synopsis cfgremove “cfgName“, “member [; member ...]“ Availability admin NOTE: This command requires HP Advanced Zoning, which is included within the Base Configuration Services and bundled with each B-series switch. Description Use this command to remove one or more members from an existing zone configuration. If all members are removed, the zone configuration is deleted.
Page 89 cfgDelete cfgDisable cfgEnable cfgSave cfgShow cfgTransAbort cfgTransShow Fabric OS 5.x command reference guide...
Page 90: Cfgsave
cfgSave Saves zone configuration to flash memory. Synopsis cfgsave Availability admin NOTE: This command requires HP Advanced Zoning, which is included within the Base Configuration Services and bundled with each B-series switch. 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 91 See also cfgAdd cfgClear cfgCreate cfgDelete cfgDisable cfgEnable cfgRemove cfgShow cfgTransAbort cfgTransShow Fabric OS 5.x command reference guide...
Page 92: Cfgshow
cfgShow Displays zone configuration information. Synopsis cfgshow [“pattern“][, mode] Availability all users NOTE: This command requires HP Advanced Zoning, which is included within the Base Configuration Services and bundled with each B-series switch. Description Use this command to display zone configuration information. If no operand is specified, all zone configuration information (both defined and effective) appears.
Page 93 Operands This command has the following optional operands: A POSIX-style regular expression used to match zone pattern configuration names. The pattern must be enclosed in quotation marks, and can contain: • Question mark (?), which is a placeholder for any single character •...
Page 94 See also cfgAdd cfgClear cfgCreate cfgDelete cfgDisable cfgEnable cfgRemove cfgSave cfgTransAbort cfgTransShow Fabric OS commands...
Page 95: Cfgsize
cfgSize Displays zone database size details. Synopsis cfgsize [integer] Availability all users NOTE: This command requires HP Advanced Zoning, which is included within the Base Configuration Services and bundled with each B-series switch. Description Use this command to display the size details of the zone database. All sizes are in bytes. The size details include the following: Zone DB max size The upper limit for the defined configuration, determined by the...
Page 96 cfgShow Fabric OS commands...
Page 97: Cfgtransabort
cfgTransAbort Aborts the current zoning transaction. Synopsis cfgtransabort [token] Availability admin NOTE: This command requires HP Advanced Zoning, which is included within the Base Configuration Services and bundled with each B-series switch. Description Use this command to abort the current zoning transaction without committing it. All changes made since the transaction was started will be removed and the zone configuration database restored to the state before the transaction was started.
Page 98: Cfgtransshow
cfgTransShow Displays information about the current zoning transaction. Synopsis cfgtransshow Availability all users NOTE: This command requires HP Advanced Zoning, which is included within the Base Configuration Services and bundled with each B-series switch. Description Use this command to display the ID of the current zoning transaction. This command also gives information about whether or not a transaction can be aborted or not.
Page 99: Chassisconfig
chassisConfig Displays or sets the configuration of the chassis. Synopsis chassisconfig [ -f ] [ option ] Availability admin (set) all users (display) Description Use this command to set the chassis configuration for products that support both single-switch and dual-switch operation.Each configuration specifies whether the chassis runs as one logical switch or two. Each configuration also specifies the port blade ID that is permitted on each logical switch.
Page 100 Unless the chassis is currently configured as Option 1 (a single 128-port switch with blade IDs 4 and 17 and CP blade IDs 5 and 16), both CP blades should always contain firmware that supports this command. Use of earlier versions will adversely affect switch operation. Because this is a disruptive operation and has profound effect on the behavior of the chassis, it needs to be used selectively.
Page 101 switch:admin> chassisconfig Current Option: 1 All Supported Options (With Blade ID 5 on slots 5-6) ---------------------------------------------------- Option 1: One 128-port switch (Blade ID 4, 17 on slots 1-4, 7-10, Blade ID 5, 16 on slots 5-6) Option 2: Two 64-port switches (Blade ID 4 on slots 1-4, 7-10, Blade ID 5 on slots 5-6) Option 3: Two 64-port switches (Blade ID 4 on slots 1-4, ID 2 on slots 7-10, Blade ID 5 on slots 5-6)
Page 102 Please upload switch 0 configuration... Server Name or IP Address [host]: 192.168.79.240 User Name [user]: ckonchad File Name [config.txt]: Password: Upload complete Are you sure you want to continue? (Y/N): y Current Option changed to 2 Restoring switch 0 configuration to factory defaults... done. (Telnet connection goes down at this point.) See also configDownload...
Page 103: Chassisname
chassisName Displays or sets the chassis name for a switch. Synopsis chassisname [name] Availability admin (set) all users (display) Description Use this command to change the name associated with the chassis. In the HP StorageWorks Core Switch 2/64 and HP StorageWorks SAN Director 2/128, there are two logical switches associated with a single chassis.
Page 104: Chassisshow
chassisShow Displays all field replaceable units (FRUs). Synopsis chassisshow Availability all users Description Use this command to inventory and display the FRU header content for each object in the chassis and chassis backplane version. The header data is formatted into a record consisting of up to 13 lines. See Table 4 for more information about the lines and their meaning.
Page 105 Examples To display all FRUs for a switch: Fabric OS 5.x command reference guide 105...
Page 106 switch:user> chassisshow Chassis Backplane Revision: 1C SW BLADE Slot: 3 Header Version: Power Consume Factor: -180 Factory Part Num: 60-0001532-03 Factory Serial Num: 1013456800 Manufacture: Day: 12 Month: Year: 2001 Update: Day: 15 Month: Year: 2001 Time Alive: 28 days Time Awake: 16 days 555-374757...
Page 107 Unit: 1 Header Version: Power Consume Factor: Factory Part Num: 20-123456-12 Factory Serial Num: B014934500 Manufacture: Day: Month: Year: 2001 Update: Day: 15 Month: Year: 2001 Time Alive: 88 days Time Awake: 16 days 456-777888 Part Num: 230-290-12370 (output truncated) See also slotShow Fabric OS 5.x command reference guide 107...
Page 108: Chipregshow
chipRegShow Displays the port registers for a given chip number. Synopsis chipregshow [slotnumber/]chipnumber [filter] Availability all users Description Use this command to display the ASIC pair register contents for the specified chip on the specified blade slot. NOTE: The output of this command is only for support use only. Operands This command has the following operands: Specifies the index of the chip within the specified blade to...
Page 109: Cmemretentiontest
cmemRetentionTest Tests the data retention of the central memory SRAMs. Synopsis cmemretentiontest [--slot slotnumber][-passcnt count][-datatype type][-ports itemlist][-seed value] Availability admin Description Use this command to verify that data written into the central memory SRAMs in the ASIC pair is retained after a 10-second wait.
Page 110 Examples To run the data-retention test on the central memory SRAMS: switch:admin> cmemretentiontest --slot 3 Running cmemretentiontest ....Test Complete: cmemretentiontest Pass 2 of 2 Duration 0 hr, 2 min Duration 0 hr, 2 min Duration 0 hr, 2 min & 13 sec (0:2:13:234).
Page 111: Cmitest
cmiTest Verifies the control message interface (CMI) bus between ASICs. Synopsis cmitest [--slot slotnumber][-passcnt count][-txports itemlist][-rxports itemlist][-skip mask] Availability admin Description Use this command to test: • Multiplexed 4-bit CMI point-to-point connection between two ASICs. Message sent with a bad checksum sets the error and interrupt bits of the destination ASIC. •...
Page 112 Examples To run a CMI test between two ASIC pairs: switch:admin> cmitest -txports 3/0-3/7 -rxports 3/8-3/15 Running cmitest ....Test Complete: cmitest Pass 1 of 1 Duration 0 hr, 0 min & 2 sec (0:0:2:591). passed. Diagnostics Listed below are possible error messages if failures are detected: DIAG-BADINT DIAG-CMICKSUM DIAG-CMIDATA...
Page 113: Configdefault
configDefault Restores the system configuration to default. Synopsis configdefault Availability admin Description Use this command to reset a subset of configuration settings to the default values. All configuration parameters, with the following exceptions, are reset: • Ethernet MAC address, IP address, and subnetmask •...
Page 114 Examples To restore the system configuration to default values: switch:admin> configdefault Committing Configuration ...done. See also agtCfgDefault configure switchDisable switchEnable 114 Fabric OS commands...
Page 115: Configdownload
configDownload Downloads a switch configuration file from a host file. Synopsis configdownload [-p ftp] “host“,“user“,“file“,“passwd“ configdownload -p scp “host“,“user“,“file“ configdownload Availability admin NOTE: The switchAdmin role is not allowed to change the zoning and security configuration. Therefore, zoning and security sections in the configuration being downloaded to the switch are ignored. See ”MUA-based roles”...
Page 116 • In the defined security policies section, at least one member of the FCS_POLICY must be the same as a member in the previous FCS_POLICY. • In the active security policy section, the FCS_POLICY must be exactly the same as the previous FCS_POLICY.
Page 117 Specifies a host name or IP address in quotation marks: for example, host “citadel” or “192.168.1.48”. The configuration file is downloaded from this host. Specifies the user name, in quotation marks: for example, “jdoe”. This user user name is used to gain access to the host system. Specifies the file name, in quotation marks: for example, “config.txt”.
Page 118: Configshow
configShow Displays system configuration settings. Synopsis configshow [“filter“] Availability all users Description Use this command to view the system configuration settings set by the command. configure Operands This command has the following optional operand: Specify a text string, in quotation marks, that limits the output of filter the command to only those entries that contain the text string.
Page 119 switch:admin> configshow diag.postDisable: fabric.domain: fabric.ops.vc.linkCtrl: 0 fabric.ops.vc.multicast: fabric.ops.wan_tov: fc4.fcIp.address: 192.168.65.62 fc4.fcIp.mask: 255.255.255.0 fcAL.fanFrameDisable: fcAL.useAltBBCredit: lcdContrast: licenseKey: none rpc.rstatd: rpc.rusersd: See also agtCfgShow configure diagDisablePost diagEnablePost ipAddrShow licenseShow syslogdIpShow Fabric OS 5.x command reference guide 119...
Page 120: Configupload
configUpload Uploads the switch configuration file to a host file. Synopsis configupload [-p ftp | scp][host,user,file[,passwd]] Availability admin Description Use this command to upload the switch configuration to a host file. To upload the configuration file from a Microsoft Windows NT system using file transfer protocol (FTP), the FTP server might have to be installed from the distribution media and enabled.
Page 121 The configuration file is written as three sections. The first section contains the switch boot parameters. It has variables such as the switch’s name and IP address. This section corresponds to the first few lines of output of the command. configShow The second section contains general switch configuration variables, such as diagnostic settings, fabric configuration settings, and SNMP settings.
Page 122 See also configDefault configDownload configShow configure 122 Fabric OS commands...
Page 123: Configure
configure Modifies system configuration parameters. Synopsis configure Availability admin Description Use this command to change the following system configuration parameters: • Switch fabric settings • Virtual channel settings • Zoning operation parameters • RSCN transmission mode • Arbitrated loop parameters •...
Page 124: Configure Command Fabric Parameters Fields
Table 5 lists the fabric parameters fields and their settings. Table 5 Configure command fabric parameters fields Field Type Default Range number varies Domain number 10000 E_D_TOV * 2 to 120000 R_A_TOV number 2000 1000 to R_A_TOV / 2 E_D_TOV number 0 to R_A_TOV / 4 WAN_TOV...
Page 125 MAX_HOPS Maximum hops (MAX_HOPS) is an integer that denotes the upper limit on the number of hops a frame might have to traverse to reach any destination port from any source port across the fabric. NOTE: The R_A_TOV, E_D_TOV, WAN_TOV, and MAX_HOPS configuration parameters are inter-related.
Page 126: Configure Command Virtual Channel Fields
NOTE: An HP Extended Fabrics license is required to set this mode. BB Credit The buffer-to-buffer (BB) credit represents the number of buffers available to attached devices for frame receipt. The range of allowed values varies depending on other system settings. Insistent Domain ID mode This mode enables a flag for the domain ID, so that the current domain setting for the switch is insistent: that is, remains the same over switch...
Page 127: Rscn Transmission Modes
RSCN Transmission mode Table 7 lists the RSCN Transmission Mode fields and their settings. Table 7 RSCN transmission modes Field Type Default Range End-device RSCN Transmission Mode number 0 to 2 Domain RSCN to End-device for switch IP address or name change number 0 to 1 Descriptions of the RSCN Transmission Mode field values are as follows:...
Page 128: Configure Command System Services Fields
System Services Table 9 lists the system services fields and their settings. Table 9 Configure command system services fields Field Default Range rstatd On/Off rusersd On/Off telnetd On/Off Descriptions of the system service (setting) fields are as follows: Dynamically enables or disables a server that returns system rstatd operation information through remote procedure calls (RPC).
Page 129 Table 10 Configurable application attributes (continued) Application File Type Default Range SNMP SNMP Security Level number 0, 1, 2 cfgload Secure Config Upload and Download boolean on/off NOTE: The secure protocols must not be enabled before setting SSL attributes correctly. Operands none Fabric OS 5.x command reference guide 129...
Page 130 Examples 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 WAN_TOV: (0..30000) [0] 0 MAX_HOPS: (7..19) [7] Data field size: (256..2112) [2112] Sequence Level Switching: (0..1) [0] 1 Disable Device Probing: (0..1) [0] Switch PID Format: (1..2) [1]...
Page 131: Uptime
Arbitrated Loop parameters(yes, y, no, n): [no] yes Alternate BB credit: (0..1) [0] Send FAN frames?: (0..1) [1] Enable CLOSE on OPEN received?: (0..1) [0] Always send RSCN?: (0..1) [0] Do Not Allow AL_PA 0x00?: (0..1) [0] System services(yes, y, no, n): [no] yes rstatd(on, off): [off] rusersd(on, off): [off] telnetd (on, off): [on]...
Page 132: Crossporttest
crossPortTest Tests functional operation of port external transmit and receive path. Synopsis crossporttest [-nframes count][-lb_mode mode][-spd_mode mode][-norestore mode][-ports itemlist] Availability admin Description This command verifies the intended functional operation of the switch by sending frames from port M's transmitter and looping them back through an external fiber cable into port N's receiver, thus exercising all the switch components, from the main board, to the media, to the fiber cable, to the media, and back to the main board.
Page 133 At each pass, a different data type is used to create the frame from a palette of seven types meaning that if a pass of seven is requested, seven different frames are used in the test. If eight passes, the first seven frames are unique, and the eighth is the same as the first.
Page 134 Specify the speed mode for the test. This parameter is used only for Bloom and -spd_mode mode Condor ASIC-based products, for which it controls the speed at which each port is operated. For 1 Gb/s-only products it is ignored. The exact operation of each mode 5 through 8 depends upon the loopback mode selected.
Page 135 cmemRetentionTest cmiTest itemList portLoopbackTest portRegTest spinSilk sramRetentionTest Fabric OS 5.x command reference guide 135...
Page 136: Datatypeshow
dataTypeShow Displays sample data stream types used in some diagnostic commands. Synopsis datatypeshow [-seed value] Availability all users Description Use this command to display sample data stream types used in diagnostic commands. There are 20 different sample data types. The command displays an example of each data stream. Operands This command has the following operand: Specify the data pattern seed value.
Page 137: Date
date Displays or sets the switch date and time. Synopsis date [“newdate“] Availability all users (display) admin (set) Description Use this command to set the date and time. All switches maintain the current date and time in flash memory. If the security feature (secure mode) is not enabled, switch operation does not depend on the date and time.
Page 138 MM is minutes, 00-59 yy is the year, 00-99 If you enter any value in the range 00-69, then the year displayed will be 2000–2069. For example, if you enter the value 04, then the year displayed will be 2004. If you enter any value between 70-99 in the year field (yy), the year displayed will be in the range 1970–1999.
Page 139: Dbgshow
dbgShow Displays current values of debug and verbosity levels of the specified module. Synopsis dbgshow module_name Availability all users Description Use this command to display the current values of debug and verbosity levels of the specified module. If no module name is specified, displays debug and verbosity levels of all modules. Operands This command has the following operands: Specify the name of the module for which you want to view the...
Page 140: Diagclearerror
diagClearError Clears the diagnostics failure status. Synopsis diagclearerror [[--slot] slotnumber] -all Availability admin Description Use this command to clear the diagnostics failure status. Operands This command has the following operands: Specify the slot to clear the diagnostics failure status. The default is set [--slot] slotnumber to 0 and designed to operate on fixed-port-count products.
Page 141: Diagcommandshow
diagCommandShow Displays diagnostic command descriptions. Synopsis diagcommandshow [command] Availability all users Description Use this command to display a short description of a diagnostic command. NOTE: to look up diagnostic command help pages. diagHelp Options This command has the following options: Specify a command name to display more detailed information.
Page 142: Diagdisablepost
diagDisablePost Disables power-on self-test (POST). Synopsis diagdisablepost Availability admin Description Use this command to disable POST. A reboot is not required for this command to take effect. NOTE: This command disables POST on both Core Switch 2/64 logical switches. Operands none Examples To disable the POST during future powerons:...
Page 143: Diagenablepost
diagEnablePost Enables power-on self-test (POST) execution at next reboot. Synopsis diagenablepost Availability admin Description Use this command to enable POST. A reboot is not required for this command to take effect. POST includes two phases: POST Phase I mainly tests hardware and POST Phase II tests system functionality. NOTE: This command disables POST on both Core Switch 2/64 logical switches.
Page 144: Diagenv
diagEnv Diagnostic debug parameters management package. Synopsis diagsetdebug value diagdebughelp diagsetdebugnoncheck value diagsetdebugnorestore value diagsetfaillimit value diagsetfrcerr value diagshowusr ... more commands ... Availability admin Description All of diagnostic parameters can be set either by running relevant user commands or by setting them directly in some way.
Page 145 Examples To display the values of the diagnostic parameters: switch:admin> diagshowusr Name Environment Value USR_DILATION DIAG_USR_DLY_DILATION USR_MEMDLY DIAG_USR_MEMDLY USR_SEED DIAG_USR_SEED USR_SPECIAL DIAG_USR_SPECIAL (output truncated) See also none Fabric OS 5.x command reference guide 145...
Page 146: Diagfaillimit
diagFailLimit Sets the diagnostics fail limit. Synopsis diagfaillimit [limit | -show] Availability admin Description Use this command to set the diagnostics fail limit to a specified value. The fail limit controls the number of failures before certain diagnostic test methods aborts. The exact use of this configuration setting depends on the test method.
Page 147: Diaghelp
diagHelp Displays diagnostic command information. Synopsis diaghelp [command] Availability all users Description Use this command to display a short description of diagnostic commands that are available to the user if command is not specified. The command builds a database of command information during the first execution.
Page 148: Diagloopid
diagLoopId Sets the diagnostics loop ID. Synopsis 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 AL_PA and used as the port address for any diagnostics that operate in FL_Port mode.
Page 149: Diagmodeshow
diagModeShow Displays diagnostic mode configuration. Synopsis diagmodeshow Availability all users Description Use this command to display the current settings for several diagnostic configuration parameters. This command is most often used by burn-in scripts to display a summary of the configuration settings that were in effect when the script was run.
Page 150 See also burninLevel setEsdMode setGbicMode setSplbMode 150 Fabric OS commands...
Page 151: Diagpost
diagPost Sets or displays diagnostic POST configuration. Synopsis diagpost [mode | -show] Availability admin Description Use this command to enable or disable POST testing. The mode is saved in flash memory (and stays in that mode) until the next execution of diagPost. The mode becomes active as soon as this command is executed;...
Page 152: Diagretry
diagRetry Sets or displays diagnostic retry mode. Synopsis diagretry [mode | -show] Availability admin Description Use this command to enable retry mode if the mode value is nonzero and to disable the retry mode if the mode value is 0. The mode is saved in flash memory (and stays in that mode) until the next execution of diagRetry.
Page 153: Diagsetburnin
diagSetBurnin Initializes the blade for a burn-in run. Synopsis diagsetburnin [--slot slotnumber][script | -current] Availability admin Description This sets up the blade burn-in parameters for the registered burn-in script. The burn-in will start at the next run of power-on self-test (POST) on the designated blades. The errors and activity logs are stored in flash memory.
Page 154: Diagsetcycle
diagSetCycle Sets diagnostic script parameters. Synopsis diagsetcycle script [-show | -default | [-keyword value]] Availability admin Description Use this command to provide an interactive method to update diagnostic command parameters. If only script is specified, the command displays all configuration variables used by the specified script and enters an interactive session.
Page 155 Examples To update diagnostic command parameters: switch:admin> diagsetcycle switchburnin.sh -show CURRENT - KEYWORD : DEFAULT - number_of_runs : 1 - vib - thermal : 10 BURNIN - label : BURNIN - tbr_passes - prt_on - cntmem_on - cmi_on - retention_on - cam_on - flt_passes : 50...
Page 156: Diagsetesdmode
diagSetEsdMode Enables or disables ESD mode. Synopsis diagsetcycle script [-show | -default | [-keyword value]] setesdmode [mode | -show] Availability admin Description Use this command to enable or disable ESD mode. The mode is saved in flash memory and stays in that mode until the next execution of setEsdMode.
Page 157: Diagshow
diagShow Displays diagnostics status. Synopsis diagshow [--slot number][-uports itemlist][-bports itemlist][-use_bports value] Availability all users Description Use this command to display the diagnostics status for the specified list of blade or user ports. Operands This command has the following operands: Specify which slot to operate on. If this option is not specified, -slot number the default slot 0 is used.
Page 158: Diagshowtime
diagShowTime Sets or displays diagnostic show-time mode. Synopsis diagshowtime [mode | -show] Availability admin Description Use this command to enable show-time mode (if the mode value is not 0) or disable the show-time mode (if the mode value is set to 0). The mode is saved in flash memory (and stays in that mode) until the next execution of diagShowTime.
Page 159: Diagskiptests
diagSkipTests Enables or disables diagnostics skip test flags. Synopsis diagskiptests [value | -show] Availability admin Description Use this command to enable or disable the diagnostics skip test flags. The skip test flags are saved in flash memory and stay set until the next execution of diagSkipTests. The mode becomes active as soon as this command is executed.
Page 160: Diagstatus
diagStatus Displays currently running diagnostic tests. Synopsis diagstatus [ slotnumber ] Availability all users Description Use this command to display currently running diagnostic test names. Operands This command has the following optional operand: Specifies the slot to display. If omitted, all blades in the system slotnumber are assumed.
Page 161: Diagstopburnin
diagStopBurnin Terminates a blade burn-in run. Synopsis diagstopburnin [--slot number] Availability admin Description Use this command to determine which PID is running burn-in on a blade and terminate that activity. The burn-in script handles the logging cleanup. This command does not require a reboot to take effect. Operands This command has the following optional operand: Specify the slot to stop burn-in.
Page 162: Dlsreset
dlsReset Disables the dynamic load sharing (DLS) option. Synopsis dlsreset Availability admin Description Use this command to turn off DLS when a fabric change occurs. See for a full description of load dlsSet sharing. NOTE: This command should be used only if devices connected to the fabric cannot handle occasional routing changes correctly.
Page 163: Dlsset
dlsSet Enables the dynamic load sharing (DLS) option. Synopsis dlsset Availability admin Description Use this command to turn on 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 an E_Port or an Fx_Port) directed to the same remote domain is routed through the same output E_Port.
Page 164: Dlsshow
dlsShow Display the setting of the dynamic load sharing (DLS) option. Synopsis dlsshow Availability all users Description Use this command to display whether DLS is on or off. One of two messages displays: The DLS option is turned on. Load sharing is reconfigured with DLS is set every change in the fabric, and existing routes can be moved to maintain optimal balance.
Page 165: Dnsconfig
dnsConfig Sets or displays domain name service (DNS) parameters. Synopsis dnsconfig Availability admin Description Use this command to display or set the DNS parameters. The domain name service parameters are the domain name and the name server IP address for primary and secondary name servers.
Page 166 See also configDownload configUpload firmwareDownload ipAddrSet ipAddrShow 166 Fabric OS commands...
Page 167: Enclosureshow
enclosureShow Displays attributes of the switch enclosure. Synopsis enclosureShow attribute Availability all users Description Use this command to display attributes of the switch enclosure. Currently, supported attributes are the vendor-specific enclosure identifier and the identifier of the enclosure interface to which the switch is attached.
Page 168: Errclear
errClear Clears all error log messages for all switch instances on this control processor (CP). Synopsis errclear Availability admin Description Use this command to clear all internal and external error log messages for all switch instances on this CP. Operands none Examples To clear the error log messages:...
Page 169: Errdelimiterset
errDelimiterSet Sets the error log start and end delimiter for messages sent to the console and syslog. Synopsis errdelimiterset [-s “start_delimiter_string“] [-e “end_delimiter_string“] Availability admin Description Use this command to set the error log start and end delimiter for log messages sent to the console and syslog.
Page 170: Errdump
errDump Displays the error log, without pagination. Synopsis errdump [-s switch_instance] [-r] Availability all users Description Use this command to display external error log messages for all switch instances and the chassis, without pagination. The -r operand displays the messages in reversed order. The following information displays in each message: Start delimiter Delimiter string for the start of a message.
Page 171 See also errDelimiterSet errFilterSet errShow Fabric OS 5.x command reference guide 171...
Page 172: Errfilterset
errFilterSet Sets a filter for an error log destination. Synopsis errFilterSet [-d “destination“][-v “severity“] Availability admin Description Use this command to set a filter for an error log destination. A filter is set based on the severity level of the messages.
Page 173: Errmoduleshow
errModuleShow Displays all the defined error log modules. Synopsis errmoduleshow Availability user Description Use this command to display a list of all defined error log modules. Operands none Fabric OS 5.x command reference guide 173...
Page 174 Examples To display a list of all defined error log modules: switch:user> errmoduleshow TRCE KTRC BLPU PISP PIXE AUTH BLDE BPRT CFLD CFMN CHPS CONF DIAG ERRL FABR FABS FCIU FCMC FCPD FCPH FICU FILB FKLB (output truncated) See also errDump errShow 174 Fabric OS commands...
Page 175 Fabric OS 5.x command reference guide 175...
Page 176: Errshow
errShow Displays the error log messages, with pagination. Synopsis errshow [-s switch_instance] [-r] Availability all users Description Use this command to display external error log messages for all switch instances and the chassis, one at a time. The -r operand displays the messages in a reversed order. The following information displays in each message: Start delimiter Delimiter string for the start of a message.
Page 177 Examples To display the error log, with pagination: switch:user> errshow Version: 4.4.0 2004/07/14-22:24:08, [HAMK-1003], 1,, INFO, switch1, Heartbeat up Type <CR> to continue, Q<CR> to stop: 2004/07/14-22:24:47, [FSSM-1002], 2,, INFO, switchChassis, HA State is in sync Type <CR> to continue, Q<CR> to stop: 2004/07/14-22:25:29, [SEC-1192], 3,, INFO, switch2, Security violation: Login failure attempt via SERIAL.
Page 178: Exit
exit Logs out from a shell session. Synopsis exit 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. command is an accepted synonym for logout, as is pressing Ctrl-D at the beginning of a line.
Page 179: Fabportshow
fabPortShow Displays fabric port information. Synopsis fabportshow [slotnumber/]portnumber Availability all users Description Use this command to display the state of a port, relative to the fabric, as well as a list of pending commands. The following information displays: Port Displays the port number. State The state of the port: Port Offline...
Page 180 Flags Port flags: 0x00000001 Slave connection 0x00000002 Loopback connection 0x00000004 Incompatible connection 0x00000008 Overlapping domains 0x00000010 Overlapping zones 0x00000020 Done PTIO ioctl 0x00000040 Sent an RJT to ELP 0x00000080 BF received from the port 0x00000200 Segmented by routing code 0x00000800 Zoning has completed 0x00001000 Segmented by Platform Management...
Page 181 Examples To display fabric port information: switch:admin> fabportshow 4/14 Fabric Port Information: ======================== Port: State: List: 0x10068418 List Count: Flags: 0x280120 nbrWWN: 10:00:00:60:69:80:06:cf red_ports: 10 11 62 63 Open commands pending: ====================== No commands pending See also portShow Fabric OS 5.x command reference guide 181...
Page 182: Fabretryshow
fabRetryShow Displays the retry count of the fabric commands. Synopsis fabretryshow Availability all users Description Use this command to display the retry count of the fabric commands. The SW_ISL (ISL ports) information displays the retry count for the following fabric commands: Exchange Link Parameters Exchange Link Parameters HA_EFP...
Page 183 Examples To display the retry count of Fabric OS commands: switch:user> fabretryshow E_Ports SW_ISL HA_EFP RSCN RAID GAID ELP_TMR See also fabStatsShow Fabric OS 5.x command reference guide 183...
Page 184: Fabriclog
fabricLog Displays (all users) or manipulates (admin) the fabric log. Synopsis fabricLog -s | -c | -d | -e | -r size Availability all users admin Description Use this command to display, clear, disable, enable, or resize the fabric log. Operands This command has the following operands: Displays fabric log (all users).
Page 185 Examples To change the number of entries: switch:admin> fabriclog -s Time Stamp Input and *Action S, P Sn,Pn Port ======================================================================= ==== 11955:655 SCN Switch Online F2,NA F2,NA NA 11955:657 *Start 2 * F_S_TOV Timer F2,NA F2,NA NA 11955:657 *Start 60 * F_S_TOV Timer F2,NA F2,NA NA 11955:669 RSCN Rcv addr: 0x3000000...
Page 186: Fabricprincipal
fabricPrincipal Sets principal switch selection mode. Synopsis fabricprincipal [-fhq][ mode ] Availability all users (display current setting) admin (modify current setting) Description Use this command to set principal switch selection mode for the switch. The implementation of the command is based solely on mechanisms specified in the fabricPrincipal Fibre Channel standards.
Page 187 To enable the principal selection mode setting and force fabric rebuild: switch:admin> fabricprincipal -f 1 Principal Selection Mode enabled (Forcing fabric rebuild) See also fabricShow Fabric OS 5.x command reference guide 187...
Page 188: Fabricshow
fabricShow Displays fabric membership information. Synopsis fabricshow Availability all users Description Use this command to display information about switches in the fabric. If the switch is initializing or disabled, the message no fabric is displayed. If the fabric is reconfiguring, some or all switches might not display; otherwise, the following fields display: Switch ID The switch Domain_ID and embedded port D_ID world wide name...
Page 189: Fabstateclear
fabStateClear Clears the fabric state information. Synopsis fabstateclear Availability admin Description Use this command to clear the queue of fabric state information logged by the fabric. NOTE: This command is obsoleted by fabricLog Operands none Examples To clear the fabric state information: switch:admin>...
Page 190: Fabstateresize
fabStateResize Changes the number of state entries. Synopsis fabStateResize num Operands This command has the following operand: The switch Domain_ID and embedded port D_ID Examples To change the number of entries: switch:admin> fabstateshow Time Stamp Input and *Action S, P Sn,Pn Port =======================================================================...
Page 191 See also fabricLog fabStateClear fabStateShow Fabric OS 5.x command reference guide 191...
Page 192: Fabstateshow
fabStateShow Displays the fabric state information. Synopsis fabstateshow Availability all users Description Use this command to display the queue of fabric state information logged by the fabric. NOTE: This command is obsoleted by fabricLog -s. Operands none Examples To display the fabric state information: 192 Fabric OS commands...
Page 193 switch:admin> fabstateshow Time Stamp Input and *Action S, P Sn,Pn Port =========================================================================== 11955:655 SCN Switch Online F2,NA F2,NA 11955:657 *Start 2 * F_S_TOV Timer F2,NA F2,NA 11955:657 *Start 60 * F_S_TOV Timer F2,NA F2,NA 11955:669 RSCN Rcv addr: 0x3000000 F2,NA F2,NA 11957:65 SCN Port Online...
Page 194: Fabstatsshow
fabStatsShow Displays the fabric statistics. Synopsis fabstatsshow Availability all users Description Use this command to display the statistics for the fabric. The information appears as follows: • Number of times a switch domain ID has been forcibly changed • Number of E_Port offline transitions •...
Page 195 Examples To display the fabric statistics: switch:admin> fabstatsshow Description Count ----------------------------------------- Domain ID forcibly changed: E_Port offline transitions: Reconfigurations: Segmentations due to: Loopback: 6 < Incompatibility: Overlap: Zoning: E_Port Segment: Licensing: Disabled E_Port: Platform DB: Sec Incompatibility: Sec Violation: ECP Error: Duplicate WWN: Eport Isolated: See also...
Page 196: Fabswitchshow
fabSwitchShow Displays the fabric switch state structure information. Synopsis fabswitchshow Availability all users Description Use this command to display the fabric switch state structure information. IMPORTANT: This command is provided strictly for debugging purposes; it is not intended as a user command.
Page 197 dup xid occurrence: iu nodes outstanding: EFP update port: FWN frames pending test check point: No check point set fabric license: TRUE fabric EFP version: last message: 20:30:29.826 *Snd inquiry (4) D0,NA D0,NA NTP ports online: RSCN domain recovery list: no domain RSCN's to recover reachable domains: 1 3 4...
Page 198: Fandisable
fanDisable Disables a fan unit. Synopsis fandisable unit Availability admin Description Use this command to disable a nonfaulty fan unit by setting the RPM speed to 0. NOTE: This command is not available on nonbladed systems except for the HP StorageWorks SAN Switch 4/32.
Page 199: Fanenable
fanEnable Enables a fan unit. Synopsis fanenable unit Availability admin Description Use this command to return the fan unit to the default RPM speed (only if the fan unit has been previously disabled using the command). fanDisable NOTE: This command is not available on nonbladed systems except for the StorageWorks SAN Switch 4/32.
Page 200: Fanshow
fanShow Displays fan status and speed. Synopsis fanshow Availability all users Description Use this command to display the current status and speed of each fan in the system. Fan status is displayed as: Fan is functioning correctly. absent Fan is not present. below minimum Fan is present but rotating too slowly or stopped.
Page 201: Fastboot
fastBoot Reboots the control processor (CP), bypassing power-on self-test (POST). Synopsis fastboot Availability admin Description Use this command to reboot the CP. The reboot takes effect immediately as the CP resets and executes normal power-on booting sequence. However, POST is skipped, reducing boot time significantly. If POST has been disabled using the command, then is the same as...
Page 202: Fazoneadd
faZoneAdd Adds a member to a Fabric Assist zone. Synopsis 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 agtCfgShow command).
Page 203 To add another target member to “Blue_fazone”: switch:admin> fazoneadd "Blue_fazone", "10:49:00:00:00:20:3f:2e" See also faZoneCreate faZoneDelete faZoneRemove faZoneShow Fabric OS 5.x command reference guide 203...
Page 204: Fazonecreate
faZoneCreate Creates a Fabric Assist zone. Synopsis 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. The FA zone name must be unique among all Fabric Assist zone objects. The member list must be enclosed in quotation marks members separated by a semicolons.
Page 205 Operands The following operands are required: Specify a name for the Fabric Assist zone. The name must be fazoneName enclosed in quotation marks. Specify a member or list of members to add to a Fabric Assist member zone. The list must be enclosed in quotation marks, members separated by semicolons.
Page 206: Fazonedelete
faZoneDelete Deletes a Fabric Assist zone. Synopsis 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).
Page 207: Fazoneremove
faZoneRemove Removes members from a Fabric Assist zone. Synopsis 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 208 See also faZoneAdd faZoneCreate faZoneDelete faZoneShow 208 Fabric OS commands...
Page 209: Fazoneshow
faZoneShow Displays Fabric Assist zone information. Synopsis fazoneshow [“pattern“[, transflag]] Availability all users Description Use this command to display Fabric Assist zone information. Specifying this command with no parameters or with the second parameter set to 0 displays all Fabric Assist zone configuration information for both defined and effective configurations.
Page 210: Fcping
fcPing Sends a Fibre Channel Extended Link Service (ELS) ECHO request to a pair of ports. Synopsis fcPing [ -hbq ] [ -n frames ] [ -l length ] [ -i wait ] [ -p pattern ] source destination Availability all users Description Use this command to perform a zoning check between the source and destination.
Page 211 Specifies up to 16 "pad" bytes, which are used to fill out the -p pattern request frame payload that is sent. This is useful for diagnosing data-dependent problems in the fabric link. The pattern bytes are specified as hexadecimal characters. For example, -p ff causes the request frame to be filled with all 1s.
Page 212 To display one device that accepts the request and another device that does not respond to the request: switch:admin> fcPing 0x020800 22:00:00:04:cf:75:63:85 Source: 0x20800 Destination: 22:00:00:04:cf:75:63:85 Zone Check: Zoned Pinging 0x20800 with 12 bytes of data: received reply from 0x20800: 12 bytes time:1159 usec received reply from 0x20800: 12 bytes time:1006 usec received reply from 0x20800: 12 bytes time:1008 usec received reply from 0x20800: 12 bytes time:1038 usec...
Page 213: Fcplogclear
fcpLogClear Clears the FCPD debug information log (debug command). Synopsis fcpLogClear Availability admin Description Use this command to clear the debug information logged by FCPD. Operands none Examples To clear the FCPD debug information log: switch:admin> fcplogclear See also fcpLogDisable fcpLogEnable fcpLogShow Fabric OS 5.x command reference guide 213...
Page 214: Fcplogdisable
fcpLogDisable Disables the FCPD debug information log (debug command). Synopsis fcpLogDisable Availability admin Description Use this command to disable the debug information logged by FCPD. Operands none Examples To disable the FCPD debug information log: switch:admin> fcpLogDisable See also fcPing fcpLogEnable fcpLogShow 214 Fabric OS commands...
Page 215: Fcplogenable
fcpLogEnable Enables the FCPD debug information log (debug command). Synopsis fcpLogEnable Availability admin Description Use this command to enable the debug information logged for FCPD. Debug information logging is enabled by default. Operands none Examples To enable the FCPD debug information log: switch:admin>...
Page 216: Fcplogshow
fcpLogShow Displays the FCPD debug information log (debug command). Synopsis fcpLogShow Availability all users Description Use this command to display the debug information logged at various stages of FCP device probing. Operands none Examples To display the FCPD debug information log: switch:admin>...
Page 217 See also fcPing fcpLogDisable fcpLogEnable Fabric OS 5.x command reference guide 217...
Page 218: Fcpprobeshow
fcpProbeShow Displays the Fibre Channel Protocol (FCP) probe information. Synopsis fcpprobeshow [slotnumber/]portnumber Availability all users Description Use this command to display the FCP probing information for the devices attached to the specified F_Port or FL_Port. This information includes the number of successful logins and SCSI INQUIRY commands sent over this port and a list of the attached devices.
Page 219 See also portLoginShow portLogShow Fabric OS 5.x command reference guide 219...
Page 220: Fcprlsshow
fcpRlsShow Display the Fibre Channel Protocol (FCP) Read Link Status (RLS) information. Synopsis fcprlsshow [slotnumber/]portnumber Availability all users Description Use this command to display the FCP RLS information for a particular device, which should be either an F_Port or FL_Port. This information describes the number of loss-of-signal, loss-of-sync, CRC-error, and other failure events that have been detected on this port.
Page 221: Fdmicacheshow
fdmiCacheShow Displays abbreviated remote FDMI device information, according to remote domain ID. Synopsis fdmicacheshow Availability all users Description Use this command to display FDMI cache information for remote domains only. The state of each remote domain, identified by its domain ID, is shown to be unknown, known, unsupported, or error.
Page 222: Fdmishow
fdmiShow Displays detailed FDMI device information. Synopsis fdmishow Availability all users Description Use this command to display FDMI information for all HBAs and ports. Detailed FDMI information is displayed for local HBAs and ports. This information includes the HBA with its corresponding ports, along with their respective attributes.
Page 223 Local Port database contains: 10:00:00:00:c9:25:9b:96 Remote HBA database contains no entry. Remote Port database contains no entry. See also fdmiCacheShow Fabric OS 5.x command reference guide 223...
Page 224: Ficonclear
ficonClear Clears the records from the specified FICON database. Synopsis ficonclear [database] Availability all users Description Use this command to remove records from the local FICON database. The command effect depends on the specified database. Operands The operand is as follows: Specifies the name of the FICON database.
Page 225: Ficoncupset
ficoncupset Sets FICON-CUP parameters for a switch. Synopsis ficoncupset fmsmode enable | disable ficoncupset modereg bitname 0 | 1 Availability admin Description Use this command to set FICON-CUP (Control Unit Port) parameters for a switch. All the parameters described below can be set while the switch is online. Changes to parameters are effective immediately. A reboot is not required for the changes to take effect.
Page 226: Ficoncupshow
ficoncupshow Displays FICON-CUP parameters for a switch. Synopsis ficoncupshow fmsmode ficoncupshow modereg [bitname] Availability all users Description Use this command to display FICON-CUP (Control Unit Port) parameters for a switch. Operands The following operands are supported: Display the FICON Management Server (FMS) mode for the switch. fmsmode modereg Display the FICON-CUP mode register.
Page 227 To display ASM bit in the mode register for the switch: switch:user> ficoncupshow modereg ASM See Also ficoncupset Fabric OS 5.x command reference guide 227...
Page 228: Ficonhelp
ficonHelp Displays a list of FICON support commands. Synopsis ficonhelp Availability all users Description Use this command to display a list of FICON support commands, with descriptions. Operands none Examples To display a list of FICON commands: switch:admin> ficonhelp ficonshow RNID Displays all RNID (Registered Node Identification Data) for FICON devices connected to the local switch.
Page 229 ficonshow ILIR Displays all ILIR (Implicit Link Incident Record) entries within the local switch. ficonshow ILIR fabric Displays all ILIR entries within the fabric. ficonclear RLIR Clears the RLIR entries from the local RLIR database ficonclear RNID Clears the 'not current' entries from the local RNID database.
Page 230: Ficonshow
ficonShow Displays the contents of the specified FICON database. Synopsis ficonshow RNID [fabric] ficonshow LIRR [fabric] ficonshow SwitchRNID [fabric] ficonshow RLIR [fabric] ficonshow ILIR [fabric] Availability all users Description Use this command to display the contents of a FICON database. The database operand is ficonShow the name of the database to display.
Page 231 FRU Serial Number Displays the FRU serial number. Incident Count Displays the incident count. This number increases by 1 for each incident within the individual switch. Link Incident Description Same as Link Incident Type. Link Incident Type Indicates the link incident type as one of the following: •...
Page 232 0x03 Input unit record, if it is an storage port; otherwise, a reserved field for a channel port. 0x04 Output unit, if it is an storage port; otherwise, a reserved field for a channel port 0x05 Reserved field for a channel port. 0x06 Controller, if it is an storage port;...
Page 233 Time Stamp Displays the timestamp, expressed in date format. Type Same as Port Type. Type Number Displays the type number of the self describing node. It also describes the machine type. Operands This command has the following operands: Specify the database to display. Valid values are: database •...
Page 234 To display the local and remote LIRR database: switch:admin> ficonshow LIRR fabric {Fmt Type PID Listener Port WWN Switch Port WWN Listener Type 0x18 N 502b00 50:05:07:64:01:00:15:8d 20:2b:00:60:69:80:1e:4e Conditional 0x18 N 502e00 50:05:07:64:01:40:0f:ca 20:2e:00:60:69:80:1e:4e Conditional 0x18 N 511b00 50:05:07:64:01:00:0f:ca 20:1b:00:60:69:80:1e:4f Conditional 0x18 N 511c00 50:05:07:64:01:40:0d:d0 20:1c:00:60:69:80:1e:4f Conditional 0x18 N...
Page 235 To display the local RLIR database: switch:user> ficonshow RLIR {Fmt Type PID Port Incident Count TS Format Time Stamp 0x18 N 502e00 1 Time server Mon Jan 13 04:29:33 2003 Port Status: Link not operational Link Failure Type: Loss of signal or synchronization Registered Port WWN Registered Node WWN Flag...
Page 236 To display the local ILIR database: switch:user> ficonshow ILIR {FRU Failure [2]: Power Supply[2] failure occurred on Mon Jan 13 12:11:38 2003 Protocol Domain Fabric WWN Switch WWN 0x18 FICON 10:00:00:60:69:33:33:33 10:00:00:60:69:80:1e:4e FRU part number: 23000000602 FRU serial number: FL2L0001071 {Listener Port Type Listener PID Listener Port WWN 0x502b00 50:05:07:64:01:00:15:8d...
Page 237: Filtertest
filterTest Tests frame filters. Synopsis filtertest [--slot slotnumber][-passcnt passcnt][-txports itemlist][-scamoff offset][-dcamoff offset][-fdefoff offset] Availability admin Description Use this command to verify the ASIC frame–level filtering logic including every type of filter actions: FLTACT_LIST_A Action to handle the subgroup A-based filtering. FLTACT_LIST_B Action to handle the subgroup B-based filtering.
Page 238 NOTE: This command is not supported on the HP StorageWorks 4/8 or 4/16 SAN switch, the HP StorageWorks SAN Switch 4/32, or the HP StorageWorks 4/256 SAN Director, which use the Condor ASIC. Operands This command has the following operands: Specify the slot number on which the diagnostic operates.
Page 239: Firmwarecommit
firmwareCommit Commits switch firmware. Synopsis firmwarecommit Availability admin Description Use this command to commit a firmware download to a CP. This command copies an updated firmware image to the secondary partition and commits both partitions of the CP to an updated version of the firmware.
Page 240 See also firmwareDownload firmwareRestore 240 Fabric OS commands...
Page 241: Firmwaredownload
firmwareDownload Downloads switch firmware from a remote host or local directory. Synopsis firmwaredownload [[ -s [ -b -n -i ] ] host,user,pfile,passwd Availability admin Description Use this command to download switch firmware from an FTP server or from a local NFS directory to the switch’s nonvolatile storage area.
Page 242 Specify this operand to activate autoreboot mode. After downloading firmware, the system must be rebooted. If single-CP mode is enabled and this operand is not specified, the user must issue the command reboot manually to activate the downloaded image. If autoreboot mode is enabled, the switch reboots automatically after the firmwareDownload command has been run.
Page 243 switch:admin> firmwareDownload 192.168.166.30,johndoe,/pub/dist/release.plist,12345 This command will upgrade both CPs in the switch. If you want to upgrade a single CP only, please use -s option. You can run firmwareDownloadStatus to get the status of this command. This command will cause the active CP to reset and will require that existing telnet, secure telnet or SSH sessions be restarted.
Page 244 See the HP StorageWorks Fabric OS 5.x diagnostics and system error messages reference guide for more information. See also firmwareCommit firmwareDownloadStatus firmwareRestore firmwareShow reboot version 244 Fabric OS commands...
Page 245: Firmwaredownloadstatus
firmwareDownloadStatus Displays the status of a firmware download. Synopsis firmwaredownloadstatus Availability admin Description Use this command to display an event log that records the progress and status of the current command. The event log is created by the current command firmwareDownload firmwareDownload and is kept until another...
Page 246 [6]: Tue Jan 18 13:27:07 2004 cp0: Firmwaredownload has started on Standby CP. This step will take up to 30 minutes. [7]: Tue Jan 18 13:31:20 2004 cp0: Firmwaredownload has completed successfully on Standby CP. [8]: Tue Jan 18 13:31:23 2004 cp0: Standby CP starts reboot.
Page 247: Firmwarerestore
firmwareRestore Restores the former active firmware image. Synopsis firmwarerestore Availability admin Description Use this command to restore the former active firmware image. This command can only be run if autocommit was disabled during the firmwareDownload. After a and a reboot (with autocommit disabled), the downloaded firmware firmwareDownload becomes active.
Page 248: Firmwareshow
firmwareShow Displays the Fabric OS versions on both partitions of the local and remote CPs. Synopsis firmwareshow Availability admin Description Use this command to display the Fabric OS versions on primary and secondary partitions. For systems with multiple control processor (CP) cards, this command displays this information for both local and remote CPs.
Page 249: Fporttest
fportTest Functional test of F->N, N->F point-to-point path. Synopsis fporttest [-nframes count][-ports itemlist][-seed payload_pattern][-width pattern_width][-size pattern_size] Availability admin Description Use this command to verify the functional operation of the switch by sending ELS ECHO frames from the switch F_Port transmitter and receiving ELS ECHO ACC from the N_Port device into the F_Port receiver. This exercises all the switch components, from the main board, to the SFP, to the fiber cable, to the SFPs (of the N_Port devices and the switch F_Port), and back to the main board.
Page 250 Operands This command has the following optional operands: -nframes count Specify the number of times (or number of frames per port) to execute this test. If count is omitted, the default of 10 is used. Specify the ports to test. If itemlist is omitted, the test is executed on -ports itemlist all online F_Ports in the specified slot.
Page 251 ERR_STAT_BADOS ERR_STAT_C3DISC ERR_STAT_CRC ERR_STAT_ENCIN ERR_STAT_ENCOUT ERR_STAT_TRUNC FDET_PERR FINISH_MSG_ERR FTPRT_STATUS_ERR LESSN_STATUS_ERR MBUF_STATE_ERR MBUF_STATUS_ERR NO_SEGMENT PORT_ABSENT PORT_ENABLE PORT_M2M PORT_STOPPED PORT_WRONG RXQ_FRAME_ERR RXQ_RAM_PERR STATS STATS_C3FRX STATS_FRX STATS_FTX TIMEOUT XMIT See the HP StorageWorks Fabric OS 5.x diagnostics and system error messages reference guide for more information.
Page 252: Frureplace
fruReplace Interactive interface to replace a field replaceable unit (FRU). Synopsis frureplace FRU Availability admin Description Use this command to guide the user in replacing an FRU. The command automatically performs the necessary backup and restore (steps to accommodate the replacement). Operands This the following operand is required: Specify the type of hardware component being replaced.
Page 253 If this session lost for any reason, please re-enter the frureplace command and follow the instructions to complete the operation. Please enter the word `continue' after the new WWN card has been installed: continue Restoring the information to the replacement FRU now, please wait about 20 seconds to complete Verifying the replacement FRU now...
Page 254: Fspfshow Display Fields
fspfShow Displays Fabric Shortest Path First (FSPF) protocol information. Synopsis fspfshow Availability all users Description Use this command to display the FSPF protocol information and internal data structures to the FSPF module. Table 12 describes the information that this command displays. Table 12 fspfshow display fields Field...
Page 255 Table 12 fspfshow display fields Field Description lsrDelayTo Link State Record delay time out value, in milliseconds. lsrDelayCount Counter of delayed Link State Records. ddb_sem FSPF semaphore ID. event_sch FSPF scheduled events bit map. Operands none Examples To display FSPF protocol information: switch:admin>...
Page 256 See also bcastShow topologyShow uRouteShow 256 Fabric OS commands...
Page 257: Fwalarmsfilterset
fwAlarmsFilterSet Enables or disables alarms for Fabric Watch. Synopsis fwalarmsfilterset [mode] Availability admin NOTE: This command requires a Fabric Watch license. Description Use this command to configure alarm filtering for Fabric Watch. By turning off the alarms, all non-environment class alarms are suppressed. By turning on the alarms, all class alarms are generated. Operands This command has the following operand: Specify 1 to enable the alarms, 0 to disable the alarms.
Page 258: Fwalarmsfiltershow
fwAlarmsFilterShow Displays alarm filtering for Fabric Watch. Synopsis fwalarmsfiltershow Availability all users NOTE: This command requires a Fabric Watch license. Description Use this command to display whether alarm filtering is enabled or disabled. Operands none Examples To display the status of alarm filtering in Fabric Watch: switch:user>...
Page 259: Fwclassinit
fwClassInit Initializes all classes under Fabric Watch. Synopsis fwclassinit Availability admin NOTE: This command requires a Fabric Watch license. Description Use this command to initialize all classes under Fabric Watch. The command should be used only after installing a Fabric Watch license to start licensed Fabric Watch classes. See for a list of fwConfigure classes.
Page 260: Fwconfigreload
fwConfigReload Reloads the Fabric Watch configuration. Synopsis fwconfigreload Availability admin NOTE: This command requires a Fabric Watch license. Description Use this command to reload the Fabric Watch configuration. This command should be used only after downloading a new Fabric Watch configuration file from a host. Operands none Examples...
Page 261: Fwconfigure Fabric Watch Classes And Areas
fwConfigure Displays and modifies the Fabric Watch configuration. Synopsis fwconfigure [--enable --port portNumber] | [--disable --port portNumber] Availability admin NOTE: This command requires a Fabric Watch license. 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.
Page 262 Table 13 fwConfigure fabric watch classes and areas (continued) Class Area Port Link loss Sync loss Signal loss Protocol error Invalid words Invalid CRCS RXPerformance TXPerformance State Changes Fabric E_Port downs Fabric reconfigure Domain ID changes Segmentation changes Zone changes Fabric<->QL Fabric logins SFP state changes...
Page 263 Table 13 fwConfigure fabric watch classes and areas (continued) Class Area F/FL_Port (Optical) Link loss Sync loss Signal loss Protocol error Invalid words Invalid CRCS RXPerformance TXPerformance State Changes AL_PA Performance Monitor Invalid CRCS EE Performance Monitor Invalid CRCS RXPerformance TXPerformance Filter Performance Monitor Customer Define...
Page 264 Table 13 fwConfigure fabric watch classes and areas (continued) Class Area Security Telnet Violations HTTP Violations API Violations RSNMP Violations WSNMP Violations SES Violations MS Violations Serial Violations Front Panel Violations SCC Violations DCC Violations Login Violations Invalid Timestamps Invalid Signatures Invalid Certificates SLAP Failures SLAP Bad Packets...
Page 265 Examples To configure thresholds: switch:admin> fwconfigure 1 : Environment class 2 : SFP class 3 : Port class 4 : Fabric class 5 : E-Port class 6 : F/FL Port (Optical) class 7 : Alpa performance Monitor class 8 : EE performance Monitor class 9 : Filter performance Monitor class 10 : Security class 11 : Resource class...
Page 266 See also fwClassInit fwConfigReload fwShow 266 Fabric OS commands...
Page 267: Fwfrucfg
fwFruCfg Displays or modifies FRU state alert configuration. Synopsis fwfrucfg [--show] Availability admin NOTE: This command requires a Fabric Watch license. Description Use this command to configure FRU states and actions. Based on these configuration settings, Fabric Watch generates action when an FRU state changes. To configure e-mail alerts, use fwMailCfg. NOTE: This command is not applicable to platforms without FRUs.
Page 268 Examples To change the FRU state alert configuration: switch:admin> fwfrucfg The current FRU configuration: Alarm State Alarm Action ----------------------------------------------- Slot Power Supply Note that the value 0 for a parameter means that it is NOT used in the calculation Configurable Alarm States are: Absent-1, Inserted-2, On-4, Off-8, Faulty-16 Configurable Alarm Actions are: Errlog-1, E-mail-16...
Page 269: Fwhelp
fwHelp Displays Fabric Watch command information. Synopsis fwhelp Availability all users NOTE: This command requires a Fabric Watch license. Description Use this command to display the commands that configure Fabric Watch. Operands none Examples To display a summary of Fabric Watch commands: switch:user>...
Page 270: Fwmailcfg
fwMailCfg Displays and configures Fabric Watch e-mail alerts. Synopsis fwmailcfg Availability admin NOTE: This command requires a Fabric Watch license. Description Use this command to display or modify the configuration and status of the Fabric Watch e-mail alert in the switch.
Page 271 Config Show Menu -------------------------------------- : Environment class : SFP class : Port class : Fabric class : E-Port class : F/FL Port (Optical) class : Alpa Performance Monitor class : End-to-End Performance Monitor class : Filter Performance Monitor class : Security class : Resource class : FRU Class : Quit...
Page 272 Mail Config Menu -------------------------------------- : Environment class : SFP class : Port class : Fabric class : E-Port class : F/FL Port (Optical) class : Alpa Performance Monitor class : End-to-End Performance Monitor class : Filter Performance Monitor class : Security class : FRU Class : Quit Select an item =>...
Page 273: Fwportdetailshow
fwPortDetailShow Displays the port information for specified user ports. Synopsis fwportdetailshow [--p portNumber] | [--s portState] Availability all users NOTE: This command requires a Fabric Watch license. Description Use this command to print the overall status of the ports specified. The overall status is calculated based on the following contributors: Port Errors Number of link loss occurrences exceeded limit for time period...
Page 274 Yields a port detail report for the specified portState. Valid --s portState portState entries are: Report based on all healthy ports Report based on all marginal ports Report based on all faulty ports Report based on all offline ports Examples To retrieve a port detail report: switch:user>...
Page 275 switch:user> fwportdetailshow --s h Port Detail Report Report time: 06/07/2004 03:11:44 PM Switch Name: switch IP address: 10.255.255.255 Port Exception report [by Healthy] --------Port-Errors------------ -----SFP-Errors---- Port# Type State Dur(H:M) LFA LSY LSI PER INW CRC PSC BLP STM SRX STX SCU ------------------------------------------------------------------------------ HEALTHY 001:11...
Page 276: Fwsamshow
fwSamShow Displays switch availability monitor information. Synopsis fwsamshow Availability all users NOTE: This command requires a Fabric Watch license. Description Use this command to display information about port availability. The information displayed includes total uptime, total downtime, number of faulty occurrences, and total percent of downtime for each port. Operands none Examples...
Page 277: Fwset
fwSet Sets the parameters controlled by Fabric Watch. Synopsis fwset [--port --persistence seconds] Availability all users NOTE: This command requires a Fabric Watch license. Description Use this command to set parameters controlled by Fabric Watch. It allows the user to set the port persistence time (time in which a port must persistently be in a marginal state before being labeled as such) Operands...
Page 278: Fwsettocustom
fwSetToCustom Sets boundary and alarm levels to custom values. Synopsis fwsettocustom Availability admin NOTE: This command requires a Fabric Watch license. Description Use this command to set boundary and alarm levels to custom values for all classes and areas in Fabric Watch.
Page 279: Fwsettodefault
fwSetToDefault Returns boundary and alarm levels to the default values. Synopsis fwsettodefault Availability admin NOTE: This command requires a Fabric Watch license. Description Use this command to return boundary and alarm levels to defaults for all classes and areas in Fabric Watch.
Page 280: Fwshow
fwShow Displays the thresholds monitored by Fabric Watch. Synopsis fwshow [--port --persistence] | [--disable --port] Availability all users NOTE: This command requires a Fabric Watch license. Description Use this command to display the thresholds monitored by Fabric Watch. This command also displays the port persistence time and ports with all thresholds disabled.
Page 281 10 : Security class 11 : Resource class 12 : Quit Select an item => : (1..12) [11] 1 1 : Temperature 2 : Fan 3 : Power Supply 4 : return to previous page Select an area => : (1..4) [4] 2 ===================================================================== Name Label...
Page 282 Raw history: 38 C 38 C 38 C Flags: 0x 40 TRIGGERED Counter: Access via: Function call Address: 0x100155a8 Argument: 0x00000001 Previous: 0x00000026 (38) Current: 0x00000026 (38) Events: Style: Triggered Event 0 occurred 1 time, last at 16:30:17 on 12/09/2011 Event 1 occurred 10 times, last at 16:49:02 on 12/09/2011 * Event 5 occurred 1 time, last at 16:30:23 on 12/09/2011 Callbacks:...
Page 283 Displays shell history. Synopsis Availability all users Description Use this command to view the shell history. 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 enables previously typed commands to be edited.
Page 284: Hadisable
haDisable Disables the High Availability feature in the switch. Synopsis hadisable Availability admin Description Use this command to disable the High Availability feature in the switch. If the HA feature is already disabled, this command does nothing. Operands none Examples To disable the High Availability feature: switch:admin>...
Page 285: Hadump
haDump Displays information about the status of the High Availability feature in the switch. Synopsis hadump Availability all users Description Use this command to display information about the status of the High Availability feature in the switch. This command displays the following information: •...
Page 286 Examples To view information about the High Availability feature: switch:admin> hadump hashow: Local CP (Slot 6, CP1): Active Remote CP (Slot 5, CP0): Standby, Healthy HA enabled, Heartbeat Up, HA State synchronized ipaddrshow: SWITCH0 Ethernet IP Address: 10.64.118.104 Ethernet Subnetmask: 255.255.240.0 Fibre Channel IP Address: 0.0.0.0 Fibre Channel Subnetmask: 0.0.0.0 SWITCH1...
Page 287: Haenable
haEnable Enables the High Availability feature in the switch. Synopsis haenable Availability admin Description Use this command to enable the High Availability feature in the switch. If the HA feature is already enabled, this command does nothing. Operands none Examples To enable the High Availability feature in the switch: switch:admin>...
Page 288: Hafailover
haFailover Forces the failover mechanism so that the standby control processor (CP) becomes the active CP. Synopsis hafailover Availability admin Description Use this command to force the failover mechanism to occur so that the standby CP becomes the active CP. Because results in an active CP reboot, a warning message and confirmation are haFailover...
Page 289: Hashow
haShow Displays control processor (CP) status. Synopsis hashow Availability all users Description Use this command to display control processor status, which includes: • Local CP state (slot number and CP ID) • Remote CP state (slot number and CP ID) •...
Page 290 Examples To display CP status: switch:admin> hashow Local CP (Slot 6, CP1): Active Remote CP (Slot 5, CP0): Standby, Healthy HA Enabled, Heartbeat Up, HA State Synchronized switch:admin> hashow Local CP (Slot 6, CP1): Active Remote CP (Slot 5, CP0): Standby, Failed Backplane PCI fail, severity: CRITICAL HA enabled, Heartbeat Up, HA State not in sync See also...
Page 291: Hasyncstart
haSyncStart Enables HA state synchronization. Synopsis hasyncstart Availability admin Description Use this command to enable the HA state synchronization. Operands none Examples To enable the HA state synchronization: switch:admin> hasyncstart HA State synchronization has started See also haFailover haShow haSyncStop Fabric OS 5.x command reference guide 291...
Page 292: Hasyncstop
haSyncStop Disables the HA state synchronization. Synopsis hasyncstop Availability admin Description Use this command to temporarily disable the HA synchronization. The next failover that takes place after might be disruptive. Operands none Examples To disable the HA state synchronizing process: switch:admin>...
Page 293: Help
help Displays help information for commands. Synopsis help [command] Availability all users Description Use this command without a operand to display an alphabetical list of individual commands. At the end of the list are commands that display groups of commands; for example, displays a list of diagShow diagnostic commands.
Page 294: Historylastshow
historyLastShow Displays the latest entry in the field replaceable unit (FRU) history log. Synopsis historylastshow Availability all users Description Use this command to display the contents of the latest 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 (port blade), CP BLADE (control processor), WWN (world wide name card), or...
Page 295: Historymode
historyMode Displays the mode of the history log. Synopsis historymode Availability all users Description Use this command to display the mode of the history buffer: Rotating mode New messages overwrite the oldest messages in the log. First-in mode Once the log is full, all additional logs are discarded so that the first set of logs to fill the buffer are preserved.
Page 296: Historyshow
historyShow Displays the entire field replaceable unit (FRU) history log. Synopsis historyshow Availability all users Description Use this command to display the entire history log, which records insertion and removal events for blades, power supplies, fans, and world wide name (WWN) cards. Each history record contains three lines of information.
Page 297 Examples To display the entire contents of the history file: switch:admin> historyshow Unit 3 Removed at Tue Aug 14 10:05:37 1970 Factory Part Number: 20-123456-12 Factory Serial Number: 1013456800 POWER SUPPLY Unit 1 Inserted at Tue Aug 14 10:52:10 1970 Factory Part Number: 60-0001536-02 Factory Serial Number:...
Page 298 See also historyLastShow 298 Fabric OS commands...
Page 299: Httpcfgshow
httpCfgShow Displays the Java™ plug-in version. Synopsis httpcfgshow Availability all users Description Use this command to display the version of the Java plug-in supported by Web Tools. This command also displays the URL from which the plug-in can be downloaded. Operands none Examples...
Page 300: 14 I Command Field Descriptions
Displays a task summary. Synopsis i [processID] Availability all users Description Use this command to display information about all of the processes or about a specific process (if a process ID) is supplied. One line is displayed per process. Fields displayed with this commands include those shown in Table Table 14...
Page 301 Table 14 i command field descriptions (continued) Field Description ADDR Memory address of the process The total size of the process in virtual memory, in pages WCHAN The address of an event for which process is sleeping (if blank, process is running) The controlling terminal of the process (? printed for no controlling terminal) TIME...
Page 302: Ifmodeset
ifModeSet Sets the link operating mode for a network interface. Synopsis ifmodeset [“interface“] Availability admin Description Use this command to set the link operating mode for a network interface. 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.
Page 303 Examples To advertise all modes of operation, when not entering this command through the serial console port, follow this scenario for the command: ifModeSet 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.
Page 304: Ifmodeshow
ifModeShow Displays the link operating mode for a network interface. Synopsis ifmodeshow [interface] Availability all users Description Use this command to display the link operating mode for a network interface. Operands This command has the following operand: Specify the name of the interface. You might specify the name interface with quotation marks, but using them is not required.
Page 305: Interfaceshow
interfaceShow Displays FSPF interface information. Synopsis interfaceshow [slotnumber/][portnumber] Availability all users Description Use this command to display the two data structures associated with FSPF interfaces (E_Ports) on the switch: • The permanently allocated Interface Descriptor Block (IDB). The neighbor data structure. This data structure is allocated when a switch port becomes an E_Port. The •...
Page 306 nghbCap Neighbor capabilities. Should be 0. nghbId Domain ID of the neighbor (adjacent) switch. idbNo IDB number. Should be equal to port_number. remPort Port number on the remote switch connected to this port. nflags Internal FSPF flags. initCount Number of times this neighbor was initialized without the interface going down.
Page 307 Operands This command has the following operands: For bladed systems only, specify the slot number of the port to slotnumber display, followed by a slash (/). Specify the port number to display, relative to its slot for bladed portnumber systems. Use to list valid ports.
Page 308 state = NB_ST_FULL lastTransition = Apr 02 20:01:44.512 nghbCap = 0x0 nghbId = 100 idbNo remPort = 52 nflags = 0xf initCount lastInit = Apr 02 20:01:44.460 firstHlo = Apr 02 20:01:44.473 nbstFull = Apr 02 20:01:44.512 delay lastScn = 16 &dbRetransList = 0x1008c6a0 &lsrRetransList = 0x1008c6c4...
Page 309: Interopmode
interopMode Enables or disables HP switch interoperability with switches from other manufacturers. Synopsis interopmode [mode] Availability admin Description Use this command to enable or disable interoperability mode for individual HP switches. This feature enables other manufacturers’ switches to be used in an HP fabric. This command must be executed on all HP switches in the fabric.
Page 310 Examples 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. switch:admin> reboot See also configure 310 Fabric OS commands...
Page 311: Iodreset
iodReset Turns off the in-order delivery (IOD) option. Synopsis iodreset Availability admin Description Use this command to turn off the IOD option. The IOD option is turned off by default; however, if the IOD option was turned on using iodSet, this command can be used to turn it off again. Disabling IOD allows fast re-routing after a fabric topology change.
Page 312: Iodset
iodSet Enables the in-order delivery (IOD) option. Synopsis 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.
Page 313: Iodshow
iodShow Displays the in-order delivery (IOD) option setting. Synopsis iodshow Availability all users Description Use this command to display whether the IOD option is enabled or disabled. Operands none Examples To display the current setting of the IOD option: switch:admin> iodshow IOD is not set See also iodReset...
Page 314: Ipaddrset
ipAddrSet Sets the IP address details for a switch or control processor (CP). Synopsis ipaddrset [-cp number] [-sw number] Availability admin Description Use this command to set the IP addresses on the switch or CP. If no option is provided on a chassis-based system, the command displays the usage.
Page 315 See also ipAddrShow Fabric OS 5.x command reference guide 315...
Page 316: Ipaddrshow
ipAddrShow Display the IP address information for a switch or control processor (CP). Synopsis ipaddrshow [-cp cp_number] | [-sw sw_number] Availability all users Description Use this command to display the IP addresses configured in the system. The -cp option displays the CP IP address and the -sw option displays the switch IP addresses. For switches, the command displays the Ethernet IP address, Ethernet subnetmask, Fibre Channel IP address, and Fibre Channel subnetmask.
Page 317: Islshow
islShow Displays ISL information. Synopsis islshow Availability all users Description Use this command to display the current connections and status of the ISL of each port on this switch. The WWN to which the ISL is connected, the speed of the connection, and whether this ISL is trunked are displayed.
Page 318: Itemlist
itemList Lists parameter syntax information. Synopsis item_list = element | element white item_list element = item | item - item item = num | slot [ white ] / [ white ] num slot = num num = hex | int int = int digit | digit hex = 0x hex digit | hex hex digit digit = 0|1|2|3|4|5|6|7|8|9...
Page 319: Object Descriptions
• In the case of conflicting settings within a single item list, an error is generated, as described earlier. In the case of multiple item list parameters, the last one on the command line overrides previous settings. The exact type of list varies, depending on the test and the parameter; however, the most common are blade ports and user ports.
Page 320: Killtelnet
killTelnet Terminates an open telnet session. Synopsis killtelnet Availability admin Description Use this command to terminate an open telnet session. The command is an interactive killTelnet menu-driven command. Upon invocation, it lists all the current telnet and serial port login sessions. It lists information such as the session number, login name, idle time, IP address of the connection, and timestamp of when the login session was opened.
Page 321 switch:admin> killtelnet Collecting login information..Done List of telnet sessions (3 found) ______________________________________________________________________________ Session No USER IDLE FROM LOGIN@ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ root0 ttyS0 1:17m 5:13pm admin0 pts/0 16.00s 192.168.130.29 6:29pm admin0 pts/1 3.00s 192.168.130.29 6:31pm ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Enter Session Number to terminate (q to quit) 1 Collecting process information...
Page 322: Licenseadd
licenseAdd Adds license keys to switch. Synopsis licenseadd “license“ Availability admin Description Use this command to add license keys to the system. Some features of the switch and the fabric to which it is connected are optional, licensed products. Without a license installed for such products, their services are not available. After you enter a license, the licensed product is available immediately and the system does not need to be rebooted.
Page 323: Licensehelp
licenseHelp Displays commands used to administer license keys. Synopsis licensehelp Availability all users Description Use this command to display a list of the commands used to administer license keys. Operands none Examples To display license commands: switch:admin> licensehelp licenseAdd Add a license to this switch licenseIdShow Show system license ID licenseRemove...
Page 324: Licenseidshow
licenseIdShow Displays system license ID. Synopsis licenseidshow Availability all users Description Use this command to display the license ID of the system. Some features of the switch and the fabric are optional, licensed products. Without a license installed for such products, the services provided by these features are not available. For dual-domain systems, a single license enables both logical switches to use these products.
Page 325: Licenseremove
licenseRemove Removes the license key from the system. Synopsis 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 command to verify that the key has been licenseShow...
Page 326: Licenseshow
licenseShow Displays current license keys. Synopsis licenseshow Availability all users Description Use this command to display current license keys, along with a list of licensed products enabled by these keys. The message No license installed on this switch is displayed when no licenses are installed.
Page 327: Linkcost
linkCost Sets or displays the fabric shortest path first (FSPF) cost of a link. Synopsis 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.
Page 328 Examples To display the cost of a link and set that cost: switch:admin> linkcost Slot Interface Cost -------------------------------------- 500 (STATIC) 1000 500 (STATIC) 200 (STATIC) 1000 1000 1000 1000 1000 1000 1000 11 (E_PORT) 2000 (STATIC) 1000 1000 1000 1000 switch:admin>...
Page 329: Login
login Logs in as a new user. Synopsis login Availability all users Description Use this command to log in to the switch with another user name and password, without first logging out from the original session. If the user was originally connected using a telnet or rlogin session, that session is left open.
Page 330: Logout
logout Logs out from a telnet, rlogin, or serial port session. Synopsis 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 and the serial port returns to the login: prompt. command is accepted as a synonym for logout, as is Ctrl-D at the beginning of a line.
Page 331: Loopporttest
loopPortTest Functional test of L_Port M->M path on a loop. Synopsis loopporttest [-nframes count][-ports itemlist][-seed payload_pattern][-width pattern_width] Availability admin Description Use this command to verify the operation of the switch by sending frames from port M's transmitter and looping the frames back through an external fiber cable, including all the devices on the loop, into port M's receiver.
Page 332 Specify the seed pattern of the test packets. The data types are: -seed payload_pattern CSPAT 0x7e, 0x7e, 0x7e, 0x7e, ... BYTE_LFSR 0x69, 0x01, 0x02, 0x05, ... CHALF_SQ 0x4a, 0x4a, 0x4a, 0x4a, ... QUAD_NOT 0x00, 0xff, 0x00, 0xff, ... CQTR_SQ 0x78, 0x78, 0x78, 0x78, ... CRPAT 0xbc, 0xbc, 0x23, 0x47, ...
Page 333: Lsdbshow Display Fields
lSDbShow Displays the Fabric Shortest Path First (FSPF) link state database. Synopsis lsdbshow [domain] Availability all users Description Use this command to display an FSPF link state database record for switches in the fabric, or one domain within it. There are two types of database entries: The link state database entry, which is permanently allocated.
Page 334 Table 16 lsdbShow display fields (continued) Field Description parent Internal variable. mPathCost Internal variable. mHopsFromRoot Internal variable. lsAge Age, in seconds, of this LSR. An LSR is removed from the database when its age exceeds 3,600 seconds. reserved Reserved for future use. type Type of the LSR.
Page 335 Examples To display the link state record for a switch: switch:admin> lsdbshow 1 Domain = 1 (self), Link State Database Entry pointer = 0x1004d430 lsrP = 0x10053d18 earlyAccLSRs ignoredLSRs lastIgnored = Never installTime = Apr 02 22:25:30.159 lseFlags = 0xa uOutIfsP[0] = 0x00000000 uOutIfsP[1]...
Page 336 LinkId = 2, out port = 34, rem port = 2, cost = 500, costCnt = 0, type = 1 LinkId = 2, out port = 35, rem port = 3, cost = 500, costCnt = 0, type = 1 LinkId = 2, out port = 44, rem port =...
Page 337: Memshow
memShow Displays the amounts of free and used memory in a switch. Synopsis memshow [ -b | -k | -m ] Availability all users Description Use this command to display free and used memory in the switch, as well as the shared memory and buffers used by the kernel.
Page 338: Minicycle
miniCycle Runs a functional test of internal and external transmit and receive paths at full speed. Synopsis minicycle [--slot slotnumber][-nmegs count][-lb_mode mode][-spd_mode mode][-ports itemlist] Availability admin Description Use this command to verify the intended functional operation of an ASIC pair (miniswitch) at the maximum or selected speed by setting up the routing hardware so that frames received by port M are retransmitted by way of port N.
Page 339 Configure up the routing table so that when port M receives frames, the frames are routed back to the partner port N and vice versa. Transmit two frames by way of port M and two frames by way of port N. The following four patterns will be used for the four frames, one pattern each: •...
Page 340 Internal (parallel) loopback Backend bypass and port loopback Backend bypass and SERDES loopback Backend bypass and internal loopback Specifies the speed mode for the test. This parameter is only used for -spd_mode mode Bloom and Condor ASIC-based products, for which this parameter controls the speed at which each port operates.
Page 341 Examples To run a functional test on slot 1 using external (SERDES) loopback: switch:admin> minicycle --slot 1 -lb_mode 2 Running minicycle ....One moment please ... Path 0 ... Spinning ... Path 1 ... Spinning ... Path 2 ... Spinning ... Path 3 ...
Page 342 Diagnostics When it detects failures, the test reports one or more of the following error messages: DATA EPI1_STATUS_ERR ERR_STATS_2LONG ERR_STATS_BADEOF ERR_STATS_BADOS ERR_STATS_C3DISC ERR_STATS_CRC ERR_STATS_ENCIN ERR_STATS_ENCOUT ERR_STATS_TRUNC ERR_STAT_2LONG ERR_STAT_BADEOF ERR_STAT_BADOS ERR_STAT_C3DISC ERR_STAT_CRC ERR_STAT_ENCIN ERR_STAT_ENCOUT ERR_STAT_TRUNC FDET_PERR FINISH_MSG_ERR FTPRT_STATUS_ERR INIT LESSN_STATUS_ERR MBUF_STATE_ERR MBUF_STATUS_ERR NO_SEGMENT PORT_ABSENT...
Page 343 See also backport camTest centralMemoryTest cmemRetentionTest cmiTest crossPortTest itemList portLoopbackTest portRegTest spinSilk sramRetentionTest Fabric OS 5.x command reference guide 343...
Page 344: Minispropshow
minisPropShow Displays ASIC pair properties. Synopsis minispropshow [slotnumber/]asicpair | [--slot slotnumber] -all Availability all users Description Use this command to display the ASIC pair properties. NOTE: This command is not intended for normal user operation and is available to provide supplemental information during system debug.
Page 345 slot: 1, miniS: 2 [2/16] <4,1657/0001 5,1657/0001> (be,17) (be,16) (be,15) (be,14) (be,13) (be,12) (bi,23) (bi,22) (bi,11) (bi,10) (bi,59) (bi,58) (fe,11) (fe,10) (fe,9) (fe,8) slot: 1, miniS: 3 [2/16] <6,1657/0001 7,1657/0001> (be,23) (be,22) (be,21) (be,20) (be,19) (be,18) (bi,7) (bi,6) (bi,27) (bi,26) (bi,43) (bi,42) (fe,15) (fe,14) (fe,13) (fe,12) See also none Fabric OS 5.x command reference guide 345...
Page 346: Mscapabilityshow
msCapabilityShow Displays the Management Server (MS) capabilities. Synopsis mscapabilityshow Availability all users Description Use this command to display the supported capabilities of the Management Server for each switch in the fabric. An asterisk displays next to the name of the local switch. NOTE: Reliable commit service (RCS) is a fabric-wide capability and is supported only if all the switches in the fabric support RCS.
Page 347 See also msConfigure msPlMgmtActivate msPlMgmtDeactivate msTdDisable msTdEnable msTdReadConfig Fabric OS 5.x command reference guide 347...
Page 348: Msconfigure
msConfigure Configures the Management Server (MS) access control list (ACL). Synopsis msconfigure Availability admin Description Use this command to configure the MS ACL. MS allows a SAN management application to retrieve and administer the fabric and interconnect elements, such as switches. This application is located at the Fibre Channel well-known address, 0xFFFFFA.
Page 349 MS Access List consists of (5): { 20:01:00:60:69:00:60:10 20:02:00:60:69:00:60:10 20:03:00:60:69:00:60:10 20:02:00:60:69:00:60:03 20:02:00:60:69:00:60:15 Done Display the access list Add member based on its Port/Node WWN Delete member based on its Port/Node WWN select : (0..3) [1] 0 done ... See also msCapabilityShow msPlatShow msPlClearDB...
Page 350: Msplatshow
msPlatShow Displays the Management Server (MS) platform database. Synopsis msplatshow Availability all users Description Use this command to display information from the MS platform database. This command displays the name of each platform object with the platform type (GATEWAY, HOST_BUS_ADAPTER, and so forth), associated management addresses, and associated node names.
Page 351 See also msCapabilityShow msConfigure msPlatShowDBCB msPlClearDB msPlMgmtActivate msPlMgmtDeactivate Fabric OS 5.x command reference guide 351...
Page 352: Msplatshowdbcb
msPlatShowDBCB Displays the Management Server (MS) platform service database control block. Synopsis msplatshowdbcb Availability all users Description Use this command to display the control block fields associated with the platform database. Operands none Examples To display the MS platform service database control block: switch:admin>...
Page 353: Msplcleardb
msPlClearDB Clears the Management Server (MS) platform database on all switches in the fabric. Synopsis msplcleardb Availability admin Description Use this command to clear the MS platform database on all switches in the fabric. Because this operation is nonrecoverable, it should not be used unless it is intended to resolve a database conflict between two joining fabrics or to establish an entirely new fabric with an empty database.
Page 354: Msplmgmtactivate
msPlMgmtActivate Activates the Management Server (MS) platform service. Synopsis msplmgmtactivate Availability admin Description Use this command to activate the MS platform service in the entire fabric. This command attempts to activate the MS platform service for each switch in the fabric. If successful, the change takes effect immediately and commits to the change to nonvolatile storage of each switch.
Page 355: Msplmgmtdeactivate
msPlMgmtDeactivate Deactivates the Management Server (MS) platform service. Synopsis msplmgmtdeactivate Availability admin Description Use this command to deactivate the MS platform service in the entire fabric. This command deactivates the MS platform service for each switch in the fabric and commits the change to nonvolatile storage. After a successful deactivation, all switches in the fabric boot with the MS platform service disabled.
Page 356: Mstddisable
msTdDisable Disables the Management Server (MS) topology discovery service. Synopsis mstddisable [“ALL”] Availability admin Description Use this command to disable the management server topology discovery service of a local switch or an entire fabric. This change takes effect immediately and commits to the configuration database for all switches;...
Page 357 See also msTdEnable msTdReadConfig Fabric OS 5.x command reference guide 357...
Page 358: Mstdenable
msTdEnable Enables the Management Server (MS) topology discovery service. Synopsis mstdenable [“ALL”] Availability admin Description Use this command to enable the MS topology discovery service on a local switch or on the entire fabric. This change takes effect immediately and commits to the configuration database for all affected switches. If the operand “ALL”...
Page 359: Mstdreadconfig
msTdReadConfig Displays the status of Management Server (MS) topology discovery service. Synopsis mstdreadconfig Availability all users Description Use this command to check whether or not the management server topology discovery service is enabled. Operands none Examples To display the status of the topology discovery service: switch:admin>...
Page 360: Myid
myId Displays the current login session details. Synopsis myid Availability admin Description Use this command to display the status of the system and the login session details. The login session gives details of the following: • CP/switch (or console/serial port) used to log in •...
Page 361: Nbrstateshow
nbrStateShow Displays FSPF neighbor's state. Synopsis 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. FSPF defines a neighbor as a remote E_Port interface that is directly attached to the local switch.
Page 362: Nbrstatsclear
nbrStatsClear Resets FSPF interface counters. Synopsis nbrstatsclear [slotnumber/][portnumber] Availability admin Description Use this command to reset the counters of FSPF frames transmitted and received on each inter-switch link (ISL) or a specific ISL. These counters display using the using the command.
Page 363 (output truncated) nCmdAcc = 37 nInvCmd nHloIn = 10 nInvHlo nLsuIn = 17 nLsaIn = 10 attHloOut = 11 nHloOut = 11 attLsuOut = 12 nLsuOut = 12 attLsaOut = 17 nLsaOut = 17 switch:admin> nbrstatsclear 1/0 switch:admin> interfaceshow 1/0 idbP = 0x10050a38 Interface 0 data structure:...
Page 364 See also interfaceShow portShow switchShow 364 Fabric OS commands...
Page 365: Nodefind
nodeFind Displays all the device Name Server (NS) entries matching a given WWN, device PID, or alias. Synopsis nodefind WWN | PID | ALIAS Availability all users Description Use this command to display the NS information for all the devices in the fabric that have either a port world wide name (WWN) or a node WWN matching with the given WWN;...
Page 366 Examples To display all the device information matching the given data: switch:admin> nodefind a320 Local: Type Pid PortName NodeName 0314d9; 3;22:00:00:04:cf:5d:dc:2d;20:00:00:04:cf:5d:dc:2d; 0 FC4s: FCP [SEAGATE ST318452FC 0001] Fabric Port Name: 20:14:00:60:69:80:04:79 Permanent Port Name: 22:00:00:04:cf:5d:dc:2d Device type: Physical Target Aliases: a320 0314d6;...
Page 367 To display all the device information matching the given PID: switch:admin> nodefind 0x020eef Remote: Type Pid PortName NodeName 020eef; 3;20:00:00:e0:8b:01:ce:d3;20:00:00:e0:8b:01:ce:d3; Fabric Port Name: 20:0e:00:60:69:51:0b:ba Permanent Port Name: 20:00:00:e0:8b:01:ce:d3 Device type: Physical Target Aliases: To display all the device information matching the given no match: switch:admin>...
Page 368: Nsaliasshow
nsAliasShow Displays local Name Server (NS) information, with aliases. Synopsis nsaliasshow [-r -t] Availability all users Description Use this command to display local name server information with the added feature of displaying the defined configuration aliases to which the device belongs. The following message is displayed if there is no information in this switch: There is no entry in the Local Name Server The command...
Page 369 Initiator A SCSI initiator Target A SCSI target Initiator+Target Both a SCSI initiator and a SCSI target Examples To display local NS information with aliases: switch:admin> nsAliasShow Type Pid PortName NodeName TTL(sec) 021200; 2,3;10:00:00:60:69:00:03:19;30:00:00:60:69:00:03:19; na FC4s: FCIP Fabric Port Name: 20:02:00:60:69:01:44:22 Permanent Port Name: 10:00:00:60:69:00:03:19 Aliases: 021300;...
Page 370 To display local NS information with aliases with -r option: switch:admin> nsAliasShow -r Type Pid PortName NodeName 021200; 2,3;10:00:00:60:69:00:03:19;30:00:00:60:69:00:03:19; 3 FC4s: FCIP Fabric Port Name: 20:02:00:60:69:01:44:22 Permanent Port Name: 10:00:00:60:69:00:03:19 Aliases: 021300; 3;10:00:00:60:69:00:02:d6;20:00:00:60:69:00:02:d6; 1 Fabric Port Name: 20:03:00:60:69:01:44:22 Permanent Port Name: 10:00:00:60:69:00:02:d6 Aliases: DeviceAlias 0214e2;...
Page 371 To display local NS information with aliases with -r and -t options: switch:admin> nsAliasShow -r -t Type Pid PortName NodeName 021200; 2,3;10:00:00:60:69:00:03:19;30:00:00:60:69:00:03:19; 3 FC4s: FCIP Fabric Port Name: 20:02:00:60:69:01:44:22 Permanent Port Name: 10:00:00:60:69:00:03:19 Device type: Physical Unknown(initiator/target) Aliases: 021300; 3;10:00:00:60:69:00:02:d6;20:00:00:60:69:00:02:d6; 1 Fabric Port Name: 20:03:00:60:69:01:44:22 Permanent Port Name: 10:00:00:60:69:00:02:d6 Device type: NPV Initiator...
Page 372: Nsallshow
nsAllShow Displays global name server information. Synopsis 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 type operand is supplied, only devices of specified FC-PH type are displayed. If type is omitted, all devices are displayed.
Page 373 See also nsShow switchShow Fabric OS 5.x command reference guide 373...
Page 374: Nscamshow
nscamShow Displays information about remote devices in the Name Server (NS) cache. Synopsis nscamshow [-t] Availability all users Description Use this command to display the local NS cache information about the devices discovered in the fabric by the NS cache manager. The message No Entry found! displays if the NS cache manager does not discover new switches or new devices in the fabric.
Page 375 Examples To display all switch and device entries discovered by the NS in the fabric: switch:admin> nscamShow nscam show for remote switches: Switch entry for 2 state owner known v430 0xfffc01 Device list: count 1 Type Pid PortName NodeName 021200; 2,3;10:00:00:60:69:00:ab:ba;10:00:00:60:69:00:ab:ba;...
Page 376 nsShow switchShow 376 Fabric OS commands...
Page 377: Nsshow
nsShow Displays local Name Server (NS) information. Synopsis nsshow [-r -t] Availability all users Description Use this command to display local NS information about devices connected to this switch. The following message is displayed if there is no information in this switch: There is no entry in the Local Name Server command displays information from all switches.
Page 378 Operands This command has the following operands: Replaces the TTL attribute output with SCR (state change registration) information in the display. This value indicates what type of RSCN a device registers to receive. Values include: SCR=0 Reserved. SCR=1 Fabric detected registration. Register to receive all RSCN requests issued by the fabric controller for events detected by the fabric.
Page 379 Examples To display local NS information: switch:admin> nsShow Type Pid PortName NodeName TTL(sec) 021200; 2,3;10:00:00:60:69:00:03:19;30:00:00:60:69:00:03:19; na FC4s: FCIP Fabric Port Name: 20:02:00:60:69:01:44:22 Permanent Port Name: 10:00:00:60:69:00:03:19 021300; 3;10:00:00:60:69:00:02:d6;20:00:00:60:69:00:02:d6; na Fabric Port Name: 20:03:00:60:69:01:44:22 Permanent Port Name: 10:00:00:60:69:00:02:d6 0214e2; 3;21:00:00:fa:ce:00:21:1e;20:00:00:fa:ce:00:21:1e; na FC4s: FCP [STOREX RS2999FCPH3 MT09]...
Page 380 To display local NS information with -r: switch:admin> nsShow -r Type Pid PortName NodeName 021200; 2,3;10:00:00:60:69:00:03:19;30:00:00:60:69:00:03:19; 3 FC4s: FCIP Fabric Port Name: 20:02:00:60:69:01:44:22 Permanent Port Name: 10:00:00:60:69:00:03:19 021300; 3;10:00:00:60:69:00:02:d6;20:00:00:60:69:00:02:d6; 1 Fabric Port Name: 20:03:00:60:69:01:44:22 Permanent Port Name: 10:00:00:60:69:00:02:d6 0214e2; 3;21:00:00:fa:ce:00:21:1e;20:00:00:fa:ce:00:21:1e; 0 FC4s: FCP [STOREX RS2999FCPH3 MT09]...
Page 381 To display local NS information with -r and -t: switch:admin> nsShow -r -t Type Pid PortName NodeName 021200; 2,3;10:00:00:60:69:00:03:19;30:00:00:60:69:00:03:19; 3 FC4s: FCIP Fabric Port Name: 20:02:00:60:69:01:44:22 Permanent Port Name: 10:00:00:60:69:00:03:19 Device type: Physical Unknown(initiator/target) 021300; 3;10:00:00:60:69:00:02:d6;20:00:00:60:69:00:02:d6; 1 Fabric Port Name: 20:03:00:60:69:01:44:22 Permanent Port Name: 10:00:00:60:69:00:02:d6 Device type: Physical Initiator 021301;...
Page 382: Nszonemember
nsZoneMember Displays the information of all the online devices zoned with the given device. Synopsis nszonemember -a | -u | pid | wwn Availability all users Description Use this command to display information about all the online devices zoned with the given device. Issuing this command without operands displays all online devices zoned with the given device.
Page 383 Examples To display the information of all the online devices zoned with the given device: switch:admin> nszonemember 0x0416e2 3 local zoned members: Type Pid PortName NodeName 041901; 2,3;10:00:00:00:c9:26:0e:ae;20:00:00:00:c9:26:0e:ae; 3 Fabric Port Name: 20:09:00:60:69:50:06:78 Permanent Port Name: 10:00:00:00:c9:26:0e:ae Device type: Physical Initiator 0416e2;...
Page 384 To display the information of all the online devices zoned with the given WWN: switch:admin> nszonemember 10:00:00:00:c8:23:0b:ad 3 local zoned members: Type Pid PortName NodeName 041901; 2,3;10:00:00:00:c9:26:0e:ae;20:00:00:00:c9:26:0e:ae; 3 Fabric Port Name: 20:09:00:60:69:50:06:78 Permanent Port Name: 10:00:00:00:c9:26:0e:ae Device type: Physical Initiator 0416e2;...
Page 385 To display all the unzoned devices in the fabric: switch:admin> nszonemember -u Pid: 0xb01ea9; Aliases: trimm32b_1 Pid: 0xb01eaa; Aliases: trimm32b_2 Pid: 0xb01eab; Aliases: trimm32b_3 Pid: 0xb01eac; Aliases: trimm32b_4 Pid: 0xb01fad; Aliases: trimm32a_5 Pid: 0xb01fae; Aliases: trimm32a_6 Pid: 0xb01fb1; Aliases: trimm32a_7 Pid: 0xb01fb2;...
Page 386: Passwd
passwd Changes the password for a user level. Synopsis passwd [“user“] Availability all users Description Use this command to change the password for the user currently logged in or for another user. To change the password for a specific user, enter the command with the optional user operand. Users logging in to the system by way of RADIUS are allowed to change the passwords of the roles they log in;...
Page 387 Use the following keys to control input: Return When entered at a prompt with no preceding input, accepts the default value (if applicable) and moves to the next prompt. Ctrl+D (end-of-file) When entered at a prompt with no preceding input, terminates the command without changing the password.
Page 388: Pathinfo
pathInfo Display routing and statistics information along a path, covering multiple switches. Synopsis pathinfo [domain] [src_portnumber] [dst_portnumber] [-r] Availability admin Description Use this command to display detailed routing information from a source port or area on the local switch to a destination port or area on another switch. This routing information describes the exact path that a user data stream takes to go from the source port to the destination port, including all intermediate switches.
Page 389 The bandwidth of the output ISL, in Gb/s. It does not apply to the embedded port. Cost The cost of the output link used by FSPF routing protocol. Only applicable if the output link is currently recognized by FSPF. When requested, statistics are reported below the routing information for each hop. These statistics are presented for both the input and output ports, for both receive and transmit modes.
Page 390 The source route can specify a partial route from source to destination (in which case the remaining hops are chosen as the path from the input port or area on the first hop not listed in the source route to the destination), as a full route, or as an arbitrary route across the fabric.
Page 391 Examples To display basic path information to a specific domain, using the command line (noninteractive mode): switch:admin> pathinfo 91 Target port is Embedded In Port Domain ID (Name) Out Port Cost --------------------------------------------------------- 9 (web226) 1000 10 (web229) 1000 8 (web228) 1000 91 (web225) To display basic and extended statistics using interactive mode:...
Page 392 In Port Domain ID (Name) Out Port Cost --------------------------------------------------------- 10 (web229) 1000 Port ----------------------------------------------- B/s (1s) B/s (64s) Txcrdz (1s) Txcrdz (64s) F/s (1s) F/s (64s) Words 240434036 2294316 2119951 2121767 Frames 20025929 54999 162338 56710 Errors In Port Domain ID (Name) Out Port Cost ---------------------------------------------------------...
Page 393: Pdshow
pdShow Displays data from a panic dump file. Synopsis pdshow [panic-dump-file] Availability admin Description Use this command to display data from a panic dump file. The panic dump file contains information that might be useful to determine the cause of the system panic. When executed without any arguments, this command displays output from the latest panic dump file available on the switch.
Page 394 See also portLogDump saveCore 394 Fabric OS commands...
Page 395: Perfaddeemonitor
perfAddEEMonitor Adds an end-to-end monitor to a port. Synopsis perfaddeemonitor [slotnumber/]portnumber SourceID DestID Availability admin NOTE: This command requires a Performance Monitor license Description Use this command to add an end-to-end performance monitor to a port. The performance monitor counts the number of words received, number of words transmitted, and number of CRC errors detected using either of the following two conditions: •...
Page 396 Specify the 3-byte DID (destination ID) of the destination device. It DestID should be in 0xDDAAPP format, where DD is domain ID, AA is area ID and PP is AL_PA ID. For example, 0x050200 has a domain ID of 5, an area ID of 2, and an AL_PA ID of 0. SourceID and DestID both cannot be 0x000000.
Page 397: Perfaddipmonitor
perfAddIPMonitor Adds a filter-based performance monitor for IP frame count. Synopsis perfaddipmonitor [slotnumber/]portnumber [alias] Availability admin NOTE: This command requires a Performance Monitor license. Description Use this command to define filter-based monitors to count the number of IP traffic frames. Only frames transmitted are counted.
Page 398 See also perfAddEEMonitor perfAddReadMonitor perfAddRWMonitor perfAddSCSIMonitor perfAddUserMonitor perfAddWriteMonitor 398 Fabric OS commands...
Page 399: Perfaddreadmonitor
perfAddReadMonitor Adds a filter-based performance monitor for the SCSI Read command. Synopsis perfaddreadmonitor [slotnumber/]portnumber [alias] Availability admin NOTE: This command requires a Performance Monitor license. Description Use this command to define filter-based monitors to count the number of SCSI FCP Read commands in Fibre Channel frames.
Page 400 See also perfAddEEMonitor perfAddIPMonitor perfAddRWMonitor perfAddSCSIMonitor perfAddUserMonitor perfAddWriteMonitor 400 Fabric OS commands...
Page 401: Perfaddrwmonitor
perfAddRWMonitor Adds a filter-based performance monitor for the SCSI read and write commands. Synopsis perfaddrwmonitor [slotnumber/]portnumber [alias] Availability admin NOTE: This command requires a Performance Monitor license. Description Use this command to define filter-based monitors to count the number of SCSI FCP Read and Write commands in Fibre Channel frames.
Page 402 See also perfAddEEMonitor perfAddIPMonitor perfAddReadMonitor perfAddSCSIMonitor perfAddUserMonitor perfAddWriteMonitor 402 Fabric OS commands...
Page 403: Perfaddscsimonitor
perfAddSCSIMonitor Adds a filter-based performance monitor for SCSI frame count. Synopsis perfaddscsimonitor [slotnumber/]portnumber [alias] Availability admin NOTE: This command requires a Performance Monitor license. Description Use this command to define filter-based monitors to count the number of SCSI traffic frames. Only frames transmitted are counted.
Page 404 See also perfAddEEMonitor perfAddIPMonitor perfAddReadMonitor perfAddRWMonitor perfAddUserMonitor perfAddWriteMonitor 404 Fabric OS commands...
Page 405: Perfaddusermonitor
perfAddUserMonitor Adds a user-defined filter-based performance monitor. Synopsis perfaddusermonitor [slotnumber/]portnumber “grouplist“ [alias] Availability admin NOTE: This command requires a Performance Monitor license. Description Use this command to define a custom filter for frame offsets and values. For every offset, each group of comparison values is OR-ed together to determine a match. If there are multiple offsets, each resulting OR function is AND-ed to determine if the entire statement is true, thus incrementing the counter.
Page 406 Mask Specify the mask value to be applied (AND-ed) to frame contents. ValueList Specify up to four values that need to be captured from frame contents. The ValueList can be either hexadecimal or decimal format. SOFx frames are considered a special case. The Offset is specified as 0x0;...
Page 407: Perfaddwritemonitor
perfAddWriteMonitor Adds a filter-based performance monitor for the SCSI write command. Synopsis perfaddwritemonitor [slotnumber/]portnumber [alias] Availability admin NOTE: This command requires a Performance Monitor license. Description Use this command to define filter-based monitors to count the number of SCSI FCP write commands in Fibre Channel frames.
Page 408 See also perfAddEEMonitor perfAddIPMonitor perfAddReadMonitor perfAddRWMonitor perfAddSCSIMonitor perfAddUserMonitor 408 Fabric OS commands...
Page 409: Perfcfgclear
perfCfgClear Clears the previously saved performance monitoring configuration settings from nonvolatile memory. Synopsis perfcfgclear Availability admin NOTE: This command requires a Performance Monitor license. Description Use this command to clear the previously saved end-to-end and filter configuration settings of performance monitoring from nonvolatile memory. Operands none Examples...
Page 410: Perfcfgrestore
perfCfgRestore Restores performance monitoring configuration settings from nonvolatile memory. Synopsis perfcfgrestore Availability admin NOTE: This command requires a Performance Monitor license. Description Use this command to restore the performance monitoring configuration information from nonvolatile memory. This does not restore the information cleared using the command;...
Page 411: Perfcfgsave
perfCfgSave Saves performance monitoring configuration settings to nonvolatile memory. Synopsis perfcfgsave Availability admin NOTE: This command requires a Performance Monitor license. Description Use this command to save the current end-to-end and filter configuration settings of performance monitoring into nonvolatile memory. This enables the performance monitoring configuration to be saved across power cycles.
Page 412: Perfcleareemonitor
perfClearEEMonitor Clears statistics counters of an end-to-end performance monitors. Synopsis perfcleareemonitor [slotnumber/]portnumber [monitorId] Availability admin NOTE: This command requires a Performance Monitor license. This command is deprecated; use instead. perfMonitorClear Description Use this command to clear statistics counters for all end-to-end performance monitors on a port, or an end-to-end monitor associated with a specific monitorId.
Page 413 See also perfAddEEMonitor perfShowEEMonitor perfMonitorClear Fabric OS 5.x command reference guide 413...
Page 414: Perfclearfiltermonitor
perfClearFilterMonitor Clears statistics counters of a filter-based performance monitors. Synopsis perfclearfiltermonitor [slotnumber/]portnumber [monitorId] Availability admin NOTE: This command requires a Performance Monitor license. This command is deprecated; use instead. perfMonitorClear Description Use this command to clear statistics counters for all filter-based performance monitors on a port, or a filter-based monitor associated with a specific monitorId.
Page 415 See also perfAddUserMonitor perfShowFilterMonitor perfMonitorClear Fabric OS 5.x command reference guide 415...
Page 416: Perfclralpacrc
perfClrAlpaCrc Clears the CRC error count associated with a port and arbitrated loop physical address (AL_PA). Synopsis perfclralpacrc [slotnumber/]portnumber [ALPA] Availability admin NOTE: This command requires a Performance Monitor license. Description Use this command to clear a specific CRC error counter associated with a specific port and AL_PA, or all such counters on a port.
Page 417: Perfdeleemonitor
perfDelEEMonitor Deletes one or all end-to-end performance monitors from a port. Synopsis perfdeleemonitor [slotnumber/]portnumber [monitorId] Availability admin NOTE: This command requires a Performance Monitor license. Description Use this command to delete an end-to-end performance monitor from a port, or all such monitors associated with a port.
Page 418: Perfdelfiltermonitor
perfDelFilterMonitor Deletes one or all filter-based performance monitors from a port. Synopsis perfdelfiltermonitor [slotnumber/]portnumber [monitorid] Availability admin NOTE: This command requires a Performance Monitor license. Description Use this command to delete a filter-based performance monitor from a port, or all such monitors associated with a port.
Page 419: Perfhelp
perfHelp Displays performance monitoring help information. Synopsis perfhelp Availability all users NOTE: This command requires a Performance Monitor license. Description Use this command to display the available performance monitoring help commands. Operands none Fabric OS 5.x command reference guide 419...
Page 420 Examples To display commands related to performance monitoring: switch:admin> perfhelp perfCfgSave Save Performance configuration to FLASH perfCfgRestore Restore Performance configuration from FLASH perfCfgClear Clear Performance settings from FLASH perfClrAlpaCrc Clear ALPA device's CRC count perfShowAlpaCrc Get ALPA CRC count by port and ALPA perfAddEEMonitor Add end-to-end monitor to a port perfDelEEMonitor...
Page 421: Perfmonitorclear
perfMonitorClear Clears counters of end-to-end, filter-based, and ISL performance monitors on a port. Synopsis perfmonitorclear --class monitor_class [slotnumber/]portnumber [monitorId] Availability admin Description Use this command to clear counters for performance monitors on a port, specified by class. Monitor classes include end-to-end monitors (EE), filter-based monitors (FLT), and inter-switch link monitors (ISL). Issuing the command on a port clears all end-to-end and filter-based monitors (but not portStatsClear...
Page 422 To clear statistics counters for a filter-based monitor: switch:admin> perfMonitorClear --class FLT 1/2 4 Filter-based monitor number 4 counters are cleared switch:admin> perfMonitorClear --class FLT 1/2 This will clear ALL filter-based monitors' counters on port 2, continue? (yes, y, no, y): [no] y To clear statistics counters for an ISL monitor: switch:admin>...
Page 423: Perfmonitorshow
perfMonitorShow Displays end-to-end, filter-based, and ISL monitors on a port. Synopsis perfmonitorshow --class monitor_class [slotnumber/]portnumber [interval] Availability all users Description Use this command to display previously created monitors on a port. Monitor classes include end-to-end monitors (EE), filter-based monitors (FLT), and ISL monitors (ISL). ISL monitors are automatically activated on E_Ports (not including trunk slaves).
Page 424 Operands The operands are as follows: The monitor class, which can be one of EE (end-to-end), FLT (filter-based), --class or ISL (inter-switch link). This operand is required. monitor_class For bladed systems only, this operand specifies the slot number of the slotnumber port on which the monitor is to be added, followed by a slash (/).
Page 425 To display EE monitors on a port: witch:admin> perfMonitorShow --class EE 4/5 There are 7 end-to-end monitor(s) defined on port 53. OWNER_APP OWNER_IP_ADDR TX_COUNT RX_COUNT CRC_COUNT -------------------------------------------------------------------------------------------------- ---------- 0x58e0f 0x1182ef TELNET 0x0000000000000000 0x0000000000000000 0x0000000000000000 0x21300 0x21dda TELNET 0x00000004d0ba9915 0x0000000067229e65 0x0000000000000000 0x21300 0x21ddc TELNET...
Page 426 To display filter monitor information on a port: switch:admin> perfMonitorShow --class FLT 2/5 There are 7 filter-based monitors defined on port 21. ALIAS OWNER_APP OWNER_IP_ADDR FRAME_COUNT ----------------------------------------------------------------- SCSI_Frame TELNET 0x00000000002c2229 SCSI_WR TELNET 0x000000000000464a SCSI_RW TELNET 0x000000000000fd8c SCSI_RW WEB_TOOLS 192.168.169.40 0x0000000000007ba3 SCSI_RW WEB_TOOLS 192.168.169.190 0x0000000000004f0e...
Page 427: Perfsetporteemask
perfSetPortEEMask Sets overall mask for end-to-end (EE) performance monitors. Synopsis perfsetporteemask [slotnumber/]portnumber TxSIDMsk TxDIDMsk RxSIDMsk RxDIDMsk Availability admin NOTE: This command requires a Performance Monitor license. Description Use this command to set the mask for the EE performance 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.
Page 428 Specify the source ID mask in dd:aa:pp format. Quotation marks are RxSIDMsk optional. RxSIDMsk represents receiving source ID mask. This operand is required. Specify the destination ID mask in dd:aa:pp format. Quotation marks RxDIDMsk are optional. RxDIDMsk represents receiving destination ID mask. This operand is required.
Page 429: Perfshowalpacrc
perfShowAlpaCrc Displays the CRC error count by port or by arbitrated loop physical address (AL_PA). Synopsis perfshowalpacrc [slotnumber/]portnumber [ALPA] Availability all users NOTE: This command requires a Performance Monitor license. Description Use this command to display the CRC error count of one or all devices attached to a port. If the AL_PA operand is specified, only the CRC count for that AL_PA device is displayed.
Page 430: Perfshoweemonitor
perfShowEEMonitor Displays end-to-end performance monitor information on a port. Synopsis perfshoweemonitor [slotnumber/]portnumber [interval] Availability all users NOTE: This command requires a Performance Monitor license. This command is deprecated; use instead. perfMonitorShow Description Use this command to display end-to-end monitor information on a port. for details regarding this command’s output.
Page 431: See Also
Examples To display end-to-end monitor frame traffic on a port at an interval of every 6 seconds: switch:admin> perfshoweemonitor 4/5 6 perfshoweemonitor 53, 6: Tx/Rx are # of bytes and crc is # of crc errors ------------- ------------- ------------- ------------- ------------- ============= =============...
Page 432: Perfshowfiltermonitor
perfShowFilterMonitor Displays filter-based performance monitor information for a port. Synopsis perfshowfiltermonitor [slotnumber/]portnumber [interval] Availability all users NOTE: This command requires a Performance Monitor license. This command is deprecated; use instead. perfMonitorShow Description Use this command to display all the filter-based monitors defined on the specified port and the traffic count values.
Page 433 To display filter monitor information on a port: switch:admin> perfshowfiltermonitor 2/5 There are 7 filter-based monitors defined on port 21. ALIAS OWNER_APP OWNER_IP_ADDR FRAME_COUNT ----------------------------------------------------------------- SCSI_Frame TELNET 0x00000000002c2229 SCSI_WR TELNET 0x000000000000464a SCSI_RW TELNET 0x000000000000fd8c SCSI_RW WEB_TOOLS 192.168.169.40 0x0000000000007ba3 SCSI_RW WEB_TOOLS 192.168.169.190 0x0000000000004f0e SCSI_RD WEB_TOOLS...
Page 434: Perfshowporteemask
perfShowPortEEMask Displays the current address mask for end-to-end performance monitors on a port. Synopsis perfshowporteemask [slotnumber/]portnumber Availability all users NOTE: This command requires a Performance Monitor license. Description Use this command to display the current mask shared across all end-to-end (EE) performance monitors of a port.
Page 435 Examples To display the end-to-end mask on a port: switch:admin> perfshowporteemask 2/4 The EE mask onport 20 is set by application NONE TxSID Domain: TxSID Area: TxSID ALPA: TxDID Domain: TxDID Area: TxDID ALPA: RxSID Domain: RxSID Area: RxSID ALPA: RxDID Domain: RxDID Area: RxDID ALPA:...
Page 436: Pkicreate
pkiCreate Creates public key infrastructure (PKI) objects. Synopsis pkicreate Availability admin Description Use this command in nonsecure mode to create PKI objects: • Switch private key and CSR • Private key pass-phrase • Install root certificate This command does not create the switch certificate. The switch certificate should be obtained offline from Certificate Authority.
Page 437: Pkiremove
pkiRemove Remove existing public key infrastructure (PKI) objects. Synopsis pkiremove Availability admin Description Use this command to remove PKI objects in nonsecure mode. It removes switch private key, private key pass-phrase, CSR, root certificate, and switch certificate. In secure mode, this command displays a message and does not remove PKI objects. Operands none Examples...
Page 438: Pkishow
pkiShow Displays existing public key infrastructure (PKI) objects. Synopsis pkishow Availability all users Description Use this command to display existence of PKI objects, such as switch private key, private key pass-phrase, CSR, root certificate, and switch certificate. Operands none Examples To view PKI objects: switch:admin>...
Page 439: Portalpashow
portAlpaShow Displays the arbitrated loop physical addresses (AL_PAs) of devices attached to a port. Synopsis portalpashow [slotnumber/]portnumber Availability all users Description Use this command to display the device AL_PAs present in a port and whether these devices are public or private.
Page 440: Portbuffershow
portBufferShow Displays the buffer usage information for a port group or for all port groups in the switch. Synopsis portbuffershow [slotnumber/][portnumber] Availability all users Description Use this command to display the current long-distance buffer information for the ports in a port group. The port group can be specified by giving any port number in that group.
Page 441 When there is no connection to a port or the port is disabled, or the port is not an E_Port some of the information in this display is not relevant, such as long distance mode, needed buffers, and link distance. In this case, the irrelevant fields display as hyphens.
Page 442: Portcamshow
portCamShow Displays port-based filter CAM utilization. Synopsis portcamshow [slotnumber/][portnumber] Availability all users Description Use this command to display the current filter CAM utilization of all ports or one port specified at input. The following information is displayed: SID used Total number of CAM entries used by this port. Note that each CAM entry (either SID or DID CAM) can be shared among ports in the same quad.
Page 443 Examples To display the filter CAM utilization for all ports on a switch: switch:user> portcamshow Ports of Slot 9 -------------------------------------------- Port SID used DID used SID free DID free ------------------------------------------- (output truncated) To display the filter CAM utilization for a single port on a switch: switch:user>...
Page 444: Portcfg
portCfg Sets a port's configuration to be disabled or enabled. Synopsis portCfg action [slotnumber/]portnumber [range] mode Availability admin Description Use this command to disable or enable configuration to a certain port or to a range of ports. Operands This command has the following operands: Possible action includes rscnsupr.
Page 445 Examples To configure a port as RSCN suppressed: switch:admin> portcfg rscnsupr 2/4 --enable switch:admin> portcfgshow [output from other slots suppressed] Ports of Slot 2 9 10 11 12 13 14 15 -----------------+--+--+--+--+----+--+--+--+----+--+--+--+----+--+--+-- Speed AN AN AN AN AN AN AN AN AN AN AN AN AN AN AN AN Trunk Port...
Page 446 To configure a port as not RSCN suppressed: switch:admin> portcfg rscnsupr 2/4 --disable switch:admin> portcfgshow [output from other slots suppressed] Ports of Slot 2 9 10 11 12 13 14 15 -----------------+--+--+--+--+----+--+--+--+----+--+--+--+----+--+--+-- Speed AN AN AN AN AN AN AN AN AN AN AN AN AN AN AN AN Trunk Port...
Page 447 To configure a range of ports as RSCN suppressed: switch:admin> portcfg rscnsupr 2/4-7 --enable switch:admin> portcfgshow [output from other slots suppressed] Ports of Slot 2 9 10 11 12 13 14 15 -----------------+--+--+--+--+----+--+--+--+----+--+--+--+----+--+--+-- Speed AN AN AN AN AN AN AN AN AN AN AN AN AN AN AN AN Trunk Port...
Page 448: Portcfgdefault
portCfgDefault Restores the port configuration to default values. Synopsis portcfgdefault [slotnumber/]portnumber Availability admin Description Use this command to reset any special configuration values on a port to their factory defaults. You can view the current port configuration using the command. portCfgShow Operands This command has the following operands:...
Page 449: Portcfgeport
portCfgEPort Enables a port to become an E_Port or prevents a port from becoming an E_Port. Synopsis portcfgeport [slotnumber/]portnumber, mode Availability admin Description Use this command to enable a port to become an E_Port or to prevent a port from becoming an E_Port. The E_Port capability is enabled by default unless this command is used to disable it.
Page 450: Portcfggport
portCfgGPort Designates a port as a G_Port. Synopsis portcfggport [slotnumber/]portnumber, mode Availability admin Description Use this command to designate a port as a G_Port. After 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. A port designated as a G_Port can become an E_Port.
Page 451: Portcfgislmode
portCfgISLMode Enables or disables ISL R_RDY mode on a port. Synopsis portcfgislmode [slotnumber/]portnumber, [mode] Availability admin Description Use this command to enable or disable ISL R_RDY mode on a port. If enabling ISL R_RDY mode on a port, make sure the PID format is consistent across the entire fabric. See the command for more configure information on the core PID format.
Page 452 See also portCfgShow 452 Fabric OS commands...
Page 453: Portcfglongdistance
portCfgLongDistance Configures a port to support long-distance links. Synopsis portcfglongdistance [slotnumber/]portnumber [ distance_level] [vc_translation_link_init] [desired_distance] Availability admin NOTE: This command requires an HP Extended Fabrics license. Description Use this command to allocate enough full-size frame buffers on a particular port to support a long-distance link up to 500 km.
Page 454 desired_distance is used to allocate the buffers. In this case, the port operates in degraded mode instead being disabled due to insufficient buffers. Pressing Ctrl+D cancels the configuration update. When a port is configured to be a long-distance port, the output of portShow switchShow displays the long-distance level.
Page 455 Examples To configure a port to support a 100 km link and be initialized using long-distance link initialization protocol: switch:admin> portcfglongdistance 4/15 L2 1 switch:admin> portshow 4/15 portCFlags: 0x1 portFlags: 0x20001 PRESENT LED portType: portState: 2 Offline portPhys: No_Light portScn: portId: 013f00 portWwn:...
Page 456: Portcfglport
portCfgLPort Locks a port as an L_Port. Synopsis portcfglport [slotnumber/]portnumber locked_mode [private_mode] [duplex_mode] Availability admin Description Use this command to designate a port as an L_Port. The switch then only attempts to initialize that port as an FL_Port. By default, the L_Port is a public L_Port. It can be set to private L_Port and the FLOGI is rejected.
Page 457 Examples To configure a port as a locked L_Port: switch:admin> portcfglport 4/15, 1 switch:admin> portcfgshow [output from other slots suppressed] Ports of Slot 4 9 10 11 12 13 14 15 -----------------+--+--+--+--+----+--+--+--+----+--+--+--+----+--+--+-- Speed AN AN AN AN AN AN AN AN AN AN AN AN AN AN AN AN Trunk Port...
Page 458 458 Fabric OS commands...
Page 459: Portcfgpersistentdisable
portCfgPersistentDisable Disables a port persistently. Synopsis portcfgpersistentdisable [slotnumber/]portnumber Availability admin Description Use this command to persistently disable a port. Persistently disabled ports remain disabled across power cycles, switch reboots, and switch enables. By default, a port is enabled persistently. The change in configuration is effective immediately.
Page 460 See also ficoncupset ficoncupshow portCfgDefault portDisable portEnable portCfgPersistentEnable portShow switchShow 460 Fabric OS commands...
Page 461: Portcfgpersistentenable
portCfgPersistentEnable Enables a port persistently. Synopsis portcfgpersistentenable [slotnumber/]portnumber Availability admin Description Use this command to persistently enable a port. Persistently enabled ports remain enabled across power cycles, switch reboots, and switch enables. By default, a port is enabled persistently. The change in configuration is effective immediately.
Page 462 See also ficoncupset ficoncupshow ficoncupset ficoncupshow portDisable portDisable portEnable portCfgPersistentDisable portCfgShow portShow switchShow 462 Fabric OS commands...
Page 463: Portcfgshow
portCfgShow Displays port configuration settings. Synopsis portcfgshow [slotnumber/][portnumber] Availability all users Description Use this command to display the current configuration of all ports. If no operand is specified, all the port configuration settings are displayed for that switch or for the Core Switch 2/64 logical switch. The following configuration information appears: Speed mode Displays as 1G, 2G, or AN (when in auto speed negotiation...
Page 464 Operands This command has the following operands: For bladed systems only, specifies the slot number of the port to slotnumber display, followed by a slash (/). Specifies the port number to display, relative to its slot for bladed portnumber systems. Use to display a list of valid ports.
Page 465 To display the configuration settings of a port: switch:user> portcfgshow 4/15 Area Number: Speed Level: AUTO Trunk Port Long Distance VC Link Init Locked L_Port Locked G_Port Disabled E_Port ISL R_RDY Mode RSCN Suppressed Persistent Disable See also portCfg portCfgEPort portCfgGPort portCfgLongDistance portCfgLPort...
Page 466: Portcfgspeed
portCfgSpeed Configures the port speed level. Synopsis 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 flash memory and is persistent across switch reboot or power cycle.
Page 467: Portcfgtrunkport
portCfgTrunkPort Configures a port to be enabled or disabled for HP ISL Trunking license. Synopsis portcfgtrunkport [slotnumber/]portnumber mode Availability admin NOTE: This command requires a ISL Trunking license. Description Use this command to enable or disable a port for trunking. NOTE: You can disable or enable trunking using the portCfgTrunkPort...
Page 468: Portdebug
portDebug Sets debug level and verbose level of port modules. Synopsis portdebug dbg_lvl, vbs_lvl Availability admin Description Use this command to set the debug level and verbose level of port modules. Operands This command has the following operands: Specify the debug level to be set for port modules; valid values are 1 to 5. dbg_lvl Specify the verbose level to be set for port modules;...
Page 469: Portdisable
portDisable Disables a port. Synopsis portdisable [slotnumber/]portnumber Availability admin Description Use this command to disable a port. If the port is connected to another switch, the fabric might reconfigure. If the port is connected to one or more devices, the devices can no longer communicate with the fabric.
Page 470: Portenable
portEnable Enables a port. Synopsis portenable [slotnumber/]portnumber Availability admin Description Use this command to enable a port. If the port is connected to another switch, the fabric might reconfigure. If the port is connected to one or more devices, the devices can communicate with the fabric. For ports that come online after being enabled, the following indications might be sent to indicate a state transition: RSCN, SNMP trap, Web pop-up window.
Page 471: Porterrshow
portErrShow Displays port error summary. Synopsis 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: frames tx Frames transmitted...
Page 472 1.9m 1.9m 2.0m 1.9m 1.8m 1.7m 1.8m 1.8m 2.1m 2.0m 2.1m 2.1m 2.0m 2.0m 9.0m 8.6m See also portShow portStatsShow 472 Fabric OS commands...
Page 473: Portflagsshow
portFlagsShow Displays the port status bitmaps for all ports in a switch. Synopsis portflagsshow Availability all users Description Use this command to display the following status for a port: SNMP Displays whether the port is online or offline. Physical Displays the port physical status. Valid values are In_Sync and No_Light.
Page 474 Online In_Sync PRESENT ACTIVE E_PORT G_PORT LOGIN LED ACCEPT Online In_Sync PRESENT ACTIVE E_PORT G_PORT LOGIN LED ACCEPT Offline No_Light PRESENT LED Offline No_Light PRESENT LED Online In_Sync PRESENT ACTIVE F_PORT L_PORT LOGIN NOELP LED ACCEPT Online In_Sync PRESENT ACTIVE F_PORT L_PORT LOGIN NOELP LED ACCEPT Online In_Sync PRESENT ACTIVE E_PORT G_PORT LOGIN LED ACCEPT...
Page 475: Portledtest
portLedTest Cycles user port LEDs. Synopsis portledtest [-npass count][-ports itemlist] Availability admin Description Use this command to exercise the user port LEDs in the current switch on and off by setting the ATTN LEDs to green for the ON condition and unlighted for the OFF condition. The SPEED LEDs are initially set to black before the command execution.
Page 476: Portlogclear
portLogClear Clears the port log. Synopsis portlogclear Availability admin Description Use this command to clear the port log. You might want to clear the port log before triggering an activity so that the log displays only the log events related to that activity. If the port log is disabled, the following message appears as the first line.
Page 477: Portlogconfigshow
portLogConfigShow Displays the current port log configuration. Synopsis portlogconfigshow Availability admin Description Use this command to display the current port log configuration. Operands none Examples To display the current port log configuration: switch:admin> portlogconfigshow max portlog entries = 8192 See also portLogResize Fabric OS 5.x command reference guide 477...
Page 478: Portlogdump
portLogDump Displays the port log without page breaks. Synopsis 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 prompts the user to press Enter portLogShow between each page.
Page 479 switch:user> portLogDump 20 time task event port args ------------------------------------------------------ 08:35:27.899 tShell pstate 08:35:27.899 tReceive pstate 08:35:27.916 tReceive pstate 08:35:28.416 interrupt 08:35:28.433 tFabric ioctl 101d9910,0 08:35:28.433 tFabric 02fffffd,00fffffd,0005ffff,10000000 08:35:28.433 tReceive c0fffffd,00fffffd,00050006 08:35:28.433 tReceive 03fffffd,00fffffd,00050006,02000000 08:35:28.433 tTransmit c0fffffd,00fffffd,00050006 See also portLogClear portLogShow upTime Fabric OS 5.x command reference guide 479...
Page 480: Portlogdumpport
portLogDumpPort Displays the port log of specified port, without page breaks. Synopsis portlogdumpport portid Availability all users Description Use this command to display the port log of specified port. The command displays all entries in the log without any page breaks. It is identical to portLogShowPort, except that prompts portLogShowPort the user to press Enter between each page.
Page 481 08:35:28.433 tFabric ioctl 103646d8,0 08:35:28.466 tFabric ioctl 3c,1 08:35:28.466 tFabric pstate 08:35:28.466 tReceive pstate 08:35:28.466 tReceive pstate 08:35:28.483 tFabric 02fffffd,00fffffd,0006ffff,11100060 08:35:28.483 tReceive c0fffffd,00fffffd,00060007 08:35:28.483 tReceive 03fffffd,00fffffd,00060007,02100060 08:35:28.483 tTransmit c0fffffd,00fffffd,00060007 08:35:28.483 tFabric ioctl 08:35:28.483 tFabric See also portLogClear portLogShow upTime Fabric OS 5.x command reference guide 481...
Page 482: Portlogeventshow
portLogEventShow Displays information about port log events. Synopsis portlogeventshow Availability admin Description Use this command to display information about the ID associated with the various port log events. The Disabled field indicates if the port log for that event ID is disabled (1) or enabled (0). Operands none Examples...
Page 483 create debug nbrfsm timer fcin fcout read write frame msRemQ msRemR nsRemQ nsRemR rscn state xalloc xfree xerr xstate seqst payload zone event switch ficonq routing See also portLogTypeDisable portLogTypeEnable Fabric OS 5.x command reference guide 483...
Page 484: Portloginshow
portLoginShow Displays port login status. Synopsis portloginshow [slotnumber/]portnumber Availability all users Description Use this command to display port login received from devices attached to the specified port. Some information varies with the switch model and port type. The following lines appear: Type Type of login: FLOGI, fabric login to fabric F_Port.
Page 485 Examples To display login information for port 23: switch:admin> portloginshow 23 Type world wide name credit df_sz cos ===================================================== 201700 21:00:00:e0:8b:05:a3:c9 2048 scr=1 201700 21:00:00:e0:8b:05:a3:c9 d_id=FFFC20 201700 21:00:00:e0:8b:05:a3:c9 d_id=FFFFFC See also fcpProbeShow portShow Fabric OS 5.x command reference guide 485...
Page 486: Portlogpdisc
portLogPdisc Sets or clears the debug_pdisc_flag. Synopsis portlogpdisc lvl Availability admin Description Use this command to set or clear the debug_pdisc_flag. Operands This command has the following operand: Specify either 0 to clear the flag or 1 to set the debug_pdisc_flag. Examples To set the debug_pdisc_flag: switch:admin>...
Page 487: Portlogportshow
portLogPortShow Displays information about port log port settings. Synopsis portLogPortShow Availability admin Description Use this command to display information about whether the port log for various ports is enabled or disabled. 1 in the right column indicates port log for that port is disabled, and 0 indicates port log for that port is enabled.
Page 488 See also portLogEventShow portLogReset portLogTypeDisable portLogTypeEnable 488 Fabric OS commands...
Page 489: Portlogreset
portLogReset Enables the port log facility. Synopsis portlogreset Availability admin Description Use this command to enable the port log facility. for events that might disable the port log facility. portLogClear Operands none Examples To enable the port log: switch:admin> portlogreset See also portLogPortShow Fabric OS 5.x command reference guide 489...
Page 490: Portlogresize
portLogResize Resizes the port log to the specified number of entries. Synopsis portlogresize num_entries Availability admin Description Use this command to resize the port log to specified number of entries. If num_entries is less than the already configured port log size, no change is effected. Operands This command has the following operand: Specifies the number of entries to which portlog needs to be...
Page 491: Portlogshow
portLogShow Displays the port log. Synopsis portlogshow [count, saved, portid] Availability all users Description Use this command to display the port log, page by page. command displays the same information as portLogDump, but it enables you to portLogShow press Enter after each page of output. Port logs are circular log files in the switch firmware, which can save up to 8,192 entries.
Page 492 Speed negotiation states fcin Incoming fibre channel information unit fcout Outgoing fibre channel information unit read Information unit header log from read operation write Information unit header log from write operation Information unit header log of an fc error frame frame fc frame payload nsRemQ...
Page 493 ctin Argument 0 is divided into two 16-bit fields: A bit map indicating whether subsequent args are valid (0001 means argument 1 is valid, 0003 means arguments 1 and 2 are valid) Argument 1 is the first word of the CT payload, if applicable (as specified in [A]) Argument 2 is the second word of the CT payload, if applicable (as specified in [A]).
Page 494 Link Failure: NOS Transmit State Link Failure: NOS Receive State Offline: OLS Transmit State Offline: OLS Receive State Offline: Wait for OLS State LIP reason 8001 Retry loop init 8002 Start loop after gaining sync 8003 Restart loop after port reset 8004 LIP when a loop hangs 8005...
Page 495 Examples To view the port log for a port: switch:user> portLogShow 24 time task event port args ------------------------------------------------- 17:05:30.384 PORT 02fffffd,00fffffd,08fbffff,14000000 17:05:30.384 PORT c0fffffd,00fffffd,08fb0e02 17:05:30.384 PORT debug 00c0ffee,00fd0118,00000000,00000001 17:05:30.389 PORT 02fffffd,00fffffd,08fdffff,14000000 17:05:30.389 PORT c0fffffd,00fffffd,08fd0e03 17:05:30.389 PORT debug 00c0ffee,00fd013c,00000000,00000001 17:05:30.504 PORT 02fffffd,00fffffd,08feffff,14000000 17:05:30.504 PORT...
Page 496: Portlogshowport
portLogShowPort Displays the port log of specified port, with page breaks. Synopsis portlogshowport [portid] Availability all users Description Use this command to display the port log, showing 22 entries at a time. It is identical to portLogDumpPort, except that does not prompt the user to press Enter between portLogDumpPort each page of output.
Page 497 08:35:28.483 tFabric 02fffffd,00fffffd,0006ffff,11100060 08:35:28.483 tReceive c0fffffd,00fffffd,00060007 08:35:28.483 tReceive 03fffffd,00fffffd,00060007,02100060 08:35:28.483 tTransmit c0fffffd,00fffffd,00060007 08:35:28.483 tFabric ioctl 08:35:28.483 tFabric (output truncated) See also portLogClear portLogShow upTime Fabric OS 5.x command reference guide 497...
Page 498: Portlogtypedisable
portLogTypeDisable Disables the port log of a specified type. Synopsis portlogtypedisable id Availability admin Description Use this command to disable the port log for a specified port log type. Operands This command has the following operand: Specify a nonzero value that corresponds to the port log type to be disabled.
Page 499: Portlogtypeenable
portLogTypeEnable Enables the port log of a specified type. Synopsis portlogtypeenable id Availability admin Description Use this command to enable the port log for a specified port log type. Operands This command has the following operand: Specify a nonzero value that corresponds to the port log type to be enabled.
Page 500: Portloopbacktest
portLoopbackTest Functional test of port N->N path. Synopsis portloopbacktest [--slot number][-nframes count][-lb_mode mode] [-spd_mode mode][-ports itemlist] Availability admin Description Use this command to verify the functional operation of the switch by sending frames from the port N transmitter and looping them back into the same port N receiver. The loopback is done at the parallel loopback path.
Page 501 Operands This command has the following operands: Specify the slot number on which the diagnostic will operate. The --slot number ports specified will be relative to this slot number. The default is set to 0 and designed to operate on fixed-port-count products. Specify the number of frames to send.
Page 502 Diagnostics Following are possible error messages if failures are detected: DATA ERRSTAT INIT PORTDIED STATS TIMEOUT XMIT See the HP StorageWorks Fabric OS 5.x diagnostics and system error messages reference guide for more information. See also camTest centralMemoryTest cmemRetentionTest cmiTest crossPortTest itemList portRegTest...
Page 503: Portname
portName Assigns or displays a port name. Synopsis portname [slotnumber/]portnumber, name Availability admin Description Use this command to assign or display a port name. Both port_number and name operands are optional for this command. With both the operands present, the port name string will be assigned to the port. With only the port name operand, the previously assigned port name will be displayed.
Page 504 portCfgDefault portShow 504 Fabric OS commands...
Page 505: Portperfshow
portPerfShow Displays port throughput performance in bytes, kilobytes, or megabytes. Synopsis portperfshow [interval] Availability all users Description Use this command to display throughput information for all ports on the switch. Data appears in 8 or 16 columns, one column per port plus one column that displays the total for these ports. Results appear every second or over the specified interval, until Enter, Ctrl-c, or Ctrl-d is pressed.
Page 506: Portregtest
portRegTest Reads and writes test of the ASIC SRAMs and registers. Synopsis portregtest [--slot slotnumber][-ports itemlist][-skiptests mask][-verbose mode] Availability admin Description Use this command to verify that SRAM and register data bits in each ASIC can be independently written and read. The test method used is to write a walking 1 pattern to each bit location.
Page 507 Examples To run a bit write/read test of the ASIC SRAMs and registers: switch:admin> portregtest -ports 1/0-1/15 Running Port Register Test ..Test Complete: "portregtest" Pass 1 of 1 Duration 0 hr, 0 min & 33 sec (0:0:33:447). passed. Diagnostics When this command detects failures, the test might report one or more of the following error messages: BUS_TIMEOUT REGERR...
Page 508: Portrouteshow
portRouteShow Displays routing tables for the specified port. Synopsis portrouteshow [slotnumber/]portnumber Availability all users Description Use this command to display the port address ID and the contents of the following port routing tables: External unicast routing table Displays how the specified port forwards unicast frames to remote domains in the following format: domain_number: ports_bitmap •...
Page 509 Examples To display the routing tables for a port: switch:user> portrouteshow 4/15 port address ID: 0x02bf00 external unicast routing table: 1: 0x4 (vc=3) 2: 0x10000 (vc=0) internal unicast routing table: 60: 0x8000 (vc=2) 63: 0x1000 (vc=5) broadcast routing table: 0x10000 See also bcastShow fabricShow...
Page 510: Portshow Display Fields
portShow Displays port status. Synopsis portshow [slotnumber/]portnumber Availability all users Description Use this command to display status information for the specified port, as shown in Table 17. Information varies with the switch model and port type. Table 17 portShow display fields Field Description portName...
Page 511 Table 17 portShow display fields (continued) Field Description No_Card No interface card present No_Module No module (SFP or other) present No_Light Module not receiving light No_Sync Receiving light but out of sync In_Sync Receiving light and in sync Laser_Flt Module is signaling a laser fault Port_Flt Port marked faulty Diag_Flt...
Page 512 Table 17 portShow display fields (continued) Field Description Suspended Transmission suspended interrupts. Parity_err Central memory parity errors. 2_parity_err Secondary Tx parity errors. CMI_bus_err Control message interface errors. The second column displays link error status block counters. The third column displays the number of F_RJTs and F_BSYs generated. For L_Ports, the third column also displays the number of loop initialization protocols (LIPs) received, number of LIPs transmitted, and the last LIP received.
Page 513 Examples To display the state of a port: switch:user> portshow 2/15 portName: Tape drive 8 portHealth: HEALTHY Authentication: None portDisableReason: None portCFlags: 0x1 portFlags: 0x903 PRESENT ACTIVE E_PORT G_PORT U_PORT LOGICAL_ONLINE LOGIN portType: 10.0 portState: 1 Online portPhys: In_Sync portScn: E_Port Trunk port port generation number:...
Page 514: Portstats64Show
portStats64Show Displays the 64-bit hardware statistics for a port. Synopsis portstats64show [slotnumber/]portnumber Availability all users Description Use this command to display the following hardware statistics for a port. Two integers are reported for most values. In such cases, the top word is the most significant. stat64_wtx Number of 4-byte words transmitted.
Page 515 Operands This command has the following operands: For bladed systems only, specify the slot number of the port to be slotnumber configured, followed by a slash (/). Specify a port number to be configured, relative to its slot for bladed portnumber systems.
Page 516 er64_crc top_int : Frames with CRC errors bottom_int : Frames with CRC errors er64_trunc top_int : Frames shorter than minimum bottom_int : Frames shorter than minimum er64_toolong top_int : Frames longer than maximum bottom_int : Frames longer than maximum er_bad_eof top_int : Frames with bad end-of-frame bottom_int : Frames with bad end-of-frame er64_enc_out...
Page 517: Portstatsclear
portStatsClear Clears the hardware statistics of a specified switch port. Synopsis portstatsclear [slotnumber/]portnumber Availability admin Description Use this command to clear the hardware statistics, including the AL_PA-based CRC monitor, end-to-end monitor, and filter-based monitor statistics, for a specified switch port. For platforms with a Bloom-based ASIC, the command also clears the hardware statistics for associated ports in the target port quad.
Page 518: Portstatsshow
portStatsShow Displays port hardware statistics. Synopsis portstatsshow [slotnumber/]portnumber Availability all users Description Use this command to display port hardware statistics counters. Some counters are platform- and port-specific and appear only with those platforms and ports. All statistics have a maximum 32-bit value of 4,294,967,295.
Page 519 CLS received when OPEN. fl_cls_rx OPN/CLS BB_Credit stalls. fl_bb_stall Number of CFIFOs allocated. fl_cf_alloc CFIFOs delivered when OPENED. fl_cf_opn Number of CFIFOs full stalls. fl_cf_full CFIFO not available stalls. fl_cf_na Number of age count triggers. fl_trig_age Number of loop not busy triggers. fl_trig_lp Number of times the FL_Port entered OPEN state.
Page 520 tim_rdy_pri 1279213528 Time R_RDY high priority tim_txcrd_z Time BB_credit zero er_enc_in Encoding errors inside of frames er_crc Frames with CRC errors er_trunc Frames shorter than minimum er_toolong Frames longer than maximum er_bad_eof Frames with bad end-of-frame er_enc_out 8600353 Encoding error outside of frames er_disc_c3 Class 3 frames discarded open...
Page 521: Portswap
portSwap Swaps area numbers of two ports. Synopsis portswap [slotnumber1/]portnumber1 [slotnumber2/]portnumber2 Availability admin Description Use this command to swap area numbers for a pair of ports. Both ports must be disabled prior to executing this command and the port-swapping feature must be enabled using portSwapEnable. NOTE: To undo a previous port swap, execute again on the same two ports.
Page 522 See also portDisable portEnable portShow portSwapDisable portSwapEnable portSwapShow switchShow 522 Fabric OS commands...
Page 523: Portswapdisable
portSwapDisable Disables the portswap feature. Synopsis portswapdisable Availability admin Description Use this command to disable the portswap feature. The command cannot be used after this portSwap feature is disabled. The enabled state of the portswap feature is persistent across reboots and power cycles. NOTE: Enabling or disabling the portswap feature does not effect previously performed portswap operations.
Page 524: Portswapenable
portSwapEnable Enables the portswap feature. Synopsis portswapenable Availability admin Description Use this command to enable the portswap feature. The command cannot be used unless the portSwap feature is first enabled with this command. The enabled state of the portswap feature is persistent across reboots and power cycles. NOTE: Enabling or disabling the portswap feature does not effect previously performed portswap operations.
Page 525: Portswapshow
portSwapShow Displays the state of the portswap feature. Synopsis portswapshow Availability all users Description Use this command to display the state of the portswap feature, as well as port and area information for those ports whose area number ID different from the default area number. The default area number of a port is the same as its switch port number.
Page 526: Porttest
portTest Performs a functional test of a switch in a live fabric. Synopsis porttest [-ports itemlist][-iteration count][-userdelay time][-timeout time][-pattern pattern][-patsize size][-seed seed][-listtype porttype] Availability admin Description Use this command to isolate problems to a single replaceable element and isolate problems to near-end terminal equipment, far-end terminal equipment, or the transmission line.
Page 527 Operands This command has the following operands: Specify a list of user ports to test. By default, all the user ports -ports itemlist in the switch are tested. See the help pages for itemList further details. Specify the number of times (or number of frames per port) to -iteration count execute this test.
Page 528: Porttestshow
portTestShow Displays information from portTest. Synopsis porttestshow [-ports itemlist] Availability admin Description Use this command to display a snapshot of information from portTest. The following information appears: • Pass or fail information on a given port • Port type tested •...
Page 529 Examples To display information from portTest: switch:admin> porttestshow 1 Port 1 : PASS PortType: OTHER PortState: NO TEST PortInternalState: INIT PortTypeToTest: NO_TEST Pattern: 0x0 Seed: 0x0 UserDelay: 0 TotalIteration: 0 CurrentIteration: 0 TotalFail: 0 ConsecutiveFail: 0 StartTime: NONE StopTime: NONE Timeout: 0 ErrorCode: 0 See also...
Page 530: Powerofflistset
powerOffListSet Sets slot power-off list order. Synopsis powerofflistset Availability admin Description Use this command to change the order in which slots are powered off. This command displays the current order and then prompts you to indicate the new order. Whenever a power supply goes out of service or a field-replaceable unit (FRU) is inserted, the system available power is compared to the system required power to determine if there is enough power to operate.
Page 531 Examples To modify the power-off list order: switch:admin> powerofflistSet Slot Current POL ------------------- 1st slot to be powered off: (1..10) [10] 1 2nd slot to be powered off: (2..10) [9] 2 (continued on next page) 3rd slot to be powered off: (3..10) [8] 3 4th slot to be powered off: (4..10) [7] 4 5th slot to be powered off: (7..10) [7] 10 6th slot to be powered off: (7..9) [8] 9...
Page 532 slotPowerOff slotPowerOn slotShow 532 Fabric OS commands...
Page 533: Powerofflistshow
powerOffListShow Displays slot power-off list order. Synopsis 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.
Page 534 See also chassisShow powerOffListShow psShow slotPowerOff slotPowerOn slotShow 534 Fabric OS commands...
Page 535: Psshow
psShow Displays power supply status. Synopsis psshow Availability all users Description Use this command to display the current status of the switch power supplies. The status of each supply is displayed as: Power supply functioning correctly absent Power supply not present unknown Unknown power supply unit installed predicting failure...
Page 536 See also chassisShow fanShow 536 Fabric OS commands...
Page 537: Qloopadd
qloopAdd Adds a member to a QuickLoop. Synopsis qloopadd “qloopname“, “member;member“ Availability admin NOTE: This command requires HP Advanced Zoning license, which is included within the Base Configuration Services and bundled with each B-series switch. 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.
Page 538: Qloopcreate
qloopCreate Creates a QuickLoop. Synopsis qloopcreate “qloopname“, “member;member“ Availability admin NOTE: This command requires HP Advanced Zoning license, which is included within the Base Configuration Services and bundled with each B-series switch. 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.
Page 539 Examples 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 Fabric OS 5.x command reference guide 539...
Page 540: Qloopdelete
qloopDelete Deletes a QuickLoop. Synopsis qloopdelete “name“ Availability admin NOTE: This command requires HP Advanced Zoning license, which is included within the Base Configuration Services and bundled with each B-series switch. 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 command.
Page 541: Qloopremove
qloopRemove Removes a member from a QuickLoop. Synopsis qloopremove “qloopName“, “member;member“ Availability admin NOTE: This command requires HP Advanced Zoning license, which is included within the Base Configuration Services and bundled with each B-series switch. Description Use this command to remove one or more members from a QuickLoop. The member list is identified through an exact string match;...
Page 542 See also qloopAdd qloopCreate qloopDelete qloopShow 542 Fabric OS commands...
Page 543: Qloopshow
qloopShow Displays QuickLoop information. Synopsis qloopshow [pattern][, mode] Availability all users NOTE: This command requires HP Advanced Zoning license, which is included within the Base Configuration Services and bundled with each B-series switch. Description Use this command to display QuickLoop configuration information. If no parameters are specified, all zone configuration information (defined and enabled) is displayed.
Page 544 Examples To display all QuickLoops beginning with the letter “q”: switch:admin> qloopshow "q*" qloop: qlp1 10:00:00:60:69:00:60:11 10:00:00:60:69:00:30:02 qloop: qlp2 10:00:00:60:69:00:60:13 See also qloopAdd qloopCreate qloopDelete qloopRemove 544 Fabric OS commands...
Page 545: Quietmode
quietMode Sets or clears the telnet session quiet mode, or displays the current mode. Synopsis quietmode [mode] Availability admin Description This command affects the output displayed on the switch console (telnet session only). By default, quiet mode is off and all switch tasks can send output to the console. Some output is caused by asynchronous events, such as the fabric reconfiguring or devices logging in.
Page 546: Rcsdisabled
rcsDisabled Displays whether Reliable Commit Service (RCS) is enabled. Synopsis rcsdisabled Availability all users Description Use this command to display whether RCS is enabled. If rcsDisabled = 0 appears, RCS is enabled; rcsDisabled = 1 appears if RCS is disabled. NOTE: This command can be issued on Fabric OS v4.1.x, and above, and v5.x FCS switch in the fabric.
Page 547: Reboot
reboot Reboots either one control processor (CP) or the entire system. Synopsis reboot Availability admin Description Use this command to immediately reboot a CP in a director or an entire switch. The command line session is closed. When this command is issued on a single-CP system, all switches in the system are entirely shut down and all Fibre Channel ports become inactive until the system restarts.
Page 548: Routehelp
routeHelp Displays a list of FSPF-related commands. Synopsis routehelp Availability all users Description Use this command to display a list of FSPF-related commands. Operands none Examples To display a list of FSPF-related commands: switch:admin> routehelp aptPolicy Get or set Advanced Performance Tuning policy bcastShow Print broadcast tree information dlsReset...
Page 549: Savecore
saveCore Saves or removes core files created by daemons. Synopsis To FTP core files: savecore [[-f core-file-list]... | ] [-h ip-address] [-u user_name | -a] [-p password][-d remote_directory] To remove core files: savecore [[-r core-files-directory-list]... | ] To list core files: savecore -l Availability admin...
Page 550 Examples To list all core files in a CP: switch:admin> savecore -l /core_files/panic/core.873 /core_files/zoned/core.1234 /core_files/zoned/core.5678 /mnt/core_files/nsd/core.873 /mnt/core_files/panic/core.873 To remove selected core files from a CP: switch:admin> savecore -r /core_files/panic/,/core_files/zoned/,/mnt/core_files/nsd/ Removing: /core_files/panic/ Removing: /core_files/zoned/ Removing: /mnt/core_files/nsd/ To remove selected core files from the CP (using multiple -r operands): switch:admin>...
Page 551 To FTP selected core file directories: switch:admin> savecore -h 192.168.204.188 -u jsmith -d core_files_here -p password -f /core_files/zoned/,/mnt/core_files/nsd/ /core_files/zoned//core.1234: 1.12 kB 382.60 B/s /core_files/zoned//core.5678: 1.12 kB 381.95 B/s /mnt/core_files/nsd//core.873: 1.12 kB 382.53 B/s Files transferred successfully! To remove all core files using the savecore management utility: switch:admin>...
Page 552 To FTP core files using the savecore management utility: switch:admin> savecore following 1 directories contains core files: [ ]0: /core_files/zoned Welcome to core files management utility. Menu 1(or R): Remove all core files 2(or F): FTP all core files 3(or r): Remove marked files 4(or f): FTP marked files 5(or m): Mark Files for action 6(or u): Un Mark Files for action...
Page 553 To remove core files from a selected directory: switch:admin> savecore following 2 directories contains core files: [ ]0: /core_files/nsd [ ]1: /core_files/zoned Welcome to core files management utility. Menu 1(or R): Remove all core files 2(or F): FTP all core files 3(or r): Remove marked files 4(or f): FTP marked files 5(or m): Mark Files for action...
Page 554 See also none 554 Fabric OS commands...
Page 555: Secactivesize
secActiveSize Displays the size of the active security database. Synopsis secactivesize Availability admin Description Use this command to display the size of the active security database. The maximum is 256 KB. This command is intended strictly for debugging purposes by technical support staff. The information displayed might not be supported between releases and is subject to change arbitrarily.
Page 556: Secauthsecret
secAuthSecret Manages the DH-CHAP shared secret key information. Synopsis secauthsecret [--show][--set][--remove value | --all] Availability admin Description Use this command to manage the DH-CHAP shared secret key database used for the authentication. This command displays, sets, and removes shared secret key information from the database or deletes the entire database.
Page 557 To set the shared secret: switch:admin> secAuthSecret --set This command sets up secret keys for the DH-CHAP authentication. The minimum length of a secret key is 8 characters and maximum 40 characters. Setting up secret keys does not initiate DH-CHAP authentication. If switch is configured to do DH-CHAP, it is performed whenever a port or a switch is enabled.
Page 558 To remove a shared secret WWN: switch:admin> secAuthSecret --remove This command deletes database of DH-CHAP secret keys. If a fabric requires authentication, deleting this database may cause switch to segment from the fabric. Re-enter peer secret: Enter local secret: Re-enter local secret: Enter WWN, Domain, or switch name (Leave blank when done): Are you done? (yes, y, no, n): [no] y Saving data to key store...
Page 559: Seccertutil
secCertUtil A utility that manages third-party PKI-based certificates in the switch. Synopsis seccertutil Availability admin Description Use this command to manage third-party certificates in the switch, as follows: • Generate a public/private key pair. • Generate a certificate signing request (CSR). •...
Page 560 Operands The operands are as follows: Generates a public/private key pair.This is the first step for setting up genkey third-party certificates. The key length can be either 1,024 or 2,048 bits long. The greater the length of the key, the more secure is the connection; however, the performance goes down.
Page 561 To generate a CSR: switch:admin> seccertutil gencsr Country Name (2 letter code, eg, US): State or Province Name (full name, eg, California): Locality Name (eg, city name): Organization Name (eg, company name): Organizational Unit Name (eg, department or section name): Common Name (Fully qualified Domain Name, or IP address): generating CSR, file name is: <ip_address>.csr Done...
Page 562 To display contents of a certificate: switch:admin> seccertutil show certificate file name See also none 562 Fabric OS commands...
Page 563: Secdefinesize
secDefineSize Displays the size of the defined security database. Synopsis secdefinesize Availability admin Description Use this command to display the size of the defined security database. The maximum size is 256 KB. This command is intended strictly for debugging purposes by technical support staff. The information displayed might not be supported between releases and is subject to change arbitrarily.
Page 564: Secfabricshow
secFabricShow Displays security-related fabric information. Synopsis secfabricshow Availability all users Description This command displays the security-related information about the fabric. The information displayed is as follows: Role Displays whether the switch is the primary FCS, backup FCS, or not FCS. Displays the world wide name of the switch.
Page 565 See also secPolicyDump secPolicyShow Fabric OS 5.x command reference guide 565...
Page 566: Secfcsfailover
secFCSFailover Enables a backup FCS switch to take over as primary FCS switch. Synopsis secfcsfailover Availability admin Description Use this command to enable a backup FCS switch to take over as the primary FCS switch. This command can be issued only on a backup FCS switch. After this command is issued, the primary FCS switch aborts its current transaction and moves the backup FCS switch to the top of the FCS list.
Page 567: Secglobalshow
secGlobalShow Displays the current internal security state information. Synopsis secglobalshow Availability admin Description Use this command to display security server (secd) specific information as a snapshot of its current state. The information can include some of the following: • The version and general information The current status of the RCS transaction •...
Page 568: Sechelp
secHelp Displays information about security commands. Synopsis sechelp Availability all users Description Use this command to display a list of security commands. Operands none 568 Fabric OS commands...
Page 569 Examples To display a list of security telnet commands: switch:admin> sechelp pkiCreate Creates new pki objects pkiRemove Removes pki objects pkiShow Displays existence of pki objects secActiveSize Displays size of the active (security) database secAuthSecret Creates/Manages/Displays DHCHAP secret key details secCertUtil Creates/Manages/Displays third party PKI certificates...
Page 570: Secmodedisable
secModeDisable Disables secure mode. Synopsis secmodedisable Availability admin Description Use this command to disable secure mode on all switches in the fabric. This command deletes both the defined and active security database. This command can be issued only in secure mode and only from the primary FCS switch. Operands none Examples...
Page 571: Secmodeenable
secModeEnable Enables secure mode. Synopsis secmodeenable [--quickmode] | [[--currentpwd] [--lockdown[=scc |=dcc]] [--fcs list_of_switches | list_of_switches]] Availability admin Description Use this command to enable secure mode on all switches in the fabric. This command fails if any switch in the fabric is not capable of enforcing the security policies defined in the security database. If no operand is specified, the command becomes interactive.
Page 572 If the fabric is in secure mode and no FCS switches are present in the fabric, the command can be issued on any switch. This is used to recover a secure fabric that has no FCS switch. Only the --fcs option can be used in this case.
Page 573 This option is a shorthand notation for a combination of the --quickmode --currentpwd, --lockdown, and --fcs "*" options. On successful execution of the command, security is enabled in the fabric with all switches being FCS, all switches having passwords identical to that of the primary FCS and SCC, and DCC policies capturing and maintaining the current configuration of the fabric.
Page 574 To enable a security policy that includes three FCS switches specified by domain, WWN address, and switch name: fcsprimary:admin> secmodeenable Your use of the certificate-based security features of the software installed on this equipment is subject to the End User License Agreement provided with the equipment and the Certification Practices Statement,...
Page 575 Enter WWN, Domain, or switch name(Leave blank when done): sw1 Switch WWN is 10:00:00:60:69:80:04:0a. The new FCS list: 10:00:00:60:69:80:04:0f 10:00:00:60:69:80:04:0e 10:00:00:60:69:80:04:0a Enter WWN, Domain, or switch name(Leave blank when done): Are you done? (yes, y, no, n): [no] y Is the new FCS list correct? (yes, y, no, n): [no] y Please enter current admin account password: Warning:...
Page 576 To enable secure mode using --currentpwd --fcs “*”: fcsprimary:admin> secModeEnable --currentpwd --fcs "*" Your use of the certificate-based security features of the software installed on this equipment is subject to the End User License Agreement provided with the equipment and the Certification Practices Statement, which you may review at http://www.switchkeyactivation.com/cps.
Page 577: Secmodeshow
secModeShow Displays whether security mode is enabled or disabled. Synopsis secmodeshow Availability all users Description Use this command to display the current security mode of the fabric. The fabric can be in secure mode or nonsecure mode. The command displays secure mode as ENABLED or DISABLED. If the fabric is in secure mode, the following information appears: Version stamp Displays the current version and build date and time of the security database.
Page 578: Secnonfcspasswd
secNonFcsPasswd Sets the admin password for non-FCS switches. Synopsis secnonfcspasswd Availability admin Description Use this command to change the admin password on all non-FCS switches in the fabric. This command can be issued only from the primary FCS switch in secure mode. The changed passwords are persistent across reboots.
Page 579: Secpolicyabort
secPolicyAbort Aborts all changes to the defined database that have not been saved. Synopsis secpolicyabort Availability admin Description Use this command to abort all changes to the defined security database that have not been saved to flash memory. NOTE: This command can be issued only in secure mode and only from the primary FCS switch. Operands none Examples...
Page 580: Secpolicyactivate
secPolicyActivate Applies defined policy set to all switches in the fabric. Synopsis secpolicyactivate Availability admin Description Use this command to activate the current defined security policy to all switches in the fabric. After activation, the defined policy set becomes the active policy set. NOTE: This command can be issued only in secure mode and only from the primary FCS switch.
Page 581: Secpolicyadd
secPolicyAdd Adds members to an existing security policy. Synopsis secpolicyadd name, “member [; member...]“ Availability admin Description Use this command to add members to an existing access policy. The new members must not already be members within the policy or the command fails. Each policy corresponds to a management method.
Page 582 Operands This command has the following operands: Specify the name of an existing policy to which you want to add members. Valid values name for this operand are: DCC_POLICY_nnn FCS_POLICY TELNET_POLICY HTTP_POLICY API_POLICY RSNMP_POLICY WSNMP_POLICY SES_POLICY (HP does not support SES_POLICY) MS_POLICY SERIAL_POLICY FRONTPANEL_POLICY...
Page 583 The following policy types require members be specified by WWN address: • FCS_POLICY • SES_POLICY (HP does not support SES_POLICY) • MS_POLICY • SERIAL_POLICY • FRONTPANEL_POLICY • SCC_POLICY These policy types require members be specified as WWN strings, domain IDs, or switch names.
Page 584 To add two devices to attach to domain 3, ports 1 and 3, in an existing empty DCC policy; port WWN of the first device is 11:22:33:44:55:66:77:aa and port WWN of the second device is 11:22:33:44:55:66:77:bb: switch:admin> secpolicyadd "DCC_POLICY_abc", "11:22:33:44:55:66:77:aa;11:22:33:44:55:66:77:bb;3(1,3)" Member(s) have been added to DCC_POLICY_abc.
Page 585: Secpolicycreate
secPolicyCreate Creates a new security policy. Synopsis secpolicycreate “name” [, “member [;member...]“ Availability admin Description Use this command to create a new security policy. All policies can be created only once, except for the DCC_POLICY_nnn. Each DCC_POLICY_nnn must have a unique name. Adding members while creating a policy is optional.
Page 586 Operands This command has the following operands: Specify the name of a policy you want to create. Valid values for this operand are: name • DCC_POLICY_nnn • TELNET_POLICY • HTTP_POLICY • API_POLICY • RSNMP_POLICY • WSNMP_POLICY • SES_POLICY (HP does not support SES_POLICY) •...
Page 587 WWN Member Policy Types The following policy types require members be specified by WWN address: SES_POLICY (HP does not support SES_POLICY) MS_POLICY SERIAL_POLICY FRONTPANEL_POLICY These policy types require member IDs be specified as WWN strings, domains, or switch names. If domain, or switch names are used, the switches associated must be present in the fabric or the command fails.
Page 588 To create a new front panel policy that only enables domains 3 and 4 to use the front panel: switch:admin> secpolicycreate "FRONTPANEL_POLICY", "3; 4" FRONTPANEL_POLICY has been created. To create a device policy to allow two devices to attach to domain 3 ports 1 and 3 (the WWN of first device is 11:22:33:44:55:66:77:aa and the WWN of second device is 11:22:33:44:55:66:77:bb): switch:admin>...
Page 589: Secpolicydelete
secPolicyDelete Deletes an existing security policy. Synopsis secpolicydelete “name“ Availability admin Description Use this command to delete an existing defined policy. The FCS_POLICY cannot be deleted through this command, since this policy must exist to maintain security mode. Each policy corresponds to a management method. The list of members of a policy acts as an access control list for that management method.
Page 590 Operands This command has the following operand: Specify the name of a security policy to delete. The policy name must be enclosed in name quotation marks. Valid security policy names are: DCC_POLICY_nnn TELNET_POLICY HTTP_POLICY API_POLICY RSNMP_POLICY WSNMP_POLICY SES_POLICY (HP does not support SES_POLICY) MS_POLICY SERIAL_POLICY FRONTPANEL_POLICY...
Page 591 secPolicyRemove secPolicySave secStatsShow Fabric OS 5.x command reference guide 591...
Page 592: Secpolicydump
secPolicyDump Displays all members of existing security policies. Synopsis secpolicydump [“listtype”[, “name”]] Availability all users Description Use this command to display, without page breaks, the members of an existing policy in the active and defined (saved) databases. NOTE: This command can be issued only in secure mode but from any primary FCS switch. Operands This command has the following operands: Specify which database to display.
Page 593 Examples To display all security policy information from all databases (active, updating, and defined), without page breaks: primaryfcs:admin> secpolicydump ____________________________________________________ DEFINED POLICY SET FCS_POLICY Primary WWN DId swName __________________________________________________ 10:00:00:60:69:30:15:5c 1 primaryfcs HTTP_POLICY IpAddr __________________________________________________ 192.155.52.0 ____________________________________________________ ____________________________________________________ ACTIVE POLICY SET FCS_POLICY Primary WWN DId swName...
Page 594 See also secPolicyAbort secPolicyActivate secPolicyAdd secPolicyCreate secPolicyDelete secPolicyRemove secPolicySave secStatsShow 594 Fabric OS commands...
Page 595: Secpolicyfcsmove
secPolicyFCSMove Moves a member in the FCS policy. Synopsis secpolicyfcsmove [from, to] Availability admin Description Use this command to move an FCS member from one position to another in the FCS list. Only one FCS can be moved at a time. The first FCS switch in the list that is also present in the fabric is the primary FCS. If no parameters are specified, the command becomes interactive, prompting you to supply valid values for the operands.
Page 596 Examples To move the backup FCS switch at position 2 to position 3 in the FCS list: switch:admin> secpolicyfcsmove Primary WWN DId swName. ================================================= 10:00:00:60:69:10:02:18 1 switch5. 10:00:00:60:69:00:00:5a 2 switch60. 10:00:00:60:69:00:00:13 3 switch73. Please enter position you'd like to move from : (1..3) [1] 2 Please enter position you'd like to move to : (1..3) [1] 3...
Page 597: Secpolicyremove
secPolicyRemove Removes members from an existing policy. Synopsis secpolicyremove “name” [, “member [;member]“] Availability admin Description Use this command to remove members from an existing security policy. If a policy is empty after removing all members, all accesses to the policy are disallowed (the DCC_POLICY and OPTIONS_POLICY are exceptions).
Page 598 member Specify a member or list of members to delete from the policy. The members must be enclosed in quotation marks and separated by semicolons. This operand is required. Depending on the policy type, members can be specified using IP address, WWN, domain, or switch name.
Page 599 OPTIONS_POLICY members NoNodeWWNZoning is the only option. Examples To remove a member that has a WWN of 12:24:45:10:0a:67:00:40 from MS policy: switch:admin> secpolicyremove "MS_POLICY", "12:24:45:10:0a:67:00:40" Member(s) have been removed from MS_POLICY. See also secPolicyAbort secPolicyActivate secPolicyAdd secPolicyCreate secPolicyDelete secPolicyDump secPolicySave secStatsShow Fabric OS 5.x command reference guide 599...
Page 600: Secpolicysave
secPolicySave Saves a defined security policy to flash memory on all switches in the fabric. Synopsis secpolicysave Availability admin Description Use this command to save a defined security policy to flash memory of all switches in the fabric. NOTE: This command can be issued only from secure mode and only from the primary FCS switch. Operands none Examples...
Page 601: Secpolicyshow
secPolicyShow Displays an existing security policy. Synopsis secpolicyshow ["listtype"[, "name"]] Availability all users Description Use this command to display the members of an existing policy in the active or defined security policy database. You can specify which database to display. If a database is not specified, all databases are displayed.
Page 602 The specified policy name must be capitalized. DCC_POLICY_nnn name has the common prefix DCC_POLICY_ followed by a string of user defined characters. These characters do not have to be capitalized like regular policy names, but is case sensitive. This operand is optional.
Page 603: Secstatsreset
secStatsReset Resets one or all security statistics to 0. Synopsis secstatsreset [“name”][,”list”] Availability admin Description Use this command to reset one or all security statistics to 0. This command can be issued to any switch. If issued on the primary FCS switch, this command can reset security statistics for any or all switches in the fabric.
Page 604 Operands This command has the following operands: Specify the name of a security statistic you would like to reset. If executed name on the primary FCS, specify an asterisk (*) to represent all security policies. Valid values for this operand are: •...
Page 605 Examples To reset all statistics on the local switch: switch:admin> secstatsreset About to reset all security counters. Are you sure (yes, y, no, n):[no] y Security statistics reset to zero. To reset DCC_POLICY statistics on domains 1 and 69: switch:admin> secstatsreset "DCC_POLICY", "1;69" Reset DCC_POLICY statistic.
Page 606: Secstatsshow
secStatsShow Displays one or all security statistics. Synopsis secstatsshow [“name”][, “list”] Availability all users Description Use this command to display one or all security statistics. This command can be issued to any switch. If issued on the primary FCS switch, this command can retrieve and display the security statistics for any or all switches in the fabric.
Page 607 Operands This command has the following operands: Specify the name of a security statistic you would like to view. If executed on the name primary FCS, specify an asterisk (*) to represent all security policies. Valid values for this operand are: •...
Page 608 Examples To display the MS_POLICY statistics on the local switch: switch:admin> secstatsshow "MS_POLICY" Name Value ==================== To display statistic information for TELNET_POLICY for all switches in the fabric (example from a nonsecure switch): switch:admin> secstatsshow "TELNET_POLICY", "*" Fabric Statistics: Domain 1: Name Value =========================================...
Page 609: Sectemppasswdreset
secTempPasswdReset Resets a temporary password on a remote switch. Synopsis sectemppasswdreset [domain[, “login_name”]] Availability admin Description Use this command to remove temporary passwords that were set up using secTempPasswdSet command. If a login name is not supplied, all passwords on the switch identified by the specified domain are refreshed.
Page 610 Examples To remove temporary passwords: switch:admin> sectemppasswdreset 2, "root" Account root has been successfully disabled on domain 2 switch:admin> sectemppasswdreset 2 Restoring password of every account on domain 2 Temporary password of each account on domain 2 has been successfully reset (if switch is non fcs switch it will further display).
Page 611: Sectemppasswdset
secTempPasswdSet Sets a temporary password on a remote switch. Synopsis sectemppasswdset domain, “login_name” Availability admin Description Use this command to set a unique temporary password for a given account on a specific switch in the fabric. Use the command to remove the temporary password or reboot the secTempPasswdReset switch.
Page 612 See also passwd secModeDisable secModeShow secNonFcsPasswd secTempPasswdReset 612 Fabric OS commands...
Page 613: Sectransabort
secTransAbort Aborts current security transaction. Synopsis sectransabort Availability admin Description Use this command to abort the current transaction. This command is used to recover from management application problems. This command aborts all current changes that have not been committed or activated.
Page 614: Secversionreset
secVersionReset Resets the security version stamp to 0. Synopsis secversionreset Availability admin Description Use this command to reset the security version stamp of all switches in a fabric to 0, so that it can be joined to another secure fabric. When merging two or more secure fabrics: Determine which secure fabric will become the FCS_POLICY controller fabric: the dominant fabric to which all other secure fabrics will be merged.
Page 615: Sensorshow
sensorShow Displays sensor readings. Synopsis 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. Operands none Examples...
Page 616: Setdbg
setDbg Sets debug level of the specified module. Synopsis setdbg [module_name] [level] Availability admin Description Use this command to set the debug level of a specified module. NOTE: High debug level values can generate a large volume of messages, degrading the system response time.
Page 617: Setesdmode
setEsdMode Enables or disables ESD mode. Synopsis setesdmode [mode | -show] Availability admin Description Use this command to enable or disable ESD mode. The mode is saved in flash memory and stays in that mode until the next execution of setEsdMode. The mode becomes active as soon as this command is executed.
Page 618: Setgbicmode
setGbicMode Enables or disables media mode. Synopsis setmediamode [mode | -show] setgbicmode [mode | -show] setsfpmode [mode | -show] Availability admin Description Use these commands to enable media mode (GBIC or SFP) if the mode value is nonzero and disable the media mode if the mode value is 0.
Page 619: Setmediamode
setMediaMode Enables or disables media mode. Synopsis setmediamode [mode | -show] setgbicmode [mode | -show] setsfpmode [mode | -show] Availability admin Description Use these commands to enable media mode (GBIC or SFP) if the mode value is nonzero and disable the media mode if the mode value is 0.
Page 620: Setmodem
setModem Enables or disables modem dial-in to a control processor (CP). Synopsis setmodem [-e] | [-d] Availability admin Description Use this command to enable or disable modem dial-in to a CP on those systems that support modem dial-in. When modem dial-in is enabled, you can log in to a CP through a modem, and a modem attached to the CP accepts the call.
Page 621: Two Modems Attached For High Availability
See the hardware reference manual for your platform for complete modem installation instructions. RJ-11 "Y" Adapter Optional Handset co Line Note: Modem power connections not shown DB-25M to DB-9F Modem Cable (one per CP Card) POWER SUPPLY 4 Modem Port on CP Card (one per CP Card;...
Page 622: Setsfpmode
setSfpMode Enables or disables media mode. Synopsis setmediamode [mode | -show] setgbicmode [mode | -show] setsfpmode [mode | -show] Availability admin Description Use these commands to enable media mode (GBIC or SFP) if the mode value is nonzero and disable the media mode if the mode value is 0.
Page 623: Setsplbmode
setSplbMode Sets or displays single port loopback (SPLB) mode. Synopsis setsplbmode [mode | -show] Availability admin Description Use this command to enable MFG mode if mode is a nonzero, and disable SPLB mode if mode is 0. 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.
Page 624: Setverbose
setVerbose Specifies module verbose level. Synopsis setverbose [module_name] [level] Availability admin Description Use this command to set the verbose level of the specified module. These levels filter the display of the debug messages to the serial console. By default, no debug messages are displayed. Operands This command has the following operands: Specify the name of the module for which verbose level is to be...
Page 625: Sfpshow
sfpShow Displays serial ID SFP information. Synopsis sfpshow [slotnumber/][portnumber] | [-all] 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.
Page 626 Examples To display SFP summary information: switch:user> sfpshow Area 0: id (id) Vendor: Serial No: Area 1: id (sw) Vendor: FINISAR CORP. Serial No: H1149T2 Area 2: id (sw) Vendor: FINISAR CORP. Serial No: H112TUD Area 3: id (sw) Vendor: FINISAR CORP. Serial No: H11QET9 Area 4: id (sw) Vendor: IBM...
Page 627 To display detailed SFP information for a Finisar smart SFP: switch:user> sfpshow 1/3 Identifier: Connector: Transceiver: 050c402000000000 100,200_MB/s M5,M6 sw Inter_dist Encoding: 8B10B Baud Rate: (units 100 megabaud) Length 9u: (units 100 meters) Length 50u: (units 10 meters) Length 62.5u: 15 (units 10 meters) Length Cu: (units 1 meter)
Page 628 To display all SPF information: switch:user> sfpshow -all ============= Port ============= Identifier: Connector: Transceiver: 050c402000000000 100,200_MB/s M5,M6 sw Inter_dist Encoding: 8B10B Baud Rate: (units 100 megabaud) Length 9u: (units km) Length 9u: (units 100 meters) Length 50u: (units 10 meters) Length 62.5u:15 (units 10 meters) Length Cu:...
Page 629: Shellflowcontroldisable
shellFlowControlDisable Disables XON/XOFF flow control on the console serial ports. Synopsis shellflowcontroldisable Availability admin Description Use this command to disable XON/XOFF flow control on the console serial ports. Flow control is disabled by default. Because this command changes the flow control on the console serial port, it must be executed from a session that is logged in from the console serial port.
Page 630: Shellflowcontrolenable
shellFlowControlEnable Enables XON/XOFF flow control to the shell task. Synopsis shellflowcontrolenable Availability admin Description Use this command to enable XON/XOFF flow control to the shell task. Flow control is disabled by default. Because this command changes the flow control on the console serial port, it must be executed from a session that is logged in from the console serial port.
Page 631: Slotoff
slotOff Disables a blade slot. Synopsis slotoff slotnumber Availability admin Description Use this command to disable a nonfaulty blade unit while leaving the blade unit powered on. This command disables both the external and internal ports on the blade, in contrast to the command, which only disables external ports.
Page 632: Sloton
slotOn Enables a blade slot. Synopsis sloton slotnumber Availability admin Description Use this command to reenable a blade unit that was previously disabled. Operands This command has the following operand: Specify the slot number of the blade to enable. This operand is required. slotnumber Examples To power on blade unit 3:...
Page 633: Slotpoweroff
slotPowerOff Removes power from a slot. Synopsis slotpoweroff slotnumber 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. Operands This command has the following operand: Specify the slot number of the blade to disable.
Page 634: Slotpoweron
slotPowerOn Restores power to a slot. Synopsis slotpoweron slotnumber 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. The command reports such slots as being in the slotShow state of INSERTED, NOT POWERED ON.
Page 635: Slotshow
slotShow Displays the status of all slots in the system. Synopsis slotshow Availability all users Description Use this command to inventory and display the current status of each slot in the system. The fields and their possible values are as follows: Slot Displays the physical slot number.
Page 636 Examples To display a blade inventory and status: switch:admin> slotshow Slot Blade Type Status --------------------------------- SW BLADE FAULTY SW BLADE DISABLED SW BLADE ENABLED SW BLADE DIAG RUNNING POST2 CP BLADE ENABLED (User Ports Disabled) CP BLADE ENABLED UNKNOWN VACANT SW BLADE DIAG RUNNING POST1 SW BLADE...
Page 637: Sltest
slTest Tests the serial link of port N->N path. Synopsis sltest [ -ports itemlist ][ -lb_mode mode ][ -speed mode ] [ -passcnt count ][ -duration count ] Availability admin Description Use this command to verify the intended functional operation of the switch by sending SERDES BIST patterns from port N's transmitter, and looping the patterns back into the same port N's receiver.
Page 638 -duration count Specifies the duration, in milliseconds, to perform this test on the primitive. The default value is 100. Specifies a list of blade ports to test. By default all the blade ports in the --ports itemlist specified slot (--slot) is used. See for further details.
Page 639: Snmpconfig
snmpConfig Manages the SNMP agent configuration. Synopsis snmpConfig --show | --set | --default [snmpv1 | snmpv3 | accessControl | mibCapability | systemGroup] Availability admin (set, default) all users (display) Description Use this command to manage the configuration of the SNMP agent in the switch. The configuration includes SNMPv1 and SNMPv3 configuration, access control list (ACL) configuration, MIB capability configuration, and system group configuration.
Page 640 connUnitEventTrap, and swFabricWatchTrap), are sent to configured trap recipients. By default, this value is set at 0, implying that no Event Trap is sent. Possible values are: None Critical Error Warning Informational Debug SNMPv3 configuration parameters Two user roles, snmpadmin and snmpuser, are supported. snmpadmin provides read-write access and snmpuser provides read-only access.
Page 641 six users of SNMPv3 and trap severity level. Note that the factory default value for the SNMPv3 trap recipient of each user is 0.0.0.0. accessControl configuration parameters The ACL check is as follows: there are six ACLs to restrict SNMP get/set/trap operations to hosts under a host-subnet-area.
Page 642 systemGroup configuration parameters System description. The default value is Fibre Channel Switch. sysDescr Location of the system (switch). The default value is End User Premise. sysLocation Contact information for this system (switch). The default value is set as Field sysContact Support.
Page 643 Examples To change the SNMPv1 configuration: switch:admin> snmpconfig --set snmpv1 SNMP community and trap recipient configuration: Community (rw): [Secret C0de] admin Trap Recipient's IP address in dot notation: [0.0.0.0] 10.32.225.1 Trap recipient Severity level : (0..5) [0] 1 Community (rw): [OrigEquipMfr] Trap Recipient's IP address in dot notation: [10.32.225.2] Trap recipient Severity level : (0..5) [1] Community (rw): [private]...
Page 644 To change the SNMPv3 configuration: switch:admin> snmpconfig --set snmpv3 SNMPv3 user configuration: User (rw): [snmpadmin1] adminuser Auth Protocol [MD5(1)/SHA(2)/noAuth(3)]: (1..3) [3] 1 New Auth Passwd: Verify Auth Passwd: Priv Protocol [DES(1)/noPriv[2]): (1..2) [2] 1 New Priv Passwd: Verify Priv Passwd: User (rw): [snmpadmin2] shauser Auth Protocol [MD5(1)/SHA(2)/noAuth(3)]: (1..3) [3] 2 New Auth Passwd:...
Page 645 To change the accessControl configuration: switch:admin> snmpconfig --set accessControl SNMP access list configuration: Access host subnet area in dot notation: [0.0.0.0] 192.168.0.0 Read/Write? (true, t, false, f): [true] Access host subnet area in dot notation: [0.0.0.0] 10.32.148.0 Read/Write? (true, t, false, f): [true] f Access host subnet area in dot notation: [0.0.0.0] Read/Write? (true, t, false, f): [true] Access host subnet area in dot notation: [0.0.0.0] 10.33.0.0...
Page 646 To change the systemGroup configuration to the default: switch:admin> snmpconfig --default systemGroup ***** This command will reset the agent's system group configuration back to factory default ***** sysDescr = Fibre Channel Switch sysLocation = End User Premise sysContact = Field Support authTraps = 0 (OFF) ***** Are you sure? (yes, y, no, n): [no] y...
Page 647: Snmpmibcapset
snmpMibCapSet Modifies options for configuring SNMP MIB trap capability. Synopsis snmpmibcapset Availability admin Description This command enables a user 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 648 Example To view or modify the options for configuring SNMP MIB traps: switch:admin> snmpmibcapset The SNMP Mib/Trap Capability has been set to support FE-MIB SW-MIB FA-MIB FICON-MIB HA-MIB SW-TRAP swFCPortScn swFabricWatchTrap FA-TRAP connUnitStatusChange connUnitSensorStatusChange HA-TRAP fruStatusChanged cpStatusChanged FA-MIB (yes, y, no, n): [yes] FICON-MIB (yes, y, no, n): [yes] n HA-MIB (yes, y, no, n): [yes] SW-TRAP (yes, y, no, n): [yes]...
Page 649: Snmpmibcapshow
snmpMibCapShow Displays options for configuring SNMP MIB trap capability. Synopsis snmpMibCapShow Availability all users Description Use this command to display the SNMP MIBs and traps capability of the SNMP agent in the switch. Specifying yes means the user can access FA-MIB variables with an SNMP FA-MIB manager.
Page 650 Examples To display the options for configuring SNMP MIB trap capability: switch:admin> snmpmibcapshow FE-MIB: YES SW-MIB: YES FA-MIB: YES FICON-MIB: NO HA-MIB: YES SW-TRAP: YES swFCPortScn: YES swEventTrap: NO swFabricWatchTrap: YES swTrackChangesTrap: YES FA-TRAP: NO SW-EXTTRAP: NO HA-TRAP: YES fruStatusChanged: YES cpStatusChanged: YES fruHistoryTrap: NO See also...
Page 651: Spinfab
spinFab Runs functional test of switch-to-switch ISL cabling and trunk group operation. Synopsis spinfab [-nmegs count][-ports itemlist][-setfail mode][-domain value] Availability admin Description Use this command to verify the intended functional operation of the ISL links between switches. At the maximum speed of 4 Gb/s, it sets the routing hardware such that test frames received by each E_Port are retransmitted on the same E_Port.
Page 652 Operands This command has the following operands: Specify in millions the number of frames to send. The test will progress -nmegs count until the specified number of frames has been transmitted on each port. The default value is 10 million frames. This command only approximately counts the frames and the actual number of frames sent will be slightly larger, particularly at 2 Gb/s link speeds.
Page 653 ERR_STAT_2LONG ERR_STAT_BADEOF ERR_STAT_BADOS ERR_STAT_C3DISC ERR_STAT_CRC ERR_STAT_ENCIN ERR_STAT_ENCOUT ERR_STAT_TRUNC FINISH_MSG_ERR INIT MBUF_STATE_ERR NO_SEGMENT PORT_ABSENT PORT_DIED PORT_ENABLE PORT_M2M PORT_STOPPED PORT_WRONG RXQ_RAM_PERR STATS STATS_C3FRX STATS_FRX STATS_FTX TIMEOUT XMIT See the HP StorageWorks Fabric OS 5.x diagnostics and system error messages reference guide for more information.
Page 654: Spinjitter
spinJitter Measures line-speed jitter. Synopsis spinjitter [--slot number] [-nmegs count] [-lb_mode mode] [-spd_mode mode] [-ports itemlist] Availability admin Description This test uses the same procedures as but with a special pattern for line-speed jitter spinSilk measurement. The test uses the following pattern: jCRPAT be d7 23 47 6b 8f b3 14 5e fb 35 59 be d7 23 47 For details about the procedures used in this test, see spinSilk.
Page 655 For -lb_mode set to 0,1, the following speed modes are available to test the speed negotiation. Set all even ports' speed for autonegotiate. Set all odd ports' speed for 1 Gb/s. Set all even ports' speed for autonegotiate. Set all odd ports' speed for 2Gb/s.
Page 656 Diagnostics When it detects failures, the test might report one or more of the following error messages: DATA EPI1_STATUS_ERR ERR_STAT ERR_STATS ERR_STATS_2LONG ERR_STATS_BADEOF ERR_STATS_BADOS ERR_STATS_C3DISC ERR_STATS_CRC ERR_STATS_ENCIN ERR_STATS_ENCOUT ERR_STATS_TRUNC ERR_STAT_2LONG ERR_STAT_BADEOF ERR_STAT_BADOS ERR_STAT_C3DISC ERR_STAT_CRC ERR_STAT_ENCIN ERR_STAT_ENCOUT ERR_STAT_TRUNC FDET_PERR FINISH_MSG_ERR FTPRT_STATUS_ERR INIT LESSN_STATUS_ERR MBUF_STATE_ERR...
Page 657 See also backport camTest centralMemoryTest cmemRetentionTest cmiTest crossPortTest itemList portLoopbackTest portRegTest spinSilk sramRetentionTest Fabric OS 5.x command reference guide 657...
Page 658: Spinsilk
spinSilk Performs a functional test of internal and external transmit and receive paths. Synopsis spinsilk [-nmegs count][-lb_mode mode][-spd_mode mode][-verbose mode][-ports itemlist] Availability admin Description Use this command to verify the intended functional operation of the switch, at the selected speed, by configuring the routing hardware so that frames received by port M are retransmitted by way of port N.
Page 659 • 128 bytes of RANDOM • 512 bytes of RDRAM_PAT The partner port N eventually sends four similar frames, as follows: • 2112 bytes of BYTE_LFSR • 928 bytes of CSPAT • 200 bytes of RANDOM • 480 bytes of RDRAM_PAT Periodically check the following: a.
Page 660 Specify the speed mode for the test. This parameter is used only for Bloom and -spd_mode mode Condor ASIC-based 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 5 through 8 depends upon the loopback mode selected.
Page 661 Examples To perform a functional test on selected ports: switch:admin> spinsilk -ports 1/0 - 1/2 Running Spin Silk ..... One moment please ...Ports Segmented (0) switchName: switch switchType: 10.1 switchState: Offline switchRole: Disabled switchDomain: 1 (unconfirmed) switchId: fffc01 switchWwn: 10:00:00:60:69:80:03:0c switchBeacon: blade1: Beacon: OFF blade2: Beacon: OFF...
Page 662 ERR_STAT_TRUNC FDET_PERR FINISH_MSG_ERR FTPRT_STATUS_ERR INIT LESSN_STATUS_ERR MBUF_STATE_ERR MBUF_STATUS_ERRBAR> NO_SEGMENT PORT_ABSENT PORT_DIED PORT_ENABLE PORT_M2M PORT_STOPPED PORT_WRONG RXQ_FRAME_ERR RXQ_RAM_PERR STATS STATS_C3FRX STATS_FRX STATS_FTX TIMEOUT XMIT See the HP StorageWorks Fabric OS 5.x diagnostics and system error messages reference guide for more information. See also backport camTest...
Page 663: Sramretentiontest
sramRetentionTest Performs a data retention test of the miscellaneous SRAMs in ASIC. Synopsis sramretentiontest [--slot slotnumber][-passcnt count][-ports itemlist][-skip bitmask][-delay value] 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.
Page 664 Diagnostics Following are the possible error messages if failures are detected: BUS_TIMEOUT REGERR REGERR_UNRST See the HP StorageWorks Fabric OS 5.x diagnostics and system error messages reference guide for more information. See also camTest centralMemoryTest cmiTest crossPortTest dataTypeShow itemList portLoopbackTest spinSilk 664 Fabric OS commands...
Page 665: Statsclear
statsClear Clears port and diagnostic statistics. Synopsis statsclear [--slot slotnumber][-uports itemlist][-bports itemlist] [-use_bports value] Availability admin Description Use this command to clear the port and diagnostics statistics for the specified list of blade or user ports. Options The following are optional: Specifies the slot on which to operate.
Page 666: Statstest
statsTest Runs a statistics counter diagnostic test. Synopsis statstest [-passcnt count][-ports itemlist] Availability admin Description Use this command to verify the ASIC statistics counter logic. It can run on every base port of the quadrant, and send the frame through internal loopback with no CRC data to induce the CRC error. This command is also run from camTest.
Page 667 Diagnostics When it detects failures, the subtest reports one or more of the following error messages: DIAG-STSINIT DIAG-STSNULL DIAG-STSSID DIAG-STSXMIT DIAG-STSRCV DIAG-STSFRMCNT DIAG-STSWRDCNT DIAG-STSALPACNT See the HP StorageWorks Fabric OS 5.x diagnostics and system error messages reference guide for more information. See also camTest itemList...
Page 668: Stopporttest
stopPortTest Terminates the running portTest. Synopsis stopporttest [-ports itemlist] Availability admin Description Use this command to stop the currently running portTest. See the command for more portTest information. is running in nonsingle mode, use stopporttest to stop the test. portTest Operands The command has the following operands: Specify a list of user ports to test.
Page 669: Supportftp
supportFtp Sets, clears, or displays support FTP parameters, or a time interval to check the FTP server. Synopsis supportftp [-S] supportftp -s [-h hostip] [-u username] [-p password] [-d remotedirectory] supportftp -t hours supportftp -R Availability admin Description Use this command to set, clear, or display support FTP parameters or a time interval to check the FTP server.
Page 670 Examples To set the FTP parameters: switch:admin> supportftp -s -h 192.168.67.126 -u anonymous -d tracedump supportftp: ftp parameters changed. To display a time interval at which to check the FTP server: switch:admin> supportftp -t 24 supportftp: ftp check period changed. See also supportSave supportShow...
Page 671: Supportsave
supportSave Saves support information for RASLOG, TRACE, and supportShow. Synopsis supportsave [-n] [-c] [-u user_name -p password] -h host_ip -d remote_dir Availability admin Description Use this command to save RASLOG, TRACE, and information and other support supportShow information to a remote FTP location. On a dual-CP system, only the local CP information is saved and information is not available on the active CP.
Page 672 Examples To save RASLOG, TRACE, and information to an FTP server in non-interactive mode: supportShow switch:admin> supportsave -n -u admin -p pass -h 192.168.1.1 -d tmp Saving support information for module RASLOG..ortSave_files/switch-S5-200405200010-errDumpAll.ss: 1.66 kB 566.47 B/s Saving support information for module TRACE..ortSave_files/switch-S5-200405200010-tracedump.dmp: 10.00 MB 848.00 kB/s...
Page 673 supportShow traceDump traceFtp traceTrig Fabric OS 5.x command reference guide 673...
Page 674: Supportshow
supportShow Prints switch information for debugging purposes. Synopsis supportshow [[slotnumber/]portnumber1-portnumber2] [lines] Availability all users Description Use this command to display support information from groups of preselected Fabric OS and Linux commands. You can specify the range of ports for which this information displays. These commands are organized by groups, but note that the order of the groups listed next is not the same as executed by the command.
Page 675 • fabPortShow • fspfShow • fcpLogShow • zone stateshow • portZoneShow • portCamShow • cfgShow • cfgSize • rcssmshow • rcsregistryshow • zone mergeshow • services (ENABLED by default) • fdmiCacheShow • fdmiShow • nsShow • nsAllShow • nscamShow • security (ENABLED by default) •...
Page 676 • portErrShow • fwSamShow • agtCfgShow • (product-dependent) slotShow • emtraceshow • emtraceshow2 • emhsmtraceshow • systraceshow -d • fwAlarmsFilterShow • chassisShow • timeout • historyShow • portSwapShow • configShow • extend (DISABLED by default) • buffers (per-port) • credits (per-port) •...
Page 677 Specifies the number of lines of output to lines portLogDump display. If this parameter used, the slotnumber/portnumber parameter is required. Example To display switch information for debugging: switch:admin> supportshow 1/1-3 supportshow groups enabled: system version: Kernel: 2.4.19 Fabric OS: v4.1.0 Made on: Fri Jan 10 01:06:10 2003 Flash:...
Page 678 See also supportFtp supportSave supportShowCfgDisable supportShowCfgEnable supportShowCfgShow traceDump traceFtp traceTrig 678 Fabric OS commands...
Page 679: Supportshowcfgdisable
supportShowCfgDisable Disables a group of commands under the command. supportShow Synopsis supportshowcfgdisable [os | exception | port | fabric | services | security | network | portlog | system | extend | filter | perfmon | ficon] Availability admin Description Use this command to disable a group of commands under the command.
Page 680: Supportshowcfgenable
supportShowCfgEnable Enables a group of commands under the command. supportShow Synopsis supportshowcfgenable [os | exception | port | fabric | services | security | network | portlog | system | extend | filter | perfmon | ficon] Availability admin Description Use this command to enable a group of commands under the command.
Page 681: Supportshowcfgshow
supportShowCfgShow Displays the groups of commands enabled for display by the command. supportShow Synopsis supportshowcfgshow Availability all users Description Use this command to display the groups of commands enabled for display by the supportShow command. Use the and the commands to supportShowCfgEnable supportShowCfgDisable modify which groups are displayed.
Page 682: Switchbeacon
switchBeacon Sets switch beaconing mode on or off. Synopsis switchbeacon [mode] Availability admin Description Use this command to enable or disable switch beaconing mode. When beaconing mode is turned on, the port LEDs flash amber, left to right and right to left, which continues until turned off by the user.
Page 683: Switchcfgpersistentdisable
switchCfgPersistentDisable Disables a switch persistently. Synopsis switchcfgpersistentdisable Availability admin Description Use this command to persistently disable the switch. All Fibre Channel ports are taken offline. If the switch was part of a fabric, the remaining switches reconfigure. The switch remains disabled even after a reboot.
Page 684: Switchcfgpersistentenable
switchCfgPersistentEnable Enables a switch persistently. Synopsis switchcfgpersistentenable Availability admin Description Use this command to persistently enable the switch. All Fibre Channel ports which did not fail power-on self-test (POST) are enabled, and can come online if connected to a device, or remain offline if disconnected.
Page 685: Switchcfgspeed
switchCfgSpeed Configures all ports of a switch to a particular speed. Synopsis 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 flash memory and persists across switch reboots or power cycles. If any port on the switch is not capable of the specified speed setting, an error message appears for that port.
Page 686: Switchcfgtrunk
switchCfgTrunk Enables or disables trunking on all the ports of a switch. Synopsis switchcfgtrunk mode Availability admin NOTE: This command requires an HP ISL Trunking license. Description Use this command to enable or disable trunking on all the ports of a switch. NOTE: You can disable or enable trunking using the portCfgTrunkPort...
Page 687: Switchdisable
switchDisable Disables the switch. Synopsis switchdisable Availability admin Description Use this command to disable the switch. All Fibre Channel ports are taken offline; if the switch was part of a fabric, the remaining switches reconfigure. The switch must be disabled before making configuration changes (using configure configDefault) or before running many of the diagnostic tests.
Page 688: Switchenable
switchEnable Enables the switch. Synopsis switchenable Availability admin Description Use this command to enable the switch. All Fibre Channel ports that passed POST are enabled. They can come online if connected to a device, or will remain offline if disconnected. Use if you switchEnable disable the switch to make configuration changes or to run diagnostics.
Page 689: Switchname
switchName Displays or sets the switch name. Synopsis switchname [name] Availability all users (display) admin (set) Description Use this command to display or set the switch name. All switches have a symbolic name that is primarily used for switch management. This name is also shown in the Fabric OS CLI prompt, under each switch icon on the Fabric Web page, and in the output of various Fabric OS commands, such as fabricShow.
Page 690: Switchreboot
switchReboot Halts and reboots the operational switch. Synopsis switchreboot Availability admin Description This command reboots the operational switch without disrupting the other switch in a dual-switch chassis. This command is equal to running and switchStart. switchShutdown NOTE: This command is not supported on single-domain systems. Operands none Examples...
Page 691: Switchshow
switchShow Displays switch and port status. Synopsis switchshow [-portcount] Availability all users Description Use this command to display switch and port status information. Information might vary by switch model. Switch summary information; it is followed by a section covering summary information by port: Displays the switch symbolic name.
Page 692 Port State Port state information No_Card No interface card present. No_Module No module (SFP or other) present. Mod_Val Module validation in process.Mod_Inv – nvalid module. No_Light Module not receiving light. No_Sync Module receiving light but out of sync. In_Sync Module receiving light and in sync. Laser_Flt Module signaling a laser fault.
Page 693 Operand The operand is as follows: Displays the number of ports on the switch. -portcount Example To display the port count: switch:admin> switchShow -portcount ports= 64 To display the port status for an E_Port: switch:user> switchshow switchName: san116 switchType: 10.1 switchState: Online switchMode:...
Page 694: Switchshutdown
switchShutdown Halts the operational switch. Synopsis switchshutdown Availability admin Description Use this command to halt switch operation on one switch without disrupting the other. This command disables a logical switch in a dual-switch chassis. This command has to be used in combination with switchStart. This command halts 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 695: Switchstart
switchStart Initializes a previously shut down switch. Synopsis switchstart Availability admin Description Use this command to initialize one switch without disrupting the other switch in the dual-switch chassis. This command has to 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 and blades associated with the switch.
Page 696: Default Contributor, Values, And Status
switchStatusPolicySet Sets the policy parameters that determine overall switch status. Synopsis switchstatuspolicyset Availability admin Description Use this command to set 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 697 Examples To change the switch policies: switch:admin> switchstatuspolicyset To change the overall switch status policy parameters The current overall switch status policy parameters: Down Marginal ---------------------------------- PowerSupplies Temperatures Fans Blade Flash MarginalPorts FaultyPorts MissingSFPs Note that the value, 0, for a parameter, means that it is NOT used in the calculation.
Page 698: Default Contributor, Values, And Status
switchStatusPolicyShow Displays the policy parameters that determine overall switch status. Synopsis 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.
Page 699 Examples To display the switch policies: switch:admin> switchstatuspolicyshow The current overall switch status policy parameters: Down Marginal ---------------------------------- PowerSupplies Temperatures Fans Blade Flash MarginalPorts FaultyPorts MissingSFPs See also switchStatusPolicySet switchStatusShow Fabric OS 5.x command reference guide 699...
Page 700: Switchstatusshow
switchStatusShow Displays overall switch status. Synopsis switchstatusshow Availability all users Description Use this command to display the overall status of the switch. In addition, users with a Fabric Watch license are able to view the list of unhealthy ports. This command displays the overall switch status, along with the status of each of the following contributors: •...
Page 701 Examples To display a switch health report: switch:user> switchstatusshow Switch Health Report Report time: 06/19/2003 10:48:31 AM Switch Name: switch IP address: 10.10.255.255 SwitchState: MARGINAL Duration: 00:06 Power supplies monitor HEALTHY Temperatures monitor HEALTHY Fans monitor MARGINAL WWN servers monitor HEALTHY Standby CP monitor HEALTHY...
Page 702: Switchuptime
switchUptime Displays the amount of time the switch has been operating. Synopsis switchuptime Availability all users Description Use this command to display the current time and the amount of time that the switch has been operational. Operands none Examples To view the uptime for the switch: switch:user>...
Page 703: Syslogdfacility
syslogdFacility Changes the syslog facility. Synopsis syslogdFacility [-l level] Availability admin Description Use this command to change the syslog facility to LOG_LOCAL0, LOG_LOCAL1, LOG_LOCAL2, LOG_LOCAL3, LOG_LOCAL4, LOG_LOCAL5, LOG_LOCAL6, or LOG_LOCAL7. The syslog daemon (syslogd) is a process available on most UNIX systems that reads and forwards system messages to the appropriate log files or users, depending on the system configuration.
Page 704: Syslogdipadd
syslogdIpAdd Adds the IP address of a syslog daemon. Synopsis syslogdipadd ip_address Availability admin Description Use this command to add the IP address of the server that is running the syslogd process. The syslog daemon (syslogd) is a process available on most UNIX systems that reads and forwards system messages to the appropriate log files or users, depending on the system configuration.
Page 705: Syslogdipremove
syslogdIpRemove Removes the IP address of a syslog daemon. Synopsis syslogdipremove ip_address Availability admin Description Use this command to remove the IP address of the server that is running the syslogd process. Operands This command has the following operand: Specify the IP address of the server running syslogd. This operand is required. ip_address Examples To remove the address 192.168.1.60 from the list of machines to which system messages are sent:...
Page 706: Syslogdipshow
syslogdIpShow Displays all syslog daemon IP addresses. Synopsis syslogdipshow Availability all users Description Use this command to display all syslog daemon IP addresses in the configuration database. Operands none Examples To display all syslog daemon IP addresses: switch:admin> syslogdipshow syslog.IP.address.1: 192.168.1.60 syslog.IP.address.2: 192.168.1.88...
Page 707: Systemverification
systemVerification Runs a suite of diagnostic tests on all switches in a fabric. Synopsis systemverification [-parameters | -short] [[-fru type] -unit id] Availability admin Description Use this command to run a comprehensive, system-wide test of all switches in a system. The command initiates a burn-in run on all switches within the current system.
Page 708 Use to focus testing on a single FRU in the system. The id for a -unit id FRU type of BLADE correlates to the slot number of the FRU to be tested. Diagnostics Each diagnostic test in this suit might report its own set of error messages when it detects failures. See the “Diagnostics”...
Page 709 See also burninErrClear burninStatus diagSetBurnin diagSetCycle Fabric OS 5.x command reference guide 709...
Page 710: Tempshow
tempShow Displays temperature readings. Synopsis tempshow Availability all users Description Use this command to display the current temperature readings of all temperature sensors in a switch. For each sensor, this command displays the slot number (if applicable), the sensor state, and the temperature. The temperature readings are given in both Centigrade and Fahrenheit.
Page 711: Timeout
timeout Sets or displays the idle timeout value for a login session. Synopsis timeout [timeval] Availability admin (set and display) all users (display only) Description Use this command without an operand to display, in minutes, the current timeout value after which idle logins are automatically terminated.
Page 712: Topologyshow
topologyShow Displays the unicast fabric topology. Synopsis topologyshow [domain] Availability all users Description Use this command to display the fabric topology, as it appears to the local switch, including: • 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 713 Examples To display the unicast fabric topology: switch:admin> topologyshow 2 domains in the fabric; Local Domain ID: 1 Domain: Metric: Name: switch Path Count: Hops: Out Port: In Ports: None Total Bandwidth: 2 Gbps Bandwidth Demand: Flags: Hops: Out Port: In Ports: None Total Bandwidth:...
Page 714: Tracedump
traceDump Displays, initiates, or removes a trace dump. Synopsis tracedump [-S] [-s slot] tracedump -n [-s slot] tracedump -r [-s slot] Availability admin Description Use this command to initiate a background trace dump, to remove the content of a trace dump, or to display the dump status on the switch.
Page 715 traceFtp traceTrig Fabric OS 5.x command reference guide 715...
Page 716: Traceftp
traceFtp Displays, enables, or disables the trace auto-FTP, or retrieves the trace dump file. Synopsis traceftp [-S] traceftp -e traceftp -d traceftp -n [-s slot] [-h hostip] [-u username] [-p password] [-d remotedirectory] [-f remotefile] Availability admin Description Use this command to display, enable, or disable trace auto-FTP or to retrieve a trace dump file from the switch to the FTP site immediately.
Page 717 Specifies the slot number from which a trace dump is -s slot generated. If this is not supplied, the trace dump is generated from the local slot. -h hostip Specifies the FTP host IP address. It must be an IP address. hostip should be less than 48 characters.
Page 718: Tracetrig
traceTrig Sets, removes, or displays trace triggers. Synopsis tracetrig [-S] [-s slot] tracetrig -a [-s slot] msgid tracetrig -r [-s slot] msgid tracetrig -R [-s slot] Availability admin Description Use this command to set, remove, or display trace triggers for the specified slot on the switch. NOTE: If there is no parameter specified, this command defaults to tracetrig -S.
Page 719 To remove all trace triggers: switch:admin> tracetrig -R all trace triggers are removed See also supportFtp supportSave supportShow traceFtp traceFtp Fabric OS 5.x command reference guide 719...
Page 720: Trackchangeshelp
trackChangesHelp Displays information on track-changes feature commands. Synopsis trackchangeshelp Availability all users Description Use this command to display information about the track-changes commands. Examples To display information on the track-changes feature commands: switch:admin> trackchangeshelp trackChangesSet Configure alert for login/logout/config update trackChangesShow Displays status of track changes See also...
Page 721: Trackchangesset
trackChangesSet Enables or disables configuring of track-changes feature. Synopsis trackchangesset [mode][, snmptrapmode] Availability admin Description This command enables or disables the track-changes feature. An SNMP-TRAP mode can also be enabled. Trackable changes are: • Successful login Unsuccessful login • • Logout •...
Page 722 See also agtCfgSet agtCfgShow trackChangesHelp trackChangesShow 722 Fabric OS commands...
Page 723: Trackchangesshow
trackChangesShow Displays status of track-changes feature. Synopsis trackchangesshow Availability all users Description Use this command to display status of the track-changes feature. It displays if the feature is turned on or off and if SNMP traps are generated. The output from the track-changes feature is dumped to the error log for the switch. Use the errDump command or the command to view the error log.
Page 724: Trunkdebug
trunkDebug Debugs a trunk link failure. Synopsis trunkdebug port1 port2 Availability admin Description Use this command to debug a trunk link failure. This command reports one of the following messages, based on the trunking properties of the two specified ports: •...
Page 725 See also portCfgTrunkPort switchCfgTrunk trunkShow Fabric OS 5.x command reference guide 725...
Page 726: Trunkshow
trunkShow Displays trunking information. Synopsis trunkshow Availability all users Description Use this command to display trunking information. The following fields appear: Trunking Group Number Displays each trunking group on a switch. All the ports that are part of this trunking group are displayed. Port to port connections Displays the port-to-port trunking connections.
Page 727: Tsclockserver
tsClockServer Displays or sets the NTP server address. Synopsis tsclockserver [ipaddr] Availability all users (display) admin (set) Description Use this command to synchronize the local time of the principal or primary FCS switch to an external NTP server. The time server daemon synchronizes fabric time by sending updates of the principal or primary FCS local switch time periodically to every switch in the fabric.
Page 728 Examples To display the current clock server value (LOCL), set the value to an NTP server at the specified IP address and then verify that the new IP address was saved: switch:admin> tsclockserver LOCL switch:admin> tsclockserver "123.123.123.123" Updating Clock Server configuration...done. switch:admin>...
Page 729: Tstimezone
tsTimeZone Displays or sets the system time zone. Synopsis tstimezone [houroffset [, minuteoffset]] Availability all users (display) admin (set) Description Use this command to display or set the system time zone. All switches maintain the current time zone setup in flash memory. Changing the time zone on a switch updates the local time zone setup and is reflected in local time calculations.
Page 730 Example To display the current time zone setup and then change it to GMT-3:30: switch:admin> tsTimeZone Time Zone Hour Offset: 0 Time Zone Minute Offset: 0 switch:admin> tsTimeZone -3, -30 Updating Time Zone configuration...done. System Time Zone change will take effect at next reboot. switch:admin>...
Page 731: Turboramtest
turboRamTest Performs a turbo SRAM logic test for 2 Gb/s ASICs. Synopsis turboramtest [--slot slotnumber][-passcnt count][-ports itemlist] Availability admin Description This command verifies the on chip SRAM located in the 2 Gb/s ASIC using the turbo-RAM BIST circuitry. These same SRAMS are tested by using PCI operations but portRegTest sramRetentionTest...
Page 732 Diagnostics When it detects failures, the subtest might report one or more of the following error messages: DIAG-WTEST DIAG-INC_RWTEST DIAG-DEC_RWTEST DIAG-RAMINIT_TO See the HP StorageWorks Fabric OS 5.x diagnostics and system error messages reference guide for more information. See also centralMemoryTest cmemRetentionTest cmiTest...
Page 733: Txdpath
txdPath Performs a functional test of ASIC pair TXA,TXD connections. Synopsis txdpath [--slot slotnumber][-nframes count][-lb_mode mode][-spd_mode mode][-nonstop mode][-ports itemlist] Availability admin Description Use this command to verify the TXA, TXD, and CMI data paths between the chips within a mini-switch. This is done by configuring all of the ports on the mini-switch in internal loopback and sending a frame from each quadrant to each other port on the same mini-switch.
Page 734 Operands This command has the following operands:- Specifies the slot number that the diagnostic will operate on. The ports --slot specified will be relative to this slot number. The default is set to 0 and designed slotnumber to operate on fixed-port-count products. Specifies the number of frames to send in millions.
Page 735 Specify nonstop mode. If set to a nonzero value, the test does not stop on the --nonstop mode first error. The default value is 0. Specify a list of user ports to test. By default, all of the user ports in the current -ports switch are tested.
Page 736 upTime Displays length of time the system has been operational. Synopsis uptime Availability all users Description provides a one line display of the following information. The current time, how long the system upTime has been running, how many users are currently logged on, and the system load averages for the past 1, 5, and 15 minutes.
Page 737 uRouteConfig Configures a static route. Synopsis urouteconfig in_area domain out_area Availability admin Description Use this command to configure static routes. A static route is a route that is assigned to a specific path (defined by port number out_area), and does not change when a topology change occurs unless the path used by the route becomes unavailable.
Page 738 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> urouteshow 1/1 2 Local Domain ID: 1 In Port Domain Out Port Metric...
Page 739 uRouteRemove Removes a static route. Synopsis urouteremove in_area domain Availability admin Description Use this command to remove a previously configured static route. After this command is issued, the route to domain for in_area might change to use a different output port, if dynamic load sharing (DLS) is set.
Page 740 uRouteShow Displays unicast routing information. Synopsis 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 741 Specify a port number. Valid values for port number vary, portnumber depending on the switch type. Use to display a switchShow list of valid ports. This operand is optional; if omitted, the command displays routing information for all input ports in the switch.
Page 742: Userconfig
userConfig Manages user accounts. Synopsis userconfig [actions][arguments] Availability all users Description Use this command to display, add, delete, change, or recover switch accounts. You can create new login accounts to manage a switch. These accounts take on the permission or role of the default admin or user account.
Page 743 The following sections describe of each action type. --show username | [-a | -b] Displays information about the current login account, account named username or all accounts either in active or backup account database. If running from an account with user permission, the command can only display information about that account.
Page 744 --change username [-r rolename] [-d description] [-e yes | no] Change attributes for an existing account, named username, in the switch. The -r option specifies change to authorization rolename. The -d option specifies change to description. The -e option expects either yes or no to enable or disable an account. Once an account is disabled, the CLI sessions associated with the account are terminated.
Page 745: Userrename
userRename Renames the user login name. Synopsis userrename old_username new_username Availability admin NOTE: This command is not supported on all platforms. Description Use this command to change an existing account login name to a new login name. The following rules apply: •...
Page 746: Version
version Displays firmware version information. Synopsis version Availability all users Description Use this command to display firmware version information and build dates. The following information appears: Kernel Displays the version of switch kernel operating system Fabric OS Displays the version of switch Fabric OS Made on Displays the build date of firmware running in switch Flash...
Page 747: Voltshow
voltShow Displays the current level of the voltage sensors on a system. Synopsis voltshow Availability admin Description Use this command to display information about a switch's voltage levels. The format of the display varies according to the switch model, the number of voltages on the device, and the number of voltage sensors present.
Page 748 Examples To display the voltage levels on a system: switch:admin> voltshow FRU TYPE - Number 1.8/1.2V 2.5V 3.3V ---------------------------------------------------------------- SW BLADE Slot: 2 1.82 2.51 3.30 11.94 SW BLADE Slot: 3 0.00 0.00 0.09 12.31 CP BLADE Slot: 5 2.48 3.29 5.17 12.50...
Page 749: Wwn
Displays a switch world wide name (WWN). Synopsis 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 appears in the output of the command.
Page 750: Zonedelete
zoneAdd Adds a member to the zone. Synopsis zoneadd “zoneName“, “member;member“ Availability admin NOTE: This command requires HP Advanced Zoning license, which is included within the Base Configuration Services and bundled with each B-series switch. Description Use this command to add one or more members to an existing zone. This command changes the defined configuration.
Page 751 zoneCreate Creates a zone. Synopsis zonecreate “zonename“, “member;member“ Availability admin NOTE: This command requires HP Advanced Zoning license, which is included within the Base Configuration Services and bundled with each B-series switch. Description Use this command to create a new zone. A zone name is a C-style name beginning with a letter and followed by any number of letters, digits, and underscore characters.
Page 752: Zoneadd
This command changes the defined configuration. For the change to be preserved across switch reboots, it must be saved to flash memory using the command. For the change to become effective, an cfgSave appropriate zone configuration must be enabled using the command.
Page 753 zoneDelete Deletes a zone. Synopsis zonedelete “zonename“ Availability admin NOTE: This command requires HP Advanced Zoning license, which is included within the Base Configuration Services and bundled with each B-series switch. Description Use this command to delete a zone. This command changes the defined configuration. For the change to be preserved across switch reboots, it must be saved to flash memory using the command.
Page 754 zoneHelp Displays help information for zone commands. Synopsis zonehelp Availability all users Description Use this command to display help information for zone commands. Operands none Examples To display zone command help information: switch:admin> zonehelp aliAdd Add a member to a zone alias aliCreate Create a zone alias aliDelete...
Page 755 cfgDisable cfgEnable cfgSize cfgTransAbort faZoneAdd faZoneCreate faZoneDelete faZoneShow Fabric OS 5.x command reference guide 755...
Page 756 zoneObjectCopy Copies a zone object. Synopsis zoneObjectCopy “objectName“, “newName“ Availability admin NOTE: This command requires HP Advanced Zoning license, which is included within the Base Configuration Services and bundled with each B-series switch. Description Use this command to copy a zone object to a new zone object. The resulting object has the same type as the original object.
Page 757 See also cfgAdd cfgClear cfgDelete cfgDisable cfgEnable cfgRemove cfgSave cfgShow zoneObjectRename Fabric OS 5.x command reference guide 757...
Page 758 zoneObjectExpunge Expunges a zone object. Synopsis zoneObjectExpunge “objectName“ Availability admin NOTE: This command requires HP Advanced Zoning license, which is included within the Base Configuration Services and bundled with each B-series switch. Description Use this command to expunge a zone object. In addition, to performing a simple delete, this command also removes the object from the member lists of all other objects.
Page 759 Examples To create a configuration containing three zones: switch:admin> cfgShow Defined configuration: cfg: USA_cfg Red_zone; White_zone; Blue_zone zone: Blue_zone 1,1; array1; 1,2; array2 zone: Red_zone 1,0; loop1 zone: White_zone 1,3; 1,4 alias: array1 21:00:00:20:37:0c:76:8c; 21:00:00:20:37:0c:71:02 alias: array2 21:00:00:20:37:0c:76:22; 21:00:00:20:37:0c:76:28 alias: loop1 21:00:00:20:37:0c:76:85;...
Page 760 zoneObjectRename Renames a zone object. Synopsis zoneObjectRename “objectName“, “newName“ Availability admin NOTE: This command requires HP Advanced Zoning license, which is included within the Base Configuration Services and bundled with each B-series switch. Description Use this command to rename a zone object. You can use this command for all zone object types, including cfg, zone, and alias.
Page 761 See also cfgAdd cfgClear cfgDelete cfgDisable cfgEnable cfgRemove cfgSave cfgShow zoneObjectCopy Fabric OS 5.x command reference guide 761...
Page 762 zoneRemove Removes a member from a zone. Synopsis zoneremove “zonename“, “member;member“ Availability admin NOTE: This command requires HP Advanced Zoning license, which is included within the Base Configuration Services and bundled with each B-series switch. Description Use this command to remove one or more members from an existing zone. The member list is located by an exact string match;...
Page 763 Examples To remove array2 from Blue_zone: switch:admin> zoneremove "Blue_zone", "array2" switch:admin> zoneremove "Blue_zone", "2,20" See also zoneAdd zoneCreate zoneDelete zoneShow Fabric OS 5.x command reference guide 763...
Page 764 zoneShow Displays zone information. Synopsis zoneshow [“pattern“][, mode] Availability all users NOTE: This command requires HP Advanced Zoning license, which is included within the Base Configuration Services and bundled with each B-series switch. Description Use this command to display zone configuration information. If no parameters are specified, all zone configuration information (both defined and enabled) is displayed.
Page 765 See also zoneAdd zoneCreate zoneDelete zoneRemove Fabric OS 5.x command reference guide 765...
Page 766 766 Fabric OS commands...
Page 767: Licensed Product Commands
3 Licensed product commands This chapter summarizes the commands that are available only with a license key. • Advanced zoning commands, page 767 • QuickLoop Fabric Assist mode commands, page 768 • Extended Fabrics command, page 769 • Fabric Watch commands, page 769 •...
Page 768: Quickloop Fabric Assist Mode Commands
Table 20 Zoning commands (continued) Command Description Creates a zone configuration. cfgCreate Deletes a zone configuration. cfgDelete Removes a zone from a zone configuration. cfgRemove Zone Management Clears all zone configurations. cfgClear Disables a zone configuration. cfgDisable Enables a zone configuration. cfgEnable Saves zone configurations in flash memory.
Page 769: Extended Fabrics Command
Extended Fabrics command The command described in Table 22, is available with the purchase of an HP Extended Fabrics license key. Table 22 Extended fabrics commands Command Description Configure a port to support long-distance links. portCfgLongDistance Fabric Watch commands The commands listed in Table 23 are available with the purchase of an HP Fabric Watch license key.
Page 770: Advanced Performance Monitoring Commands
Advanced Performance Monitoring commands The commands listed in Table 25 are available with the purchase of an HP Advanced Performance Monitoring license key. Table 25 Performance monitoring commands Command Description Add an end-to-end monitor to a port. perfAddEEMonitor Add an IP monitor to a port. perfAddIPMonitor Add a SCSI Read monitor to a port.
Page 771: Secure Fabric Os Commands
Secure Fabric OS commands The commands listed in Table 26 are available with the purchase of an HP Security license key. For more detailed information about security, see the HP StorageWorks Secure Fabric OS user guide.) Table 26 HP secure fabric OS commands Command Description Displays security related fabric information.
Page 772 772 Licensed product commands...
Page 773: Commands Exclusive To The Primary Fcs
4 Exclusive primary FCS commands This chapter summarizes the commands that are available on the primary FCS only when the security feature is installed and enabled. Commands exclusive to the primary FCS The following commands are available on the primary FCS only when security is installed and enabled. Table 27 Commands exclusive to the primary FCS Command...
Page 774: 774 Exclusive Primary Fcs Commands
Table 27 Commands exclusive to the primary FCS (continued) Command Notes Must be run from the primary FCS switch. faZoneAdd Must be run from the primary FCS switch. faZoneCreate Must be run from the primary FCS switch. faZoneDelete Must be run from the primary FCS switch. faZoneRemove Must be run from the primary FCS switch.
Page 775 Table 27 Commands exclusive to the primary FCS (continued) Command Notes Must be run from the primary FCS switch. Can also be run on a single secVersionReset non-FCS switch which is segmented from a fabric. Can be run on all switches to view the NTP server's IP address. You can only tsClockServer modify the NTP server's IP address on the primary FCS switch.
Page 776 776 Exclusive primary FCS commands...
Page 777: Mua-Based Roles
5 MUA-based roles This chapter summarizes the commands that are applicable to the multiple user account (MUA) roles. The MUA feature distinguishes between a user account and the role assigned to the account. This chapter includes information for the switchAdmin role. switchAdmin Role Permissions The switchAdmin role offers most of the permissions of the existing admin role, except the ability to configure zones, perform security-related functions, and perform user management.
Page 778 Table 28 switchAdmin commands (continued) Command Description Displays all field replaceable units (FRUs). chassisShow Displays the port registers for a given chip number. chipRegShow Tests the data retention of the central memory SRAMs. cmemRetentionTest Verifies the control message interface (CMI) bus between ASICs. cmiTest Displays system configuration settings.
Page 779 Table 28 switchAdmin commands (continued) Command Description Sets principal switch selection mode. fabricPrincipal Displays fabric membership information. fabricShow Clears the fabric state information. fabStateClear Changes the number of state entries. fabStateResize Displays the fabric state information. fabStateShow Displays the fabric statistics. fabStatsShow Displays the fabric switch state structure information.
Page 780 Table 28 switchAdmin commands (continued) Command Description Displays the Fabric OS versions on both partitions of the local and firmwareShow remote CPs. Functional test of F->N, N->F point-to-point path. fportTest Interactive interface to replace a field replaceable unit (FRU). fruReplace Displays Fabric Shortest Path First (FSPF) protocol information.
Page 781 Table 28 switchAdmin commands (continued) Command Description Displays current license keys. licenseShow Sets or displays the fabric shortest path first (FSPF) cost of a link. linkCost Logs in as new user. login Logs out from a telnet, rlogin, or serial port session. logout Displays the Fabric Shortest Path First (FSPF) link state database.
Page 782 Table 28 switchAdmin commands (continued) Command Description Displays the information of all the online devices zoned with the given nsZoneMember device. Changes the password for a user level. passwd Display routing and statistics information along a path, covering pathInfo multiple switches. Displays data from a panic dump file.
Page 783 Table 28 switchAdmin commands (continued) Command Description Displays port error summary. portErrShow Displays the port status bitmaps for all ports in a switch. portFlagsShow Clears the port log. portLogClear Displays the current port log configuration. portLogConfigShow Displays the port log without page breaks. portLogDump Displays the port log of specified port, without page breaks.
Page 784 Table 28 switchAdmin commands (continued) Command Description Adds a member to a QuickLoop. qloopAdd Creates a QuickLoop. qloopCreate Deletes a QuickLoop. qloopDelete Removes a member from a QuickLoop. qloopRemove Displays QuickLoop information. qloopShow Sets or clears the telnet session quiet mode, or displays the current quietMode mode.
Page 785 Table 28 switchAdmin commands (continued) Command Description Displays options for configuring SNMP MIB trap capability. snmpMibCapShow Displays switch information for debugging purposes. supportShow Disables a group of commands under the command. supportShowCfgDisable supportShow Enables a group of commands under the command.
Page 786 Table 28 switchAdmin commands (continued) Command Description Sets, removes, or displays trace triggers. traceTrig Displays information on track-changes feature commands. trackChangesHelp Debugs a trunk link failure. trunkDebug Displays trunking information. trunkShow Displays or sets the NTP Server address. tsClockServer Displays or sets the system time zone. tsTimeZone Displays how long the switch has been up.
Page 787: Control Processor Commands
6 Control processor commands This chapter lists the commands available when logged in to the active CP and standby CP in an HP StorageWorks Core Switch 2/64, HP StorageWorks SAN Director 2/128, or HP StorageWorks 4/256 SAN Director. Commands supported on the active CP When logged in to the active CP on a Core Switch 2/64, you must specify the logical switch number to which you are connecting.
Page 788 Table 29 Commands supported on the standby CP (continued) Command Description Lists parameter syntax information. itemList Terminate telnet/serial login sessions interactively. killTelnet Display memory usage in the system. memShow Display the current login session details. myId Display information from panic dump file. pdShow Reboot the standby CP.
Page 789: Supportshow Reference
7 supportShow reference This chapter explains the information displayed by the command. This chapter has the supportShow following sections: • supportShow control commands, page 789 • supportShow command groups, page 789 • Proc entry information displayed, page 792 supportShow control commands command is used to display support information by executing groups of preselected supportShow Fabric OS and Linux commands.
Page 790 Table 30 supportShow command groups (continued) Command group Fabric OS 3.2.0 Fabric OS 4.4.0 port portShow diagShow portregshow portShow portstructshow portloginshow bloomdatashow portregshow portRouteShow portRouteShow portsemshow bloomsemshow semashow 1 fabric fabricShow fabricShow islShow islShow trunkShow trunkShow topologyShow topologyShow fashow fabStateResize qlshow fabSwitchShow cfgShow...
Page 791 Table 30 supportShow command groups (continued) Command group Fabric OS 3.2.0 Fabric OS 4.4.0 system version myId upTime version switchShow firmwareShow tempShow upTime psShow switchStatusShow licenseShow switchShow diagShow haDump portFlagsShow tempShow portErrShow sensorShow portCfgShow psShow configShow fanShow licenseShow portFlagsShow portCfgShow sfpShow portErrShow fwSamShow...
Page 792: Proc Entry Information Displayed
Proc entry information displayed The os command group prints a number of proc entries. Table 31 displays example proc entry information. Table 31 proc entry information displayed Proc display command Proc example display /proc/cmdline /proc/cmdline quiet /proc/cpuinfo /proc/cpuinfo cpu : 405GP clock : 200MHz revision : 1.69 (pvr 4011 0145) bogomips : 199.47...
Page 793 Table 31 proc entry information displayed (continued) Proc display command Proc example display /proc/interrupts /proc/interrupts CPU0 0: 0 IBM UIC Level serial 1: 591 IBM UIC Level serial 2: 2696197 IBM UIC Level IBM OCP IIC 10: 0 IBM UIC Level OCP EMAC MAL SERR 11: 1512 IBM UIC Level OCP EMAC TX EOB 12: 343895 IBM UIC Level OCP EMAC RX EOB 13: 0 IBM UIC Level OCP EMAC TX DE...
Page 794 Table 31 proc entry information displayed (continued) Proc display command Proc example display /proc/pci /proc/pci PCI devices found: Bus 0, device 0, function 0: Host bridge: IBM 405GP PLB to PCI Bridge (rev 1). Master Capable. Latency=7. Prefetchable 32 bit memory at 0x0 [0x7fffffff]. Bus 0, device 4, function 0: IDE interface: CMD Technology Inc PCI0649 (rev 2).
Page 795 Table 31 proc entry information displayed (continued) Proc display command Proc example display /proc/uptime /proc/uptime 158791.21 155710.77 /proc/version /proc/version Linux version 2.4.19 (swrel@sierra) (gcc version 2.95.3 20010112 (prerelease)) #1 Wed Mar 26 00:04:35 PST 2003 Fabric OS 5.x command reference guide 795...
Page 796 796 supportShow reference...
Page 797: Glossary
Glossary 8b/10b encoding An encoding scheme that converts each 8-bit byte into 10 bits. Used to balance 1s and 0s in high-speed transports. address identifier A 24-bit or 8-bit value used to identify the source or destination of a frame. See also S_ID and D_ID.
Page 798 autocommit A feature of the command. Enabled by default, autocommit commits firmwareDownload new firmware to both partitions of a control processor. autoreboot Refers to the -b option of the command. Enabled by default. firmwareDownload AW_TOV Arbitration wait timeout value. The minimum time an arbitrating L_Port waits for a response before beginning loop initialization.
Page 799 cascade Two or more interconnected Fibre Channel switches. HP StorageWorks 1 GB/s switches and later switches can be cascaded up to 239 switches, with a recommended maximum of seven interswitch links (no path longer than eight switches). See also fabric, ISL. Clock and data recovery circuitry.
Page 800 configuration (1) A set of parameters that can be modified to fine-tune the operation of a switch. Use the command to view the current configuration of your switch. configShow 2) In HP Zoning, a zoning element that contains a set of zones. The Configuration is the highest-level zoning element and is used to enable or disable a set of zones on the fabric.
Page 801 digital certificate An electronic document issued by a CA (certificate authority) to an entity, containing the public key and identity of the entity. Entities in a secure fabric are authenticated based on these certificates. See also authentication, CA, public key. disparity The proportion of 1s and 0s in an encoded character.
Page 802 end-to-end flow Governs flow of Class 1 and 2 frames between N_Ports. See also EE_Credit. control entry fabric The basic HP software license that allows one E_Port per switch. End of frame. A group of ordered sets used to mark the end of a frame. error As it applies to the Fibre Channel industry, a missing or corrupted frame, timeout, loss of synchronization, or loss of signal (link errors).
Page 803 Fabric address notification. Retains the AL_PA and fabric address when a loop reinitializes, if the switch supports FAN. fan-in The ratio of hosts to storage devices; the view of the SAN from the storage port's perspective. fan-out The ratio of storage devices to hosts; the view of the SAN from the host port's perspective. FC-0 Lowest layer of Fibre Channel transport.
Page 804 FCIA Fibre Channel Industry Association. An international organization of Fibre Channel industry professionals. Provides oversight of ANSI and industry-developed standards, among other tasks. FCIP Tunneling The HP Multiprotocol SAN Routing Service that enables SANs to span longer distances than Service could be supported with native Fibre Channel links.
Page 805 Fibre Channel The primary protocol used for building SANs to transmit data between servers, switches, and storage devices. Unlike IP and Ethernet, Fibre Channel was designed to support the needs of storage devices of all types. It is a high-speed, serial, bidirectional, topology-independent, multiprotocol, and highly scalable interconnection between computers, peripherals, and networks.
Page 806 Fibre Channel Service Protocol. The common protocol for all fabric services, transparent to the fabric type or topology. See also FS. FSPF Fabric shortest path first. The HP routing protocol for Fibre Channel switches. Fabric OS state synchronization. The FSS service is related to high availability (HA). The primary function of FSS is to deliver state update messages from active components to their peer standby components.
Page 807 header A Fibre Channel frame has a header and a payload. The header contains control and addressing information associated with the frame. hop count The number of ISLs a frame must traverse to get from its source to its destination. host A computer system that provides end users with services like computation and storage access.
Page 808 iSCSI Internet Small Computer Systems Interface. A protocol that defines the processes for transferring block storage applications over TCP/IP networks by encapsulating SCSI commands into TCP and transporting them over the network via IP. iSCSI Gateway The HP multiprotocol SAN routing service that maps the FCP protocol to the IP transport. This Service service projects iSCSI hosts onto the backbone fabric of a gateway switch.
Page 809 Link Services A protocol for link-related actions. Loop initialization primitive. The signal used to begin initialization in a loop. Indicates either loop failure or node resetting. LIPA Loop-initialization previously assigned. The device marks a bit in the bitmap if it did not log in with the fabric in a previous loop initialization.
Page 810 Link reset response. A primitive sequence during link initialization between two N_Ports in point-to-point topology or an N_Port and an F_Port in fabric topology. It is sent in response to an LR and expects a response of Idle. LSAN Logical storage area network. An LSAN enables device and storage connectivity that spans two or more fabrics.
Page 811 MSRS Multiprotocol SAN Routing Services. An optionally licensed software bundle available on certain HP platforms, such as the HP StorageWorks MP Router, that includes the Fibre Channel Routing Service, the iSCSI Gateway Service, and the FCIP Tunneling Service. MTBF Mean time between failures. An expression of time, indicating the longevity of a device. multicast The transmission of data from a single source to multiple specified N_Ports (as opposed to all the ports on the network).
Page 812 ordered set A transmission word that uses 8b/10b mapping and begins with the K28.5 character. Ordered sets occur outside of frames and include the following items: • Frame delimiters—Mark frame boundaries and describe frame contents. • Primitive signals—Indicate events. • Primitive sequences—Indicate or initiate port states.
Page 813 Public key infrastructure. An infrastructure that is based on public key cryptography and CA (certificate authority) and that uses digital certificates. See also CA, digital certificate, public cryptography. PKI certification Public key infrastructure certification utility. A utility that makes it possible to collect certificate utility requests from switches and to load certificates to switches.
Page 814 private loop An arbitrated loop that does not include a participating FL_Port. private loop device A device that supports a loop and can understand 8-bit addresses but does not log in to the fabric. private NL_Port An NL_Port that communicates only with other private NL_Ports in the same loop and does not log in to the fabric.
Page 815 RAID Redundant array of independent disks. A collection of disk drives that appear as a single volume to the server and are fault tolerant through mirroring or parity checking. See also JBOD. RAIT Redundant array of independent tapes. Reliable Commit Service. Refers to HP-specific ILS command code. RCS_SFC RCS Stage Fabric Config.
Page 816 S_ID Source ID. Refers to the native port address (24 bit address). Storage area network. A network of systems and storage devices that communicate using Fibre Channel protocols. See also fabric. SAN architecture The overall design of a storage network solution, which includes one or more related fabrics, each of which has a topology.
Page 817 Sequence initiative. Simple Name Server A switch service that stores names, addresses, and attributes for up to 15 minutes and (SNS) provides them as required to other devices in the fabric. SNS is defined by Fibre Channel standards and exists at a well-known address. Also referred to as directory service or name server.
Page 818 SPOF Single point of failure. Any component in a SAN whose malfunction could bring down the entire SAN. Secure shell. Used starting in HP Fabric OS v4.1 to support encrypted telnet sessions to the switch. SSH encrypts all messages, including the client sending the password at login. Standard Translative Allows public devices to communicate with private devices that are directly connected to the Mode...
Page 819 Third-party copy. A protocol for performing tape backups without using server resources. track changes An HP Fabric OS feature that can be enabled to report specific activities (for example, logins, logouts, and configuration task changes). The output from the track-changes feature is dumped to the error log for the switch.
Page 820 WBEM [need definition; BOFMS] Wavelength division multiplexer. Allows multiple wavelengths to be combined or filtered on a single cable. well-known address As it pertains to Fibre Channel technology, a logical address defined by Fibre Channel standards as assigned to a specific function and stored on the switch. workstation A computer used to access and manage the fabric.
Page 821: Index
Index aliasJoin aliasPurge AAA services aliasShow aaaConfig aliCreate AAA services Advanced Zoning license RADIUS exclusive primary FCS commands access levels zoning Advanced Zoning license aliDelete Advanced Zoning commands Advanced Zoning license aliAdd exclusive primary FCS commands aliCreate zoning aliDelete aliRemove aliRemove Advanced Zoning license aliShow...
Page 822 cfgClear NS operation parameters Advanced Zoning license portlog events enable zoning RSCN transmission mode cfgCreate system services Advanced Zoning license virtual channel settings exclusive primary FCS commands zoning operation parameters zoning configure cfgDelete SNMP Advanced Zoning license conventions exclusive primary FCS commands document zoning text symbols...
Page 823 aliShow configuration cfgCreate Fabric Watch cfgDelete Fabric Watch license cfgDisable Fabric Watch commands cfgEnable fwAlarmFilterSet cfgRemove fwAlarmsFilterShow cfgSave fwClassInit cfgTransAbort fwConfigReload cfgTransShow fwConfigure faZoneAdd fwFruCfg faZoneCreate fwHelp faZoneDelete fwMailCfg faZoneRemove fwPortDetailShow faZoneShow fwSamShow msConfigure fwSet msPlClearDb fwSetToCustom msPlMgmtActivate fwSetToDefault msPlMgmtDeactivate fwShow mstdDisable fabricPrincipal...
Page 824 ficonClear Fabric Watch license ficoncupset fwSetToDefault ficoncupshow Fabric Watch license ficonHelp fwShow ficonShow Fabric Watch license snmpConfig snmpMibCapShow supportShow supportShowCfgDisable standby CP commands supportShowCfgEnable haDisable switchShow haDump ficonClear standby CP commands FICON haEnable ficoncupset haFailover FICON haShow ficoncupshow standby CP commands FICON haSyncStart ficonHelp...
Page 825 Licensed product commands licenseHelp nbrStateShow licenseIDShow nbrStatsClear licenseRemove nodeFind licenseShow NS operation parameters linkCost configuration login nsAliasShow logout nsAllShow loopPortTest nscamShow LSDbShow nsZoneMember Management Server passwd msCapabilityShow exclusive primary FCS commands msConfigure pathInfo msPlatShow pdShow msPlatShowDBCB standby CP commands msPlClearDB perfAddEEMonitor msPlMgmtActivate Performance Monitor license...
Page 826 perfCfgRestore portLoginShow perfCfgSave portLogPdisc perfClearEEMonitor portLogReset perfClearFilterMonitor portLogResize perfClrAlpaCrc portLogShow perfDelEEMonitor portLogShowPort perfDelFilterMonitor portLogTypeDisable perfHelp portLogTypeEnable perfShowAlpaCrc portLoopbackTest perfShowEEMonitor portName perfShowFilterMonitor portPerfShow perfShowPortEEMask portRegTest perfSetPortEEMask portRouteShow perfShowAlpaCrc portShow Performance Monitor license SNMP perfShowEEMonitor portStats64Show Performance Monitor license portStatsClear perfShowFilterMonitor portStatsShow Performance Monitor license portSwap perfShowPortEEMask...
Page 827 qloopRemove Secure Fabric OS qloopShow secPolicyDump QuickLoop Fabric Assist mode commands exclusive primary FCS commands quietMode Secure Fabric OS secPolicyFcsMove exclusive primary FCS commands Secure Fabric OS RADIUS secPolicyRemove aaaConfig exclusive primary FCS commands Secure Fabric OS reboot secPolicySave standby CP commands exclusive primary FCS commands related documentation Secure Fabric OS...
Page 828 sensorShow ifModeSet setDbg ifModeShow setEsdMode killTelnet setGbicMode memShow setMediaMode myId setModem pdShow setSfpMode reboot setSplbMode saveCore setVerbose switchName sfpShow tsClockServer shellFlowControlDisable upTime shellFlowControlEnable version slotOff state entries slotOn statsClear slotPowerOff statsTest slotPowerOn stopPortTest slotShow Subscriber’s choice, HP slTest supportFtp SNMP supportSave agtCfgDefault supportShow...
Page 829 traceDump zoning traceFtp zoneObjectExpunge traceTrig Advanced Zoning license trackChangesHelp zoning trackChangesSet zoneObjectRename SNMP Advanced Zoning license trackChangesShow zoning SNMP zoneRemove trunkDebug Advanced Zoning license trunking exclusive primary FCS commands portCfgTrunkPort zoning trunkShow zoneShow tsClockServer Advanced Zoning license exclusive primary FCS commands exclusive primary FCS commands standby CP commands zoning...
Page 830 830 Index...

This manual is also suitable for:

Storageworks fabric os 5

HP StorageWorks 2/64 - Core Switch Command Reference Manual

About this Guide

Tables

Fabric os Command Line Interface

Fabric os Commands

Figures

Quick Links

Related Manuals for HP StorageWorks 2/64 - Core Switch

Summary of Contents for HP StorageWorks 2/64 - Core Switch