Skip to main content
Pure Technical Services

How-To: Manage Hosts and Host Connections with SDK v1

Currently viewing public documentation. Please login to access the full scope of documentation.

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.

host_wwns.png

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.

host_iqns.png

 

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).

wwn_host_volconnect.png

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).

iqn_host_volconnect.png

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.

new_hostgroup.png

 

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.

hosts_in_hostgroup.png

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.

volconnect_hostgroup.png

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