Hitachi Compute Blade Emulex Adapter User's Guide for Utility

FASTFIND LINKS Getting Help Contents

MK-99COM105-08

© 2010-2015 Hitachi, Ltd. All rights reserved.

No part of this publication may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying and recording, or stored in a database or retrieval system for any purpose without the express written permission of Hitachi, Ltd.

Hitachi, Ltd., reserves the right to make changes to this document at any time without notice and assumes no responsibility for its use. This document contains the most current information available at the time of publication. When new or revised information becomes available, this entire document will be updated and distributed to all registered users.

Some of the features described in this document might not be currently available. Refer to the most recent product announcement for information about feature and product availability, or contact Hitachi Data Systems Corporation at https://portal.hds.com.

Notice: Hitachi, Ltd., products and services can be ordered only under the terms and conditions of the applicable Hitachi Data Systems Corporation agreements. The use of Hitachi, Ltd., products is governed by the terms of your agreements with Hitachi Data Systems Corporation.

Hitachi is a registered trademark of Hitachi, Ltd., in the United States and other countries. Hitachi Data Systems is a registered trademark and service mark of Hitachi, Ltd., in the United States and other countries.

Archivas, Essential NAS Platform, HiCommand, Hi-Track, ShadowImage, Tagmaserve, Tagmasoft, Tagmasolve, Tagmastore, TrueCopy, Universal Star Network, and Universal Storage Platform are registered trademarks of Hitachi Data Systems Corporation.

AIX, AS/400, DB2, Domino, DS8000, Enterprise Storage Server, ESCON, FICON, FlashCopy, IBM, Lotus, OS/390, RS6000, S/390, System z9, System z10, Tivoli, VM/ESA, z/OS, z9, zSeries, z/VM, z/VSE are registered trademarks and DS6000, MVS, and z10 are trademarks of International Business Machines Corporation.

All other trademarks, service marks, and company names in this document or website are properties of their respective owners.

Microsoft product screen shots are reprinted with permission from Microsoft Corporation. ii

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

Contents

Preface ...... v Document Conventions ...... vi Getting Help...... viii Comments ...... viii

Overview of This Manual ...... 1-1

Flow Chart of Setting up ...... 2-1

The OneCommand Manager application GUI (in Windows) ...... 3-1

The OneCommand Manager application CLI (in Linux) ...... 4-1

Supported Operating Systems...... 5-1

Restrictions ...... 6-1

Acronyms and Abbreviations ...... 1

Contents iii

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

Preface

Thank you very much for purchasing the Hitachi Compute blade. This document describes how to use the management utility for Emulex adapters.

This preface includes the following information: ¨ Document Conventions ¨ Getting Help ¨ Comments

Preface v

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

Document Conventions

This document uses the following typographic conventions:

Convention Description

Bold Indicates text on a window, other than the window title, including menus, menu options, fields, and labels. Example: Click OK.

Italic Indicates a variable, which is a placeholder for actual text provided by the user or system. Example: copy source-file target-file Note: Angled brackets (< >) are also used to indicate variables.

screen/code Indicates text that is displayed on screen or entered by the user. Example: # pairdisplay -g oradb < > angled brackets Indicates a variable, which is a placeholder for actual text provided by the user or system. Example: # pairdisplay -g Note: Italic font is also used to indicate variables.

[ ] square brackets Indicates optional values. Example: [ a | b ] indicates that you can choose a, b, or nothing.

{ } braces Indicates required or expected values. Example: { a | b } indicates that you must choose either a or b.

| vertical bar Indicates that you have a choice between two or more options or arguments. Examples: [ a | b ] indicates that you can choose a, b, or nothing. { a | b } indicates that you must choose either a or b.

underline Indicates the default value. Example: [ a | b ]

This document uses the following icons to draw attention to information:

Icon Meaning Description

This indicates the presence of a potential risk that might cause death WARNING or severe injury. This indicates the presence of a potential risk that might cause CAUTION relatively mild or moderate injury. This indicates the presence of a potential risk that might cause severe NOTICE NOTICE damage to the equipment and/or damage to surrounding properties.

This indicates notes not directly related to injury or severe damage to Note equipment.

Tip This indicates advice on how to make the best use of the equipment.

vi Preface

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

Abbreviated Notations of Operating Systems (OS) In this manual, OS names are expressed as follows: · Microsoft(R) Windows Server(R) 2012 R2 Standard (Windows Server 2012 R2 hereafter) · Microsoft(R) Windows Server(R) 2012 R2 Datacenter (Windows Server 2012 R2 hereafter) · Microsoft(R) Windows Server(R) 2012 Standard (Windows Server 2012 hereafter) · Microsoft(R) Windows Server(R) 2012 Datacenter (Windows Server 2012 hereafter) · Microsoft(R) Windows Server(R) 2008 Standard 32-bit (Windows Server 2008 (32bit) hereafter) · Microsoft(R) Windows Server(R) 2008 Enterprise 32-bit (Windows Server 2008 (32bit) hereafter) · Microsoft(R) Windows Server(R) 2008 Standard (Windows Server 2008 hereafter) · Microsoft(R) Windows Server(R) 2008 Enterprise (Windows Server 2008 hereafter) · Microsoft(R) Windows Server(R) 2008 Standard without Hyper-VTM 32-bit (Windows Server 2008 (32bit) hereafter) · Microsoft(R) Windows Server(R) 2008 Enterprise without Hyper-VTM 32-bit (Windows Server 2008 (32bit) hereafter) · Microsoft(R) Windows Server(R) 2008 Standard without Hyper-VTM (Windows Server 2008 hereafter) · Microsoft(R) Windows Server(R) 2008 Enterprise without Hyper-VTM (Windows Server 2008 hereafter) · Microsoft(R) Windows Server(R) 2008 R2 Standard (Windows Server 2008 R2 hereafter) · Microsoft(R) Windows Server(R) 2008 R2 Enterprise (Windows Server 2008 R2 hereafter) · Microsoft(R) Windows Server(R) 2008 R2 Datacenter (Windows Server 2008 R2 hereafter) · Red Hat(R) Enterprise Linux(R) Server 6.6 (RHEL6.6 hereafter) · Red Hat(R) Enterprise Linux(R) Server 6.5 (RHEL6.5 hereafter) · Red Hat(R) Enterprise Linux(R) Server 6.4 (RHEL6.4 hereafter) · Red Hat(R) Enterprise Linux(R) Server 6.2 (RHEL6.2 hereafter) · Red Hat(R) Enterprise Linux(R) Server 5.9 (RHEL5.9 hereafter) · Red Hat(R) Enterprise Linux(R) Server 5.7 (RHEL5.7 hereafter)

Preface vii

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

Abbreviations for 10Gb Converged Network Expansion Cards Abbreviations for the following card model names are written in this manual. · Abbreviation "onboard CNA" : CB500 series server blade onboard CNA CB2500 series server blade onboard CNA · Abbreviation "CNA expansion card" : CB500 4-port converged network expansion card CB2000 2/4-port converged network expansion card CB2000 CNA board (PCI express adapter type) CB2500 CNA board (PCI express adapter type) · Abbreviation "LAN expansion card" : CB500 10Gb 4-port LAN expansion card CB2000 10Gb 2/4-port LAN expansion card

Abbreviation for Fiber Channel (FC) Card Abbreviation for the following FC card model name is written in this manual. · Abbreviation "8Gb FC expansion card" CB500 8Gb 2-port Fiber Channel expansion card CB2000 8Gb 2-port Fiber Channel expansion card CB2000 8Gb 2-port Fibre Channel board (PCI express adapter type) CB2500 8Gb 2-port Fibre Channel board (PCI express adapter type) · Abbreviation "8Gb FC board" CB2000 8Gb 2-port Fibre Channel board (PCI express adapter type) CB2500 8Gb 2-port Fibre Channel board (PCI express adapter type) · Abbreviation "16Gb FC expansion card" CB500 16Gb 2-port Fiber Channel expansion card CB2000 16Gb 2-port Fibre Channel board (PCI express adapter type) CB2500 16Gb 2-port Fibre Channel board (PCI express adapter type) · Abbreviation "16Gb FC board" CB2000 16Gb 2-port Fibre Channel board (PCI express adapter type) CB2500 16Gb 2-port Fibre Channel board (PCI express adapter type) · Abbreviation "FC expansion card" 8Gb FC expansion card 16Gb FC expansion card Getting Help The Hitachi Data Systems customer support staff is available 24 hours a day, seven days a week. If you need technical support, log on to the Hitachi Data Systems Portal for contact information: https://portal.hds.com Comments Please send us your comments on this document: [email protected]. Include the document title and number including the revision level (for example, -07), and refer to specific sections and paragraphs whenever possible. All comments become the property of Hitachi Data Systems Corporation. Thank you! viii Preface

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

1

Overview of This Manual

This manual describes the management utility for the Emulex products

¨ Hitachi Compute Blade Emulex Adapter User's Guide

Overview of This Manual 1-1

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

Hitachi Compute Blade Emulex Adapter User's Guide

Hitachi Compute Blade Emulex Adapter User's Guide is the manual for the following products.

# System Model Products Product Code Remarks 1 CB500 540A B1 Onboard CNA GGAGD0B1-TNNX14Y 2 series 520H B1 Onboard CNA GGAGC0B1-TNNX14Y 3 520H B2 Onboard CNA GG-RV3XGC0B2X1-Y 4 520H B3 Onboard CNA GG-RV3XGC0B3X1-Y 5 520X B1 Onboard CNA GG-RV3XGE0B1X1-Y 6 CNA expansion card GG-CN3MXG2X1-Y 7 GGX-CN3MXG2X1[EX] 8 GGX-CN3MXG2X3[EX] for CB500 x2 model 9 LAN expansion card GG-CN3MXG2X2-Y 10 GGX-CN3MXG2X2[EX] 11 GGX-CN3MXG2X4[EX] for CB500 x2 model 12 8Gb FC expansion card GG-CC3M8G1X1-Y 13 GGX-CC3M8G1X1[EX] 14 16Gb FC expansion card GG-CC3M161X1-Y 15 GGX-CC3M161X1[EX] 16 CB2000 CNA board GV-CN2NXG3X1-Y 17 series (for chassis) GV-CN2NXG3XR-Y for RoHS 18 GVX-CN2NXG3X1[BX] 19 GVX-CN2NXG3X2[BX] for CB2000 x4 model 20 CNA board GV-CN2DXG3X1-Y 21 (for I/O slot expansion unit) GVX-CN2DXG3X1[EX] 22 GVX-CN2DXG3X2[EX] for CB2000 x4 model 23 LAN expansion card (2-port) GV-CN2MXG1X1-Y 24 GVX-CN2MXG1X1[EX] 25 GVX-CN2MXG1X2[EX] for CB2000 x4 model 26 LAN expansion card (4-port) GV-CN2MXG2X1-Y 27 GVX-CN2MXG2X1[EX] 28 GVX-CN2MXG2X2[EX] for CB2000 x4 model 29 CNA expansion card (2-port) GV-CN2MXG3X1-Y 30 GVX-CN2MXG3X1[EX] 31 GVX-CN2MXG3X2[EX] for CB2000 x4 model 32 CNA expansion card (4-port) GV-CN2MXG4X1-Y 33 GVX-CN2MXG4X1[EX] 34 GVX-CN2MXG4X2[EX] for CB2000 x4 model 35 8Gb FC board GV-CC2N8G3X1-Y 36 (for chassis) GV-CC2N8G3XR-Y for RoHS 37 GVX-CC2N8G3X1[BX] 38 8Gb FC board GV-CC2D8G3X1-Y 39 (for I/O slot expansion unit) GVX-CC2D8G3X1[EX] 40 8Gb FC expansion card GV-CC2M8G3X1-Y 41 GV-CC2M8G3XR-Y for RoHS 42 GVX-CC2M8G3X1[EX] 43 16Gb FC board GV-CC2N163X1-Y 44 (for chassis) GVX-CC2N163X1[BX] 45 16Gb FC board GV-CC2D163X1-Y 46 (for I/O slot expansion unit) GVX-CC2D163X1[EX] 47 CB2500 520X B1 Onboard CNA GG-RV3XGE0B1X1-Y 48 series 520H B3 Onboard CNA GG-RV3XGC0B3X1-Y 49 CNA board GG-CN4NXG3X1-Y 50 8Gb FC board GG-CC4N8G3X1-Y 51 16Gb FC board GG-CC4N163X1-Y

1-2 Overview of This Manual

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

Hitachi Compute Blade Emulex Adapter User's Guide consists of three documents : for Driver, for Hardware and for Utility.

See the document "Hitachi Compute Blade LAN Advanced Function Manual for Emulex (MK-99COM082)" for how to setup the NIC teaming and how to setup the VLAN.

# Document Name Contents Hitachi Compute Blade Emulex How to install the drivers of the adapters 1 Adapter User's Guide for Driver How to setup the drivers (MK-99COM103) Hitachi Compute Blade Emulex Outline of Emulex adapters 2 Adapter User's Guide for Hardware BIOS parameter list and the way to (MK-99COM104) configure the parameters Hitachi Compute Blade Emulex This document. 3 Adapter User's Guide for Utility How to install and to operate the utility that (MK-99COM105) manages the Emulex adapters How to configure the parameters with the utility Hitachi Compute Blade LAN Advanced How to setup the NIC teaming 4 Function Manual for Emulex How to setup the VLAN (MK-99COM082)

Overview of This Manual 1-3 Hitachi Compute Blade Emulex Adapter User's Guide for Utility

2

Flow Chart of Setting up

This chapter describes the flow chart of setting up for Emulex adapters.

¨ The flow chart of setting up for onboard CNA / CNA expansion card / LAN expansion card ¨ The flow chart of setting up for 8Gb / 16Gb Fibre Channel expansion card

Flow Chart of Setting up 2-1

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

The Flow Chart of Setting up for Onboard CNA / CNA expansion card / LAN expansion card

The flow chart of setting up for onboard CNA / CNA expansion card / LAN expansion card is as follows.

Start

Enabling PXE Disabling PXE

Setting Personality

Enabling multichannel Disabling Multichannel function function

See "Hitachi Compute Blade Emulex Adapter User's Guide Setting iSCSI initiator for Hardware"

Setting iSCSI target (for boot) Setting iSCSI target (for data)

Setting FCoE

Setting FCoE (for booting) Setting FCoE (for data)

Setup of OS See "OS Installation Guide" for each OS.

NIC driver

See "Hitachi Compute Blade iSCSI driver Emulex Adapter User's Guide for Driver"

FCoE driver

In this document, Settings by OCM/OCM_CLI See the chapter 3 or 4.

Settings by NIC Teaming Kit See "Hitachi Compute Blade LAN Advanced function manual ž Teaming setting for Emulex" ž VLAN setting

End

2-2 Flow Chart of Setting up

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

The Flow Chart of Setting up for 8Gb / 16Gb FC expansion card

The setting flow of 8Gb / 16Gb FC expansion card is as follows

Start

Setting Fibre Channel Device See "Hitachi Compute Blade Emulex Adapter User's Guide for Hardware" boot configuration for FC device

See "OS Installation Guide" for OS Setting up each OS.

See "Hitachi Compute Blade Installing Driver Emulex Adapter User's Guide for Driver"

Configurations by OCM/OCM_CLI

Configuring the driver In this document, parameters. see the chapter 3 or 4.

End

Flow Chart of Setting up 2-3

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

3

The OneCommand Manager application GUI (in Windows)

This chapter describes the OneCommand Manger application GUI (OCM hereafter) for Emulex adapters.

¨ OCM version List ¨ Installing OCM ¨ Uninstalling OCM ¨ Confirming OCM version ¨ Starting OCM ¨ Stopping OCM ¨ OCM functions ¨ Configuring by OCM

The OneCommand Manager application GUI (in Windows) 3-1

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

OCM version List

Supported OCM versions are as follows.

Table 3-1 : No. Supported OCM version Remarks 1 6.0.15.1 2 6.1.14.1 3 6.1.34.1 or 6.1.34.1-1 4 6.3.16.1 or 6.3.16.1-1 5 10.2.340.5 or 10.2.340.5-1 Only for : CB500 520X B1 CB500 520H B3 CB2500 520X B1 CB2500 520H B3

3-2 The OneCommand Manager application GUI (in Windows)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

Installing OCM

This section describes the OCM installation procedure. The following description assumes that user logs on with administrator privilege (such as Administrator). The OCM has been installed to the OS preinstalled system with onboard CNA, CNA expansion card or LAN expansion card. Install OCM when reinstalling OS or installing the Emulex adapters newly to the system.

The drivers and OCM are provided with CD/DVD media. : "Server installation and monitoring tool" or "10Gb CNA Driver CD". For the information of the driver version, see "Support_EN.html" etc. included in the media.

1. Start OCM and confirm the version. Windows Server 2008 / Windows Server 2008 R2 : Select [Start] – [All programs] – [Emulex] – [OCManager]. Windows Server 2012 / Windows Server 2012 R2 : Select [Start] – [OCManager].

2. Click [Help] – [About OneCommand(TM) Manager] and confirm the version. Confirm that the version is listed in Table 3-1. When the version is supported, the installation is not necessary. When upgrading or downgrading, go to next step. When reinstalling, go to next step after uninstalling. The uninstalling process is describes in the section "Uninstalling OCM".

3. Insert the driver media into the DVD-ROM drive, and open the following folder.

Table 3-2: - CB500 CB520A x1, CB520H x1, CB540A x1 model : " Server installation and monitoring tool " media :

OS Location of the installation file Windows Server 2008 (32bit) See the file "support_EN.html" in the root folder. Windows Server 2008 Windows Server 2008 R2 Windows Server 2012 Windows Server 2012 R2

