Fujitsu ETERNUS DX Disk User manual

FUJITSU Storage
ETERNUS DX
Configuration Guide -Server Connection-
(FCoE) for Linux
Driver Settings for Converged Network Adapter Cards
P3AM-6402-11ENZ0

This page is intentionally left blank.

Preface
This manual briefly explains the operations that need to be performed by the user in order to connect an
ETERNUS DX to a server running Linux and using Converged Network Adapter cards via an FCoE interface.
This manual is used when performing the setup procedure described in "Installing Drivers and Setting Up the
Server" of the "Configuration Guide -Server Connection- (FCoE) for Linux".
This manual should be used in conjunction with any other applicable user manuals, such as those for the
ETERNUS DX, server, OS, Converged Network Adapter cards, and drivers.
Refer to "Configuration Guide -Server Connection- Notations" for the notations used in this manual such as
product trademarks and product names. For storage systems that are supported by the OS, refer to the Server
Support Matrix of the ETERNUS DX.
11th Edition
April 2018
The Contents and Structure of this Manual
This manual is composed of the following two chapters.
•"Chapter 1 Setup Procedure for Emulex Converged Network Adapter Cards" (page 5)
This chapter describes how to set up the server and Emulex Converged Network Adapter card driver when
connecting to the server via Emulex Converged Network Adapter cards.
•"Chapter 2 Setup Procedure for QLogic Converged Network Adapter Cards" (page 11)
This chapter describes the workflow required to establish a connection between a server with QLogic Con-
verged Network Adapter cards and an ETERNUS DX.
An appendix contains a WWN instance management table for servers, for use in "Setting Up the Converged
Network Adapter Cards".
3
FUJITSU Storage ETERNUS DX Configuration Guide -Server Connection- (FCoE) for Linux
Copyright 2018 FUJITSU LIMITED
P3AM-6402-11ENZ0

Table of Contents
Chapter 1 Setup Procedure for Emulex Converged Network Adapter Cards 5
1.1 Workflow ........................................................................................................................................ 5
1.2 Setting Up the Converged Network Adapter Cards.......................................................................... 6
1.3 Installing the Converged Network Adapter Card Driver................................................................... 8
1.4 Setting Up the Driver Parameters................................................................................................... 8
1.5 Creating an Initial RAM Disk......................................................................................................... 10
1.6 Rebooting the OS ......................................................................................................................... 10
Chapter 2 Setup Procedure for QLogic Converged Network Adapter Cards 11
2.1 Workflow ...................................................................................................................................... 11
2.2 Setting Up the Converged Network Adapter Cards........................................................................ 12
2.3 Installing the Converged Network Adapter Card Driver................................................................. 15
2.4 Setting Up the Driver Parameters................................................................................................. 16
2.5 Creating an Initial RAM Disk......................................................................................................... 18
2.6 Rebooting the OS ......................................................................................................................... 18
Appendix A WWN Instance Management Table for the Server (Blank) 19
4
FUJITSU Storage ETERNUS DX Configuration Guide -Server Connection- (FCoE) for Linux
Copyright 2018 FUJITSU LIMITED
P3AM-6402-11ENZ0

Chapter 1
Setup Procedure for Emulex Converged Network
Adapter Cards
This chapter describes the workflow required to establish a connection between a server with Emulex Con-
verged Network Adapter cards and an ETERNUS DX.
1.1 Workflow
All work after this point requires "root" privileges.
When using Linux supported Converged Network Adapter cards, this procedure is used for all OS architectures
(e.g. x86, Intel64), Converged Network Adapter cards, and driver versions.
Workflow
Setting Up the Converged Network Adapter Cards
Install the Converged Network Adapter cards, acquire their physical addresses and WWN information.
•"1.2 Setting Up the Converged Network Adapter Cards" (page 6)
Setting Up the Driver Parameters
Set the driver parameters by editing the configuration file.
•"1.4 Setting Up the Driver Parameters" (page 8)
5
FUJITSU Storage ETERNUS DX Configuration Guide -Server Connection- (FCoE) for Linux
Copyright 2018 FUJITSU LIMITED
P3AM-6402-11ENZ0

