Brocade Network Advisor Port Commissioning User Manual

®

53-1003220-01
11 July 2014

Brocade Network Advisor

Port Commissioning Quick Start Guide

Supporting Network Advisor 12.3.0

Copyright © 2014 Brocade Communications Systems, Inc. All Rights Reserved.

Brocade, Brocade Assurance, the B-wing symbol, DCX, Fabric OS, MLX, SAN Health, VCS, and VDX are registered trademarks, and AnyIO, Brocade
One, CloudPlex, Effortless Networking, ICX, NET Health, OpenScript, and The Effortless Network are trademarks of Brocade Communications
Systems, Inc., in the United States and/or in other countries. Other brands, products, or service names mentioned may be trademarks of their
respective owners.

Notice: This document is for informational purposes only and does not set forth any warranty, expressed or implied, concerning any equipment,
equipment feature, or service offered or to be offered by Brocade. Brocade reserves the right to make changes to this document at any time,
without notice, and assumes no responsibility for its use. This informational document describes features that may not be currently available.
Contact a Brocade sales office for information on feature and product availability. Export of technical data contained in this document may
require an export license from the United States government.

The authors and Brocade Communications Systems, Inc. shall have no liability or responsibility to any person or entity with respect to any loss,
cost, liability, or damages arising from the information contained in this book or the computer programs that accompany it.

The product described by this document may contain “open source” software covered by the GNU General Public License or other open source
license agreements. To find out which open source software is included in Brocade products, view the licensing terms applicable to the open
source software, and obtain a copy of the programming source code, please visit
http://www.brocade.com/support/oscd.

Brocade Communications Systems, Incorporated

Corporate and Latin American Headquarters
Brocade Communications Systems, Inc.
130 Holger Way
San Jose, CA 95134
Tel: [phone]
Fax: [phone]
E-mail: [e-mail]

European Headquarters
Brocade Communications Switzerland Sàrl
Centre Swissair
Tour B - 4ème étage
29, Route de l'Aéroport
Case Postale 105
CH-1215 Genève 15
Switzerland
Tel: [phone]
Fax: [phone]
E-mail: [e-mail]

Asia-Pacific Headquarters
Brocade Communications Systems China HK, Ltd.
No. 1 Guanghua Road
Chao Yang District
Units 2718 and 2818
Beijing 100020, China
Tel: [phone]
Fax: [phone]
E-mail: [e-mail]

Asia-Pacific Headquarters
Brocade Communications Systems Co., Ltd. (Shenzhen WFOE)
Citic Plaza
No. 233 Tian He Road North
Unit 1308 – 13th Floor
Guangzhou, China
Tel: [phone]
Fax: [phone]
E-mail: [e-mail]

Document History

Title Publication number Summary of changes Date

Brocade Network Advisor Port Commissioning Quick Start Guide 53-1003278-01 New document. May 2104

Brocade Network Advisor Port Commissioning Quick Start Guide 53-1003220-01 New document. July 2014

2 of 21 Brocade Network Advisor Port Commissioning Quick Start Guide

Publication Number: 53-1003220-01

In this document

NOTE

•Port commissioning overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

•Configuring port commissioning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

•CIMOM servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

•F-Port commissioning. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

•E-Port commissioning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

•Port commissioning by switch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

•Port commissioning by blade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

•Port commissioning deployment results . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

•Viewing a port commissioning deployment report. . . . . . . . . . . . . . . . . . . . 18

•CIMCLI trouble shooting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Port commissioning overview

Port commissioning is only supported on FICON devices running Fabric OS 7.1 or later.

Port commissioning provides an automated mechanism to remove an E-Port or F-Port from use (decommission) and
to put it back in use (recommission). This feature identifies the target port and communicates the intention to
decommission or recommission the port to those systems within the fabric affected by the action. Each affected
system can agree or disagree with the action, and these responses are automatically collected before a port is
decommissioned or recommissioned.

Note the following restrictions of port commissioning:

• The local switch and the remote switch on the other end of the E-Port or F-Port must both be running Fabric OS

7.1. 0 or l a t e r.