- CB500 CB520H x2 model: "Server installation and monitoring tool " media : OS Location of the installation file Windows Server 2008 (32bit) See the file "support_EN.html" in the root folder. Windows Server 2008 Windows Server 2008 R2 Windows Server 2012 Windows Server 2012 R2

The OneCommand Manager application GUI (in Windows) 3-3

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

- CB500 520X B1/520H B3 model: "CB500 10Gb CNA Drivers ver.01-06 (or higher)" media :

OS Location of the installation file Windows Server 2008 R2 \WinSrv2008\Utility\OCM Windows Server 2012 Windows Server 2012 R2

- CB2500 520X B1/520H B3 model: "CB2500 10Gb CNA Drivers ver.01-06 (or higher)" media :

OS Location of the installation file Windows Server 2008 R2 \WinSrv2008\Utility\OCM Windows Server 2012 Windows Server 2012 R2

- CB2000 Standard server blade x3 model : " Server installation and monitoring tool " media : OS Location of the installation file Windows Server 2008 (32bit) See the file "support_EN.html" in the root folder. Windows Server 2008 Select "Contents - 4.Drivers and utilities", and "Standard server Windows Server 2008 R2 blade x3" - Utilities(WS12/WS08R2/WS08)", and "FC - Emulex One Windows Server 2012 Command Manager". Windows Server 2012 R2

- CB2000 High performance server blade, Standard server blade x4 model: " Server installation and monitoring tool " media : OS Location of the installation file Windows Server 2008 (32bit) See the file "support_EN.html" in the root folder. Windows Server 2008 Select "Contents - 4.Drivers and utilities", and "Standard server Windows Server 2008 R2 blade x4 " or "High-performance server blade x2" - Windows Server 2012 Utilities(WS12R2/WS12/WS08R2/WS08)", and "FC - Emulex One Windows Server 2012 R2 Command Manager".

4. Execute the following script file. Table 3-3: OS Script file Windows Server 2008 (32bit) OneCommandManager_Install_x86.bat Windows Server 2008 OneCommandManager_Install_x64.bat Windows Server 2008 R2 Windows Server 2012 Windows Server 2012 R2

5. The installation starts automatically. Wait until "Emulex OCManager Enterprise" on the task bar disappears. When "Emulex OCManager Enterprise" disappears, the installation is complete.

6. Restart the OS.

3-4 The OneCommand Manager application GUI (in Windows)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

Uninstalling OCM

1. Select [Start] – [Control Panel] – [Programs] – [Uninstall a Program]

2. Select "Emulex OCManager Enterprise [version]".

3. Click [Remove] or [Uninstall].

4. The pop-up message "This will remove Emulex OCManager Enterprise from your computer. Do you want to continue?" is displayed. Click [Yes] to start uninstalling.

5. When uninstalling is complete, the pop-up message "Emulex OCManager Enterprise has been removed from your computer." is displayed. Click [OK].

The OneCommand Manager application GUI (in Windows) 3-5

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

Confirming OCM version

1. Start OCM and click [Help] – [About OneCommand(TM) Manager] to display the version.

2. Confirm that the version is listed in Table 3-1.

3. Click [OK] to close the window.

3-6 The OneCommand Manager application GUI (in Windows)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

Starting OCM

1. Starting OCM.

- Windows Server 2008 / Windows Server 2008 R2 : Select Start – All programs – Emulex – OCManager.

- Windows Server 2012 / Windows Server 2012 R2 : Select Start – OCManager.

- OCManager WebLaunch Install is not supported. Do not select this icon. - OCManager WebLaunch Uninstall is not supported. Do not select this icon. - OCManager WebLaunch Update URL is not supported. Do not select this icon.

The OneCommand Manager application GUI (in Windows) 3-7

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

Stopping OCM

1. Stopping OCM.

Select [File] – [Exit] in menu bar or click the close box located in upper right corner in the window.

3-8 The OneCommand Manager application GUI (in Windows)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

OCM functions

OCM functions

Main OCM functions are as follows. Table 3-4: Main Functions Explanation Remarks Viewing the configuration information Viewing the configuration information of host, adapters, ASIC, port, device, etc. Setting the adapter Setting the driver parameter, iSCSI target and NPIV function.

OCM Window Element Definitions

The OCM window contains five basic components: the menu bar, the toolbar, the discovery-tree, the property tabs, and the status bar.

(1) Main Window

A B C D

E

A : Menu bar

The commands : File, Edit, View, Port, Discovery, Batch, Help are located in the menu bar. Many of the menu bar commands are also available from the toolbar.

B : Toolbar

The OneCommand Manager application GUI (in Windows) 3-9

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

The buttons : Discovery Refresh, Reset, Host View, Fabric View, Virtual Ports View, Local HBAs Only, Show Host Groups, Find Host and search, Refresh LUNS, Help are located in the menu bar. Many of the toolbar functions are also available from the menu bar.

C : Property Tabs

The property tabs display configuration, statistical and status information for network elements. The set of available tabs is context-sensitive, depending on the type of network element or adapter port currently selected in the discovery-tree.

D: Discovery-Tree

The icons : local host, Other hosts, adapter, port, iSCSI, FCoE, NIC, ASIC, Virtual port, COMSTAR, Target, LUN, Media Exchanger, Tape LUN, Target Controller, Switch are located in the discovery-tree (left pane).

E : Status Bar

The status bar displays messages about OCM functions, such as "Discovery in progress" or the progress when performing an "Export SAN Info" operation.

(2) Commands in the menu bar

- File menu

Table 3-5: Command function Remarks Management Mode Configures Management Mode or TCP/IP Ver.6.1.34.1 or later Management Mode Export SAN Info Creates reports about discovered SAN elements. Reports are generated in .xml and .csv format. Exit Quits OCM

3-10 The OneCommand Manager application GUI (in Windows)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

- Edit menu

Table 3-6: Command function Remarks Find Enables you to search by host name for a particular host in the discovery-tree. Find Next Continues searching for more instances of the name you specified.

- View menu

Table 3-7: Command function Remarks Tool bar The toolbar is visible by default. Use the Toolbar item in the View menu to hide the toolbar. If the item is checked, the toolbar is visible. Status Bar The status bar is visible by default. Use the Status Bar item in the View menu to hide the status bar. When checked, the status bar is visible. Group Adapter by Host Displays the discovery-tree by Host Name. Name Group Adapter by Fabric Displays the discovery-tree by Fabric Address. Address Group Adapter by Virtual Displays the discovery-tree by Virtual Port. Port Show Host Groups - Displays hosts by their associated groups. - Displays available host groups. Manage Host Groups... Configures the host groups iSCSI Name Displays by iSCSI name. iSCSI Aliases Displays by iSCSI Aliases. Expand/Collapse tree to Displays the discovery-tree expand expression by Group, Host/Fabric Adapters, Ports, PCI Function, VirtualPorts, or Targets.

The OneCommand Manager application GUI (in Windows) 3-11

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

- Port menu

Table 3-8: Command function Remarks Reset Port... Resets the specified port. Edit Name... --- Not supported Use Default Name --- Not supported

- Discovery menu

Table 3-9: Command function Remarks Modify Settings... --- Not supported Refresh Refreshes the device to be connected with. Refresh LUNs Refreshes the LUN to be connected with. This command is enabled when the "Target" icon is selected. TCP/IP --- Not supported

- Batch menu

Table 3-10: Command function Remarks Download Firmware... --- Not supported Update Driver Parameter... --- Not supported

3-12 The OneCommand Manager application GUI (in Windows)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

- Help menu

Table 3-11: Command function Remarks Contents Displays the OCM's online help. About OneCommand (TM) Displays the version information of OCM Manager

(3) Toolbar Buttons

The toolbar buttons perform the following tasks:

Table 3-12: Button task Remarks

Discovery Refresh button

- Initiates a discovery refresh cycle.

Reset button

- Resets the selected adapter.

Host View button (default)

- Displays the host system. - Displays the installed adapters within each host system. - Displays adapter ports and the port numbers if available. - Displays adapters by the WWNN if multiple adapters have the same model number. - Displays the WWPN if targets are present. Multiple adapters can refer to the same target. - Displays the LUN number if LUNs are present.

Fabric View button

- Displays the FC/FCoE fabrics in the SAN with their fabric IDs. - Displays the ports under each switch. - If targets are present, displays each WWPN. Multiple adapters can refer to the same target. - If LUNs are present, displays each LUN number. - If the fabric ID is all zeros, no fabric is attached. Note: iSCSI and NIC ports are not displayed in Fabric View.

Virtual Ports View button

- Displays virtual ports in the SAN. Note: iSCSI and NIC ports are not displayed in Virtual Ports View.

Local HBAs Only button

- Displays only local adapters.

Show Host Groups button and menu

- Displays hosts by their associated groups. - Displays available host groups.

The OneCommand Manager application GUI (in Windows) 3-13

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

Find Host button and search field

- Enables you to search by host name for a particular host in the discovery- tree.

Refresh LUNS button

- Initiates a LUN discovery refresh cycle.

Help button

- Displays the OCM's online help. - Displays the About OCM dialog box. The dialog box displays version information including; RMAPI, Discovery, DFClib, MILI Service Version, MILI Library Version and Remote Management Agent Version.

(4) Discovery-Tree Icons

Discovery-tree icons represent the following:

Table 3-13: Icon Content Remarks The local host.

Other hosts connected to the system.

A green adapter icon with black descriptive text represents an online adapter. Blue text represents an adapter port that had previously been discovered, but currently is not being seen by the discovery engine (service). The adapter is removed from the discovery-tree if it still is not seen after the undiscovered adapter expiration time has elapsed (default is 1800 seconds, or 30 minutes). If the adapter is discovered again before the expiration time has elapsed, it reverts back to normal black text.

The port icon represents an adapter port. A port icon with a red X indicates

the link is down. Note: Multiport adapters are represented in the discovery-tree with separate port icons for each port with the port number displayed next to the icon. The iSCSI icon represents an iSCSI PCI function instance. iSCSI functions can support up to sixteen logical adapters, with each logical adapter appearing in the discovery-tree as a separate child node under the respective iSCSI function. The green iSCSI icon represents an iSCSI PCI function on-line instance. A black iSCSI icon represents an iSCSI PCI function port-disabled instance. A red iSCSI icon represents an iSCSI PCI function link down instance. The green FCoE icon represents an FCoE PCI function on-line instance. A black FCoE icon represents an FCoE PCI function port-disabled instance. A red FCoE icon represents an FCoE PCI function link down instance. The NIC icon represents a NIC-Only PCI function instance. A green icon indicates this function instance is on-line, black indicates it is disabled, and red indicates a link down instance. The ASIC node icon, only displayed for OneConnect dual ASIC 4 port 8Gb/s FC adapters, represents each ASIC on the adapter. Each ASIC is managed independently. The ASIC node format "ASIC bus#-sub-adapter#" represents the PCI bus number and the sub-adapter number, which is a concatenation of the discovered port numbers for the ASIC. For example, "ASIC 64-12" represents PCI bus number 64, and 12 represents ports 1 and 2. If there were no discovered functions for a port on that ASIC, the label would be "ASIC 64-2" (port 1 is missing).

3-14 The OneCommand Manager application GUI (in Windows)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

The Virtual Port icon represents a virtual port.

The COMSTAR icon represents COMSTAR target mode ports. Not supported The Target icon represents connections to individual storage devices.

The LUN icon represents connections to individual disk LUNs.

The Media Exchanger icon represents connections to individual media Not exchangers. A media exchanger is a jukebox-like device that is capable of supported swapping various media device instances (such as records or CDs) in and out. The Tape LUN icon represents LUNs that are tape devices. Not supported The Target Controller LUN icon represents LUNs that are storage controllers.

The Switch icon represents connections to the switch.

Configuration Information

(1) Host information

There are two tabs that show host information: the Host Information tab and the Host Driver Parameters tab. The Host Information tab is read-only. The Host Driver Parameters tab enables you to view and define adapter driver settings for a specific host.

1. From View menu, click "Group Adapters by Host Name".

2. Select a host in the discovery-tree.

3. Select a tab.

The OneCommand Manager application GUI (in Windows) 3-15

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

- Host Information Tab

The Host Information tab displays information for the selected host such as the number of adapters installed in the selected host and the number of fabrics to which it is connected.

Table 3-14: Item Content Remarks Operating System The operating system and version installed on the selected host. Management IP If the host is discovered with FC, the Management IP Address Address field display "Host discovered over Fibre Channel" If the host has been added with TCP/IP access, the Management IP Address field displays the host's IP address, for example, 138.239.82.131. "Local Host" is displayed if you selected the host you are actually launching from. Remote Manager The version of the OCM server that is running on the host. If Server Version different versions of the OCM are installed on different hosts in the SAN, those differences appear in this field. Number of Adapters The number of adapters installed in the host. Number of Physical The number of discovered physical ports that can be managed by Ports this host. NIC Functions The number of NIC functions running on the discovered adapters on this host. FC Functions The number of FC functions running on the discovered adapters on this host. FCoE Functions The number of FCoE functions running on the discovered adapters on this host. FC Targets The number of FC targets discovered on the FC/FCoE functions on this host. VPorts The number of discovered virtual ports that can be managed by this host. (Not supported on VMware ESX servers being managed through the CIM interface.) iSCSI Functions The number of iSCSI functions running on the discovered adapters on this host. iSCSI Targets The number of iSCSI targets discovered on the iSCSI functions on this host.

3-16 The OneCommand Manager application GUI (in Windows)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

- Host Driver Parameters Tab

The Host Driver Parameters tab enables you to view and edit the adapter driver parameter settings contained in a specific host. The host driver parameters are global values and apply to all adapters in that host unless they are overridden by parameters assigned to a specific adapter using the adapter Driver Parameters tab. For each parameter, the tab shows the current value, the range of acceptable values, the default value, and whether the parameter is dynamic.

Table 3-15: Item Content Remarks Installed Driver Type The current drivers installed on this host. Adapter Parameter A list of adapter driver parameters for the selected driver type and their current values. Modify Adapter Adapter-specific information is displayed in this area. This can Parameter Area include value, range, default, activation requirements and description. Value Enter a new value in the Value field in the same hexadecimal or decimal format as the current value or select a value from the drop-down menu. If you enter a value and the current value is in hexadecimal format, it is prefaced by "0x" (for example, 0x2d). You can enter a new hexadecimal value without the "0x". make all changes If you want the change to be temporary (causing the parameter temporary to revert to its last permanent setting when the system is (if possible) rebooted), check the Make change temporary box. This option is available only for dynamic parameters. Restore Button If you changed driver parameters, but did not click Apply and you want to restore the parameters to their last saved values, click Restore. Defaults Button Click to reset all driver parameter values to their default (out-of- box) values. Apply Button Click to apply any driver parameter changes. If you changed a driver parameter that is not dynamic, you may need to reset the adapter port or create a new ramdisk and reboot the system.

The OneCommand Manager application GUI (in Windows) 3-17

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

(2) Configuration information of onboard CNA / CNA expansion card / LAN expansion card

The property tabs of "Adapter" icon are explained below.

- Adapter Information Tab (for 2-port onboard CNA)

Table 3-16-1 : Item Content Remarks Model The model of the selected adapter. Serial Number The serial number of the selected adapter. Active Firmware The firmware version currently being used by the adapter. Version Firmware State The condition of the firmware. BIOS Version The version of the BIOS in use. HW Version The hardware version of the selected adapter. NCSI Version The Network Controller Sideband Interface version. IPL File Name The name of the IPL (Initial Program Load) file currently loaded. PCI Express Link The speed of the PCI bus in which the adapter running. Speed PCI Express Bus Width The number of lanes for the slot in which the adapter is running. Adapter Temperature If the adapter's temperature is not available, "Not Supported" is displayed. If supported by the adapter, this field displays the adapter's temperature and one of the following temperature-related status messages: - Normal: The adapter's temperature is within normal operational range. - Warning: The adapter's temperature is beyond normal operational range. If the temperature continues to increase, the adapter shuts down. You must determine the cause of the temperature problem and fix it immediately. - Exceeds operational range: The temperature has reached critical limit. You must determine the cause of the temperature problem and fix it before resuming operation.

3-18 The OneCommand Manager application GUI (in Windows)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

After the system overheating issue is resolved and the adapter has cooled down, reboot the system or, if the system supports hot swapping, cycle the power of the adapter slot. Personality Area - Current : The current personality in use by the adapter. - After Reboot : (Not supported) - Apply button : (Not supported) License Features --- Not supported

[Personality - After Reboot] configuration is not supported. See "Hitachi Compute Blade Emulex Adapters User's Guide for Hardware" for the personality change.

- Adapter Information Tab (for 4-port onboard CNA)

Table 3-16-2 : Item Content Remarks Model The model of the selected adapter. Serial Number The serial number of the selected adapter. Active Firmware The firmware version currently being used by the adapter. Version Firmware State The condition of the firmware. BIOS Version The version of the BIOS in use. HW Version The hardware version of the selected adapter. NCSI Version The Network Controller Sideband Interface version. IPL File Name The name of the IPL (Initial Program Load) file currently loaded. PCI Express Link The speed of the PCI bus in which the adapter running. Speed PCI Express Bus Width The number of lanes for the slot in which the adapter is running.

The OneCommand Manager application GUI (in Windows) 3-19

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

