PowerShell deployment to Nutanix AHV

This section describes the required steps to prepare your platform for deploying Omnissa Unified Access Gateway to Nutanix AHV.

Pre-requisites to deploy Unified Access Gateway on Nutanix AHV

Recommended Operating Systems for running the PowerShell deployment script

The following table lists the operating systems from which PowerShell based Unified Access Gateway deployment to Nutanix AHV can be executed. This does not refer to the operating system of the Unified Access Gateway appliance itself.

Prepare your platform for the PowerShell deployment

1. Open the Powershell window and install the following package.

   Install-Package 7Zip4PowerShell

2. Ensure that the subnets and clusters are already created on Prism Central. For more information, see Creating a Subnet and Create a cluster.

Minimum Supported Nutanix Software Versions

• Prism Central (PC): 2024.3
• AOS: 7.0
• AHV: 10.0

Step 1. Upload the UAG vmdk image to Prism Central

1. Download the Unified Access Gateway (UAG) for vSphere, AWS, Google Cloud and Nutanix file from Omnissa Customer Connect portal.
   A zip file euc-unified-access-gateway-x.x.x.xxxxxxxxx.ova is downloaded on your local machine.

2. Extract the .vmdk image from the .ova file.

   Windows	Ubuntu
   expand-7zip ova-filename target-location For example, euc-unified-access-gateway-x.y.0.0-12345678_OVF10.ova is the downloaded file, where x-y is the version number and 12345678 is the build number. To extract the .vmdk file to C:\uag, run: expand-7zip C:\uag\euc-unified-access-gateway-x.y.0.0-12345678_OVF10.ova	tar -xvf ova-filename For example: tar -xvf euc-unified-access-gateway-x.y.0.0-12345678_OVF10.ova

3. Login to Prism Central and upload the .vmdk image file. For more information, see Add an image.

   

Step 2. Prepare the .ini file

To prepare the .ini file, configure the General settings and create a new section for [Nutanix] and include the parameters mentioned in the following table.

For more information about configuring [General] section parameters, see PowerShell deployment parameters.

Nutanix AHV specific settings

Example of .ini file

[General]
name=uag-vm
defaultGateway=10.xx.xx.xxx
deploymentOption=twonic
requestTimeoutMsec=10000
snmpEnabled=false
sshEnabled=true
sshKeyAccessEnabled=true
sshPasswordAccessEnabled=true
DNS=10.12.120.xxx


[Nutanix]
prismCentralUserName=user1.test1.com
prismCentralAddress=prism3.prov1.test1.com
cluster=cluster1
image=euc-unified-access-gateway-25.03.0.0-14396117930-system.vmdk
subnet0=subneta
subnet1=subnetb

Step 3. Deploy Unified Access Gateway to Nutanix AHV

You can deploy Unified Access Gateway to Nutanix AHV by using the uagdeployntnx.ps1 PowerShell command.

1. Download Unified Access Gateway (UAG) PowerShell Scripts file from the Omnissa Customer Connect portal.
   A zip file uagdeploy-xx.xx.x.x-xxxxxxxx is downloaded on your local machine.

2. Extract the files from the zip file. Ensure that the following PowerShell script is available on your machine.
   uagdeployntnx.ps1

3. Open PowerShell window and run the following command:
   .\uagdeployntnx.ps1 Nutanix.ini

4. Enter the root user password, admin password, and Prism Central password when prompted. For more information about the root user and admin password requirements, see Password requirements.
After successful deployment, virtual machine is created on Prism Central.

What's Next

1. Using the IP information, login to the virtual machine to ensure all services are working as expected.
2. Login to the admin UI with https://uag-ip:9443 and configure the settings based on your requirement. See Configure Horizon Settings.