Lab 5: Horizon Linux Desktop Pool deployment (Easy Setup Tool)

Up until recently, the process for Deploying Linux Desktop Pools has been fairly challenging, We will be using the new Easy Install Setup tool for Horizon Linux Desktops

We will complete the following tasks

  1. Prepare Linux, copy and extract the Horizon Agent
  2. Install the Horizon Agents using the Easy Install tool
  3. Take a vSphere snapshot of the VM
  4. Create an Instant Clone Pool
  5. Test a desktop pool session
Expand or collapse content Part 1. Preparing an Ubuntu base for Horizon desktops
Expand or collapse content Section 1. Pre-Install Linux network config
  1. On your Control Center server
    • open Chrome browser
      • on the Favourites Bar
        • select the vcenter-01a shortcut
  1. In the vSphere client
    • in the User Name
    • in the Password
      • enter Pa$$w0rd
    • at the bottom of the screen
      • select LOGIN

Ensure the LinuxGolden-01a is powered ON.
The purpose of Steps 3 to 11 are to ensure that in the lab environment we don't have duplicate IP addresses when the instant clone VMs are created.

  1. In the vSphere client
    • select and right-click LinuxGolden-01a
      • from the dropdown
        • select Edit Settings..
  1. In the Edit Settings | LinuxGolden-01a window
    • in line with Network adapter 1
      • to the right
        • select the 3 buttoned Icon
      • in the pop-out
        • select Remove device
      • in the bottom corner
        • select OK
  1. In the vSphere client
    • select and right-click LinuxGolden-01a
      • from the dropdown
        • select Edit Settings..
  1. In the Edit Settings | LinuxGolden-01a window
    • in the top right corner
      • select ADD NEW DEVICE
  1. In the Edit Settings | LinuxGolden-01a window
    • in the dropdown ,
      • right at the bottom
    • select Network Adapter
  1. The Edit Settings | LinuxGolden-01a window
  • NEXT to New Network
    • from the dropdown
      • select BROWSE ...
  1. The Select Network window
  • NEXT to CorpInternal01
    • select the radio button
    • select OK
  1. The Edit Settings | LinuxGolden-01a window
    • to close the window
      • select OK
  1. In the vSphere client
    • In the Hosts & Clusters Inventory
      • select the LinuxGolden-01a virtual machine
    • In the Virtual Machine Details
  • NEXT to IP Addresses (2)
    • make a note of YOUR specified assigned DHCP IP address
      • Note: In the example its 172.16.10.151
    • Minimize your Chrome browser
  1. On the ControlCenter server desktop
    • select and launch the PuTTy shortcut
  1. In the PuTTyConfiguration window
    • under Host Name (or IP address)
      • enter Your DHCP IP address for LinuxGolden-01a
    • under Saved Sessions
      • enter LinuxGolden-01a
    • under Saved Sessions
      • enter LinuxGolden-01a
      • select select Save
    • select Open
    • In the PuTTySecurity Alert window
      • select Accept
  1. In the PuTTyWindow
  • NEXT to login as:
    • enter omni
  • NEXT to password:
    • enter Pa$$w0rd
Expand or collapse content Section 2. Copy and extract the Horizon Agent
  1. On your ControlCenter server Taskbar
    • in the search
      • enter WinSCP
    • launch your WinSCP client
  1. In the WinSCP client
    • below Host name:
      • enter your Linux Golden Image IP address
    • below User name:
      • enter omni
    • below Password
      • enter Pa$$w0rd
    • select Login
    • In the Warning window
      • select Accept
  1. In the WinSCP window
    • In the right pane, navigate up one level
      • select home
      • in the folder hierarchy of home
        • open omni
      • in the folder hierarchy of omni
        • select Downloads
  1. On the ControlCenter server desktop
    • open the software shortcut
      • open the Horizon > 2503 folder
        • select Omnissa-horizonagent-linux-x86_64-2503-8.15.0-xx.tar.gz
        • right-click
          • select Copy
        • switch back to WinSCP
  1. In the WinSCP window
    • In the right pane
      • select and right-click to launch the menu
        • select Paste
      • In the Upload window
        • select OK
    • switch to your PuTTy session
  1. In your PuTTy Ubuntu desktop session:
    • type the following commands, pressing ENTER after each one.
