Hitachi Compute Blade Emulex Adapter User's Guide for Utility

MK-99COM105-10

Hitachi Compute Blade Emulex Adapter

User's Guide for Utility

Getting Help

Contents

FASTFIND LINKS

ii

Hitachi Compute Blade Emulex Adapter User's Guide for Utility

© 2013-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.

Contents iii


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

Preface v


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

vi Preface


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 <group>

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

WARNING This indicates the presence of a potential risk that might cause death

or severe injury.

CAUTION This indicates the presence of a potential risk that might cause

relatively mild or moderate injury.

NOTICE NOTICE This indicates the presence of a potential risk that might cause severe damage to the equipment and/or damage to surrounding properties.

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

equipment.

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

Preface vii


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





(RHEL5.7 hereafter)

viii Preface


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!

https://portal.hds.com/

mailto:[email protected]

1

Overview of This Manual 1-1


Overview of This Manual

This manual describes the management utility for the Emulex products

Hitachi Compute Blade Emulex Adapter User's Guide

1-2 Overview of This Manual


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

series 540A B1 Onboard CNA GGAGD0B1-TNNX14Y

2 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 520X B2 Onboard CNA GG-RV3XGE0B2X1-Y 7 CNA expansion card GG-CN3MXG2X1-Y 8 GGX-CN3MXG2X1[EX] 9 GGX-CN3MXG2X3[EX] 10 LAN expansion card GG-CN3MXG2X2-Y 11 GGX-CN3MXG2X2[EX] 12 GGX-CN3MXG2X4[EX] 13 8Gb FC expansion card GG-CC3M8G1X1-Y 14 GGX-CC3M8G1X1[EX] 15 16Gb FC expansion card GG-CC3M161X1-Y 16 GGX-CC3M161X1[EX] 17 CB2000

series CNA board

(for chassis) GV-CN2NXG3X1-Y

18 GV-CN2NXG3XR-Y for RoHS 19 GVX-CN2NXG3X1[BX] 20 GVX-CN2NXG3X2[BX] for CB2000 x4 model 21 CNA board

(for I/O slot expansion unit) GV-CN2DXG3X1-Y

22 GVX-CN2DXG3X1[EX] 23 GVX-CN2DXG3X2[EX] for CB2000 x4 model 24 LAN expansion card (2-port) GV-CN2MXG1X1-Y 25 GVX-CN2MXG1X1[EX] 26 GVX-CN2MXG1X2[EX] for CB2000 x4 model 27 LAN expansion card (4-port) GV-CN2MXG2X1-Y 28 GVX-CN2MXG2X1[EX] 29 GVX-CN2MXG2X2[EX] for CB2000 x4 model 30 CNA expansion card (2-port) GV-CN2MXG3X1-Y 31 GVX-CN2MXG3X1[EX] 32 GVX-CN2MXG3X2[EX] for CB2000 x4 model 33 CNA expansion card (4-port) GV-CN2MXG4X1-Y 34 GVX-CN2MXG4X1[EX] 35 GVX-CN2MXG4X2[EX] for CB2000 x4 model 36 8Gb FC board

(for chassis) GV-CC2N8G3X1-Y

37 GV-CC2N8G3XR-Y for RoHS 38 GVX-CC2N8G3X1[BX] 39 8Gb FC board

(for I/O slot expansion unit) GV-CC2D8G3X1-Y

40 GVX-CC2D8G3X1[EX] 41 8Gb FC expansion card GV-CC2M8G3X1-Y 42 GV-CC2M8G3XR-Y for RoHS 43 GVX-CC2M8G3X1[EX] 44 16Gb FC board

(for chassis) GV-CC2N163X1-Y

45 GVX-CC2N163X1[BX] 46 16Gb FC board

(for I/O slot expansion unit) GV-CC2D163X1-Y

47 GVX-CC2D163X1[EX] 48 CB2500

series 520X B1 Onboard CNA GG-RV3XGE0B1X1-Y

49 520X B2 Onboard CNA GG-RV3XGE0B2X1-Y 50 520H B3 Onboard CNA GG-RV3XGC0B3X1-Y 51 CNA board GG-CN4NXG3X1-Y 52 8Gb FC board GG-CC4N8G3X1-Y 53 16Gb FC board GG-CC4N163X1-Y

Overview of This Manual 1-3


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

1 Hitachi Compute Blade Emulex Adapter User's Guide for Driver (MK-99COM103)

How to install the drivers of the adapters How to setup the drivers

2 Hitachi Compute Blade Emulex Adapter User's Guide for Hardware (MK-99COM104)

Outline of Emulex adapters BIOS parameter list and the way to configure the parameters

3 Hitachi Compute Blade Emulex Adapter User's Guide for Utility (MK-99COM105)

This document. How to install and to operate the utility that manages the Emulex adapters How to configure the parameters with the utility

4 Hitachi Compute Blade LAN Advanced Function Manual for Emulex (MK-99COM082)

How to setup the NIC teaming How to setup the VLAN

2

Flow Chart of Setting up 2-1


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

2-2 Flow Chart of Setting up


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.

See "Hitachi Compute Blade

Emulex Adapter User's Guide

for Hardware"

See "OS Installation Guide" for each OS.



for Driver"

In this document,

See the chapter 3 or 4.


LAN Advanced function manual

for Emulex"

Setting Personality

Setup of OS

End

iSCSI driver

Enabling multichannel

function

Disabling Multichannel

function

Enabling PXE

Disabling PXE

Setting iSCSI target (for boot)

Setting iSCSI initiator

Settings by OCM/OCM_CLI

NIC driver

Settings by NIC Teaming Kit

Teaming setting VLAN setting

Setting iSCSI target (for data)

Setting FCoE

FCoE driver

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

Start

Flow Chart of Setting up 2-3


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

OS Setting up

Setting Fibre Channel Device

boot configuration for FC device

End

Configuring the driver

parameters.

Configurations by OCM/OCM_CLI

Installing Driver

In this document,

see the chapter 3 or 4.



for Driver"



for Hardware"

See "OS Installation Guide" foreach OS.

3

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


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

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


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 CB520X B1

CB500 CB 520X B2

CB500 CB 520H B3

CB2500 520X B1

CB2500 520X B2

CB2500 520H B3



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 : "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 CB520AA1, CB520H x1, CB540A x1 model : "CB500 10Gb CNA Driver CD ver.01-13" media :

