PureStorage.CBS.AVS.Configuration.ps1
|
. $PSScriptRoot/PureStorage.CommonUtil.ps1 function Set-VmHostiSCSI { <# .SYNOPSIS Configure FlashArray iSCSI target information on ESXi host .DESCRIPTION Takes in an ESXi host and configures FlashArray iSCSI target info #> Param( [Parameter(Mandatory = $true)] [VMware.VimAutomation.ViCore.Types.V1.Inventory.Cluster]$Cluster, [Parameter(Mandatory = $true)] [VMware.VimAutomation.ViCore.Types.V1.Inventory.VMHost]$Esxi, [Parameter(Mandatory = $true, ValueFromPipeline = $True)] $Flasharray, [Parameter(Mandatory = $false)] [String]$AVSCloudName, [Parameter(Mandatory = $false)] [String]$AVSResourceGroup, [Parameter(Mandatory = $false)] [int]$TimeoutInMinutes = 10 ) if ($esxi.ExtensionData.Runtime.ConnectionState -ne "connected") { Write-Warning "Host $($esxi.NetworkInfo.HostName) is not in a connected state and cannot be configured." return } $faiSCSItargets = Get-Pfa2NetworkInterface -Array $FlashArray | Where-Object { $_.services -eq "iscsi" } | Where-Object { $_.enabled -eq $true } | Where-Object { $null -ne $_.Eth.address } if ($null -eq $faiSCSItargets) { throw "The target Pure Cloud Block Store does not currently have any iSCSI targets configured." } $params = @{ ClusterName = $Cluster.Name; ScsiIpAddress = $faiSCSItargets[0].Eth.address } Invoke-RunScript -RunCommandName "Set-VmfsIscsi" -RunCommandModule "Microsoft.AVS.VMFS" -Parameters $params ` -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup -TimeoutInMinutes $TimeoutInMinutes } function New-PfaHostFromVmHost { <# .SYNOPSIS Create a FlashArray host from an ESXi vmhost object .DESCRIPTION Takes in a vCenter ESXi host and creates a FlashArray host #> Param( [Parameter(Mandatory = $true)] [VMware.VimAutomation.ViCore.Types.V1.Inventory.Cluster]$Cluster, [Parameter(Mandatory = $true)] [VMware.VimAutomation.ViCore.Types.V1.Inventory.VMHost]$Esxi, [Parameter(Mandatory = $true, ValueFromPipeline = $True)] $Flasharray, [Parameter(Mandatory = $false)] [String]$AVSCloudName, [Parameter(Mandatory = $false)] [String]$AVSResourceGroup, [Parameter(Mandatory = $false)] [int] $NvmeConnectionKeepAliveTimeoutInSeconds = 60, [Parameter(Mandatory = $false)] [int] $TimeoutInMinutes = 10 ) $ArrayName = Get-ArrayName -FlashArray $FlashArray $IsNvme = Test-ArrayHasNVmeInterface -FlashArray $FlashArray Write-Verbose "Creating Pure Cloud Block Store $ArrayName host for VMHost $($Esxi.Name)..." $newFaHost = $null try { $newFaHost = Get-PfaHostFromVmHost -flasharray $flasharray -esxi $esxi -ErrorAction Stop } catch {} $DEFAULT_SKUS = @( "av36", "av36p", "av52" ) $Sku = Get-AvsClusterSku -AvsResourceGroupName $AVSResourceGroup -AvsPrivateCloudName $AVSCloudName -AvsClusterName $ClusterName if ($DEFAULT_SKUS -contains $Sku) { $Available_Vmnics = @("vmnic1", "vmnic2") $UseAllNics = $False } else { $UseAllNics = $True } if ($null -eq $newFaHost) { if ($IsNvme) { $esxicli = $Esxi | Get-EsxCli -v2 $nqn = Get-VMHostNqn -Esxi $Esxi if (-not $nqn) { throw "No NQN found for host $($Esxi.Name)." } # Call New-NvmeTcpAdapter $VMnics = $esxicli.network.nic.list.Invoke() foreach ($vmnic in $VMnics) { if ($UseAllNics -or ($vmnic.Name -in $Available_Vmnics)) { Write-Host "Creating NVMe over TCP adapter for network interface $($vmnic.Name) on host $($Esxi.Name)..." $params = @{ HostAddress = $Esxi.Name; VMNic = $vmnic.Name } Invoke-RunScript -RunCommandName "New-NvmeTcpAdapter" -RunCommandModule "Microsoft.AVS.VMFS" -Parameters $params ` -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup -TimeoutInMinutes $TimeoutInMinutes } else { Write-Host "Network interface $($vmnic.Name) is not used for NVMe over TCP on host $($Esxi.Name)." } } # Call Set-NVMeTCP $vmks = Get-VMKInterface -AvsResourceGroupName $AVSResourceGroup -AvsPrivateCloudName $AVSCloudName -Cluster $Cluster foreach ($vmk in $vmks) { Write-Host "Setting NVMe over TCP for VMkernel interface $($vmk) on host $($Esxi.Name)..." $params = @{ HostAddress = $Esxi.Name; VmKernel = $vmk } Invoke-RunScript -RunCommandName "Set-NVMeTCP" -RunCommandModule "Microsoft.AVS.VMFS" -Parameters $params ` -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup -TimeoutInMinutes $TimeoutInMinutes } # Call Connect-NVMeTCPTarget $ArrayNqnPorts = Get-Pfa2Port -Array $FlashArray | Where-Object { $_.Nqn } foreach ($ArrayPort in $ArrayNqnPorts) { $ArrayNqn = $ArrayPort.Nqn $NodeAddress, $Port = $ArrayPort.Portal.Split(':') $params = @{ ClusterName = $Cluster.Name; NodeAddress = $NodeAddress; StorageSystemNQN = $ArrayNqn; KeepAliveTimeout = $NvmeConnectionKeepAliveTimeoutInSeconds; PortNumber = $Port; } Write-Host "Connecting NVMe over TCP target $ArrayNqn on host $($Esxi.Name)..." Invoke-RunScript -RunCommandName "Connect-NVMeTCPTarget" -RunCommandModule "Microsoft.AVS.VMFS" -Parameters $params ` -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup -TimeoutInMinutes $TimeoutInMinutes } try { $newFaHost = New-Pfa2Host -Array $FlashArray -Name ($esxi.NetworkInfo.HostName) -Nqn $nqn -ErrorAction Stop } catch { if ($PSItem.ToString() -like "Host already exists.*") { $randName = $esxi.NetworkInfo.HostName + (Get-Random -Maximum 99999 -Minimum 10000).ToString() $newFaHost = New-Pfa2Host -Array $FlashArray -Name $($randName) -Nqn $nqn Write-Host "Host name $($esxi.NetworkInfo.HostName) is in use. Host $($newFaHost.Name) is created for Esxi $($Esxi.Name)" } else { throw $PSItem.ToString() } } Update-Pfa2Host -Array $FlashArray -Name $($newFaHost.name) -Personality "esxi" | Out-Null } else { Set-VMHostiSCSI -Cluster $Cluster -esxi $esxi -flasharray $flasharray -TimeoutInMinutes $TimeoutInMinutes` -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup -ErrorAction Stop | Out-Null $iscsiadapter = $esxi | Get-VMHostHBA -Type iscsi | Where-Object { $_.Model -eq "iSCSI Software Adapter" } if ($null -eq $iscsiadapter) { throw "No Software iSCSI adapter found on host $($esxi.NetworkInfo.HostName)." } else { $iqn = $iscsiadapter.ExtensionData.IScsiName } try { try { $newFaHost = New-Pfa2Host -Array $FlashArray -Name ($esxi.NetworkInfo.HostName) -Iqns $iqn -ErrorAction Stop } catch { if ($PSItem.ToString() -like "Host already exists.*") { $randName = $esxi.NetworkInfo.HostName + (Get-Random -Maximum 99999 -Minimum 10000).ToString() $newFaHost = New-Pfa2Host -Array $FlashArray -Name $($randName) -Iqns $iqn Write-Host "Host name $($esxi.NetworkInfo.HostName) is in use. Host $($newFaHost.Name) is created for Esxi $($Esxi.Name)" } else { throw $PSItem.ToString() } } $arrayInfo = Get-Pfa2Array -Array $FlashArray $majorVersion = [int](($arrayInfo.Version.Split('.'))[0]) if ($majorVersion -ge 5) { Update-Pfa2Host -Array $FlashArray -Name $($newFaHost.name) -Personality "esxi" | Out-Null } } catch { Write-Error "$_" return $null } } } else { if ($newFaHost.wwn.count -gt 0) { throw "The host $($esxi.NetworkInfo.HostName) is already configured on array $Arrayname with FibreChannel. Multiple-protocols at once are not supported by VMware." } } return $newFaHost } function Remove-PfaUnusedHosts { Param ( [Parameter(Mandatory = $true)] [VMware.VimAutomation.ViCore.Types.V1.Inventory.Cluster]$Cluster, [Parameter(Mandatory = $True)] $Flasharray ) $hostGroups = Get-PfaHostGroupfromVcCluster -flasharray $Flasharray -cluster $cluster $faHostList = @() foreach ($hostGroup in $hostGroups) { $faHosts = Get-Pfa2Host -Array $Flasharray | Where-Object { $_.HostGroup.Name -eq $hostGroup.Name } | Where-Object { $_.IsLocal -eq $True } $faHostList = $faHostList + $faHosts } $vmHosts = $Cluster | Get-VMHost foreach ($vmHost in $vmHosts) { $faHost = Get-PfaHostFromVmHost -Flasharray $FlashArray -Esxi $vmHost -ErrorAction Ignore # Remove used hosts from the list $faHostList = $faHostList | Where-Object { $_.Name -ne $faHost.Name } } foreach ($faHost in $faHostList) { Write-Host "Removing unused host '$($faHost.Name)' from host group '$($faHost.HostGroup.Name)'..." Update-Pfa2Host -Array $Flasharray -Name $faHost.Name -HostGroupName '' # Remove might fail if there is volume in the host. try { Remove-Pfa2Host -Array $Flasharray -Name $faHost.Name } catch { # Write a non-terminating error here if failed to remove the host Write-Error "$_" -ErrorAction Continue } } } function New-PfaHostGroupfromVcCluster { <# .SYNOPSIS Create a host group from an ESXi cluster .DESCRIPTION Takes in a vCenter Cluster and creates hosts (if needed) and host group #> Param( [Parameter(Mandatory = $true)] [VMware.VimAutomation.ViCore.Types.V1.Inventory.Cluster]$Cluster, [Parameter(Mandatory = $True)] $Flasharray, [Parameter(Mandatory = $false)] [String]$AVSCloudName, [Parameter(Mandatory = $false)] [String]$AVSResourceGroup, [Parameter(Mandatory = $false)] [int] $NvmeConnectionKeepAliveTimeoutInSeconds = 60, [Parameter(Mandatory = $false)] [int] $TimeoutInMinutes = 10 ) $updated_hosts = @() # We have to use try catch here as adding -ErrorAction SilentlyContinue still throw terminating error try { $hostGroup = Get-PfaHostGroupfromVcCluster -flasharray $Flasharray -cluster $cluster } catch {} if ($hostGroup.count -gt 1) { throw "The cluster already is configured on the Pure Cloud Block Store and spans more than one host group. This cmdlet does not support a multi-hostgroup configuration." } $hostgroupName = $hostGroup.Name $esxiHosts = $cluster | Get-VMHost $HostMap = @{} foreach ($esxiHost in $esxiHosts) { $faHost = $null try { $faHost = Get-PfaHostFromVmHost -flasharray $Flasharray -esxi $esxiHost -ErrorAction Ignore if ($null -ne $faHost.HostGroup.Name) { if ($null -ne $hostGroup) { if ($hostGroup.name -ne $faHost.HostGroup.Name) { Write-Warning "The host $($faHost.name) already exists and is already in the host group $($faHost.hgroup)." } } } } catch { Write-Host "$_" } if ($null -ne $faHost) { if ($fahost.wwns.count -ge 1) { throw "The host $($esxiHost.NetworkInfo.HostName) is already configured on the Pure Cloud Block Store for FC. Mixed mode is not supported by VMware." } } if ($null -eq $faHost) { try { $faHost = New-PfaHostFromVmHost -Cluster $Cluster -flasharray $Flasharray -esxi $esxiHost ` -NvmeConnectionKeepAliveTimeoutInSeconds $NvmeConnectionKeepAliveTimeoutInSeconds -TimeoutInMinutes $TimeoutInMinutes ` -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup -ErrorAction Stop $HostMap[$faHost.Name] = $esxiHost $updated_hosts += $esxiHost.Name } catch { Write-Error $Global:Error[0] throw "Could not create host. Cannot create host group." } } else { $HostMap[$faHost.name] = $esxiHost.Name } } #FlashArray only supports Alphanumeric or the dash - character in host group names. Checking for VMware cluster name compliance and removing invalid characters. if ($null -eq $hostGroup) { if ($cluster.Name -match "^[a-zA-Z0-9\-]+$" -and $AVSCloudName -match "^[a-zA-Z0-9\-]+$") { $hostgroupName = "$($AVSCloudName)-$($cluster.Name)" } else { $hostgroupName = "$($AVSCloudName)-$($cluster.Name)" $hostgroupName = $hostgroupName -replace "[^\w\-]", "" $hostgroupName = $hostgroupName -replace "[_]", "" $hostgroupName = $hostgroupName -replace " ", "" } $hg = $null $hg = Get-Pfa2HostGroup -Array $Flasharray -Name $hostgroupName -ErrorAction SilentlyContinue | Where-Object { $_.IsLocal -eq $True } if ($null -ne $hg) { if ($hg.hosts.count -ne 0) { #if host group name is already in use and has only unexpected hosts i will create a new one with a random number at the end $nameRandom = Get-random -Minimum 1000 -Maximum 9999 $hostgroupName = "$($hostgroupName)-$($nameRandom)" $hostGroup = New-Pfa2HostGroup -Array $Flasharray -Name $hostgroupName -ErrorAction stop } else { $hostGroup = $hg } } else { #if there is no host group, it will be created $hostGroup = New-Pfa2HostGroup -Array $Flasharray -Name $hostgroupName -ErrorAction stop } } $faHostNames = @() foreach ($faHostName in $HostMap.Keys) { $faHost = Get-Pfa2Host -Array $Flasharray -Name $faHostName | Where-Object { $_.IsLocal -eq $True } if ($null -eq $faHost.HostGroup.Name) { $faHostNames += $faHostName } } #any hosts that are not already in the host group will be added if ($faHostNames.count -gt 0) { foreach ($faHostName in $faHostNames) { Write-Host "Adding $faHostName to $hostgroupName..." Update-Pfa2Host -Array $Flasharray -Name $faHostName -HostGroupName $hostgroupName | Out-Null if (-not $updated_hosts -contains $HostMap[$faHostName]) { $updated_hosts += $HostMap[$faHostName] } } } return $updated_hosts } |