Adapter Temperature If the adapter's temperature is not available, "Not Supported" is displayed. If supported by the adapter, this field displays the adapter's temperature and one of the following temperature-related status messages: - Normal: The adapter's temperature is within normal operational range. - Warning: The adapter's temperature is beyond normal operational range. If the temperature continues to increase, the adapter shuts down. You must determine the cause of the temperature problem and fix it immediately. - Exceeds operational range: The temperature has reached critical limit. You must determine the cause of the temperature problem and fix it before resuming operation. After the system overheating issue is resolved and the adapter has cooled down, reboot the system or, if the system supports hot swapping, cycle the power of the adapter slot.

- Adapter Information Tab (for CNA expansion card/LAN expansion card)

Table 3-17: Item Content Remarks Model The model of the selected adapter. Serial Number The serial number of the selected adapter. HW Version The hardware version of the selected adapter. ASICs The number of ASICs on the selected adapter.

The information of CNA expansion card or LAN expansion card that corresponds to "Adapter Information" of onboard CNA is displayed in ASIC Information tab.

3-20 The OneCommand Manager application GUI (in Windows)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

The property tabs of "ASIC node" icon are explained below.

- ASIC Information Tab (for CNA expansion card / LAN expansion card)

Table 3-18: Item Content Remarks Model The model of the selected adapter. Serial Number The serial number of the selected adapter. Active Firmware The firmware version currently being used by the adapter. Version Firmware State The condition of the firmware. BIOS Version The version of the BIOS in use. HW Version The hardware version of the selected adapter. NCSI Version The Network Controller Sideband Interface version. IPL File Name The name of the IPL (Initial Program Load) file currently loaded. PCI Express Link The speed of the PCI bus in which the adapter running. Speed PCI Express Bus Width The number of lanes for the slot in which the adapter is running. Adapter Temperature If the adapter's temperature is not available, "Not Supported" is displayed. If supported by the adapter, this field displays the adapter's temperature and one of the following temperature-related status messages: - Normal: The adapter's temperature is within normal operational range. - Warning: The adapter's temperature is beyond normal operational range. If the temperature continues to increase, the adapter shuts down. You must determine the cause of the temperature problem and fix it immediately. - Exceeds operational range: The temperature has reached critical limit. You must determine the cause of the temperature problem and fix it before resuming operation. After the system overheating issue is resolved and the adapter has cooled down, reboot the system or, if the system supports hot swapping, cycle the power of the adapter slot.

The OneCommand Manager application GUI (in Windows) 3-21

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

Personality Area - Current : The current personality in use by the adapter. - After Reboot : (Not supported) - Apply button : (Not supported) License Features --- Not supported

Personality - After Reboot configuration is not supported. See "Hitachi Compute Blade Emulex Adapters User's Guide for Hardware" for the personality change.

- Firmware Tab

Table 3-19-1: Item Content Remarks Active Firmware The firmware version currently being used by the adapter. Version Flash Firmware The flash firmware version currently being used by the Version adapter. BIOS Version The version of the BIOS currently being used by the adapter. Boot Code Versions The version of boot code and so on. Area Download Firmware --- Not Button supported Diagnostic Dump --- Not Button supported

3-22 The OneCommand Manager application GUI (in Windows)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

- Firmware Tab (4-port onboard CNA)

Table 3-19-2: Item Content Remarks Active Firmware The firmware version currently being used by the adapter. Version Flash Firmware The flash firmware version currently being used by the Version adapter. BIOS Version The version of the BIOS currently being used by the adapter. Boot Code Versions The version of boot code and so on. Area Download Firmware --- Not Button supported Diagnostic Dump --- Not Button supported

The OneCommand Manager application GUI (in Windows) 3-23

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

- Adapter Configuration Tab (4-port onboard CNA) (Not supported)

The property tabs of "port" icon are explained below.

- Physical Port Info Tab

Table 3-20: Item Content Remarks PCI Function Summary displays the number of logical ports of NIC/iSCSI/FCoE Area physical Port Status - Status : displays current connection status Area - Interface Type :

3-24 The OneCommand Manager application GUI (in Windows)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

- Configured Speed : - DAC Cable Length : - Disable Port Button : When you disable a physical port, you disable all functions, such as iSCSI and NIC, for the port. Disabled ports appear in the discovery-tree as a black port icon. Note: You cannot disable a port if PXE Boot is enabled or if any of the iSCSI target sessions are boot sessions. - Set Speed Button : (Not supported)

- DCB Tab

Table 3-21: Item Content Remarks DCBX State The current DCBX (Data Center discovery and Capability exchange protocol) state (enabled or disabled). DCBX Mode The DCBX mode can be either DCB or CIN. Note: DCBX mode also configures FIP mode. If DCBX mode is DCB, FIP is enabled. If it is CIN, FIP is disabled. LLDP Transmit State DCBX uses Link Layer Discovery Protocol (LLDP) to exchange parameters between two link peers. For the DCBX protocol to operate correctly, both LLDP Rx and Tx must be enabled. If either Rx or Tx is disabled, DCBX is disabled. LLDP Receive State DCBX uses LLDP to exchange parameters between two link peers. For the DCBX protocol to operate correctly, both LLDP Rx and Tx must be enabled. If either Rx or Tx is disabled, DCBX is disabled. PFC Properties Area - State : Enabled means that flow control in both directions (Tx and Rx) is enabled. - Active Priority : Lists the priorities with PFC set to Enabled. - Sync'd : If yes, the PFC priorities have been set by the peer. This parameter cannot be set. - Error : The error state. This capability indicates whether an error has occurred during the configuration exchange with the peer.Error is also set to YES when the Compatible method for the capability fails.

The OneCommand Manager application GUI (in Windows) 3-25

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

FCoE Properties Area - State : The FCoE state. It can be Enabled or Disabled. (FCoE ports only) - Active Priorities : The current active priority assigned for FCoE. - Sync'd : If yes, the FCoE priority has been set by the peer. This parameter cannot be set. - Error : The FCoE error state. This capability indicates whether an error has occurred during the configuration exchange with the peer. Error is also set to YES when the Compatible method for the capability fails. iSCSI Properties Area - State : The iSCSI state. It can be Enabled or Disabled. - Active Priorities : The current active priority assigned for iSCSI. - Sync'd : If yes, the iSCSI priority has been set by the peer. This parameter cannot be set. - Error : The iSCSI error state. This capability indicates whether an error has occurred during the configuration exchange with the peer. Error is also set to YES when the Compatible method for the capability fails. ETS Priority Group - State : The FCoE or NIC-only state. It can be Enabled or Properties Area Disabled. - Sync'd : If yes, the Priority Groups have been set by the peer. This parameter cannot be set. - Error : The error state. This capability indicates whether an error has occurred during the configuration exchange with the peer. Error is also set to YES when the Compatible method for the capability fails.

Active Groups - PG : The Priority Group number. It can be 0 to 7. - Priorities : The priorities that are assigned to each Priority Group. It is represented in comma separated format. - Bandwidth % : The percentage of available link bandwidth allocated to a particular Priority Group. - Max Configurable PGs : This field indicates maximum number of priority groups that can be configured on the selected OneConnect adapter port. Configure DCB Button --- Not supported

- Diagnostics Tab (Not supported)

3-26 The OneCommand Manager application GUI (in Windows)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

- Transceiver Data Tab (Not supported)

- Channel Management Tab (Not supported)

Channel Management tab of "OneCommand Manager ver.6.3.16.1-1(or higher)" is not supported. See "Hitachi Compute Blade Emulex Adapters User's Guide for Hardware" - "4.1.3 MultiChannel configuration" to configure the BW(Bandwidth).

The OneCommand Manager application GUI (in Windows) 3-27

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

The property tabs of "NIC" icon are explained below.

- Port Information Tab

Table 3-22: Item Content Remarks Driver Name The NIC driver file name. Driver Version The NIC driver version. MAC Address The NIC MAC address currently assigned to the port. Perm MAC Address The original factory assigned NIC MAC address. IPv4 Address The IPv4 address for the NIC port. Subnet Mask The subnet mask for the NIC port. Gateway Address The NIC initiator gateway address. Link Status The status of the link on the selected adapter port. Interface Name The interface assigned to this port by the host operating system. Port Speed The current port speed of the selected port. IPv6 Address The IPv6 address for the NIC port. Device ID The PCI device ID assigned to the NIC function. SubSys Device ID The PCI subsystem ID assigned to the NIC function. Vender ID The PCI vendor ID assigned to the NIC function. SubSys Vender ID The PCI subsystem vendor ID assigned to the NIC function. IP Address Origin The origin of the IP address (DHCP or Static). PCI Function The PCI function number assigned to the NIC function. PCI Bus Number The PCI BUS number assigned to the NIC function. Max MTU The maximum transmission unit for iSCSI traffic. Current MTU The current transmission unit for iSCSI traffic. Bandwidth Limit The QoS bandwidth restriction on the port. (Non vNIC adapters only) Enable PXE Boot --- Not supported

[Enable PXE Boot] function is not supported. See "Hitachi

Compute Blade Emulex Adapters User's Guide for Hardware" for changing the PXE Boot configuration.

3-28 The OneCommand Manager application GUI (in Windows)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

- PCI Registers Tab

- VPD Tab

PCI Registers Table 3-23: Item Content Remarks Product Name Product information about the selected adapter port. PN (Part Number) The adapter's part number. SN (Serial Number) The adapter's serial number. VO Vendor unique data. "V" indicates a vendor-specific field. An adapter may have none, one or more of these fields defined. Valid values for this field are "VO" (the letter "O", not the number zero) and "Vx" (where "x" is a number).

The OneCommand Manager application GUI (in Windows) 3-29

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

The property tabs of "iSCSI" icon are explained below. - Port Information Tab

displayed in Ver. 6.1.14.1 or later

Table 3-24: Item Content Remarks Driver Name The iSCSI driver file name. Driver Version The iSCSI driver version. MAC Address The iSCSI MAC address currently assigned to the port. Perm MAC Address The original factory-assigned iSCSI MAC address. Device ID The PCI device ID assigned to the iSCSI function. Vender ID The PCI vendor ID assigned to the iSCSI function. PCI Function The PCI function number assigned to the iSCSI function. LDTO (Link Down Time Out) The amount of time in seconds that the iSCSI driver delays reporting a link down error to the operating system. Max MTU Maximum transmission unit for iSCSI traffic. Default ETO The default extended timeout. Max CDB Length Maximum SCSI command descriptor block size. SubSys Device ID The PCI subsystem ID assigned to the iSCSI function. SubSys Vender ID The PCI subsystem vendor ID assigned to the iSCSI function. PCI Bus Number The PCI bus number assigned to the iSCSI function. TCP/IP Info Area - DHCP Enabled : The DHCP authentication status of the selected port. - IP Address : The iSCSI initiator IP address. - Subnet Mask : The iSCSI initiator subnet mask. - Gateway Address : The iSCSI initiator gateway address. - VLAN Enabled : The VLAN enabled state for the iSCSI interface. - VLAN ID : The VLAN identifier to use 0-4094 (only valid when VLAN is enabled). - 0 indicates the VLAN is disabled. - VLAN Priority : The VLAN priority for the iSCSI interface. Modify... Button Enables you to change TCP/IP settings for the selected port. You can change the port's VLAN tag, priority, IP address and more. Network Info Area - Link Status : The status of the link on the selected adapter port. - Port Speed : The port speed at which the selected port is running. Enable iSCSI Boot --- Not check box supported

3-30 The OneCommand Manager application GUI (in Windows)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

[Enable iSCSI Boot] function is not supported. See "Hitachi Compute Blade Emulex Adapters User's Guide for Hardware" for changing the iSCSI Boot configuration.

- PCI Registers Tab

The OneCommand Manager application GUI (in Windows) 3-31

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

- iSNS Tab (Not supported)

VPD Tab

Table 3-25: Item Content Remarks Product Name Product information about the selected adapter port. PN (Part Number) The adapter's part number. SN (Serial Number) The adapter's serial number. VO Vendor unique data. "V" indicates a vendor-specific field. An adapter may have none, one or more of these fields defined. Valid values for this field are "VO" (the letter "O", not the number zero) and "Vx" (where "x" is a number).

3-32 The OneCommand Manager application GUI (in Windows)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

The property tabs of "Virtual Port" icon under "iSCSI" icon are explained below.

- iSCSI Statistics Tab

Table 3-26: Item Content Remarks Node Roles The node role for this iSCSI initiator. Portal Count The number of rows in the iscsiPortaltypeTable which are currently associated with this iSCSI instance. Node Count The number of rows in the iscsiNodetypeTable which are currently associated with this iSCSI instance. Session Count The number of rows in the iscsiSessiontypeTable which are currently associated with this iSCSI instance. Session Failure Count The number of times a session belonging to this port has failed. Last Session Failure The type of failure encountered in the last session failure. Type Last Session Remote The iSCSI name of the remote node from the failed session. Node Name Session Digest Errors The count of sessions which failed due to receipt of a PDU containing header or data digest errors. Session Connection The count of sessions which failed due to a sequence exceeding Timeout a time limit. Session Format Errors The count of sessions which failed due to receipt of an iSCSI PDU that contained a format error. Login Failures The number of times a login from this initiator failed. Last Failure Time The timestamp of the most recent failure of a login attempt from this initiator. A value of 0 indicates that no failures have occurred. Last Failure Type A description of the last failure. Last Target Failure The UTF-8 string name of the target that most recently failed a Name login request from this initiator. Last Target Failure The Internet Network Address of the target that most recently Address failed. Login Accept The count of Login Response PDUs received by this initiator Responses that were accepted. Login Other Fail The count of Login Response PDUs received by this initiator

The OneCommand Manager application GUI (in Windows) 3-33

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

Responses with any status code not counted by the other objects. Login Redirect The count of Login Response PDUs received by the initiator with Response status class Redirection. Login Authentication The count of Login Response PDUs with status class 0x201 Fail Responses Authentication Failed received by this initiator. Login Authentication The number of times the initiator has aborted a login because Failures the target could not be authenticated. Login Negotiation The number of times the initiator has aborted a login because Failures parameter negotiation with the target failed. Logout Normals The count of Logout Command PDUs generated by this initiator with reason code normal. Logout Others The count of Logout Command PDUs generated by this initiator with any status code other than normal. Port Row Status This field allows entries to be dynamically added and removed from this table via Simple Network Management Protocol (SNMP). Portal Role The role of a portal. A portal can operate in either one of two roles as a target portal and/or an initiator portal. Portal Protocol The portal's transport protocol. Portal Tag The portal's aggregation tag when the portal is used as an initiator.

- iSCSI Initiator Login Options Tab

Table 3-27: Item Content Remarks iSCSI Names Area - Initiator iSCSI Name : The iSCSI qualifier name of the initiator. - Initiator Alias : An optional non-unique string used to identify the initiator. Initiator Login Options --- Not Area supported Authentication Area - Authentication Method : Three options are available for the Authentication method: "None", "One-Way CHAP" and "Mutual CHAP". One-Way CHAP requires only that the authenticator

3-34 The OneCommand Manager application GUI (in Windows)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

(iSCSI target) authenticate the iSCSI initiator. Mutual CHAP requires that both the iSCSI target and iSCSI initiator authenticate each other. When "None" is selected, no authentication is performed. - Target CHAP Name : The iSCSI login name sent by the initiator to the target for authentication. This parameter is required for both One-Way CHAP and Mutual CHAP authentication. The parameter is also known as the username. It can be any sequence of characters and numbers. The minimum length of the name is 1 character and the maximum length is 256 characters. - Target Secret : The iSCSI login secret sent by the initiator to the target for authentication. This parameter is required for both One-Way CHAP and Mutual CHAP authentication. It can be any sequence of characters and numbers. The minimum length of the secret is 12 characters and maximum length is 16 characters. - Initiator CHAP Name : The iSCSI login name sent by the target to the initiator for authentication. This parameter is only required for Mutual CHAP authentication. The parameter is also known as the username. It can be any sequence of characters and numbers. The minimum length of the name is 1 character and the maximum length is 256 characters. - Initiator Secret : The iSCSI login secret sent by the target to the initiator for authentication. This parameter is only required for Mutual CHAP authentication. It can be any sequence of characters and numbers. The minimum length of the secret is 12 characters and the maximum length is 16 characters. Apply Changes Button Click this button to save and apply your changes. View Default Login Click this button to see the default login settings. Options...Button

[ImmediateData], [HeaderDigest], [DataDigest], [Authentication Method] functions are not supported. Use these functions in default configurations.

The OneCommand Manager application GUI (in Windows) 3-35

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

- iSCSI Target Discovery Tab

Table 3-28: Item Content Remarks Target Portals The Target Portals table contains all target portals that are queried for targets. Depending on the SAN setup, the contents of this table may be a subset of the available target portals, or it could contain the full set of target portals for all iSCSI targets. Add Portal Button Click to add a target portal. Remove Portal Button Click to remove a portal. Targets The Targets table contains all currently discovered targets. Targets in this table come from one of three possible sources: - The target was manually added. - The target was discovered via a target portal. - The target was found through an iSNS server query. Target Login... Button Click to log in to a selected target. Manually Add Target... Click to manually add an iSCSI target. Button Target Sessions... Click to view active sessions for the selected target. Button Remove Target... Click to manually remove an iSCSI target. Button Refresh Target Click to manually force a complete rediscovery of the targets, querying all configured iSNS servers and target portals.

3-36 The OneCommand Manager application GUI (in Windows)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

The property tabs of "Target" icon under "iSCSI" - "Virtual Port" icon are explained below.

- Target Information Tab

