Manual Cloud Connector Appliance Setup

This guide details the steps required to manually configure the Cloud Connector Appliance for Frame on AHV.

Requirements

The Frame Cloud Connector Appliance must be able to:

  • communicate with Nutanix Prism Central API (HTTPS/443).

  • communicate with the Frame backplane via the Internet (outbound HTTPS/443 and WSS/443).

Frame Workloads need to be placed in a VLAN that:

  • has a DHCP server with a sufficiently large IP range to account for the number of VMs (concurrent users).

  • can communicate with the Frame backplane via the Internet (outbound HTTPS/443 and WSS/443).

  • can accept remoting connections from end users that are on a corporate network (inbound HTTPS/443 and WSS/433).

Setup

  1. First, in your Prism Central console, navigate to your VMs page and select “Create VM.”

../../../_images/mcca_01.png
  1. Create a new VM for the Frame Cloud Connector Appliance (CCA) in a VLAN that meets the requirements listed above.

../../../_images/mcca_1.png

Note

For use cases with up to 500 concurrent users, Frame recommends configuring your CCA with 1 vCPU, 2 cores, and 4 GB RAM.

  1. Click “+ Add New Disk” in the upper right corner of the window.

../../../_images/mcca_2.png
  1. Add a 0.1 GB Disk with a SCSI Bus Type and select the appropriate container. Then, click “Add.”

../../../_images/mcca_3.png
  1. Under the “Disks” section, click on the edit icon next to the CD-ROM entry.

../../../_images/mcca_4.png
  1. Select the CCA ISO, this will mount from the “Clone from Image” operation for the VM. Keep the Bus Type as “IDE.” Click “Update.”

../../../_images/mcca_5.png
  1. The Boot Configuration should be set to ” Legacy BIOS” (default).

../../../_images/mcca_6.png
  1. Next, select “+ Add New NIC.”

../../../_images/mcca_7.png
  1. Select your network for the CCA VM, then click “Add.” In this example, we’re using IPAM. Your network configuration may be different.

../../../_images/mcca_8.png
  1. Next, check the “Custom Script” check box and click on the “Type or Paste Script option.” Enter #cloud-config as shown below. Click “Save” and close the VM.

../../../_images/mcca_9.png

Warning

If #cloud-config is not entered under the script field, the “Nutanix” root level user will have no way to log in.

If you are configuring your CCA for GovCloud use, paste the following script into the “Type or Paste Script” field:

#cloud-config
runcmd:
- set_cca_var CCA_SWITCHBOARD_URL cch.console.nutanix.us
- set_cca_var CCA_API_URL https://cpanel-backend.console.nutanix.us
- set_cca_var CCA_PLATFORM_URL https://console.nutanix.us
- set_cca_var CCA_REGISTRATION_URL https://gateway-external-api.console.nutanix.us
- systemctl restart cca-bridge
  1. Mount the CCA onto the virtual CD-ROM and select the CD-ROM as the primary boot device.

../../../_images/mcca_2.png
  1. Attach a 100 MB (0.1 GB) disk to the VM using the “Add New Disk” function. Do not use the “Add Volume Group” function.

../../../_images/mcca_4.png
  1. Save the VM with the preferences specified and power it on.

By default, the CCA will try to acquire an IP address from a DHCP server. To set a static IP, follow the instructions in this guide. If you wish to continue with the AHV setup, return to Step 5 of the AHV setup guide.