Creating an Initial RAM Disk
Create an initial RAM disk to match the kernel being used.
•"1.5 Creating an Initial RAM Disk" (page 10)
Now proceed to the next workflow described in "Connecting the Server to the ETERNUS DX storage sys-
tems" of the "Configuration Guide -Server Connection- (FCoE) for Linux".
1.2 Setting Up the Converged Network Adapter Cards
Install the Converged Network Adapter card to the server, and acquire the physical address and World Wide
Name (WWN) for the Converged Network Adapter card.
•The physical address and WWN of a Converged Network Adapter card are required information in the fol-
lowing cases: when an error has occurred in the system, when using the ETERNUS DX storage systems (se-
curity function, host affinity function, etc.) to restrict server access, or when connecting the ETERNUS DX
storage systems and the server using a Fibre Channel switch and a CEE/FCoE switch.
•Acquire the physical address and WWN when installing the Converged Network Adapter card, because the
relationship between a physical address and WWN cannot be determined from BIOS and OS. Physical ad-
dress and WWN must be assigned to "WWN instance management table for the server".
The workflow is shown below.
(1) Install the Converged Network Adapter card
(2) Turn on the server
(3) Acquire the physical address and WWN for the Converged Network Adapter card
(4) Add a record for the server in the WWN instance management table for the server
When installing two or more Converged Network Adapter cards in the server, first turn off the server, then
repeat Steps (1) through (4) above for each Converged Network Adapter card to be installed.
The procedure is as follows:
1Install the Converged Network Adapter card in the server.
For the installation method, slot positions, activation of the installed slot, and notes regarding the Con-
verged Network Adapter card, refer to the Converged Network Adapter card documentation or the User's
Guide of the server.
Chapter 1 Setup Procedure for Emulex Converged Network Adapter Cards
1.2 Setting Up the Converged Network Adapter Cards
6
FUJITSU Storage ETERNUS DX Configuration Guide -Server Connection- (FCoE) for Linux
Copyright 2018 FUJITSU LIMITED
P3AM-6402-11ENZ0

2Turn on the server, and press the [Alt] + [E] keys or [Ctrl] + [E] keys while the following message is
displayed.
!!! Emulex OneConnect FCoE BIOS !!!, Version 4.01a0
Copyright (c) 1997-2010 Emulex. All rights reserved.
Press <Alt E> or <Ctrl E> to enter Emulex BIOS configuration
utility. Press <s> to skip Emulex BIOS
Emulex OneConnect FCoE BIOS Utility starts.
3Select the Converged Network Adapter card from which information is to be obtained with the [h] and
[i] keys. Press the [Enter] key.
4Check the [Mem Base] and [Port Name] values.
The value of [Mem Base] is the physical address and the value of [Port Name] is the Converged Net-
work Adapter card WWN.
Emulex OneConnect FCoE BIOS Utility, XB4.01a0
01: OCe10102-FM Bus#: 09 Dev#: 00 Func#: 02
Mem Base: F94C0000 Firmware Version: 2.702.200.17 BIOS: Disabled!
Port Name: 10000000C99CDD9B Node Name: 20000000C99CDD9B
Vlan ID: 1002 DCBX mode: CEE mode
Physical address
Converged Network Adapter card WWN
5Record the physical address and WWN in the "WWN instance management table for the server".
Refer to "Appendix A WWN Instance Management Table for the Server (Blank)" (page 19).
The following shows an example of this.
WWN instance management table for the server
Host name
IP Address
Physical slot
name
Converged Network Adapter
card WWN Instance name Physical address Cable tag
slot0 10 00 00 00 C9 9C DD 9B F94C0000
Details of contents
The details of contents for the WWN instance management table for the server are as follows:
Host name:
Record the host name.
IP Address:
Record the IP address of the server.
Physical slot name:
Record the slot position of installed Converged Network Adapter card.
For the installation location, refer to the User's Guide for each server.
Converged Network Adapter card WWN:
Record the [Port Name] value. This value can be confirmed in Step 4.
Chapter 1 Setup Procedure for Emulex Converged Network Adapter Cards
1.2 Setting Up the Converged Network Adapter Cards
7
FUJITSU Storage ETERNUS DX Configuration Guide -Server Connection- (FCoE) for Linux
Copyright 2018 FUJITSU LIMITED
P3AM-6402-11ENZ0