• Port commissioning is not supported on links configured for encryption or compression.

• Port commissioning is not supported on ports with DWDM (dense wavelength-division multiplexing), CWDM

(corse wavelength-division multiplexing), or TDM (time-division multiplexing).

• E-Port commissioning requires that the lossless feature is enabled on both the local switch and the remote

switch.

• Fabric tracking must be enabled to maintain the decommissioned port details (such as port type, device port

wwn, and so on). Do not accept changes in the Management application client.

For more information about fabric tracking, refer to Brocade Network Advisor User Manual“Enabling fabric

tracking” on page 289.

Brocade Network Advisor Port Commissioning Quick Start Guide 3 of 21
Publication Number: 53-1003220-01

z/OS requirements

NOTE

NOTE

You must meet the following requirements to configure port decommissioning and recommissioning through the
Management application.

• Make sure the z/OS is running 1.12 or later to support z/OS CIM and port decommission.

• Make sure there is a working CIMOM server on each LPAR (logical partition) that participates in port

decommission.

For more information, refer to the sections: Quick guide: CIM server setup and verification, CIM server security
setup, and Setting up the CIM server for storage management in the Common Information Model User’s Guide,
version 1 release 13 (part number: SC33-7998-08).

• Make sure you have SMP/E (System Modification Program/Extended), RACF (Resource Access Control Facility),

and UNIX systems services skills.

• Make sure you have the following IBM APARs (Authorized Program Analysis Reports) for z/OS CIM (CIMOM) and

port decommission on z/OS version 1, release 13.

- OA38145 — z/OS CIM APAR in support of port decommissioning

- OA38303 and HA42524 — IOS port decommissioning APARs

OA38303 requires OA40538 and OA40037.

- OA40538 — Switch CUP diagnostics APAR

- OA40037 — ESCON director code in support of switch CUP diagnostics APAR

- OA40876 — IOS switch SPOF enhancements APAR

Contact the IBM Support Center for the latest APAR updates.

• Make sure you have a Common Event Adapter (CEA) running in full function mode on each LPAR that has a

CIMOM server that participates in port decommission.

For more information, refer to Customizing for CEA in the z/OS Planning for Installation, version 1 release 13
(part number: GA22-7504-28).

• Make sure that the CIMOM server runs as a started task (CFZCIM) on each z/OS LPAR. The CIMOM server must

be running for F_Port decommission to function properly.

• Make sure you have access to the CLI (cimcli command) for troubleshooting.

For more information, refer to “CIMCLI trouble shooting” on page 20.

4 of 21 Brocade Network Advisor Port Commissioning Quick Start Guide

Publication Number: 53-1003220-01

Configuring port commissioning

The following procedure provides an overview of the steps you must complete to configure port commissioning.

1. Make sure you meet the z/OS (mainframe operating system) requirements.

For more information, refer to “z/OS requirements” on page 4.

2. Register each CIMOM servers within the fabric affected by the action.

For step-by-step instructions, refer to “Registering a CIMOM server” on page 5.

3. Decommission an F-Port.

For step-by-step instructions, refer to “Decommissioning an F-Port” on page 11.

4. Review the decommission deployment report.

For step-by-step instructions, refer to “Viewing a port commissioning deployment report” on page 18.

5. Recommission the F-Port.

For step-by-step instructions, refer to “Recommissioning an F-Port” on page 12.

6. Review the recommission deployment report.

For step-by-step instructions, refer to “Viewing a port commissioning deployment report” on page 18.

You can also configure port commissioning for E-Ports (“E-Port commissioning” on page 13), all ports on a blade
(“Port commissioning by blade” on page 15), or all ports on a switch (“Port commissioning by switch” on
page 14).

CIMOM servers

Before you can decommission or recommission an F-Port, you must register the CIMOM servers within the fabric
affected by the action.

Registering a CIMOM server

Make sure you obtain the CIMOM server system and credentials from the CIMOM server administrator and the
authorized user ID from the RACF administrator.

1. Select Configure > Port Commissioning > Setup.

