Top
ServerView Resource Orchestrator Cloud Edition V3.1.1 Reference Guide (Command/XML)
ServerView

15.4.2 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="Server IP Address" iqn="Server IQN Name" portindex="Storage port Index number connected from server"/>
      <Nic ip="Server IP Address" iqn="Server IQN Name" portindex="Storage port Index number connected from server"/>
     </Nics>
     <Chap user="User Name Authentication" password="Authentication Password"/>
     <MutualChap password="Mutual Authentication Password"/>
    </Server>
   </Disk>
   <Disk name="Disk Name">
    ...
   </Disk>
  </Disks>
 </Storage>
Table 15.8 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

Specify the resource name of an existing storage pool.

If there are storage pools with the same name on different levels, the level must also be specified.

Resource_folder_name/Resource_pool_name

Storage port index number (*1)

(Port index)

Index number to specify the storage port

Specify an 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]

Specify an integer between 1,024 and 65,535 for iSCSI Communication_Port_Number. If left blank, "3,260" is set.

Storage port IQN name

(Port iqn)

Storage port IQN name

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

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

Specify a number with up to one decimal place, in units of gigabytes.

For details on the scope which can be specified, refer to "16.2.3 [Disk] Tab" in the "User's Guide for Infrastructure Administrators (Resource Management) CE".

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

Specify a 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 connected from the server (*1, *3)

(Nic portindex)

Storage port index number which is connected to a NIC of a server to use iSCSI boot

Specify an integer starting from "0".

Specify a number between 0 and 999.

User name authentication

(Chap user)

User name for CHAP authentication

(optional)

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

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

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