1.9. iSCSI Discovery Configuration
The default iSCSI configuration file is
/etc/iscsi/iscsid.conf. This file contains iSCSI settings used by iscsid and iscsiadm.
During target discovery, the
iscsiadm tool uses the settings in /etc/iscsi/iscsid.conf to create two types of records:
- Node records in
/var/lib/iscsi/nodes - When logging into a target,
iscsiadmuses the settings in this file. - Discovery records in
/var/lib/iscsi/discovery_type - When performing discovery to the same destination,
iscsiadmuses the settings in this file.
Before using different settings for discovery, delete the current discovery records (i.e.
/var/lib/iscsi/discovery_type) first. To do this, use the following command:
iscsiadm -m discovery -t discovery_type -p target_IP:port -o delete[1]
There are two ways to reconfigure discovery record settings:
- Edit the
/etc/iscsi/iscsid.conffile directly prior to performing a discovery. Discovery settings use the prefixdiscovery; to view them, run:iscsiadm -m discovery -t discovery_type -p target_IP:port - Alternatively,
iscsiadmcan also be used to directly change discovery record settings, as in:iscsiadm -m discovery -t discovery_type -p target_IP:port -o update -n setting -v %valueRefer toman iscsiadmfor more information on availablesettings and validvalues for each.
After configuring discovery settings, any subsequent attempts to discover new targets will use the new settings. Refer to Section 1.11, “Scanning iSCSI Interconnects” for details on how to scan for new iSCSI targets.
For more information on configuring iSCSI target discovery, refer to the
man pages of iscsiadm and iscsid. The /etc/iscsi/iscsid.conf file also contains examples on proper configuration syntax.
[1]
The
target_IP and port variables refer to the IP address and port combination of a target/portal, respectively. For more information, refer to Section 1.2.1, “iSCSI API” and Section 1.11, “Scanning iSCSI Interconnects”.
[2]
For details on different types of discovery, refer to the DISCOVERY TYPES section of
man iscsiadm.
