Download Print this page

Hitachi GVX-CC64GxBX series User Manual

Gigabit fibre channel adapter.
Hide thumbs

Advertisement

HITACHI
Gigabit Fibre Channel Adapter
USER'S GUIDE
(Utility Software Edition)
Revision 41.0
Jul 2017
Read this manual well and keep it near the system so
that you can refer to it as needed.
Before starting operation, familiarize yourself with the
safety instructions.
All Rights Reserved, Copyright © 2004-2017, Hitachi, Ltd.

Advertisement

   Related Manuals for Hitachi GVX-CC64GxBX series

   Summary of Contents for Hitachi GVX-CC64GxBX series

  • Page 1

    Revision 41.0 Jul 2017 Read this manual well and keep it near the system so that you can refer to it as needed. Before starting operation, familiarize yourself with the safety instructions. All Rights Reserved, Copyright © 2004-2017, Hitachi, Ltd.

  • Page 2: Important Notes

    Information  The BladeSymphony server name has been changed to Hitachi Compute Blade. If you are using BladeSymphony based server products, substitute references to Hitachi Compute Blade with BladeSymphony.  The Hitachi Virtualization Manager (HVM) name has been changed to Hitachi logical partitioning manager (LPAR manager, or LP).

  • Page 3

    in which case the user will be required to correct the interference at personal expense. The user is cautioned that changes or modifications not expressly approved by the manufacturer could void the user’s right to operate the equipment.  EN55022 Compliance Warning: This is a class A product.

  • Page 4

     Export control To export this product, check the export control-related regulations and follow the necessary procedures. If you have any questions, contact our sales representative. Note that the same handling is required for peripheral equipment and pre-installed software shipped with this product. Notes on Deleting Data when Disposing of or Transferring the System Equipment Personal computers and system equipment are used for various purposes at the office...

  • Page 5: Registered Trademarks And Trademarks

    Registered Trademarks and Trademarks Microsoft, Windows, and Windows Server are registered trademarks or trademarks of Microsoft Corp. in and outside the U.S. Pentium and Xeon are trademarks or registered trademarks of Intel Corporation in and outside the U.S. Linux is a registered trademark or trademark of Linus Torvalds in and outside the U.S. Red Hat is a registered trademark or trademark of Red Hat, Inc.

  • Page 6: Introduction

    Introduction Thank you for purchasing Hitachi Gigabit Fibre Channel Adapter. This manual describes procedures for the use of Hitachi Gigabit Fibre Channel Adapter such as installation, connection, and handling. Notation  Symbols Meanings of symbols used in this manual are as follows:...

  • Page 7: Information On Support And Service

    Information on Support and Service Missing Parts on Delivery The product is checked by local support personnel when it is delivered. In some cases, no checkout work is performed or no local support personnel visit you when the product is delivered. If you find any missing part or if you have any questions on the delivered product in such cases, contact your sales.

  • Page 8: Table Of Contents

    Contents Information ........................ii Important Notes ...................... ii Reliability of the System Equipment ............... ii Regulatory Compliance Notices................ii Notes on Deleting Data when Disposing of or Transferring the System Equipmentiv Registered Trademarks and Trademarks ............... v Introduction ........................vi Notation ........................

  • Page 9

    Restore the HBA BIOS Setup Data ..............61 Update or Delete WWPN in the configuration file ..........62 Display port statistics .................... 64 Display target information ..................66 Reflect driver parameter to the new Adapter when hot-plugging ......67 Persistent Bindings [Linux only] ................70 Display port attributes [Windows only] ..............

  • Page 10

    Convert parameters to new utility program ..............149 Convert parameters to old utility program ..............150 Backup parameters ..................... 150 Restore parameters ....................150 Delete all parameters ....................151 Delete ConnectionType or LinkSpeed parameter ............151 List of the Response Messages of hfcmig ..............152 11 Driver parameters ..............

  • Page 11: Precautions For Safe Use

    Precautions for Safe Use Notes related to safety issues are marked as shown below. This is a safety alert symbol. It calls attention to a potential safety hazard to humans. In order to avoid possible injury or death, follow the message provided after this symbol.

  • Page 12

    WARNING Abnormal heat, smoke, abnormal noise, or abnormal smell Should you find anything abnormal occurred, turn off the power and unplug all the power cords of the equipment (maximum of 5) from the electrical outlets. Using the power cord after such occurrences may lead to electric shock or fire. Do not place any objects around the electrical outlet to allow users to unplug the power cord immediately.

  • Page 13

    WARNING Handling of the power cables Always use the power cables shipped with the equipment, and follow the instructions below: Failure to follow the correct handling practices may lead to damage to the power cables to expose the copper wires, or overheating due to short-circuiting or partial disconnection, which may cause electric shock or fire.

  • Page 14

    WARNING Contact failure and tracking of the power plug Comply with the following instructions for handling of the power plug. Otherwise, tracking or contact failure may cause a fire.  Make sure that the power plug is fully and securely inserted into the electrical outlet.

  • Page 15

    WARNING Not designed to operate in a humid or dusty environment Do not use the equipment near a place where water is used such as sink, in a humid basement, or in a dusty place. Such conditions may lower electric insulation, leading to electric shock or fire.

  • Page 16

    CAUTION Contact with contact pins  Do not touch the contact pins of connectors with your hand or any metal item. Do not any objects such as wire among the pins. Do not place the equipment in a place where there are metal pieces.

  • Page 17

    CAUTION Signal cables  When wiring cables, take care not to trip over the cables. It could cause injury or failure of devices connected to the equipment. It could also cause loss of valuable data.  Do not place heavy items on the cables. Avoid wiring cables close to a thermal appliance.

  • Page 18

    NOTICE Backing up data Always create backup copies of important data on the hard disk to auxiliary storage. If the hard disk fails, all data stored on it will be lost. Not designed to operate outdoors Do not operate the equipment outdoors. It could cause a failure. Disposal of the equipment ...

  • Page 19

    NOTICE Implementing a disk array  You must not change the disk array during system operations. Otherwise, the system would lose all data.  If you select [New Configuration], the hard disk will lose all data. Power operation Follow the prescribed procedure for power operation. Power input or output not according to the prescribed procedure may cause problems to the system equipment.

  • Page 20

    First Aid for Electric Shock First aid is the help you can provide before you can get professional medical help. For serious conditions, it is vitally important to take the victim to a doctor as soon as possible. Have someone call an ambulance at once while you apply first aid. Break the victim’s contact with the source of electricity in the quickest safe way possible.

  • Page 21

    Warning labels Warning labels can be found at the following locations on the system equipment. <Hitachi Compute Blade system equipment>...

  • Page 22: How To Use The Manuals

    How to Use the Manuals This section describes the manuals provided with Hitachi Gigabit Fibre Channel Adapter. Manual Organization HITACHI Gigabit Fibre Channel Adapter USER’S GUIDE has several edition published in parts. The contents of the User’s Guide are shown below.

  • Page 23: Before Use

    (2) hfcutil[Windows], hfcddutil (Red Hat Linux): Set driver paraemters and support SFP hot-swap feature. (3) hfcmcup: back up, restore and update the firmware file into FLASH-ROMon Hitachi Gigabit Fibre Channel board. (4) hfcls [Windows only]:Display driver information (5) hfcmcref: Support online-update feature of the firmware on Gigabit Fibre Channel board.

  • Page 24

    (*1) On VMware ESXi 5.0, you are required to install CIM provider on the host and CIM client on the remote host instead to manage Adapter. You can operate various function executing CIM client on the remote host. For detailed operations and functions, refer to HITACHI Gigabit Fibre Channel Adapter USER’S GUIDE (Utility Software Edition – VMware).

  • Page 25: The Correspondence Relationship Between Hfcmgr, Hfcbios, Hfcutil, Hfcmcup And Hfcls Functionality

    The correspondence relationship between hfcmgr, hfcbios, hfcutil, hfcmcup and hfcls functionality The correspondence relationship between hfcmgr, hfcbios, hfcutil, hfcmcup or hfcls are as follows. Windows Function hfcmgr Old utility command command - Display General Information hfcmgr –g Display or Set the Port hfcmgr –p hfcutil menu mode Information...

  • Page 26

    Linux Function hfcmgr Old utility command command - Display General Information hfcmgr –g Display Port hfcmgr –p hfcddutil -o Information hfcddutil –P hfcddutil –Q hfcddutil –R hfcddutil –S hfcbios -o cfgshow -d <DEVICE> (*1) hfcbios -d <DEVICE> -p PARAMETER (*1) Display Boot hfcmgr –b...

  • Page 27: Updating Ramdisk Image [linux Only]

    # cd /boot/efi/efi/redhat(for IA-64) # /sbin/mkinitrd –f <image-file-name>.img <kernel version> ● Notes on using Hitachi Dynamic Link Manager Software (HDLM) Update the RAMDISK image file for HDLM in the SAN boot environment using HDLM. Refer to the HDLM User's Guide when using the SAN boot environment using HDLM.

  • Page 28: Precautions When Updating Windows Driver From The Version X.y.z.470 Or Lower To X.y.z.530 Or Higher [windows Only]

    Precautions when updating Windows driver from the version X.Y.Z.470 or lower to X.Y.Z.530 or higher [Windows only] Windows driver version lower than or equal to x.y.z.470 (Corresponding HFCTools version is 1.0.1.19) and driver version higher than or equal to x.y.z.530 (Corresponding HFCTools version is 1.0.2.22) use different utility program to set parameters.

  • Page 29

    Figure Procedure for converting parameters Updated Driver from the old version to the new version Set HBA parameter by using hfcmputil Yes or unknown Execute We recommend that you backup the current parameters ‘hfcmig –backup’ before converting using 'hfcmig -new' Execute ‘hfcmig –new’...

  • Page 30: Precautions When Downgrading Windows Driver From The Version X.y.z.530 Or Higher To The Version X.y.z.470 Or Lower [windows Only]

    Precautions when downgrading Windows driver from the version X.Y.Z.530 or higher to the version X.Y.Z.470 or lower [Windows only] You need to convert parameters when you downgrade driver version higher than or equal to x.y.z.530 to the driver version lower than or equal to x.y.z.470. You also need to execute ‘hfcmig.exe –old’...

  • Page 31: Install Utility Software

    Install Utility software This section describes how to install utility software of Hitachi Gigabit Fibre Channel Adapter. Install Utility software on Windows Install utility software For information on how to install utility software, refer to "HITACHI Gigabit Fibre Channel Adapter USER’S GUIDE". The utility software version 1.xx.xx.xx is installed by default in the “\Program Files\Hitachi\drivers\hba\HFCTools”...

  • Page 32: Confirm Installed Utility Software Version

    Confirm installed utility software version You can confirm the utility software version accorging to the following procedures. (2) LOGON to the system by administrator privilege. (3) Click “Start” and "Control Panel”. Select “The Add or Remove Programs window” and select the “Add or Remove Programs” tab. A following window is displayed. Confirm logical device name You can confirm the logical device name to execute Display port attributes [Windows only] command...

  • Page 33: Install Utility Software On Linux

    The location which utility software is stored. Matching OS Utility software Red Hat Enterprise Linux5 or higher /opt/hitachi/drivers/hba/hfcmgr SUSE Linux Enterprise Server 10 Service Pack 1 or higher Confirm installed utility software version (1) LOGON to the system by root privilege.

  • Page 34: Confirm Logical Device Name

    # more /proc/scsi/hfcldd/1 Hitachi PCI to Fibre Channel Host Bus Adapter Driver version 4.1.13.836 Firmware version 200789 Package_ID = 0x82 Driver version (utility software version) Special file name = hfcldd1 Logical device name Major_number = 254 Minor_number Instance_number Host# = 1, Unique id...

  • Page 35: Hfcmgr

    hfcmgr List of Commands The user interface for this utility, hfcmgr, is CLI. The root privilege of the system is required for executing hfcmgr. Table List of commands Supported Supported OS and supported version of utility software (*2) Function command Display General Information hfcmgr -g Y (1.0)

  • Page 36

    Persistent Bindings [Linux hfcmgr -pb Y (1.0) Y (1.11) only] Display port attributes hfcmgr -ls Y (1.11) [Windows only] Isolate or Recover adapter Y (1.11) hfcmgr -sfp Y (5.1.1) port. Online update of the firmware hfcmgr -u (*5) Y(2.1) Y(2.1) Target Scan hfcmgr -scan Y (6.9)

  • Page 37

    hfcmgr version: <Linux> higher than or equal to 6.9 and lower than or equal to 7.9 <Windows> higher than or equal to 2.16 and lower than or equal to 7.9 LPAR manager dedicated FC LPAR manager shared FC display display No.

  • Page 38

    (*5) If the driver, firmware or LPAR manager should be updated for using the commands in the guest of LPAR manager, refer to HITACHI Gigabit Fibre Channel Adapter USER’S GUIDE (Support Matrix Edition) for the supported combinations of the versions.

  • Page 39: List Of Functions

    {A|B}: You can select the option A or B. <options>.. : You can select multiple <option>. [Example]: When the command is supported on both Linux and Windows, the example is shown as Linux operation. In this case, the command is specified using the relative path on the/opt/hitachi/drivers/hba directory.

  • Page 40: Display General Information

    Display General Information  hfcmgr higher than or equal to version 8.0 [Function] Display the server information and adapter information [Syntax] <Display> hfcmgr -g [Example] Figure Sample of hfcmgr –g display (Windows/Linux) # ./hfcmgr -g Time:xxxx/xx/xx xx:xx:xx ---------------------------------------------------------------- Host Name : xxxxxxxx OS Type : Red Hat Enterprise Linux Server release 6.4 (Santiago)

  • Page 41

    When Virtual Fibre Channel is used, the messages of the chart below will be displayed. # ./hfcmgr -g Time:xxxx/xx/xx xx:xx:xx ---------------------------------------------------------------- Host Name : xxxxxxxx OS Type : Red Hat Enterprise Linux Server release 6.4 (Santiago) OS Version : 2.6.32-358.11.1.el6.x86_64 Driver Version : 4.6.18.2479 hfcmgr Version : 8.1 ----------------------------------------------------------------...

  • Page 42

    Cannot use the Virtual Fibre Channel Port WaitLinkUp Wait Linkup status *1) If the embedded FC switch module is used in Hitachi Compute Blade 320 or Hitachi Compute Blade 2000, the model name may be displayed as ‘Unknown Model’. hfcmgr <Windows>...

  • Page 43

     hfcmgr lower than version 8.0 [Function] Display the server information and adapter information [Syntax] <Display> hfcmgr -g [Example] Figure Sample of hfcmgr –g display (Windows/Linux) # ./hfcmgr –g Time:xxxx/xx/xx xx:xx:xx ---------------------------------------------------------------- Host Name : xxxxxxxx OS Type : Red Hat Enterprise Linux Server release 5 (Tikanga) OS Version : 2.6.18-8.el5 Driver Version : 4.5.10.470...

  • Page 44

    Isolate(SFPDown) SFP is not plugged. Isolate(CHK-STP) Adapter is check-stopped *1) If the embedded FC switch module is used in Hitachi Compute Blade 320 or Hitachi Compute Blade 2000, the model name may be displayed as ‘Unknown Model’. hfcmgr <Windows> version higher than or equal to 2.19, The OS Type and OS Version are...

  • Page 45: Display Or Set The Port Information

    Display or Set the Port Information  hfcmgr higher than or equal to version 8.0 This section refers to the hfcmgr version higher than or equal to 8.0. For hfcmgr version lower than 8.0, please refer to p39. hfcmgr version can be checked by executing a command, “hfcmgr -g”. For details, refer to “Display General Information”.

  • Page 46

    ■ Configurable Adapter There are some parameters that can only be configurable on a specified Adapter. The parameter configurable only on 16Gbps FC-HBA have a character “Y” on the “[16Gbps]” column. The parameter configurable only on 8Gpbs or lesser FC-HBAs have a character “Y”...

  • Page 47

    Option List Table Option Configura Indicated ble values item name (unit) auto Connection auto ptop Type loop [4Gbps] Link Speed auto auto (Gbps) [8Gbps] auto (Gbps) [16Gbps] auto (Gbps) Transfer Size (MB) 0-60 Login Delay [Lesser (sec) Time than 8Gbps] [16Gbps]...

  • Page 48

    Option Configura Indicated ble values item name (unit) 0-60 Link Down (sec) Time 0-60 Reset Delay [Lesser (sec) Time than 8Gbps] [16Gbps] 0x01 Preferred 0x01 0x02 AL-PA 0x04 0x08 0x0f 0x10 0x17 0x18 0x1b 0x1d 0x1e 0x1f 0-60 Reset (sec) Timeout 0-60 Abort...

  • Page 49

    Option Configura Indicated ble values item name (unit) 16-255 Scatter/Gat her List disable MSCS disable enable Mode Interrupt <Window Type s>msix msix <Linux> [Lesser than 8Gbps] [16Gbps] msix Logging disable Mode verbose Login Target Filter perf disable Performanc disable enable e Option npiv disable...

  • Page 50

    Option Configura Indicated ble values item name (unit) multi Link Reset multi single Mode 1-255 Init (sec) Negotiation Time 1-30 NPIV vport count disable Target disable enable Restrain mpid disable Multiple disable enable PortID minq Core Control iosize minq minq iosize cpun cc-size 1-32768...

  • Page 51

    Option Configura Indicated ble values item name (unit) 0-1024 Concurrent (If this Channels paramete r is set to 0, then the driver recognize s logical number as this paramete mque disable Multi queue disable enable...

  • Page 52

    (*1) For this option, prease refer to the Notice in the section “List of Commands”. (*2) This option is not supported in RHEL6 or later. (*3) This option does not allow to assign logical device name. Perf Option is only changeable in Windows 2008 or Windows 2008 R2. In Windows 2003, the value of perf option is “disable”, and cannot be set to “enable”.

  • Page 53

    The parameters with a character “N” in the “Reboot required” column If the parameters with symbol “N” in the “Reboot required” column are changed, a message below is displayed and the new parameter becomes effective in Hitachi Fibre Channel Adapter driver without reboot.

  • Page 54

    Exchange per Core : off (-) Interrupt Coalescing : 0 usec (-) Additional Performance Monitor: off (-) # /opt/hitachi/drivers/hba/hfcmgr –p 1: WWPN:50000870003021e0 Device:hfcldd0 [LinkUp] 2: WWPN:50000870003021e2 Device:hfcldd1 [LinkUp] If any port is not passed as a command-line parameter, enter the number of the port here to display Enter number >...

  • Page 55

    (Step 2) Set QueueDepth of hfcldd0 to 20. Figure Procedure to set a QueueDepth value to the specified port # ./hfcmgr -p hfcldd0 qd 20 Time:xxxx/xx/xx xx:xx:xx Succeeded. Update the RAMDISK image for the changes to take effect permanently. Reboot your system for the changes to take effect. # ./hfcmgr -p hfcldd0 This result indicates that the QueueDepth parameter is set to 20 but the driver is...

  • Page 56

    (Step 5) Check if the configured values become effective. Confirm hfcldd0 works with the specified value at (Step 2), and hfcldd1 works with the common value specified at (Step 3). Figure Procedure to check the QueueDepth values of hfcldd0, hfcldd1 # ./hfcmgr -p hfcldd0 Time: xxxx/xx/xx xx:xx:xx --------------------------------------------------------...

  • Page 57

    Then, remove the specified QueueDepth value for hfcldd0, and check if all ports including hfcldd0 work with commonly specified QueueDepth value, 10. (Step 6) Remove the specified QueueDepth value of hfcldd0. Figure Procedure to remove a specified value of a port. # ./hfcmgr -p delete hfcldd0 qd Do you execute it? (y/n) >...

  • Page 58

    : 1024 KB (-) Exchange per Core : off (-) Interrupt Coalescing : 0 usec (-) Additional Performance Monitor: off (-) # /opt/hitachi/drivers/hba/hfcmgr –p 1: WWPN:50000870003021e0 Device:hfcldd0 [LinkUp] 2: WWPN:50000870003021e2 Device:hfcldd1 [LinkUp] port passed command-line parameter, enter the Enter number > 1 number of the port here to display the port information.

  • Page 59

    (Step 2) Set MCK Link Down Time of hfcldd0 to 20. The new value for MCK Link Down Time becomes effective immediately. Figure Procedure to set a MCK Link Down Time value to the specified port # ./hfcmgr -p hfcldd0 ldm 20 Time:xxxx/xx/xx xx:xx:xx The specified parameter becomes effective...

  • Page 60

     hfcmgr lower than version 8.0 This section refers to the hfcmgr version lower than 8.0. For hfcmgr version higher than or equal to 8.0, please refer to p19.. hfcmgr version can be checked by executing a command, “hfcmgr -g”. For details, refer to “Display General Information”.

  • Page 61

    ■ Configurable Adapter There are some parameters that can only be configurable on a specified Adapter. The parameter configurable only on 16Gbps FC-HBA have a character “Y” on the “[16Gbps]” column. The parameter configurable only on 8Gpbs or lesser FC-HBAs have a character “Y”...

  • Page 62

    Option List Table Option Configura Indicated ble values item name (unit) auto Connection auto ptop Type loop [4Gbps] Link Speed auto auto (Gbps) [8Gbps] auto (Gbps) Transfer Size (MB) 0-60 Login Delay (sec) Time 0-60 Link Down (sec) Time 0-60 Reset Delay (sec) Time...

  • Page 63

    Option Configura Indicated ble values item name (unit) 0x01 Preferred 0x01 0x02 AL-PA 0x04 0x08 0x0f 0x10 0x17 0x18 0x1b 0x1d 0x1e 0x1f 0-60 Reset (sec) Timeout 0-60 Abort (sec) Timeout disable Abort disable enable Restrain 1-254 Queue Depth 1-256 0-10 Machine (times)

  • Page 64

    Option Configura Indicated ble values item name (unit) Login Target Filter perf disable Performanc disable enable e Option npiv disable NPIV disable enable (*1) For this option, prease refer to the Notice in the section “List of Commands”. (*2) This option is not supported in RHEL6 or later. (*3) This option does not allow to assign logical device name.

  • Page 65

    [Example] The procedure to set separately QueueDepth of hfcldd0 to 20 while setting the other adapters across all the ports to 10 is shown below on Linux: (Step 1) Refer to the set value of hfcldd0. Each item name: The current driver operation value (value set to hfcldd.conf/FLASH- ROM) is indicated.

  • Page 66

    (Step 2) Set QueueDepth of hfcldd0 to 20. Figure Sample of separate setting of hfcmgr –p port # ./hfcmgr -p hfcldd0 qd 20 Time:xxxx/xx/xx xx:xx:xx Succeeded. You need reboot system after remake a ramdisk image to reflect parameter changes to the system. # ./hfcmgr -p hfcldd0 20 is set but driver is still operating on 32.

  • Page 67

    (Step 5) Make sure that the set information is translated. hfcldd0 operates by the separate setting of the port in (Step 2) and hfcldd1 operates by the common setting across all the adapter ports in (Step 3.) Figure Check after setting hfcmgr –p # ./hfcmgr -p hfcldd0 Time: xxxx/xx/xx xx:xx:xx --------------------------------------------------------...

  • Page 68: Display Or Set The Boot Information

    (hfcmgr version RHEL6: lower than 8.12, RHEL7: lower than 9.11, Windows: lower than 8.13) Figure Sample of hfcmgr –b setting or display # ./hfcmgr -b hfcldd1 bi enable Time:xxxx/xx/xx xx:xx:xx Succeeded. You need reboot system to reflect setting changes to the system. # /opt/hitachi/drivers/hba/hfcmgr -b hfcldd1 Time:xxxx/xx/xx xx:xx:xx -------------------------------------------------------- WWPN:50000870003021e0 Device:hfcldd1 [LinkUp] --------------------------------------------------------...

  • Page 69

    [Example2] Set Luid scan mode of hfcldd0 to "enable" to check as shown below: (hfcmgr version RHEL6: higher than or equal to 8.12, RHEL7: higher than or equal to 9.11, Windows: higher than or equal to 8.13) # ./hfcmgr -b hfcldd0 ls enable Time:xxxx/xx/xx xx:xx:xx Succeeded.

  • Page 70

    (*2) If the N+M Cold Standby function is enabled, the function will be effective after next reboot. When the function is effective, WWPN and Pre-configure variable of the HBA will be under the control of the Hitachi Compute Blade system.

  • Page 71

    (1) You need to reboot the system to activate the changes after the set command is successfully executed. (2) This “hfcmgr -b” command cannot be used if operating on the LPAR manager of Hitachi Server Virtualization Mechanism". (3) FLASH-ROM data is updated when you set parameters. While the command is being executed, do not close the operation Window, terminate the command forcibly, or perform operations such as turning off the power of the server unit or rebooting.

  • Page 72: Back Up Or Update Flash-rom

    On-line means that the executing the special commands transfer the FLASH-ROM data to the hardware without turning the power off and on. Refer to ‘HITACHI Gigabit Fibre Channel Adapter USER’S GUIDE (Windows Driver Edition)’ or ‘HITACHI Gigabit Fibre Channel Adapter USER’S...

  • Page 73

    The following example is to update FLASH-ROM to all logical devices. (1) Back up the FLASH-ROM. # ./hfcmgr -f all backup . force Time:XXXX/XX/XX XX:XX:XX hfcmcup Ver. 1.4.0.9 Copyright(C) 2003,2004,2005. Hitachi, Ltd. >>>>>>>>>>>>>>> hfcldd0 --- The current microcode level for 220742(hfcldd0) --- Flash ROM Read-1 --- Flash ROM Read-2 file /root/54100A30.220742.EF.500008700030F1B6.BK is exist...

  • Page 74

    (2) Update the FLASH-ROM. # ./hfcmgr -f all update /root/54100A30.220742.EF.500008700030F17A.BK Time:XXXX/XX/XX XX:XX:XX hfcmcup Ver. 1.4.0.9 Copyright(C) 2003,2004,2005. Hitachi, Ltd. >>>>>>>>>>>>>>> hfcldd0 hfcldd0 HITACHI FC Adapter *** NOTICE *** NOTICE *** NOTICE *** The microcode installation occurs while the adapter and any attached drives are available for use.

  • Page 75

    In such a case, wait a while and re-execute the command. # ./hfcmgr -f all update <Backup File> Time:20xx/11/27 19:16:47 hfcmcup Ver. 2.4.0.20 Copyright(C) 2003, 201x, Hitachi, Ltd. >>>>>>>>>>>>>>> hfcldd0 hfcldd0 HITACHI FC Adapter *** NOTICE *** NOTICE *** NOTICE ***...

  • Page 76

    If you execute the update using ‘all’ option, the execution continues for the next port when the update process failed for the current adapter port. You can specify only one update file. Hitachi Gigabit Fibre Channel Adapter has its own binary file for FLASH-ROM depending on its device ID. If there are multiple types of Hitachi Gigabit Fibre Channel Adapter exist on the same system and execute the update command specifying ‘all’...

  • Page 77: Display Current Component [linux Only]

    Display Current Component [Linux only] [Function] Display the configuration that the driver is currently recognizing and operating on. [Syntax] <Display> hfcmgr –c [Example] Figure Sample of hfcmgr –c display # ./hfcmgr -c Time:xxxx/xx/xx xx:xx:xx -------------------------------------------------------- WWPN:5000087000300130 Device:hfcldd0 [LinkUp] -------------------------------------------------------- TargetID : 000 TargetWWPN : 50060e8000427810 TargetWWNN : 50060e8000427810...

  • Page 78

    [Details of display] Table Details of hfcmgr –c display Item of display Description Adapter information WWPN Adapter WWPN Device Logical device name Target information TargetID Target ID (0-255) TargetWWPN Target WWPN TargetWWNN Target WWNN [Notes] (1) This command displays the configuration that the driver is currently recognizing and operating on.

  • Page 79: Search The System Mounted Devices

    Logical device name DeviceID Device ID BUS/DEV/FUNC PCI BUS/DEV/FUNC number WWPN Adapter WWPN Original WWPN WWPN indicated on the adapter body (the white label) [Notes] (1) This command cannot be used if operating on the LPAR manager of Hitachi Server Virtualization Mechanism".

  • Page 80: Back Up The Hba Bios Setup Data

    Back up the HBA BIOS Setup Data [Function] Current setup data for HBA BIOS is displayed. Confirm if all data is correct then take backup. [Syntax] hfcmgr –bk { <logical-device-name>| all } <save-directory> [force] # Perform on each adapter port force # Omit the (y/n) confirmation message to execute the command [Example]...

  • Page 81

    ・Windows: higher than or equal to 8.13 [Notes] (1) This command cannot be used if operating on the LPAR manager of Hitachi Server Virtualization Mechanism". (2) You may not able to obtain correct data if executed on the adapter not running correctly.

  • Page 82: Restore The Hba Bios Setup Data

    (1) In order to translate into the driver after the set command is successfully executed, the system must be rebooted. (2) This command cannot be used if operating on the LPAR manager of Hitachi Server Virtualization Mechanism. (3) FLASH-ROM data is updated when you set parameters. While the command is being executed, do not close the operation Window, terminate the command forcibly, or perform operations such as turning off the power of the server unit or rebooting.

  • Page 83: Update Or Delete Wwpn In The Configuration File

    Update or Delete WWPN in the configuration file [Function] The information set by the unit of the adapter port using the port information (hfcmgr –p) command, etc. is saved with its corresponding WWPN to the configuration file, which is /etc/hfcldd.conf file in Linux and to the Registry in Windows. This command can update WWPN contained in the configuration file.

  • Page 84

    [Notes] (1) If the Additional WWPN is used with Pre-configure function of Hitachi Compute Blade, you do not need to update the WWPN by using this command. [Linux] You need to update the RAMDISK image and reboot the system in order to enable the new settings after the set or delete commands have been successfully executed.

  • Page 85: Display Port Statistics

    (1) Monitoring data from 1 to 6 is the total amount of monitoring data over shared guests if operating on the LPAR manager of Hitachi Server Virtualization Mechanism. (2) Monitoring data from 1 to 5 is displayed with ‘---‘, when the adapter port is isolated.

  • Page 86

    Figure Sample of executing hfcmgr -s [driver version X.Y.Z.670 or higher] # ./hfcmgr -s hfcldd1 count 11 interval 2 Time:2009/12/19 13:10:24 ------------------------------------------------------------ WWPN:23100000870cc09c Device:scsi0 [LinkUp] ------------------------------------------------------------ TxFrames : 00000000000000199107 TxWords : 00000000000078821776 RxFrames : 00000000000000333613 RxWords : 00000000000135497613 LIPCount : 00000000000000000000 NOSCount : 00000000000000000000 ErrorFrame : 00000000000000000000...

  • Page 87: Display Target Information

    -------------------------------------------------------- WWPN:50000870003022dc Device:hfcldd0 [LinkDown] -------------------------------------------------------- No Target -------------------------------------------------------- WWPN:50000870003022de Device:hfcldd1 [LinkUp] -------------------------------------------------------- TargetWWPN:50060e8000c3f386 TargetWWNN:50060e8000c3f386 LUN:0 Size: 4297MB Vendor:HITACHI Model:DF600F LUN:1 Size: 4297MB Vendor:HITACHI Model:DF600F LUN:2 Size: 4297MB Vendor:HITACHI Model:DF600F [Details of display] Table Details of hfcmgr –t display Item of display...

  • Page 88: Reflect Driver Parameter To The New Adapter When Hot-plugging

    [Function] This command reflects the parameter settings explained at “Display or Set the Port Information” from the old hot-removed Adapter to the new hot-added Adapter. For details on hot-remove or hot-add Adapter, refer to the section “” in “HITACHI Gigabit Fibre Channel Adapter USER’S GUIDE (Linux/VMware Driver Edition)”.

  • Page 89

     hfcmgr lower than version 8.0 [Function] You can change parameter settings immediately while system is running. Meanwhile this function allows you to change parameters settings temporary. When you change parameter settings permanently, you need to update the RAMDISK image after changing parameters. For details to update the RAMDISK image, refer to section ‘Notes on Updating the RAMDISK Image’.

  • Page 90

    (Step 3) Confirm whether new parameter setting is applied. Figure Sample of executing hfcmgr -p # ./hfcmgr -p hfcldd0 Link Down Time : 10 (10) Machine Check : 1 (-) This command cannot change the following parameters dynamically. Table Parameters which is not applied dynamically Section Parameters which is not applied dynamically Display or Set...

  • Page 91: Persistent Bindings [linux Only]

    Persistent Bindings [Linux only] [Function]You can fix the configuration information using the configuration information persistent binding function (persistent bindings (*1)). You can have the configuration recognized on the system created automatically as the persistent binding information to register it in /etc/hfcldd.conf.

  • Page 92

    Succeeded. You need reboot system after remake a ramdisk image to reflect parameter changes to the system. # /opt/hitachi/drivers/hba/hfcmgr -pb automap on Time:xxxx/xx/xx xx:xx:xx Succeeded. You need reboot system after remake a ramdisk image to reflect parameter changes to the system.

  • Page 93

    [Detailed description] Table Detailed description of hfcmgr –pb Item of display Description Automap on/off Need to turn off to use the persistent binding function. Adapter information WWPN Adapter WWPN Device Logical device name Targeted information TargetID Target ID (0-255) TargetWWPN Target WWPN TargetWWNN Target WWNN...

  • Page 94: Display Port Attributes [windows Only]

    Link speed between adapter and its connected device. When connection is in LinkDown state, `-‘ is displayed *1) If you use embedded FC-switch in Hitachi Compute Blade 320 and Hitachi Compute Blade 2000, ‘Unknown model’ may be displayed with Model name filed.

  • Page 95: Isolate Or Recover Adapter Port

    Refer to Hitachi Compute Blade system user’s guide’ for how to replace SFP. Some models of Hitachi Gigabit Fibre Channel Adapter products may not support SFP hot-swap feature. Refer to ‘HITACHI Gigabit Fibre Channel USER’S GUIDE (Support Matrix Edition) for detail.

  • Page 96

    [Detailed description] Table Detailed description of hfcmgr –sfp Item of display Description Device Logical device name WWPN World Wide Port Name Status Port Status LinkUp: Normal state LinkDown: FC cable is not plugged. WaitLinkUp: Waiting to Linkup after Linkdown is detected. Isolate(C ): Isolated by executing command.

  • Page 97

    [Example 2] Before you replace SFP transceiver, execute isolate command. If command succeed, port status will change to Isolate(C ) and Transceiver replacement to replaceable. This means you can hot-replace SFP transceiver. Figure Sample of executing hfcmgr –sfp command (Isolate) #./hfcmgr -sfp hfcldd1 Do you execute it? (y/n) >...

  • Page 98: Online Update Of The Firmware

    Online update of the firmware [Function] Transfer the FLASH-ROM data into the hardware while system is running. For detailed procedure, refer to ‘HITACHI Gigabit Fibre Channel Adapter USER’S GUIDE (Windows Driver Edition)’ or ‘HITACHI Gigabit Fibre Channel Adapter USER’S GUIDE (Linux/VMware Driver Edition)’.

  • Page 99

    Meaning Applicable Firmware online update is applicable. No need Hitachi Gigabit Fibre Channel Adapter hardware has already updated by this version of the update file. You do not need to execute online update. Waiting Firmware update operation is running now. You are now waiting to complete the operation.

  • Page 100: Target Scan

    Target Scan [Function] If you execute on this command in the system configuration which FC-SAN disk is connected through FC-Switch, the driver initiates to scan process of the target then it can detect new target. When Windows has already identified the target and only LUs are added or removed, the driver does not detect added or removed LUs when executing this command.

  • Page 101: Performance Monitor

    Performance Monitor This function is available in hfcmgr version higher than or equal to 8.0, in Windows/Linux environments. hfcmgr version can be checked by executing a command, “hfcmgr -g". For details, refer to “Display General Information”. [Function] This command shows statistical information collected by devices or drivers. Statistical information includes data such as total count of I/Os after OS boot, I/O size distribution, processing times to send/receive I/Os.

  • Page 102

    [Example 1] Display I/O total counts, without specifying core. # ./hfcmgr -pm hfcldd0 count Time:2013/10/19 00:25:33 ------------------------------------------------------------ WWPN:50000870005b4092 Device:hfcldd0 [LinkUp] ------------------------------------------------------------ Entry WRCnt RDCnt WR-Data RD-Data 743796 Cmnd/Int Cmnd/IntAvg 1.00 BusyResp HBABusy TXQBusy SGLBusy DMABusy IOEr loSyn loSig LinkEr CRCEr...

  • Page 103

    [Example 2] Display I/O total counts, with specifying core. # ./hfcmgr -pm hfcldd0 count core Time:2013/10/19 00:27:15 ------------------------------------------------------------ WWPN:50000870005b4092 Device:hfcldd0 [LinkUp] ------------------------------------------------------------ Entry core1 core3 WRCnt RDCnt WR-Data RD-Data 374000 369796 Cmnd/Int Cmnd/IntAvg 1.00 1.00 BusyResp HBABusy TXQBusy SGLBusy DMABusy IOEr loSyn loSig...

  • Page 104

    [Detailed information about each entries in I/O Total Counts Display] Display entry Description Device Logical Device Name WWPN World Wide Port Name Status Indicates the status of the port. Port status is shown below. LinkUp : Normal condition. LinkDown : FC cable is not plugged. WaitLinkUp : Waiting to Linkup after Linkdown is detected.

  • Page 105

    [Example 3] Display I/O Size Distribution, without specifying core. # ./hfcmgr -pm hfcldd0 io Time:2013/10/19 00:28:34 ------------------------------------------------------------ WWPN:50000870005b4092 Device:hfcldd0 [LinkUp] ------------------------------------------------------------ Entry RD-512B RD-2KB RD-4KB RD-16KB 526928 RD-32KB 12537 RD-Over 18115 WR-512B WR-2KB WR-4KB WR-16KB 519934 WR-32KB 361371 WR-Over 9847 [Example 4] Display I/O Size distribution, with specifying core.

  • Page 106

    [Detailed information about each entries in I/O Distribution Display] Display entry Description Device Logical Device Name WWPN World Wide Port Name Status Indicates the status of the port. Port status is shown below. LinkUp : Normal condition. LinkDown : FC cable is not plugged. WaitLinkUp : Waiting to Linkup after Linkdown is detected.

  • Page 107

    [Example 5] Display I/O Processing Time, without specifying core. # ./hfcmgr -pm hfcldd0 latency Time:2013/10/19 00:30:24 ------------------------------------------------------------ WWPN:50000870005b4092 Device:hfcldd0 [LinkUp] ------------------------------------------------------------ Entry TXMax[usec] 7.99 TXMin[usec] 0.49 TXAvg[usec] 1.34 TXCnt 4096 RSPMax[usec] 311745.62 RSPMin[usec] 93.55 RSPAvg[usec] 7225.31 RSPCnt RXMax[usec] 8.20 RXMin[usec] 0.65 RXAvg[usec] 2.16...

  • Page 108

    [Example 6] Display I/O Processing Time, with specifying core. # ./hfcmgr -pm hfcldd0 latency core Time:2013/11/21 05:00:05 ------------------------------------------------------------ WWPN:50000870005b4092 Device:hfcldd0 [LinkUp] ------------------------------------------------------------ Entry core0 core2 TXMax[usec] 7.76 7.36 TXMin[usec] 1.37 1.19 TXAvg[usec] 2.76 2.57 TXCnt RSPMax[usec] 384588.03 619871.17 RSPMin[usec] 69.00 62.86 RSPAvg[usec] 17219.94 23873.09...

  • Page 109

    To calculate I/O Processing Time, this command collects recentry executed I/O commands up to 8192 commands, except for IOPS entry that may be count more than 8192 commands. The number of I/Os to count in this command may vary on the environment. [Detailed information about each entries in I/O Processing Time] Display entry Description...

  • Page 110: Virtual Fibre Channel Activation

    “Virtual fibre channel feature in Windows Server 2012 and 2012 R2 with Hyper-V roll installed” in “HITACHI Gigabit Fibre Channel Adapter USER’S GUIDE (Windows Driver Edition)” or the section “RHEL6 and RHEL7KVM Virtual Fibre Channel” in “HITACHI Gigabit Fibre Channel Adapter USER’S GUIDE (Linux/VMware Driver Edition)”.

  • Page 111: Display Version Information Of The Utility Software

    Display version information of the utility software [Function] Display version information [Syntax] hfcmgr –v [Examples] #./hfcmgr -v -------------------------------------------------------------- Hitachi HBA Utility Version 03-00 hfcmgr Version 2.2 (cli:1.1.2.2.2.5.4.2 api:1.1.2.2.2.5.4.1 cmn:1.1.2.2.2.6.4.3) Copyright (c) 2007,2009, Hitachi Ltd. --------------------------------------------------------------...

  • Page 112: Display Help Information

    Display help information [Function] Display help information [Syntax] hfcmgr –h [Examples] #./hfcmgr -h -------------------------------------------------- Please select number you want to refer help. -------------------------------------------------- 1 : General Information 2 : Port Information 3 : Boot Information 4 : Firm Backup/Update Execution 5 : Bios Backup 6 : Bios Restore 7 : Show Device List...

  • Page 113: Hfcmgr Response Messages

    If they are used in unsupported combination, hfcmgr command does not work properly and appropriate message may not be displayed. Refer to ‘Windows driver and its utility software version’ table in HITACHI Gigabit Fibre Channel Adapter USER’S GUIDE (Support Matrix Edition) for supported combinations.

  • Page 114

    【Windows】11 No such file. No assigned file existing 【Linux】12 Check if the file exists. 【Windows】12 Not support, LPAR mode is Not supported on the LPAR manager (shared 【Linux】13 shared. 【Windows】13 Not support, LPAR mode. Not supported on the LPAR manager 【Linux】14 Unused Not support, E-Option is disable.

  • Page 115

    Unused Unused Unused 33, 39 Unused HFCAPI system error. An API system error occurred. HFCAPI argument error. An API parameter error occurred. HFCAPI invalid WWPN. An API illegal WWPN error occurred. HFCAPI lock timeout. An API lock timeout occurred. Re-execute after a while. HFCAPI invalid HBA.

  • Page 116

    32, 71 Unused 34, 72 Unused 【Windows】36 The Non NPIV FC port of direct If virtual fibre channel ports on Windows link to target should set up FC- Server 2012 or later Hyper-V environment are 【Linux】40 AL, not Auto negotiation. directly connected to a disk device, the connection type of the adapter port should be set to “FC-AL”, not “Auto”.

  • Page 117: Hfcutil

    hfcutil hfcutil (Windows) Command Tree Structure of hfcutil Various parameters for the Adapter can be set by the hfcutil command. The following figure shows the command tree structure of hfcutil. hfcutil Main Menu 1 . Display HBA Adapter Number 2 . Modify HBA Adapter Number 1 .

  • Page 118: Confirm The Adapter Number

    Adapter when an individual parameter is set to each Adapter. -Confirmation of Adapter number- Microsoft Windows [Version 5.2.3790] (C) Copyright 1985-2003 Microsoft Corp. C:\Program Files\Hitachi\drivers\hba\HFCTools>hfcls --- Device symbolic name : scsi3 PCI Vendor id/Device id : 1054/3009 PCI bus/device/function number : 5/0/0 Driver name [version] : 1.0.1.5...

  • Page 119: Allocate The Adapter Number

    -Setting example- Adapter number 0 is allocated to the Adapter whose World Wide Port Name is 50000870 00300140. ------------------------------------------------------------ Hitachi HBA Utility for Windows. Version 1.03 (11/07/2004) Copyright (c) 2004, Hitachi Ltd. ------------------------------------------------------------ Main Menu --------- 1 .

  • Page 120

    Please acquire World Wide Port Name of the installed Adapter by using "hfcls" (Program to display the attribute information). Microsoft Windows [Version 5.2.3790] (C) Copyright 1985-2003 Microsoft Corp. C:\Program Files\Hitachi\drivers\hba\HFCTools>hfcls --- Device symbolic name : scsi3 PCI bus/device/function number : 2/0/0 Driver name [version] : hfcwdd [1.0.0.6]...

  • Page 121: Delete The Adapter Number

    The value after deleting 31 - 5000087000300018 Adapter Number ( 0-31 or X to Cancel ) => Driver parameters Available range for each parameter is deferent depending on the type of Hitachi Gigabit Fibre Channel Adapters. Refer to section ‘Driver parameters’ for details.

  • Page 122: Hfcddutil On Linux

    Linux hfcddutil has two modes, Menu mode and CLI mode. Available range for each parameter is deferent depending on the type of Hitachi Gigabit Fibre Channel Adapters. Refer to section ‘Driver parameters’ for details. [MENU mode] You can execute various operations from the main screen sequentially.

  • Page 123: Menu Mode

    1 : General Information 2 : Port Information 3 : Boot Information -------------------------------------------------------------- 4 : Firm Backup/Update Execution Hitachi HBA Utility for Linux. Version 1.0.2.65 (06/17/2009) 5 : Bios Backup Copyright (c) 2004-2009, Hitachi Ltd. 6 : Bios Restore --------------------------------------------------------------...

  • Page 124

     Command tree structure of hfcddutil Various parameters and Persistent Binding function of the Adapter can be set by hfcddutil commands. The following figure shows the command tree structure of hfcddutil. Main Menu hfcddutil 1 . Display Current Component 2 . Display Auto Map Parameter 3 .

  • Page 125

    World Wide Port Name. You can confirm World Wide Port Name of the installed adapters by hfcddutil command, “Display Current Component”. -------------------------------------------------------------- Hitachi HBA Utility for Linux. Version 2.0.1.20 (3/17/2006) Copyright (c) 2004-2006, Hitachi Ltd. -------------------------------------------------------------- Main Menu --------- 1 .

  • Page 126

    Persistent Binding feature. This setting is registered in /etc/modules.conf. [Example] An adapter number 0 is allocated to the adapter port whose World Wide Port Name is 50000870 00300130. -------------------------------------------------------------- Hitachi HBA Utility for Linux. Version 2.0.1.20 (3/17/2006) Copyright (c) 2004-2006, Hitachi Ltd. -------------------------------------------------------------- Main Menu --------- 1 .

  • Page 127

     Delete the adapter number The following shows an example of the deletion of the allocated adapter number. -------------------------------------------------------------- Hitachi HBA Utility for Linux. Version 2.0.1.20 (3/17/2006) Copyright (c) 2004-2006, Hitachi Ltd. -------------------------------------------------------------- Main Menu --------- 1 . Display Current Component 2 .

  • Page 128

     Driver parameters Available range for each parameter depends on the type of Hitachi Gigabit Fibre Channel Adapters. Refer to section ‘Driver parameters’ for details.  Set Persistent Binding information You can make OS identify the fix configuration using persistent binding feature. The parameters for persistent binding information to the current configuration can be automatically created and stored in /etc/hfcldd.conf file using "Modify Persistent...

  • Page 129

    Please note that the persistent binding information set on /etc/hfcldd.conf does not become effective during Automap is enabled. The value of Automap can be confirmed by "Display Auto Map Parameter". -------------------------------------------------------------- Hitachi HBA Utility for Linux. Version 2.0.1.20 (3/17/2006) Copyright (c) 2004-2006, Hitachi Ltd. -------------------------------------------------------------- Main Menu --------- 1 .

  • Page 130

    All persistent binding information can be removed specifying “Modify Persistent Bindings -Delete Binding(s)". You have to set Automap on when you remove persistent binding information. -------------------------------------------------------------- Hitachi HBA Utility for Linux. Version 2.0.1.20 (3/17/2006) Copyright (c) 2004-2006, Hitachi Ltd. -------------------------------------------------------------- Main Menu --------- 1 .

  • Page 131

     Confirm Persistent Binding information -------------------------------------------------------------- Hitachi HBA Utility for Linux. Version 2.0.1.20 (3/17/2006) Copyright (c) 2004-2006, Hitachi Ltd. -------------------------------------------------------------- Main Menu --------- 1 . Display Current Component 2 . Display Auto Map Parameter 3 . Set Auto Map Parameter 4 .

  • Page 132

     Isolate or recover adapter port Isolate or recover adapter port when replace SFP transceiver while system is running. Refer to ‘Hitachi Compute Blade system user’s guide’ for how to replace SFP. Display SFP information You can confirm SFP information selecting ‘Select SFP Operations’-‘Display SFP Information’.

  • Page 133

    【Display items】 Item of display Description Device Logical device name WWPN World Wide Port Name Status Port Status LinkUp: Normal state LinkDown: FC cable is not plugged. WaitLinkUp: Waiting to Linkup after Linkdown is detected. Isolate(C ): Isolated by executing command. Isolate(SFPFail) : SFP failure is detected.

  • Page 134

    You can isolate the adapter port selecting ‘Select SFP Operations’-’ 2. Isolate SFP’. You have to isolate SFP before replacing SFP while OS in operation. -------------------------------------------------------------- Hitachi HBA Utility for Linux. Version 1.0.2.65 (06/17/2009) Copyright (c) 2004-2009, Hitachi Ltd. --------------------------------------------------------------...

  • Page 135

    You can recover the adapter port selecting ‘Select SFP Operations’-’ 3. Recover SFP’. You have to recover SFP after replacing SFP while OS in operation. -------------------------------------------------------------- Hitachi HBA Utility for Linux. Version 1.0.2.65 (06/17/2009) Copyright (c) 2004-2009, Hitachi Ltd. --------------------------------------------------------------...

  • Page 136: Cli Mode

    CLI Mode You can specify either short option or long option. The upper command shows short option and the lower option shows the long oprion in the following command examples. CLI options command Option Feature hfcddutil -v, --ver Display version of this utilily -h, --help Display this help and exit -i, --dspamp...

  • Page 137

    CLI mode: Display version of the utility software. # hfcddutil -v # hfcddutil --ver [Example] -------------------------------------------------------------- Hitachi HBA Utility for Linux. Version 1.0.2.65 (06/17/2009) Copyright (c) 2004-2009, Hitachi Ltd. --------------------------------------------------------------  CLI mode: Display This Help and Exit Display help information...

  • Page 138

     CLI mode: Display Auto Map Parameter You can confirm Automap parameter stored in /etc/modules.conf on RHEL3 or /etc/modprobe.conf on RHEL4. # hfcddutil -i # hfcddutil --dspamp [Example] Auto Map Parameter (in /etc/modules.conf): hfc_automap=1 (Automap On) [Display/Set items] hfc_automap Meaning Auto map is disabled.

  • Page 139

     CLI mode: Set Auto Map Parameter You can set Auto Map Parameter in /etc/modules.conf on RHEL3 or /etc/modprobe.conf on RHEL4 When you register persistent binding information, you have to set Auto Map parameter disabled. Then update RAMDISK image. # hfcddutil –j [value] # hfcddutil --setamp [value] [Display/Set items] Meaning...

  • Page 140

     CLI mode: Display HBA Adapter Number You can confirm adpter number registered in /etc/hfcldd.conf. # hfcddutil -m # hfcddutil --dsphan [Example] Adapter Number - World Wide Port Name (in /etc/hfcldd.conf): - 5000087000302100 - 5000087000302102 - 50000870003021b8 - 50000870003021ba  CLI mode: Modify HBA Adapter Number You have to allocate the adapter number beforehand when setting driver parameters or using Persistent Binding feature.

  • Page 141

    [Example] Adapter Number - World Wide Port Name (in /etc/hfcldd.conf): - 5000087000300130 - 5000087000300020 Persistent Bindings (in /etc/hfcldd.conf): 001. Adapter: 00, Target: 000, WWPN: 50060e8000427810 002. Adapter: 00, Target: 000, WWNN: 50060e8000427810 003. Adapter: 00, Target: 001, WWPN: 50060e8000427811 004. Adapter: 00, Target: 001, WWNN: 50060e8000427811 005.

  • Page 142

    【Display items】 The format is [param][instance]=[value]. Item Meaning [instance] Adapter number (0~63) [param] Driver parameter name (character) [value] The range for the driver parameter. hfc_connection_type (Decimal, 0:Auto, 1:Point to Point, 2:FC-AL) hfc_link_speed (Decimal, 0:Auto, 1:1 Gbps, 2:2 Gbps, 4:4 Gbps) hfc_max_transfer (Decimal, 1:1 MB, 4:4 MB, 8:8 MB, 16:16 MB) hfc_link_down (Decimal, 0-60) hfc_reset_delay (Decimal, 0-60)

  • Page 143

     CLI mode: Display SFP Information and Isolate/Recover SFP Isolate or recover adapter port when replace SFP transceiver while system is running. Refer to ‘Hitachi Compute Blade system user’s guide’ for how to replace SFP.  Display SFP Information You can confirm SFP information. Refer to explanation in the menu mode.

  • Page 144

     Execute Recover SFP You can recover the adapter port. You have to recover SFP after replacing SFP while OS in operation. Refer to explanation in the menu mode. # hfcddutil --sfp [hfclddX] clear <force> [Options] Item Meaning <force> # Omit the (y/n) confirmation message at time of execution [Example] Recover SFP of hfcldd0.

  • Page 145: Hfcbios

    You cannot use the hfcbios command on the LPAR manager. Set various setup parameters from the EFI driver which operates on LPAR manager. Refer to HITACHI Gigabit Fibre Channel Adapter USER’S GUIDE (BIOS/EFI Edition) for details. Function list (1) Scan all ports of adapters installed in the system...

  • Page 146: Scan All Ports To Hba Installed In System

    Please move to directory (*) that installs the utility software, and execute the following commands. (*) Windows for HFCTools version 1.xx.xx.xx: :\ProgramFiles\Hitachi\drivers\hba (:\Program Files (x86)\Hitachi\drivers \hba, for X86_64 and IA-64) Windows for HFCTools version 4.xx.xx.xx: :\Program Files\Hitachi\drivers\hba Linux: /opt/hitachi/drivers/hba Windows: # hfcbios –o devshow...

  • Page 147: Restore Hba Bios Setup Data

    -f: Specifies the stored directory of the backup file -c: Skips the confirmation of Y/N. In the following, we show the execution example in Windows. # hfcbios -d scsi4 –o backup –f C:\ hfcbios Ver. X.X.X.X Copyright(C) 2006. Hitachi, Ltd. Current Configure : scsi4 HBA BIOS : ENABLE...

  • Page 148: Apply Hba Bios Setup Data

    Apply various setup data of HBA BIOS. Currently this command is not available on Linux. Windows: (1) Select “Start”, “Control Panel” and “system” from the desktop. (2) Select the "Hardware" tab and click “Device Manager”. (3) Double click “SCSI and RAID controllers” then make sure that “Hitachi PCI Fibre Channel Adapter" is present.

  • Page 149

    (4) Double click "Hitachi PCI Fibre Channel Adapter". (5) Click "General" tab and look for same "Hitachi PCI Fibre Channel Adapter" as PCI bus number, device number and function number of "Location" that confirmed by "Scan all ports to HBA installed in system".

  • Page 150

    (2) Confirm that the FC cable is not connected with the device and click "Yes". (3) Select "Hitachi PCI Fibre Channel Adapter" of "SCSI and RAID controllers" and right-click "Enable".

  • Page 152: Confirm Hba Bios Parameters

    Linux: # ./hfcbios -d logical device name –o cfgshow In the following, we show the execution example in Windows. # hfcbios -d scsi4 –o cfgshow hfcbios Ver. X.X.X.X Copyright(C) 2006. Hitachi, Ltd. Configure Show : scsi4 HBA BIOS : ENABLE...

  • Page 153: Set Hba Bios Parameters

    Set various parameters of HBA BIOS setup data. Please move to directory (*) that installs the utility software, and execute the following commands. (*) Windows for HFC Tools version 1.xx.xx.xx: :\ProgramFiles\Hitachi\drivers\hba (:\Program Files (x86)\Hitachi\drivers \hba, for X86_64 and IA-64) Windows for HFCTools version 4.xx.xx.xx: :\Program Files\Hitachi\drivers\hba...

  • Page 154: Hba Bios Parameters

    HBA BIOS parameters The table below shows the default value and the specified range of each HBA BIOS setup parameter. Table Setup items and values Setup items Parameter Default Specified range Description HBA BIOS bios Disable Enable/Disable Sets HBA BIOS valid or ENABLE/DISABLE invalid.

  • Page 155

    (*4) If the N+M Cold Standby function is enabled, the function will be effective after next reboot. When the function is effective, WWPN and Pre-configure variable of the HBA will be under the control of the Hitachi Compute Blade system.

  • Page 156: Hfcls On Windows

    hfcls on Windows hfcls Move to the directory that you installed the utility software, and input ‘hfcls’. Items Description Device symbolic name Logical device name PCI Vendor id/Device id Vendor ID/Device ID EC level Board revision Bus/Device/Function Bus/device/Function number number Parts Number Parts number Model Name...

  • Page 157

    [Example]...

  • Page 158: Hfcmcup

     When updating FLASH-ROM, do not close the working window, terminate the command forcibly, turn the power off or reboot the system. There operation might damage FLASH-ROM and may lead the failure of the Hitachi Gigabit Fibre Channel Adapter. ...

  • Page 159: Back Up And Update Flash-rom

    # Omit the (y/n) confirmation message to execute the command 【Example 】 Back up FLASH-ROM for an logical device (scsi19) C:\Program Files (x86)\Hitachi\drivers\hba\HFCTools>hfcmcup -d scsi19 -o backup -f c:\ hfcmcup Ver. 2.4.0.18 Copyright(C) 2003, 2010, Hitachi, Ltd. --- The current microcode level for 300422(scsi19)

  • Page 160

    【Example 】 Update FLASH-ROM for an logical device (scsi19) c:\Program Files (x86)\Hitachi\drivers\hba\HFCTools>hfcmcup -d scsi19 -o download -f c:\54102030.00300429.E7 hfcmcup Ver. 2.4.0.18 Copyright(C) 2003, 2010, Hitachi, Ltd. scsi19 HITACHI FC Adapter *** NOTICE *** NOTICE *** NOTICE *** The microcode installation occurs while the adapter and any attached drives are available for use.

  • Page 161

    Hitachi Gigabit Fibre Channel Adapter has its own binary file for FLASH-ROM depending on its device ID. If there are multiple types of Hitachi Gigabit Fibre Channel Adapter exist on the same system and execute the update command specifying ‘all’ option, the command always display the error.

  • Page 162

    If HFCTools version is equals to 1.0.3.32 or higher, driver version should be equals to X.Y.6.650 or higher. Otherwise, this error message is displayed. Confirm versions of both driver and HFCTools. Please refer HITACHI Gigabit Fibre Channel Adapter USER’S GUIDE (Support Matrix Edition) for details.

  • Page 163

    OnlineUpdate is reserving it. Online update procedure is reserved. Check online update availablity executing hfcmcref and the status. INSTALL MICROCODE SYSTEM Speciefied update file version is older REVISION CHECK ERROR than current FW version. Confirm update file version. other port(s) busy.(xxx) Busy state.

  • Page 164: Hfcmcref

    (Linux/VMware Driver Edition)’. For the supported version of the driver, firmware and LPAR manager for this commands from the guest of LPAR manager, refer to HITACHI Gigabit Fibre Channel Adapter USER’S GUIDE (Support Matrix Edition) for details. Check online update is applicable [Function] Check online update is applicable or not.

  • Page 165

    Meaning Applicable Firmware online update is applicable. No need Hitachi Gigabit Fibre Channel Adapter hardware has already updated by this version of the update file. You do not need to execute online update. Waiting Firmware update operation is running now. You are now waiting for the completion of the operation.

  • Page 166: Online Update Of The Firmware

    Online update of the firmware [Function] Transfer the FLASH-ROM data into the hardware while system is running. [Syntax] <Check online update is applicable> hfcmcref –d <Device>|all} [force] <Online update> hfcmgr –u {<Device>|all} [force] <options> # Execute the command to all logical names. # Omit the (y/n) confirmation message at time of delete [Example] # hfcmcref –d all...

  • Page 167

    【Error Message】 Error messages Actions to be taken parameter error Input command syntax error Confirm command syntax. another F/W update process is Other process is executing FLASH-ROM running. update, backup or Onine-update. Confirm whether other FLASH-ROM update, backup commands or FW online update command has finished and retry command.

  • Page 168

    Specified adapter is not supported Driver and utility tools may not support specified adapter. Confirm versions of driver and utility tools. Please refer HITACHI Gigabit Fibre Channel Adapter USER’S GUIDE (Support Matrix Edition) for details. RegOpenKeyEx error. Failed to modify registry.

  • Page 169: Hfcmig [windows Only]

    hfcmig [Windows only] Windows driver version lower than or equal to x.y.z.470 (Corresponding HFCTools version is 1.0.1.19) and driver version higher than or equal to x.y.z.530 (Corresponding HFCTools version is 1.0.2.22) use different utility program to set parameters. Refer to Section 5.4 and 5.5 for the criteria of conversion. This section describes HBA parameter conversion utility ‘hfcmig.exe’.

  • Page 170: Convert Parameters To New Utility Program

    Convert parameters to new utility program [Function] Convert parameter format for hfcmputil.exe to hfcmgr.exe. [Syntax] hfcmig -new [Example] Sample of executing hfcmig –new hfcmig -new > Succeeded. The following message is displayed when parameter ConnectionType or LinkSpeed is set. In this case, execute ‘Delete ConnectionType or LinkSpeed parameter’.

  • Page 171: Convert Parameters To Old Utility Program

    Convert parameters to old utility program [Function] Convert parameter format for hfcmgr.exe to hfcmputil.exe. [Syntax] hfcmig -old [Example] Sample of executing hfcmig –old hfcmig -old > Do you execute it? > y Succeeded. Backup parameters [Function] Backup all HBA parameters set in running driver. This command stores both old and new format.

  • Page 172: Delete All Parameters

    [Example] Sample of executing hfcmig -restore hfcmig –restore .\mig_20090921211545.bk > Do you execute it? > y Succeeded. Delete all parameters [Function] Delete all HBA parameters set in running driver. [Syntax] hfcmig –reset [Example] Sample of executing hfcmig –reset hfcmig –reset >...

  • Page 173: List Of The Response Messages Of Hfcmig

    List of the Response Messages of hfcmig List of the Response Messages of hfcmig Description Response Message Succeeded. Successfully terminated Command syntax error. Command syntax error Check the syntax. Registry operation is failed. Failed to handle registry. Retry command again. File operation is failed.

  • Page 174: Driver Parameters

    GUIDE (BIOS/EFI Edition). Link Speed (-p sp) Specify the link speed of a FC path between Hitachi Fibre Channel Adapter and the device attached to it. The relations between specified value and the Link Speed are as follows. <Specified Parameter>...

  • Page 175

    (-p pa) *Displayed as “Preferred AL-PA” If AL (Arbitrated Loop) connection type is set on a FC path between Hitachi Fibre Channel Adapter and the device attached to it, the driver uses this parameter as preferred ALPA (Arbitrated Loop Physical Address) on loop initialization phase.

  • Page 176

    Allowed (-p al) [Linux only] This parameter specifies the minimum permissive retry number of a SCSI command. The parameter is available on disk devices, but ignored on tape devices. Target Reset Mode (-p tr) [RHEL5 only] This parameter specifies whether the driver executes Target Reset command to the device or not. The parameter is set to the optimum value for a general purpose, so usually this parameter does not need to be changed.

  • Page 177

    Interrupt Type (-p ir) [Linux only] This parameter specifies interrupt mode. The parameter is set to the optimum value for a general purpose, so usually this parameter does not need to be changed. In Windows, this parameter can be set in Windows Server 2016. In Windows Server 2008 R2 or lower Windows version, the driver runs with INT, and in Windows Server 2012 and Windows Server 2012 R2, the driver runs with MSI-X.

  • Page 178

    Login Target Filter (-p tf) When FC-Switch is used, restrain unnecessary logging in to target ports from adapter ports. If this parameter value is set to pid, the driver does not log in to target ports that have the same upper 2 bytes in 3 bytes of the PORT ID of the Adapter itself.

  • Page 179

    Login Target Filter 16G or Login Target Filter Ext (-p tfx) When FC-Switch is used, restrain unnecessary logging in to target ports from adapter ports. If this parameter value is set to pid, the driver does not log in to target ports that have the same upper 2 bytes in 3 bytes of the PORT ID of the Adapter itself.

  • Page 180

    Performance Option (-p perf) [Windows only] This parameter improves IO handling performance (IOPS) on degradation caused by the situation that multiple contiguous requests are stacked onto the driver. There are a few cases that this option does not improve performance of the system, depending on the environment or I/O characteristics. In Windows 2003, the value of perf option cannot be set, and the driver always runs with disable.

  • Page 181

    This parameter enables Multi Queue feature of HITACHI Gigabit Fibre Channel Adapter. After enabling this parameter and executing 'hfcmgr -p <Device>' command, occasionally a message 'Multi queue: not work (-)' is displayed. It means that Multi Queue feature of HITACHI Gigabit Fibre Channel Adapter does not work for some reasons.

  • Page 182

    If the port is connected to the disk device directly, set Connection Type ‘FC-AL’. (5) If the FC extension card is mounted on Hitachi Compute Blade 320, the parameter value ‘auto’ should not be set to the Link Speed parameter and a fixed value has to be set. Refer to ‘Hitachi Compute Blade 320 User’s Guide’...

  • Page 183

    Adapter Type Model Name Parameter and its range Link Speed Max Transfer Interrupt (sp) Size (mt) Type (ir) 2Gbps FC-HBA HFC0201 Auto, 1, 2 1MB/4MB/8MB/16MB 4Gbps FC-HBA HFC0401 Auto, 1,2,4 1MB/4MB/8MB/16MB HFC0402 HFC0401-C HFC0402-C HFC0402-M HFC0402-E 8Gbps FC-HBA HFCE0801 Auto, 2,4,8 1MB/4MB/8MB/16MB/32MB int/msi/msix HFCE0802...

  • Page 184

    Fibre Channel Arbitrated Loop (Direct Connection) Link Speed (-p sp) Specify the link speed of a FC path between Hitachi Fibre Channel Adapter and the device attached to it. The relations between specified value and the Link Speed are as follows. <Specified Parameter>...

  • Page 185

    (-p pa) *Displayed as “Preferred AL-PA” If AL (Arbitrated Loop) connection type is set on a FC path between Hitachi Fibre Channel Adapter and the device attached to it, the driver uses this parameter as preferred ALPA (Arbitrated Loop Physical Address) on loop initialization phase.

  • Page 186

    Queue Depth (-p qd) This parameter specifies maximum permissive I/O command number to queue per LU on the target device. Since each target device have a maximum permissive I/O command number, so check the specification of the target device. (Example) If 17 LUs are used on a target device and the device has a port that can queue maximum 512 commands per second, and 4 systems are using the device.

  • Page 187

    Logging Mode (-p lm) If the FC-Switch is used and do not separate its ports into zones, for example, Access Gateway mode of the FC-switch is used, the adapter ports access each other. Because of this reason, Link Down of the other adapter port or the server reboot may make the driver log unnecessary errors, such as the followings;...

  • Page 188

    If the port is connected to the disk device directly, set Connection Type ‘FC-AL’. (5) If the FC extension card is mounted on Hitachi Compute Blade 320, the parameter value ‘auto’ should not be set to the Link Speed parameter and a fixed value has to be set. Refer to ‘Hitachi Compute Blade 320 User’s Guide’...

  • Page 189

    Adapter Type Model Name Parameter and its range Link Speed Max Transfer Interrupt (sp) Size (mt) Type (ir) 2Gbps FC-HBA HFC0201 Auto, 1, 2 1MB/4MB/8MB/16MB 4Gbps FC-HBA HFC0401 HFC0402 Auto, 1,2,4 1MB/4MB/8MB/16MB HFC0401-C HFC0402-C HFC0402-M HFC0402-E 8Gbps FC-HBA HFCE0801 Auto, 2,4,8 1MB/4MB/8MB/16MB/32MB int/msi/msix HFCE0802...

  • Page 190

    HITACHI Gigabit Fibre Channel Adapter USER’S GUIDE (Utility Software Edition) Revision 41.0 Jul 2017 Hitachi, Ltd. Reprint without permission is prohibited.

Comments to this Manuals

Symbols: 0
Latest comments: