Home » HP Manuals » Storage Devices » HP StorageWorks 2/16V » Manual Viewer

HP StorageWorks 2/16V HP StorageWorks Fabric OS 5.X Procedures User Guide (AA- - Page 18

About the CLI, Help information, Displaying command help

View all HP StorageWorks 2/16V manuals

Add to My Manuals
Save this manual to your list of manuals

Page 18 highlights

• Advanced Web Tools: For Advanced Web Tools procedures, see the HP StorageWorks Fabric OS 5.x Advanced Web Tools administrator guide. • Fabric Manager: For Fabric Manager procedures, see the HP StorageWorks Fabric Manager 5.x administrator guide. • A third-party application using the API: For third-party application procedures, see the third-party API documentation. About the CLI The Fabric OS CLI is the complete fabric management tool for HP StorageWorks SANs that enables you to: • Access the full range of Fabric OS features, based on license keys • Configure, monitor, dynamically provision, and manage every aspect of the SAN • Configure and manage the HP StorageWorks fabric on multiple, efficient levels • Identify, isolate, and manage SAN events across every switch in the fabric • Manage switch licenses • Perform fabric stamping To manage a switch using telnet, Simple Network Management Protocol (SNMP), and Advanced Web Tools, the switch must be connected to a network through the switch Ethernet port (out of band) or from the Fibre Channel (in band). The switch must be configured with an IP address to allow for the network connection. See the installation guide for your switch model for information on physically connecting to the switch. You can access switches from different connections, such as Advanced Web Tools, CLI, and API. When these connections are simultaneous, changes from one connection might not be updated to the other, and some modifications might be lost. When simultaneous connections are used, make sure that you do not overwrite the work of another connection. In a mixed fabric containing switches running various Fabric OS versions, you should use the latest-model switches running the most recent release for the primary management tasks. The principal management access should be set to the core switches in the fabric. For example, to run Secure Fabric OS, use the latest-model switch as the primary Fabric Configuration Server (FCS), the location to perform zoning tasks, and the time server. A number of management tasks are designed to make fabric-level changes; for example, zoning commands make changes that affect the entire fabric. When executing fabric-level configuration tasks, allow time for the changes to propagate across the fabric before executing any subsequent tasks. For a large fabric, it might be take a few minutes. Help information Each Fabric OS command provides Help information that explains the command function, its possible operands, its level in the command hierarchy, and additional pertinent information. Displaying command help To display help information: 1. Connect to the switch and log in as admin. 2. To display a list of all command help topics for a given login level, issue the help command with no arguments. For example, if you are logged in as user and issue the help command, a list of all user-level commands that can be executed is displayed. The same rule applies to the admin role. In addition, any user-configured command that uses a switchAdmin role also displays commands available to users with the switchAdmin role. 3. To display help for a specific command for a given login level, issue help command, where command is the name of the command for which you need information. 18 Introducing Fabric OS CLI procedures

Section	Page
Contents	3
Intended audience	13
Related documentation	13
HP StorageWorks Fabric OS 5.x master glossary	13
Document conventions and symbols	14
Table 1 Document conventions	14
HP technical support	14
HP-authorized reseller	15
Helpful web sites	15
Introducing Fabric OS CLI procedures	17
About procedural differences	17
Scope and references	17
About the CLI	18
Help information	18
Displaying command help	18
Additional help topics	19
Performing basic configuration tasks	21
Connecting to the Command Line Interface	21
Setting the IP address	22
Setting the default account passwords	22
Table 2 Maximum number of simultaneous sessions	22
Setting the date and time	24
Table 3 Conversion from UTC to local time	26
Maintaining licensed features	26
Customizing the switch name	28
Customizing the chassis name	29
Disabling and enabling a switch	29
Disabling and enabling a port	30
Activating Ports on Demand	30
Making basic connections	31
Connecting to devices	31
Connecting to other switches	31
Working with domain IDs	32
Linking through a gateway	33
Checking status	34
Tracking and controlling switch changes	35
Configuring standard security features	39
Secure protocols	39
Table 4 Secure protocol support	39
Table 5 Items needed to deploy secure protocols	39
Table 6 Main security scenarios	40
Ensuring network security	40
Configuring the telnet interface	41
Blocking listeners	42
Table 7 Blocked listener applications	42
Accessing switches and fabrics	42
Table 8 Access defaults	42
Creating and maintaining user-defined accounts	43
Changing an account password	45
Setting up RADIUS AAA service	45
Configuring the RADIUS server	46
Configuring the switch	50
Enabling and disabling local authentication	52
Configuring for the SSL protocol	52
Browser and Java support	53
Summary of SSL procedures	53
Table 9 SSL certificate files	53
Choosing a CA	54
Generating a public/private key	54
Generating and storing a CSR	54
Obtaining certificates	55
Installing a switch certificate	55
Activating a switch certificate	56
Configuring the browser	56
Installing a root certificate to the Java Plug-in	57
Displaying and deleting certificates	57
Table 10 Commands to display and delete SSL certificates	57
Troubleshooting certificates	58
Table 11 SSL messages and actions	58
Configuring SNMP agent and traps	58
Setting the security level	59
Using the snmpConfig command	59
Using legacy commands for SNMPv1	62
Configuring secure file copy	67
Setting the boot PROM password	67
Without a recovery string	69
Recovering forgotten passwords	71
Maintaining configurations and firmware	73
Maintaining configurations	73
Displaying configuration settings	73
Backing up a configuration	73
Restoring a configuration	74
Restoring configurations in a FICON environment	75
Table 12 Backup and restore in a FICON CUP environment	75
Downloading configurations across a fabric	76
Printing hard copies of switch information	76
Maintaining firmware	76
Obtaining and unzipping firmware	76
Checking connected switches	77
Table 13 Recommended firmware	78
About the download process	78
Table 14 Effects of firmware changes on accounts and passwords	79
Upgrading HP StorageWorks switches	79
Upgrading HP StorageWorks directors	82
Troubleshooting firmware downloads	85
Configuring Core Switch 2/64, SAN Director 2/128, and 4/256 SAN Director	87
Identifying ports	87
By slot and port number	87
By port area ID	88
Basic blade management	88
Powering port blades off and on	88
Disabling and enabling port blades	89
Conserving power	89
Blade terminology and compatibility	89
Table 15 HP StorageWorks director terminology and abbreviations	90
CP blades	90
Port blade compatibility	91
Table 16 Blades supported by each HP StorageWorks director	91
Setting chassis configurations	91
Table 17 Supported configuration options	91
Obtaining slot information	92
Configuring a new SAN Director 2/128 with two domains	93
Converting an installed SAN Director 2/128 to support two domains	94
Setting the blade beacon mode	95
Routing traffic	97
About data routing and routing policies	97
Specifying the routing policy	97
Assigning a static route	98
Specifying frame order delivery	98
Using DLS	99
Viewing routing path information	100
Viewing routing information along a path	102
Administering FICON fabrics	105
FICON overview	105
Table 18 Fabric OS commands related to FICON and FICON CUP	107
Configuring switches	108
Preparing a switch	108
Configuring a single switch	108
Configuring a high-integrity fabric	109
Figure 1 Cascaded configuration with two switches	109
Figure 2 Cascaded configuration with three switches	109
Setting a unique domain ID	109
Displaying information	110
Link incidents	110
Registered listeners	110
Node identification data	110
FRU failures	111
Swapping ports	111
Clearing the FICON management database	111
Using FICON CUP	111
Setup summary	112
Enabling and disabling FMS mode	112
Displaying the fmsmode setting	113
Displaying mode register bit settings	113
Table 19 FICON CUP mode register bits	114
Setting mode register bits	114
Persistently enabling and disabling ports	115
Port and switch naming standards	116
Adding and removing FICON CUP licenses	116
Zoning and PDCM considerations	116
Backing up and restoring configurations	116
Troubleshooting	116
Identifying ports	117
Backing up FICON files	118
Recording configuration information	118
Figure 3 FICON switch configuration worksheet	119
Configuring the Distributed Management Server	123
Enabling and disabling the platform services	123
Controlling access	124
Configuring the server database	126
Controlling topology discovery	127
Working with diagnostic features	129
Viewing POST	129
Viewing switch status	130
Viewing port information	132
Table 20 Port error summary description	134
Viewing equipment status	135
Viewing the system message log	136
Viewing the port log	137
Table 21 Commands for port log management	137
Configuring for syslogd	138
Configuring the host	138
Table 22 Fabric OS and UNIX message severities	138
Configuring the switch	139
Viewing and saving diagnostic information	140
Setting up automatic trace dump transfers	140
Troubleshooting	143
Most common problem areas	143
Table 23 Common troubleshooting problems and tools	143
Gathering information for technical support	144
Troubleshooting questions	144
Analyzing connection problems	145
Restoring a segmented fabric	148
Correcting zoning setup issues	149
Table 24 Types of zone discrepancies	149
Table 25 Commands for debugging zoning	150
Recognizing MQ errors	151
Correcting I2C bus errors	151
Correcting device login issues	152
Identifying media-related issues	155
Table 26 Component test descriptions	156
Table 27 Switch component tests	157
Correcting link failures	157
Table 28 Switchshow output and suggested action	159
Correcting marginal links	159
Table 29 Loopback modes	160
Inaccurate information in the system message log	161
Port initialization and FCP auto-discovery process	161
Administering extended fabrics	163
About extended link buffer allocation	163
SAN Switch 2/8V, SAN Switch 2/16V, and SAN Switch 2/32, Core Switch 2/64, SAN Director 2/128, and 4/256 SAN Director (FC2-16 port blades)	163
Brocade 4Gb SAN Switch for HP p-Class BladeSystem, SAN Switch 4/32, and 4/256 SAN Director (FC4-16 and FC4-32 port blades)	163
Fabric considerations	163
Choosing an extended ISL mode	164
Table 30 Extended ISL modes: switches with Bloom ASIC	164
Table 31 Extended ISL modes: switches with Goldeneye ASIC	164
Table 32 Extended ISL modes: switches with Condor ASIC.	165
Configuring an extended ISL	165
Trunking over distance	166
Administering ISL trunking	167
About ISL trunking	167
Figure 4 Distribution of traffic over ISL trunking groups	167
Standard trunking criteria	168
Fabric considerations	168
Initializing trunking on ports	169
Monitoring traffic	169
Enabling and disabling ISL trunking	171
Setting port speeds	171
Displaying trunking information	173
Trunking over extended fabrics	173
Troubleshooting trunking problems	174
Listing link characteristics	174
Recognizing buffer underallocation	174
Administering advanced zoning	177
Zoning terminology	177
Figure 5 Zoning example	177
Zoning concepts	178
Zone types	178
Table 33 Types of zoning	178
Table 34 Approaches to fabric-based zoning	179
Zone objects	179
Zone aliases	180
Zone configurations	180
Zoning enforcement	181
Table 35 Enforcing hardware zoning	182
Figure 6 Hardware-enforced non-overlap ping zones	183
Figure 7 Hardware-enforced overlapping zones	183
Figure 8 Zoning with hardware assist (mixed-port and WWN zones)	184
Figure 9 Session-based hard zoning	184
Rules for configuring zones	184
Creating and managing zone aliases	185
Creating and maintaining zones	187
Table 36 Resulting database size: 0 to 96K	189
Table 37 Resulting database size: 96K to 128K	189
Table 38 Resulting database size: 128K to 256K	190
Table 39 Resulting database size: 256K to 1M	190
Creating and modifying zoning configurations	190
Maintaining zone objects	193
Managing zoning configurations in a fabric	195
Table 40 Zoning database limitations	195
Adding a new switch or fabric	195
Splitting a fabric	197
Using zoning to administer security	197
Resolving zone conflicts	197
Table 41 Considerations for zoning architecture	198
Administering advanced performance monitoring	199
Table 42 Advanced performance monitoring commands	199
Displaying and clearing the CRC error count	200
Monitoring EE performance	201
Adding EE monitors	201
Figure 10 Setting EE monitors on a port	202
Figure 11 Proper placement of EE performance monitors	202
Setting a mask for EE monitors	202
Figure 12 Mask positions for EE monitors	203
Deleting EE monitors	204
Monitoring filter-based performance	204
Adding standard filter-based monitors	205
Table 43 Commands to add filter-based monitors	205
Adding custom filter-based monitors	205
Table 44 Predefined values at offset 0	206
Monitoring ISL performance	207
Monitoring trunks	207
Displaying monitor counters	207
Clearing monitor counters	209
Saving and restoring monitor configurations	211
Collecting performance data	211
Configuring the PID format	213
About PIDs and PID binding	213
Summary of PID formats	213
Impact of changing the fabric PID format	213
Host reboots	214
Static PID mapping errors	214
Changes to configuration data	214
Table 45 Effects of PID format changes on configurations	215
Selecting a PID format	215
Table 46 PID format recommendations for adding new switches	216
Evaluating the fabric	216
Planning the update procedure	218
Online update	218
Offline update	218
Hybrid update	219
Changing to Core PID format	219
Changing to Extended Edge PID format	220
Table 47 Earliest Fabric OS versions for Extended Edge PID format	220
Converting port number to area ID	222
Figure 13 4/256 SAN Director with Extended Edge PID	223
PID format changes	224
Executing the basic procedure	224
Executing the HP-UX procedure	225
Executing the AIX procedure	227
Swapping port area IDs	227
Configuring interoperability mode	229
Using the HP Remote Switch feature	231
Understanding legacy password behavior	233
Password management information	233
Table 48 Account and password characteristics matrix	233
Password prompting behaviors	234
Table 49 Password prompting matrix	234
Password migration during firmware changes	235
Table 50 Password migration behavior during firmware upgrade and downgrade	235
Password recovery options	236
Table 51 Password recovery options	236
Zone merging scenarios	237
Table 52 Zone merging scenarios	237
Upgrading firmware in single-CP mode	239
Index	243
A	243
B	243
C	243
D	244
E	244
F	244
G	245
H	245
I	245
J	245
K	245
L	245
M	245
N	245
O	245
P	245
R	246
S	246
T	247
U	247
V	247
W	247

Match case Limit results 1 per page

Introducing Fabric OS CLI procedures

•

Advanced Web Tools: For Advanced Web Tools procedures, see the

HP StorageWorks Fabric OS

5.x Advanced Web Tools administrator guide

•

Fabric Manager: For Fabric Manager procedures, see the

HP StorageWorks Fabric Manager 5.x

administrator guide

•

A third-party application using the API: For third-party application procedures, see the third-party API

documentation.

About the CLI

The Fabric OS CLI is the complete fabric management tool for HP StorageWorks SANs that enables you

to:

•

Access the full range of Fabric OS features, based on license keys

•

Configure, monitor, dynamically provision, and manage every aspect of the SAN

•

Configure and manage the HP StorageWorks fabric on multiple, efficient levels

•

Identify, isolate, and manage SAN events across every switch in the fabric

•

Manage switch licenses

•

Perform fabric stamping

To manage a switch using telnet, Simple Network Management Protocol (SNMP), and Advanced Web

Tools, the switch must be connected to a network through the switch Ethernet port (out of band) or from the

Fibre Channel (in band). The switch must be configured with an IP address to allow for the network

connection. See the installation guide for your switch model for information on physically connecting to

the switch.

You can access switches from different connections, such as Advanced Web Tools, CLI, and API. When

these connections are simultaneous, changes from one connection might not be updated to the other, and

some modifications might be lost. When simultaneous connections are used, make sure that you do not

overwrite the work of another connection.

In a mixed fabric containing switches running various Fabric OS versions, you should use the latest-model

switches running the most recent release for the primary management tasks. The principal management

access should be set to the core switches in the fabric. For example, to run Secure Fabric OS, use the

latest-model switch as the primary Fabric Configuration Server (FCS), the location to perform zoning tasks,

and the time server.

A number of management tasks are designed to make fabric-level changes; for example, zoning

commands make changes that affect the entire fabric. When executing fabric-level configuration tasks,

allow time for the changes to propagate across the fabric before executing any subsequent tasks. For a

large fabric, it might be take a few minutes.

Help information

Each Fabric OS command provides Help information that explains the command function, its possible

operands, its level in the command hierarchy, and additional pertinent information.

Displaying command help

To display help information:

Connect to the switch and log in as admin.

To display a list of all command help topics for a given login level, issue the

help

command with no

arguments.

For example, if you are logged in as user and issue the

help

command, a list of all user-level

commands that can be executed is displayed. The same rule applies to the admin role. In addition,

any user-configured command that uses a switchAdmin role also displays commands available to

users with the

switchAdmin

role.

To display help for a specific command for a given login level, issue

help

command

, where

command

is the name of the command for which you need information.