Initializing AVS and Everpure Cloud Dedicated Connectivity

Everpure Cloud Dedicated for Azure
Audience
Public
Source Type
Documentation
The following command needs to be run to initialize your AVS cluster for use with Everpure Cloud Dedicated. Note that it must be run against each individual cluster inside of a given Azure VMware Solution item. So for example, if you have an AVS instance that contains 2 unique clusters, you need to run the following command two times (once for each cluster), specifying the cluster you want to execute against.
Important: Logging into Azure connects you to your default subscription by default. If you have multiple subscriptions, ensure you switch to the correct context before configuring Azure VMware Solution or Everpure Cloud Dedicated instances to avoid deployment errors. To check what context you are in, please execute this command: get-azcontext. If the context is not correct, it can be changed by using this command: set-azcontext -subscriptionID "your Subscription ID".

Build-PCBSCluster enables the software iSCSi adapter on the AVS cluster hosts, applies Everpure best practices, adds a host object and its unique iSCSI IQN to Everpure Cloud Dedicated and lastly creates a host group comprised of the AVS ESXi hosts in a given cluster. The command can be re-run against a cluster to account for any host changes or updates as well. An Azure Function can be setup to automatically monitor your AVS instance for host membership changes and those steps are outlined below in the Deploy Host Monitor section of this guide. However, the command shown here must be executed manually at least once in order for the initial connectivity between the AVS hosts and Everpure Cloud Dedicated to be established.

Note that some command arguments shown below, such as -ClusterName are case-sensitive.

Below you will find more detailed information about each PowerShell command, as well as other scenarios for their usage.

Function name: Build-PCBSCluster

Function action:

  • Enable SW iSCSI on AVS ESXi hosts

  • Apply Everpure iSCSI best practices

  • Create host objects with IQNs on Everpure Cloud Dedicated

  • Create host group with host objects on Everpure Cloud Dedicated

Function invoked when:

  • New AVS instance created

  • New ESXi host added or removed to existing AVS cluster

  • New cluster added to existing AVS instance

Examples:

  • Sample command with Minimum Required Arguments:

    
Build-PCBSCluster -ClusterName "myCluster" -AVSCloudName "myAVSCloudName" -AVSResourceGroup "myAVSResourceGroup"

  • Additional optional arguments:

    -PureCloudBlockStoreConnection $CBSConnection

Troubleshooting

ResourceGroupNotFound

If you see an error like { "error": { "code": "ResourceGroupNotFound" , "message": "Resource group \xyz\xyz could be not found." }} please ensure you switched to the correct Azure subscription context before configuring Azure VMware Solution with Everpure Cloud Dedicated instances.

To check what context you are currently logged in, please execute this command: get-azcontext.

If the context is not correct, it can be changed by using the command: set-azcontext -subscriptionID "your Subscription ID".