OS OCM version Location of the installation file Windows Server 2008 (32bit) 6.3.16.1 or 6.3.16.1-1 \WinSrv2008\Utility\OCM Windows Server 2008 Windows Server 2008 R2 Windows Server 2012 Windows Server 2012 R2

- CB500 CB520H B2 model: "CB500 10Gb CNA Driver CD ver.01-13" media :

OS OCM version Location of the installation file Windows Server 2008 (32bit) 6.3.16.1 or 6.3.16.1-1 \WinSrv2008\Utility\OCM Windows Server 2008 Windows Server 2008 R2 Windows Server 2012 Windows Server 2012 R2



- CB500 CB520X B1/ CB520X B2/CB520H B3 model: "CB500 10Gb CNA Drivers ver.01-13" media :

OS OCM version Location of the installation file Windows Server 2008 R2 10.2.340.5 or 10.2.340.5-1 \WinSrv2008\Utility\OCM_2 Windows Server 2012 Windows Server 2012 R2

- CB2500 520X B1/520X B2/520H B3 model: "CB2500 10Gb CNA Drivers ver.01-13" media :

OS OCM version Location of the installation file Windows Server 2008 R2 10.2.340.5 or 10.2.340.5-1 \WinSrv2008\Utility\OCM_2 Windows Server 2012 Windows Server 2012 R2

- CB2000 Standard server blade x3 model :

" Server installation and monitoring tool " media : OS OCM version Location of the installation file

Windows Server 2008 (32bit) 6.3.16.1 or 6.3.16.1-1 See the file "support_EN.html" in the root folder. Windows Server 2008

Windows Server 2008 R2 Windows Server 2012 Windows Server 2012 R2

- CB2000 High performance server blade, Standard server blade x4 model: " Server installation and monitoring tool " media :

OS OCM version Location of the installation file Windows Server 2008 (32bit) 6.3.16.1 or 6.3.16.1-1 See the file "support_EN.html" in the

root folder. Windows Server 2008 Windows Server 2008 R2 Windows Server 2012 Windows Server 2012 R2

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.



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.



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.



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.



Stopping OCM

1. Stopping OCM.

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



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 : 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

A B

D

C

E



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 Management Mode

Ver.6.1.34.1 or later

Export SAN Info Creates reports about discovered SAN elements. Reports are generated in .xml and .csv format.

Exit Quits OCM



- Edit menu


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


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 Name

Displays the discovery-tree by Host Name.

Group Adapter by Fabric Address

Displays the discovery-tree by Fabric Address.

Group Adapter by Virtual Port

Displays the discovery-tree by Virtual 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.



- Port menu


Reset Port... Resets the specified port. Edit Name... --- Not supported Use Default Name --- Not supported

- Discovery menu


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


Download Firmware... --- Not supported Update Driver Parameter... --- Not supported



- Help menu


Contents Displays the OCM's online help. About OneCommand (TM) Manager

Displays the version information of OCM

(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.



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).



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 exchangers. A media exchanger is a jukebox-like device that is capable of swapping various media device instances (such as records or CDs) in and out.

Not supported

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.



- 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 Address

If the host is discovered with FC, the Management IP 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 Server Version

The version of the OCM server that is running on the host. If 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 Ports

The number of discovered physical ports that can be managed by 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.



- 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.


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 Parameter Area

Adapter-specific information is displayed in this area. This can 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 temporary (if possible)

If you want the change to be temporary (causing the parameter to revert to its last permanent setting when the system is 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.



(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 Version

The firmware version currently being used by the adapter.

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 Speed

The speed of the PCI bus in which the adapter running.

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.

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




loaded.






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)


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.



The property tabs of ASIC node icon are explained below.

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





loaded.




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.



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 Version


Flash Firmware Version

The flash firmware version currently being used by the adapter.

BIOS Version The version of the BIOS currently being used by the adapter. Boot Code Versions Area

The version of boot code and so on.

Download Firmware Button

--- Not supported

Diagnostic Dump Button

--- Not supported



- Firmware Tab (4-port onboard CNA)

Table 3-19-2: Item Content Remarks

Active Firmware Version


Flash Firmware Version

The flash firmware version currently being used by the adapter.

BIOS Version The version of the BIOS currently being used by the adapter. Boot Code Versions Area

The version of boot code and so on.

Download Firmware Button

--- Not supported

Diagnostic Dump Button

--- Not supported



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

The property tabs of port icon are explained below.

- Physical Port Info Tab


PCI Function Summary Area

displays the number of logical ports of NIC/iSCSI/FCoE

physical Port Status Area

- Status : displays current connection status - Interface Type :



- 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


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.



FCoE Properties Area (FCoE ports only)

- State : The FCoE state. It can be Enabled or Disabled. - 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 Properties Area

- State : The FCoE or NIC-only state. It can be Enabled or 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)



- 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 property tabs of NIC icon are explained below.

- Port Information Tab


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.



- 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 property tabs of iSCSI icon are explained below.

- Port Information Tab

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 check box

--- Not supported

displayed in Ver. 6.1.14.1 or later



- PCI Registers Tab

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



- 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




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

- iSCSI Statistics Tab


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 Type

The type of failure encountered in the last session failure.

Last Session Remote Node Name

The iSCSI name of the remote node from the failed session.

Session Digest Errors The count of sessions which failed due to receipt of a PDU containing header or data digest errors.

Session Connection Timeout

The count of sessions which failed due to a sequence exceeding 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 Name

The UTF-8 string name of the target that most recently failed a login request from this initiator.

Last Target Failure Address

The Internet Network Address of the target that most recently failed.

Login Accept Responses

The count of Login Response PDUs received by this initiator that were accepted.

Login Other Fail Responses

The count of Login Response PDUs received by this initiator with any status code not counted by the other objects.



Login Redirect Response

The count of Login Response PDUs received by the initiator with status class Redirection.

Login Authentication Fail Responses

The count of Login Response PDUs with status class 0x201 Authentication Failed received by this initiator.

Login Authentication Failures

The number of times the initiator has aborted a login because the target could not be authenticated.

Login Negotiation Failures

The number of times the initiator has aborted a login because 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


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 Area

