Warning Livedoc is no longer being updated and will be deprecated shortly. Please refer to https://documentation.tjhsst.edu.

Difference between revisions of "SAN/Add iSCSI Initiator"

From Livedoc - The Documentation Repository
Jump to: navigation, search
(initial, incomplete page)
 
(finish prerequisites)
Line 11: Line 11:
 
<code>
 
<code>
 
  emerge -a iproute2 open-iscsi multipath-tools
 
  emerge -a iproute2 open-iscsi multipath-tools
 +
</code>
 +
 +
===Kernel===
 +
The following kernel modules need to be available. NOTE - these MUST be built as kernel modules, not into the kernel, or iscsid will fail to start.
 +
<code>
 +
CONFIG_SCSI_ISCSI_ATTRS=m
 +
CONFIG_ISCSI_TCP=m
 
</code>
 
</code>
  
 
===Networking===
 
===Networking===
 +
For security reasons, all iSCSI traffic on the SAN is run on an isolated VLAN (currently VLAN 16). In order to connect via iSCSI, the Server needs to be configured to access VLAN 16. First this VLAN needs to be added to the Server's trunk link(s).
 +
 +
Then the VLAN needs to be configured on the server. The following lines need to be added/modified in /etc/conf.d/net
 +
 +
<code>
 +
#Add VLAN 16 to the below list
 +
vlans_bond0="16 1600 1802"
 +
 +
vlan16_name="vlan16"
 +
#Replace the last two octets of the below IP with the last two
 +
#octets of the server's IP address
 +
config_vlan16="172.16.17.45/16"
 +
</code>
 +
 +
Finally, either restart the server's trunk interface (BAD idea if it's in production) or use the following commands to manually configure the interface.
 +
 +
<code>
 +
ip link add link bond0 name vlan16 type vlan id 16
 +
ip addr add 172.16.17.45/16 dev vlan16
 +
</code>

Revision as of 22:46, 28 September 2013

This page contains administration guidelines and commands for connecting a Server to the iSCSI storage provided by the CSL SAN

Prerequisites

Software

The following software packages must be installed:

  • iproute2
  • open-iscsi
  • multipath-tools

emerge -a iproute2 open-iscsi multipath-tools

Kernel

The following kernel modules need to be available. NOTE - these MUST be built as kernel modules, not into the kernel, or iscsid will fail to start.

CONFIG_SCSI_ISCSI_ATTRS=m
CONFIG_ISCSI_TCP=m

Networking

For security reasons, all iSCSI traffic on the SAN is run on an isolated VLAN (currently VLAN 16). In order to connect via iSCSI, the Server needs to be configured to access VLAN 16. First this VLAN needs to be added to the Server's trunk link(s).

Then the VLAN needs to be configured on the server. The following lines need to be added/modified in /etc/conf.d/net

#Add VLAN 16 to the below list
vlans_bond0="16 1600 1802"

vlan16_name="vlan16"
#Replace the last two octets of the below IP with the last two
#octets of the server's IP address
config_vlan16="172.16.17.45/16"

Finally, either restart the server's trunk interface (BAD idea if it's in production) or use the following commands to manually configure the interface.

ip link add link bond0 name vlan16 type vlan id 16
ip addr add 172.16.17.45/16 dev vlan16