Instance name:
Not necessary to record.
Physical address:
Record the [Mem Base] value. This value can be confirmed in Step 4.
Cable tag:
Record a tag name which indicates the connection path (relationship between the connected device
and the port).
6Press the [Esc] key to quit the Emulex OneConnect FCoE BIOS Utility.
When installing two or more Converged Network Adapter cards to the server, first turn off the server,
then repeat Step 1 through Step 6 shown here for each Converged Network Adapter card to be installed.
If multiple Converged Network Adapter cards are already installed in the server at the time of pur-
chase, the one-to-one relationship between the WWNs and the Converged Network Adapter cards
cannot be recognized. The WWNs that are obtained in this section may need to be repeatedly regis-
tered and set up on the ETERNUS DX until a server recognizes the ETERNUS DX logical disks.
For details about ETERNUS DX settings, refer to "Configuration Guide -Server Connection- Storage Sys-
tem Settings" that corresponds to the ETERNUS DX to be connected.
1.3 Installing the Converged Network Adapter Card Driver
Check whether the Converged Network Adapter card driver is the OS standard driver or not. If the Converged
Network Adapter card requires a non-standard driver, check the driver versions using the "Server Support Ma-
trix".
•When the Converged Network Adapter card requires a standard kernel package driver
The standard add-on driver for the OS should be used.
•When the Converged Network Adapter card requires a non-standard driver
Download and install the driver specified in the "Server Support Matrix" from the Emulex Corp. web-site.
Installation of applications, such as OneCommand Manager, is also required. Refer to the Emulex Con-
verged Network Adapter card manual for details on the installation method.
1.4 Setting Up the Driver Parameters
Use an editor such as "vi" to add the setting values to the configuration file.
Note that the setting values and details vary depending on the OS vender, version, whether the ETERNUS
Multipath Driver is used, and the storage system that is used.
Chapter 1 Setup Procedure for Emulex Converged Network Adapter Cards
1.3 Installing the Converged Network Adapter Card Driver
8
FUJITSU Storage ETERNUS DX Configuration Guide -Server Connection- (FCoE) for Linux
Copyright 2018 FUJITSU LIMITED
P3AM-6402-11ENZ0

•Configuration file
OS Configuration file
Red Hat Enterprise Linux 7 Any file (.conf) in /etc/modprobe.d/
Red Hat Enterprise Linux 6 Any file (.conf) in /etc/modprobe.d/
Red Hat Enterprise Linux 5 /etc/modprobe.conf
SUSE Linux Enterprise Server 12 Any file (.conf) in /etc/modprobe.d/
SUSE Linux Enterprise Server 11 /etc/modprobe.conf.local
SUSE Linux Enterprise Server 10 /etc/modprobe.conf.local
If the same driver parameter is already set in the configuration file, only the value for the parameter
must be changed.
•Setting details
In the following tables, "N" indicates the value of the driver parameter setting.
-When the ETERNUS Multipath Driver is used
OS Setting details
Red Hat Enterprise Linux 7 Not required
Red Hat Enterprise Linux 6 Not required
Red Hat Enterprise Linux 5 options scsi_mod max_luns=512
SUSE Linux Enterprise Server 12
SUSE Linux Enterprise Server 11
SUSE Linux Enterprise Server 10
-When the ETERNUS Multipath Driver is not used
OS Setting details
Red Hat Enterprise Linux 7 options lpfc lpfc_lun_queue_depth=N
Red Hat Enterprise Linux 6 options lpfc lpfc_lun_queue_depth=N
Red Hat Enterprise Linux 5 options scsi_mod max_luns=512
options lpfc lpfc_lun_queue_depth=N
SUSE Linux Enterprise Server 12
SUSE Linux Enterprise Server 11
SUSE Linux Enterprise Server 10
•Driver parameter settings
Driver parameter When the ETERNUS Multipath Driver
is used
When the ETERNUS Multipath Driver
is not used
lpfc_lun_queue_depth= Do not set Arbitrary (*1)
(Up to 1024 for each FCoE port of the
ETERNUS DX)
*1: Recommended value = 1024 ¸ (number of FCoE ports that are connected to a single CA port) ¸ num-
ber of LUNs
(Round the result down)
Chapter 1 Setup Procedure for Emulex Converged Network Adapter Cards
1.4 Setting Up the Driver Parameters
9
FUJITSU Storage ETERNUS DX Configuration Guide -Server Connection- (FCoE) for Linux
Copyright 2018 FUJITSU LIMITED
P3AM-6402-11ENZ0

-Use the value of "8" if the actual result is lower. Use the maximum value if the actual result exceeds
the maximum value for the driver.
-To achieve maximum system performance, this value can be changed according to the server load
and the peak operating times.
-The number of simultaneous command executions per CA port for the ETERNUS DX is limited to
1024. This value is used by multiple servers that share the CA port. A maximum of 1024 commands
can be executed per CA port.
1.5 Creating an Initial RAM Disk
Create an initial RAM disk image file to match the kernel being used. Refer to the Emulex Converged Network
Adapter card manual for details on the creation method.
1.6 Rebooting the OS
Reboot the OS. When the Converged Network Adapter card requires a non-standard driver, check the files in
"/var/log/messages" and confirm that the correct version of the Converged Network Adapter card driver has
been installed after rebooting the OS.
Chapter 1 Setup Procedure for Emulex Converged Network Adapter Cards
1.5 Creating an Initial RAM Disk
10
FUJITSU Storage ETERNUS DX Configuration Guide -Server Connection- (FCoE) for Linux
Copyright 2018 FUJITSU LIMITED
P3AM-6402-11ENZ0