--- Not 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 (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 Options...Button

Click this button to see the default login settings.

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

- iSCSI Target Discovery Tab




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... Button

Click to manually add an iSCSI target.

Target Sessions... Button

Click to view active sessions for the selected target.

Remove Target... Button

Click to manually remove an iSCSI target.

Refresh Target Click to manually force a complete rediscovery of the targets, querying all configured iSNS servers and target portals.



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

- Target Information Tab


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 Information Area

- IP Address : The IP address through which the initiator 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 property tabs of LUN icon under iSCSI - Virtual Port – Target icon are explained below.

- LUN Information Tab


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) 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)


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.



- 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.



The property tabs of port icon are explained below.

- Port Information Tab (FC expansion card)


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 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



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 Button

Click to enable or disable the selected FC port.

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)


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



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.



- Statistics Tab (FC/FCoE)


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.



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.)



- 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 Area

--- Not supported

Change WWN... Button Not supported

Download Firmware... button is not supported.



- 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 Area

--- Not supported

Change WWN... Button Not supported



- 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 Area

--- Not supported

Change WWN ... Button Not supported



- DHCHAP Tab (Not supported)

- Target Mapping Tab (FC/FCoE)


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 Configuration Area

This table lists persistent binding information for the selected adapter port. (Not available on VMware ESX servers being managed through the CIM interface.)

Display Mode Radio Buttons

Show WWPN, Show WWNN or Show D_ID options enable you to choose how to display information in the Persistent Binding Configuration table.

Refresh Button Click to refresh the Target Mapping tab. Change Settings Button

Click to enable or disable automapping, choose a bind type and enable or disable LUN mapping and unmasking. (Not available on VMware ESX servers being managed through the CIM interface.)

Not supported

Add Binding Button Click to add a persistent binding. Not supported

Bind New Target Button

Click to add a target that does not appear in the Persistent Binding table.

Not supported

Remove Button Click to remove the selected binding. Remove All Bindings Button

Click to remove all persistent bindings that are displayed.



- Driver Parameters Tab (FC/FCoE)


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 table

A list of adapter driver parameters for the selected driver type and their current values.

Modify Adapter Parameter Area

Adapter-specific information is displayed in this area. This can include value, range, default, activation requirements and description.

Make all changes temporary check Box

If you are making changes to multiple parameters, and you 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



- Diagnostics Tab


Diagnostic Test --- Not supported

Beacon --- Not supported

Diagnostic Dump... button

--- Not supported

PCI Registers Flash Contents

- Transceiver Data Tab (Not supported)



- VPD Tab


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




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

- Target Information Tab


Mapping Information Area

- FC ID : The FC ID for the target; assigned automatically in 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.



- LUN Masking Tab (In disabled state)


Re-enable LUN masking Button

enables LUN masking again.



- LUN Masking Tab (In enabled state)


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 property tabs of LUN icon under Adapter - Port – Target icon are explained below.

- LUN Information Tab

Table 3-46:

Item Content Remarks Vendor/Product Information Area

- Vendor Name : The name of the vendor of the LUN. - Product ID : The vendor-specific ID for the LUN. - Revision : The vendor-specific revision number for the LUN.

Mapping Information Area

- FCP LUN : The FC identifier used by the adapter to map to the 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 Information Area

- Current Mask Status : Possible states are masked or unmasked.



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.

(a)

(b)

(c)

(d)

(e)



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. 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.

(a)

(b)

(c) 0.0.0.0 0.0.0.0



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.

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

(a)

(b)

(c)

(d) Apply Changes



6. Connect to the iSCSI target


(b) Open iSCSI Target Discovery tab.

(c) Click Add Portal button.

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.

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

(a)

(b)

(c)

(a)

(b)



9. Login to the target.

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

(b) Click Target Login button.

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

(a)

(b)



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.

(a)

(b)



(2) Disconnecting the iSCSI target

The procedure to disconnect the iSCSI target is described below.

1. Select the iSCSI target to be disconnected.


(b) Open iSCSI Target Discovery tab.

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

(d) Click Target Sessions button.

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.

(a)

(b)

(c)

(d)



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 or higher.

10.0.803.25 or higher

Driver ver. (Windows 2012)

2.74.14.1 or higher

10.0.720.0 or higher

Driver ver. (Windows 2012 R2)

2.76.2.1 or higher

10.0.720.0 or higher

OneCommand Manager ver.

6.3.16.1-1 / 6.3.16.1 or higher

6.3.16.1-1 / 6.3.16.1 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.



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.



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.

4

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


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

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


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 CB520X B1

CB500 CB520X B2

CB500 CB520H B3

CB2500 520X B1

CB2500 520X B2

CB2500 520H B3 7 10.2.470.0 Only for RHEL6.6

(except CB500 CB520AA1)



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" or "10Gb CNA Driver CD" media into the DVD-ROM drive of system console.

For CB500/CB2500:

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.

For CB2000:

Select Remote CD/DVD - Start CD/DVD in the tool bar of the remote console. Then, select CD/DVD Drive button and click OK. (See "Hitachi Compute Blade 2000 USER'S GUIDE" for Remote Console Application (Java Application).)

Table 4-2:

- CB500 CB520A A1 model : "CB500 10Gb CNA Driver CD ver.01-13 (or higher)" media : OS OCM_CLI version Location of the installation file

RHEL6.2/5.7/5.9 6.3.16.2 /RHEL6/Utility/elxocm06*-<version>.tgz ("*" is a number.)

RHEL6.4 6.3.22.1 RHEL6.5 10.2.340.5-1

- CB500 CB520H x1/CB540A x1 model : "CB500 10Gb CNA Driver CD ver.01-13(or higher)" media :

OS OCM_CLI version Location of the installation file RHEL6.2/5.7/5.9 6.3.16.2 /RHEL6/Utility/elxocm06*-<version>.tgz

("*" is a number.)

RHEL6.4 6.3.22.1 RHEL6.5 10.2.340.5-1 RHEL6.6 10.2.470.0



- CB500 CB520H B2 model: "CB500 10Gb CNA Driver CD ver.01-13(or higher)" media : OS Location of the installation file

RHEL6.4 6.3.22.1 /RHEL6/Utility/elxocm06*-<version>.tgz ("*" is a number.) RHEL6.5 10.2.340.5-1

RHEL6.6 10.2.470.0 - CB500 CB520X B1/CB520H B3 model: "CB500 10Gb CNA Driver CD ver.01-13(or higher)" media :