Table 3-29: Item Content Remarks Target iSCSI Name The iSCSI name assigned to the target. Target Alias The iSCSI alias assigned to the target. This is assigned at the target portal, not by the OCM. ETO (Extended Timeout Value) The ETO for the target. The driver ensures that I/Os are not "timed out" until this time has expired (from the time the target stopped responding). You can change this value if you want. Target Portal - IP Address : The IP address through which the initiator Information Area communicates with the target. - Port : The TCP port through which the initiator communicates with the target. - Group Tag : The tag of the group for which sub-groups must be refreshed. Sessions... button Click to view the currently active sessions for the target. Apply Button Click to save and apply your ETO changes.

The OneCommand Manager application GUI (in Windows) 3-37

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

The property tabs of "LUN" icon under "iSCSI" - "Virtual Port" – "Target" icon are explained below.

- LUN Information Tab

Table 3-30: Item Content Remarks Vendor Name The name of the vendor of the LUN. Model Number The vendor's model number for the LUN. LUN Name The name of the LUN. (Available only on ESX platforms.) Serial Number The vendor's serial number for the LUN. Capacity The un-formatted size of the LUN. Block Size The size of a logical unit block in bytes.

3-38 The OneCommand Manager application GUI (in Windows)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

(3) Configuration information of FC expansion card / CNA expansion card(FCoE mode) / onboard CNA(FCoE mode)

The property tabs of "Adapter" icon are explained below.

- Adapter Information Tab (FC expansion card)

Table 3-31: Item Content Remarks Model The complete model name of the adapter. Serial Number The manufacturer's serial number for the selected adapter. Hardware Version For LightPulse adapters it displays the JEDEC ID. For OneConnect adapters it displays the board type and revision code. Device ID The default device ID for the selected adapter. (Not supported on VMware ESX servers being managed through the CIM interface.) Adapter Temperature If the adapter's temperature is not available, "Not Supported" is displayed. If supported by the adapter, this field displays the adapter's temperature and one of the following temperature- related status messages: - Normal : The adapter's temperature is within normal operational range. - Warning : The adapter's temperature is beyond normal operational range. If the temperature continues to increase, the adapter shuts down. You must determine the cause of the temperature problem and fix it immediately. - Exceeds operational range : Adapter stopped: The temperature has reached critical limit, forcing the adapter to shut down. You must determine the cause of the temperature problem and fix it before resuming operation. After the system overheating issue is resolved and the adapter has cooled down, reboot the system or, if the system supports hot swapping, cycle the power of the adapter slot.

The OneCommand Manager application GUI (in Windows) 3-39

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

- Firmware Tab (FC expansion card)

Table 3-32: Item Content Remarks Active Firmware Version The firmware version currently being used by the adapter. Flash Firmware Version The firmware version used by the adapter in next booting. Download Firmware - Not supported Diagnostic Dump - Not supported

[Download Firmware] button is not supported. [Diagnostic Dump ] button is not supported.

3-40 The OneCommand Manager application GUI (in Windows)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

The property tabs of "port" icon are explained below.

- Port Information Tab (FC expansion card)

Table 3-33: Item Content Remarks Port Attributes Area - Port WWN : The Port of the adapter. - Node WWN : The Node World Wide Name of the selected adapter. - Fabric Name or Host Name : The Fabric Name field is displayed in Host view. This is a 64-bit worldwide unique identifier assigned to the fabric. The Host Name is displayed in Fabric view. The host name is the name of the host containing the adapter. (Not supported on VMware ESX servers being managed through the CIM interface.) - Boot Version : The version of boot code installed on the selected adapter port. If the boot code is disabled, the field displays "Disabled". - Port FC ID : The FC ID for the selected adapter port. - Driver Version : The version of the driver installed for the adapter. - Driver Name : The executable file image name for the driver as it appears in the Emulex driver download package. - Firmware Version : The version of Emulex firmware currently active on the adapter port. - Discovered Ports : The number of mapped and unmapped ports found during discovery by the Emulex adapter driver. The mapped ports are targets and the unmapped ports are non- targets such as switches or adapters. - Port Type : The FC type of the selected adapter's port. (Not available if the port link is down.) - OS Device Name : The platform-specific name by which the selected adapter is known to the operating system. (Not supported on VMware ESX servers being managed through the CIM interface.) - Symbolic Node Name : The FC name used to register the driver with the name server. - Supported Class of Service : A frame delivery scheme

The OneCommand Manager application GUI (in Windows) 3-41

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

exhibiting a set of delivery characteristics and attributes. There are three classes of service. . Class 1 provides a dedicated connection between a pair of ports with confirmed delivery or notification of non-delivery. . Class 2 provides a frame switched service with confirmed delivery or notification of non-delivery. . Class 3 provides a frame switched service similar to Class 2 but without notification of frame delivery or non-delivery. - Supported FC4 Types : A 256-bit (8-word) map of the FC-4 protocol types supported by the port containing the selected adapter. Port Status Area - Link Status : The status of the link on the selected adapter port. - Port Speed : The current port speed of the selected adapter port. Enable/Disable Port Click to enable or disable the selected FC port. Button Loop Map Table The loop map shows the different ports present in the loop, and is present only if the port (adapter) is operating in loop mode. The simplest example would be to connect a JBOD directly to an adapter. When this is done, the port type is a private loop, and the loop map has an entry for the adapter, and one entry for each of the disks in the JBOD. (Not supported on VMware ESX servers being managed through the CIM interface.)

- Port Information Tab (CNA expansion card / onboard CNA)

Table 3-34: Item Content Remarks Port Attributes Area - Port WWN : The Port World Wide Name of the adapter. - Node WWN : The Node World Wide Name of the selected adapter. - Fabric Name or Host Name : The Fabric Name field is displayed in Host view. This is a 64-bit worldwide unique identifier assigned to the fabric. The Host Name is displayed in Fabric view. The host name is the name of the host containing

3-42 The OneCommand Manager application GUI (in Windows)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

the adapter. - Boot Version : The version of boot code installed on the selected adapter port. If the boot code is disabled, the field displays "Disabled". - Port FC ID : The FCoE ID for the selected adapter port. - PCI Function : The PCI function number assigned by the system. - Driver Version : The version of the driver installed for the adapter. - Driver Name : The executable file image name for the driver as it appears in the Emulex driver download package. - Firmware Version : The version of Emulex firmware currently active on the adapter port. - Discovered Ports : The number of mapped and unmapped ports found during discovery by the Emulex adapter driver. The mapped ports are targets and the unmapped ports are non- targets such as switches or adapters. - Port Type : The current operational mode of the selected adapter's port. - Enable PFC Throttle checkbox : PFC throttle is enabled by default to prevent the loss of FCoE packets. Uncheck the box to disable PFC throttle. Note: The checkbox does not appear if the adapter does not support PFC throttle. - OS Device Name : The platform-specific name by which the selected adapter is known to the operating system. - Supported Class of Servic : A frame delivery scheme exhibiting a set of delivery characteristics and attributes. There are three classes of service. . Class 1 provides a dedicated connection between a pair of ports with confirmed delivery or notification of non-delivery. . Class 2 provides a frame switched service with confirmed delivery or notification of non-delivery. . Class 3 provides a frame switched service similar to Class 2 but without notification of frame delivery or non-delivery. - Supported FC4 Types : A 256-bit (8-word) map of the FC-4 protocol types supported by the port containing the selected adapter. Port Status Area - Link Status : The status of the link on the selected adapter port. - Port Speed : The current port speed of the selected adapter port. - Bandwidth Limit : The QoS bandwidth restriction on the port.

The OneCommand Manager application GUI (in Windows) 3-43

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

- Statistics Tab (FC/FCoE)

Table 3-35: Item Content Remarks Tx Frames FC frames transmitted by this adapter port. Tx Words FC words transmitted by this adapter port. Tx KB Count FC kilobytes transmitted by this adapter port. Tx Sequences FC sequences transmitted by this adapter port. LIP count The number of loop initialization primitive (LIP) events that have occurred for the port. This field is not supported if the topology is not arbitrated loop. Loop initialization consists of the following: - Temporarily suspending loop operations. - Determining whether loop capable ports are connected to the loop. - Assigning AL_PA IDs. - Providing notification of configuration changes and loop failures. - Placing loop ports in the monitoring state. Error Frames The number of frames received with cyclic redundancy check (CRC) errors. Link Failures The number of times the link has failed. A link failure is a possible cause of a timeout. Loss of Signal The number of times the signal was lost. Invalid Tx Words The total number of invalid words transmitted by this adapter port. Ex Count Orig The number of FC exchanges originating on this port. (Not supported on VMware ESX servers being managed through the CIM interface.) Active XRIs The number of active exchange resource indicators. (Not supported on VMware based ESX platforms using the CIM interface.) Received P_BSY The number of FC port-busy link response frames received. Link Transitions The number of times the SLI port sent a link attention condition. Elastic Buf Overruns The number of times the link interface has had its elastic buffer overrun. Rx Frames The number of FC frames received by this adapter port.

3-44 The OneCommand Manager application GUI (in Windows)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

Rx Words The number of FC words received by this adapter port. Rx KB Count The received kilobyte count by this adapter port. Rx Sequences The number of FC sequences received by this adapter port. (Not supported on VMware ESX servers being managed through the CIM interface.) NOS count The number of NOS events that have occurred on the switched fabric. (Not currently supported for Emulex Windows drivers or arbitrated loop.) Dumped Frames The number of frames that were lost due to a lack of host buffers available. (Not currently supported for the SCSIport Miniport driver, the Storport Miniport driver or the driver for Solaris.) Loss of Sync The number of times loss of synchronization has occurred. Prim Seq Prot Errs The primitive sequence protocol error count. This counter is incremented whenever there is any type of protocol error. Invalid CRCs The number of frames received that contain CRC failures. Ex Count Resp The number of FC exchange responses made by this port. (Not supported on VMware ESX servers being managed through the CIM interface.) Active RPIs The number of remote port indicators. (Not supported on VMware ESX servers being managed through the CIM interface.) Receive F_BSY The number of FC port-busy link response frames received. Primitive Seq Timeouts The number of times a primitive sequence event timed out. (Not supported on VMware ESX servers being managed through the CIM interface.) Arbitration Timeouts The number of times the arbitration loop has timed out.Large counts could indicate a malfunction somewhere in the loop or heavy usage of the loop. (Not supported on VMware ESX servers being managed through the CIM interface.)

The OneCommand Manager application GUI (in Windows) 3-45

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

- Maintenance Tab (8Gb FC expansion card)

Table 3-36: Item Content Remarks Firmware Area - Current Version : The Emulex firmware version number for this model of adapter. - Initial Load : The firmware version stub responsible for installing SLI code into its proper slot. - SLI-2 Name : The name of the SLI-2 firmware overlay. - Kernel Version : The version of the firmware responsible for starting the driver. - Operational Name : The name of the operational firmware for the selected adapter. - SLI-1 Name : The name of the SLI-1 firmware overlay. - SLI-3 Name : The name of the SLI-3 firmware overlay. - Adapter Boot Version : Displays one of the following: . The selected adapter port's boot code version if boot code is present. . "Disabled" if the boot code is disabled. . "Not Present" if boot code is not loaded. If boot code is not loaded, the Enable Adapter boot checkbox is not visible and you cannot configure the selected port to boot from SAN. Enable adapter boot checkbox Not supported [Download Firmware...] Button Not supported [Configure Boot... ] Button Not supported WWN Management --- Not Area supported [Change WWN...] Button Not supported

[Download Firmware...] button is not supported.

3-46 The OneCommand Manager application GUI (in Windows)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

- Maintenance Tab (FCoE)

Table 3-37: Item Content Remarks Firmware Area - Firmware Version on Flash : Specifies the firmware version stored on the adapter's non-volatile storage. When the system restarts, this version becomes the active firmware version. - Service Processor FW Version : Specifies the firmware version that is currently operational on the adapter. - Active Firmware Version : The version of firmware running on the selected adapter. - ULP FW Name : The firmware version running on the (Upper Layer Protocol) processors within the ASIC. [Configure Boot... ] Button Not supported WWN Management --- Not Area supported [Change WWN...] Button Not supported

The OneCommand Manager application GUI (in Windows) 3-47

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

- Maintenance Tab (16Gb FC expansion card)

Table 3-38: Item Content Remarks Firmware Area - Active Firmware Version : The version of firmware running on the selected adapter. - Service Processor FW Version : Specifies the firmware version that is currently operational on the adapter. - Firmware Version on Flash : Specifies the firmware version stored on the adapter's non-volatile storage. When the system restarts, this version becomes the active firmware version. - ULP FW Name : The firmware version running on the (Upper Layer Protocol) processors within the ASIC. - Adapter Boot Version : Displays one of the following: . The selected adapter port's boot code version if boot code is present. . "Disabled" if the boot code is disabled. . "Not Present" if boot code is not loaded. If boot code is not loaded, the Enable Adapter boot checkbox is not visible and you cannot configure the selected port to boot from SAN. [Configure Boot ...] Button Not supported WWN Management --- Not Area supported [Change WWN ...] Button Not supported

3-48 The OneCommand Manager application GUI (in Windows)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

- DHCHAP Tab (Not supported)

- Target Mapping Tab (FC/FCoE)

Table 3-39: Item Content Remarks Current Settings Area - Active Bind Type : WWPN, WWNN, or a destination identifier (D_ID). - Automapping : The current state of SCSI device automapping: enabled (default) or disabled. Current Mappings Area This table lists current mapping information for the selected adapter port. Persistent Binding This table lists persistent binding information for the selected Configuration Area adapter port. (Not available on VMware ESX servers being managed through the CIM interface.) Display Mode Radio Show WWPN, Show WWNN or Show D_ID options enable you Buttons to choose how to display information in the Persistent Binding Configuration table. Refresh Button Click to refresh the Target Mapping tab. Change Settings Click to enable or disable automapping, choose a bind type Not Button and enable or disable LUN mapping and unmasking. (Not supported available on VMware ESX servers being managed through the CIM interface.) Add Binding Button Click to add a persistent binding. Not supported Bind New Target Click to add a target that does not appear in the Persistent Not Button Binding table. supported Remove Button Click to remove the selected binding. Remove All Bindings Click to remove all persistent bindings that are displayed. Button

The OneCommand Manager application GUI (in Windows) 3-49

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

- Driver Parameters Tab (FC/FCoE)

Table 3-40: Item Content Remarks Installed Driver Type The current drivers installed on this host. If there is more than one driver type installed, the Installed Driver Types drop-down menu shows a list of all driver types that are installed on the adapters in the host and enables you to select the particular driver type to configure. Adapter Parameter A list of adapter driver parameters for the selected driver type table and their current values. Modify Adapter Adapter-specific information is displayed in this area. This can Parameter Area include value, range, default, activation requirements and description. Make all changes If you are making changes to multiple parameters, and you temporary check Box want all the changes to be temporary, check the Make all changes temporary box. This setting overrides the setting of the Make change temporary box. Only dynamic parameters can be made temporary. Restore Button If you changed driver parameters, but did not click Apply and you want to restore the parameters to their last saved values, click Restore. Default Button Click to reset all driver parameter values to their default (out- of-box) values. Globals Button Apply Button Click to apply any driver parameter changes. If you changed a driver parameter that is not dynamic, you may need to reset the adapter port or create a new ramdisk and reboot the system. Save Button

3-50 The OneCommand Manager application GUI (in Windows)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

- Diagnostics Tab

Table 3-41: Item Content Remarks Diagnostic Test --- Not supported Beacon --- Not supported Diagnostic Dump... --- Not button supported PCI Registers Flash Contents

- Transceiver Data Tab (Not supported)

The OneCommand Manager application GUI (in Windows) 3-51

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

- VPD Tab

Table 3-42: Item Content Remarks Product Name Product information about the selected adapter port. PN (Part Number) The adapter's part number. SN (Serial Number) The adapter's serial number. VO Vendor unique data. "V" indicates a vendor-specific field. An adapter may have none, one or more of these fields defined. Valid values for this field are "VO" (the letter "O", not the number zero) and "Vx" (where "x" is a number).

3-52 The OneCommand Manager application GUI (in Windows)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

The property tabs of "Target" icon under "Adapter" - "Port" icon are explained below.

- Target Information Tab

Table 3-43: Item Content Remarks Mapping Information - FC ID : The FC ID for the target; assigned automatically in Area the firmware. - SCSI Bus Number : The SCSI bus number to which the target is mapped. - SCSI Target Number : The target's identifier on the SCSI bus. - Node WWN : A unique 64-bit number, in hexadecimal, for the target (N_PORT or NL_PORT). - Port WWN : A unique 64-bit number, in hexadecimal, for the fabric (F_PORT or Switched Fabric Loop Port [FL_PORT]). - OS Device Name : The operating system device name.

The OneCommand Manager application GUI (in Windows) 3-53

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

- LUN Masking Tab (In disabled state)

Table 3-44: Item Content Remarks Re-enable LUN enables LUN masking again. masking Button

3-54 The OneCommand Manager application GUI (in Windows)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

- LUN Masking Tab (In enabled state)

Table 3-45: Item Content Remarks LUN The FC LUN number. On Reboot The 'On Reboot' column shows the mask configuration currently saved to the configuration file on disk (Solaris) or to the Registry (Windows). Normally, for a specific LUN, the states reported in the 'On Reboot' and 'Current' column are identical. However, there can be times where these do not match. For example, the hbacmd utility can be used to change only the 'Current' mask state for a LUN and not touch the 'On Reboot' mask state contained in the configuration file. Current The 'Current' column displays the live mask state currently in use by the driver. When you first see the LUN Masking tab, the mask states displayed in the 'Current' column are identical to the mask states for the corresponding LUNs in the discovery- tree.

The OneCommand Manager application GUI (in Windows) 3-55

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

