QLogic iscsi Boot for HP FlexFabric Adapters User Guide

Transcription

1 QLogic iscsi Boot for HP FlexFabric Adapters User Guide Abstract This document is for the person who installs, administers, and troubleshoots servers and storage systems. HP assumes you are qualified in the servicing of computer equipment and trained in recognizing hazards in products with hazardous energy levels. Part Number: November 2013 Edition: 1

2 Copyright 2013 Hewlett-Packard Development Company, L.P. The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein. Microsoft and Windows are U.S. registered trademarks of Microsoft Corporation.

3 Contents Introduction... 4 Overview... 4 Installing iscsi in Linux, ESXi, and Windows... 4 Configuring iscsi in QCC GUI, interactive QCC CLI, or non-interactive CLI... 4 Setup... 5 Setting up QCC on a management server... 5 Downloading and installing QCC... 5 iscsi initiator... 5 Configuring an iscsi Initiator in Linux... 5 Configuring an iscsi Initiator in Windows... 6 Configuring an iscsi Initiator in VMware iscsi Name Server isns iscsi function configuration iscsi boot setup using Fast!UTIL Configuring Host Adapter settings Configuring iscsi boot settings Configuration options DCHP boot setup for iscsi Boot (IPv4) iscsi boot setup using QCC CLI Troubleshooting iscsi diagnostics iscsi troubleshooting diagram Support and other resources Before you contact HP HP contact information Acronyms and abbreviations Documentation feedback Index Contents 3

