Skip to main content
Pure Technical Services

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

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

 

Creating a Host

The New-Pfa2Host 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 SDKv2-host with the specified WWNs on an array previously connected to and set in the $FlashArray variable. 

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-Pfa2Host -Array $FlashArray -Wwns $wwn -Name SDKv2-host

The view from the Web management interface shows the host and assigned WWNs.

new-pfa2host.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 SDKv2-IQNS-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-Pfa2Host -Array $FlashArray -Name 'SDKv2-IQNS-host' -Iqns $iqn

The view from the Web management interface shows the host and assigned IQNs.

new-pfa2host2.png

 

Connecting and Removing a Volume to a 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-Pfa2Connection cmdlet. The below example first uses the Get-Pfa2Volume cmdlet with a Where-Object clause to retrieve the previously created sample volumes.

PS C:\> Get-Pfa2Volume -Array $FlashArray | Where-Object { $_.name -like 'SDK*' } | Format-Table -AutoSize
Id                                   Name           ConnectionCount Created             Destroyed HostEncryptionKeyStatus Provisioned Qos
--                                   ----           --------------- -------             --------- ----------------------- ----------- ---
2245a634-7bd9-55c8-d22a-0e4e17bbe9f7 SDK2-sample-3               0 8/7/2020 3:07:24 PM     False none                     2147483648 class Qos {…
d73e3c73-c0d4-6982-c377-d70f0e813b63 SDK2-sample-2               0 8/7/2020 3:07:24 PM     False none                     2147483648 class Qos {…
d59bbc70-ca3a-4c61-7c6e-b5ac0ba54ea4 SDK2-sample-1               0 8/7/2020 3:07:24 PM     False none                     2147483648 class Qos {…
       
PS C:\> New-Pfa2Connection -Array $FlashArray -VolumeNames 'SDKv2-Sample-1' -HostNames 'SDKv2-host'

The view from the Web management interface shows the SDKv2-Sample-1 volume connect to the SDKv2-host.

new-pfa2connection.png

To remove a volume that is connected to a host, use the Remove-Pfa2HostVolumeConnection cmdlet.

PS C:\> Remove-Pfa2Connection -Array $FlashArray -VolumeNames 'SDKv2-Sample-1' -HostNames 'SDKv2-host'

 

Creating a Host Group and Adding Hosts

The New-Pfa2HostGroup cmdlet is used to create a new Host Group.  

PS C:\> New-Pfa2HostGroup -Array $FlashArray -Name 'SDKv2-HostGroup'

The view from the Web management interface shows the new SDK-Sample-HostGroup.

new-pfa2hostgroup.png

 

Adding and Removing a Host within a Host Group

To add a Host(s) to an existing Host Group, use the New-Pfa2HostHostGroup cmdlet.

PS C:\> $hosts = @('SDKv2-host','SDKv2-IQNS-host')
PS C:\> $hosts
SDKv2-host
SDKv2-IQNS-host
PS C:\> New-Pfa2HostHostGroup -Array $FlashArray -GroupNames 'SDKv2-HostGroup' -MemberNames $hosts

The view from the Web management interface shows the new SDKv2-HostGroup and added Hosts.

new-pfs2hosthostgroup.png

To remove a Host(s) from a Host Group, use the Remove-Pfa2Host cmdlet.

PS C:\> Remove-Pfa2Host -Array $FlashArray -HostsToRemove $hosts -Name 'SDKv2-HostGroup'

 

Connecting and Removing a Volume in a Host Group

Connecting a volume to a host group allows all of the hosts within the host group to see the volume. A typical use case for this is creating a Clustered Shared Volume (CSV) for high-availability for all Windows Server Failover Cluster nodes. Use the New-Pfa2Connection cmdlet.

PS C:\> New-Pfa2Connection -Array $FlashArray -VolumeNames 'SDKv2-Sample-2' -HostGroupNames 'SDKv2-HostGroup'

The view from the Web management interface shows the SDK-Sample-2 added to the Host Group.

new-pfa2connection2.png

To remove a connected volume from a host group, use Remove-Pfa2Connection cmdlet.

PS C:\> Remove-Pfa2Connection -Array $FlashArray -VolumeNames 'SDKv2-Sample-2' -HostGroupNames 'SDKv2-HostGroup'