The property tabs of "LUN" icon under "Adapter" - "Port" – "Target" icon are explained below.

- LUN Information Tab

Table 3-46: Item Content Remarks Vendor/Product - Vendor Name : The name of the vendor of the LUN. Information Area - Product ID : The vendor-specific ID for the LUN. - Revision : The vendor-specific revision number for the LUN. Mapping Information - FCP LUN : The FC identifier used by the adapter to map to the Area SCSI OS LUN. - SCSI OS LUN : The SCSI identifier used by the OS to map to the specific LUN. - OS Device Name : The name assigned by the OS to the LUN. LUN Capacity Area Note: LUN capacity information is only provided when the LUN is a mass-storage (disk) device. Other devices like tapes and scanners, etc. do not display capacity. - Capacity : The capacity of the LUN, in megabytes. - Block Size : The length of a logical unit block in bytes. LUN Masking - Current Mask Status : Possible states are masked or Information Area unmasked.

3-56 The OneCommand Manager application GUI (in Windows)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

Configuring by OCM

Configuring the Personality

Configuring the personality of onboard CNA or CNA expansion card by the OCM is not supported. See "Hitachi Compute Blade Emulex Adapter User's Guide for Hardware" for configuring the personality. Configuring the PXE Boot

Configuring the PXE by OCM is not supported. See "Hitachi Compute Blade Emulex Adapter User's Guide for Hardware" for configuring the PXE. Configuring UEFI on the system is necessary for the PXE Boot. See "EFI User's Guide" for the PXE boot Driver Parameter Settings

The driver parameter can be set by the OCM. Setting the parameter "Queue Depth" of "exlfc" driver which is the driver of the FC expansion card is explained below. The performance may be improved by changing the setting of "Queue Depth".

1. Start the OCM. Windows Server 2008 / Windows Server 2008 R2 : Select [Start] – [All programs] – [Emulex] – [OCManager]. Windows Server 2012 / Windows Server 2012 R2 : Select [Start] – [OCManager]. 2. (a) Select "LPe1205A-HI" – "Port" in the discovery-tree. (b) Open "Driver Parameters" tab. (c) Select "Queue Depth" in "Adapter Driver" list. (d) Input a value in "Value" field (e) Click "Apply" button.

(b)

(d)

(a) (c)

(e)

The OneCommand Manager application GUI (in Windows) 3-57

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

3. The message " Are you sure you want to save these new drivers parameter settings?" is popped-up. Click "Yes"

4. The message "The specified changes have been made." is popped-up.

5. Reboot the system.

The setting value of "Queue Depth" : The performance may be improved by changing the setting of "Queue Depth". The value is limited as follows. The number of LUN to be accessed * Queue_Depth must be less than 512. (Queue Depth = 1 ~ 32) LUN is 17 for example: - When Queue Depth is 32 : 17 * 32 = 544 : NG (larger than 512) - When Queue Depth = 31 : 17 * 31 = 527 : NG (larger than 512) - When Queue Depth = 31 : 17 * 30 = 510 : OK (less than 512) If you need to reset the value to the default, click "Defaults" button and "Apply" button and then reboot the system.

iSCSI Target Settings

(1) Connecting to iSCSI Target

Connecting to or disconnecting the iSCSI target can be set by the OCM.

The procedure for CNA expansion card for example is explained below.

1. Start OCM.

- Windows Server 2008 / Windows Server 2008 R2 : Select [Start] – [All programs] – [Emulex] – [OCManager].

- Windows Server 2012 / Windows Server 2012 R2 : Select [Start] – [OCManager].

2. Set the IP Address of the iSCSI initiator.

(a) Select "OCxxxxxxxxx-xx-HI" - "ASIC xx-x" - "Port"- "iSCSI " in the discovery-tree.

(b) Open "Port Information" tab.

(c) Click "Modify" button.

3-58 The OneCommand Manager application GUI (in Windows)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

(b)

(a)

0.0.0.0 (c) 0.0.0.0

3. "Modify TCP/IP Configuration" window is displayed.

Input the values to "IP Address" field and "Subnet Mask" field, and click "OK"

- "VLAN" function is not supported. Do not check "VLAN Enabled" check box. See " Hitachi Compute Blade LAN Advanced Function Manual for Emulex" for VLAN setting. - "DHCP" function is not supported. Do not check "DHCP Enabled" check box. - Do not enter any value to "Gateway Address" field.

The OneCommand Manager application GUI (in Windows) 3-59

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

4. Confirm the value in the "TCP/IP Info" area to be set to the inputted value.

5. Set the iSCSI initiator name.

(a) Select "OCxxxxxxxxx-xx-HI" - "ASIC xx-x" - "Port"- "iSCSI" – "Virtual Port" icon in the discovery-tree.

(b) Open the "iSCSI Initiator Login Options" tab.

(c) Input to "Initiator iSCSI Name" field.

(d) Click "Apply Changes" button.

(b)

(c)

(a)

(d) Apply Changes

- "Immediate Data", "Header Digest", "Data Digest", "Authentication Method" are not supported. Use the default values.

3-60 The OneCommand Manager application GUI (in Windows)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

6. Connect to the iSCSI target

(a) Select "OCxxxxxxxxx-xx-HI" - "ASIC xx-x" - "Port"- "iSCSI" – "Virtual Port" icon in the discovery-tree.

(b) Open "iSCSI Target Discovery" tab.

(c) Click "Add Portal" button.

(b)

(a) (c)

7. Input the IP Address of iSCSI disk array to be connected to.

(a) Input the IP address to the "Portal Address" field.

(b) Click "OK".

(a)

(b)

8. When the IP address is correct, the message "Success adding send target portal." is displayed.

9. Login to the target.

The OneCommand Manager application GUI (in Windows) 3-61

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

(a) Select "iSCSI Name" of the iSCSI disk array to be connected.

(b) Click "Target Login" button.

(a)

(b)

10. "Target Login" window is displayed, and click "OK".

3-62 The OneCommand Manager application GUI (in Windows)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

11. Confirm that the value in Status column changes to "Connected".

12. Confirm that the target has been connected to.

(a) Confirm that the Target icon and LUN icon are added under the Virtual Port icon in the discovery-tree.

(b) Confirm the values in "Target iSCSI Name" field and "IP Address" in "Target Information" tab. And the procedure is complete.

(b)

(a)

The OneCommand Manager application GUI (in Windows) 3-63

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

(2) Disconnecting the iSCSI target

The procedure to disconnect the iSCSI target is described below.

1. Select the iSCSI target to be disconnected.

(a) Select "OCxxxxxxxxx-xx-HI" - "ASIC xx-x" - "Port"- "iSCSI" – "Virtual Port" icon in the discovery-tree.

(b) Open "iSCSI Target Discovery" tab.

(c) Select the target to be disconnected in the "Target" area.

(d) Click "Target Sessions" button.

(b)

(a)

(c)

(d)

2. "Target Sessions" window is displayed, and click "Logout".

3. "Target Logout Warning" popped up window is displayed, and click "Yes".

4. Confirm that the value in the "Status" column changes to "Unconnected". And the procedure is complete.

3-64 The OneCommand Manager application GUI (in Windows)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

NPIV Settings

(1) Conditions to use

NPIV (N_Port ID Virtualization) function is supported for FC expansion card in Windows Server 2012 / Windows Server 2012 R2 environment. The following conditions are required to use NPIV. Table 3-47: 8Gb FC expansion card 16Gb FC expansion card FC Firmware ver. 2.01A12 10.0.803.25 or higher. or higher Driver ver. 2.74.14.1 10.0.720.0 (Windows 2012) or higher or higher Driver ver. 2.76.2.1 10.0.720.0 (Windows 2012 R2) or higher or higher OneCommand 6.3.16.1-1 / 6.3.16.1 6.3.16.1-1 / 6.3.16.1 Manager ver. or higher or higher

(2) Setting procedure

Set "Enabled" to "EnableNPIV" item to use NPIV.

1. Start OCM.

- Windows Server 2012 / Windows Server 2012 R2 : Select [Start] – [OCManager].

The OneCommand Manager application GUI (in Windows) 3-65

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

2. Select the port "Port x: xx:xx:xx:xx:xx:xx: xx:xx" of the FC adaper "LPe12xxxxx・・・" to configure, and select "Driver Parameters" tab.

3. Move the cursor to "EnableNPIV" in "Adapter Parameter" column, and select "Enabled".

3-66 The OneCommand Manager application GUI (in Windows)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

4. Press "Apply" button on the bottom of the window.

5. Select "Yes" for the message "Are you sure you want to save these new driver parameter settings?" in the "Driver Parameter Configuration" window.

6. Press "OK" for the message "The specified changes have been made. One or more of your changes require a reboot before they become active." in the "Driver Parameter Configuration" window. If the NPIV settings are required for other ports or adapters, repeat the step 2 to step 6.

7. Reboot the OS and the system.

- To enable the NPIV function, the configurations in OS like the virtual SAN manager setting on the Hyper-V manager on Windows 2012 or Windows 2012 R2 are also required other than this setting by OCM. - When connecting to the disk array equipment via FC switch, the FC switch has to support the NPIV protocol. - Link up the NPIV port of the virtual machine or the virtual machine may fail to boot up. - To enable the security function of disk array equipment (Host- group setting, LUN security setting etc.) per NPIV port, the WWN that is assigned to NPIV port has to be registered.

The OneCommand Manager application GUI (in Windows) 3-67

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

4

The OneCommand Manager application CLI (in Linux)

This chapter describes the OneCommand Manger application CLI (OCM_CLI hereafter) for Emulex adapters.

¨ OCM_CLI version List ¨ Installing OCM_CLI ¨ Uninstalling OCM_CLI ¨ Confirming OCM_CLI version ¨ Starting OCM_CLI ¨ Stopping OCM_CLI ¨ OCM_CLI functions ¨ Configuring by OCM_CLI

The OneCommand Manager application CLI (in Linux) 4-1

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

OCM_CLI version List

Supported OCM_CLI versions are as follows.

Table 4-1 : No. Supported OCM_CLI version Remarks 1 6.0.15.1 Initial release 2 6.1.14.1 --- 3 6.1.34.2 --- 4 6.3.16.2 --- 5 6.3.22.1 --- 6 10.2.340.5 or 10.2.340.5-1 Only for : CB500 520X B1 CB500 520H B3 CB2500 520X B1 CB2500 520H B3

7 10.2.470.0 Only for : CB500 520X B1 , RHEL6.6 CB500 520H B2 , RHEL6.6 CB500 520H B3 , RHEL6.6 CB2500 520X B1 , RHEL6.6 CB2500 520H B3 , RHEL6.6

4-2 The OneCommand Manager application CLI (in Linux)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

Installing OCM_CLI

This section describes the OCM_CLI installation procedure. The following description assumes that user logs on with administrator privilege (such as root). The OCM_CLI has been installed to the OS preinstalled system with onboard CNA, CNA expansion card or LAN expansion card. Install OCM_CLI when reinstalling OS or installing the Emulex adapters newly to the system.

The drivers and OCM_CLI are provided with CD media. : "Server installation and monitoring tool" or " 10Gb CNA Driver CD". For the information of the driver version, see "Readme.html" or "Support_EN.html" etc. included in the media.

1. Confirm the OCM_CLI version. Execute the following command and see the value of "Command Line Interface" column.

# hbacmd Version

Confirm that the version is listed in Table 4-1. When the version is supported, the installation is not necessary. When upgrading or downgrading, go to next step. When reinstalling, go to next step after uninstalling. The uninstalling process is describes in the section "Uninstalling OCM_CLI".

2. Insert "Server installation and monitoring tool" media into the DVD-ROM drive of system console. Select [Tools] - [Launch Virtual Media] located in upper side of Remote Console menu and open [Virtual Media Session] window. Check the "Mapped" check box of the CD/DVD drive to set the virtual drive.

Table 4-2: - CB500 CB520A x1/CB520H x1/CB540A x1 model : " Server installation and monitoring tool " media : OS Location of the installation file RHEL6.4/6.2/5.7/ See the file "support_EN.html" in the root folder. 5.9 Select "Contents - 4.Drivers and utilities", and "CB520Hx1" or "CB520Ax1/CB540Ax1" - Utilities (RHEL6.4)", and "FC - Emulex One Command Manager". RHEL6.5 See the file "support_EN.html" in the root folder. Select "Contents - 4.Drivers and utilities", and "CB520Hx1" or "CB520Ax1/CB540Ax1" - Utilities (RHEL6.5)", and "FC - Emulex One Command Manager".

- CB500 CB520H x2 model: "CB500 10Gb CNA Driver CD ver.01-08 (or higher)" media : OS Location of the installation file RHEL6.4/6.5/6.6 /RHEL6/Utility/elxocm06*-.tgz ("*" is a number.)

The OneCommand Manager application CLI (in Linux) 4-3

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

- CB500 CB520X B1/CB520H B3 model: "CB500 10Gb CNA Driver CD ver.01-08 (or higher)" media : OS Location of the installation file RHEL6.5/6.6 /RHEL6/Utility/elxocm06*-.tgz ("*" is a number.) (64-bit x86_64)

- CB2500 520X B1/520H B3 model: "CB2500 10Gb CNA Driver CD ver.01-08 (or higher)" media : OS Location of the installation file RHEL6.5/6.6 /RHEL6/Utility/elxocm06*-.tgz ("*" is a number.) (64-bit x86_64)

- CB2000 High performance server blade x2, Standard server blade x3 model : "Server installation and monitoring tool " media : OS Location of the installation file RHEL6.4/6.2/5.7/ See the file "support_EN.html" in the root folder. 5.9 Select "Contents - 4.Drivers and utilities", and "Standard server blade x3/High-performance server blade x2 - Utilities(RHEL6.4)", and "FC - Emulex One Command Manager". RHEL6.5 See the file "support_EN.html" in the root folder. Select "Contents - 4.Drivers and utilities", and "Standard server blade x3/High-performance server blade x2 - Utilities(RHEL6.5)", and "FC - Emulex One Command Manager".

- CB2000 Standard server blade x4 model:"Server installation and monitoring tool " media : OS Location of the installation file RHEL6.4 See the file "support_EN.html" in the root folder. Select "Contents - 4.Drivers and utilities", and "Standard server blade x4 - Utilities(RHEL6.4)", and "FC - Emulex One Command Manager". RHEL6.5 See the file "support_EN.html" in the root folder. Select "Contents - 4.Drivers and utilities", and "Standard server blade x4 - Utilities(RHEL6.5)", and "FC - Emulex One Command Manager".

Mount the media to any directory in the system.

# mount /dev/cdrom /media

Copy the utility file from the mounted media to the directory in the system. The directory in the system is /tmp/ocmwork/ for example.

# mkdir /tmp/ocmwork # cp –a /media//elxocm.tgz /tmp/ocmwork # umount /media # cd /tmp/ocmwork

Extract the utility file.

# tar -zxvf /tmp/ocmwork/elxocm.tgz

3. Execute the following command.

# chmod 755 install.sh # ./install.sh -q

4. Reboot the system and the procedure is complete.

4-4 The OneCommand Manager application CLI (in Linux)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

Uninstalling OCM_CLI

1. Confirm the OCM_CLI version. Execute the following command and see the value of "Command Line Interface" column.

# hbacmd Version

Confirm that the version is listed in Table 4-1.

2. Prepare the script file to uninstall. Insert "Server installation and monitoring tool" media into the DVD-ROM drive of system console. Select [Tools] - [Launch Virtual Media] located in upper side of Remote Console menu and open [Virtual Media Session] window. Check the "Mapped" check box of the CD/DVD drive to set the virtual drive.

Table 4-3: - CB520A x1, CB520H x1, CB540A x1 model :" Server installation and monitoring tool " media : OS Location of the installation file RHEL6.4/6.2/5.7/ See the file "support_EN.html" in the root folder. 5.9 Select "Contents - 4.Drivers and utilities", and "CB520Hx1/CB520Ax1/CB540Ax1 - Utilities (RHEL6.4)", and "FC - Emulex One Command Manager". RHEL6.5 See the file "support_EN.html" in the root folder. Select "Contents - 4.Drivers and utilities", and "CB520Hx1" or "CB520Ax1/CB540Ax1" - Utilities (RHEL6.5)", and "FC - Emulex One Command Manager".

- CB520H x2 model: model : "CB500 10Gb CNA Driver CD ver.01-08 (or higher)" media : OS Location of the installation file RHEL6.4/6.5/6.6 /RHEL6/Utility/elxocm06*-.tgz ("*" is a number.)

- CB500 CB520X B1/CB520H B3 model: "CB500 10Gb CNA Driver CD ver.01-08 (or higher) " media : OS Location of the installation file RHEL6.5/6.6 /RHEL6/Utility/elxocm06*-.tgz ("*" is a number.) (64-bit x86_64)

- CB2500 520X B1/520H B3 model: "CB2500 10Gb CNA Driver CD ver.01-08 (or higher)" media : OS Location of the installation file RHEL6.5/6.6 /RHEL6/Utility/elxocm06*-.tgz ("*" is a number.) (64-bit x86_64)

The OneCommand Manager application CLI (in Linux) 4-5

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

- CB2000 High performance server blade x2, Standard server blade x3 model : "Server installation and monitoring tool " media : OS Location of the installation file RHEL6.4/6.2/5.7/ See the file "support_EN.html" in the root folder. 5.9 Select "Contents - 4.Drivers and utilities", and "Standard server blade x3/High-performance server blade x2 - Utilities(RHEL6.4)", and "FC - Emulex One Command Manager". RHEL6.5 See the file "support_EN.html" in the root folder. Select "Contents - 4.Drivers and utilities", and "Standard server blade x3/High-performance server blade x2 - Utilities(RHEL6.5)", and "FC - Emulex One Command Manager".

