Horizon 7.0 – Install and configuration

Horizon 7 is the latest version of VMware’s virtual desktop product. In a previous post I talked about what was new in version 7 but I thought it was about time I got my hands dirty and had a go at installing it.

If you’ve ever installed any previous versions it’s not a great deal different, but the good news is, it’s still very simple to get up and running. It’s also got a non disruptive upgrade process.

What you’ll need:

1 or more Windows servers for the connection server component

1 Windows server for the View Composer component

1 Windows server for View Composer SQL (optional)

Administrator access to your domain

Administrator access to vCenter


View Composer Installation

  1. Log into the View composer windows server and run the view composer setup as an administrator. On the welcome screen, click ‘next’.horizon720
  2. Click the button to accept the EULA and click ‘next’.horizon721
  3. If you want to change the install path select ‘change’, otherwise, just click ‘next’ to continue.horizon722
  4. The View Composer installation requires an SQL database. You can either install SQL locally on this server or use a remote SQL server. Whichever you choose to do you must first create an empty database in SQL and give permissions to the view composer service userhorizon723
  5. Once you’ve completed these steps, click the ODBC DSN Setup, and create an ODBC connection to  your database under the ‘system DSN’ tab. Once complete and tested, click ‘ok’horizon724
  6. Back on the database selection screen, enter the ODBC alias name and enter the username and password of the account you granted database permissions to, then click ‘next’.horizon725
  7. Leave the SOAP port settings as default and choose which certificate you want to use. I’m leaving the default settings.horizon726
  8. Now we’ve completed these configuration steps, click ‘install’ to start the installation.horizon727
  9. Monitor the progress of the installationhorizon728
  10. Depending on the user you’re logged in as, you may receive this error. It’s because you’re logged in as a user other than the view composer account and the account doesnt have rights to start the service. If you do receive this, open services.msc and edit the service properties and set the service to run as the view composer user. You should now be able to manually start the service. Once you’ve done this, come back to the error and click ‘retry’. Now it should detect the service is running and should continue.horizon729horizon730horizon731horizon732
  11. The installation should now show as running.horizon733
  12. Once the installation is complete, click ‘finish’horizon735
  13. Finally you will be prompted to reboot the server.horizon736


Connection Server Installation

  1. Log into the view connection server and run the connection server executable as a local administrator. On the Welcome screen, click ‘next’horizon71
  2. Click on the button to accept the EULA, and click ‘next’.horizon72
  3. Now you can choose an alternate location for your install if you wish by clicking ‘change’. If you’re happy with the default, click ‘next’horizon73
  4. Here you can choose the type of install. To summarise, Standard server is for your first connection server, Replica is for any subsequent connection servers, Security is for your DMZ gateway and Enrollment is a new option for doing True SSO with VMware Identity manager. For this install, select ‘Standard’ and then if you’re happy to use ipv4, click ‘next’.horizon74
  5. The install will continue for a few seconds.horizon705
  6. You’ll then be asked to enter a recovery password and reminder. Enter these and click ‘next’.horizon75
  7. Choose whether you want the install to configure your windows firewall or not. If you select configure, the install will populate all the necessary roles. If you don’t use the windows firewall you can choose the second option, then click ‘next’.horizon76
  8. Now you must choose a group to populate the Horizon administrators group. You can either choose the server local admins group, or you can specify a domain group. Once you’ve done one of these, click ‘next’.horizon77
  9. Select whether you want to participate in the user experience improvement program and click ‘next’horizon78
  10. On the next screen, click ‘install’ to begin the installation.horizon79
  11. The install itself will take a few mins.horizon710
  12. Once it completes, you get an option to view the readme or not, then click ‘finish’.horizon711
  13. Thats the connection server installation done. If you now open a web browser and go to https://connectionservername/admin, you should see the admin login page below. Enter an account thats a member of the admins group you specified during the install and click ‘login’.horizon712
  14. Once logged in you should see the Horizon dashboard. It may look a little daunting if you havent used it before but lets start with the simple stuff. Click the ‘edit license’ button in the top left corner.horizon713
  15. Once you’ve added your license key, it should look like the entry below.horizon714
  16. Next, click ‘servers’ in the left hand menu. The first thing we need to do in this section is specify the vCenter server. Click the ‘add’ button.horizon715
  17. In the new wizard that appears, enter the details for your vCenter server. You can also amend a number of settings below if you feel necessary. My advice is leave these as defaults for now as you can always come back and edit them later.horizon716
  18. If you receive a warning about the vCenter certificate, click the view button and accept the certificate.             horizon717
  19. Here you can choose whether to use View Composer or not. If you choose to configure it, enter hte details and click ‘next’ to continue.horizon718
  20. Now you must specify the domains you want view composer to be able to use. Enter the domains by clicking ‘add’ and entering the details, then click ‘next’horizon7293
  21. On the storage screen you can specify some storage settings. I would advice checking both boxes and then clicking ‘next’horizon7294
  22. Check the selected settings in the summary screen and click ‘finish’horizon7295
  23. Back on the main dashboard you should now be able to see the vCenter server in the list. Ensure that the colums to the right have green ticks inhorizon7296
  24. If you want to use the new Instant clones functionality, click on ‘instant clone domain admins’ on the left hand menu, and click ‘add’ at the top.horizon7297
  25. Add the details for an admin in the domain and click ‘ok’. You will notice a limitation here in that whereas view composer will allow you provision machines in multiple different domains, instant clones only supports a single domain administrator account.                                     horizon7298
  26. Once back on the main dashboard you should see the instant clones admin in the list.horizon7299
  27. Click on ‘event configuration’ at the bottom of the left hand menu, and click the ‘edit’ buttonhorizon7230
  28. Here you must enter the details of the events database. Before you can complete this section you must have created an empty database and you must have created an SQL user and delegated permissions. The events database only supports SQL authentication and not windows. Once you’ve completed these steps, click ‘ok’ If your database and permissions are ok the window should close.horizon740
  29. You should now be taken back to the dashboard where you should see a screen like the one below.horizon741
  30. On the right hand side, next to the events database settings you’ll see syslog settings. Click the ‘edit’ buttton to add a syslog server. Enter the address of your syslog or Log Insight server and click ‘ok’horizon742
  31. You should now see the entry in the box belowhorizon743

