Blame etc/iface.example

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