HP StorageWorks Fabric OS 5.
Legal and notice information © Copyright 2005 Hewlett-Packard Development Company, L.P. © 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.
Contents About this guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Intended audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . HP StorageWorks Fabric OS 5.x master glossary . . . . . . . . . Document conventions and symbols . . . . . . . . . . . . . . . . . . HP technical support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . HP-authorized reseller. . . .
cfgRemove. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . cfgSave. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . cfgShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . cfgSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
fabStateShow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . fabStatsShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . fabSwitchShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . fanDisable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . fanEnable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
historyMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . historyShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . httpCfgShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . i. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
perfCfgRestore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . perfCfgSave. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . perfClearEEMonitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . perfClearFilterMonitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
portStats64Show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . portStatsClear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . portStatsShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . portSwap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
sfpShow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . shellFlowControlDisable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . shellFlowControlEnable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . slotOff . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
turboRamTest . . . . . . . . . . . . . . . . . . . . . . . txdPath . . . . . . . . . . . . . . . . . . . . . . . . . . . upTime . . . . . . . . . . . . . . . . . . . . . . . . . . . uRouteConfig . . . . . . . . . . . . . . . . . . . . . . . uRouteRemove . . . . . . . . . . . . . . . . . . . . . . uRouteShow. . . . . . . . . . . . . . . . . . . . . . . . userConfig. . . . . . . . . . . . . . . . . . . . . . . . . userRename . . . . . . . . . . . . . . . . . . . . . . . . version . . . . . . . . . . . . . . .
3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 Role permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 Command output descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 Configure command fabric parameters fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents
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.
Document conventions and symbols Document conventions Table 1 Convention Element Medium blue text: Figure 1 Cross-reference links and e-mail addresses Medium blue, underlined text (http://www.hp.
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 • Applicable error messages • Operating system type and revision level • Detailed, specific questions For continuous quality improvement, calls may be recorded or monitored.
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 • Using this guide, page 19 Understanding access levels Fabric OS supports two classes of user accounts: default and multiple user account (MUA). Default accounts, introduced in early versions of Fabric OS, include root, factory, admin, and user.
except the ability to perform zone and security configuration and user management. See Table 3 for a high-level description of role permissions.
• 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 • Configuration and management of the HP fabric on multiple levels • Identification, isolation, and management of SAN events across every switch in the fabric • Management switch licenses Using this guide Th
Fabric OS command line interface
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.
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.
The following provides a detailed description of each action type: --show List the current RADIUS servers, along with their parameters. Fabric OS 5.
--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. server must be different from the servers in the existing configuration. Remove the specified server from the RADIUS configuration list.server must match a server in the existing configuration.
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. These changes are persistent across power cycles and reboots.
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: 0 none 1 critical 2 error 3 warning 4 informational 5 debug See errModuleShow for related information. The ACL check is as follows: there are six ACLs to restrict SNMP get/set/trap operations to hosts under a host-subnet-area. Host-subnet-area is defined by comparing nonzero IP octets. For example, an ACL of 192.168.64.
SNMPv1 community and trap recipient configuration: Community 1: Secret C0de (rw) Trap recipient: 192.168.15.
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) No trap recipient configured yet SNMP access list configuration: Entry 0: No access host configured yet Entry 1: No access h
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. This command updates the following values (See the HP StorageWorks Fabric OS 5.
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. By default, this value is set to 0, implying that no such traps are sent.
To correct any input mistake: erases the previous character, 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] Trap Recipient's IP address in dot notation: [192.168.1.
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. The following information displays: sysDescr The system (switch) description. The default value is Fibre Channel Switch. sysLocation The location of the system.
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. Possible values are: 0 none 1 critical 2 error 3 warning 4 informational 5 debug See errShow for related information.
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.
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. This command changes the defined configuration.
See also aliCreate aliDelete aliRemove aliShow 36 Fabric OS commands
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 aliasShow command to show the existing groups with its corresponding N_Ports. Operands The following aliasDelete argument is required.
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. An N_Port can be added from any switch that is part of the fabric. To get a list of online ports currently defined in the fabric, use the nsAllShow command.
Exit status 0 Successful operation nonzero Indicates the operation has failed See also aliasDelete aliasPurge aliasShow fabricShow nsAllShow nsShow Fabric OS 5.
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.
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.
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). The alias member list cannot contain another zone alias.
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.
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. For the change to be preserved across switch reboots, it must be saved to flash memory using the cfgSave command.
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. This command changes the defined configuration.
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 46 Fabric OS commands
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; those that match in the defined configuration are displayed.
See also aliAdd aliCreate aliDelete aliRemove 48 Fabric OS commands
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; typically, customers do not need to use this command.
• 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 • FC Originator Exchange ID (OXID) for this frame This policy allows for optimal utilization of the available paths as I/O traffic between different (SID, DID, OXID) pairs can use different paths.
See also dlsReset dlsSet dlsShow switchDisable Fabric OS 5.
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. Authentication process uses the protocol that is set using this command. When no protocol is set, the default setting of fcap, dhchap is used.
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> authutil --set -a all Authentication is set to fcap,dhchap. To set DH group 3: switch:admin> authutil --set -g 3 DH Group was set to 3.
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.
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: 1 sid data: 0xfffffd did data: 0xfffffd payload size: 2048 bytes Test Complete: backplanetest Pass 1 of 1 Duration 0 hr, 0 min & 1 sec (0:0:1:715). passed.
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: • Proper backend port domain routing setup such that every user port has a valid path to every other user port.
-fr_type type Specifies the frame type to send. The default value is 1. Type Description 0 Single frame 1 spinfab frames 2 spinfab 1K frames -extonly mode Specifies external-test-only mode. The default value is 0, which disables this mode. This command normally sends bursts of frames from each port under test to every other port in the list. With -extonly mode set to 1, the command sends only one burst of frames to each port from each ASIC pair-to-ASIC pair link.
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. The banner can be created using the banner operand or by entering the bannerSet command without an operand, making the session interactive. If you enter the banner text using the interactive method, the valid length is 1022 characters.
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.
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. Normally, all F_Ports and FL_Ports are members of the broadcast distribution tree.
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.
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. When beaconing is enabled, the port LEDs flash amber in a running pattern from port 0 through port 15 and back again. The pattern continues until the user turns it off.
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. The blade must be disabled before making configuration changes or before running many of the diagnostic tests.
Examples To disable blade 2 and then verify: switch:admin> bladedisable 2 Blade 2 is being disabled...
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. If the switch is connected to a fabric, it rejoins the fabric.
8 UNKNOWN VACANT 9 UNKNOWN VACANT 10 UNKNOWN VACANT switch:admin> bladeenable 4 slBlade 4 is being enabled...
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 diagSetBurnin and diagSetCycle. Operands This command has the following operand: slotNum A nonzero value that specifies the slot number from which to clear burn-in errors.
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: slotNum A nonzero value that specifies the slot number from which to display burn-in errors.
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. The mode becomes active as soon as this command is executed so that it does not require a reboot to take effect.
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. Operands The following operands are optional: Optional specify to get the burn-in status of a single slot. If not specified, all slots are displayed.
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. A hit means the data is found in the CAM. A miss means the data is not found.
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 DIAG-CAMSTAT DIAG-CANTXMIT See the HP StorageWorks Fabric OS 5.x diagnostics and system error messages reference guide for more information.
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 the switchDisable command.
• 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. • Port 0 reads the central memory in ASIC 1. • Port 1 reads the central memory in ASIC 1. • Port 14 reads the central memory in ASIC 1. • Port 15 reads the central memory in ASIC 1. • Port 15 reads the central memory in ASIC 2. • Port 15 reads the central memory in ASIC 3. 3.
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: 1. Clear the error and interrupt bits of all ASICs. 2. Set up the hardware so that transmission of data includes a bad buffer. 3. For each of the 11 possible offsets for each ASIC X in the switch: a. Write a 64-byte pattern in the central memory. b. Read X from all ASIC Y in the switch. c.
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.
portLoopbackTest portRegTest spinSilk sramRetentionTest Fabric OS 5.
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. The devices that an initiator sees are based on this configuration.
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. For the change to be preserved across switch reboots, it must be saved to flash memory using the cfgSave command.
cfgRemove cfgSave cfgShow 80 Fabric OS commands
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.
See also cfgDisable cfgEnable cfgSave 82 Fabric OS commands
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.
See also cfgAdd cfgClear cfgDelete cfgDisable cfgEnable cfgRemove cfgSave cfgShow 84 Fabric OS commands
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. For the change to be preserved across switch reboots, it must be saved to flash memory using the cfgSave command.
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. This command ends and commits the current zoning transaction buffer to both volatile and flash memory.
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.
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. This command changes the defined configuration.
cfgDelete cfgDisable cfgEnable cfgSave cfgShow cfgTransAbort cfgTransShow Fabric OS 5.
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.
See also cfgAdd cfgClear cfgCreate cfgDelete cfgDisable cfgEnable cfgRemove cfgShow cfgTransAbort cfgTransShow Fabric OS 5.
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.
Operands This command has the following optional operands: A POSIX-style regular expression used to match zone configuration names. The pattern must be enclosed in quotation marks, and can contain: pattern • Question mark (?), which is a placeholder for any single character • Asterisk (*), which is a placeholder for any string of characters • Ranges, which are a placeholder for any character within the range. Ranges must be enclosed in brackets: for example, [0-9] or [a-f].
See also cfgAdd cfgClear cfgCreate cfgDelete cfgDisable cfgEnable cfgRemove cfgSave cfgTransAbort cfgTransShow 94 Fabric OS commands
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.
cfgShow 96 Fabric OS commands
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.
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.
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.
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.
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) Option 4: Two 64-port switches (Blade ID 2 on slots 1-4, ID 4 on slots 7
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.
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. Enter this command with no parameter to display the current name. Enter this command with a name operand to set the chassis name.
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.
Examples To display all FRUs for a switch: Fabric OS 5.
switch:user> chassisshow Chassis Backplane Revision: 1C SW BLADE Slot: 3 Header Version: 1 Power Consume Factor: -180 Factory Part Num: 60-0001532-03 Factory Serial Num: 1013456800 Manufacture: Day: 12 Month: 6 Year: 2001 Update: Day: 15 Month: 7 Year: 2001 Time Alive: 28 days Time Awake: 16 days ID: 555-374757 Part Num: 234-294-12345 Serial Num: 2734658 Revision Num: A.
FAN Unit: 1 Header Version: 1 Power Consume Factor: -50 Factory Part Num: 20-123456-12 Factory Serial Num: B014934500 Manufacture: Day: 6 Month: 7 Year: 2001 Update: Day: 15 Month: 7 Year: 2001 Time Alive: 88 days Time Awake: 16 days ID: 456-777888 Part Num: 230-290-12370 (output truncated) See also slotShow Fabric OS 5.
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: [slotnumber/]chipnumber Specifies the index of the chip within the specified blade to display.
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. The method used is to write a fill-pattern to all SRAMs, wait 10 seconds, and then read all SRAMs to verify that the data read matches the data previously written.
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). 13 sec (0:2:13:234). 13 sec (0:2:13:234). passed. Diagnostics The following are possible error messages: LCMEM_ERR LCMRS_ERR LCMTO_ERR See the HP StorageWorks Fabric OS 5.
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. • Message sent with a good checksum does not set any error or interrupt bit in any ASIC pair.
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 DIAG-CMIINVCAP DIAG-CMINOCAP DIAG-CMISA1 DIAG-INTNIL See the HP StorageWorks Fabric OS 5.x diagnostics and system error messages reference guide for more information.
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.
Examples To restore the system configuration to default values: switch:admin> configdefault Committing Configuration ...done.
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” on page 777 for more information.
• 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. Order of members must be maintained. • If either security policies section has a RSNMP_POLICY, then that section must have a WSNMP_POLICY.
host Specifies a host name or IP address in quotation marks: for example, “citadel” or “192.168.1.48”. The configuration file is downloaded from this host. user Specifies the user name, in quotation marks: for example, “jdoe”. This user name is used to gain access to the host system. file Specifies the file name, in quotation marks: for example, “config.txt”. Absolute path names might be specified using a forward slash (/).
configShow Displays system configuration settings. Synopsis configshow [“filter“] Availability all users Description Use this command to view the system configuration settings set by the configure command. Operands This command has the following optional operand: f Specify a text string, in quotation marks, that limits the output of the command to only those entries that contain the text string.
switch:admin> configshow diag.postDisable: fabric.domain: 0 1 fabric.ops.vc.linkCtrl: 0 fabric.ops.vc.multicast: 7 fabric.ops.wan_tov: 0 fc4.fcIp.address: 192.168.65.62 fc4.fcIp.mask: 255.255.255.0 fcAL.fanFrameDisable: 0 fcAL.useAltBBCredit: 0 lcdContrast: 128 licenseKey: none rpc.rstatd: 1 rpc.rusersd: 1 See also agtCfgShow configure diagDisablePost diagEnablePost ipAddrShow licenseShow syslogdIpShow Fabric OS 5.
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. The FTP service is widely available on UNIX hosts but less so on Windows hosts.
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 configShow command. The second section contains general switch configuration variables, such as diagnostic settings, fabric configuration settings, and SNMP settings.
See also configDefault configDownload configShow configure 122 Fabric OS commands
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 • System services • Portlog events settings • Application attributes NOTE: If executed on an enabled switch, only the application attribute can be configured.
Table 5 lists the fabric parameters fields and their settings.
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. Assigning a specific value to one or more of these parameters can change the range of allowed values that can be assigned to the other parameters.
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.
RSCN Transmission mode Table 7 lists the RSCN Transmission Mode fields and their settings.
System Services Table 9 lists the system services fields and their settings. Table 9 Configure command system services fields Field Default Range rstatd Off On/Off rusersd Off On/Off telnetd On On/Off Descriptions of the system service (setting) fields are as follows: Dynamically enables or disables a server that returns system operation information through remote procedure calls (RPC). The protocol provides for a wide range of system statistics.
Table 10 Configurable application attributes (continued) Application File Type Default Range SNMP SNMP Security Level number 0 0, 1, 2 cfgload Secure Config Upload and Download boolean off on/off NOTE: The secure protocols must not be enabled before setting SSL attributes correctly. Operands none Fabric OS 5.
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] Per-frame Route Priority: (0..1) [0] BB credit: (1..
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..
crossPortTest Tests functional operation of port external transmit and receive path.
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. The data palette of seven are: 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, ...
-spd_mode mode Specify the speed mode for the test. This parameter is used only for Bloom and 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. When speed modes 5 through 8 are used with cables, they must be connected even to odd or the test will fail.
cmemRetentionTest cmiTest itemList portLoopbackTest portRegTest spinSilk sramRetentionTest Fabric OS 5.
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. If no seed is specified, then a seed value of 0 is used.
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. A switch with incorrect date values continues to function properly.
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. For example if you enter 80 for yy, then the year displayed will be 1980. Operands This command has the following operand: newdate Specify the new date and time, in quotation marks.
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: module_name Specify the name of the module for which you want to view the debug and verbosity levels.
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: [--slot] slotnumber Specify the slot to clear the diagnostics failure status. The default is set to 0 and designed to operate on fixed-port-count products. -all If specified, all blades clear.
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: Use diagHelp to look up diagnostic command help pages. Options This command has the following options: command Specify a command name to display more detailed information.
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: switch:admin> diagdisablepost Config update Succeeded Diagnostic POST is now disabled.
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.
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. The latter method is supposed to be run only by in-house technicians but users.
Examples To display the values of the diagnostic parameters: switch:admin> diagshowusr Name Environment Value USR_DILATION DIAG_USR_DLY_DILATION 1 USR_MEMDLY DIAG_USR_MEMDLY 10 USR_SEED DIAG_USR_SEED 0x0 USR_SPECIAL DIAG_USR_SPECIAL 0x0 (output truncated) See also none Fabric OS 5.
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. The fail limit is saved in flash memory and stays set until the next execution of diagFailLimit.
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. This process takes a few seconds to complete. NOTE: Use default operands when running diagnostics commands.
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. The mode becomes active as soon as this command is executed; it does not require a reboot to take effect.
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. NOTE: Any automated use of this command should rely only on the names of the specific variables, not on their exact positions in the output.
See also burninLevel setEsdMode setGbicMode setSplbMode 150 Fabric OS commands
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; it does not require a reboot to take effect.
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. The mode becomes active as soon as this command is executed; it does not require a reboot to take effect.
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. The activity log of the script is saved in /var/log/scriptname.slot.log.
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. If all parameters are used, variables can be updated manually.
Examples To update diagnostic command parameters: switch:admin> diagsetcycle switchburnin.
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. The mode becomes active as soon as this command is executed. It does not require a reboot to take effect. ESD mode modifies the behavior of the diagnostic test methods and post scripts.
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: -slot number Specify which slot to operate on. If this option is not specified, the default slot 0 is used. The default slot is designed to operate on fixed-port-count products.
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. The mode becomes active as soon as this command is executed; it does not require a reboot to take effect.
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. It does not require a reboot to take effect.
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: slotnumber Specifies the slot to display. If omitted, all blades in the system are assumed. Examples To display currently running diagnostic tests: switch:admin> diagstatus Diagnostic status for slot: 1.
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: --slot number Specify the slot to stop burn-in.
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 dlsSet for a full description of load sharing. NOTE: This command should be used only if devices connected to the fabric cannot handle occasional routing changes correctly. DLS is not supported in certain routing policies. See aptPolicy for more information on routing policies.
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.
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: DLS is set The DLS option is turned on. Load sharing is reconfigured with every change in the fabric, and existing routes can be moved to maintain optimal balance. DLS is not set The DLS option is turned off. Once placed, existing routes are never moved to maintain optimal balance.
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.
See also configDownload configUpload firmwareDownload ipAddrSet ipAddrShow 166 Fabric OS commands
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. Operands This command has the following operands: Attribute of the enclosure to display: attribute id Displays the vendor-specific enclosure identifier.
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.
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. An empty string clears the start and the end delimiters (including the colon) so that they are not displayed.
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. Timestamp Timestamp for the message. Message ID Message identifier.
See also errDelimiterSet errFilterSet errShow Fabric OS 5.
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. If no parameters are specified, this command displays the filters that are currently in use. Operands This command has the following operands: -d “destination“ Specifies the destination to set the filter.
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.
Examples To display a list of all defined error log modules: switch:user> errmoduleshow KT UT TRCE KTRC LOG CDR BLPU PISP PIXE EGR BL PIC PS RTE AS AUTH BLDE BLM BPRT CER CFLD CFMN CHPS CONF CPT DIAG EM ERRL FABR FABS FCIU FCMC FCPD FCPH FICU FILB FKLB (output truncated) See also errDump errShow 174 Fabric OS commands
Fabric OS 5.
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. Timestamp Timestamp for the message. Message ID Message identifier.
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 to continue, Q to stop: 2004/07/14-22:24:47, [FSSM-1002], 2,, INFO, switchChassis, HA State is in sync Type to continue, Q to stop: 2004/07/14-22:25:29, [SEC-1192], 3,, INFO, switch2, Security violation: Login failure attempt via SERIAL.
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. The exit command is an accepted synonym for logout, as is pressing Ctrl-D at the beginning of a line. Operands none Examples To exit from a shell session: switch:admin> exit Connection to host lost.
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.
Flags Port flags: 0x00000001 0x00000002 0x00000004 0x00000008 0x00000010 0x00000020 0x00000040 0x00000080 0x00000200 0x00000800 0x00001000 0x00002000 0x00004000 0x00008000 0x00010000 0x00020000 0x00040000 0x00080000 0x00100000 0x00200000 0x00400000 0x00800000 0x01000000 0x02000000 0x040000000 0x080000000 0x100000000 0x200000000 Slave connection Loopback connection Incompatible connection Overlapping domains Overlapping zones Done PTIO ioctl Sent an RJT to ELP BF received from the port Segmented by routing
Examples To display fabric port information: switch:admin> fabportshow 4/14 Fabric Port Information: ======================== Port: 62 State: P3 List: 0x10068418 List Count: 0 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.
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.
Examples To display the retry count of Fabric OS commands: switch:user> fabretryshow E_Ports SW_ISL 21 31 40 44 ELP 0 0 0 0 EFP 0 1 0 0 HA_EFP 0 0 0 0 DIA 0 0 0 0 RDI 0 0 0 0 BF 0 0 0 0 RSCN 0 0 0 0 FWD 0 0 0 0 EMT 0 0 0 0 ETP 0 0 0 0 RAID 0 0 0 0 GAID 0 0 0 0 INQ 0 0 0 0 ELP_TMR 0 0 0 0 GRE 0 0 0 0 ECP 0 0 0 0 FWN 0 0 0 0 See also fabStatsShow Fabric OS 5.
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: -s | --show Displays fabric log (all users). -c | --clear Clears fabric log. -d | --disable Disables fabric log. By default, the fabric log is enabled. -e | --enable Enables fabric log.
Examples To change the number of entries: switch:admin> fabriclog -s Time Stamp Xid Input and *Action S, P Sn,Pn Port ======================================================================= ==== 11955:655 SCN Switch Online F2,NA F2,NA NA NA 11955:657 *Start 2 * F_S_TOV Timer F2,NA F2,NA NA NA 11955:657 *Start 60 * F_S_TOV Timer F2,NA F2,NA NA NA 11955:669 RSCN Rcv addr: 0x3000000 F2,NA F2,NA NA NA 11957:65 SCN Port Online F2,P0 F2,P1 21 NA 11957:69 0x277 *ELP Send 11957:
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 fabricPrincipal command is based solely on mechanisms specified in the Fibre Channel standards.
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.
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.
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 -c.
fabStateResize Changes the number of state entries.
See also fabricLog fabStateClear fabStateShow Fabric OS 5.
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.
switch:admin> fabstateshow Time Stamp Input and *Action S, P Sn,Pn Port Xid =========================================================================== 11955:655 SCN Switch Online F2,NA F2,NA NA NA 11955:657 *Start 2 * F_S_TOV Timer F2,NA F2,NA NA NA 11955:657 *Start 60 * F_S_TOV Timer F2,NA F2,NA NA NA 11955:669 RSCN Rcv addr: 0x3000000 F2,NA F2,NA NA NA 11957:65 SCN Port Online F2,P0 F2,P1 21 NA 11957:69 *ELP Send F2,P1 F2,P1 21 0x277 11957:69 SCN Port Online F2
fabStatsShow Displays the fabric statistics. Synopsis fabstatsshow Availability all users Description Use this command to display the statistics for the fabric.
Examples To display the fabric statistics: switch:admin> fabstatsshow Description Count ----------------------------------------Domain ID forcibly changed: 0 E_Port offline transitions: 0 Reconfigurations: 1 Segmentations due to: Loopback: 6 < Incompatibility: 0 Overlap: 0 Zoning: 0 E_Port Segment: 0 Licensing: 0 Disabled E_Port: 0 Platform DB: 0 Sec Incompatibility: 0 Sec Violation: 0 ECP Error: 0 Duplicate WWN: 0 Eport Isolated: 0 See also fabRetryShow Fabric OS 5.
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.
dup xid occurrence: 0 iu nodes outstanding: 0 EFP update port: 2 FWN frames pending 0 test check point: No check point set fabric license: TRUE fabric EFP version: 7 last message: 20:30:29.826 *Snd inquiry (4) NA D0,NA D0,NA NA NTP ports online: RSCN domain recovery list: no domain RSCN's to recover reachable domains: 1 3 4 3 domains reachable Ports used for EFP/BF/DIA flood: (output truncated) See also supportShow Fabric OS 5.
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. Operands This command has the following operand: unit Specify the fan's unit number to disable. View the fan unit numbers using the fanShow command. This operand is required.
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 fanDisable command). NOTE: This command is not available on nonbladed systems except for the StorageWorks SAN Switch 4/32. Operands This command has the following operand: unit Specify the fan's unit number to enable. View the fan unit numbers using the fanShow command. This operand is required.
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: OK Fan is functioning correctly. absent Fan is not present. below minimum Fan is present but rotating too slowly or stopped. above minimum Fan is rotating too quickly. unknown Unknown fan unit installed. faulty Fan has exceeded hardware tolerance and has stopped.
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 diagDisablePost command, then fastBoot is the same as reboot.
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). For the change to become effective, an appropriate Fabric Assist zone configuration must be enabled using the cfgEnable command.
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.
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. A Fabric Assist zone name is in C language style.
Operands The following operands are required: fazoneName Specify a name for the Fabric Assist zone. The name must be enclosed in quotation marks. member Specify a member or list of members to add to a Fabric Assist zone. The list must be enclosed in quotation marks, members separated by semicolons. A member can be specified by one or more of the following methods: • Enter a fabric domain and area number pair (for example, “1,2“). View the area numbers for ports using the switchShow command.
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). For the change to become effective, an appropriate Fabric Assist zone configuration must be enabled using the cfgEnable command.
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. For example, if a Fabric Assist zone contains “array2; array3; array4”, removing “array4; array3” fails but removing “array3; array4” succeeds.
See also faZoneAdd faZoneCreate faZoneDelete faZoneShow 208 Fabric OS commands
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. Defined configuration information is shown from the transaction buffer. See the cfgShow command for a description of this display.
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. In addition, two Fibre Channel ELS requests are generated. The first ELS request is from the domain controller to the source port identifier.
-p pattern Specifies up to 16 "pad" bytes, which are used to fill out the 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. -b Specifies to bypass the zone check functionality. -q Specifies quiet output. Only the zoning information and the summary line appear upon program termination.
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 received reply from 0x2080
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.
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.
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> fcpLogEnable See also fcPing fcpLogDisable fcpLogShow Fabric OS 5.
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> fcpLogShow Time Stamp Event Port file&lineno arg0 arg1 arg2 arg3 arg4 ====================================================================================== 22:34:10.
See also fcPing fcpLogDisable fcpLogEnable Fabric OS 5.
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.
See also portLoginShow portLogShow Fabric OS 5.
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.
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. The revision of the switch also displays, followed by the world wide name of the switch.
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. Only abbreviated FDMI information is shown for HBA and ports on remote switches.
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.
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: database Specifies the name of the FICON database. The databases are: RLIR Removes all entries from the link incidents database. RNID Removes all the not current entries from the device node identification database.
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.
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: fmsmode Display the FICON Management Server (FMS) mode for the switch. modereg Display the FICON-CUP mode register.
To display ASM bit in the mode register for the switch: switch:user> ficoncupshow modereg ASM ASM --1 See Also ficoncupset Fabric OS 5.
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. ficonshow RNID fabric ficonshow LIRR Displays all RNID entries within the fabric.
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. Fabric OS 5.
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 ficonShow database operand is the name of the database to display.
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: • Bit-error-rate threshold exceeded • Loss of signal or synchronization • NOS recognized • Primitive sequence timeout • Invalid primitive sequence for port state Listener PID Same as PID.
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; otherwise, a reserved field for a channel port. 0x07 Terminal - Full screen if it is an storage port; otherwise, a reserved field for a channel port.
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 • RNID • LIRR • SwitchRNID • RLIR • ILIR This operand is required.
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 531800 50:05:07:64:01:40:13:70 20:18:00:60:69:33:3
To display the local RLIR database: switch:user> ficonshow RLIR { {Fmt Type PID 0x18 N Port Incident Count TS Format 502e00 46 Time Stamp 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 50:05:07:64:01:40:0f:ca 50:05:07:64:00:c1:69:ca Type Number: 002064 Model Number: 101 Manufacturer: IBM Flag Node Parameters 0x50 0x200105 Flag Node Parameters 0x00 0x200a2e Plant
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 Fmt Protocol Domain Fabric WWN 0x18 FICON 80 Switch WWN 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 N 0x502b00 50:05:07:64:01:00:15:8d } } {FRU Failure [3]: Power Supply[4] failure occurred on Mon Jan 13 12:11:38 2003 Fmt Protocol Doma
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. FLTACT_FROZEN Action to handle the frame frozen process.
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: --slot slotnumber Specify the slot number on which the diagnostic operates. The port specified are relative to this slot number. The default is 0 and designed to operate on fixed-port-count products. -passcnt passcnt Specify the number of times to perform this test.
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. This must be done after each firmware download and after the switch has been rebooted and a sanity check is performed to make sure the new image is fine.
See also firmwareDownload firmwareRestore 240 Fabric OS commands
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.
-b 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 reboot command manually to activate the downloaded image. If autoreboot mode is enabled, the switch reboots automatically after the firmwareDownload command has been run. -n Specify this operand to deactivate autocommit mode.
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. Do you want to continue [Y]: FirmwareDownload has started in Standby CP. It may take up to 10 minutes.
See the HP StorageWorks Fabric OS 5.x diagnostics and system error messages reference guide for more information.
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 firmwareDownload command. The event log is created by the current firmwareDownload command and is kept until another firmwareDownload command is issued. There is a timestamp associated with each event.
[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. [9]: Tue Jan 18 13:33:54 2004 cp0: Standby CP booted up with new firmware. [10]: Tue Jan 18 13:33:56 2004 cp0: Firmwarecommit has started on both Active and Standby CPs.
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 firmwareDownload and a reboot (with autocommit disabled), the downloaded firmware becomes active. If you then do not want to commit the firmware and want to restore the former firmware, run firmwareRestore.
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. Operands none Examples To display the firmware version of a single-CP system: switch:admin> firmwareshow Primary partition: v5.0.
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.
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. -ports itemlist Specify the ports to test. If itemlist is omitted, the test is executed on all online F_Ports in the specified slot. -seed payload_pattern Specify the pattern of the test packets payload.
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.
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. WWN is the only supported value; it specifies the replacement of the WWN card.
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... WWN card hot swap is now complete. FRU replacement completed successfully! See also none Fabric OS 5.
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 Description version Version of FSPF protocol. domainID Domain number of local switch. switchOnline State of the local switch.
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.
See also bcastShow topologyShow uRouteShow 256 Fabric OS commands
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: mode Specify 1 to enable the alarms, 0 to disable the alarms.
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.
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 fwConfigure for a list of classes.
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.
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. Each area can include multiple thresholds.
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 E_Port Link loss Sync loss Signal loss Protocol error Invalid words Invalid CRCS RXPerformance TXPerformance State Changes 262 Fabric OS commands
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 Fabric OS 5.
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 TS Out of Sync No-FCS Incompatible Security DB Illegal Command Resource Flash Operands This command has the following optional ope
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 12 : Quit Select a class => : (1..12) [1] 1 1 : Temperature 2 : Fan 3 : Power Supply 4 : return to previous page Select an area => : (1..
See also fwClassInit fwConfigReload fwShow 266 Fabric OS commands
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.
Examples To change the FRU state alert configuration: switch:admin> fwfrucfg The current FRU configuration: Alarm State Alarm Action ----------------------------------------------Slot 0 1 Power Supply 0 0 Fan 0 0 WWN 0 0 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 Slot Alarm State: (0..31) [0] 3 Slot Alarm Action: (0..
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.
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. Switch elements monitored by Fabric Watch are divided into classes, and e-mail alerts are based on the classes. Each class can configure one e-mail address as the alert message's receiver.
Config Show Menu -------------------------------------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 : End-to-End Performance Monitor class 9 : Filter Performance Monitor class 10 : Security class 11 : Resource class 12 : FRU Class 13 : Quit Select an item => : (0..
Mail Config Menu -------------------------------------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 : End-to-End Performance Monitor class 9 : Filter Performance Monitor class 10 : Security class 12 : FRU Class 13 : Quit Select an item => : (0..13) [11] 1 Mail To: [NONE] JoeDoe@bogus.
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.
Yields a port detail report for the specified portState. Valid portState entries are: --s portState h Report based on all healthy ports m Report based on all marginal ports f Report based on all faulty ports o Report based on all offline ports Examples To retrieve a port detail report: 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.
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.
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.
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 The operand is as follows: --port --persistence seconds Set port parameters.
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. Operands none Examples To set alarm levels to custom values: switch:admin> fwsettocustom Committing configuration...done.
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. Operands none Examples To return alarm levels to default values: switch:admin> fwsettodefault Committing configuration...done. See also fwSetToCustom Fabric OS 5.
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.
10 : Security class 11 : Resource class 12 : Quit Select an item 1 : Temperature => : (1..12) [11] 1 2 : Fan 3 : Power Supply 4 : return to previous page Select an area => : (1..
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: No callbacks are registered.
h Displays shell history. Synopsis h 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. The h command displays the 20 most recent commands typed into the shell; the oldest commands are replaced as new ones are entered. To edit a command, press ESC to access edit mode and then use vi commands.
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.
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.
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 Ethernet IP Address: 10.64.118.105 Ethernet Subnetmask: 255.255.240.0 Fibre Channel IP Address: 0.0.0.
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> haenable HA is enabled See also haDisable Fabric OS 5.
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 haFailover results in an active CP reboot, a warning message and confirmation are displayed. If the user confirms, the failover takes place.
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) • High Availability enabled/disabled • Heartbeat up/down • Health of standby CP: Healthy The standby CP is running and the background health diagnostic has not detected any errors.
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 haDisable haEnable haFailover 290 Fabric OS commands
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.
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.
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, diagShow displays a list of diagnostic commands.
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 UNKNOWN.
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. Operands none Examples To change the history mode to first-in from rotating: switch:admin> historymode History Mode is: Rotating.
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.
Examples To display the entire contents of the history file: switch:admin> historyshow FAN Unit 3 Removed at Tue Aug 14 10:05:37 1970 Factory Part Number: 20-123456-12 Factory Serial Number: 1013456800 POWER SUPPLY Inserted at Tue Aug 14 10:52:10 1970 Unit 1 Factory Part Number: 60-0001536-02 Factory Serial Number: Not Available FAN Inserted at Tue Aug 14 10:23:45 2001 Unit 3 Factory Part Number: 20-123456-12 Factory Serial Number: 1013456800 WWN Inserted at Tue Aug 14 11:03:45 2001
See also historyLastShow 298 Fabric OS commands
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 To display the Java plug-in version: switch:admin> httpcfgshow Current HTTP configuration javaplugin.version = 1,3,1 javaplugin.homeURL = http://java.sun.com/products/plugin See also none Fabric OS 5.
i 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 14.
Table 14 i command field descriptions (continued) Field Description ADDR Memory address of the process SZ The total size of the process in virtual memory, in pages WCHAN The address of an event for which process is sleeping (if blank, process is running) TTY The controlling terminal of the process (? printed for no controlling terminal) TIME The cumulative execution time for the process CMD The command name of the process Operands This command has the following operand: Specify the process nam
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. Changing the link mode is not supported for all network interfaces or for all Ethernet network interfaces.
Examples To advertise all modes of operation, when not entering this command through the serial console port, follow this scenario for the ifModeSet command: switch:admin> ifmodeset eth0 Exercise care when using this command. Forcing the link to an operating mode not supported by the network equipment to which it is attached may result in an inability to communicate with the system through its ethernet interface. It is recommended that you only use this command from the serial console port.
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: interface Specify the name of the interface. You might specify the name with quotation marks, but using them is not required. For example, you can use either eth0 or “eth0”, where eth is the network interface and 0 is the physical unit.
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.
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. lastInit Time the last initializing state, NB_ST_INIT, on this interface. firstHlo Time the first hello sent on this interface.
Operands This command has the following operands: slotnumber For bladed systems only, specify the slot number of the port to display, followed by a slash (/). portnumber Specify the port number to display, relative to its slot for bladed systems. Use switchShow to list valid ports. This operand is optional; if omitted, the interface information for all ports is displayed.
state = NB_ST_FULL lastTransition = Apr 02 20:01:44.512 nghbCap = 0x0 nghbId = 100 idbNo = 4 remPort = 52 nflags = 0xf initCount = 1 lastInit = Apr 02 20:01:44.460 firstHlo = Apr 02 20:01:44.473 nbstFull = Apr 02 20:01:44.
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. Each switch must be rebooted after changing the interoperability mode for the change to take effect.
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.
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. This command might cause out-of-order delivery of frames during fabric topology changes.
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. However, when topology changes occur in the fabric (for instance, a link goes down), traffic is rerouted around the failure and some frames might be delivered out of order.
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 iodSet Fabric OS 5.
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. To set the CP IP address use -cp; to set the switch IP address use -sw.
See also ipAddrShow Fabric OS 5.
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.
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.
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 hex digit = digit |A|B|C|D|E|F|a|b|c|d|e|f white = *[“\t\f\r ,“] Description All kernel diagnostics have at least one item list parameter to specify which ports to test.
• 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.
killTelnet Terminates an open telnet session. Synopsis killtelnet Availability admin Description Use this command to terminate an open telnet session. The killTelnet command is an interactive 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.
switch:admin> killtelnet Collecting login information....Done List of telnet sessions (3 found) ______________________________________________________________________________ Session No USER TTY IDLE FROM LOGIN@ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 0 root0 ttyS0 1:17m - 5:13pm 1 admin0 pts/0 16.00s 192.168.130.29 6:29pm 2 admin0 pts/1 3.00s 192.168.130.
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.
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.
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. The chassis is assigned a license ID from which a license is generated.
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 licenseShow command to verify that the key has been removed and the licensed product uninstalled. After removing a license key, the switch must be rebooted.
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.
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. The FSPF protocol compares the cost of various paths between a source switch and a destination switch by adding the costs of all the ISL's along each path. FSPF chooses the path with minimum cost.
Examples To display the cost of a link and set that cost: switch:admin> linkcost Slot Interface Cost -------------------------------------2 0 500 (STATIC) 2 1 2 2 500 (STATIC) 2 3 200 (STATIC) 2 4 1000 2 5 1000 2 6 1000 2 7 1000 2 8 1000 2 9 1000 2 10 1000 2 11 (E_PORT) 2000 (STATIC) 2 12 1000 2 13 1000 2 14 1000 2 15 1000 1000 switch:admin> linkcost 2/4 500 switch:admin> linkcost 2/4 Slot 2 Interface 4 Cost 500 (STATIC) switch:admin> linkcost 2/4 0
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. This command allows you to access commands that you cannot access at your current user level.
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. The exit command is accepted as a synonym for logout, as is Ctrl-D at the beginning of a line.
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.
-seed payload_pattern -width pattern_width Specify the seed pattern of the test packets. The data types are: 1 CSPAT 0x7e, 0x7e, 0x7e, 0x7e, ... 2 BYTE_LFSR 0x69, 0x01, 0x02, 0x05, ... 3 CHALF_SQ 0x4a, 0x4a, 0x4a, 0x4a, ... 4 QUAD_NOT 0x00, 0xff, 0x00, 0xff, ... 5 CQTR_SQ 0x78, 0x78, 0x78, 0x78, ... 6 CRPAT 0xbc, 0xbc, 0x23, 0x47, ... 7 RANDOM 0x25, 0x7f, 0x6e, 0x9a, ... Specify the width of the test pattern.
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. • The link state record (LSR), which is allocated when a switch is connected to the fabric.
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. Always 1. options Always 0. lsId ID of this LSR. It is identical to the domain number. advertiser ID (domain number) of the switch that originated this LSR.
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 = 0 ignoredLSRs = 0 lastIgnored = Never installTime = Apr 02 22:25:30.
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 = 12, cost = 500, costCnt = 0, type = 1 LinkId = 2, out port = 45, rem port = 13, cost = 500, costCnt = 0, type = 1 LinkId = 2, out port = 46, rem port = 14, cost = 500, costCnt = 0, type = 1 LinkId = 2, out port = 47, rem port = 15, cost = 500, costCnt = 0, type = 1 The local switch has sixteen links
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. Operands This command has the following operands: -b Specify to display memory usage in bytes. -k Specify to display memory usage in kilobytes. -m Specify to display memory usage in megabytes. By default, memory usage is displayed in bytes.
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.
3. 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. 4. 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: • 1000 bytes of CSPAT • 480 bytes of RDRAM_PAT • 2112 bytes of BYTE_LFSR • 200 bytes of RANDOM 5. Periodically check status: a. Each port has not died. b. Each port's frames-transmitted counter is still incrementing. c.
-spd_mode mode 5 Internal (parallel) loopback 7 Backend bypass and port loopback 8 Backend bypass and SERDES loopback 9 Backend bypass and internal loopback Specifies the speed mode for the test. This parameter is only used for Bloom and Condor ASIC-based products, for which this parameter controls the speed at which each port operates. For 1G-only products, this parameter is ignored. The exact operation of modes 5 through 8 depends on the loopback mode selected.
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 ... Spinning ... Path 4 ... Spinning ... Path 5 ... Spinning ... Path 6 ... Spinning ... Path 7 ... Spinning ... Test Complete: minicycle Pass 1 of 1 Duration 0 hr, 1 min & 4 sec (0:1:4:409). passed.
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 PORT_DIED PORT_ENABLE P
See also backport camTest centralMemoryTest cmemRetentionTest cmiTest crossPortTest itemList portLoopbackTest portRegTest spinSilk sramRetentionTest Fabric OS 5.
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. Operands The operands are as follows: slotnumber/asicpair Specifies the index of the ASIC pair within the specified blade to be displayed.
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.
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.
See also msConfigure msPlMgmtActivate msPlMgmtDeactivate msTdDisable msTdEnable msTdReadConfig Fabric OS 5.
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. If the MS ACL is empty (default), MS is available to all systems connected to the fabric.
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 0 Done 1 Display the access list 2 Add member based on its Port/Node WWN 3 Delete member based on its Port/Node WWN select : (0..3) [1] 0 done ... See also msCapabilityShow msPlatShow msPlClearDB msPlMgmtActivate msPlMgmtDeactivate msTdDisable msTdEnable msTdReadConfig secPolicyShow Fabric OS 5.
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.
See also msCapabilityShow msConfigure msPlatShowDBCB msPlClearDB msPlMgmtActivate msPlMgmtDeactivate Fabric OS 5.
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.
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.
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. After successful activation, all switches in the fabric boot with the MS platform service enabled.
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.
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; therefore, persistent across power cycles and reboots.
See also msTdEnable msTdReadConfig Fabric OS 5.
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” is used, this command attempts to enable the MS topology discovery service on all switches in the fabric.
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> mstdreadconfig *MS Topology Discovery is enabled. See also msCapabilityShow msConfigure msPlMgmtActivate msPlMgmtDeactivate msTdDisable msTdEnable Fabric OS 5.
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.
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. The following fields display: Local Domain ID Domain number of local switch. Local Port E_Port (interface) on local switch.
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 interfaceShow command. Use this command without operands to reset counters on all interfaces.
(output truncated) nCmdAcc = 37 nInvCmd = 0 nHloIn = 10 nInvHlo = 0 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: nghbP = 0x1004ce68 ifNo = 0 masterPort = 0 (self) defaultCost = 500 cost = 500 (output truncated) nCmdAcc = 0 nInvCmd = 0 nHloIn = 0 nInvHlo = 0 nLsuIn = 0 nLsaIn = 0 attHloO
See also interfaceShow portShow switchShow 364 Fabric OS commands
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; or have a device PID matching with the given PID; or have a defined configuration alias to which the device belongs matching with the given alias.
Examples To display all the device information matching the given data: switch:admin> nodefind a320 Local: Type Pid NL COS PortName 0314d9; NodeName SCR 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 NL 0314d6; 3;22:00:00:04:cf:9f:78:7b;20:00:00:04:cf:9f:78:7b; 0 FC4s: FCP [SEAGATE ST336605FC 0003] Fabric Port Name: 20:14:00
To display all the device information matching the given PID: switch:admin> nodefind 0x020eef Remote: Type Pid NL COS 020eef; PortName NodeName 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> nodefind abcd No device found. See also aliShow nsAllShow nscamShow nsShow Fabric OS 5.
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 nsAllShow displays information from all switches.
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 N COS 021200; PortName NodeName TTL(sec) 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: N 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:6
To display local NS information with aliases with -r option: switch:admin> nsAliasShow -r { Type Pid N COS 021200; PortName NodeName SCR 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: N 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 NL 0214e2; 3;21:00:00:fa:ce:00
To display local NS information with aliases with -r and -t options: switch:admin> nsAliasShow -r -t { Type Pid N COS 021200; PortName NodeName SCR 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: N 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:
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. NOTE: Specifying the type operand causes the switch to send out a query to every switch in the fabric.
See also nsShow switchShow Fabric OS 5.
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.
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 known rev owner v430 0xfffc01 Device list: count 1 Type Pid COS PortName NodeName N 021200; 2,3;10:00:00:60:69:00:ab:ba;10:00:00:60:69:00:ab:ba; FC4s: FCIP PortSymb: [28] "SEAGATE ST318452FC 0001" Fabric Port Name: 20:02:00:60:69:00:68:19 Permanent Port Name: 10:00:00:60:69:00:ab:ba Switch entry for 4 state known rev v320 owner 0
nsShow switchShow 376 Fabric OS commands
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 The nsAllShow command displays information from all switches. Each line of output displays: Type U for unknown, N for N_Port, NL for NL_Port. PID 24-bit Fibre Channel address.
Operands This command has the following operands: -r -t 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. SCR=2 Nx_Port detected registration.
Examples To display local NS information: switch:admin> nsShow { Type Pid N COS 021200; PortName NodeName TTL(sec) 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 N 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 NL 0214e2; 3;21:00:00:fa:ce:00:21:1e;20:00:00:fa:ce:00:21:1e; na FC4s: FCP [STO
To display local NS information with -r: switch:admin> nsShow -r { Type Pid N COS 021200; PortName NodeName SCR 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 N 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 NL 0214e2; 3;21:00:00:fa:ce:00:21:1e;20:00:00:fa:ce:00:21:1e; 0 FC4s: FCP [STOREX R
To display local NS information with -r and -t: switch:admin> nsShow -r -t { Type Pid N COS 021200; PortName NodeName SCR 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) N 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 Initiat
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.
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 COS PortName NodeName SCR NL 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 NL 0416e2; 3;22:00:00:20:37:d9:6b:b3;20:00:00:20:37:d9:6b:b3; 0 FC4s: FCP [SEAGATE ST318304FC 0005] Fabric Port Name: 20:06:00:60:69:50
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 COS PortName NodeName SCR NL 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 NL 0416e2; 3;22:00:00:20:37:d9:6b:b3;20:00:00:20:37:d9:6b:b3; 0 FC4s: FCP [SEAGATE ST318304FC 0005] Fabric Port Name: 20:06:00:60:69
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; Aliases: trimm32a_8 Pid: 0xdc2800; Aliases: Totally 9 unzoned devices in the fabric. See also cfgShow nscamShow nsShow Fabric OS 5.
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.
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. This is valid on most computers; however, your settings could be different.
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.
BW 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.
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. The maximum hop count is enforced. If the source route does not specify all the switches along a section of the path, a further option allows to specify a strict versus a loose path.
Examples To display basic path information to a specific domain, using the command line (noninteractive mode): switch:admin> pathinfo 91 Target port is Embedded Hop In Port Domain ID (Name) Out Port BW Cost --------------------------------------------------------0 E 9 (web226) 2 1G 1000 1 3 10 (web229) 8 1G 1000 2 8 8 (web228) 9 1G 1000 3 6 91 (web225) E - - To display basic and extended statistics using interactive mode: switch:admin> pathinfo Max hops: (1..
Hop In Port Domain ID (Name) Out Port BW Cost --------------------------------------------------------1 3 10 (web229) 12 Port 1G 1000 3 12 Tx Rx Tx Rx ----------------------------------------------- Hop B/s (1s) 36 76 0 0 B/s (64s) 5 5 5 5 Txcrdz (1s) 0 - 0 - Txcrdz (64s) 0 - 0 - F/s (1s) 1 1 0 0 F/s (64s) 0 0 0 0 Words 240434036 2294316 2119951 2121767 Frames 20025929 54999 162338 56710 Errors - 4 - 0 In Port Domain ID (Name) Out Port BW
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. If a panic dump file is specified as an argument, the contents of that specific file are displayed.
See also portLogDump saveCore 394 Fabric OS commands
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.
DestID Specify the 3-byte DID (destination ID) of the destination device. It 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. Optionally, a comma can separate the operands. SourceID and DestID also can be enclosed in quotation marks. A space is required to separate the operands even when using commas.
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. After a successful execution of this command, a monitor number is displayed.
See also perfAddEEMonitor perfAddReadMonitor perfAddRWMonitor perfAddSCSIMonitor perfAddUserMonitor perfAddWriteMonitor 398 Fabric OS commands
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. Only frames transmitted are counted. After successful execution of this command, a monitor number is displayed.
See also perfAddEEMonitor perfAddIPMonitor perfAddRWMonitor perfAddSCSIMonitor perfAddUserMonitor perfAddWriteMonitor 400 Fabric OS commands
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. Only frames transmitted are counted. After a successful execution of this command, a monitor number is displayed.
See also perfAddEEMonitor perfAddIPMonitor perfAddReadMonitor perfAddSCSIMonitor perfAddUserMonitor perfAddWriteMonitor 402 Fabric OS commands
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. After a successful execution of this command, a monitor number is displayed.
See also perfAddEEMonitor perfAddIPMonitor perfAddReadMonitor perfAddRWMonitor perfAddUserMonitor perfAddWriteMonitor 404 Fabric OS commands
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.
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; valueList values are specified with: alias 0 SOFf 1 SOFc1 2 SOFi1 3 SOFn1 4 SOFi2 5 SOFn2 6 SOFi3 7 SOFn3 Specify a name for this monitor. This string truncates to a maximum of 10 characters.
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. Only frames transmitted are counted. After a successful execution of this command, a monitor number is displayed.
See also perfAddEEMonitor perfAddIPMonitor perfAddReadMonitor perfAddRWMonitor perfAddSCSIMonitor perfAddUserMonitor 408 Fabric OS commands
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.
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 perfCfgClear command; rather, it restores the configuration on nonvolatile memory.
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.
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 perfMonitorClear instead. 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.
See also perfAddEEMonitor perfShowEEMonitor perfMonitorClear Fabric OS 5.
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 perfMonitorClear instead. 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.
See also perfAddUserMonitor perfShowFilterMonitor perfMonitorClear Fabric OS 5.
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.
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.
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.
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.
Examples To display commands related to performance monitoring: switch:admin> perfhelp perfCfgSave Save Performance configuration to FLASH perfCfgRestore FLASH Restore Performance configuration from 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 Delete an end-to-end monitor on port perfClearEEMonitor on a port Clear an end-to-
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).
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> perfMonitorClear --class ISL 1 This will clear ISL monitor on port 1, continue? (yes, y, no, n): [no] y See also perfAddEEMonitor perfAddIPMonito
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). End-to-end monitors are created using perfAddEEMonitor.
Operands The operands are as follows: --class monitor_class The monitor class, which can be one of EE (end-to-end), FLT (filter-based), or ISL (inter-switch link). This operand is required. slotnumber For bladed systems only, this operand specifies the slot number of the port on which the monitor is to be added, followed by a slash (/). portnumber Specifies the number of the port on which the monitor is to be added, relative to its slot for bladed systems. Use switchShow for a list of valid ports.
To display EE monitors on a port: switch:admin> perfMonitorShow --class EE 4/5 There are 7 end-to-end monitor(s) defined on port 53.
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. KEY ALIAS OWNER_APP OWNER_IP_ADDR FRAME_COUNT ----------------------------------------------------------------0 SCSI_Frame TELNET N/A 0x00000000002c2229 1 SCSI_WR TELNET N/A 0x000000000000464a 2 SCSI_RW TELNET N/A 0x000000000000fd8c 3 SCSI_RW WEB_TOOLS 192.168.169.40 4 SCSI_RW WEB_TOOLS 192.168.169.
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.
RxSIDMsk Specify the source ID mask in dd:aa:pp format. Quotation marks are optional. RxSIDMsk represents receiving source ID mask. This operand is required. RxDIDMsk Specify the destination ID mask in dd:aa:pp format. Quotation marks are optional. RxDIDMsk represents receiving destination ID mask. This operand is required. Optionally, a comma can separate the operands. A space is required to separate the operands even when using commas.
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.
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 perfMonitorShow instead. Description Use this command to display end-to-end monitor information on a port. See perfMonitorShow for details regarding this command’s output.
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 0 1 2 3 4 ------------------------------------------------------------crc Tx Rx crc Tx Rx crc Tx Rx crc Tx Rx crc Tx ============= ============= ============= ============= ============= 0 0 0 0 0 0 0 0 0 0 0 0 0 0 53m 4.9m 0 53m 4.9m 0 53m 4.9m 0 53m 4.9m 0 0 53m 4.4m 0 53m 4.4m 0 53m 4.4m 0 53m 4.
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 perfMonitorShow instead. Description Use this command to display all the filter-based monitors defined on the specified port and the traffic count values. See perfMonitorShow for details regarding this command’s output.
26k 26k 26k 26k 26k 26k 26k 26k 26k 164 190 181 200 180 179 187 200 204 752 700 701 750 692 696 720 722 717 752 700 701 750 692 696 720 722 717 752 700 701 751 691 696 720 722 717 588 510 520 550 512 517 533 522 513 164 190 181 201 179 179 187 200 204 To display filter monitor information on a port: switch:admin> perfshowfiltermonitor 2/5 There are 7 filter-based monitors defined on port 21.
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. There are only two commands that can modify the value of the EE mask: perfSetPortEEMask and perfCfgRestore.
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: on TxSID Area: on TxSID ALPA: on TxDID Domain: on TxDID Area: on TxDID ALPA: on RxSID Domain: on RxSID Area: on RxSID ALPA: on RxDID Domain: on RxDID Area: on RxDID ALPA: on See also perfAddEEMonitor perfDelEEMonitor perfSetPortEEMask Fabric OS 5.
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. In secure mode, this command exits with a warning and does not create PKI objects.
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.
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.
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. If the port is not an active FL_Port or if it does not have any AL_PA, this command displays an error.
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. If no port is specified, then the long-distance buffer information for all of the port groups of the switch is displayed.
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. Operands This command has the following operands: slotnumber For bladed systems only, specifies the slot number of the port group to display, followed by a slash (/).
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. DID used Total number of CAM entries used by this port.
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 0 0 0 64 512 1 0 0 64 512 2 0 0 64 512 3 0 0 64 512 4 0 0 64 512 5 0 0 64 512 6 0 0 64 512 7 0 0 64 512 8 0 0 63 511 DID free 9 0 0 63 511 10 0 0 63 511 11 1 1 63 511 12 0 0 46 510 13 0 0 46 510 14 0 0 46 510 15 18 2 46 510 ------------
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: action Possible action includes rscnsupr. rscnsupr is for the local port's RSCN suppression.
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 0 1 2 3 4 5 6 7 8 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 ON ON ON ON ON ON ON ON ON ON ON ON ON ON ON ON Long Distance .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. VC Link Init .. .. .. ..
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 0 1 2 3 4 5 6 7 8 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 ON ON ON ON ON ON ON ON ON ON ON ON ON ON ON ON Long Distance .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. VC Link Init .. .. .. .. .. .
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 0 1 2 3 4 5 6 7 8 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 ON ON ON ON ON ON ON ON ON ON ON ON ON ON ON ON Long Distance .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. VC Link Init .. .. .. .
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 portCfgShow command. Operands This command has the following operands: slotnumber For bladed systems only, specify the slot number of the port to display, followed by a slash (/).
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. When a port is configured as a non-E_Port through this command, an ISL connected to this port is segmented.
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. Changes made by this command are persistent across switch reboots or power cycles.
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 configure command for more information on the core PID format. ISL R_RDY mode sends ELP with Flow Control Mode 02 and enables connectivity with WAN gateway products.
See also portCfgShow 452 Fabric OS commands
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. The port can only be used as an F/FL/E_Port.
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 and switchShow displays the long-distance level.
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 portType: PRESENT LED 1.
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. The switch never attempts point-to-point (F_Port) initialization on the port.
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 0 1 2 3 4 5 6 7 8 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 ON ON ON ON ON ON ON ON ON ON ON ON ON ON ON ON Long Distance .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. VC Link Init .. .. .. .. .. .. .. .
Fabric OS commands
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.
See also ficoncupset ficoncupshow portCfgDefault portDisable portEnable portCfgPersistentEnable portShow switchShow 460 Fabric OS commands
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. A persistent port enable reenables all previously set port configurations of that port.
See also ficoncupset ficoncupshow ficoncupset ficoncupshow portDisable portDisable portEnable portCfgPersistentDisable portCfgShow portShow switchShow 462 Fabric OS commands
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 mode).
Operands This command has the following operands: slotnumber For bladed systems only, specifies the slot number of the port to display, followed by a slash (/). portnumber Specifies the port number to display, relative to its slot for bladed systems. Use switchShow to display a list of valid ports. This operand is optional; if omitted, this command displays information for all ports.
To display the configuration settings of a port: switch:user> portcfgshow 4/15 Area Number: 63 Speed Level: AUTO Trunk Port OFF Long Distance OFF VC Link Init OFF Locked L_Port OFF Locked G_Port OFF Disabled E_Port OFF ISL R_RDY Mode OFF RSCN Suppressed OFF Persistent Disable OFF See also portCfg portCfgEPort portCfgGPort portCfgLongDistance portCfgLPort portCfgSpeed portCfgTrunkPort Fabric OS 5.
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.
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 or switchCfgTrunk commands.
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: dbg_lvl Specify the debug level to be set for port modules; valid values are 1 to 5. vbs_lvl Specify the verbose level to be set for port modules; valid values are 1 to 5.
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. If the port was online before being disabled, a state transition will be indicated: RSCN, an SNMP trap, a Web pop-up window.
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.
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).
2: 154 152 0 0 0 0 0 1.9m 0 1 2 0 0 0 3: 154 153 0 0 0 0 0 1.9m 0 1 2 0 0 0 4: 0 0 0 0 0 0 0 12 0 0 0 1 0 0 5: 0 0 0 0 0 0 0 35 0 0 0 1 0 0 6: 0 0 0 0 0 0 0 0 0 0 0 1 0 0 7: 0 0 0 0 0 0 0 0 0 0 0 1 0 0 8: 0 0 0 0 0 0 0 0 0 0 0 1 0 0 9: 0 0 0 0 0 0 0 0 0 0 0 1 0 0 10: 0 0 0 0 0 0 0 0 0 0 0 1 0 0 11: 0 0 0 0 0 0 0 0 0 0 0 1 0 0 12: 154 153 0 0 0 0 0 2.
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. Flags Displays whether there is an SFP inserted in the port, whether the port is active, and the port type.
4 2 Online In_Sync PRESENT ACTIVE E_PORT G_PORT LOGIN LED ACCEPT 4 3 Online In_Sync PRESENT ACTIVE E_PORT G_PORT LOGIN LED ACCEPT 4 4 Offline No_Light PRESENT LED 4 5 Offline No_Light 4 6 Online In_Sync PRESENT ACTIVE F_PORT L_PORT LOGIN NOELP LED ACCEPT 4 7 Online In_Sync PRESENT ACTIVE F_PORT L_PORT LOGIN NOELP LED ACCEPT 4 8 Online In_Sync PRESENT ACTIVE E_PORT G_PORT LOGIN LED ACCEPT 4 9 Online In_Sync PRESENT ACTIVE E_PORT G_PORT LOGIN LED ACCEPT 4 10 Online In
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. The SPEED LEDs are set to green once the command is executing.
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. WARNING: port log is disabled If the port log is disabled, portLogClear enables it.
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.
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 portLogShow prompts the user to press Enter between each page. If the port log is disabled, the following message displays as the first line. See portLogClear command for more information.
switch:user> portLogDump 20 time task event port cmd args -----------------------------------------------------08:35:27.899 tShell pstate 14 OL1 08:35:27.899 tReceive pstate 14 LR2 08:35:27.916 tReceive pstate 14 AC 08:35:28.416 interrupt scn 14 1 08:35:28.433 tFabric ioctl 14 90 08:35:28.433 tFabric Tx 14 164 08:35:28.433 tReceive Rx 14 0 08:35:28.433 tReceive Rx 14 164 08:35:28.
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 portLogShowPort prompts the user to press Enter between each page. Port logs are circular log files in the switch firmware, which can save up to 8,192 entries.
08:35:28.433 tFabric ioctl 14 91 103646d8,0 08:35:28.466 tFabric ioctl 14 a7 3c,1 08:35:28.466 tFabric pstate 14 LR1 08:35:28.466 tReceive pstate 14 LR3 08:35:28.466 tReceive pstate 14 AC 08:35:28.483 tFabric Tx 14 96 08:35:28.483 tReceive Rx 14 0 08:35:28.483 tReceive Rx 14 96 08:35:28.483 tTransmit Tx 14 0 08:35:28.483 tFabric ioctl 14 a1 08:35:28.
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).
22 create 0 23 debug 1 24 nbrfsm 0 25 timer 0 26 sn 0 27 fcin 0 28 fcout 0 29 read 0 30 write 0 31 err 0 32 frame 0 33 msRemQ 0 34 msRemR 0 35 nsRemQ 0 36 nsRemR 0 37 rscn 0 38 state 0 39 xalloc 0 40 xfree 0 41 xerr 0 42 xstate 0 43 seq 0 44 seqst 0 45 iu 0 46 payload 0 47 zone 0 48 cmd 0 49 event 0 50 msg 0 51 switch 0 52 ficonq 0 53 routing 0 See also portLogTypeDisable portLogTypeEnable Fabric OS 5.
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: fe FLOGI, fabric login to fabric F_Port. ff PLOGI, process login to specific N_Ports or well-known address, such as name server. fd FDISC, virtual N_Port login.
Examples To display login information for port 23: switch:admin> portloginshow 23 Type PID world wide name credit df_sz cos ===================================================== fe 201700 21:00:00:e0:8b:05:a3:c9 3 2048 8 scr=1 ff 201700 21:00:00:e0:8b:05:a3:c9 0 0 8 d_id=FFFC20 ff 201700 21:00:00:e0:8b:05:a3:c9 0 0 8 d_id=FFFFFC See also fcpProbeShow portShow Fabric OS 5.
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: lvl Specify either 0 to clear the flag or 1 to set the debug_pdisc_flag.
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.
16 0 17 0 18 1 19 0 20 0 21 0 22 0 23 0 24 0 25 0 26 0 27 0 28 0 29 0 30 0 31 0 See also portLogEventShow portLogReset portLogTypeDisable portLogTypeEnable 488 Fabric OS commands
portLogReset Enables the port log facility. Synopsis portlogreset Availability admin Description Use this command to enable the port log facility. See portLogClear for events that might disable the port log facility. Operands none Examples To enable the port log: switch:admin> portlogreset See also portLogPortShow Fabric OS 5.
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: num_entries Specifies the number of entries to which portlog needs to be resized. The valid range of values is 8,192 to 16,384.
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. The portLogShow command displays the same information as portLogDump, but it enables you to 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. See portLogConfigShow to display the current port log size.
sn 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 err Information unit header log of an fc error frame frame fc frame payload nsRemQ Inter-switch name server query rscn RSCN xalloc Allocate an exchange xfree Free an exchange xerr Exchange error xstate Exchange state payload Frame payload Port Displays the
ctin Argument 0 is divided into two 16-bit fields: [A] 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]).
LIP reason LF1 Link Failure: NOS Transmit State LF2 Link Failure: NOS Receive State OL1 Offline: OLS Transmit State OL2 Offline: OLS Receive State OL3 Offline: Wait for OLS State 8001 Retry loop init 8002 Start loop after gaining sync 8003 Restart loop after port reset 8004 LIP when a loop hangs 8005 Restart loop if LIP received when sending out ARB(F0) 8006 LIP when an OPN returns 8007 Restart loop when LIPs received in OLD_PORT AC state 8008 Restart loop if loop not empty but E_P
Examples To view the port log for a port: switch:user> portLogShow 24 time task event port cmd args ------------------------------------------------17:05:30.384 PORT Rx 0 40 17:05:30.384 PORT Tx 0 0 17:05:30.384 PORT debug 0 17:05:30.389 PORT Rx 1 40 17:05:30.389 PORT Tx 1 0 17:05:30.389 PORT debug 1 17:05:30.504 PORT Rx 2 40 17:05:30.504 PORT Tx 2 0 17:05:30.504 PORT debug 2 17:05:30.507 PORT Rx 3 40 17:05:30.507 PORT Tx 3 0 17:05:30.
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 portLogDumpPort does not prompt the user to press Enter between each page of output.
08:35:28.483 tFabric Tx 14 96 08:35:28.483 tReceive Rx 14 0 08:35:28.483 tReceive Rx 14 96 08:35:28.483 tTransmit Tx 14 0 08:35:28.483 tFabric ioctl 14 a1 08:35:28.483 tFabric scn 14 5 02fffffd,00fffffd,0006ffff,11100060 c0fffffd,00fffffd,00060007 03fffffd,00fffffd,00060007,02100060 c0fffffd,00fffffd,00060007 0,0 (output truncated) See also portLogClear portLogShow upTime Fabric OS 5.
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. The values corresponding to different log types can be obtained by running portLogEventShow.
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. The values corresponding to different log types can be obtained by running portLogEventShow.
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. The path exercised in this test does not include the media or the fiber cable.
Operands This command has the following operands: --slot number Specify the slot number on which the diagnostic will operate. The ports specified will be relative to this slot number. The default is set to 0 and designed to operate on fixed-port-count products. -nframes count Specify the number of frames to send. The test will progress until the specified number of frames has been transmitted on each port. The default value is 10. -lb_mode mode Specify the loopback mode for the test.
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.
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. With no operands, the port names of all the ports present will be displayed.
portCfgDefault portShow 504 Fabric OS commands
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.
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. This is done by writing a pattern of 0x00000001 to register N. Read and ensure that the same pattern previously written is read back.
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 REGERR_UNRST See the HP StorageWorks Fabric OS 5.x diagnostics and system error messages reference guide for more information.
portRouteShow Displays routing tables for the specified port.
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 switchShow topologyShow uRouteShow Fabric OS 5.
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 Name assigned to the port by the command of the same name. portHealth Current health of the port (Fabric Watch license required).
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 Port failed diagnostics Lock_Ref Locking to the reference signal portScn Last state change notification for port.
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.
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 LOGICAL_ONLINE LOGIN portType: PRESENT ACTIVE E_PORT G_PORT U_PORT 10.
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. stat64_wrx Number of 4-byte words received. stat64_ftx Frames transmitted. stat64_frx Frames received.
Operands This command has the following operands: slotnumber For bladed systems only, specify the slot number of the port to be configured, followed by a slash (/). portnumber Specify a port number to be configured, relative to its slot for bladed systems. Use switchShow to display a list of valid ports.
er64_crc er64_trunc er64_toolong er_bad_eof er64_enc_out 0 top_int : Frames with CRC errors 0 bottom_int : Frames with CRC errors 0 top_int : Frames shorter than minimum 0 bottom_int : Frames shorter than minimum 0 top_int : Frames longer than maximum 0 bottom_int : Frames longer than maximum 0 top_int : Frames with bad end-of-frame 0 bottom_int : Frames with bad end-of-frame 0 top_int : Encoding error outside of frames 9131157 er64_disc_c3 bottom_int : Encoding error outside of fram
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.
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. stat_wtx 4-byte words transmitted. stat_wrx 4-byte words received. stat_ftx Frames transmitted. stat_frx Frames received.
fl_cls_rx CLS received when OPEN. fl_bb_stall OPN/CLS BB_Credit stalls. fl_cf_alloc Number of CFIFOs allocated. fl_cf_opn CFIFOs delivered when OPENED. fl_cf_full Number of CFIFOs full stalls. fl_cf_na CFIFO not available stalls. fl_trig_age Number of age count triggers. fl_trig_lp Number of loop not busy triggers. open Number of times the FL_Port entered OPEN state. transfer Number of times the FL_Port entered TRANSFER state. opened Number of times the FL_Port entered OPENED state.
tim_rdy_pri 1279213528 Time R_RDY high priority tim_txcrd_z 4 Time BB_credit zero er_enc_in 0 Encoding errors inside of frames er_crc 0 Frames with CRC errors er_trunc 0 Frames shorter than minimum er_toolong 0 Frames longer than maximum er_bad_eof 0 Frames with bad end-of-frame er_enc_out 8600353 Encoding error outside of frames er_disc_c3 0 Class 3 frames discarded open 16 loop_open transfer 16 loop_transfer opened 16 FL_Port opened starve_stop 0 tenancies stopped due
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 portSwap again on the same two ports.
See also portDisable portEnable portShow portSwapDisable portSwapEnable portSwapShow switchShow 522 Fabric OS commands
portSwapDisable Disables the portswap feature. Synopsis portswapdisable Availability admin Description Use this command to disable the portswap feature. The portSwap command cannot be used after this 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.
portSwapEnable Enables the portswap feature. Synopsis portswapenable Availability admin Description Use this command to enable the portswap feature. The portSwap command cannot be used unless the 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.
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.
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. Diagnostics can be executed every day or on demand.
Operands This command has the following operands: -ports itemlist Specify a list of user ports to test. By default, all the user ports in the switch are tested. See the itemList help pages for further details. -iteration count Specify the number of times (or number of frames per port) to execute this test. The default value is 20. Valid values include: 0 Run the test on timeout mode. -1 Run indefinitely. -userdelay time Specify the delay between frames sent by portTest, in milliseconds.
portTestShow Displays information from portTest. Synopsis porttestshow [-ports itemlist] Availability admin Description Use this command to display a snapshot of information from portTest.
Examples To display information from portTest: switch:admin> porttestshow 1 Port 1 : PASS PortType: OTHER PortState: NO TEST PortInternalState: INIT Pattern: 0x0 PortTypeToTest: NO_TEST Seed: 0x0 UserDelay: 0 TotalIteration: 0 CurrentIteration: 0 TotalFail: 0 ConsecutiveFail: 0 StartTime: NONE StopTime: Timeout: 0 NONE ErrorCode: 0 See also crossPortTest fportTest itemList loopPortTest portLoopbackTest portTest spinFab stopPortTest Fabric OS 5.
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.
Examples To modify the power-off list order: switch:admin> powerofflistSet Slot Current POL ------------------10 1st 9 2nd 8 3rd 7 4th 4 5th 3 6th 2 7th 1 8th 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 7th slot to be powered off: (7..
slotPowerOff slotPowerOn slotShow 532 Fabric OS commands
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. If there is less power available than the demand, then the power-off list is processed until there is enough power for the system to operate.
See also chassisShow powerOffListShow psShow slotPowerOff slotPowerOn slotShow 534 Fabric OS commands
psShow Displays power supply status. Synopsis psshow Availability all users Description Use this command to display the current status of the switch power supplies.
See also chassisShow fanShow 536 Fabric OS commands
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.
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.
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.
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 cfgSave command.
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; therefore, when removing multiple members, order is important.
See also qloopAdd qloopCreate qloopDelete qloopShow 542 Fabric OS commands
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. See cfgShow for a description of this display.
Examples To display all QuickLoops beginning with the letter “q”: switch:admin> qloopshow "q*" qloop: qlp1 qloop: qlp2 See also qloopAdd qloopCreate qloopDelete qloopRemove 544 Fabric OS commands 10:00:00:60:69:00:60:11 10:00:00:60:69:00:30:02 10:00:00:60:69:00:60:13
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.
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.
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.
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.
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 Description Use this command to FTP core files, to remove core files, or to list core files. With no arguments, saveCore enters interactive mode.
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.
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.
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.
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 6(or u): Un Mark Files for action 9(or e): Exit Your choice: m Enter File Number to mark: 1 Enter CR To Continue....
See also none 554 Fabric OS commands
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. NOTE: This command must be issued in secure mode.
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. If you are performing set or remove operations, when the command is completed new data is saved persistently.
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. Warning: Please use a secure channel for setting secrets. Using an insecure channel is not safe and can compromise secrets.
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... Done.
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). • Delete a CSR. • List the certificates present in the switch. • Display the contents of a certificate/CSR. • Delete a specific certificate. • Configure a SSL certificate file name.
Operands The operands are as follows: genkey Generates a public/private key pair.This is the first step for setting up 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. The keys are generated only after deleting existing CSR and all other certificates. gencsr Generates a new CSR for the switch. This is second step for setting up third-party certificates in the switch.
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: .csr Done To delete the CSR: switch:admin> seccertutil delcsr WARNING!!! About to delete the switch CSR.
To display contents of a certificate: switch:admin> seccertutil show certificate file name See also none 562 Fabric OS commands
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. NOTE: This command must be issued in secure mode.
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. WWN Displays the world wide name of the switch. DId Displays the domain of the switch. Status Displays the security state of the switch: Ready – This switch is in a stable state.
See also secPolicyDump secPolicyShow Fabric OS 5.
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.
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.
secHelp Displays information about security commands. Synopsis sechelp Availability all users Description Use this command to display a list of security commands.
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 certificates Creates/Manages/Displays third party PKI secDefineSize Displays size of the defined (security) database secFabricShow Displays security related fabric informati
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 To disable security mode: primaryfcs:admin> secmodedisable Please enter current admin account password: Warning!!! About to disable security.
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.
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. NOTE: Using Fabric OS CLI or Web Tools, ensure that all users are logged off the fabric before enabling secure mode; otherwise, users on non-FCS switches lose their telnet sessions. HP recommends that a maximum of 80 WWNs be specified in the FCS policy using the command.
This option is a shorthand notation for a combination of the --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.
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, which you may review at http://www.switchkeyactivation.com/cps.
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: proper Access to support passwords are of the Root and Factory accounts may be required the switch.
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. By using these security features, you are consenting to be bound by the terms of these documents.
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.
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. All non-FCS switches that join the fabric in the future inherit this new password.
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 To abort all changes that have not been saved to flash memory: primaryfcs:admin> secpolicyabort Unsaved data has been aborted.
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.
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. The list of members of a policy acts as an access control list for that management method. When security is first enabled using the command, only the FCS_POLICY exists.
Operands This command has the following operands: name Specify the name of an existing policy to which you want to add members. Valid values 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 SCC_POLICY OPTIONS_POLICY The specified policy name must be capitalized.
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. If domain ID, or switch names are used, the switches associated must be present in the fabric or the command fails.
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.
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. You can add members to a policy later, using the secPolicyAdd command. Each policy corresponds to a management method.
Operands This command has the following operands: name Specify the name of a policy you want to create. Valid values for this operand 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 • SCC_POLICY • OPTIONS_POLICY The specified policy name must be capitalized. The DCC_POLICY_nnn name has the common prefix DCC_POLICY_ followed by a string of user-defined characters.
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. DCC_POLICY Members The DCC_Policy_nnn is a list of devices associated with a specific switch and port combination.
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.
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. When security mode is first enabled using the command, only the FCS_POLICY exists.
Operands This command has the following operand: Specify the name of a security policy to delete. The policy name must be enclosed in quotation marks. Valid security policy names are: name 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 SCC_POLICY OPTIONS_POLICY The specified policy name must be capitalized.
secPolicyRemove secPolicySave secStatsShow Fabric OS 5.
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: listtype Specify which database to display.
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 Pos Primary WWN DId swName __________________________________________________ 1 Yes 10:00:00:60:69:30:15:5c 1 primaryfcs HTTP_POLICY IpAddr __________________________________________________ 192.155.52.
See also secPolicyAbort secPolicyActivate secPolicyAdd secPolicyCreate secPolicyDelete secPolicyRemove secPolicySave secStatsShow 594 Fabric OS commands
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.
Examples To move the backup FCS switch at position 2 to position 3 in the FCS list: switch:admin> secpolicyfcsmove Pos Primary WWN DId swName. ================================================= 1 Yes 10:00:00:60:69:10:02:18 1 switch5. 2 No 10:00:00:60:69:00:00:5a 2 switch60. 3 No 10:00:00:60:69:00:00:13 3 switch73. Please enter position you'd like to move from Please enter position you'd like to move to : (1..3) [1] 2 : (1..
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). You cannot remove all members from FCS_POLICY, and you cannot remove the FCS members from SCC_POLICY.
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.
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.
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 To save new policy set in all switches in the fabric: switch:admin> secpolicysave secpolicysave command was completed successfully.
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. You can specify to display a security policy by name. If no name is specified, all policies are displayed.
The specified policy name must be capitalized. The 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.
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. Fabric OS 5.
Operands This command has the following operands: name Specify the name of a security statistic you would like to reset. If executed on the primary FCS, specify an asterisk (*) to represent all security policies.
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. See also secFabricShow secStatsShow Fabric OS 5.
t 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. NOTE: This command displays security policy statistics in secure mode. In nonsecure mode, it only reports login statistics.
Operands This command has the following operands: name Specify the name of a security statistic you would like to view. If executed on the primary FCS, specify an asterisk (*) to represent all security policies.
Examples To display the MS_POLICY statistics on the local switch: switch:admin> secstatsshow "MS_POLICY" Name Value ==================== MS 20 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 ========================================= TELNET_POLICY 0 Domain 69: Name Value ========================================= TELNET_POLICY 0 Domain 70:
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. If the domain is also not supplied, all temporary passwords for all login levels are removed from every switch in the fabric.
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). Root and factory accounts on domain 2 have been disabled.
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 secTempPasswdReset command to remove the temporary password or reboot the switch. You can change any password on any switch.
See also passwd secModeDisable secModeShow secNonFcsPasswd secTempPasswdReset 612 Fabric OS commands
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. NOTE: This command can be issued from any switch in secure mode. Operands none Examples To abort the current security transaction: switch:admin> sectransabort Transaction has been aborted.
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: 1. Determine which secure fabric will become the FCS_POLICY controller fabric: the dominant fabric to which all other secure fabrics will be merged. 2.
t 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.
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. Operands This command has the following operands: module_name Specify the name of the module for which you want to view the debug and verbosity levels. Module names are case sensitive.
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. It does not require a reboot to take effect. ESD mode modifies the behavior of the diagnostic test methods and post scripts.
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. The mode is saved in flash memory and stays in that mode until the next execution of setMediaMode, setSfpMode, or setGbicMode. The mode becomes active as soon as this command is executed.
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. The mode is saved in flash memory and stays in that mode until the next execution of setMediaMode, setSfpMode, or setGbicMode. The mode becomes active as soon as this command is executed.
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. When modem dial-in is disabled, the modem attached to the CP does not accept the calls.
See the hardware reference manual for your platform for complete modem installation instructions.
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. The mode is saved in flash memory and stays in that mode until the next execution of setMediaMode, setSfpMode, or setGbicMode. The mode becomes active as soon as this command is executed.
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. It does not require a reboot to take effect.
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: module_name Specify the name of the module for which verbose level is to be set; module names are case sensitive.
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. NOTE: SFPs are polled by a background process. The sfpShow command retrieves the latest information from cache.
Examples To display SFP summary information: switch:user> sfpshow Area 0: id (id) Vendor: Area 1: id (sw) Vendor: FINISAR CORP. Serial No: Serial No: H1149T2 Area 2: id (sw) Vendor: FINISAR CORP. Serial No: H112TUD Area 3: id (sw) Vendor: FINISAR CORP.
To display detailed SFP information for a Finisar smart SFP: switch:user> sfpshow 1/3 Identifier: 3 SFP Connector: 7 LC Transceiver: 050c402000000000 100,200_MB/s M5,M6 sw Inter_dist Encoding: 1 8B10B Baud Rate: 21 (units 100 megabaud) Length 9u: 0 (units 100 meters) Length 50u: 30 (units 10 meters) Length 62.5u: 15 Length Cu: 0 (units 10 meters) (units 1 meter) Vendor Name: FINISAR CORP. Vendor OUI: 00:90:65 Vendor PN: FTRJ-8519-7D-2.
To display all SPF information: switch:user> sfpshow -all ============= Port 0: ============= Identifier: 3 SFP Connector: 7 LC Transceiver: 050c402000000000 100,200_MB/s M5,M6 sw Inter_dist Encoding: 1 8B10B Baud Rate: 21 (units 100 megabaud) Length 9u: 0 (units km) Length 9u: 0 (units 100 meters) Length 50u: 30 (units 10 meters) Length 62.
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. This command cannot run from a telnet session.
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. This command cannot run from a telnet session.
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 bladeDisable command, which only disables external ports. Unlike ports affected by bladeDisable, ports on a slot disabled by this command are not re-enabled after switchEnable, switchStart, or switchReboot.
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: slotnumber Specify the slot number of the blade to enable. This operand is required. Examples To power on blade unit 3: switch:admin> sloton 3 Slot 3 is being enabled.
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: slotnumber Specify the slot number of the blade to disable. This operand is required.
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 slotShow command reports such slots as being in the state of INSERTED, NOT POWERED ON. Operands This command has the following operand: slotnumber Specify the slot number of the blade to enable. This operand is required.
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. Blade Type Displays the blade type: • SW BLADE—The blade is a switch. • CP BLADE—The blade is a control processor.
Examples To display a blade inventory and status: switch:admin> slotshow Slot Blade Type ID Status --------------------------------1 SW BLADE 2 FAULTY 2 SW BLADE 2 DISABLED 3 SW BLADE 2 ENABLED 4 SW BLADE 2 DIAG RUNNING POST2 5 CP BLADE 1 ENABLED (User Ports Disabled) 6 CP BLADE 1 ENABLED 7 UNKNOWN 8 SW BLADE 2 DIAG RUNNING POST1 9 SW BLADE 2 INSERTED, NOT POWERED ON 10 UNKNOWN See also bladeDisable bladeEnable chassisShow slotOff slotOn slotPowerOff slotPowerOn 636
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. The loopback is done at the parallel and serial loopback paths.
-duration count Specifies the duration, in milliseconds, to perform this test on the primitive. The default value is 100. --ports itemlist Specifies a list of blade ports to test. By default all the blade ports in the specified slot (--slot) is used. See itemList for further details. Examples To test the serial link of the following port path: switch:admin> sltest -ports 0/5-0/31 -speed 4 -lb_mode 1 passcnt 1 Running Port sltest .... passed.
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.
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: 0 None 1 Critical 2 Error 3 Warning 4 Informational 5 Debug SNMPv3 configuration parameters Two user roles, snmpadmin and snmpuser, are supported. snmpadmin provides read-write access and snmpuser provides read-only access. Entries are added to USM table corresponding to each role.
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. Host-subnet-area is defined by comparing nonzero IP octets. For example, an ACL of 192.168.64.0 enables access by any host that starts with the specified octets.
systemGroup configuration parameters sysDescr System description. The default value is Fibre Channel Switch. sysLocation Location of the system (switch). The default value is End User Premise. sysContact Contact information for this system (switch). The default value is set as Field Support. See the definition of sysDescr, sysLocation, and sysContact in system group of MIB-II.
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] Trap Recipient's IP address in dot notation: [10.32.225.
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: Verify Auth Passwd: Priv Protocol [DES(1)/noPriv[2]): (1..
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.
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 See also agtCfgDefault agtCfgSet agtCfgShow snmpMibCapSet snmpMibCapShow SW_v5_x.
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. FA-MIB Specifying yes means the user can access FA-MIB variables with an SNMP manager.
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] swFCPortScn (yes, y, no, n): [yes] swEventTrap (yes, y, no, n)
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. FA-MIB Specifying yes means the user can access FA-MIB variables with an SNMP manager. The default value is yes. FICON-MIB Specifying yes means the user can access FICON-MIB variables with an SNMP manager. The default value is yes.
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 agtCfgDefault agtCfgSet agtCfgShow snmpConfig 650 Fabric OS commands
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.
Operands This command has the following operands: -nmegs count Specify in millions the number of frames to send. The test will progress 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. -ports itemlist Specify a list of user ports to test.
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.
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 spinSilk but with a special pattern for line-speed jitter 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.
For -lb_mode set to 0,1, the following speed modes are available to test the speed negotiation. 3 Set all even ports' speed for autonegotiate. Set all odd ports' speed for 1 Gb/s. 4 Set all even ports' speed for autonegotiate. Set all odd ports' speed for 2Gb/s. 5 Set all odd ports' speed for autonegotiate. Set all even ports' speed for 1 Gb/s. 6 Set all odd ports' speed for autonegotiate. Set all even ports' speed for 2 Gb/s.
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 MBUF_STATUS_ERR NO_SEGMENT PORT_ABSENT
See also backport camTest centralMemoryTest cmemRetentionTest cmiTest crossPortTest itemList portLoopbackTest portRegTest spinSilk sramRetentionTest Fabric OS 5.
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. Likewise, frames received by port N are retransmitted by way of port M.
• 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 5. Periodically check the following: a. No port has died. b. Each port's frames-transmitted counter is still incrementing. c.
-spd_mode mode Specify the speed mode for the test. This parameter is used only for Bloom and 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. When speed modes 5 through 8 are used with cables, they must be connected EVEN to ODD or the test will fail. 0 Run test at 1 Gb/sec, 2 Gb/sec, and 4 Gb/sec. 1 Run test at 1 Gb/sec.
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.
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.
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.
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.
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: --slot slotnumber Specifies the slot on which to operate. If this option is not specified, the default slot is assumed.
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.
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 Fabric OS 5.
stopPortTest Terminates the running portTest. Synopsis stopporttest [-ports itemlist] Availability admin Description Use this command to stop the currently running portTest. See the portTest command for more information. If portTest is running in nonsingle mode, use stopporttest to stop the test. Operands The command has the following operands: -ports itemlist Specify a list of user ports to test. By default, all the user ports in the switch are tested. See itemList help pages for further details.
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. NOTE: If there is no parameter specified, this command defaults to supportFtp -S.
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.
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 supportShow information and other support information to a remote FTP location. On a dual-CP system, only the local CP information is saved and supportShow information is not available on the active CP. If no operands are specified, this command enters interactive mode.
Examples To save RASLOG, TRACE, and supportShow information to an FTP server in non-interactive mode: 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: 566.47 B/s 1.66 kB Saving support information for module TRACE... ...ortSave_files/switch-S5-200405200010-tracedump.dmp: 848.00 kB/s 10.00 MB Saving support information for module SUPPORTSHOW... ...
supportShow traceDump traceFtp traceTrig Fabric OS 5.
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.
• 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) • authUtil • secFabricShow • secGlobalShow • secModeShow • secStatsShow • network (ENABLED by default) • bootenv • df • ifconfig • route • hostname • portlog (ENABLED by default) • portLogDump • system (ENABLED by default) • myId • versi
• portErrShow • fwSamShow • agtCfgShow • slotShow (product-dependent) • emtraceshow • emtraceshow2 • emhsmtraceshow • systraceshow -d • fwAlarmsFilterShow • chassisShow • timeout • historyShow • portSwapShow • configShow • extend (DISABLED by default) • buffers (per-port) • credits (per-port) • data (per-port) • phantom (per-port) • properties (per-port) • statistics (per-port) • filter (DISABLED by default; this group has lengthy output) • filterportshow (per-port) • perfmon (DISABLED by default) • ps_dump
Specifies the number of lines of portLogDump output to display. If this parameter used, the slotnumber/portnumber parameter is required. lines 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: Thu Jan 17 00:06:52 2003 BootProm: 3.2.1 uptime: 10:49am up 3:25, 1 user, load average: 1.55, 1.20, 1.
See also supportFtp supportSave supportShowCfgDisable supportShowCfgEnable supportShowCfgShow traceDump traceFtp traceTrig 678 Fabric OS commands
supportShowCfgDisable Disables a group of commands under the supportShow command. 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 supportShow command. Use the supportShowCfgEnable command to enable groups of commands. See ”supportShow reference” on page 789, for more information.
supportShowCfgEnable Enables a group of commands under the supportShow command. 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 supportShow command. Use the supportShowCfgDisable command to disable groups of commands. See ”supportShow reference” on page 789, for more information.
supportShowCfgShow Displays the groups of commands enabled for display by the supportShow command. Synopsis supportshowcfgshow Availability all users Description Use this command to display the groups of commands enabled for display by the supportShow command. Use the supportShowCfgEnable and the supportShowCfgDisable commands to modify which groups are displayed. See ”supportShow reference” on page 789, for more information.
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. The pattern continues until the user turns it off. This can be used to beckon the user to a failing unit, for example. Beaconing mode affects only the port LEDs.
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. The disable process can be observed and verified by watching the front panel LEDs change to slow flashing yellow as each port is disabled.
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. The switch might need to be enabled if it was previously disabled to make configuration changes or to run diagnostics.
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.
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 or switchCfgTrunk commands.
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 or configDefault) or before running many of the diagnostic tests. All commands that require the switch to be disabled send an error if invoked while the switch is enabled.
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 switchEnable if you disable the switch to make configuration changes or to run diagnostics. If the switch is connected to a fabric, it rejoins the fabric. When this command is issued, the 10-second fabric stability countdown is displayed.
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. Use this command with the name operand to assign a new switch name.
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 switchShutdown and switchStart. NOTE: This command is not supported on single-domain systems. Operands none Examples To reboot an operational switch: switch:admin> switchreboot Stopping all switch daemons...Done. Powering off slot 1...Done.
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: switchName Displays the switch symbolic name. switchType Displays the switch model number. switchState Displays the switch state: online, offline, testing, or faulty.
Port State comment 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. Port_Flt Port marked faulty. Diag_Flt Port failed diagnostics. Lock_Ref Locking to the reference signal. Testing Running diagnostics.
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.
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.
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.
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.
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 2 1 Temperatures 2 1 Fans 2 1 WWN 0 1 CP 0 1 Blade 0 1 Flash 0 1 MarginalPorts 2 1 FaultyPorts 2 1 MissingSFPs 0 0 Note that the value, 0, for a parameter, means that it is NOT used in the calculation.
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. The command displays the current parameters in a three-column format, shown in Table 19.
Examples To display the switch policies: switch:admin> switchstatuspolicyshow The current overall switch status policy parameters: Down Marginal ---------------------------------PowerSupplies 2 1 Temperatures 2 1 Fans 2 1 WWN 0 1 CP 0 1 Blade 0 1 Flash 0 1 MarginalPorts 2 1 FaultyPorts 2 1 MissingSFPs 0 0 See also switchStatusPolicySet switchStatusShow Fabric OS 5.
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.
Examples To display a switch health report: switch:user> switchstatusshow Switch Health Report 10:48:31 AM Report time: 06/19/2003 Switch Name: switch IP address: 10.10.255.
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.
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.
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.
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: ip_address Specify the IP address of the server running syslogd. This operand is required. Examples To remove the address 192.168.1.60 from the list of machines to which system messages are sent: switch:admin> syslogdipremove 192.168.1.
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 syslog.IP.address.3: 192.168.2.
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. The optional -fru and -unit parameters allow you to focus the testing to a single blade in a multiblade system.
Use to focus testing on a single FRU in the system. The id for a FRU type of BLADE correlates to the slot number of the FRU to be tested. -unit id Diagnostics Each diagnostic test in this suit might report its own set of error messages when it detects failures. See the “Diagnostics” section of individual diagnostic test help pages. These messages are available only in the log file. See the HP StorageWorks Fabric OS 5.x diagnostics and system error messages reference guide for more information.
See also burninErrClear burninStatus diagSetBurnin diagSetCycle Fabric OS 5.
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. See the hardware reference manual for your switch to determine the normal temperature range.
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. Use this command with the timeval operand to set the login timeout value to the specified interval. A value of 0 disables timeout functionality of login sessions.
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. • For each path cost, the number of hops from the local switch to the destination switch and a summary of all ports are routed through that path.
Examples To display the unicast fabric topology: switch:admin> topologyshow 2 domains in the fabric; Local Domain ID: 1 Domain: 6 Metric: 500 Name: switch Path Count: 4 Hops: 1 Out Port: 60 In Ports: None Total Bandwidth: 2 Gbps Bandwidth Demand: 0 % Flags: D Hops: Out Port: In Ports: Total Bandwidth: Bandwidth Demand: Flags: 1 61 None 2 Gbps 0 % D Hops: Out Port: In Ports: Total Bandwidth: Bandwidth Demand: Flags: 1 62 None 2 Gbps 0 % D Hops: Out Port: In Ports: Total Bandwidth: Bandwidth Demand: Flags
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. NOTE: If there is no parameter specified, this command defaults to traceDump -S. The default remote file name format is chassisname-S#-YYYYMMDDHHMMSS.
traceFtp traceTrig Fabric OS 5.
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. NOTE: If there is no parameter specified, this command defaults to traceFtp -S.
-s slot Specifies the slot number from which a trace dump is 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. -u username Specifies the FTP user name. username should be less than 48 characters. -p password Specifies the FTP user password. If the user name is anonymous, the password is not needed. password should be less than 48 characters.
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. Operands This command has the following mutually exclusive operands: -S Displays trace triggers for the specified slot.
To remove all trace triggers: switch:admin> tracetrig -R all trace triggers are removed See also supportFtp supportSave supportShow traceFtp traceFtp Fabric OS 5.
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.
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 • Config file change from task • Track changes on • Track changes off The output from the track-changes feature is dumped to the error log for the switch.
See also agtCfgSet agtCfgShow trackChangesHelp trackChangesShow 722 Fabric OS commands
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 errModuleShow command to view the error log.
trunkDebug Debugs a trunk link failure. Synopsis trunkdebug port1 port2 Availability admin Description Use this command to debug a trunk link failure.
See also portCfgTrunkPort switchCfgTrunk trunkShow Fabric OS 5.
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. WWN Displays the WWN of the connected port.
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.
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> tsclockserver 123.123.123.
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. All switches are by default in the 0,0 time zone: that is, GMT.
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.
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 portRegTest and sramRetentionTest using PCI operations but for this test, the BIST controller is able to perform the SRAM write and read operations at a much faster rate.
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.
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.
Operands This command has the following operands:--slot slotnumber Specifies the slot number that the diagnostic will operate on. The ports specified will be relative to this slot number. The default is set to 0 and designed to operate on fixed-port-count products. -nmegs count Specifies the number of frames to send in millions. The test progresses until the specified number of frames transmits on each port. The default value is 10, which represents 10 million frames.
--nonstop mode Specify nonstop mode. If set to a nonzero value, the test does not stop on the first error. The default value is 0. -ports itemlist Specify a list of user ports to test. By default, all of the user ports in the current switch are tested. This option might be used to restrict testing to the specified ports. Examples To run the txdPath test: switch:admin> txdpath Running TX Data Path Test .... Test Complete: "txdpath" Pass 10 of 10 Duration 0 hr, 0 min & 47 sec (0:0:47:645).
upTime Displays length of time the system has been operational. Synopsis uptime Availability all users Description upTime provides a one line display of the following information. The current time, how long the system has been running, how many users are currently logged on, and the system load averages for the past 1, 5, and 15 minutes. For up and powered-on times less than 60 seconds, the time is displayed in seconds. For times greater than or equal to 60 seconds, the time is displayed in minutes.
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.
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.
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. If DLS is not set, the route remains as is, with its route attribute changed from static to dynamic.
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. The following information appears: Local Domain ID Domain number of local switch.
portnumber Specify a port number. Valid values for port number vary, depending on the switch type. Use switchShow to display a list of valid ports. This operand is optional; if omitted, the command displays routing information for all input ports in the switch. domainnumber Displays routing information for the specified domain. This operand is optional; if omitted, the routing information for all domains in the fabric is displayed.
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. When the command completes, account name and other attributes are saved persistently.
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. The following table lists the result of different combination of options.
--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. The following rules apply to change an account: 1.
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: • new_username must begin with a letter and contain only alphanumeric characters or underscores. • new_username must be between 1 and 40 characters long. • new_username must be different from any existing account login name.
version Displays firmware version information. Synopsis version Availability all users Description Use this command to display firmware version information and build dates.
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.
Examples To display the voltage levels on a system: switch:admin> voltshow FRU TYPE - Number 1.8/1.2V 2.5V 3.3V 5V 12V 48V 53V ---------------------------------------------------------------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 -- -- CP BLADE Slot: 6 -- 2.50 3.29 5.17 12.50 -- -- SW BLADE Slot: 8 1.80 2.52 3.30 -- 12.00 -- -- SW BLADE Slot: 9 1.80 2.51 3.
wwn Displays a switch world wide name (WWN). Synopsis wwn Availability all users Description Use this command to display the WWN of a switch. All switches have a numeric address that is the unique Fibre Channel address used for communicating with the switch. The WWN appears in the output of the switchShow command. NOTE: When security mode is enabled, this command can be issued only from the primary FCS switch.
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. For the change to be preserved across switch reboots, it must be saved to flash memory using the cfgSave command.
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.
This command changes the defined configuration. For the change to be preserved across switch reboots, it must be saved to flash memory using the cfgSave command. For the change to become effective, an appropriate zone configuration must be enabled using the cfgEnable command. NOTE: Use this command to create a broadcast zone. This is a special zone used to specify those nodes that can receive broadcast traffic. Broadcast traffic is usually meant for servers and not for storage devices.
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 cfgSave command.
zoneHelp Displays help information for zone commands. Synopsis zonehelp Availability all users Description Use this command to display help information for zone commands.
cfgDisable cfgEnable cfgSize cfgTransAbort faZoneAdd faZoneCreate faZoneDelete faZoneShow Fabric OS 5.
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. You can use this command for all zone object types, including cfg, zone, and alias.
See also cfgAdd cfgClear cfgDelete cfgDisable cfgEnable cfgRemove cfgSave cfgShow zoneObjectRename Fabric OS 5.
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. Afterwards, this object is completely removed from the database.
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; 21:00:00:20:37:0c:71:df switch:admin> zoneObjectExpunge "White_zone" switch:admin> cfgShow
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.
See also cfgAdd cfgClear cfgDelete cfgDisable cfgEnable cfgRemove cfgSave cfgShow zoneObjectCopy Fabric OS 5.
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; therefore, it is important to maintain the order when removing multiple members.
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.
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. See cfgShow for a description of this display.
See also zoneAdd zoneCreate zoneDelete zoneRemove Fabric OS 5.
Fabric OS commands
3 Licensed product commands This chapter summarizes the commands that are available only with a license key.
Table 20 Zoning commands (continued) Command Description cfgCreate Creates a zone configuration. cfgDelete Deletes a zone configuration. cfgRemove Removes a zone from a zone configuration. Zone Management cfgClear Clears all zone configurations. cfgDisable Disables a zone configuration. cfgEnable Enables a zone configuration. cfgSave Saves zone configurations in flash memory. cfgTransAbort Aborts the current zoning transaction. zoneObjectCopy Copies a zone object.
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 portCfgLongDistance Configure a port to support long-distance links. Fabric Watch commands The commands listed in Table 23 are available with the purchase of an HP Fabric Watch license key. Table 23 Fabric watch commands Command Description fwClassInit Initialize all classes under Fabric Watch.
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 perfAddEEMonitor Add an end-to-end monitor to a port. perfAddIPMonitor Add an IP monitor to a port. perfAddReadMonitor Add a SCSI Read monitor to a port. perfAddRWMonitor Add a SCSI Read and Write monitor to a port. perfAddSCSIMonitor Add a SCSI traffic frame monitor to a port.
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 secFabricShow Displays security related fabric information. secFCSFailover Enables a backup FCS switch to take over as primary FCS switch. secHelp Display information about security telnet commands. Enable security mode.
Licensed product commands
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 (continued) Command Notes 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. faZoneShow Must be run from the primary FCS switch. msConfigure Can be run on all switches, but it does not display ACL in secure mode. msPlMgmtDeactivate Must be run from the primary FCS switch.
Table 27 Commands exclusive to the primary FCS (continued) Command Notes secVersionReset Must be run from the primary FCS switch. Can also be run on a single non-FCS switch which is segmented from a fabric. tsClockServer Can be run on all switches to view the NTP server's IP address. You can only modify the NTP server's IP address on the primary FCS switch. wwn This command can be run on all switches to view the WWN. With security enabled the WWN of a switch cannot be modified.
Exclusive primary FCS commands
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.
Table 28 switchAdmin commands (continued) Command Description chassisShow Displays all field replaceable units (FRUs). chipRegShow Displays the port registers for a given chip number. cmemRetentionTest Tests the data retention of the central memory SRAMs. cmiTest Verifies the control message interface (CMI) bus between ASICs. configShow Displays system configuration settings. configDownload Downloads a switch configuration file from a host file, omitting zoning and security configurations.
Table 28 switchAdmin commands (continued) Command Description fabricPrincipal Sets principal switch selection mode. fabricShow Displays fabric membership information. fabStateClear Clears the fabric state information. fabStateResize Changes the number of state entries. fabStateShow Displays the fabric state information. fabStatsShow Displays the fabric statistics. fabSwitchShow Displays the fabric switch state structure information. fanShow Displays fan status and speed.
Table 28 switchAdmin commands (continued) Command Description firmwareShow Displays the Fabric OS versions on both partitions of the local and remote CPs. fportTest Functional test of F->N, N->F point-to-point path. fruReplace Interactive interface to replace a field replaceable unit (FRU). fspfShow Displays Fabric Shortest Path First (FSPF) protocol information. fwHelp Displays Fabric Watch command information. h Displays shell history. help Displays help information for commands.
Table 28 switchAdmin commands (continued) Command Description licenseShow Displays current license keys. linkCost Sets or displays the fabric shortest path first (FSPF) cost of a link. login Logs in as new user. logout Logs out from a telnet, rlogin, or serial port session. lSDbShow Displays the Fabric Shortest Path First (FSPF) link state database. memShow Displays the amounts of free and used memory in a switch. minisPropShow Displays ASIC pair properties.
Table 28 switchAdmin commands (continued) Command Description nsZoneMember Displays the information of all the online devices zoned with the given device. passwd Changes the password for a user level. pathInfo Display routing and statistics information along a path, covering multiple switches. pdShow Displays data from a panic dump file. perfHelp Displays performance monitoring help information. pkiCreate Creates public key infrastructure (PKI) objects.
Table 28 switchAdmin commands (continued) Command Description portErrShow Displays port error summary. portFlagsShow Displays the port status bitmaps for all ports in a switch. portLogClear Clears the port log. portLogConfigShow Displays the current port log configuration. portLogDump Displays the port log without page breaks. portLogDumpPort Displays the port log of specified port, without page breaks. portLogEventShow Displays information about port log events.
Table 28 switchAdmin commands (continued) Command Description qloopAdd Adds a member to a QuickLoop. qloopCreate Creates a QuickLoop. qloopDelete Deletes a QuickLoop. qloopRemove Removes a member from a QuickLoop. qloopShow Displays QuickLoop information. quietMode Sets or clears the telnet session quiet mode, or displays the current mode. reboot Reboots either one control processor (CP) or the entire system. routeHelp Displays a list of FSPF-related commands.
Table 28 switchAdmin commands (continued) Command Description snmpMibCapShow Displays options for configuring SNMP MIB trap capability. supportShow Displays switch information for debugging purposes. supportShowCfgDisable Disables a group of commands under the supportShow command. supportShowCfgEnable Enables a group of commands under the supportShow command. supportShowCfgShow Displays the groups of commands enabled for display by the supportShow command.
Table 28 switchAdmin commands (continued) Command Description traceTrig Sets, removes, or displays trace triggers. trackChangesHelp Displays information on track-changes feature commands. trunkDebug Debugs a trunk link failure. trunkShow Displays trunking information. tsClockServer Displays or sets the NTP Server address. tsTimeZone Displays or sets the system time zone. upTime Displays how long the switch has been up. uRouteConfig Configures a static route.
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. This guarantees that any commands you execute are run on the desired logical switch.
Table 29 Commands supported on the standby CP (continued) Command Description itemList Lists parameter syntax information. killTelnet Terminate telnet/serial login sessions interactively. memShow Display memory usage in the system. myId Display the current login session details. pdShow Display information from panic dump file. reboot Reboot the standby CP. saveCore FTP or remove core files generated by daemons. switchName Print this switch's name. tsTimeZone Display time zone.
7 supportShow reference This chapter explains the information displayed by the supportShow command. This chapter has the following sections: • supportShow control commands, page 789 • supportShow command groups, page 789 • Proc entry information displayed, page 792 supportShow control commands The supportShow command is used to display support information by executing groups of preselected Fabric OS and Linux commands.
Table 30 supportShow command groups (continued) Command group Fabric OS 3.2.0 Fabric OS 4.4.
Table 30 supportShow command groups (continued) Command group Fabric OS 3.2.0 Fabric OS 4.4.
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.
Table 31 proc entry information displayed (continued) Proc display command /proc/interrupts Proc example display /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 14: 0 IBM UIC Level OCP EMAC RX DE 26: 52017 IBM UIC Level bloom 30: 1060300 IBM UIC Level ide0 FIT: 0 PIT: 15879069 BAD: 0 /proc/m
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). IRQ 30. Master Capable. Latency=64. Min Gnt=2.Max Lat=4. I/O at 0x1008 [0x100f]. I/O at 0x1000 [0x1003]. I/O at 0x2000 [0x2007].
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.
supportShow reference
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. AL_PA Arbitrated-loop physical address. A unique 8-bit value assigned during loop initialization to a port in an arbitrated loop. AL_TIME Arbitrated-loop timeout value.
autocommit A feature of the firmwareDownload command. Enabled by default, autocommit commits new firmware to both partitions of a control processor. autoreboot Refers to the -b option of the firmwareDownload command. Enabled by default. AW_TOV Arbitration wait timeout value. The minimum time an arbitrating L_Port waits for a response before beginning loop initialization.
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. CDR Clock and data recovery circuitry. CE Conformité Européenne. CFG Configuration. CFN Change fabric name. Refers to an ELS field that appears in portLogDump command output.
configuration (1) A set of parameters that can be modified to fine-tune the operation of a switch. Use the configShow command to view the current configuration of your switch. 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. See also zone configuration. congestion The realization of the potential of oversubscription.
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. Neutral disparity means an equal number of each, positive disparity means a majority of 1s, and negative disparity means a majority of 0s. DLS Dynamic load-sharing.
end-to-end flow control Governs flow of Class 1 and 2 frames between N_Ports. See also EE_Credit. entry fabric The basic HP software license that allows one E_Port per switch. EOF 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). See also loop failure. EVMd Event management database. Delivers FDMI-related events.
FAN 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. Represents physical media. FC-1 Layer of Fibre Channel transport that contains the 8b/10b encoding scheme.
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 Service The HP Multiprotocol SAN Routing Service that enables SANs to span longer distances than could be supported with native Fibre Channel links.
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. Fibre Channel transport A protocol service that supports communication between Fibre Channel service providers.
FSP 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. FSS 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.
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. hot swappable A hot swappable component can be replaced under power. HTTP Hypertext Transfer Protocol. The standard TCP/IP transfer protocol used on the World Wide Web.
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 Service The HP multiprotocol SAN routing service that maps the FCP protocol to the IP transport. This service projects iSCSI hosts onto the backbone fabric of a gateway switch. ISL Interswitch link.
Link Services A protocol for link-related actions. LIP 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. LIRP Loop-initialization report position frame. The first frame transmitted in the loop initialization process after all L_Ports have selected an AL_PA.
LRR 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. The path between devices in an LSAN can be local to a fabric or cross one or more FC routers and one or more backbone fabrics.
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).
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. Ordered sets are used to differentiate Fibre Channel control information from data frames and to manage frame transport. originator The Nx_Port that originated an exchange.
PKI 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 key cryptography. PKI certification utility Public key infrastructure certification utility. A utility that makes it possible to collect certificate requests from switches and to load certificates to switches. See also digital certificate, PKI. PLDA Private loop direct-attached.
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. protocol A defined method and set of standards for communication.
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. RCS Reliable Commit Service. Refers to HP-specific ILS command code. RCS_SFC RCS Stage Fabric Config. Refers to HP-specific ILS command code. receiver A device that performs detection and signal processing.
S_ID Source ID. Refers to the native port address (24 bit address). SAN 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. SAN port count The number of ports available for connection by nodes in the entire SAN.
SI 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. Single CP Mode The -s option of the firmwareDownload command. Using firmwareDownload -s enables Single CP Mode.
SPOF Single point of failure. Any component in a SAN whose malfunction could bring down the entire SAN. SSH 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 fabric. stealth mode A method used in some switches to simulate HP switches using QuickLoop.
TPC 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. transceiver A device that converts one form of signaling to another for transmission and reception; in fiber optics, optical to electrical. translate domain See xlate domain.
WBEM [need definition; BOFMS] WDM 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. Also referred to as a “management station” or “host.” WTV Write timeout value.
Index A AAA services 22 aaaConfig AAA services RADIUS access levels 17 Advanced Zoning license Advanced Zoning commands 767 aliAdd 35 aliCreate 42 aliDelete 44 aliRemove 45 aliShow 47 cfgActvShow 78 cfgAdd 79 cfgClear 81 cfgCreate 83 cfgDelete 85 cfgDisable 86 cfgEnable 87 cfgRemove 88 cfgSave 90 cfgShow 92 cfgSize 95 cfgTransAbort 97 cfgTransShow 98 qloopAdd 537 qloopCreate 538 qloopDelete 540 qloopRemove 541 qloopShow 543 zoneAdd 750 zoneCreate 751 zoneDelete 753 zoneHelp 754 zoneObjectCopy 756 zoneObject
cfgClear 81 Advanced Zoning license zoning cfgCreate 83 Advanced Zoning license exclusive primary FCS commands zoning cfgDelete 85 Advanced Zoning license exclusive primary FCS commands zoning cfgDisable 86 Advanced Zoning license exclusive primary FCS commands zoning cfgEnable 87 Advanced Zoning license exclusive primary FCS commands zoning cfgRemove 88 Advanced Zoning license exclusive primary FCS commands zoning cfgSave 90 Advanced Zoning license exclusive primary FCS commands zoning cfgShow 92 Advanced
aliShow 47 cfgCreate 83 cfgDelete 85 cfgDisable 86 cfgEnable 87 cfgRemove 88 cfgSave 90, 92 cfgTransAbort 97 cfgTransShow 98 faZoneAdd 202 faZoneCreate 204 faZoneDelete 206 faZoneRemove 207 faZoneShow 209 msConfigure 348 msPlClearDb 353 msPlMgmtActivate 354 msPlMgmtDeactivate 355 mstdDisable 356 passwd 386 secFabricShow 564 secModeDisable 570 secNonFcsPasswd 578 secPolicyAbort 579 secPolicyActivate 580 secPolicyAdd 581 secPolicyCreate 585 secPolicyDelete 589 secPolicyDump 592 secPolicyFcsMove 595 secPolicyR
ficonClear 224, 779 ficoncupset 225 ficoncupshow 226 ficonHelp 228 ficonShow 230, 779 snmpConfig 641 snmpMibCapShow 649 supportShow 676 supportShowCfgDisable 679 supportShowCfgEnable 680 switchShow 692 ficonClear 224 FICON ficoncupset 225 FICON ficoncupshow 226 FICON ficonHelp 228 FICON ficonShow 230 FICON filterTest 237 firmwareCommit 239 standby CP commands firmwareDownload 241 standby CP commands firmwareDownloadStatus 245 standby CP commands firmwareRestore 247 standby CP commands firmwareShow 248 stand
N Licensed product commands 767 licenseHelp 323 licenseIDShow 324 licenseRemove 325 licenseShow 326 linkCost 327 login 329 logout 330 loopPortTest 331 LSDbShow 333 nbrStateShow 361 nbrStatsClear 362 nodeFind 365 NS operation parameters configuration 127 nsAliasShow 368 nsAllShow 372 nscamShow 374 nsZoneMember 382 M P Management Server msCapabilityShow 346, 781 msConfigure 348, 781 msPlatShow 350, 781 msPlatShowDBCB 352, 781 msPlClearDB 353, 781 msPlMgmtActivate 354, 781 msPlMgmtDeactivate 355, 781 msTd
perfCfgRestore 410 perfCfgSave 411 perfClearEEMonitor 412 perfClearFilterMonitor 414 perfClrAlpaCrc 416 perfDelEEMonitor 417 perfDelFilterMonitor 418 perfHelp 419 perfShowAlpaCrc 429 perfShowEEMonitor 430 perfShowFilterMonitor 432 perfShowPortEEMask 434 perfSetPortEEMask 427 perfShowAlpaCrc 429 Performance Monitor license perfShowEEMonitor 430 Performance Monitor license perfShowFilterMonitor 432 Performance Monitor license perfShowPortEEMask 434 Performance Monitor license pkiCreate 436 public key infrastr
qloopRemove 541 qloopShow 543 QuickLoop Fabric Assist mode commands 768 quietMode 545, 546 R RADIUS aaaConfig 22 RCS 546 reboot 547 standby CP commands related documentation 13 routeHelp 548 RSCN transmission mode configuration 127 S saveCore 549 standby CP commands secActiveSize 555 Secure Fabric OS secCertUtil public key infrastructure secDefineSize 563 Secure Fabric OS secFabricShow 564 exclusive primary FCS commands Secure Fabric OS secFcsFailover 566 Secure Fabric OS secGlobalShow 567 Secure Fabric O
sensorShow 615 setDbg 616 setEsdMode 617 setGbicMode 618 setMediaMode 619 setModem 620 setSfpMode 622 setSplbMode 623 setVerbose 624 sfpShow 625 shellFlowControlDisable 629 shellFlowControlEnable 630 slotOff 631 slotOn 632 slotPowerOff 633 slotPowerOn 634 slotShow 635 slTest 637 SNMP agtCfgDefault 777 agtCfgSet 777 agtCfgShow 32, 777 configDefault 113 configUpload 121 configure 128 portDisable 469 portEnable 470 portFlagsShow 473 portShow 510 secPolicyAdd 583 snmpConfig 639, 784 snmpMibCapSet 647, 784 snmpM
traceDump 714 traceFtp 716 traceTrig 718 trackChangesHelp 720 trackChangesSet 721 SNMP trackChangesShow 723 SNMP trunkDebug 724 trunking portCfgTrunkPort 467, 782 trunkShow 726 tsClockServer 727 exclusive primary FCS commands standby CP commands tsTimeZone 729 turboRamTest 731 txdPath 733 U upTime 736 standby CP commands urouteConfig 737 urouteRemove 739 urouteShow 740 V version 745, 746 standby CP commands virtual channel settings configuration 126 voltShow 747 W web sites HP storage 15 HP Subscriber’s
Index
