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 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.

   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 Add iSCSI Target or 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
   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 Installation
   Destination.

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 1. Add iSCSI Target
    1. Click the Add iSCSI Target button in the bottom right
       corner of the 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 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.

Add FCoE SAN

   The following procedure explains how to add Fibre Channel over
   Ethernet (FCoE) storage devices and make them available during
   the installation:

   Procedure 2. Add FCoE Target
    1. Click the Add FCoE SAN button in the bottom right corner of
       Installation Destination - Specialized & Network Disks. A
       new dialog window will open.
    2. Select the network interface (NIC) which is connected to
       your FCoE switch from the drop-down menu. Note that this
       network interface must be configured and connected - see
       Network & Hostname.
    3. Below the NIC drop-down menu are two choices:

        Use DCB
                Data Center Bridging (DCB) is a set of
                enhancements to the Ethernet protocols designed to
                increase the efficiency of Ethernet connections in
                storage networks and clusters. This option should
                only be enabled for network interfaces that
                require a host-based DCBX client. Configurations
                on interfaces that implement a hardware DCBX
                client should leave this check box empty.

        Use auto vlan
                This option indicates whether VLAN discovery
                should be performed. If this box is checked, then
                the FCoE Initiation Protocol (FIP) VLAN discovery
                protocol will run on the Ethernet interface once
                the link configuration has been validated. If they
                are not already configured, network interfaces for
                any discovered FCoE VLANs will be automatically
                created and FCoE instances will be created on the
                VLAN interfaces. This option is enabled by
                default.

    4. After you select which interface and options to use, click
       Add FCoE Disk(s). Discovered FCoE storage devices will be
       displayed under the Other SAN Devices tab in Installation
       Destination - Specialized & Network Disks.
