You can configure this Web page to show or hide the icon for downloading Horizon Client or the icon for connecting to a remote desktop through HTML Access. You can also configure other links on this page.

About this task

By default, the portal page shows both an icon for downloading and installing the native Horizon Client and an icon for connecting through HTML Access. In some cases, however, you might want to have the links point to an internal Web server, or you might want to make specific client versions available on your own server. You can reconfigure the page to point to a different URL.

You can make installer links for specific client operating systems. For example, if you browse to the portal page from a Mac OS X system, the link for the native Mac OS X installer appears. For Windows clients, you can make separate links for 32-bit and 64-bit installers.

Important:

If you upgraded from View Connection Server 5.x or an earlier release and did not have the HTML Access component installed, and if you previously edited the portal page to point to your own server for downloading Horizon Client, those customizations might be hidden after you install View Connection Server 6.0 or later. With Horizon 6 or later, the HTML Access component is automatically installed during an upgrade of View Connection Server.

If you already installed the HTML Access component separately for View 5.x, any customizations you made to the Web page are preserved. If you did not have the HTML Access component installed, any customizations you had made are hidden. The customizations for earlier releases reside in the portal-links.properties file, which is no longer used.

Procedure

  1. On the View Connection Server host, open the portal-links-html-access.properties file with a text editor.

    The location of this file is CommonAppDataFolder\VMware\VDM\portal\portal-links-html-access.properties. For Windows Server 2008 operating systems, the CommonAppDataFolder directory is C:\ProgramData. To display the C:\ProgramData folder in Windows Explorer, you must use the Folder Options dialog box to show hidden folders.

    Note:

    Customizations for View 5.x and earlier releases resided in the portal-links.properties file, which is located in the same CommonAppDataFolder\VMware\VDM\portal\ directory as the portal-links-html-access.properties file.

  2. Edit the configuration properties to set them appropriately.

    By default, both the installer icon and the HTML Access icon are enabled and a link points to the client download page on the VMware Web site. To disable an icon, which removes the icon from the Web page, set the property to false.

    Option

    Property Setting

    Disable HTML Access

    enable.webclient=false

    If this option is set to false but the enable.download option is set to true, the user is taken to a Web page for downloading the native Horizon Client installer. If both options are set to false, the user sees the following message: "Contact your local administrator for instructions on accessing this Connection Server."

    Disable downloading Horizon Client

    enable.download=false

    If this option is set to false but the enable.webclient option is set to true, the user is taken to the HTML Access login Web page. If both options are set to false, the user sees the following message: "Contact your local administrator for instructions on accessing this Connection Server."

    Change the URL of the Web page for downloading Horizon Client

    link.download=https://url-of-web-server

    Use this property if you plan to create your own Web page.

    Create links for specific installers

    The following examples show full URLs, but you can use relative URLs if you place the installer files in the downloads directory, which is under the C:\Program Files\VMware\VMware View\Server\broker\webapps\ directory on View Connection Server, as described in the next step.

    • 32-bit Windows installer:

      link.win32=https://server/downloads/VMware-Horizon-Client.exe
    • 64-bit Windows installer:

      link.win64=https://server/downloads/VMware-Horizon-Client.exe
    • Linux installer:

      link.linux=https://server/downloads/VMware-Horizon-Client.tar.gz
    • Mac OS X installer:

      link.mac=https://server/downloads/VMware-Horizon-Client.dmg
    • iOS installer:

      link.ios=https://server/downloads/VMware-Horizon-Client-iPhoneOS.zip
    • Android installer:

      link.android=https://server/downloads/VMware-Horizon-Client-AndroidOS.apk

    Change the URL for the Help link

    link.help

    By default, this link points to a help system hosted on the VMware Web site. The Help link appears in the upper-right corner of the screen. For the HTML Access login screen and the desktop selector screen, the Help link is a question mark icon. After you are logged in to a desktop, the Help link is a Help command in the drop-down menu on the right end of the client menu bar.

  3. To have users download installers from a location other than the VMware Web site, place the installer files on the HTTP server where the installer files will reside.

    This location must correspond to the URLs you specified in the portal-links-html-access.properties file from the previous step. For example, to place the files in a downloads folder on the View Connection Server host, use the following path:

    C:\Program Files\VMware\VMware View\Server\broker\webapps\downloads

    The links to the installer files could then use relative URLs with the format /downloads/client-installer-file-name.

  4. Restart the View Web Component service.