Product SiteDocumentation Site

5.4.9. Installation Destination - Specialized & Network Disks

This part of the Installation Destination screen allows you to configure non-local storage devices, namely iSCSI and FCoE storage. This section will mostly be useful to advanced users who have a need for networked disks. For instructions on setting up local hard drives, see Section 5.4.8, “Installation Destination”.

Important

This section only explains how to make existing network disks available inside the installer. It does not explain how to set up your network or a storage server, only how to connect to them.
Installation Destination - Network Storage Filters
A list of currently configured network storage devices, displaying one configured iSCSI target.
Figure 5.15. Installation Destination - Network Storage Filters

The screen contains a list of all currently available (discovered) network storage devices. When the screen is opened for the first time, the list will be empty in most cases because no network storage has been discovered - the installer makes no attempt at discovering this unless you configure network disks using a Kickstart file.
To add one or more storage devices to the screen so you can search them and use them in the installation, click Add iSCSI Target or Add FCoE SAN in the bottom right corner of the screen, and follow the instructions in Section 5.4.9.1, “Add iSCSI Target” or Section 5.4.9.2, “Add FCoE SAN”, depending on which type of network storage you want to add.
Network storage devices successfully discovered and configured by the installer will then be displayed in the main list, along with identifying information such as Name, WWID, Model and Target. To sort the list by a specific column (for example WWID), click the column's heading.

Note

On lower display resolutions, the list may be too wide to fit on the screen, and some of the columns or buttons may be hidden initially. Use the horizontal scroll bar at the bottom of the list to move your view and see all available table columns and controls.
There are three tabs on the top of the list, which display different information:
Search
Displays all available devices, regardless of their type, and allows you to filter them either by their World Wide Identifier (WWID) or by the port, target, or logical unit number (LUN) at which they are accessed.
Multipath Devices
Storage devices accessible through more than one path, such as through multiple SCSI controllers or Fiber Channel ports on the same system.

Important

The installation program only detects multipath storage devices with serial numbers that are 16 or 32 characters long.
Other SAN Devices
Devices available on a Storage Area Network (SAN).
Depending on the tab you are currently in, you can filter the discovered devices by using the Filter By field. Some of the filtering options are automatically populated based on discovered devices (for example, if you select Filter By: Vendor, another drop-down menu will appear showing all vendors of all discovered devices). Other filters require your input (for example when filtering by WWID), and present you with a text input field instead of a drop-down menu.
In the list (regardless of how it is filtered), each device is presented on a separate row, with a check box to its left. Mark the check box to make the device available during the installation process; this will cause this device (node) to be shown in the Specialized & Network Disks section in Section 5.4.8, “Installation Destination”. There, you can select the disk as an installation target and proceed with either manual or automatic partitioning.

Note

Devices that you select here are not automatically wiped by the installation process. Selecting a device on this screen does not, in itself, place data stored on the device at risk. Also note that any devices that you do not select here to form part of the installed system can be added to the system after installation by modifying the /etc/fstab file.
When you have selected the storage devices to make available during installation, click Done to return to Section 5.4.8, “Installation Destination”.

5.4.9.1. Add iSCSI Target

To use iSCSI storage devices, the installer must be able to discover them as iSCSI targets and be able to create an iSCSI session to access them. Both of these steps may require a user name and password for Challenge Handshake Authentication Protocol (CHAP) authentication.
You can also configure an iSCSI target to authenticate the iSCSI initiator on the system to which the target is attached (reverse CHAP), both for discovery and for the session. Used together, CHAP and reverse CHAP are called mutual CHAP or two-way CHAP. Mutual CHAP provides the greatest level of security for iSCSI connections, particularly if the user name and password are different for CHAP authentication and reverse CHAP authentication.
Follow the procedure below to add an iSCSI storage target to your system.
Procedure 5.1. Add iSCSI Target
  1. Click the Add iSCSI Target button in the bottom right corner of the Section 5.4.9, “Installation Destination - Specialized & Network Disks” screen. A new dialog window titled Add iSCSI Storage Target will open.
  2. Enter the IP address of the iSCSI target in the Target IP Address field.
  3. Provide a name in the iSCSI Initiator Name field for the iSCSI initiator in iSCSI Qualified Name (IQN) format. A valid IQN entry contains:
    • The string iqn. (including the period).
    • A date code specifying the year and month in which your organization's Internet domain or subdomain name was registered, represented as four digits for the year, a dash, and two digits for the month, followed by a period. For example, represent September 2010 as 2010-09.
    • Your organization's Internet domain or subdomain name, presented in reverse order (with the top-level domain first). For example, represent the subdomain storage.example.com as com.example.storage.
    • A colon (:) followed by a string which uniquely identifies this particular iSCSI initiator within your domain or subdomain. For example, :diskarrays-sn-a8675309
    A complete IQN will therefore look as follows:
    iqn.2010-09.com.example.storage:diskarrays-sn-a8675309
    An example using the correct format is also displayed below the input field for reference.
    For more information about IQNs, see 3.2.6. iSCSI Names in RFC 3720 - Internet Small Computer Systems Interface (iSCSI), available from http://tools.ietf.org/html/rfc3720#section-3.2.6 and 1. iSCSI Names and Addresses in RFC 3721 - Internet Small Computer Systems Interface (iSCSI) Naming and Discovery, available from http://tools.ietf.org/html/rfc3721#section-1.
  4. Specify the type of authentication to use for iSCSI discovery using the Discovery Authentication Type drop-down menu. Depending on which type of authentication you selected, additional input fields (such as CHAP Username and CHAP Password may then become visible. Fill in your authentication credentials; these should be provided by your organization.
  5. Click the Start Discovery button. The installer will now attempt to discover an iSCSI target based on the information you provided, and if the target requires CHAP or reverse CHAP authentication, it will attempt to use the credentials you provided. This process may take some time (generally less than 30 seconds), depending on your network.
    If the discovery was not successful, an error message will be displayed in the dialog window. This message will vary based on which part of the discovery failed. If the installer did not find the target you specified at all, you should check the IP address; if the problem is an authentication error, make sure you entered all CHAP and reverse CHAP credentials correctly and that you have access to the iSCSI target.

    Note

    The No nodes discovered error message may also mean that all nodes on the address you specified are already configured. During discovery, Anaconda ignores nodes which have already been added.
    If the discovery was successful, you will see a list of all discovered nodes.
  6. Select one or more nodes you want to log in to by marking or unmarking the check box next to each node discovered on the target. Below the list, select again the type of authentication you want to use; you can also select the Use the credentials from discovery option if the CHAP/reverse CHAP user name and password you used to discover the target are also valid for logging in to it.
    After selecting all nodes you want to use, click Log In to initiate an iSCSI session. Anaconda will attempt to log in to all selected nodes. If the login process is succesful, the Add iSCSI Storage Target dialog will close, and all nodes you have configured will now be shown in the list of network disks in Section 5.4.9, “Installation Destination - Specialized & Network Disks”.
You can repeat this procedure to discover additional iSCSI targets, or to add more nodes from a previously configured target. However, note that once you click the Start Discovery button for the first time, you will not be able to change the iSCSI Initiator Name. If you made an error when configuring the initiator name, you must restart the installation.