- CB2000 Standard server blade x4 model:"Server installation and monitoring tool " media : OS Location of the installation file RHEL6.4 See the file "support_EN.html" in the root folder. Select "Contents - 4.Drivers and utilities", and "Standard server blade x4 - Utilities(RHEL6.4)", and "FC - Emulex One Command Manager". RHEL6.5 See the file "support_EN.html" in the root folder. Select "Contents - 4.Drivers and utilities", and "Standard server blade x4 - Utilities(RHEL6.5)", and "FC - Emulex One Command Manager".

Mount the media to any directory in the system.

# mount /dev/cdrom /media

Copy the utility file from the mounted media to the directory in the system. The directory in the system is /tmp/ocmwork/ for example.

# mkdir /tmp/ocmwork # cp –a /media//elxocm.tgz /tmp/ocmwork # umount /media # cd /tmp/ocmwork

Extract the utility file.

# tar -zxvf /tmp/ocmwork/elxocm.tgz

3. Execute the following command.

# chmod 755 uninstall.sh # ./uninstall.sh

4. Reboot the system and the procedure is complete.

4-6 The OneCommand Manager application CLI (in Linux)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

Confirming OCM_CLI version

1. Execute the following command.

# hbacmd Version

2. See the value of "Command Line Interface" column.

The OneCommand Manager application CLI (in Linux) 4-7

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

Starting OCM_CLI

The CLI Client component of the OneCommand Manager application provides access to the capabilities of the Remote Management library or the CIM interface from a console command prompt to get the management information. The CLI Client is intended for use in scripted operations from within shell scripts or batch files. The CLI Client is a console application named HbaCmd. A single operation is performed by entering "hbacmd", followed by a CLI client command and its possible parameters, at the command line.

# hbacmd [parameters]

When the specified operation is completed, the command prompt is displayed. For a majority of commands, the first parameter following the command is the WWPN or MAC address of the port that the command is to act upon.

The following syntax rules and usage are applicable for the HbaCmd application:

. Parameters denoted within angle brackets < > are required.

. Parameters denoted within square brackets [ ] are optional.

. For Linux,program names must be in lowercase letters, therefore, the command line must begin with "hbacmd" (rather than "HbaCmd").

. An optional IP address or host name can be specified using the "h" option with the following syntax:

hbacmd [h=IP_Address[:port] | Hostname[:port]] [parameters]

. If the "h" option is omitted, the command is run on the local host.

