How-To: Manage Hosts and Host Connections with SDK v1
This article is for the PowerShell SDK version 1.
In this section we will cover:
Create a Host
The New-PfaHost cmdlet is used to create a new Host on the FlashArray. Before using this cmdlet, have either the IQNs (iSCSI) or WWNs (Fibre Channel) names available. The below sample creates a new host named SDK-Sample-Host with the specified WWNs.
PS C:\> $wwn = @('10:00:00:00:00:00:11:11','10:00:00:00:00:00:12:12')
PS C:\> $wwn
10:00:00:00:00:00:11:11
10:00:00:00:00:00:12:12
PS C:\> New-PfaHost -Array $FlashArray -WwnList $wwn -Name SDK-Sample-Host
iqn wwn name
--- --- ----
{} {1000000000001111, 1000000000001212} SDK-Sample-Host
The view from the Web management interface shows the host and assigned WWNs.
WWNs or IQNs can be specified using a PowerShell array, Eg. $wwn = @('##','##') or $iqn = @('##','##'). This is an easier method to use than entering directly as a parameter entry.
Below is an example of creating a new host named SDK-IQNSample-Host with assigned IQNs.
PS C:\> $iqn = @('iqn.1998-01.com.sample1.iscsi','iqn.1998-01.com.sample2.iscsi')
PS C:\> $iqn
iqn.1998-01.com.sample1.iscsi
iqn.1998-01.com.sample2.iscsi
PS C:\> New-PfaHost -Array $FlashArray -Name 'SDK-IQNSample-Host' -IqnList $iqn
iqn wwn name
--- --- ----
{iqn.1998-01.com.sample1.iscsi, iqn.1998-01.com.sample2.iscsi} {} SDK-IQNSample-Host
The view from the Web management interface shows the host and assigned IQNs.
Connect Volume to Host
Using the sample hosts created for Fibre Channel and iSCSI above, volumes can now be connected. To connect a volume to a host, use New-PfaHostVolumeConnection cmdlet. The below example first uses the Get-PfaVolumes cmdlet with a Where-Object clause to retrieve the previously created sample volumes.
PS C:\> Get-PfaVolumes -Array $FlashArray | Where-Object { $_.name -like 'SDK*' } | Format-Table -AutoSize
source serial created name size
------ ------ ------- ---- ----
95DAA3D006E43D8F0004B467 2016-11-01T21:30:47Z SDK-Sample 536870912000
95DAA3D006E43D8F0004B468 2016-11-01T21:41:16Z SDK-Sample-1 262144000
95DAA3D006E43D8F0004B469 2016-11-01T21:41:17Z SDK-Sample-2 262144000
95DAA3D006E43D8F0004B46A 2016-11-01T21:41:17Z SDK-Sample-3 262144000
95DAA3D006E43D8F0004B46B 2016-11-01T21:41:17Z SDK-Sample-4 262144000
95DAA3D006E43D8F0004B46C 2016-11-01T21:41:17Z SDK-Rename-5 262144000
95DAA3D006E43D8F0004B46D 2016-11-01T21:41:17Z SDK-Sample-6 262144000
95DAA3D006E43D8F0004B46E 2016-11-01T21:41:17Z SDK-Sample-7 262144000
95DAA3D006E43D8F0004B46F 2016-11-01T21:41:17Z SDK-Sample-8 262144000
95DAA3D006E43D8F0004B470 2016-11-01T21:41:17Z SDK-Sample-9 262144000
95DAA3D006E43D8F0004B471 2016-11-01T21:41:18Z SDK-Sample-10 262144000
PS C:\> New-PfaHostVolumeConnection -Array $FlashArray -VolumeName 'SDK-Sample-1' -HostName 'SDK-Sample-Host'
vol name lun
--- ---- ---
SDK-Sample-1 SDK-Sample-Host 1
The view from the Web management interface shows the SDK-Sample1 volume connect to the SDK-Sample-Host (Fibre Channel).
Below is an example of connecting a volume to the SDK-IQNSample-Host (iSCSI).
PS C:\> New-PfaHostVolumeConnection -Array $FlashArray -VolumeName 'SDK-Sample-10' -HostName 'SDK-IQNSample-Host' vol name lun --- ---- --- SDK-Sample-10 SDK-IQNSample-Host 1 The view from the Web management interface shows the host and assigned IQNs.
The view from the Web management interface shows the SDK-Sample10 volume connect to the SDK-IQNSample-Host (iSCSI).
To add additional WWNs or IQNs to a host, use the Add-PfaHostWwns or Add-PfaHostIqns. To remove a volume that is connected to a host, use the Remove-PfaHostVolumeConnection cmdlet.
PS C:\> Remove-PfaHostVolumeConnection -Array $FlashArray -VolumeName 'SDK-Sample-1' -HostName 'SDK-Sample-Host' vol name --- ---- SDK-Sample-1 SDK-Sample-Host
Create a Host Group & Add Hosts
The New-PfaHostGroup cmdlet is used to create a new Host Group.
PS C:\> New-PfaHostGroup -Array $FlashArray -Name 'SDK-Sample-HostGroup'
hosts name
----- ----
{} SDK-Sample-HostGroup
The view from the Web management interface shows the new SDK-Sample-HostGroup.
Add Host to Host Group
To add a Host(s) to an existing Host Group, use the Add-PfaHosts cmdlet.
PS C:\> $hosts = @('SDK-Sample-Host','SDK-IQNSample-Host')
PS C:\> $hosts
SDK-Sample-Host
SDK-IQNSample-Host
PS C:\> Add-PfaHosts -Array $FlashArray -Name 'SDK-Sample-HostGroup' -HostsToAdd $hosts
hosts name
----- ----
{SDK-Sample-Host, SDK-IQNSample-Host} SDK-Sample-HostGroup
The view from the Web management interface shows the new SDK-Sample-HostGroup and added Hosts.
To remove a Host(s) from a Host Group, use the Remove-PfaHosts cmdlet.
PS C:\> Remove-PfaHosts -Array $FlashArray -HostsToRemove $hosts -Name 'SDK-Sample-HostGroup'
hosts name
----- ----
{} SDK-Sample-HostGroup
Connect Volume to Host Group
The final task is to connect a Volume to a Host Group. Connecting a volume to a host group allows all of the hosts within the host group to see the volume. A use case example for this is creating a Clustered Shared Volume (CSV) for high-availability for all Windows Server Failover Cluster nodes. Use the New-PfaHostGroupVolumeConnection cmdlet.
PS C:\> New-PfaHostGroupVolumeConnection -Array $FlashArray -VolumeName 'SDK-Sample-2' -HostGroupName 'SDK-Sample-HostGr oup' vol name lun --- ---- --- SDK-Sample-2 SDK-Sample-HostGroup 254
The view from the Web management interface shows the SDK-Sample-2 added to the Host Group.
To remove a connected volume from a host group, use Remove-PfaHostGroupVolumeConnection cmdlet.
PS C:\> Remove-PfaHostGroupVolumeConnection -Array $FlashArray -VolumeName 'SDK-Sample-2' -HostGroupName 'SDK-Sample-Hos tGroup' vol name --- ---- SDK-Sample-2 SDK-Sample-HostGroup