Site Pairing are the relationship between HCX instances, they can be a simple 1 to 1, 1 to many or many to 1.
For the purposes of this lab, I will create a simple 1 to 1 site pairing.
Before you start, ensure you have run through and complete the basic HCX Manager configurations especially the vCenter registrations.
Add the Certificate
Before you start, you will want to have created a hashtable of all the CSV data and then read the relevant values into variables for use.
Please refer to previous posts on this process.
Next, you will need to add the target HCX Certificate to the Source HCX server, this can be done in the VAMI or via API.
Note – This section of code uses the function ‘Connect-HcxVAMI‘, this is part of William Lams Power.HCX.psm1 PowerShell module.
It can be downloaded from GIT here https://github.com/lamw/VMware.HCX
You will just need to load it at the start of your script i.e.
Import-Module .\VMware.HCX.psm1 -Force
The Connect-HcxVAMI Function, takes in the HCX Server name and local credentials and establishes a connection to the HCX Admin Interface on port 9443.
Finally, this section of code posts the target HCX server’s URL to the certificates API to register it.
Create the Site Pairing
A site pairing is created by passing a payload to the CloudConfigs API and adding the source vCenters VCGUID
https://<HCX Server>/hybridity/api/cloudConfigs?vcGuid=<vCenter GUID>
The VcGuid can be fetched with a simple Get-View command as shown:
Next you need to connect to HCX and get a ‘x-hm-authorization‘ token.
The Connect-HcxServer function calls the https://<HCX Server>/hybridity/api/sessions URL and requests a ‘x-hm-authorization’ token which is passed back to the script to then allow API authentication to the HCX Server with SSO Credentials.
Finally you are ready to create the site pairing.
$hcxLoginUrl = "https://$HCXServer/hybridity/api/cloudConfigs?vcGuid=$SrcVcGuid"
$payload = '{"remote":{"url":"'+ $TgtHCXServer + '","username":"'+ $TgtVCUser + '","password":"'+ $TgtVCPassword + '"}}'
$sitePairingResults = Invoke-WebRequest -Uri $hcxLoginUrl -Headers $headers -Body $payload -Method POST -UseBasicParsing -ContentType "application/json" -SkipCertificateCheckReady to move on? Click here for blog 6 of 9 – HCX API Explorer
Want to see the API magic for this step?
Checkout the YouTube video below (maybe watch at 2x speed):