OS Location of the installation file RHEL6.5 10.2.340.5-1 /RHEL6/Utility/elxocm06*-<version>.tgz

("*" is a number.) RHEL6.6 10.2.470.0 - CB2500 520X B1/520H B3 model: "CB2500 10Gb CNA Driver CD ver.01-13 (or higher)" media :


("*" is a number.) RHEL6.6 10.2.470.0 - CB500 CB520X B2 model: "CB500 10Gb CNA Driver CD ver.01-13 (or higher)" media :

OS Location of the installation file

RHEL6.6 10.2.470.0 /RHEL6/Utility/elxocm06*-<version>.tgz ("*" is a number.)

- CB2500 520X B2 model: "CB2500 10Gb CNA Driver CD ver.01-13 (or higher)" media : OS Location of the installation file


- CB2000 High performance server blade x2, Standard server blade x3 model : "CB2000 10Gb CNA Driver CD ver.01-12 (or higher)" media :


("*" is a number.)

RHEL6.4 6.3.22.1 RHEL6.5 10.2.340.5-1 RHEL6.6 10.2.470.0

- CB2000 Standard server blade x4 model: "CB2000 10Gb CNA Driver CD ver.01-12 (or higher)" media : OS OCM_CLI version Location of the installation file


RHEL6.4 6.3.22.1 RHEL6.5 10.2.340.5-1 RHEL6.6 10.2.470.0

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/<path to the install file>/elxocm<version>.tgz /tmp/ocmwork # umount /media # cd /tmp/ocmwork

Extract the utility file.

# tar -zxvf /tmp/ocmwork/elxocm<version>.tgz

3. Execute the following command.

4. Reboot the system and the procedure is complete.

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



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. Insert "Server installation and monitoring tool" or "10Gb CNA Driver CD" media into the DVD-ROM drive of system console.

For CB500/CB2500:

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.

For CB2000:

Select Remote CD/DVD - Start CD/DVD in the tool bar of the remote console. Then, select CD/DVD Drive button and click OK. (See "Hitachi Compute Blade 2000 USER'S GUIDE" for Remote Console Application (Java Application).)

Table 4-3:

- CB500 CB520A A1 model : "CB500 10Gb CNA Driver CD ver.01-13 (or higher)" media : OS OCM_CLI version Location of the installation file


RHEL6.4 6.3.22.1 RHEL6.5 10.2.340.5-1

- CB500 CB520H x1/CB540A x1 model : "CB500 10Gb CNA Driver CD ver.01-13(or higher)" media : OS OCM_CLI version Location of the installation file


RHEL6.4 6.3.22.1 RHEL6.5 10.2.340.5-1 RHEL6.6 10.2.470.0

- CB500 CB520H B2 model: "CB500 10Gb CNA Driver CD ver.01-13(or higher)" media : OS Location of the installation file

RHEL6.4 6.3.22.1 /RHEL6/Utility/elxocm06*-<version>.tgz ("*" is a number.) RHEL6.5 10.2.340.5-1

RHEL6.6 10.2.470.0 - CB500 CB520X B1/CB520H B3 model: "CB500 10Gb CNA Driver CD ver.01-13(or higher)" media :


("*" is a number.) RHEL6.6 10.2.470.0 - CB2500 520X B1/520H B3 model: "CB2500 10Gb CNA Driver CD ver.01-13 (or higher)" media :


("*" is a number.) RHEL6.6 10.2.470.0



- CB500 CB520X B2 model: "CB500 10Gb CNA Driver CD ver.01-13 (or higher)" media : OS Location of the installation file


- CB2500 520X B2 model: "CB2500 10Gb CNA Driver CD ver.01-13 (or higher)" media : OS Location of the installation file


- CB2000 High performance server blade x2, Standard server blade x3 model : "CB2000 10Gb CNA Driver CD ver.01-12 (or higher)" media :


("*" is a number.)

RHEL6.4 6.3.22.1 RHEL6.5 10.2.340.5-1 RHEL6.6 10.2.470.0

- CB2000 Standard server blade x4 model: "CB2000 10Gb CNA Driver CD ver.01-12 (or higher)" media : OS OCM_CLI version Location of the installation file


RHEL6.4 6.3.22.1 RHEL6.5 10.2.340.5-1 RHEL6.6 10.2.470.0

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/<path to the install file>/elxocm<version>.tgz /tmp/ocmwork # umount /media # cd /tmp/ocmwork

Extract the utility file.

# tar -zxvf /tmp/ocmwork/elxocm<version>.tgz



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



Confirming OCM_CLI version


