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
    • Installer for an unknown OS (for example, you could use this property for the Chrome client installer):

      link.unknown=https://server/downloads/VMware-Horizon-Client-AndroidOS-arm-ARC.apk

    Change the URL for the Help link in the login page

    link.help

    By default, this link points to a help system hosted on the VMware Web site. The Help link appears at the bottom of the login page.

  3. (Optional) : Change the URL for the Help link in the sidebar.

    After you are logged in to a remote desktop or application, the Help button is located in the About box, which you can display by clicking Horizon at the top of the sidebar. You can also access the Help button from the Settings window.

    To change the URL for this link, edit the HELP_URL_VIEW property in the appropriate file in the ViewConnectionServer-InstallDir\webapps\portal\desktop\locale\ directory, where ViewConnectionServer-InstallDir is the installation directory for View Connection Server. The default installation directory is C:\Program Files\VMware\VMware View\Server\broker\.

    For example, if you are using English, edit the HELP_URL_VIEW property in the en.json file.

  4. 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 directory 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.

  5. Restart the View Web Component service.