Configuring iSCSI is two parts:
- Assign VLANs to Equinix Metal server interfaces
- Configure network in vSphere.
This article is focused on iSCSI configuration with Hybrid bonded or Layer 2 bonded modes.
Assign VLANs to Equinix Metal server interfaces
To configure iSCSI the servers must have VLAN access to the FlashArray iSCSI ports. In the Equinix console, choose the server and click Network. Scroll down to Layer 2. Click on Add New Vlan.
Add the two iSCSI VLANs to bond0.
This will enable network access to the FlashArray iSCSI ports.
Repeat for all hosts that need iSCSI access.
Add iSCSI Port Groups
For each virtual distributed switch, you must add a port group for each iSCSI VLAN. For the FlashArray there will be two iSCSI VLANs, as can be seen in the below image there are indeed two, one with VLAN ID 1016 and 1017.
To create them, go to the Networking view in the inventory list and right click on the the desired VDS (Virtual Distributed Switch) and choose New Distributed Port Group.
Enter in a name for the port group that is clear and click Next. Choose VLAN under VLAN type and enter in the first VLAN ID.
Click Customize default policies configuration.
Under Teaming and failover change the load balancing to Route based on source MAC hash and also ensure the LAG is the Active uplink and the standard uplinks are moved to unused.
Complete the wizard. Now run the same process for the second VLAN.
Note, if your FlashArray uses jumbo frames (MTU is set to 9000) you must set this on the VDS as well. Right-click on the VDS and choose Settings > Edit Settings.
Under Advanced, change the MTU to 9000 and click OK.
Add VMkernel Ports
For each ESXi host, you need to create a VMkernel adapter for each VLAN that has an IP on that specific VLAN. These vmkernel ports should be added to their respective VDS port groups.
Click on the host and click on Configure > VMkernel adapters > Add Networking.
Choose VMkernel Network Adapter and select the first VLAN port group under Select an existing network.
In the next screen, leave all services unchecked and otherwise defaults. If the FlashArray iSCSI ports are configured for jumbo frames, set the MTU to Custom and 9000 (or what it is set to).
Enter in IP information using an IP that is valid for the chosen VLAN. Override the gateway if needed.
Repeat for the other VLAN.
Configure iSCSI Targets
The Software iSCSI adapter comes enabled by default in Equinix deployments, but it does come bound to an existing VMkernel port. This needs to be removed from the iSCSI adapter for brand new server deployments.
In the vSphere Client, click on the host in the Hosts & Clusters inventory view, then Configure > Storage Adapters and select the Software iSCSI target then Network Port Binding.
Find the existing VMkernel port and click Remove.
Confirm the removal.
Now you can configure the FlashArray iSCSI information. To do so, right-click on the cluster and choose Pure Storage > Add/Update Host Group.
In the screen that appears choose the correct FlashArray (if there is more than one). If this is are no hosts in this cluster yet configured on the selected FlashArray, this will create a host group and configure each host. If some hosts are configured but others not, it will configure the "new" hosts and add them to the pre-existing host group. Click Create.
This will do the following:
- Add software iSCSI adapter (though this is created by default in Equinix so it will be skipped).
- Add FlashArray iSCSI targets and add best practices
- Create host group (if not created already)
- Create host for each new host and add IQN
- Add host(s) to host group.
To confirm connectivity, click on the host in the Hosts & Clusters inventory view, then Configure > Storage Adapters and select the Software iSCSI target. Click on static discovery. If there are no targets that mean network connection between the host and the FlashArray iSCSI targets is not correct.
Furthermore if you login to the FlashArray web interface, you can verify uniform connectivity by looking at Health > Connections > Host Connections. The host will be listed. You can click on it to see the details.
If you click on the host for more details you can see some additional information.
If the status is anything besides Redundant, investigate connectivity. There should be:
- More than one connection on each controller
- Connections on both controllers
- Equal number of connections on both controllers
You can also click on the cluster object in vCenter and go to Configure > Pure Storage > Host Connections to see if any host is not configured.