# hbacmd Version

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



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 <command> [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]] <command> [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.



. 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.



Stopping OCM_CLI

No operation is needed to stop OCM_CLI normally.



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 [GroupName][CmdName]

Displays command information for the HbaCmd application.

Table 4-6: Adapter License Management Command Command Command Syntax Description Remarks

ShowLicenseAdapterID hbacmd ShowLicenseAdapterID <WWPN|MAC>

--- Not supported

InstallAdapterLicense hbacmd InstallAdapterLicense <WWPN|MAC> <LicenseFile>

--- Not supported

ShowAdapterLicenseFeatures

hbacmd ShowAdapterLicenseFeatures <WWPN|MAC>

--- Not supported

Table 4-7: Attributes Command Command Command Syntax Description Remarks

HbaAttributes hbacmd [h=<IPAddress>] hbaattributes <WWPN>

Shows a list of all adapter attributes for all ports on the adapter.

PortAttributes hbacmd <h=IPAddress of host> PortAttributes <WWPN|MAC>

Shows a list of all port attributes for the adapter.

PortStatistics hbacmd PortStatistics <WWPN> --- Not supported ServerAttributes hbacmd ServerAttributes <WWPN|MAC> --- Not supported SetPhyPortSpeed SetPhyPortSpeed <WWPN | MAC

address> <Mode> [Speed [Length]] --- Not supported

SetPortEnabled SetPortEnabled <WWPN | MAC address> <PortEnable>

--- Not supported

Table 4-8: Authentication Command Command Command Syntax Description Remarks

AuthConfigList hbacmd AuthConfigList <WWPN> --- Not supported DeleteAuthConfig hbacmd DeleteAuthConfig <WWPN1>

<WWPN2> <PasswordType> <Password> --- Not supported

GetAuthConfig hbacmd GetAuthConfig <WWPN1> <WWPN2>

--- Not supported

GetAuthStatus, hbacmd GetAuthStatus <WWPN1> <WWPN2>

--- Not supported



Command Command Syntax Description Remarks InitiateAuth hbacmd InitiateAuth <WWPN1>

<WWPN2> --- Not supported

SetAuthConfig hbacmd SetAuthConfig <WWPN1> <WWPN2> <PasswordType> <Password> <Parameter> <Value>

--- Not supported

SetPassword hbacmd SetPassword <WWPN1> <WWPN2> <Flag> <Cpt> <Cpw> <Npt> <Npw>

--- Not supported

Table 4-9: Boot Command Command Command Syntax Description Remarks

EnableBootCode hbacmd EnableBootCode <WWPN | MAC> <Flag>

--- Not supported

GetBootParams hbacmd GetBootParams <WWPN> <Type> --- Not supported SetBootParam hbacmd SetBootParam <WWPN> <Type>

<Param> <Value1> [BootDev <Value2>] --- Not supported

Table 4-10: DCB Command Command Command Syntax Description Remarks

GetDCBParams hbacmd GetDCBParams <WWPN|MAC> --- Not supported SetDCBParam hbacmd SetDCBParam <WWPN|MAC>

<Param> <Value> --- Not supported

GetPGInfo hbacmd GetPGInfo <WWPN|MAC> --- Not supported SetDCBPriority hbacmd SetDCBPriority <WWPN|MAC>

<PFC Priorities> <Priorities of PGID0> <Priorities of PGID1>...<Priorities of PGID7>

--- Not supported

SetCnaPGBW hbacmd SetCnaPGBW <WWPN|MAC> <BW0 … BW7>

--- Not supported

Table 4-11: Diagnostic Command Command Command Syntax Description Remarks

EchoTest hbacmd EchoTest <WWPN Source> <WWPN Destination> <Count> <StopOnError> <Pattern>

--- Not supported

GetBeacon hbacmd GetBeacon <WWPN|MAC> --- Not supported GetXcvrData hbacmd GetXcvrData <WWPN|MAC> --- Not supported LoadList hbacmd LoadList <WWPN> --- Not supported LoopBackTest hbacmd LoopBackTest <WWPN|MAC>

<Type> <Count> <StopOnError> [Pattern] --- Not supported

LoopMap hbacmd LoopMap <WWPN> --- Not supported PciData hbacmd PciData <WWPN|MAC> <Type> --- Not supported PostTest hbacmd PostTest <WWPN> --- Not supported SetBeacon hbacmd SetBeacon <WWPN | MAC>

<BeaconState> --- Not supported

SetCableNVP hbacmd SetCableNVP <WWPN|MAC> <NVP>

--- Not supported

TDRTest hbacmd TDRTest <WWPN | MAC address> --- Not supported SelfTest hbacmd SelfTest <WWPN | MAC address> --- Not supported Wakeup hbacmd WakeUp <WWPN> --- Not supported

Table 4-12: Driver Parameter Command Command Command Syntax Description Remarks

DriverConfig hbacmd DriverConfig <WWPN> <FileName> <Flag>

--- Not supported

GetDriverParams hbacmd GetDriverParams <WWPN> Shows the name and values of each parameter.

GetDriverParamsGlobal hbacmd GetDriverParamsGlobal <WWPN> Shows the name and the global value of each driver parameter.



Command Command Syntax Description Remarks SaveConfig hbacmd SaveConfig <WWPN> <FileName>

<Flag> --- Not supported

SetDriverParam --- Changes a driver parameter and designates the scope of the change.

Not supported

SetDriverParamDefaults

--- Changes all values to the default for the adapter(s).

Not supported

Table 4-13: Dump Command Command Command Syntax Description Remarks

DeleteDumpFiles hbacmd DeleteDumpFiles <WWPN|MAC> --- Not supported Dump hbacmd Dump <WWPN|MAC> --- Not supported GetDumpDirectory hbacmd h=ipaddress[:port] m=cim

[u=username] [p=password] [n=root/emulex] GetDumpDirectory <WWPN|MAC>

--- Not supported

SetDumpDirectory ESX/ESXI using the CIM interace: hbacmd h=ipaddress[:port] m=cim [u=username] [p=password] [n=root/emulex] setdumpdirectory <DumpDirectoryName> ESX using the RM (remote management) interface: hbacmd h=ipaddress[:port] setdumpdirectory <DumpDirectoryName>

--- Not supported

GetRetentionCount hbacmd GetRetentionCount <WWPN|MAC> --- Not supported SetRetentionCount hbacmd SetRetentionCount <WWPN|MAC>

<Value> --- Not supported

GetDumpFileNames hbacmd GetDumpFileNames <WWPN|MAC>

--- Not supported

GetDumpFile hbacmd [h=ipAddress] GetDumpFile <WWPN|MAC> <filename>

--- Not supported

Table 4-14: FCoE Command Command Command Syntax Description Remarks

GetFIPParams hbacmd GetFIPParams <WWPN> --- Not supported SetFIPParam hbacmd SetFIPParams <WWPN> --- Not supported GetFCFInfo hbacmd GetFCFInfo <WWPN> --- Not supported

Table 4-15: iSCSI Command Command Command Syntax Description Remarks

AddARPTableEntry hbacmd [h=host_IP[:port] | hostname[:port]] AddARPTableEntry <MAC_Address> <Dest_MAC_Address> <Dest_IP_Address>

--- Not supported

AddRouteTableEntry hbacmd [h=host_IP[:port] | hostname[:port]] AddRouteTableEntry <MAC_Address> <Dest_IP_Address> <Subnet_Mask> <Gateway>

--- Not supported

AddTarget hbacmd [h=host_IP[:port] | hostname[:port]] AddTarget <MAC_Address> <Target_IP> <Port> <iscsi_target_name> [ImmediateData=<0|1>] [HeaderDigest=<0|1>] [DataDigest=<0|1>] [Auth=<0|1|2> "TgtCHAPName" "TgtSecret" "InitCHAPName" "InitSecret"]

Adds a target to the list of targets seen by the initiator and logs into the target once it has been successfully created.

AddTargetPortal hbacmd [h=host_IP[:port] | hostname[:port]] AddTargetPortal <MAC_Address> <Target_IP> <Port> [ImmediateData=<0|1>] [HeaderDigest=<0|1>] [DataDigest=<0|1>] [Auth=<0|1|2> "TgtCHAPName" "TgtSecret" "InitCHAPName" "InitSecret"]

--- Not supported



Command Command Syntax Description Remarks CleariSNSServer hbacmd [h=host_IP[:port] | hostname[:port]]

CleariSNSServer <MAC_Address> --- Not supported

DelARPTableEntry hbacmd [h=host_IP[:port] | hostname[:port]] DelARPTableEntry <MAC_Address> <Dest_MAC_Address> <Dest_IP_Address>

--- Not supported

DelRouteTableEntry hbacmd [h=host_IP[:port] | hostname[:port]] DelRouteTableEntry <MAC_Address> <Dest_IP_Address> <Subnet_Mask> <Gateway>

--- Not supported

DiscoveriSNSServer hbacmd [h=host_IP[:port] | hostname[:port]] DiscoveriSNSServer <MAC_Address>

--- Not supported

GetInitiatorProperties hbacmd [h=host_IP[:port] | hostname[:port]] GetInitiatorProperties <MAC_Address>

Shows all the initiator login options for the specified port.

GetiSCSILuns hbacmd [h=host_IP[:port] | hostname[:port]] GetiSCSILuns <MAC_Address> <iscsi_target_name>

Shows all the LUNs and their information for a specified target.

GetiSCSIPortStats hbacmd [h=host_IP[:port] | hostname[:port]] GetiSCSIPortStats <MAC_Address>

Lists all session information for a specified session.

GetNetworkConfiguration

hbacmd GetNetworkConfiguration <MAC address>

Lists a port's TCP/IP information.

GetSessionInfo hbacmd [h=host_IP[:port] | hostname[:port]] GetSessionInfo <MAC_Address> <iscsi_target_name> <TSIH | <ISID_Qual Target_IP>>

Lists all session information for a specified session.

iSCSIPing hbacmd [h=host_IP[:port] | hostname[:port]] iSCSIPing <MAC_Address> <IP_Address>

Issues ICMP echo requests to a target.

Not supported

ListSessions hbacmd [h=host_IP[:port] | hostname[:port]] ListSessions <MAC_Address> <iscsi_target_name>

Lists all the sessions on a specified target.

RemoveTarget hbacmd [h=host_IP[:port] | hostname[:port]] RemoveTarget <MAC_Address> <iscsi_target_name>

--- Not supported

RemoveTargetPortal hbacmd [h=host_IP[:port] | hostname[:port]] RemoveTargetPortal <MAC_Address> <Target_IP> <Port>

--- Not supported

SetInitiatorProperties hbacmd [h=host_IP[:port] | hostname[:port]] SetInitiatorProperties <MAC_Address> [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"]

Sets the initiator properties for the specified port.

SetNetworkConfiguration

hbacmd [h=host_IP[:port] | hostname[:port]] SetNetworkConfiguration <MAC_Address> <VLAN_ENABLED=<0|1> [<VLAN_ID=<0-4096>> <Priority=<0-7>>] <DHCP=<0|1>> [<IP_Address> <Subnet_Mask> [Gateway]]

Sets the TCP/IP configuration on a specified port.

SetTargetLoginProperties

hbacmd [h=host_IP[:port] | hostname[:port]] SetTargetLoginProperties <MAC_Address> <iscsi_target_name> [ImmediateData=<0|1>] [HeaderDigest=<0|1>] [DataDigest=<0|1>] [Auth=<0|1|2> "TgtCHAPName" "TgtSecret" "InitCHAPName" "InitSecret"]

--- Not supported

SetTargetProperties hbacmd [h=host_IP[:port] | hostname[:port]] SetTargetProperties <MAC_Address> <iscsi_target_name> <ETO>

--- Not supported



Command Command Syntax Description Remarks SetTPLoginProperties hbacmd [h=host_IP[:port] | hostname[:port]]

SetTPLoginProperties <MAC_Address> <Target_IP> <Port> [ImmediateData=<0|1>] [HeaderDigest=<0|1>] [DataDigest=<0|1>] [Auth=<0|1|2> TgtCHAPName TgtSecret InitCHAPName InitSecret]

--- Not supported

ShowARPTable hbacmd [h=host_IP[:port] | hostname[:port]] ShowARPTable <MAC_Address>

Shows the current ARP table for the specified port.

ShowiSNSServer hbacmd [h=host_IP[:port] | hostname[:port]] ShowiSNSServer <MAC_Address>

--- Not supported

ShowRouteTable hbacmd [h=host_IP[:port] | hostname[:port]] ShowRouteTable <MAC_Address>

--- Not supported

ShowTarget hbacmd [h=host_IP[:port] | hostname[:port]] ShowTarget <MAC_Address> [<iscsi_target_name> | refreshtargets]

Shows the properties for a specified target.

ShowTargetPortal hbacmd [h=host_IP[:port] | hostname[:port]] ShowTargetPortal <MAC_Address> [<Target_IP> <Port>]

--- Not supported

TargetLogin hbacmd [h=host_IP[:port] | hostname[:port]] TargetLogin <MAC_Address> [<target_Ip> <port>]

Logs in to a target.

TargetLogout hbacmd [h=host_IP[:port] | hostname[:port]] TargetLogout <MAC_Address> <iscsi_target_name> <TSIH | <ISID_Qual Target_IP>

Logs out of a target.

UpdateiSNSServer hbacmd [h=host_IP[:port] | hostname[:port]] UpdateiSNSServer <MAC_Address> <Server_IP> <Port>

--- Not supported

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

GetLunList hbacmd GetLunList <HBA WWPN> <Target WWPN> <Option>

--- Not supported

GetLunUnmaskByHba hbacmd GetLunUnMaskByHBA <HBA WWPN> <Option>

--- Not supported

GetLunUnmaskByTarget

hbacmd GetLunUnMaskByTarget <HBA WWPN> <Target WWPN> <Option>

--- Not supported

RescanLuns hbacmd RescanLuns <HBA WWPN> <Target WWPN>

--- Not supported

SetLunMask hbacmd SetLunMask <HBA WWPN> <Target WWPN> <Option> <Lun> <LunCount> <MaskOp>

--- Not supported

Table 4-17: Miscellaneous Command Command Command Syntax Explanation Remarks

Download hbacmd Download <WWPN|MAC> <FileName>

--- Not supported

ExportSANInfo hbacmd ExportSANInfo [format] --- Not supported GetQoSInfo hbacmd [h=host_IP[:port] | hostname[:port]]

GetQoSInfo <MAC_Address> Shows the QoS information for a specified NIC port.

GetVPD hbacmd GetVPD <WWPN|MAC> Shows the port’s VPD. ListHBAs hbacmd [h=<IPAddress>] listhbas [local]

[m=model] [pt=type] Shows a list of the 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]] GetQoSInfo <MAC_Address>