cd /home/omni/Downloads/
  • List the files in the /Downloads$ folder
 ls -l
  • Extract the files from the agent bundle
tar -zxvf Omnissa-horizonagent-linux-x86_64-2503-8.15.0-14301895253.tar.gz

Note: You can use the tab key to help auto complete typing the command, especially the Omnissa-horizonagent... portion.

  1. In your PuTTy Ubuntu desktop session,
    • List the files in the /Downloads$ folder
 ls 
  • Change into the folder created when you extracted the Horizon Agent files.
 cd Omnissa-horizonagent-linux-x86_64-2503-8.15.0-14301895253/
Expand or collapse content Part 2. Deploying the Linux Horizon Agent using the Easy Setup Tool in Expert mode
  1. In the PuTTy session
    • type the following command
touch config.txt
  1. Install the Horizon Agent
    • Enter the following command and press ENTER
sudo ./easyinstall_viewagent.sh -l expert -f config.txt
  • NEXT to [sudo] password for omni:
    • Pa$$w0rd
  1. Enter the DNS server information (1)
    • 192.168.110.10
  1. Enter the host name (2)
    • linuxgolden-01a
  1. Enter the NTP server information (3)
    • leave blank
  1. Select to join active directory (4)
    • press Enter

Note when the option is in CAPS, this is the default, it is therefore not necessary to enter Y.

  1. Enter the domain FQDN (5)
    • techseals.co

Best Practice from our Engineering team is to enter this in Lower Case

  1. Input the user name used to join domain (6)
    • administrator
  1. Input the user name used to join domain (7)
    • Pa$$w0rd

Note you will not see you password being typed, so be careful regarding Syntax errors

  1. Input the computer OU DN to join (8)
OU=Computers,OU=Corp,DC=techseals,DC=co

Note: This canonical name is case sensitive

  1. A summary of the inputs will be displayed
    • NEXT to * Do you agree with the inputs above? [Y/n]
    • Press Enter

Note Y is in CAPS therefore Yes is the default

  1. All the required dependencies will now be installed and configured
    • Sections 2 , 3 and 4 of Phase 1 deploy the dependencies, set the hostname configuration and Domain Join
  1. The OMNISSA GENERAL TERMS page will display
    • To Accept
      • press TAB
      • press ENTER

The following prompts allow you to choose which features of the Horizon Agent are enabled.

A capital Y indicates that Yes is the default response.

A capital N indicates that No is the default response.

  1. Select to configure the Horizon agent in managed mode
    • Press ENTER
  1. Input to not support multiple sessions
    • Press ENTER
  1. Input to not support webcam redirection
    • Press ENTER
  1. Input to not support audio input redirection
    • Press ENTER
  1. Input to support USB redirection
    • Enter y
    • Press ENTER

Note y is not the default

  1. Input to download the zipped VHCI source code
    • Press ENTER to leave this blank and download from the default URL
  2. Input to not support IPv6 network
    • Press ENTER
  1. Input to not disable single-session application pools
    • Press ENTER
  1. Input to not support FIPS
    • Press ENTER
  1. Input to not support smartcard redirection
    • Press ENTER
  1. Input to support client drive redirection
    • Press ENTER
  1. Input to support clipboard redirection
    • Press ENTER
  1. Input to support printer redirection
    • Press ENTER
  1. Input to not skip building the required kernel modules
    • Press ENTER
  2. Input to not disable the Omnissa Greeter
    • Press ENTER
  1. Input to support single sign on
    • Press ENTER
  1. Input to not support True SSO
    • Press ENTER
  1. Input the preferred self signed cert subject DN
    • Press ENTER
  1. Input the preferred JMS SSL keystore password
    • Press ENTER
  1. Select to not restart after installation
    • Press ENTER
  1. A summary of your inputs will be displayed
    • Press ENTER
  1. Reboot Linux
    • Enter the following command and press ENTER
sudo reboot
  • NEXT to [sudo] password for omni:
    • Pa$$w0rd
Expand or collapse content Part 3: Taking a vSphere Snapshot
  1. Switch back to the vSphere client
  2. Shut down the Linux VM
    • Select and right-click LinuxGolden-01a
      • select Power > Shut Down Guest OS
    • In the Confirm Guest Shut Down window
      • select YES
  1. Take a snapshot of the VM
    • Select and right-click LinuxGolden-01a
      • Select Snapshots > Take Snapshot...
  1. In the Take snapshot window
    • NEXT to Name enter Agent Installed
    • Press CREATE
