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

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

Minimum Supported Nutanix Software Versions

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

Step 1. Download and upload the .qcow2 image file

1. Download the Unified Access Gateway (UAG) for vSphere, AWS, Google Cloud and Nutanix file from Omnissa Customer Connect portal.

2. Login to Prism Central and upload the .qcow2 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-26.06.0.0-14396117935-system.qcow2
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.