--- Not supported

Reset hbacmd Reset <WWPN> --- Not supported TargetMapping hbacmd TargetMapping <WWPN> --- Not supported



Command Command Syntax Explanation Remarks SetCimCred hbacmd SetCimCred <username>

<password> <namespace> <portnum> --- Not supported

GetCimCred hbacmd GetCimCred --- Not supported AddHost hbacmd AddHost host_address --- Not supported RemoveHost hbacmd RemoveHost host_address --- Not supported CnaGetEventLog hbacmd CnaGetEventLog <WWPN|MAC> --- Not supported CnaClearEventLog hbacmd CnaClearEventLog <WWPN|MAC> --- Not supported SetPfcThrottle hbacmd SetPfcThrottle <WWPN> <0|1> --- Not supported

Table 4-18: Persistent Binding Command Command Command Syntax Explanation Remarks

AllNodeInfo hbacmd AllNodeInfo <WWPN> --- Not supported BindingCapabilities hbacmd BindingCapabilities <WWPN> --- Not supported BindingSupport hbacmd BindingSupport <WWPN>

<Source> --- Not supported

PersistentBinding hbacmd PersistentBinding <WWPN> <Source>

--- Not supported

RemoveAllPersistentBinding

hbacmd RemoveAllPersistentBinding <WWPN>

