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.

KP_Ext_Announcement.png

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