Nutanix Integration Configuration Guide

Workspot Support -

Workspot-Nutanix Integration Overview

Workspot-Nutanix Integration provides a simple interface with easy access to Nutanix Acropolis - a turnkey VDI 2.0 infrastructure platform. Workspot's Enterprise Connector provides the integration service between Nutanix deployments and Workspot Control. Control is Workspot's cloud-based, comprehensive management solution that radically simplifies the automatic provisioning of VDI desktops, in addition to managing configurations and policies for the environment.

Prerequisites and Configuration Notes

The following are general prerequisites for this guide:

  • Setup your hyper converged infrastructure environment where your virtual desktops will be running, and make sure it is accessible from the internet. PRISM (Nutanix UI console) is optional but, at a minimum, you will need an Acropolis deployment hosting a single cluster-node configuration.
  • Create a Nutanix account on Acropolis for provisiong of the Virtual Machines (VMs). See the Nutanix website for more information regarding the Nutanix Xtreme Computing Platform and it's configuration.
  • Create an Enterprise Connector installation which will provide the integration service. Log into Control (https://control.workspot.com), and go to Company > Datacenter > Download Connector to download the software. See Enterprise Connector Configuration Guide for more information. Figure 1 - Download the Workspot Enterprise Connector

Configuring Control involves the following steps for Workspot-Nutanix Integration:

  1. Read the instructions.
  2. Add Datacenter and provide a name that describes the datacenter. Note: "Cupertino DC" is used in this example where DC is short for Data Center.
  3. Add Configuration for the Nutanix Acropolis configuration type.
  4. Add Pool to provision Virtual Machines (VMs). The Nutanix VDI is used by virutue of the integrated configuration defined.
  5. Assign Desktops in the pool to users using one of the following methods: (a) users defined in Workspot, (b) and/or users listed in a spreadsheet that is imported.
  6. Import Pool contained in a "csv" file that lists users, ip addresses, and other relevant information. Refer the screen shot of such a Sample CSV File at the end of this guide.

Control Configuration for Nutanix Integration

  1. Read the instructions: Navigate to Control :: Resources > VDI(0) and review the Virtual Desktop Infrastructure (VDI) Setup panel, as shown in Figure 2 below. Figure 2 - Virtual Desktop Infrastructure (VDI) Setup - First Time Use (FTU)

  2. Add Datacenter: Navigate to Company > Datacenter > Add Datacenter. Optionally, you may navigate to Resources > VDI(0) and click on the Datacenter Setup link in item (2.) of the instructions, as shown in Figure 2 above, to arrive on the same page. Click on the Add Datacenter button to raise the "Name this Datacenter" dialog. Figure 3 - Name this Datacenter

    Provide a meaningful name to identify the Datacenter's profile. "Cupertino DC" is used in this example where DC is short for Data Center. Click on the Save button.

    Now, the Datacenter profile is displayed. There are a few items here to highlight: (1) the Add Configuration button is disabled, (2) make a note of the Integration Key, this will be used when installing the Enterprise Connector, (3) Connector Version is blank, and the Connector Status is shown as Not Installed. Refer to Figure 4 below.   Figure 4 - Add Datacenter Completed - Enterprise Connector Not Installed

    After the Enterprise Connector that matches the Integration Key has been installed, the Add Configuration button is enabled, the Connector Version is filled in, and the Connector Status is shown as Connected. Refer to Figure 5 below. Figure5 - Add Datacenter - Enterprise Connector Installed, Version and Status Available

  3. Add Configuration for Nutanix Acropolis: Navigate to Company > Datacenter and click on the Add Configuration button. The panel titled "Add a Configuration for the <datacenter name> datacenter" is posed.

    1. Provide a meaningful Name to identify this configuration profile, "Nutanix" is used in this example. Select Nutanix as the Configuration Type. Figure 13 - Add Configuration - Nutanix - Configuration Type and Name.

    2. Enter the Nutanix Prism Address (IP address) - the FQDN or hostname of the PRISM web console may be used as well. The Nutanix Prism Address, shown in Figure 15 below, is the NETBIOS name "CVM". (Note: The IP address is listed in the PRISM VM table as the Nutanix Controller VM with a name similar in form to "NTNX-1acce551-A-CVM").
    3. Enter Port number for management interface (Nutanix Default is 9440).
    4. Configure to Allow Self Signed Certificates or do not allow. Figure 14 - Add Configuration - Nutanix - Host, Port, Certificate

    5. Enter User Name and Password for Nutanix Prism admin account used for provisioning Virtual Machines (VMs). Figure 15 - Add Configuration - Nutanix - Service Account for Provisioning Virtual Machines (VMs)

    6. Click on the Save button. The "Datacenter configuration created successfully" message is displayed and the Nutanix configuration panel shows the Configuration Type, Host, Port, and User Name. Figure 16 - Add Configuration - Nutanix - "Datacenter config created successfully"

  4. Add Pool: Navigate to Resources > VDI to provision Virtual Machines (VMs). Click on the Add Pool button. Optionally, you may click on the VDI Setup link in item (4.) of the instructions, as shown in Figure 2 previously, to arrive on the same page. Pools may also be created using the Import Desktops from Config option under Import Pool. Refer to Section 7 covering which covers importation of pre-defined VDI pools.

    1. Navigate to Resources > VDI and click on the Add Pool button to display the Create Your Virtual Desktops panel. Provide a Desktop Pool Name and Select a Config. Note that the Desktop Pool Name is the display name of the VM in the user's Workspot.   Figure 17 - Add Pool - Create Your Virtual Desktops

    2. Upon selecting the config, "Nutanix" for the purposes of this guide, the Select a Template panel is posed. Enter a name-part for a desired template and click on Select button listed next to the template for purpose of the pool. Figure 18 - Add Pool - Select a Template

    3. Enter the Number of Desktops to provision. Enter the Naming Prefix and Suffix Length that is used to uniquely name each virtual desktop during provisioning. Click on the Upload an icon link if a different icon is desired representing the desktop in the Workspot Cient. Figure 19 - Add Pool - Enter the Paramters for Pool
        Figure 20 - Add Pool - Upload an Icon

    4. Manage Virtual Desktops and Check Progress during provisioning. Figure 21 - Add Pool - Manage Virtual Desktops - Check Progress
        Figure 22 - Add Pool - Virtual Desktops Creation Progress - 0% - Waiting for IP...
        Figure 23 - Add Pool - Virtual Desktops Creation Progress - 0% - Powering On...
        Figure 24 - Add Pool - Virtual Desktops Creation Progress - 67% - Online
        Figure 25 - Add Pool - Virtual Desktops Creation Progress - 100% Complete

    5. After completion of pool creation, click on the < Back to Pool Details link to see the list of virtual desktops provisioned for the Ops Windows 10 E Desktop Pool (3). Figure 26 - Add Pool - Manage Virtual Desktops - Back to Pool Details

    6. Logging into Nutanix Prism and going to VM > Table, the virtual desktops provisioned through Control are listed. Figure 27 - Add Pool - Nutanix - VM Table View

    7. Once the first pool has been created, the Virtual Desktop Infrastructure (VDI) Setup instructions are no longer displayed. The instructions panel is replaced with the list of pools that are available for management. Figure 28 - Add Pool - Manage Virtual Desktop Pools (1) list

  5. Assign Desktops: Navigate to Resources > VDI to assign Virtual Machines (VMs). Click on the Assign Desktops button. Click on name of the pool to open the Manage Virtual Desktops.

    1. Click on the name of the pool you want to make assignments in. For the purposes of this guide, the "Ops Windows 10 E Desktops Pool" in Figure 28 above, was selected, containing the three (3) Desktops that were provisioned earlier. Figure 29 - Assign Desktops - Ops Windows 10 E Desktops Pool (3)

    2. In Figure 29 above, all three (3) provisioned desktops were selected. Clicking on the Assign Desktops button poses the "Assign Selected Virtual Desktop(s) to New Users Desktops:" tool. The tabs shown under All Users act as search filters: (1) Workspot - search users that are registered with your company in Workspot Control. Figure 30 - Assign Desktops - "Assign Selected Virtual Desktop(s) to New Users Desktops:" tool

    3. For the successful assignment of users to occur, the user must have self-registered or an administrator must have created an account already. By navigating to Users > Users, the users granted the right to use a Workspot Client can be listed. Figure 31 - Assign Desktops - User Identification

    4. Navigate back to the "Assign Selected Virtual Desktop(s) to New Users Desktops:" tool. Using the Workspot filter lists the two users with accounts in Control. Using the selectors, check boxes and arrow widgets, pick the users who will be assigned a desktop. Click on the Assign button. Figure 32 - Assign Desktops - Using the "Workspot" filter and user assignment tool

    5. Since ONLY two users were selected for assignment, ONLY two desktops have been assigned users. This is evident as shown in the "Ops Windows 10 E Desktops Pool" status table below. Figure 33 - Assign Desktops - Manage Virtual Desktop Pools detail status table

    6. Additional summary status is displayed for the pool by clicking on the < Back to Desktop Pools navigation link shown in the figure above. Figure 34 - Assign Desktops - Manage Virtual Desktop Pools summary status table

    7. Navigate to Users > User Details :: Assigned Virtual Desktops. Note that desktops assigned to users are listed for their account. Figure 35 - Assign Desktops - Users > User Details :: Assigned Virtual Desktops

  6. Import Pool: Navigate to Resources > VDI. Click on the Import Pool button and use the Import Desktops from Config link. A sample spreadsheet file (.csv), similar to the one shown in Figure 38 below, can be downloaded by clicking on the Download Sample CSV button.   Figure 37 - Import Pool - Import Virtual Desktops Panel
      Figure 38 - Import Pool - Sample CSV File

Troubleshooting

    • If errors occur during installation and setup, look at the results in the "setup.log" file in the folder "C:\ProgramData\workspot\".
    • If errors occur while the connector is running, look at the contents in the "connector_<date>.log" file in the folder "C:\Program Files\Workspot_Enterprise_Connector\log\".


List of Figures in this Guide
Figure 1 - Download the Workspot Enterprise Connector
Figure 2 - Virtual Desktop Infrastructure (VDI) Setup - First Time Use (FTU)
Figure 3 - Name this Datacenter
Figure 4 - Add Datacenter - Enterprise Connector Not Installed
Figure 5 - Add Datacenter - Enterprise Connector Installed, Version and Status Available
Figure 6 - Add a Configuration to the Cupertino DC Datacenter
Figure 7 - Add Configuration - Active Directory - Configuration Type
Figure 8 - Add Configuration - Active Directory - Synchronize Member Accounts
Figure 9 - Add Configuration - Active Directory - Datacenter config created successfully
Figure 10 - Add Configuration - Active Directory - Sync is initiated...
Figure 11 - Add Configuration - Active Directory - Post-Sync, AD Status
Figure 12 - Active Directory - Enterprise Connector Compatible E-mail Entry
Figure 13 - Add Configuration - Nutanix - Configuration Type and Name
Figure 14 - Add Configuration - Nutanix - Host, Port, Certificate
Figure 15 - Add Configuration - Nutanix - Service Account for Provisioning VMs
Figure 16 - Add Configuration - Nutanix - "Datacenter config created successfully"
Figure 17 - Add Pool - Create Your Virtual Desktops
Figure 18 - Add Pool - Select a Template
Figure 19 - Add Pool - Enter the Paramters for Pool
Figure 20 - Add Pool - Upload an Icon
Figure 21 - Add Pool - Manage Virtual Desktops - Check Progress
Figure 22 - Add Pool - Virtual Desktops Creation Progress - 0% - Waiting for IP...
Figure 23 - Add Pool - Virtual Desktops Creation Progress - 0% - Powering On...
Figure 24 - Add Pool - Virtual Desktops Creation Progress - 67% - Online
Figure 25 - Add Pool - Virtual Desktops Creation Progress - 100% Complete
Figure 26 - Add Pool - Manage Virtual Desktops - Back to Pool Details
Figure 27 - Add Pool - Nutanix - VM Table View
Figure 28 - Add Pool - Manage Virtual Desktop Pools (1) list
Figure 29 - Assign Desktops - Ops Windows 10 E Desktops Pool (3)
Figure 30 - Assign Desktops - "Assign Selected Virtual Desktop(s) to New Users Desktops:" tool
Figure 31 - Assign Desktops - User Identification
Figure 32 - Assign Desktops - Using the "Workspot" filter and user assignment tool
Figure 33 - Assign Desktops - Manage Virtual Desktop Pools detail status table
Figure 34 - Assign Desktops - Manage Virtual Desktop Pools summary status table
Figure 35 - Assign Desktops - Users > User Details :: Assigned Virtual Desktops
Figure 36 - Assign Desktops - Active Directory filter use and desktop assignment
Figure 37 - Import Pool - Import Virtual Desktops Panel
Figure 38 - Import Pool - Sample CSV File

Have more questions? Submit a request

Comments

Powered by Zendesk