The Port Commissioning Setup dialog box displays (Figure 1).

Brocade Network Advisor Port Commissioning Quick Start Guide 5 of 21
Publication Number: 53-1003220-01

FIGURE 1 Port Commissioning Setup dialog box

2. Enter the IP address (IPv4 or IPv6 format) or host name of the CIMOM server in the Network Address field.

3. (Optional) Enter a description of the CIMOM server in the Description field.

The description cannot be over 1024 characters.

4. Enter the CIMOM port number for the CIMOM server in the CIMOM Port field.

The default port number is 5989.

5. Enter the namespace of the CIM_FCPort in the Namespace field.

The default namespace is root/cimv2.

6. (Optional) Enter a user identifier for the CIMOM server in the Credentials User ID field.

The credentials user identifier cannot be over 128 characters.

7. (Optional) Enter a password in the Password field.

The password cannot be over 512 characters.

8. Click the right arrow button to add the new CIMOM server and credentials to the Systems List.

The application validates the mandatory fields.

9. Select the new CIMOM server in the System List and click Tes t to check connectivity.

When testing is complete, the updated status displays in the Status column of the Systems List for the selected
CIMOM server.

10. Click OK or Apply to save your work and save the CIMOM server details in the database.

6 of 21 Brocade Network Advisor Port Commissioning Quick Start Guide

Publication Number: 53-1003220-01

Viewing existing CIMOM servers

NOTE

Port commissioning is only supported on FICON devices running Fabric OS 7.1 or later.

Before you can decommission or recommission an F-Port, you must register the CIMOM servers within the fabric
affected by the action. For more information, refer to “Registering a CIMOM server” on page 5.

1. Select Configure > Port Commissioning > Setup.

The Port Commissioning Setup dialog box displays (Figure 1).

The Port Commissioning Setup dialog box has two main areas. The Add/Edit Systems and Credentials area
enables you to register CIMOM servers (system and credentials) one at a time and contains the following fields
and components:

• Network Address — Enter the IP address (IPv4 or Ipv6 format) or host name of the CIMOM server in the field.

• Description — (Optional) Enter a description of the CIMOM server in the field. The description cannot be over

1024 characters.

• CIMOM Port — Enter the CIMOM port number for the CIMOM server in the field. The default port number is

5989.

• Namespace — Enter the namespace of the CIM_FCPort in the field. The default namespace is root/cimv2.

• Credentials - User ID (Optional) — Enter a user identifier for the CIMOM server in the field. The credentials

user identifier cannot be over 128 characters.

• Credentials - Password (Optional) — Enter a password in the field. The password cannot be over 512

characters.

• Left arrow button — Select a CIMOM server in the Systems List and click to move the defined CIMOM server

credentials to the Add/Edit Systems and Credentials area for editing or deletion.

• Right arrow button — Click to move the defined CIMOM server credentials form the Add/Edit Systems and

Credentials area to the Systems List.

The Systems List details the defined CIMOM server and contains the following data:

• Network Address — The IP address (IPv4 or Ipv6 format) or host name of the system.

• Description — User-defined description of the system.

• CIMOM Port — The CIMOM port number of the system.

• Namespace — The namespace of the CIM_FCPort.

• User ID — The user identifier for the system.

• Status — The system connectivity status. Updates when you test the reachability of the CIMOM server and

when you contact the CIMOM server to respond to the F-Port decommission or recommission request. Valid
status options include:

 OK — CIMOM server contact successful with current credentials.
 Not Contacted Yet — CIMOM servers configured, connectivity not tested yet.
 Credentials Updated — Credentials changed, connectivity not tested yet.
 Credentials Failed — CIMOM server contact failed with current credentials.
 Not Reachable — CIMOM server not reachable.
 Wrong Namespace — CIMOM server namespace is incorrect.

• Last Contacted — The last time you contacted the system. Updates when you test the reachability of the

CIMOM server and when you contact the CIMOM server to respond to the F-Port decommission or
recommission request.

Brocade Network Advisor Port Commissioning Quick Start Guide 7 of 21
Publication Number: 53-1003220-01