Expand or collapse content Part 4. Deploying a Linux based Instant Clone Pool
  1. In the Horizon Admin Console
    • In the left pane under Inventory,
      • Select Desktops
  1. In the Desktop Pools
    • Select ADD
  1. Select the Type of desktop pool
    • Leave the default of Automated Desktop Pool
    • Click NEXT
  1. Select the clone type and the vCenter Server to use
    • Leave the default clone type of Instant Clone
    • There is only one vCenter Server in this environment
    • Click NEXT
  1. Change the User Assignment
    • Select the radio button next to Floating
    • Click NEXT
  1. Confirm the Storage Optimization configuration
    • Click NEXT
  1. Complete the Desktop Pool Identification
    • Under ID
      • Enter Linux-INST
    • Under Display Name
      • Enter LinuxINST
    • Click NEXT
  1. Input the Provisioning Settings
    • Under Use a Naming Pattern
      • Enter LinuxINST-
    • Under Desktop Pool Sizing > Maximum Machines
      • Enter 2
    • Click NEXT
  1. Complete the vCenter Settings
    • Golden Image in vCenter:
      • Click the BROWSE button
      • Select the LinuxGolden-01a Golden Image
      • Click SUBMIT
    • Snapshot
      • Click the BROWSE button
      • Select the snapshot called Agent Installed
      • Click SUBMIT
    • VM Folder Location
      • Click the BROWSE button
      • Select RegionA01
      • Click SUBMIT
    • Cluster (Resource Settings)
      • Click the BROWSE button
      • Select BLRCapacity
      • Click SUBMIT
    • Resource Pool (Resource Settings)
      • Click the BROWSE button
      • Select BLRCapacity
      • Click SUBMIT
    • Datastores (Resource Settings)
      • Click the BROWSE button
      • Select CorpLUN-01a
      • Click SUBMIT
      • In the Warning window select OK
    • Click NEXT
  1. Configure the Desktop Pool Settings
    • Under Log off After Disconnect:
      • From the dropdown list select Immediately
    • Click NEXT
  1. Configure the Remote Display Settings
    • Accept the defaults
    • Click NEXT
  1. Configure the Guest Customization
    • Below Domain
      • validate that techseals.co(instant) is selected
    • To the right of AD Container select BROWSE
      • In the AD Container window
      • Expand OU=Corp
      • Select OU=Computers,OU=Corp
      • Click SUBMIT
  1. Select to Allow Reuse of Existing Computer Accounts
    • Select the checkbox
    • Click NEXT
  2. Review the Ready to Complete summary of your input
    • Select the checkbox next to Entitle Users After Adding Pool
    • Click SUBMIT
  1. In the Add Entitlements window
    • Select ADD
  1. Add a group entitlement to the desktop pool
    • In the row Name/User Name, in the box to the right of Starts with
      • Enter IT Support
    • Click Find
    • Select the checkbox next to IT Support
    • Click OK to close the Find User of Group window
    • Click OK to close Add Entitlements
  1. In the Info window
    • Click OK
  1. In the Desktop Pools screen
    • In the top right part of the desktop Pools screen select the Refresh button
    • Select the Linux-INST entry
  1. On the Summary tab
    • Scroll down to Secondary Image
      • View the progress of the pool being Provisioned
    • To the right, notice the State is Publishing
      • When complete this will report as Published
    • You will need to have to wait until the Pool is Published

NOTE: The page does not dynamically update. You will have to refresh periodically.

  1. In the Horizon Admin Console
    • Under Inventory
      • Select Machines
  1. View the Machines Status
    • Use the scroll bar at the bottom of the window and scroll to the right of the screen
    • Wait until the Status shows Available for your Machines
Expand or collapse content Part 5. Testing the Linux Desktop Pool
  1. On your Control Center server
    • Select and launch the Omnissa Horizon Client shortcut
  1. In the Horizon Client window
    • Select which Horizon environment top connect to
    • Double-click on horizon-01a.techseals.co
  1. In the Horizon Sign in window
  1. Select the desktop pool
    • Double-click on LinuxINST
  1. In the Horizon client
    • Note you now have a Linux Desktop experience
    • You can now log off the session

0 Comments

Add your comment

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.