PowerShell deployment to vCloud Director

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

Pre-requisites to deploy Unified Access Gateway on vCloud Director

Prepare your platform for the PowerShell deployment.

1. Install PowerShell 7.
2. Ensure that vApps and Catalogs are created on vCloud Director. See Create a vApp from vApp Template and Add a Catalog to VMware vCloud Director in the VMware vCloud Director Tech Docs.
3. Ensure that the user has the right privileges to manage vApps, Catalogs, and Networks features on vCloud Director. For more information, see VMware vCloud Director Tech Docs.

Recommended Operating Systems and PowerShell Versions

Step 1. Upload the ova image to vCloud Director

1. Download the OVA file from the Omnissa Customer Connect portal.

2. Upload the ova image on vCloud Director. For more information, see Create a vApp Template from an OVF File in the VMware vCloud Director Tech Docs.
   
   

Step 2. Prepare the .ini file

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

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

vCloud Director specfic settings

Example of .ini file

[General]
name=uag-deployment
netInternet=t1-01-test-t-o11
netManagementNetwork=t1-01-test-t-o11
netBackendNetwork=t1-01-test-t-o11
defaultGateway=10.22.130.xxx
deploymentOption=onenic
ip0=
netMask0=255.255.255.0
requestTimeoutMsec=10000
snmpEnabled=false
sshEnabled=true
sshKeyAccessEnabled=true
sshPasswordAccessEnabled=true
DNS=10.12.120.xxx

[vCloud]
vcUsername=test
vcHost=test-01.oc.omnissa.com
vcOrgId=test-01-ws1uem-tunnel-t
catalog=uag-ova-files
uagTemplate=Sample_template
vcVappName=UAG Team

Step 3. Deploy Unified Access Gateway to vCloud Director

You can deploy Unified Access Gateway to vCloud Director by using the uagdeployoc.ps1 PowerShell command.

1. From the Omnissa Customer Connect, go to Unified Access Gateway (UAG) PowerShell Scripts 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 scripts are available on your machine.
   uagdeployoc.ps1 and uagdeploy.psm1

3. Open PowerShell window and run the command.
   .\uagdeployoc.ps1 .\Onecloud.ini

4. Enter the vCloud password, root user password, and admin password when prompted.
   Virtual applications are created on the vApps.
   
   

5. Power on the virtual machine.

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.