Skip to main content

July 20, 2026

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

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.

Recommended Operating Systems

Operating SystemRecommended OS Version
Windows10 and 11
Ubuntu20.04, 22.04, 24.04

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. From the Omnissa Customer Connect, go to Unified Access Gateway (UAG) for vSphere, AWS, Google Cloud, and Nutanix file and click DOWNLOAD NOW.
    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.

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

    Add UAG image to Nutanix

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

ValueExampleDescription
prismCentralUserNameuser1.test1.comEnter the prism central username.
prismCentralAddressprism3.prov1.test1.comEnter the prism central address.
clustercluster1Enter the name of the customer where the virtual machine has to be deployed.
imageuag-vmEnter the name of the image.
subnet0, subnet1, subnet2subnet0=subneta, subnet1=subnetb, subnet2=subnetcEnter the name of the Subnet for eth0 interface.
subnet1 and subnet2 are required only during multi NIC deployments.
Note: To get the network details on Prism Cental, go to Network & Security > Subnets.

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. From the Omnissa Customer Connect, go to Unified Access Gateway (UAG) 2506 PowerShell Scripts for Nutanix file and click DOWNLOAD NOW.
    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.

Virtual machine created on Nutanix AHV

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.

Was this page helpful?

Provide feedback for this topic

Was this topic helpful?

Please do not include any personal or confidential information.

Generating link…