25.13. 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: [5]
#iscsiadm -m discovery -t discovery_type -p target_IP:port -o delete
Here, discovery_type can be either
sendtargets, isns, or fw.
For details on different types of discovery, refer to the DISCOVERY TYPES section of the iscsiadm(8) man page.
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 to the iscsiadm(8) man page for more information on available setting options and valid value options for each.
After configuring discovery settings, any subsequent attempts to discover new targets will use the new settings. Refer to Section 25.15, “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.
[5]
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 25.7.1, “iSCSI API” and Section 25.15, “Scanning iSCSI Interconnects”.