4 Introduction Overview This section describes the driver and agent installation, configuration, operation, and troubleshooting of the NC526 series CNA iscsi function. Installing iscsi in Linux, ESXi, and Windows For information about specific operating system support, see the QLogic website ( Linux For information about packaging content, Linux OS support, supported features, driver deployment, and driver system parameters, see "iscsi Adapter Inbox Driver Update Readme." ESXi For information about packaging content, ESXi OS support, using the driver, and installing the driver, see "iscsi Adapter Driver and IMA Plug-in for VMware ESXi 5.0.x Readme." Windows For information about packaging content, Windows OS support, and using the driver, see "iscsi Adapter STOR Miniport Driver for Windows Readme." Configuring iscsi in QCC GUI, interactive QCC CLI, or non-interactive CLI For information about configuring QCC GUI, interactive QCC CLI, or non-interactive CLI, see the QLogic website ( QCC GUI See "QConvergeConsole Help System iscsi Initiator 3-2 SN D." Interactive QCC CLI See "QConvergeConsole CLI User's Guide." Non-Interactive QCC CLI See "SCSI Noninteractive Commands" in the "QConvergeConsole CLI User's Guide." Introduction 4

5 Setup Setting up QCC on a management server Set up QCC on only one management server in your network to manage all CNAs, and complete the QCC installation before installing drivers or updating firmware. Use QCC to manage CNAs instead of SANsurfer (QLogic HBA management application). Downloading and installing QCC Download and install QCC on Windows and Linux operating systems. To locate and download the QCC application: 1. Go to the HP website ( 2. Click Drivers and downloads. 3. Enter the CNA model number. Use the HP model number as your guide. 4. Select the operating system. 5. Select the QCC application, and then download it to the server. To download the QCC agent, repeat steps 1 through 4, and then select QCC agent. iscsi initiator Use the following information to configure iscsi Initiator on the appropriate operating system. Configuring an iscsi Initiator in Linux 1. Enter gaucli in a terminal window to access the QCC CLI. 2. Select 2: Adapter Configuration on the QConvergeConsole CLI Main Menu. 3. Select 1: CNA Configuration on the Adapter Type Configuration Selection menu. 4. Select 1: CNA iscsi Configuration on the CNA Protocol Type Selection menu. 5. Select 3: Port IP Settings on the CNA iscsi Configuration menu. 6. Select the converged network port you want to configure. 7. Select 2: Configure IP Settings. If you have already used Fast!Util to configure IP settings, this information is already populated. 8. Complete the interactive list of settings as follows: a. Enable IPv4 [on]: Press the Enter key to accept the default. b. DHCP to obtain IPv4 Network Information: [off]: Press the Enter key to accept the default. To enable DHCP, enter ON, and then press the Enter key. c. IP_Address []: Type the IP address of the initiator system, and then press the Enter key. Setup 5

6 d. IP_Subnet_Mask [ ]: Type the appropriate subnet mask, and then press the Enter key. e. IP_Gateway [ ]: Press the Enter key to accept the default. f. Enable IPv6 [off]: Press the Enter key to accept the default. g. Press the Enter key to continue. 9. Select 3: Save changes and reset HBA (if necessary) on the options menu. 10. Enter Yes at the prompt for both ports. 11. Type p, and then press the Enter key. 12. Type p, and then press the Enter key. This returns you to the CNA iscsi Configuration menu. 13. Select 4: Target Configuration on the CNA iscsi Configuration menu. 14. Select the same converged network port you selected in Step Select 6: Add a Target. 16. Complete the interactive list of settings as follows: a. IPv6 Target? [off]: Press the Enter key to accept the default. b. TGT_iSCSI_Name []: Type the IQN of the iscsi target to connect to, and then press the Enter key. c. TGT_Port [3260]: If the setting is something other than 3260, enter 3260, and then press the Enter key. d. TGT_TargetIPAddress [ ]: Type the IP address of the target, and then press the Enter key. 17. Select 12: Save Target/CHAP Changes on the options menu. This completes the iscsi initiator configuration for connecting to the iscsi target. Configuring an iscsi Initiator in Windows 1. Double-click the OCC CLI desktop icon or enter gaucli in the CMD window to access the QCC CLI. 2. Select 2: Adapter Configuration on the QCC CLI Main Menu. Setup 6

7 3. Select 1: CNA Configuration on the Adapter Type Configuration Selection menu. 4. Select 1: CNA iscsi Configuration on the CNA Protocol Type Selection menu. 5. Select 3: Port IP Settings on the CNA iscsi Configuration menu. Setup 7

8 6. Select the converged network port you want to configure. 7. Select 2: Configure IP Settings if you need to configure IP Settings. If you have configured this using Fast!UTIL, the IP address field is already populated. 8. Complete the interactive list of settings as follows: a. Enable IPv4 [on]: Press the Enter key to accept the default. b. DHCP to obtain IPv4 Network Information: [off]: Enter ON, and then press the Enter key. Select DHCP, and then press the Enter key. c. Enable IPv6 [off]: Press the Enter key to accept the default. If you are using a static address, set DHCP to obtain IPv4 network information to OFF. d. IP_Address []: Enter the IP address of the initiator system, and then press the Enter key. e. IP_Subnet_Mask [ ]: Enter the appropriate subnet mask, and then press the Enter key. f. IP_Gateway [ ]: Press the Enter key to accept the default or enter the address of the default gateway. Setup 8

9 g. Press the Enter key to continue. 9. Select 3: Save changes and reset HBA (if necessary) on the options menu. 10. Enter Yes at the prompt for both ports. After you have saved the configuration, press the Enter key to continue. 11. Type p, and then press the Enter key. 12. Type p, and then press the Enter key. This returns you to the CNA iscsi Configuration menu. 13. Select 4: Target Configuration on the CNA iscsi Configuration menu. 14. Select the same converged network port you selected in Step 6. Setup 9

10 15. Select 6: Add a Target. 16. Complete the interactive list of settings as follows: a. IPv6 Target? [off]: Press the Enter key to accept the default. b. TGT_iSCSI_Name []: Enter the IQN of the iscsi target to connect to, and then press the Enter key. c. TGT_Port [3260]: Press the Enter key to accept the default. d. TGT_TargetIPAddress [ ]: Enter the IP address of the target, and then press the Enter key. 17. Select 12: Save Target/CHAP Changes on the options menu. This completes the iscsi initiator configuration for connecting to the iscsi target. Configuring an iscsi Initiator in VMware Enable the iscsi initiator software so that ESXi can use it to access iscsi storage. To configure an ESX/ESXi initiator: 1. Log in to the vsphere Client. Setup 10

11 2. Select a server. 3. Click the Configuration tab. 4. Click Storage Adapters in the Hardware panel. 5. Select the iscsi initiator you want to configure from the list of available storage adapters, and then click Properties. The General Properties dialog box shows the initiator status, default name, and alias. 6. Click Configure. 7. (Optional) Type a new name to change the default iscsi name for your initiator. The name you enter must be worldwide unique and properly formatted so that all storage devices can recognize the software iscsi initiator. IMPORTANT: An iscsi name change applies to new iscsi sessions only. Existing sessions do not use the new settings until you log out and log in again. 8. Click OK to save your changes. Configuring iscsi on ESXi 5.x 1. Log in to the vsphere Client. 2. Select the host server. 3. Click the Configuration tab. 4. Click Storage Adapters in the Hardware panel. This lists all storage controllers available on the host server. Setup 11

12 5. Select an ISP82xx 10GBe iscsi PCI Express CNA port. The system displays the information for the port in the Details pane. Setup 12

13 6. Click Properties. 7. Click Configure. The General Properties dialog box shows the initiator status, default name, and alias. Setup 13

14 8. (Optional) Enter an iscsi Name and iscsi Alias. 9. Enter a static IP address under Hardware Initiator Properties. If you configured the static IP address using the Fast!UTIL, the system displays that IP address, as well as the DHCP address. 10. Click OK. Setup 14

15 11. Click the Dynamic Discovery tab. 12. Click Add, and then enter the IP address of the SAN portal. 13. Verify the port number, and then click OK. After the adapter connects to the SAN, the address of the SAN should appear under iscsi Server Location. Setup 15

16 14. Click the Static Discovery tab. This screen lists any targets assigned to the server, along with the target IP address, port, and name. 15. Click Close to close the iscsi Initiator Properties. 16. Click Yes at the prompt to rescan the host bus adapter. Setup 16

17 17. Return to the Configuration tab, and then select the adapter you configured. 18. Verify that the system indicates the correct number of targets in Connected Targets under Details. 19. Check Devices and Paths in View under Details to verify that the targets are listed. 20. When the rescan completes, you can create the datastores on the targets. iscsi Name Server isns For additional information about the iscsi name server, isns, see "Configuring isns to Automatically Discover Targets" in the QCC Help System. iscsi function configuration 1. Press Ctrl+Q at the first CTRL+Q prompt: Press <Ctrl+Q> to enter setup menu Setup 17

18 The Function Configuration utility opens. 2. Select the Type for Function 4, and then press the Enter key. 3. Select iscsi, and then press the Enter key. 4. Select the Type for Function 5, and then press the Enter key. 5. Select iscsi, and then press the Enter key. 6. Press the Escape key, and then select Save Changes at the prompt. Setup 18

19 7. Select Reboot System from the Exit Setup Menu prompt when the system has finished saving the configuration. iscsi boot setup using Fast!UTIL Fast!UTIL is the QLogic iscsi BIOS Configuration utility used to configure iscsi. Use Fast!UTIL to program the QLogic iscsi adapter to boot from the SAN. You must enable iscsi before you complete the iscsi boot setup. See iscsi function configuration (on page 17) for details. With iscsi enabled, launch the QLogic NC526 Series Adapters BIOS. The first Ctrl+Q prompt is for the setup menu. To access Fast!UTIL for PXE and iscsi, press Ctrl+Q at the second banner that displays during the QLogic NC526 Series Adapters BIOS initialization. After you have chosen an adapter, wait several seconds for the Fast!UTIL menu to appear. The Fast!UTIL Options menu for iscsi contains the following selections: Configuration Settings Scan iscsi Devices iscsi Disk Utility Ping Utility Setup 19

20 Loopback Test Reinit Adapter Select Host Adapter Exit Fast!UTIL Fast!UTIL prompts you to select the adapter you want to configure. After changing the settings, exit and reboot your system to load the new Fast!UTIL parameters. Configuring Host Adapter settings 1. Press Ctrl+Q at the second CTRL+Q prompt: Press <CTRL-Q> or <ALT-Q> for Fast!UTIL 2. Select the port to configure using the arrow keys on the keyboard, and then press the Enter key. 3. Select the adapter, and then press the Enter key. Setup 20

21 4. Select Configuration Settings, and then press the Enter key. 5. Select Host Adaptor Settings, and then press the Enter key. Changing the Initiator IP Settings Setup 21

22 1. Select Initiator IP Settings, from the Host Adapter Settings screen, and then press the Enter key. The Initiator IP Settings menu opens. Setup 22

23 With DHCP set to Yes, the system ignores any IPv4 or IPv6 settings. The following image shows the DHCP configuration settings. With DHCP set to No, continue with the next step to set the IPv4 and IPv6 addresses. Setup 23

24 2. Select the IPv4 Address, and then press the Enter key. 3. Enter the IPv4 Address in the New field, and then press the Enter key. 4. Select the Subnet Mask, and then press the Enter key. 5. Enter the Subnet Mask in the New field, and then press the Enter key. 6. Select the Gateway IPv4 Address, and the press the Enter key. 7. Enter the Gateway IPv4 address in the New field, and then press the Enter key. 8. Press the Escape key to return to the Host Adapter Settings menu. Changing Luns per Target Luns per target defaults to 16. Changing Spinup Delay Spinup Delay defaults to disabled. Changing the Initiator iscsi Name Setup 24

25 1. Select the Initiator iscsi Name, and then press the Enter key. The Initiator iscsi Name defaults to the name shown, including a date, the manufacturer name, the model number, and the MAC address. 2. Enter the new iscsi name in the New: field, and then press the Enter key. Entering or changing the CHAP name and secret Setup 25

26 The initial CHAP name defaults to a blank space. If your site uses CHAP, set the CHAP name as follows: 1. Select the Initiator CHAP Name, and then press the Enter key. 2. Enter the Initiator CHAP name in the New: field, and then press the Enter key. Make sure that the name matches the Initiator CHAP name configured on the SAN. 3. Select Initiator CHAP secret, and then press the Enter key. 4. Enter the CHAP secret, and then press the Enter key. Setup 26

27 5. Enter the CHAP secret again at the Confirm New Secret prompt, and then press the Enter key. 6. Select Save Changes at the Configuration Settings Modified Prompt, and then press the Enter key. This returns you to the Fast!UTIL Options screen. Setup 27

28 7. Repeat the configuration for the other adapter port. Configuring iscsi boot settings Obtain the SAN target iscsi name and IP address. 1. Select the adapter, and then press the Enter key. Setup 28

29 2. Select Configuration Settings, and then press the Enter key. 3. Select iscsi Boot Settings, and then press the Enter key. Setting the Adapter Boot Mode Setup 29

30 1. Select the Adapter Boot Mode:, and then press the Enter key. The boot mode defaults to Disable. 2. Select the appropriate boot mode, and then press the Enter key. Setting the Primary Boot Device Settings (CHAP) 1. Select Primary Boot Device Settings to configure the boot volume, and then press the Enter key. Setup 30

31 2. If your site uses CHAP, select Security Settings to set the boot device to use CHAP. 3. Press the Enter key. CHAP defaults to Disabled, and CHAP name defaults to a blank space. 4. Select CHAP:, and then press the Enter key to change the setting from Disabled to Enabled. 5. Select CHAP Name:, and then press the Enter key to open the dialog box. Setup 31

32 6. Enter the CHAP name into the dialog box, and then press the Enter key. Make sure that the CHAP name you enter is the same as the CHAP name configured in the SAN. 7. Select CHAP Secret:, and then press the Enter key. 8. Enter the CHAP secret, and then press the Enter key. Make sure that the CHAP secret you enter is the same as the CHAP secret configured in the SAN. 9. Enter the CHAP secret again, and then press the Enter key at the Confirm New Secret prompt. 10. If your site uses Mutual CHAP, select Bidirectional CHAP:, and then press the Enter key to change the setting from Disabled to Enabled. 11. Press Escape to close Security Settings. Setting the Target IP address and iscsi name 1. Select Target IP:, and then press the Enter key. 2. Enter the SAN IP address, and then press the Enter key. The Target Port defaults to 3260, and the Boot LUN defaults to zero. Setup 32

33 3. Select iscsi Name:, and then press the Enter key. 4. Enter the name of the target configured on the SAN, and then press the Enter key. 5. Press the Escape key to return to the Primary Boot Device Settings screen. Setting the Alternate Boot Device Setup 33

34 1. Select Alternate Boot Device Settings to set up a second volume. 2. Press the Enter key. 3. Configure the same fields you configured for the primary boot device using the alternate boot device information. Setting IPv4 DHCP Boot Settings Setup 34

35 1. Select IPv4 DHCP Boot Settings, and then press the Enter key. 2. Select Vendor ID:, and then press the Enter key. 3. Enter the vendor ID information, and then press the Enter key. 4. Select the Alternate Client ID:, and then press the Enter key. 5. Enter the alternate client information, and then press the Enter key. 6. Press the Escape key to exit the configuration screen. 7. Select Save Changes at the prompt, and then press the Enter key. Setup 35

36 8. Repeat the procedures in this section to configure additional iscsi boot devices. When you are finished, press the Escape key to return to the Fast!UTIL Options screen. 9. Select Exit Fast!Util, and then press the Enter key. 10. Reboot the system, and then install the operating system on the boot volume following the appropriate procedures for your operating system. Configuration options Option TCP/IP parameters using DHCP IP Auto-configuration iscsi parameters using DHCP Description Specific to IPv4. Controls whether the iscsi boot host software acquires the IP address information using DHCP (Enabled) or using a static IP configuration (Disabled). Specific to IPv6. IP auto-configuration controls whether the iscsi boot host software configures a stateless link-local address or a stateful address if DHCPv6 is present and used (Enabled). Router solicit packets are sent out up to three times with 4 second intervals in between each retry. Or, use a static IP configuration (Disabled). Controls whether the iscsi boot host software acquires the iscsi target parameters using DHCP (Enabled) or through a static configuration (Disabled). The static information is entered through the iscsi Initiator Parameters Configuration screen. Setup 36

37 Option CHAP Authentication DHCP Vendor ID IP Version HBA Boot Mode Spinup Delay Description Controls whether the iscsi boot host software uses CHAP authentication when connecting to the iscsi target. With CHAP authentication enabled, enter the CHAP ID and CHAP secret through the iscsi Initiator Parameters Configuration screen. Controls how the iscsi boot host software interprets the Vendor Class ID field used during DHCP. If the Vendor Class ID field in the DHCP offer packet matches the value in the field, the iscsi boot host software looks into the DHCP option 43 fields for the required iscsi boot extensions. If DHCP is disabled, this value does not need to be set. Specific to IPv6 and toggles between the IPv4 and IPv6 protocols. All IP settings are lost when switching from one protocol version to the other. Set this option to disable when the host OS is configured for software initiator mode and to enable for HBA mode. This option is available on HP FlexFabric adapters. The parameter cannot be changed when the adapter is in Multi-Function mode. Defaults to Disabled. When enabled, delays access to the devices. Press CTRL+S to bypass Spin Up Delay during BIOS initialization. DCHP boot setup for iscsi Boot (IPv4) DHCP boot provides a method for the iscsi initiator to acquire target parameters from a DHCP server. To configure the DHCP server to support iscsi boot, first ensure that your DHCP server is set up. iscsi boot setup using QCC CLI For information about iscsi boot setup using the QCC CLI, see the "QConvergeConsole CLI User s Guide" on the QLogic website ( Configuring iscsi boot using interactive QCC CLI For information about configuring iscsi boot using the interactive QCC CLI, see QConvergeConsole CLI User s Guide, available from the QLogic website ( Configuring iscsi boot using non-interactive QCC CLI For information about configuring iscsi boot using non-interactive QCC CLI, see "iscsi Noninteractive Commands" in the QConvergeConsole CLI User's Guide, available from the QLogic website ( Setup 37

38 iscsi boot setup QCC CLI For information about iscsi boot setup using QCC GUI, see "Configuring Boot Settings" in the QConvergeConsole Help System. Configuring iscsi boot with QCC CLI For information about configuring iscsi boot with the QCC GUI, see "Configuring Boot Settings" in the QConvergeConsole Help System. Configuring iscsi DHCP boot options For information about configuring iscsi DHCP boot options, see "Configuring Boot Settings" in the QConvergeConsole Help System. Setup 38

39 Troubleshooting iscsi diagnostics iscsi diagnostics using QCC GUI For information about iscsi diagnostics using QCC GUI, see QConvergeConsole Help System: Pinging an iscsi Port Target available from the QLogic website ( iscsi diagnostics using interactive QCC CLI For information about iscsi diagnostics using the interactive QCC CLI, see QConvergeConsole CLI User's Guide available from the QLogic website ( Troubleshooting 39

40 iscsi troubleshooting diagram Troubleshooting 40

41 Support and other resources Before you contact HP Be sure to have the following information available before you call HP: Active Health System log (HP ProLiant Gen8 or later products) Download and have available an Active Health System log for 3 days before the failure was detected. For more information, see the HP ilo 4 User Guide or HP Intelligent Provisioning User Guide on the HP website ( Onboard Administrator SHOW ALL report (for HP BladeSystem products only) For more information on obtaining the Onboard Administrator SHOW ALL report, see the HP website ( Technical support registration number (if applicable) Product serial number Product model name and number Product identification number Applicable error messages Add-on boards or hardware Third-party hardware or software Operating system type and revision level HP contact information For United States and worldwide contact information, see the Contact HP website ( In the United States: To contact HP by phone, call For continuous quality improvement, calls may be recorded or monitored. If you have purchased a Care Pack (service upgrade), see the Support & Drivers website ( If the problem cannot be resolved at the website, call For more information about Care Packs, see the HP website ( Support and other resources 41

42 Acronyms and abbreviations CHAP Challenge Handshake Authentication Protocol CNA Converged Network Adaptor DHCP Dynamic Host Configuration Protocol HBA host bus adapter HDD hard drive IPv4 Internet Protocol version 4 IPv6 Internet Protocol version 6 IQN iscsi qualified name iscsi Internet Small Computer System Interface LUN logical unit number PCI peripheral component interconnect PXE preboot execution environment Acronyms and abbreviations 42

43 QCC QConvergeConsole RFC request for comments VLAN virtual local-area network Acronyms and abbreviations 43

44 Documentation feedback HP is committed to providing documentation that meets your needs. To help us improve the documentation, send any errors, suggestions, or comments to Documentation Feedback Include the document title and part number, version number, or the URL when submitting your feedback. Documentation feedback 44

45 Index A agent installation 5 alternate boot device 28 application, installation 5 B boot device, alternate 28 boot settings 28, 37, 38 booting 28 booting problems 4 C CHAP 28 configuration options 17, 20, 28, 36, 37, 38 configuring VMware ESXi Server 11 D DHCP server 20, 28 diagnostics 39 downloading files 5, 41 M managing network adapters 5 P problem diagnosis 39 pxelinux.0 4, 5 S security settings 28 settings, boot 19, 37, 38 settings, host adapter 20 support 41 supported targets 17, 39 T target connection problems 17 target IP 28 technical support 41 troubleshooting 39, 40 F frequently asked questions 4 functions 17 H hoses 19 I initiator IP 20 initiator name 5, 6, 10 initiator secret 5, 6, 10, 28 installing a DIMM 4 iscsi boot configuration 28, 36, 37, 38 iscsi boot parameters 28, 36, 37, 38 iscsi boot targets 17, 28 iscsi initiator 5, 6, 10 Index 45