21.11.4. Binding/Unbinding an iface to a Portal
Whenever iscsiadm
is used to scan for interconnects, it will first check the iface.transport
settings of each iface
configuration in /var/lib/iscsi/ifaces
. The iscsiadm
utility will then bind discovered portals to any iface
whose iface.transport
is tcp
.
This behavior was implemented for compatibility reasons. To override this, use the -I iface_name
to specify which portal to bind to an iface
, as in:
iscsiadm -m discovery -t st -p target_IP:port
-I iface_name
-P 1
[]
By default, the iscsiadm
utility will not automatically bind any portals to iface
configurations that use offloading. This is because such iface
configurations will not have iface.transport
set to tcp
. As such, the iface
configurations of Chelsio, Broadcom, and ServerEngines ports need to be manually bound to discovered portals.
It is also possible to prevent a portal from binding to any existing iface
. To do so, use default
as the iface_name
, as in:
iscsiadm -m discovery -t st -p IP:port
-I default -P 1
To remove the binding between a target and iface
, use:
iscsiadm -m node -targetname proper_target_name
-I iface0 --op=delete
[]
To delete all bindings for a specific iface
, use:
iscsiadm -m node -I iface_name
--op=delete
To delete bindings for a specific portal (e.g. for Equalogic targets), use:
iscsiadm -m node -p IP:port
-I iface_name
--op=delete
If there are no iface
configurations defined in /var/lib/iscsi/iface
and the -I
option is not used, iscsiadm
will allow the network subsystem to decide which device a specific portal should use.