2.9 iSCSI Boot Information

The XML definition of the iSCSI boot information is shown below.

<?xml version="1.0" encoding="utf-8"?>
<Storage>
  <Pool name="Storage pool name"/>
  <Ports>
   <Port index="Storage port index number" ip="IP address[:iSCSI Communication port number]" iqn="IQN name"/>
   <Port index="Storage port index number" ip="IP address[:iSCSI Communication port number]" iqn="IQN name"/>
  </Ports>
  <Disks>
   <Disk name="Disk name">
    <DiskSize>Disk Size</DiskSize>
    <Server>
     <Nics>
      <Nic ip="IP address" iqn="IQN Name" portindex="Storage port Index number"/>
      <Nic ip="IP address" iqn="IQN Name" portindex="Storage port Index number"/>
     </Nics>
     <Chap user="User name authentication" password="Authentication password"/>
     <MutualChap password="Mutual authentication password"/>
    </Server>
   </Disk>
   <Disk name="Disk resource name">
    ...
   </Disk>
  </Disks>
 </Storage>

Table 2.12 List of Items Specified in XML Definitions for iSCSI Boot Information
Element Name	Description	Remarks (Possible Values, Examples)
Storage pool name (Pool name)	Storage pool name for disk registration	Resource name of created storage pool If there are storage pools with the same name on different levels, the level must also be specified. Folder/Pool
Storage Port Index Number (*1) (Port index)	Index number to specify the storage port	Integer starting from 0 Specify a number between 0 and 999. Smaller index numbers are managed on the primary side of iSCSI boot.
Storage port IP address (Port ip)	Storage port IP address	Specify the items in the following format. IP_address[:iSCSI Communication_port_number] iSCSI Communication_port_number specifies an integer between 1024 and 65535. If omitted, 3260 is set.
Storage port IQN name (Port iqn)	Storage port IQN name	Character string beginning and ending with an alphanumeric character and containing up to 223 alphanumeric characters, colons (":"), hyphens ("-"), and periods (".")
Disk name (Disk name)	Disk name to register in the storage pool	Character string beginning with an alphanumeric character and containing up to 32 alphanumeric characters, underscores ("_"), and hyphens ("-")
Disk size (*2) (DiskSize)	Disk size to register in the storage pool	A number with up to one decimal place, in units of gigabytes For details on the scope which can be specified, refer to "Size" in "D.3.1 When "Physical" is Selected for [Server type]" or "D.3.2 When "VM" is Selected for [Server type]" of the "ServerView Resource Orchestrator User's Guide".
Server IP address (Nic ip)	IP address of the server to use iSCSI boot	Specify the IP address.
Server IQN name (Nic iqn)	IQN name of the server to use iSCSI boot	Character string beginning and ending with an alphanumeric character and containing up to 223 alphanumeric characters, colons (":"), hyphens ("-"), and periods (".") For multipath configurations, the same IQN name must be specified for the same server.
Storage port index number which is connected to a server (1, 3) (Nic portindex)	Storage port index number which is connected to a NIC of a server to use iSCSI boot	Integer starting from 0 Specify a number between 0 and 999.
User name for authentication (Chap user)	User name for CHAP authentication (optional)	User name consisting of alphanumeric characters or symbols containing from 1 to 127 characters (ASCII characters (0x20 to 0x7e)) If left blank, the authentication password cannot be specified.
Authentication password (Chap password)	Authentication password for CHAP (optional)	User name consisting of alphanumeric characters or symbols containing from 12 to 16 characters (ASCII characters (0x20 to 0x7e)) If a user name for authentication is specified, this setting cannot be omitted.
Mutual authentication password (MutualChap password)	Password for mutual authentication (optional)	User name consisting of alphanumeric characters or symbols containing from 12 to 16 characters (ASCII characters (0x20 to 0x7e)) If a user name for authentication is omitted, this setting cannot be specified.

*1: If the Index number of a storage port is the same as the one connected to a server, a physical connection is required.
*2: Register the actual LUN size in the iSCSI boot information. If it differs, the actual size of the LUN will be enabled from the server.
*3: The NIC Index specified in the iSCSI boot network definition file must be connected in the ascending order of the specified numbers.

Example

The definition when portindex=0 with NIC1, and portindex=2 with NIC2 are connected is shown below.

Specifying a storage definition file for iSCSI boot
<Nic ... portindex="0"/>
<Nic ... portindex="2"/>
Specifying a network definition file for iSCSI boot
chassis_model.BX900.boot_nic = NIC1,NIC2

Example

<?xml version="1.0" encoding="utf-8"?>
<Storage>
  <Pool name="StoragePool" />
  <Ports>
    <Port index="0" ip="192.168.0.1" iqn="iqn.2010-03.com.fujitsu:iscsi:storage-0" />
    <Port index="1" ip="192.168.0.2" iqn="iqn.2010-03.com.fujitsu:iscsi:storage-1" />
  </Ports>
  <Disks>
    <Disk name="disk-01">
      <DiskSize>10</DiskSize>
      <Server>
        <Nics>
          <Nic portindex="0" ip="192.168.0.10" iqn="iqn.2010-03.com.fujitsu:iscsi:server-01" />
          <Nic portindex="1" ip="192.168.0.11" iqn="iqn.2010-03.com.fujitsu:iscsi:server-01" />
        </Nics>
        <Chap user="root" password="passwordpassword" />
      </Server>
    </Disk>
    <Disk name="disk-02">
      <DiskSize>10</DiskSize>
      <Server>
        <Nics>
          <Nic portindex="0" ip="192.168.0.20" iqn="iqn.2010-03.com.fujitsu:iscsi:server-02" />
          <Nic portindex="1" ip="192.168.0.21" iqn="iqn.2010-03.com.fujitsu:iscsi:server-02" />
        </Nics>
      </Server>
    </Disk>
  </Disks>
</Storage>