|
Packit |
eace71 |
#
|
|
Packit |
eace71 |
# Example iSCSI interface config
|
|
Packit |
eace71 |
#
|
|
Packit |
eace71 |
# There must be a separate iscsi interface config file for each NIC, network
|
|
Packit |
eace71 |
# interface or port or iscsi HBA you want to bind sessions to.
|
|
Packit |
eace71 |
#
|
|
Packit |
eace71 |
# For hardware iscsi, this is created for you when you run iscsiadm.
|
|
Packit |
eace71 |
# For software iscsi, you must define these files yourself.
|
|
Packit |
eace71 |
#
|
|
Packit |
eace71 |
|
|
Packit |
eace71 |
# REQUIRED: iface.transport_name
|
|
Packit |
eace71 |
#
|
|
Packit |
eace71 |
# Set the iscsi transport/driver to use for the iface by setting
|
|
Packit |
eace71 |
# iface.transport_name
|
|
Packit |
eace71 |
# example:
|
|
Packit |
eace71 |
# iface.transport_name = tcp
|
|
Packit |
eace71 |
|
|
Packit |
eace71 |
# This value is required and valid values for iface.transport_name are:
|
|
Packit |
eace71 |
# - tcp (Software iSCSI over TCP/IP)
|
|
Packit |
eace71 |
# - iser (Software iSCSI over infinniband
|
|
Packit |
eace71 |
# - qla4xxx (Qlogic QLA4XXX HBAs)
|
|
Packit |
eace71 |
# - bnx2i (Broadcom bnx iSCSI HBAs);
|
|
Packit |
eace71 |
# - cxgb3i (Chelsio cxgb S3 iSCSI HBAs);
|
|
Packit |
eace71 |
#
|
|
Packit |
eace71 |
#OPTIONAL: iface.initiatorname
|
|
Packit |
eace71 |
# To use an initiator name other than the one set in
|
|
Packit |
eace71 |
# /etc/iscsi/initiatorname.iscsi for normal sessions set the
|
|
Packit |
eace71 |
# iface.initiatorname. This is only used for normal sessions.
|
|
Packit |
eace71 |
# For discovery sessions the /etc/iscsi/initiatorname.iscsi value
|
|
Packit |
eace71 |
# is used.
|
|
Packit |
eace71 |
#
|
|
Packit |
eace71 |
# iface.initiatorname = iqn.2003-04.com.fedora:test
|
|
Packit |
eace71 |
#
|
|
Packit |
eace71 |
#
|
|
Packit |
eace71 |
# REQUIRED to be able to bind a session to a network device:
|
|
Packit |
eace71 |
# [iface.net_ifacename | iface.hwaddress]
|
|
Packit |
eace71 |
#
|
|
Packit |
eace71 |
# OPTIONAL if you are creating ifaces so you can create multiple sessions
|
|
Packit |
eace71 |
# using the default behavior where the network layer selects the device.
|
|
Packit |
eace71 |
#
|
|
Packit |
eace71 |
# __One__ of the following values are required for binding a session
|
|
Packit |
eace71 |
# to a specific nic/netdevice.
|
|
Packit |
eace71 |
#
|
|
Packit |
eace71 |
# To bind by network interface name (example: eth0, eth2:2, eth1.3)
|
|
Packit |
eace71 |
# set iface.net_ifacename
|
|
Packit |
eace71 |
# example:
|
|
Packit |
eace71 |
# iface.net_ifacename = eth0
|
|
Packit |
eace71 |
|
|
Packit |
eace71 |
# To bind by hardware address set the NIC's MAC address to iface.hwaddress
|
|
Packit |
eace71 |
# example:
|
|
Packit |
eace71 |
# iface.hwaddress = 00:0F:1F:92:6B:BF
|
|
Packit |
eace71 |
|
|
Packit |
eace71 |
# Note you can only bind using one value. If you set multiple values
|
|
Packit |
eace71 |
# the bahavior is not defined.
|
|
Packit |
eace71 |
|
|
Packit |
eace71 |
# For some transport (cxgb3i), a user could to set the private ip address for
|
|
Packit |
eace71 |
# the iscsi traffic for an network interface:
|
|
Packit |
eace71 |
# example:
|
|
Packit |
eace71 |
# - set iscsi ip on eth0 to be 102.50.50.101, eth0 needs to be up and be on
|
|
Packit |
eace71 |
# the same subnet.
|
|
Packit |
eace71 |
# iface.net_ifacename = eth0
|
|
Packit |
eace71 |
# iface.ipaddress = 102.50.50.101
|
|
Packit |
eace71 |
|
|
Packit |
eace71 |
# OPTIONAL: iface.bootproto
|
|
Packit |
eace71 |
#
|
|
Packit |
eace71 |
# Valid values are:
|
|
Packit |
eace71 |
# "dhcp" and "static"
|
|
Packit |
eace71 |
#
|
|
Packit |
eace71 |
# REQUIRED when IPv4 address need to be obtained dynamically using DHCP
|
|
Packit |
eace71 |
# example:
|
|
Packit |
eace71 |
# iface.bootproto = dhcp
|
|
Packit |
eace71 |
#
|
|
Packit |
eace71 |
# OPTIONAL when the IPv4 address is set statically
|
|
Packit |
eace71 |
# example:
|
|
Packit |
eace71 |
# iface.ipaddress = 102.50.50.101
|
|
Packit |
eace71 |
# iface.bootproto = static
|
|
Packit |
eace71 |
#
|
|
Packit |
eace71 |
|
|
Packit |
eace71 |
# OPTIONAL: iface.vlan_id
|
|
Packit |
eace71 |
# Used to set the VLAN ID for the iSCSI interfae.
|
|
Packit |
eace71 |
# example
|
|
Packit |
eace71 |
# iface.vlan_id = 1022
|
|
Packit |
eace71 |
|
|
Packit |
eace71 |
# OPTIONAL: iface.vlan_priority
|
|
Packit |
eace71 |
# Used to set the VLAN priority for the iSCSI interfae.
|
|
Packit |
eace71 |
# example
|
|
Packit |
eace71 |
# iface.vlan_priority = 1
|
|
Packit |
eace71 |
|
|
Packit |
eace71 |
# OPTIONAL: iface.vlan_state
|
|
Packit |
eace71 |
# Used to enable or disable the VLAN on the iSCSI interface
|
|
Packit |
eace71 |
# example
|
|
Packit |
eace71 |
# iface.vlan_state = enable
|
|
Packit |
eace71 |
|
|
Packit |
eace71 |
# OPTIONAL: iface.ipv6_linklocal
|
|
Packit |
eace71 |
# Specify the IPV6 Link Local Address with the
|
|
Packit |
eace71 |
# link local prefix of FE80::0/64
|
|
Packit |
eace71 |
# example:
|
|
Packit |
eace71 |
# iface.ipv6_linklocal = fe80:0000:0000:0000:020e:1eff:1111:2221
|
|
Packit |
eace71 |
|
|
Packit |
eace71 |
# OPTIONAL: iface.ipv6_router
|
|
Packit |
eace71 |
# Used to set a default IPV6 router
|
|
Packit |
eace71 |
# example:
|
|
Packit |
eace71 |
# iface.ipv6_router = fe80:0000:0000:0000:7ae7:d1ff:fe72:4048
|
|
Packit |
eace71 |
|
|
Packit |
eace71 |
# OPTIONAL: iface.ipv6_autocfg
|
|
Packit |
eace71 |
# Used to set the discovery protocol to obtain IPV6 address
|
|
Packit |
eace71 |
# For example qla4xxx support neighbor discovery
|
|
Packit |
eace71 |
# example:
|
|
Packit |
eace71 |
# iface.ipv6_autocfg = nd
|
|
Packit |
eace71 |
|
|
Packit |
eace71 |
# OPTIONAL: iface.linklocal_autocfg
|
|
Packit |
eace71 |
# For transport like qla4xxx this allows to auto configure the
|
|
Packit |
eace71 |
# IPV6 link local address based on the MAC address of the iSCSI
|
|
Packit |
eace71 |
# interface
|
|
Packit |
eace71 |
|
|
Packit |
eace71 |
# OPTIONAL: iface.router_autocfg
|
|
Packit |
eace71 |
# Required to set the IPv6 router discovery protocol
|
|
Packit |
eace71 |
# To set the router discovery protocol to Neighbor Discovery specify "nd"
|
|
Packit |
eace71 |
# example:
|
|
Packit |
eace71 |
# iface.router_autocfg = nd
|
|
Packit |
eace71 |
|
|
Packit |
eace71 |
# OPTIONAL: iface.state
|
|
Packit |
eace71 |
# By default the iface is enabled
|
|
Packit |
eace71 |
# iface.state = enable
|
|
Packit |
eace71 |
# To disable the iface set the state to "disable"
|
|
Packit |
eace71 |
# iface.state = disable
|
|
Packit |
eace71 |
|
|
Packit |
eace71 |
# iface.iface_num
|
|
Packit |
eace71 |
# REQUIRED: When there are more than 1 interface to be configured.
|
|
Packit |
eace71 |
# For transports like qla4xxx, one can specify two IPV6 interfaces
|
|
Packit |
eace71 |
# in such case the iface_num must be set correctly
|
|
Packit |
eace71 |
# example:
|
|
Packit |
eace71 |
# iface settings for first IPV6 interface
|
|
Packit |
eace71 |
# iface.iscsi_ifacename = iface-qla4xxx-ipv6-1
|
|
Packit |
eace71 |
# iface.iface_num = 0
|
|
Packit |
eace71 |
#
|
|
Packit |
eace71 |
# iface settings for second IPV6 interface
|
|
Packit |
eace71 |
# iface.iscsi_ifacename = iface-qla4xxx-ipv6-2
|
|
Packit |
eace71 |
# iface.iface_num = 1
|
|
Packit |
eace71 |
|
|
Packit |
eace71 |
# Here are some example iface files
|
|
Packit |
eace71 |
# IPV4 sample config file with static IP address:
|
|
Packit |
eace71 |
# BEGIN RECORD 2.0-872
|
|
Packit |
eace71 |
# iface.iscsi_ifacename = qla4xxx-3
|
|
Packit |
eace71 |
# iface.ipaddress = 192.168.1.75
|
|
Packit |
eace71 |
# iface.hwaddress = 00:0e:1e:04:93:92
|
|
Packit |
eace71 |
# iface.transport_name = qla4xxx
|
|
Packit |
eace71 |
# iface.bootproto = static
|
|
Packit |
eace71 |
# iface.subnet_mask = 255.255.255.0
|
|
Packit |
eace71 |
# iface.gateway = 192.168.1.1
|
|
Packit |
eace71 |
# iface.state = enable
|
|
Packit |
eace71 |
# iface.vlan = <empty>
|
|
Packit |
eace71 |
# iface.iface_num = 0
|
|
Packit |
eace71 |
# END RECORD
|
|
Packit |
eace71 |
#
|
|
Packit |
eace71 |
# IPV6 sample config file with neighbor discovery:
|
|
Packit |
eace71 |
# BEGIN RECORD 2.0-872
|
|
Packit |
eace71 |
# iface.iscsi_ifacename = qla4xxx-3-1
|
|
Packit |
eace71 |
# iface.ipaddress =
|
|
Packit |
eace71 |
# iface.hwaddress = 00:0e:1e:04:93:92
|
|
Packit |
eace71 |
# iface.transport_name = qla4xxx
|
|
Packit |
eace71 |
# iface.ipv6_autocfg = nd
|
|
Packit |
eace71 |
# iface.linklocal_autocfg = auto
|
|
Packit |
eace71 |
# iface.router_autocfg = nd
|
|
Packit |
eace71 |
# iface.ipv6_linklocal = fe80:0000:0000:0000:020e:1eff:1111:2221
|
|
Packit |
eace71 |
# iface.ipv6_router = auto
|
|
Packit |
eace71 |
# iface.state = enable
|
|
Packit |
eace71 |
# iface.vlan = <empty>
|
|
Packit |
eace71 |
# iface.iface_num = 0
|
|
Packit |
eace71 |
# END RECORD
|
|
Packit |
eace71 |
|
|
Packit |
eace71 |
# Ipv4 sample config file (DHCP configuration):
|
|
Packit |
eace71 |
# BEGIN RECORD 2.0-872
|
|
Packit |
eace71 |
# iface.iscsi_ifacename = qla4xxx-3
|
|
Packit |
eace71 |
# iface.hwaddress = 00:0e:1e:04:93:92
|
|
Packit |
eace71 |
# iface.transport_name = qla4xxx
|
|
Packit |
eace71 |
# iface.bootproto = dhcp
|
|
Packit |
eace71 |
# iface.state = enable
|
|
Packit |
eace71 |
# iface.vlan = <empty>
|
|
Packit |
eace71 |
# iface.iface_num = 0
|
|
Packit |
eace71 |
# END RECORD
|
|
Packit |
eace71 |
|
|
Packit |
eace71 |
# Sample ipv6 config file(manual configured IPs):
|
|
Packit |
eace71 |
# BEGIN RECORD 2.0-872
|
|
Packit |
eace71 |
# iface.iscsi_ifacename = iface-new-file
|
|
Packit |
eace71 |
# iface.ipaddress = fec0:ce00:7014:0041:1111:2222:1e04:9392
|
|
Packit |
eace71 |
# iface.hwaddress = 00:0e:1e:04:93:92
|
|
Packit |
eace71 |
# iface.transport_name = qla4xxx
|
|
Packit |
eace71 |
# iface.ipv6_autocfg = <empty>
|
|
Packit |
eace71 |
# iface.linklocal_autocfg = <empty>
|
|
Packit |
eace71 |
# iface.router_autocfg = <empty>
|
|
Packit |
eace71 |
# iface.ipv6_linklocal = fe80:0000:0000:0000:0000:0000:1e04:9392
|
|
Packit |
eace71 |
# iface.ipv6_router = fe80:0000:0000:0000:7ae7:d1ff:fe72:4048
|
|
Packit |
eace71 |
# iface.state = enable
|
|
Packit |
eace71 |
# iface.vlan = <empty>
|
|
Packit |
eace71 |
# iface.iface_num = 0
|
|
Packit |
eace71 |
# END RECORD
|