--- Not supported

RemovePersistentBinding

hbacmd RemovePersistentBinding <WWPN> <BindType> <ID> <SCSIBus> <SCSITarget>

--- Not supported

SetBindingSupport hbacmd SetBindingSupport <WWPN> <BindFlag>

--- Not supported

SetPersistentBinding hbacmd SetPersistentBinding <WWPN> <Scope> <BindType> <TargetId> <SCSIBus> <SCSITarget>

--- Not supported

Table 4-19: Personality Management Command Command Command Syntax Explanation Remarks

ShowPersonalities hbacmd ShowPersonalities <WWPN|MAC> --- Not supported ChangePersonality hbacmd ChangePersonality <WWPN|MAC>

<personality_type> --- Not supported

Table 4-20: VPort Command Command Command Syntax Explanation Remarks

CreateVPort hbacmd CreateVPort <physical WWPN> auto [vname]

--- Not supported

DeleteVPort hbacmd DeleteVPort <physical WWPN> <virtual WWPN>

--- Not supported

ListVPorts hbacmd ListVPorts <physical WWPN> --- Not supported VPortTargets hbacmd VPortTargets <physical WWPN>

<virtual WWPN> --- Not supported

ListVMs hbacmd ListVMs <physical WWPN> <virtual WWPN>

--- Not supported

Table 4-21: WWN Management Command Command Command Syntax Explanation Remarks

ChangeWWN hbacmd ChangeWWN <WWPN> <New WWPN> <New WWNN> <Type>

--- Not supported

GetWWNCap hbacmd GetWWNCap <WWPN> --- Not supported ReadWWN hbacmd ReadWWN <WWPN> <Type> --- Not supported RestoreWWN hbacmd RestoreWWN <WWPN> <Type> --- Not supported



Configuration Information

(1) HbaAttributes Command

Devices : onboard CNA, CNA expansion card, FC expansion card Syntax : hbacmd hbaattrib <WWPN or MAC>

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



(2) PortAttributes Command

Devices : onboard CNA, CNA/LAN expansion card, FC expansion card Syntax : hbacmd PortAttrib <WWPN or MAC>

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



(3) GetDriverParams Command

Devices : onboard CNA(FCoE), CNA expansion card(FCoE), FC expansion card Syntax : hbacmd GetDriverParams <WWPN>

WWPN : WWPN of the adapter. Examples : hbacmd GetDriverParams 10:00:00:00:c9:dc:4a:48

(4)GetDriverParamsGlobal Command

Devices : onboard CNA(FCoE), CNA expansion card(FCoE), FC expansion card Syntax : hbacmd GetDriverParamsGlobal <WWPN>

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

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



(5)GetInitiatorProperties Command

Devices : onboard CNA(iSCSI), CNA expansion card(iSCSI) Syntax : hbacmd GetInitiatorProperties <MAC>

MAC : The MAC address of the UCNA port Examples : hbacmd GetInitiatorProperties 00-00-c9-db-56-49

(6)GetiSCSILuns Command

Devices : onboard CNA(iSCSI), CNA expansion card(iSCSI) Syntax : hbacmd GetiSCSILuns <MAC> <Target-name>

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

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

LUN 0:

Vendor Name: HITACHI

Model Number: DF600F

Serial Number: 850100980051

LUN Type: 0

Capacity: 10.00 GB

Block Size: 512



(7)GetiSCSIPortStats Command

Devices : onboard CNA(iSCSI), CNA expansion card(iSCSI) Syntax : hbacmd GetiSCSIPortStats <MAC>

MAC : The MAC address of the UCNA port Examples : hbacmd GetiSCSIPortStats 00-00-c9-db-56-4d

(8)GetNetworkConfiguration Command

Devices : onboard CNA(iSCSI), CNA expansion card(iSCSI) Syntax : hbacmd GetNetworkConfiguration <MAC>

MAC : The MAC address of the UCNA port Examples : hbacmd GetNetworkConfiguration 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

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



(9)ListSessions Command

Devices : onboard CNA(iSCSI), CNA expansion card(iSCSI) Syntax : hbacmd ListSessions <MAC> <Target-name>

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



(10)GetSessionInfo Command

Devices : onboard CNA(iSCSI), CNA expansion card(iSCSI) Syntax : hbacmd GetSessionInfo <MAC><Target-name> <TSIH | <ISID_Qual

Target_IP>> 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