Horizon Agent Installation

  1. Now we’ve installed the server components we need to set up a desktop to deploy. Once you have your Windows desktop build in place with the latest version of the tools installed, we are ready to install the Horizon 7 agent. Run the agent installer and on the welcome screen, click ‘next’horizon751
  2. Click the button to accept to accept the EULA and click ‘next’horizon752
  3. Select whether you want to use IPv4 or 6 and click ‘next’horizon753
  4. Here is the interesting bit. You have the chance here to select which components are installed. You have an important choice to make here and that is whether to use View Composer or Instant Clones. Unfortunately you cannot install both (if you try you’ll get an error like below) so pick the one you’re going to use. If at a later time you want to change you just need to modify the install. Decide which you’re going to use and click ‘next’horizon754
  5. This is the error you’ll see if you try to install both featureshorizon755
  6. On the install screen, click ‘install’horizon756
  7. You’ll see the progress of the install until it completeshorizon758
  8. Once the install is complete, click ‘finish’horizon759
  9. You’ll be prompted to reboot the server to complete the install.horizon760
  10. Once the reboot has completed, use vCenter web console to create a snapshot of the server. This will be used in the provisioning process.


Creating a desktop pool

  1. Now we’ve got all the installs done, lets set up a desktop pool. As it’s one of the new Horizon 7 features, i’m going to show you how to do this using instant clones. To begin with, click on ‘desktop pools’ in the left hand menu.horizonpool1
  2. First you have to select the type of pool. Click ‘automated desktop pool’ and click ‘next’horizonpool2
  3. Next, you have to choose whether you want a dedicated or floating assignments. Select ‘floating’ and click ‘next’horizonpool3
  4. This step is key. Here you can choose to use either full clones, view composer or instant clones to create your desktops. Click Instant clones and select the vCenter server underneath, then click ‘next’horizonpool4
  5. Enter a pool ID, this is just a name to identify it. Click ‘next’horizonpool5
  6. Here you can make various changes to the pool settings, including the protocol selection. Once you’ve selected your required settings, click ‘next’horizonpool6
  7. On the provisioning settings screen, give your pool a naming convention and remember numbers will be appended onto the end. You also need to specify the pool size, then click ‘next’horizonpool7
  8. There are some VSAN options here which will be greyed out if you aren’t using it. Click ‘next’horizonpool8
  9. This is the screen where we select the machine we are going to use as the gold image. Click ‘browse’ to the right or ‘parent VM’horizonpool9
  10. Horizon will look in vCenter for candidates that can be gold images. Select the ones you want and click ‘ok’horizonpool10
  11. Repeat the process but this time for the snapshot by clicking the ‘browse’ button. Horizon will search vCenter for any snapshots on the selected VM. Select the snapshot you want to use and click ‘ok’horizonpool11
  12. Click ‘browse’ next to VM location and pick a vCenter folder to create your VMs in, then click ‘ok’horizonpool12
  13. ‘Click browse’ next to cluster and pick the cluster to run the pool on and click ‘ok’                                           horizonpool13
  14. Repeat for resource pool. Select the one you want to use and click ‘ok’horizonpool14
  15. Lastly, click browse next to datastores, and check the box next to all the datastores you want desktops to be provisioned on, then click ‘ok’horizonpool15
  16. It should look something like this when you’re done. Click ‘next’horizonpool16
  17. On the guest customisation screen, you can choose the domain to provision to and select the AD folder the desktops will be created in. You can also select scripts to run after desktop creation. These scripts should be placed in the gold image. Click ‘next’horizonpool17
  18. You should see all the settings you’ve selected in a summary screen. Click ‘finish’horizonpool18
  19. Back in the Horizon portal you should see your pool in the list.horizonpool19
  20. Switching over to vCenter, keep your eye on the recent tasks pane. You should see some cloning tasks kick off.horizonpool20
  21. A refresh of vCenter should also reveal some template machines are being created.horizonpool21
  22. Once templates are created, you’ll see some replicas are created.horizonpool22
  23. Give it some time and eventually you should see something like this. There should be a single template, a replica for each datastore and a parent for each host and each datastore. The parents should power on and you should see the instant clone process create new desktops and power them on.horizonpool23
  24. Now that the pool is created and we have deployed some desktops, the last bit before users can access is to grant them access to it. In order to do this first of all click on ‘ desktop pools’ on the left hand menu and then click on the pool you wand to entitle users on, then click the ‘entitlements’ button and ‘add entitlement’horizonpool24
  25. When the new window appears, click the ‘add’ buttonhorizonpool25
  26. Another window will open allowing you to search for users and/or groups in the directory. Type something in the name field and click ‘find’horizonpool26
  27. Results for the search should be returned. Pick either a single name or multiples by holding down the shift key, and click ‘ok’horizonpool27
  28. You should see the names you selected appearing in the list. Once you’ve added all the users you want to add click ‘ok’horizonpool28

Thats it. Your entitled users should now be able to access their desktops by using either the Horizon clicent, or (if youve enabled it in the pool settings) the web client.





Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s