. If the "h" option is specified, the command is sent to the specified remote host (assuming it is specified correctly, the remote host is up, and the remote host is running the OneCommand Manager remote management agent.

. The ":port" option is optional. If omitted, the OneCommand Manager remote management protocol uses the default TCP port. If specified, it uses the user-specified TCP port.

. Examples:

Using the IP address: hbacmd h=138.239.91.121 ListHBAs

Using the host name: hbacmd h=cp-hp5670 ListHBAs

. The "h" option is available for all commands except for the AddHost, RemoveHost, and the Version commands.

4-8 The OneCommand Manager application CLI (in Linux)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

. For FC ports, the WWPN of the adapter must be specified. Where the WWPN is specified, each pair of numbers within the WWPN is separated by colons (:) or spaces ( ). When using space separators, the entire WWPN must be enclosed in quotes (" "). For example, the following command displays the port attributes for the adapter with the specified WWPN:

hbacmd PortAttributes 10:00:00:00:c9:20:20:20

. For iSCSI and NIC ports, the MAC address must be specified. Where a MAC address is specified, each pair of numbers within the MAC address is separated by a dash (-). For example, the following command sets the target properties for the UCNA port with the specified MAC address with an extended timeout value of "1":

hbacmd SetTargetProperties 00-11-22-33-44-55 iscsiTarget 1

. For NIC ports, only the permanent MAC address is supported for the port address parameter on an HbaCmd command line.

Normally, for a UCNA port, the port's permanent MAC address and current MAC address parameters are equal. However, it is possible to set a user- specified (current) MAC Address that is different from the permanent MAC address. Also, for some implementations, it is possible to have multiple UCNA ports with the same current MAC addresses, but with unique permanent MAC addresses. Therefore, to ensure that the OneCommand Manager can access the correct port, only the permanent MAC address is supported. Note that both the permanent MAC address and the current MAC address are displayed by using the ListHBAs command.

The OneCommand Manager application CLI (in Linux) 4-9

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

Stopping OCM_CLI

No operation is needed to stop OCM_CLI normally.

4-10 The OneCommand Manager application CLI (in Linux)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

OCM_CLI functions

OCM_CLI functions

Main OCM_CLI functions are as follows. Table 4-4: Main Functions Explanation Remarks Viewing the configuration information Viewing the configuration information of host, adapters, ASIC, port, device, etc. Setting the adapter Setting the driver parameter, and iSCSI target.

OCM_CLI commands

(1) OCM_CLI Command List

Table 4-5: Help Command Command Command Syntax Description Remarks help hbacmd Help Displays command information for [GroupName][CmdName] the HbaCmd application.

Table 4-6: Adapter License Management Command Command Command Syntax Description Remarks ShowLicenseAdapterID hbacmd ShowLicenseAdapterID --- Not supported InstallAdapterLicense hbacmd InstallAdapterLicense --- Not supported ShowAdapterLicenseFe hbacmd ShowAdapterLicenseFeatures --- Not supported atures

Table 4-7: Attributes Command Command Command Syntax Description Remarks HbaAttributes hbacmd [h=] hbaattributes Shows a list of all adapter attributes for all ports on the adapter. PortAttributes hbacmd Shows a list of all port PortAttributes attributes for the adapter. PortStatistics hbacmd PortStatistics --- Not supported ServerAttributes hbacmd ServerAttributes --- Not supported SetPhyPortSpeed SetPhyPortSpeed [Speed [Length]] SetPortEnabled SetPortEnabled --- Not supported

Table 4-8: Authentication Command Command Command Syntax Description Remarks AuthConfigList hbacmd AuthConfigList --- Not supported DeleteAuthConfig hbacmd DeleteAuthConfig --- Not supported GetAuthConfig hbacmd GetAuthConfig --- Not supported GetAuthStatus, hbacmd GetAuthStatus --- Not supported

The OneCommand Manager application CLI (in Linux) 4-11

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

Command Command Syntax Description Remarks InitiateAuth hbacmd InitiateAuth --- Not supported SetAuthConfig hbacmd SetAuthConfig --- Not supported SetPassword hbacmd SetPassword --- Not supported

Table 4-9: Boot Command Command Command Syntax Description Remarks EnableBootCode hbacmd EnableBootCode --- Not supported GetBootParams hbacmd GetBootParams --- Not supported SetBootParam hbacmd SetBootParam --- Not supported [BootDev ]

Table 4-10: DCB Command Command Command Syntax Description Remarks GetDCBParams hbacmd GetDCBParams --- Not supported SetDCBParam hbacmd SetDCBParam --- Not supported GetPGInfo hbacmd GetPGInfo --- Not supported SetDCBPriority hbacmd SetDCBPriority --- Not supported ... SetCnaPGBW hbacmd SetCnaPGBW --- Not supported

Table 4-11: Diagnostic Command Command Command Syntax Description Remarks EchoTest hbacmd EchoTest --- Not supported GetBeacon hbacmd GetBeacon --- Not supported GetXcvrData hbacmd GetXcvrData --- Not supported LoadList hbacmd LoadList --- Not supported LoopBackTest hbacmd LoopBackTest --- Not supported [Pattern] LoopMap hbacmd LoopMap --- Not supported PciData hbacmd PciData --- Not supported PostTest hbacmd PostTest --- Not supported SetBeacon hbacmd SetBeacon --- Not supported SetCableNVP hbacmd SetCableNVP --- Not supported TDRTest hbacmd TDRTest --- Not supported SelfTest hbacmd SelfTest --- Not supported Wakeup hbacmd WakeUp --- Not supported

Table 4-12: Driver Parameter Command Command Command Syntax Description Remarks DriverConfig hbacmd DriverConfig --- Not supported GetDriverParams hbacmd GetDriverParams Shows the name and values of each parameter. GetDriverParamsGlobal hbacmd GetDriverParamsGlobal Shows the name and the global value of each driver parameter.

4-12 The OneCommand Manager application CLI (in Linux)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

Command Command Syntax Description Remarks SaveConfig hbacmd SaveConfig --- Not supported SetDriverParam --- Changes a driver Not supported parameter and designates the scope of the change. SetDriverParamDefault --- Changes all values to Not supported s the default for the adapter(s).

Table 4-13: Dump Command Command Command Syntax Description Remarks DeleteDumpFiles hbacmd DeleteDumpFiles --- Not supported Dump hbacmd Dump --- Not supported GetDumpDirectory hbacmd h=ipaddress[:port] m=cim --- Not supported [u=username] [p=password] [n=root/emulex] GetDumpDirectory SetDumpDirectory ESX/ESXI using the CIM interace: --- Not supported hbacmd h=ipaddress[:port] m=cim [u=username] [p=password] [n=root/emulex] setdumpdirectory ESX using the RM (remote management) interface: hbacmd h=ipaddress[:port] setdumpdirectory GetRetentionCount hbacmd GetRetentionCount --- Not supported SetRetentionCount hbacmd SetRetentionCount --- Not supported GetDumpFileNames hbacmd GetDumpFileNames --- Not supported GetDumpFile hbacmd [h=ipAddress] GetDumpFile --- Not supported

Table 4-14: FCoE Command Command Command Syntax Description Remarks GetFIPParams hbacmd GetFIPParams --- Not supported SetFIPParam hbacmd SetFIPParams --- Not supported GetFCFInfo hbacmd GetFCFInfo --- Not supported

Table 4-15: iSCSI Command Command Command Syntax Description Remarks AddARPTableEntry hbacmd [h=host_IP[:port] | hostname[:port]] --- Not supported AddARPTableEntry AddRouteTableEntry hbacmd [h=host_IP[:port] | hostname[:port]] --- Not supported AddRouteTableEntry AddTarget hbacmd [h=host_IP[:port] | hostname[:port]] Adds a target to the AddTarget list of targets seen by the initiator and logs [ImmediateData=<0|1>] into the target once it [HeaderDigest=<0|1>] [DataDigest=<0|1>] has been successfully [Auth=<0|1|2> "TgtCHAPName" "TgtSecret" created. "InitCHAPName" "InitSecret"] AddTargetPortal hbacmd [h=host_IP[:port] | hostname[:port]] --- Not supported AddTargetPortal [ImmediateData=<0|1>] [HeaderDigest=<0|1>] [DataDigest=<0|1>] [Auth=<0|1|2> "TgtCHAPName" "TgtSecret" "InitCHAPName" "InitSecret"]

The OneCommand Manager application CLI (in Linux) 4-13

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

Command Command Syntax Description Remarks CleariSNSServer hbacmd [h=host_IP[:port] | hostname[:port]] --- Not supported CleariSNSServer DelARPTableEntry hbacmd [h=host_IP[:port] | hostname[:port]] --- Not supported DelARPTableEntry DelRouteTableEntry hbacmd [h=host_IP[:port] | hostname[:port]] --- Not supported DelRouteTableEntry DiscoveriSNSServer hbacmd [h=host_IP[:port] | hostname[:port]] --- Not supported DiscoveriSNSServer GetInitiatorProperties hbacmd [h=host_IP[:port] | hostname[:port]] Shows all the initiator GetInitiatorProperties login options for the specified port. GetiSCSILuns hbacmd [h=host_IP[:port] | hostname[:port]] Shows all the LUNs GetiSCSILuns and their information for a specified target. GetiSCSIPortStats hbacmd [h=host_IP[:port] | hostname[:port]] Lists all session GetiSCSIPortStats information for a specified session. GetNetworkConfiguratio hbacmd GetNetworkConfiguration information. GetSessionInfo hbacmd [h=host_IP[:port] | hostname[:port]] Lists all session GetSessionInfo information for a > iSCSIPing hbacmd [h=host_IP[:port] | hostname[:port]] Issues ICMP echo Not supported iSCSIPing requests to a target. ListSessions hbacmd [h=host_IP[:port] | hostname[:port]] Lists all the sessions ListSessions on a specified target. RemoveTarget hbacmd [h=host_IP[:port] | hostname[:port]] --- Not supported RemoveTarget RemoveTargetPortal hbacmd [h=host_IP[:port] | hostname[:port]] --- Not supported RemoveTargetPortal SetInitiatorProperties hbacmd [h=host_IP[:port] | hostname[:port]] Sets the initiator SetInitiatorProperties properties for the specified port. [Initiator_Name="initiator_name"] [Initiator_Alias="initiator_alias"] [ImmediateData=<0|1>] [HeaderDigest=<0|1>] [DataDigest=<0|1>] [Auth=<0|1|2> "TgtCHAPName" "TgtSecret" "InitCHAPName" "InitSecret"] SetNetworkConfiguratio hbacmd [h=host_IP[:port] | hostname[:port]] Sets the TCP/IP n SetNetworkConfiguration configuration on a specified port. [> >] > [ [Gateway]] SetTargetLoginProperti hbacmd [h=host_IP[:port] | hostname[:port]] --- Not supported es SetTargetLoginProperties [ImmediateData=<0|1>] [HeaderDigest=<0|1>] [DataDigest=<0|1>] [Auth=<0|1|2> "TgtCHAPName" "TgtSecret" "InitCHAPName" "InitSecret"] SetTargetProperties hbacmd [h=host_IP[:port] | hostname[:port]] --- Not supported SetTargetProperties

4-14 The OneCommand Manager application CLI (in Linux)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

Command Command Syntax Description Remarks SetTPLoginProperties hbacmd [h=host_IP[:port] | hostname[:port]] --- Not supported SetTPLoginProperties [ImmediateData=<0|1>] [HeaderDigest=<0|1>] [DataDigest=<0|1>] [Auth=<0|1|2> TgtCHAPName TgtSecret InitCHAPName InitSecret] ShowARPTable hbacmd [h=host_IP[:port] | hostname[:port]] Shows the current ShowARPTable ARP table for the specified port. ShowiSNSServer hbacmd [h=host_IP[:port] | hostname[:port]] --- Not supported ShowiSNSServer ShowRouteTable hbacmd [h=host_IP[:port] | hostname[:port]] --- Not supported ShowRouteTable ShowTarget hbacmd [h=host_IP[:port] | hostname[:port]] Shows the properties ShowTarget for a specified target. [ | refreshtargets] ShowTargetPortal hbacmd [h=host_IP[:port] | hostname[:port]] --- Not supported ShowTargetPortal [ ] TargetLogin hbacmd [h=host_IP[:port] | hostname[:port]] Logs in to a target. TargetLogin [ ] TargetLogout hbacmd [h=host_IP[:port] | hostname[:port]] Logs out of a target. TargetLogout UpdateiSNSServer hbacmd [h=host_IP[:port] | hostname[:port]] --- Not supported UpdateiSNSServer

Table 4-16: LUN Masking Command Command Command Syntax Explanation Remarks GetLunList hbacmd GetLunList

Table 4-17: Miscellaneous Command Command Command Syntax Explanation Remarks Download hbacmd Download --- Not supported ExportSANInfo hbacmd ExportSANInfo [format] --- Not supported GetQoSInfo hbacmd [h=host_IP[:port] | hostname[:port]] Shows the QoS GetQoSInfo information for a specified NIC port. GetVPD hbacmd GetVPD Shows the port’s VPD. ListHBAs hbacmd [h=] listhbas [local] Shows a list of the [m=model] [pt=type] manageable Emulex adapters found by local, remote in-band (FC), and remote out- of-band (TCP/IP) discovery. GetElxSecInfo hbacmd [h=host_IP[:port] | hostname[:port]] --- Not supported GetQoSInfo Reset hbacmd Reset --- Not supported TargetMapping hbacmd TargetMapping --- Not supported

The OneCommand Manager application CLI (in Linux) 4-15

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

Command Command Syntax Explanation Remarks SetCimCred hbacmd SetCimCred --- Not supported GetCimCred hbacmd GetCimCred --- Not supported AddHost hbacmd AddHost host_address --- Not supported RemoveHost hbacmd RemoveHost host_address --- Not supported CnaGetEventLog hbacmd CnaGetEventLog --- Not supported CnaClearEventLog hbacmd CnaClearEventLog --- Not supported SetPfcThrottle hbacmd SetPfcThrottle <0|1> --- Not supported

Table 4-18: Persistent Binding Command Command Command Syntax Explanation Remarks AllNodeInfo hbacmd AllNodeInfo --- Not supported BindingCapabilities hbacmd BindingCapabilities --- Not supported BindingSupport hbacmd BindingSupport --- Not supported PersistentBinding hbacmd PersistentBinding --- Not supported RemoveAllPersistentBi hbacmd RemoveAllPersistentBinding --- Not supported nding RemovePersistentBindi hbacmd RemovePersistentBinding --- Not supported ng SetBindingSupport hbacmd SetBindingSupport --- Not supported SetPersistentBinding hbacmd SetPersistentBinding --- Not supported

Table 4-19: Personality Management Command Command Command Syntax Explanation Remarks ShowPersonalities hbacmd ShowPersonalities --- Not supported ChangePersonality hbacmd ChangePersonality --- Not supported

Table 4-20: VPort Command Command Command Syntax Explanation Remarks CreateVPort hbacmd CreateVPort --- Not supported auto [vname] DeleteVPort hbacmd DeleteVPort --- Not supported ListVPorts hbacmd ListVPorts --- Not supported VPortTargets hbacmd VPortTargets --- Not supported ListVMs hbacmd ListVMs

Table 4-21: WWN Management Command Command Command Syntax Explanation Remarks ChangeWWN hbacmd ChangeWWN GetWWNCap hbacmd GetWWNCap --- Not supported ReadWWN hbacmd ReadWWN --- Not supported RestoreWWN hbacmd RestoreWWN --- Not supported

4-16 The OneCommand Manager application CLI (in Linux)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

Configuration Information

(1) HbaAttributes Command

Devices : onboard CNA, CNA expansion card, FC expansion card Syntax : hbacmd hbaattrib WWPN : WWPN of the adapter. MAC : MAC address of the NIC or iSCSI port. Examples : hbacmd hbaattrib 00-00-c9-db-56-48 HBA Attributes for 00-00-c9-db-56-48

Host Name : localhost.localdomain Manufacturer : Emulex Corporation Serial Number : FC20975332 Model : OCm11104-F2-HI Model Desc : Hitachi OCm11104-F2-HI 4-Port 10Gbps Converged Network Mezzanine Card HW Version : E3 A2 FW Version : 4.1.334.2801 Vendor Spec ID : 19A2 Number of Ports : 2 Driver Name : be2net.ko Device ID : 0710 Operational FW : 4.1.334.2801 PXE Boot : Disabled Driver Version : 4.1.334.18 Board Temperature : Normal Function Type : NIC Sub Device ID : 3054 Port Number : 0 PCI Bus Number : 17 PCI Func Number : 0 Sub Vendor ID : 1054 Firmware Status : Working IPL Filename : M32FHIB5 NCSI Version : N/A Start-up Boot Code Version : 2.0.25.768 FCoE Universal Version : 7.04a13 FCoE x86 BIOS Version : 4.02a15 FCoE EFI Version : 5.01a11 FCoE FCODE Version : 4.01a1 UEFI NIC Version : 4.1.334.2801 UEFI FCODE Version : 4.1.334.2801 UEFI iSCSI Version : 4.1.334.2801 PCI Express Link Speed : 5GT/s PCI Express Bus Width : x8

The OneCommand Manager application CLI (in Linux) 4-17

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

(2) PortAttributes Command

Devices : onboard CNA, CNA/LAN expansion card, FC expansion card Syntax : hbacmd PortAttrib WWPN : WWPN of the adapter. MAC : MAC address of the NIC or iSCSI port. Examples : hbacmd PortAttrib 10:00:00:00:c9:dc:4a:49

Port Attributes for 10:00:00:00:c9:dc:4a:49

Node WWN : 20 00 00 00 c9 dc 4a 49 Port WWN : 10 00 00 00 c9 dc 4a 49 Port Symname : Emulex PPN-10:00:00:00:c9:dc:4a:49 Port FCID : F0900 Port Type : Fabric Port State : Operational Port Service Type : 8 Port Supported FC4 : 00 00 01 00 00 00 00 01 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 Port Active FC4 : 00 00 01 00 00 00 00 01 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 Port Supported Speed : 2 4 8 GBit/sec Port Speed : 8 GBit/sec Max Frame Size : 2048 OS Device Name : /sys/class/scsi_host/host5 Num Discovered Ports : 2 Fabric Name : 10 00 00 05 1e a2 64 39 Function Type : FC

4-18 The OneCommand Manager application CLI (in Linux)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

(3) GetDriverParams Command

Devices : onboard CNA(FCoE), CNA expansion card(FCoE), FC expansion card Syntax : hbacmd GetDriverParams WWPN : WWPN of the adapter. Examples : hbacmd GetDriverParams 10:00:00:00:c9:dc:4a:48

Driver Params for 10:00:00:00:c9:dc:4a:48. Values in HEX format.

DX string Low High Def Cur Exp Dyn 00: log-verbose 0 ffffffff 0 0 a00d 1 01: lun-queue-depth 1 80 1e 1e a00d 4 02: scan-down 0 1 1 1 a00d 4 03: nodev-tmo 1 ff 1e 1e a00d 1 04: topology 0 6 0 0 a00d 5 05: link-speed 0 8 0 0 a00d 5 06: fcp-class 2 3 3 3 a00d 4 07: use-adisc 0 1 0 0 a00d 1 08: ack0 0 1 0 0 a00d 4 09: cr-delay 0 3f 0 0 a00d 4 0a: cr-count 1 ff 1 1 a00d 4 0b: fdmi-on 0 2 0 0 a00d 4 0c: max-luns 0 ffff ff ff a00d 4 0d: enable-npiv 0 1 1 1 a00d 4 0e: use-msi 0 2 0 2 a00d 4

(4)GetDriverParamsGlobal Command

Devices : onboard CNA(FCoE), CNA expansion card(FCoE), FC expansion card Syntax : hbacmd GetDriverParamsGlobal WWPN : WWPN of the adapter. Examples : hbacmd GetDriverParam sGlobal 10:00:00:00:c9:dc:4a:48

Driver Params for 10:00:00:00:c9:dc:4a:48. Values in HEX format.

DX string Low High Def Cur Exp Dyn 00: log-verbose 0 ffffffff 0 0 a00d 1 01: lun-queue-depth 1 80 1e 1e a00d 4 02: scan-down 0 1 1 1 a00d 4 03: nodev-tmo 1 ff 1e 1e a00d 1 04: topology 0 6 0 0 a00d 5 05: link-speed 0 8 0 0 a00d 5 06: fcp-class 2 3 3 3 a00d 4 07: use-adisc 0 1 0 0 a00d 1 08: ack0 0 1 0 0 a00d 4 09: cr-delay 0 3f 0 0 a00d 4 0a: cr-count 1 ff 1 1 a00d 4 0b: fdmi-on 0 2 0 0 a00d 4 0c: max-luns 0 ffff ff ff a00d 4 0d: enable-npiv 0 1 1 1 a00d 4 0e: use-msi 0 2 0 2 a00d 4

The OneCommand Manager application CLI (in Linux) 4-19

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

(5)GetInitiatorProperties Command

Devices : onboard CNA(iSCSI), CNA expansion card(iSCSI) Syntax : hbacmd GetInitiatorProperties MAC : The MAC address of the UCNA port Examples : hbacmd GetInitiatorProperties 00-00-c9-db-56-49

Initiator login options for 00-00-c9-db-56-49:

Initiator iSCSI Name: iqn.1990-07.com.emulex:00-00-c9-db-56-49 Initiator Alias: abcd ImmediateData: Yes HeaderDigest: None DataDigest: None AuthMethod: None TargetCHAPName: Not Available InitCHAPName: Not Available

Default Login Options:

InitialR2T: Yes ImmediateData: Yes HeaderDigest: None DataDigest: None MaxConnections: 1 MaxOutstandingR2T: 1 FirstBurstLength: 8192 MaxBurstLength: 262144 MaxRecvDataSegmentLength: 65536 DefaultTime2Wait: 2 DefaultTime2Retain: 20 ErrorRecoveryLevel: 0 DataPDUInOrder: 1 DataSequenceInOrder: 1

(6)GetiSCSILuns Command

Devices : onboard CNA(iSCSI), CNA expansion card(iSCSI) Syntax : hbacmd GetiSCSILuns MAC : The MAC address of the UCNA port Target-name: Target's iSCSI name enclosed in quotes (string length: 11 - 255) Examples : hbacmd GetiSCSILuns 00-00-c9-db-56-4d iqn.1994- 04.jp.co.hitachi:rsd.d8m.t.10098.0a035

LUN 0: Vendor Name: HITACHI Model Number: DF600F Serial Number: 850100980051 LUN Type: 0 Capacity: 10.00 GB Block Size: 512

4-20 The OneCommand Manager application CLI (in Linux)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

(7)GetiSCSIPortStats Command

Devices : onboard CNA(iSCSI), CNA expansion card(iSCSI) Syntax : hbacmd GetiSCSIPortStats MAC : The MAC address of the UCNA port Examples : hbacmd GetiSCSIPortStats 00-00-c9-db-56-4d

Port Statistics for 00-00-c9-db-56-4d:

Node Roles: Initiator Portal Count: 1 Node Count: 1 Session Count: 1 Session Failure Count: 0 Last Session Failure Type: OtherErrors Last Session Remote Node Name: Session Digest Errors: 0 Session Connection Timeout: 0 Session Format Errors: 0 Login Failures: 0 Last Failure Time: 0 Last Failure Type: UnknownFailure Last Target Failure Name: Last Target Failure Address: 0.0.0.0 Login Accept Responses: 0 Login Other Failure Responses: 0 Login Redirect Responses: 0 Authentication Failure Responses: 0 Authentication Failures: 0 Login Negotiation Failures: 0 Logout Normals: 0 Logout Others: 0 Port Row Status: 1 Portal Role: Initiator Portal Protocol: 6 Portal Tag: 255

(8)GetNetworkConfiguration Command

Devices : onboard CNA(iSCSI), CNA expansion card(iSCSI) Syntax : hbacmd GetNetworkConfiguration MAC : The MAC address of the UCNA port Examples : hbacmd GetNetworkConfiguration 00-00-c9-db-56-4d

TCP/IP Configuration for 00-00-c9-db-56-4d:

DHCP Enabled: No VLAN Enabled: NO VLAN ID: 0 Priority: 0 IP Address: 192.168.0.63 Subnet Mask: 255.255.255.0 Gateway: 0.0.0.0 The OneCommand Manager application CLI (in Linux) 4-21

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

(9)ListSessions Command

Devices : onboard CNA(iSCSI), CNA expansion card(iSCSI) Syntax : hbacmd ListSessions MAC : The MAC address of the UCNA port Target-name: Target's iSCSI name enclosed in quotes (string length: 11 - 255) Examples : hbacmd ListSessions 00-00-c9-db-56-4d iqn.1994- 04.jp.co.hitachi:rsd.d8m.t.10098.0a035

Total Sessions: 1

Session 1 Initiator Name: iqn.1990-07.com.emulex:00-00-c9-db-56-4d Status: Open TSIH: 32954 ISID: 0x4000006c0000 ISID Qualifier: 0 Target IP Address: 192.168.0.212 Automatic Login: Yes iSCSI Boot: No

4-22 The OneCommand Manager application CLI (in Linux)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

(10)GetSessionInfo Command

Devices : onboard CNA(iSCSI), CNA expansion card(iSCSI) Syntax : hbacmd GetSessionInfo > MAC : The MAC address of the UCNA port Target-name: Target's iSCSI name enclosed in quotes (string length: 11 - 255) TSIH: TSIH value of the session (value: 1 - 65535) ISID_Qual Target_IP: ISID qualifier of the session (value: 0 - 65535)

Examples : hbacmd GetSessionInfo 00-00-c9-db-56-4d iqn.1994- 04.jp.co.hitachi:rsd.d8m.t.10098.0a035 32954

Session Info for: TSIH: 32954 ISID Qualifier: 0

Session Negotiated Login Options ------ImmediateData: No MaxConnections: 1 MaxOutstandingsR2T: 1 FirstBurstLength: N/A MaxBurstLength: 65536 DefaultTime2Wait: 2 DefaultTime2Retain: 20 ErrorRecoveryLevel: 0 DataPDUInOrder: 0 DataSequenceInOrder: 0

Session Statistics ------Session Direction: 2 C md PDUs: 91 Response PDUs: 91 Xmit Data Octets: 0 Recv Data Octets: 307642 Digest Errors: 0 Connection Timeout Errors: 0 Session Target Alias:

Connection Information ------iSCSI Connection ID: 0 Status: Logged-In Source IP Address: 192.168.0.63 Source Port: 26706 Destination IP Address: 192.168.0.212 Destination Port: 3260 Redirected Destination IP Address: 0.0.0.0 Redirected Destination Port: 0

Connection Negotiated Login Options ------Authentication Method: None HeaderDigest: None DataDigest: None MaxSendDataSegmentLength: 16384 TCPMSS: The OneCommand Manager 1448 application CLI (in Linux) 4-23 Hitachi Compute Blade Emulex Adapter User's Guide for Utility

(11)ShowARPTable Command

Devices : onboard CNA(iSCSI), CNA expansion card(iSCSI) Syntax : hbacmd ShowARPTable MAC : The MAC address of the UCNA port Examples : hbacmd ShowARPTable 00-00-c9-db-56-4d

MAC ADDRESS IP ADDRESS ------00-00-00-00-00-00 127.0.0.1

(12)ShowTarget Command

Devices : onboard CNA(iSCSI), CNA expansion card(iSCSI) Syntax : hbacmd ShowTarget [ | refreshtargets] MAC : MAC address of the UCNA port iscsi_target_name: Target's iSCSI name enclosed in quotes (string length: 11 - 255) refreshtargets : Refresh all targets before displaying the information. Examples : hbacmd ShowTarget 00-00-c9-db-56-4d iqn.1994- 04.jp.co.hitachi:rsd.d8m.t.10098.0a035

Target iSCSI Name: iqn.1994-04.jp.co.hitachi:rsd.d8m.t.10098.0a035 Target Alias: ETO: 90 Sessions: Yes Connected Sessions: Yes

Login Options ImmediateData: Yes HeaderDigest: None DataDigest: None AuthMethod: None TargetCHAPName: InitCHAPName:

Target Portal 192.168.0.212:3260 Target Portal Group Tag: 1

4-24 The OneCommand Manager application CLI (in Linux)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

(13)ListHBAs Command

Devices : onboard CNA, CNA/LAN expansion card, FC expansion card Syntax : hbacmd ListHBAs pt=type : Port type filter (valid types: NIC, iSCSI, FC, FCoE) Examples : hbacmd ListHBAs pt=nic

Manageable HBA List

Permanent MAC : 00-00-c9-db-56-48 Current MAC : 00-00-c9-db-56-48 Flags : 80000710 Host Name : localhost.localdomain Mfg : Emulex Corporation Serial No. : FC20975332 Port Number : 0 Mode : Initiator PCI Bus Number : 17 PCI Function : 0 Port Type : NIC Model : OCm11104-F2-HI Sub-Adapter ID : 01

Permanent MAC : 00-00-c9-db-56-4c Current MAC : 00-00-c9-db-56-4c Flags : 80000710 Host Name : localhost.localdomain Mfg : Emulex Corporation Serial No. : FC20975332 Port Number : 1 Mode : Initiator PCI Bus Number : 17 PCI Function : 1 Port Type : NIC Model : OCm11104-F2-HI Sub -Adapter ID : 01

(14)GetQoSInfo Command

Devices : onboard CNA, CNA/LAN expansion card Syntax : hbacmd GetQoSInfo MAC : MAC address of the UCNA port. Examples : hbacmd GetQoSInfo 00-00-c9-db-56-50

NIC QoS values for 00-00-c9-db-56-50:

MaxBitsPerSecond: 0

The OneCommand Manager application CLI (in Linux) 4-25

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

(15)GetVPD Command

Devices : onboard CNA, CNA/LAN expansion card, FC expansion card Syntax : hbacmd GetVPD MAC : MAC address of the UCNA port. Examples : hbacmd GetVPD 00-00-c9-db-56-50

VPD for HBA port 00-00-c9-db-56-50

Product Name : Hitachi OCm11104-F2-HI 4-Port 10Gbps Converged Network Mezzanine Card, NIC PF PN (Part Number) : OCm11104-F2-HI SN (Serial Number) : FC20975332 V0 : FC20975332 VB : PCIe 2.0 x8 5GT/s V1 : Hitachi OCm11104-F2-HI 4-Port 10Gbps Converged Network Mezzanine Card V2 : OCm11104-F2-HI V4 : 2

(16)ShowPersonalities Command

Devices : onboard CNA, CNA/LAN expansion card Syntax : hbacmd ShowPersonalities MAC : MAC address of the UCNA port. Examples : hbacmd CnaGetEventLog 00-00-c9-db-56-50

Adapter Personalities: NIC iSCSI (active & configured) FCoE : 2

4-26 The OneCommand Manager application CLI (in Linux)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

Configuring by OCM_CLI

Configuring the Personality

Configuring the personality of onboard CNA or CNA expansion card by the OCM_CLI is not supported. See "Hitachi Compute Blade Emulex Adapter User's Guide for Hardware" for configuring the personality.

Configuring the PXE Boot

Configuring the PXE by OCM_CLI is not supported. See "Hitachi Compute Blade Emulex Adapter User's Guide for Hardware" for configuring the PXE. Configuring UEFI on the system is necessary for the PXE Boot. See "EFI User's Guide" for the PXE boot

Driver Parameter Settings

The driver parameter can be set by the OCM_CLI. Setting the parameter "lun-queue-depth" is explained below. The performance may be improved by changing the setting of "lun-queue-depth".

1. Confirm the current value of "lun-queue-depth" parameter by "GetDriverParamsGlobal" command.

Syntax : hbacmd GetDriverParamsGlobal

WWPN : Adapter's WWPN

Example : hbacmd GetDriverParamsGlobal 10:00:00:00:c9:dc:4a:48

2. Change the value of "lun-queue-depth" parameter by "SetDriverParam" command. For example, the "lun-queue-depth" value changes from "1e (default value)" to "1f" in this explanation. Execute the following command.

Syntax : hbacmd setdriverparam

Flag1 : L = Make change local for this adapter only. G = Make change global (all adapters on this host). Flag2 : P = Make change permanent (persists across reboot). T = Make change temporary. Param : Name of the parameter to modify. Value : New parameter value, decimal or hexadecimal (0xNNN).

The OneCommand Manager application CLI (in Linux) 4-27

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

Example : hbacmd setdriverparam 10:00:00:00:c9:dc:4a:48 G P lun- queue-depth 1f

3. This procedure is successful if the following is displayed.

Set Driver Parameter lun-queue-depth=0x1f (G P) for 10:00:00:00:c9:dc:4a:48

Driver Parameter 'lun-queue-depth' successfully set to '0x1f' for all emulex adapters on this host.

4. Reboot the system and the procedure is complete.

The setting value of "lun-queue-depth" : The performance may be improved by changing the setting of "lun-queue-depth". The value is limited as follows. The number of LUN to be accessed * lun-queue-depth must be less than 512. (lun-queue-depth = 1 ~ 32) LUN is 17 for example: - When lun-queue-depth is 32 : 17 * 32 = 544 : NG - When lun-queue-depth is 31 : 17 * 31 = 527 : NG - When lun-queue-depth is 30 : 17 * 30 = 510 : OK

iSCSI Target Settings

(1) Connecting to iSCSI Target

Connecting to or disconnecting the iSCSI target can be set by the OCM_CLI. The procedure for CNA expansion card for example is explained below. This example is based on OCM_CLI version 6.1.34.2.

1. Confirm the MAC address of the adapter that is connected to the iSCSI target.

Syntax : hbacmd listhbas [local] [m=model] [pt=type]

local : Only display local adapters m=model : Model filter (append * to end of model name for wildcard match, e.g. LP9*) pt=type : Port type filter (valid types: NIC, iSCSI, FC, FCoE)

4-28 The OneCommand Manager application CLI (in Linux)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

Example :

# hbacmd listhbas Manageable HBA List Permanent MAC : 00-00-c9-da-be-3f Current MAC : 00-00-c9-da-be-3f Logical HBA# : 0 Flags : 80000712 Host Name : lin62x86 Mfg : Emulex Corporation Serial No. : FC20865066 Port Number : 0 Mode : Initiator PCI Bus Number : 42 PCI Function : 2 Port Type : iSCSI Model : OCm11104-F2-HI Sub-Adapter ID : 01

2. Set the IP address of the adapter.

Syntax : hbacmd SetNetworkConfiguration [> >] > [ [Gateway]]

MAC_Address : Only display local adapters VLAN_ENABLED : 0 = Disabled (Not supported) VLAN_ID : (Not supported) Priority : VLAN priority of the interface (Not supported) DHCP : 0 = Disabled (Not supported) IP_Address : New IP address (for example: 10.192.1.1) Subnet_Mask : Subnet Mask (for example: 255.255.255.0) Gateway : (Not supported)

Example :

# hbacmd SetNetworkConfiguration 00-00-c9-da-be-3f VLAN_Enabled=0 DHCP=0 192.168.0.83 255.255.255.0

- "DHCP" function is not supported. - "VLAN" function is not supported. - "Gateway" function is not supported.

3. Confirm the IP address to have been set.

Syntax : GetNetworkConfiguration

MAC_Address : The MAC address of the UCNA port.

The OneCommand Manager application CLI (in Linux) 4-29

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

Example :

# hbacmd GetNetworkConfiguration 00-00-c9-da-be-3f TCP/IP Configuration for 00-00-c9-da-be-3f: DHCP Enabled: No VLAN Enabled: NO VLAN ID: 0 Priority: 0 IP Address: 192.168.0.83 Subnet Mask: 255.255.255.0 Gateway: 0.0.0.0

4. Set the iSCSI initiator name.

Syntax : hbacmd SetInitiatorProperties [Initiator_Name="initiator_name"] [Initiator_Alias="initiator_alias"] [ImmediateData=<0|1>] [HeaderDigest=<0|1>] [DataDigest=<0|1>] [Auth=<0|1|2> "TgtCHAPName" "TgtSecret" "InitCHAPName" "InitSecret"]

MAC_Address : MAC address of the CNA port Initiator_Name : Initiator iSCSI name enclosed in quotes (string length: 1-224) Initiator_Alias : Initiator iSCSI alias enclosed in quotes (string length: 0-32) ImmediateData : (Not supported. Use default: 1 = Yes) HeaderDigest : (Not supported. Use default: 0= None) DataDigest : (Not supported. Use default: 0= None) Auth : (Not supported. Use default: 0= None) TgtCHAPName : Target CHAP name enclosed in quotes (string length: 1-256) TgtSecret : Target Secret enclosed in quotes (string length: 12-16) InitCHAPName : Initiator CHAP name enclosed in quotes (string length: 1-256) InitSecret : Initiator Secret enclosed in quotes(string length:12-16)

Example :

# hbacmd SetInitiatorProperties 00-00-c9-da-be-3f initiator_name=iqn.1994-04.jp.co.hitachi:i.0

"ImmediateData", "HeaderDigest", "DataDigest", "Auth" functions are not supported. Use each default value.

5. Confirm the iSCSI initiator name to have been set.

Syntax : hbacmd GetInitiatorProperties

4-30 The OneCommand Manager application CLI (in Linux)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

MAC_Address : MAC address of the CNA port

Example :

# hbacmd GetInitiatorProperties 00-00-c9-da-be-3f Initiator login options for 00-00-c9-da-be-3f: Initiator iSCSI Name: iqn.1994-04.jp.co.hitachi:i.0 Initiator Alias: ImmediateData: Yes HeaderDigest: None DataDigest: None AuthMethod: None TargetCHAPName: Not Available InitCHAPName: Not Available

6. Set the target

Syntax : hbacmd AddTarget [ImmediateData=<0|1>] [HeaderDigest=<0|1>] [DataDigest=<0|1>] [Boot=<0|1>] [Login=<0|1>] [Auth=<0|1|2> "TgtCHAPName" "TgtSecret" "InitCHAPName" "InitSecret"]

MAC_Address : The MAC address of the UCNA port. Target_IP : IP address of the target portal Port : Port number of the target portal (value: 1024-65535) iscsi_target_name : Target's iSCSI name enclosed in quotes (string length: 11-255). ImmediateData : (Not supported. Use default: 1 = Yes) HeaderDigest : (Not supported. Use default: 0= None) DataDigest : (Not supported. Use default: 0= None) Boot : This optional parameter specifies whether the added target is a boot device: 0 = Added target is not a boot device. 1 = Added target is a boot device. Login : This optional parameter specifies whether to log in to the target after it has been added: 0 = Do not log in to the target. 1 = Specify log in to the target. If the Login parameter is omitted, the default is 1. Auth : (Not supported. Use default: 0= None) TgtCHAPNam : Target CHAP name enclosed in quotes (string length: 1-256). TgtSecret : Target Secret enclosed in quotes (string length: 12-16). InitCHAPName : Initiator CHAP name enclosed in quotes (string length: 1-256). InitSecret : Initiator Secret enclosed in quotes(string length:12-16).

Example :

# hbacmd AddTarget 00-00-c9-da-be-3f 192.168.0.201 3260 iqn.1994-04.jp.co.hitachi:t.0.0

The OneCommand Manager application CLI (in Linux) 4-31

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

"ImmediateData", "HeaderDigest", "DataDigest", "Auth" functions are not supported. Use each default value.

7. Login to the target

Syntax : hbacmd TargetLogin [target_portal_ip ] [ImmediateData=<0|1>] [HeaderDigest=<0|1>] [DataDigest=<0|1>] [Auth=<0|1|2> "TgtCHAPName" "TgtSecret" "InitCHAPName" "InitSecret"]

MAC_Address : The MAC address of the UCNA port. iscsi_target_name : The target’s iSCSI name enclosed in quotes (string length: 11-255). Port : The port number of the target portal. The possible values are 1024-65535. ImmediateData : (Not supported. Use default: 1 = Yes) HeaderDigest : (Not supported. Use default: 0= None) DataDigest : (Not supported. Use default: 0= None) Auth : (Not supported. Use default: 0= None) TgtCHAPNam : The Target CHAP name enclosed in quotes (string length: 1-255). TgtSecret : The Target Secret enclosed in quotes (string length: 12-16). InitCHAPName : The Initiator CHAP name enclosed in quotes (string length: 1-255). InitSecret : The Initiator Secret enclosed in quotes (string length: 12-16).

Example :

# hbacmd TargetLogin 00-00-c9-da-be-3f iqn.1994-04.jp.co.hitachi:t.0.0 192.168.0.201 3260

"ImmediateData", "HeaderDigest", "DataDigest", "Auth" functions are not supported. Use each default value.

8. Confirm the connection to the LU

Syntax : hbacmd GetiSCSILuns

MAC_Address : MAC address of the CNA port

4-32 The OneCommand Manager application CLI (in Linux)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

iscsi_target_name : Target’s iSCSI name enclosed in quotes (string length: 11-255)

Example :

# hbacmd GetiSCSILuns 00-00-c9-da-be-3f iqn.1994-04.jp.co.hitachi:t.0.0 LUN 0: Vendor Name: HITACHI Model Number: DF600F Serial Number: 83002054001E LUN Type: 0 Capacity: 10.00 GB Block Size: 512

(2) Disconnecting the iSCSI target

The procedure to disconnect the iSCSI target is described below.

1. Confirm the MAC address of the port that is connected to the iSCSI target.

Syntax : hbacmd ListHBAs [pt=type]

pt=type: Port type filter (valid types: NIC, iSCSI, FC, FCoE)

Example :

# hbacmd listhbas Manageable HBA List Permanent MAC : 00-00-c9-da-be-3f Current MAC : 00-00-c9-da-be-3f Logical HBA# : 0 Flags : 80000712 Host Name : lin62x86 Mfg : Emulex Corporation Serial No. : FC20865066 Port Number : 0 Mode : Initiator PCI Bus Number : 42 PCI Function : 2 Port Type : iSCSI Model : OCm11104-F2-HI Sub-Adapter ID : 01

2. Confirm the "TSIH" value in the session information of the target

Syntax : hbacmd ListSessions

MAC : The MAC address of the UCNA port Target-name: Target's iSCSI name enclosed in quotes (string length: 11 - 255)

The OneCommand Manager application CLI (in Linux) 4-33

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

Example :

# hbacmd ListSessions 00-00-c9-da-be-3f iqn.1994-04.jp.co.hitachi:t.0.0 Total Sessions: 1 Session 1 Initiator Name: iqn.1994-04.jp.co.hitachi:t.0.0 Status: Open TSIH: 32954 ISID: 0x4000006c0000 ISID Qualifier: 0 Target IP Address: 192.168.0.201 Automatic Login: Yes iSCSI Boot: No

3. Disconnect the target.

Syntax : hbacmd TargetLogout >

MAC_Address : The MAC address of the UCNA port. iscsi_target_name : The target’s iSCSI name enclosed in quotes (string length: 11-255). TSIH : The TSIH value of the session. The possible values are 1- 65535. ISID_Qual : The ISID qualifier of the session. The possible values are 0-65535. Target_IP : The target's IP address.

Example :

# hbacmd TargetLogout 00-00-c9-da-be-3f iqn.1994-04.jp.co.hitachi:t.0.0 32954

A target can be disconnected only per name.

4. Confirm that the LU has been disconnected.

Syntax : hbacmd GetiSCSILuns

Example :

# hbacmd GetiSCSILuns 00-00-c9-da-be-3f iqn.1994-04.jp.co.hitachi:t.0.0

This procedure is complete.

4-34 The OneCommand Manager application CLI (in Linux)

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

5

Supported Operating Systems

The Emulex adapters support the following operating systems.

¨ Supported Operating Systems

Supported Operating Systems 5-1

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

Supported Operating Systems

The Emulex adapters support the following operating systems.

(1) The OneCommand Manager application GUI

- Windows Server 2012 R2 Standard - Windows Server 2012 R2 Datacenter - Windows Server 2012 Standard - Windows Server 2012 Datacenter - Windows Server 2008 R2 Standard - Windows Server 2008 R2 Enterprise - Windows Server 2008 R2 Datacenter - Windows Server 2008 Standard - Windows Server 2008 Enterprise - Windows Server 2008 Datacenter - Windows Server 2008 Standard without Hyper-V - Windows Server 2008 Enterprise without Hyper-V - Windows Server 2008 Datacenter without Hyper-V - Windows Server 2008 Standard 32-bit - Windows Server 2008 Enterprise 32-bit - Windows Server 2008 Datacenter 32-bit - Windows Server 2008 Standard without Hyper-V 32-bit - Windows Server 2008 Enterprise without Hyper-V 32-bit - Windows Server 2008 Datacenter without Hyper-V 32-bit

(2) The OneCommand Manager application CLI

- Red Hat Enterprise Linux 6.5 (64-bit x86_64) - Red Hat Enterprise Linux 6.5 (32-bit x86) - Red Hat Enterprise Linux 6.4 (64-bit x86_64) - Red Hat Enterprise Linux 6.4 (32-bit x86) - Red Hat Enterprise Linux 6.2 (64-bit x86_64) - Red Hat Enterprise Linux 6.2 (32-bit x86) - Red Hat Enterprise Linux 5.9 (AMD/Intel64) - Red Hat Enterprise Linux 5.9 (x86) - Red Hat Enterprise Linux 5.7 (AMD/Intel64) - Red Hat Enterprise Linux 5.7 (x86)

5-2 Supported Operating Systems

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

6

Restrictions

This chapter describes the restrictions on the OCM and OCM_CLI.

¨ Restrictions on OCM and OCM_CLI

Restrictions 6-1

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

Restrictions on OCM and OCM_CLI

The OCM and OCM_CLI functions for the system have the following restrictions.

On the system : Configuring the PXE is not supported.

On network : "DHCP", "VLAN", "Gateway" functions are not supported.

On iSCSI : "ImmediateData", "HeaderDigest", "DataDigest", "Authentication" functions are not supported.

On CNA : Configuring the personality is not supported.

Else : Dump function to create a"dump" file for a selected adapter is not supported.

For the functions above, see the following document. - "Hitachi Compute Blade Emulex Adapters User's Guide for Hardware (MK-99COM104)" - "Hitachi Compute Blade LAN Advanced Function Manual for Emulex (MK-99COM082)"

6-2 Restrictions

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

Acronyms and Abbreviations

OS's Windows Server 2012 R2 Microsoft(R) Windows Server(R) 2012 R2 Standard Microsoft(R) Windows Server(R) 2012 R2 Datacenter Windows Server 2012 Microsoft(R) Windows Server(R) 2012 Standard Microsoft(R) Windows Server(R) 2012 Datacenter Windows Server 2008 R2 Microsoft(R) Windows Server(R) 2008 R2 Standard Microsoft(R) Windows Server(R) 2008 R2 Enterprise Microsoft(R) Windows Server(R) 2008 R2 Datacenter

Windows Server 2008 Microsoft(R) Windows Server(R) 2008 Standard without Hyper- VTM Microsoft(R) Windows Server(R) 2008 Enterprise without Hyper-VTM Microsoft(R) Windows Server(R) 2008 Standard Microsoft(R) Windows Server(R) 2008 Enterprise

Windows Server 2008 Microsoft(R) Windows Server(R) 2008 Standard without Hyper- (32bit) VTM 32-bit Microsoft(R) Windows Server(R) 2008 Enterprise without Hyper-VTM 32-bit Microsoft(R) Windows Server(R) 2008 Standard 32-bit Microsoft(R) Windows Server(R) 2008 Enterprise 32-bit

RHEL5.7 Red Hat(R) Enterprise Linux(R) Server 5.7 RHEL5.9 Red Hat(R) Enterprise Linux(R) Server 5.9 RHEL6.2 Red Hat(R) Enterprise Linux(R) Server 6.2 RHEL6.4 Red Hat(R) Enterprise Linux(R) Server 6.4 RHEL6.5 Red Hat(R) Enterprise Linux(R) Server 6.5 RHEL6.6 Red Hat(R) Enterprise Linux(R) Server 6.6

ESXi5.0 VMware ESXi5.0 ESXi5.1 VMware ESXi5.1 ESXi5.5 VMware ESXi5.5

Adapters onboard CNA CB500 series onboard CNA CNA expansion card 10Gb 4-port converged network expansion card (GG-CN3MXG2X1-Y) LAN expansion card 10Gb 4-port LAN expansion card (GG-CN3MXG2X2-Y) FC expansion card 8Gb 2-port Fiber Channel expansion card (GG-CC3M8G1X1-Y)

Glossary Glossary-1

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

Utilities OCM OneCommandTM Manager application GUI OCM_CLI OneCommandTM Manager application CLI

Terms ARP address resolution protocol ASIC application-specific integrated circuit BIOS basic input-output system CLI command line interface CSV comma-separated values DCB ETO Extended TimeOut FC Fibre Channel FCoE Fibre Channel over Ethernet FIP FCoE Initialization Protocol GUI graphical user interface HBA host bus adapter ICMP Internet Control Message Protocol IP Internet Protocol iSCSI internet Small Computer System Interface iSNS internet Storage Name Server LUN logical unit number MAC media access control MSI message signaled interrupts MTU maximum transmission unit NIC network interface card (or controller) PXE Pre-boot Execution Environment RHEL Red Hat Enterprise Linux SAN storage area network SCSI Small Computer System Interface TCP Transmission Control Protocol UCNA universal converged network adapter UMC Universal Multichannel VPD vital product data VPort virtual port WWN world wide name WWNN world wide node name WWPN world wide port name VM virtual machine XML extensible markup language

Glossary-2 Glossary

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

Hitachi Data Systems

Corporate Headquarters 2845 Lafayette Street Santa Clara, California 95050-2639 U.S.A. www.hds.com

Regional Contact Information Americas +1 408 970 1000 [email protected]

Europe, Middle East, and Africa +44 (0) 1753 618000 [email protected]

Asia Pacific +852 3189 7900 [email protected]

MK-99COM105-08