Cmd 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: 1448



(11)ShowARPTable Command

Devices : onboard CNA(iSCSI), CNA expansion card(iSCSI) Syntax : hbacmd ShowARPTable <MAC>

MAC : The MAC address of the UCNA port Examples : hbacmd ShowARPTable 00-00-c9-db-56-4d

(12)ShowTarget Command

Devices : onboard CNA(iSCSI), CNA expansion card(iSCSI) Syntax : hbacmd ShowTarget <MAC> [<iscsi_target_name> | 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

MAC ADDRESS IP ADDRESS

----------------- ---------------

00-00-00-00-00-00 127.0.0.1

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



(13)ListHBAs Command

Devices : onboard CNA, CNA/LAN expansion card, FC expansion card Syntax : hbacmd ListHBAs <pt=type>

pt=type : Port type filter (valid types: NIC, iSCSI, FC, FCoE) Examples : hbacmd ListHBAs pt=nic

When the Emulex devices (CNA, LAN or FC) are busy, ListHBAs command may not display the device list or "Log Collect" tool may fail. In that case, try again after waiting about 5 minutes. Still the problem persists, reboot the OS.

(14)GetQoSInfo Command

Devices : onboard CNA, CNA/LAN expansion card Syntax : hbacmd GetQoSInfo <MAC>

MAC : MAC address of the UCNA port. Examples : hbacmd GetQoSInfo 00-00-c9-db-56-50

Manageable HBA List

Permanent MAC : 00-00-c9-db-56-48

Current MAC : 00-00-c9-db-56-48

Flags : 80000710


Mfg : Emulex Corporation

Serial No. : FC20975332

Port Number : 0

Mode : Initiator

PCI Bus Number : 17

PCI Function : 0

Port Type : NIC


Sub-Adapter ID : 01

Permanent MAC : 00-00-c9-db-56-4c

Current MAC : 00-00-c9-db-56-4c

Flags : 80000710




Port Number : 1

Mode : Initiator

PCI Bus Number : 17

PCI Function : 1

Port Type : NIC


Sub-Adapter ID : 01

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

MaxBitsPerSecond: 0



(15)GetVPD Command

Devices : onboard CNA, CNA/LAN expansion card, FC expansion card Syntax : hbacmd GetVPD <WWPN|MAC>

MAC : MAC address of the UCNA port. Examples : hbacmd GetVPD 00-00-c9-db-56-50

(16)ShowPersonalities Command

Devices : onboard CNA, CNA/LAN expansion card Syntax : hbacmd ShowPersonalities <WWPN|MAC>

MAC : MAC address of the UCNA port. Examples : hbacmd CnaGetEventLog 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

Adapter Personalities:

NIC

iSCSI (active & configured)

FCoE : 2



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>

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 followingcommand.

Syntax : hbacmd setdriverparam <WWPN> <Flag1> <Flag2> <Param> <Value>

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).



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.


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)

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.



Example :

2. Set the IP address of the adapter.

Syntax : hbacmd SetNetworkConfiguration <MAC_Address> <VLAN_ENABLED=<0|1> [<VLAN_ID=<0-4096>> <Priority=<0-7>>] <DHCP=<0|1>> [<IP_Address> <Subnet_Mask> [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 :

- "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>

MAC_Address : The MAC address of the UCNA port.

# 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



Port Number : 0

Mode : Initiator

PCI Bus Number : 42

PCI Function : 2

Port Type : iSCSI


Sub-Adapter ID : 01

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

255.255.255.0



Example :

4. Set the iSCSI initiator name.

Syntax : hbacmd SetInitiatorProperties <MAC_Address> [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 :

"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 <MAC_Address>

# 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

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



MAC_Address : MAC address of the CNA port

Example :

6. Set the target

Syntax : hbacmd AddTarget <MAC_Address> <Target_IP> <Port> <iscsi_target_name> [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 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

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



7. Login to the target

Syntax : hbacmd TargetLogin <MAC_Address> <iscsi_target_name> [target_portal_ip <port>] [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 :

8. Confirm the connection to the LU

Syntax : hbacmd GetiSCSILuns <MAC_Address> <iscsi_target_name>

MAC_Address : MAC address of the CNA port



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



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

Example :

(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 :

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

Syntax : hbacmd ListSessions <MAC> <Target-name>

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

length: 11 - 255)

# 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

# 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



Port Number : 0

Mode : Initiator

PCI Bus Number : 42

PCI Function : 2

Port Type : iSCSI


Sub-Adapter ID : 01



Example :

3. Disconnect the target.

Syntax : hbacmd TargetLogout <MAC_Address> <iscsi_target_name> <TSIH | <ISID_Qual Target_IP>>

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 :

4. Confirm that the LU has been disconnected.

Syntax : hbacmd GetiSCSILuns <MAC_Address> <iscsi_target_name>

Example :

This procedure is complete.

A target can be disconnected only per name.

# 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

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

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

5

Supported Operating Systems 5-1


Supported Operating Systems

The Emulex adapters support the following operating systems.


5-2 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.6 (64-bit x86_64)

- Red Hat Enterprise Linux 6.6 (32-bit x86)

- Red Hat Enterprise Linux 6.5 (64-bit x86_64)






- 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)

6

Restrictions 6-1


Restrictions

This chapter describes the restrictions on the OCM and OCM_CLI.

Restrictions on OCM and OCM_CLI

6-2 Restrictions


Restrictions on OCM and OCM_CLI

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

For the system :

Configuring the PXE is not supported.

For network :

"DHCP", "VLAN", "Gateway" functions are not supported.

For iSCSI :

"ImmediateData", "HeaderDigest", "DataDigest", "Authentication" functions are not supported.

O For CNA :

Configuring the personality is not supported.

Else :

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

- When the Emulex devices (CNA, LAN or FC) are busy, ListHBAs command may not display the device list or "Log Collect" tool may fail. In that case, try again after waiting about 5 minutes. Still the problem persists, reboot the OS.

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)"

Glossary Glossary-1


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 (32bit)

Microsoft(R) Windows Server(R) 2008 Standard without Hyper-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-2 Glossary


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 data center bridging 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

MK-99COM105-10

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 [email protected]

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

Asia Pacific +852 3189 [email protected]

http://www.hds.com/




Documents

Hitachi Compute Blade Emulex Adapter User's Guide for Utility