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 web portal page shows both an icon for downloading and installing the native Horizon Client, and an icon for connecting through HTML Access. The download link used is determined from the default values defined in the portal-links-html-access.properties file.
In some cases, however, you might want to have the links to point to an internal Web server, or you might want to make specific client versions available on your own server. You can reconfigure the portal page to point to a different download URL by modifying the contents of the portal-links-html-access.properties file. If that file is unavailable or is empty, and the oslinks.properties file exists, the oslinks.properties file is used to determine the link value for the installer file.
The oslinks.properties file is installed in the installation-directory\VMware\VMware View\Server\broker\webapps\portal\WEB-INF folder. If this file is missing during the HTML Access session, the download link will direct users to https://www.vmware.com/go/viewclients by default. The file contains the following default values:
link.download=https://www.vmware.com/go/viewclients # download Links for particular platforms link.win32=https://www.vmware.com/go/viewclients#win32 link.win64=https://www.vmware.com/go/viewclients#win64 link.linux32=https://www.vmware.com/go/viewclients#linux32 link.linux64=https://www.vmware.com/go/viewclients#linux64 link.mac=https://www.vmware.com/go/viewclients#mac link.ios=https://itunes.apple.com/us/app/vmware-view-for-ipad/id417993697 link.android=https://play.google.com/store/apps/details?id=com.vmware.view.client.android link.chromeos=https://chrome.google.com/webstore/detail/vmware-horizonclient/ pckbpdplfajmgaipljfamclkinbjdnma link.winmobile=https://www.microsoft.com/en-us/store/p/vmware-horizon-client/9nblggh51p19
You can make installer links for specific client operating systems in either the portal-links-html-access.properties or oslinks.properties file. 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 or Linux clients, you can make separate links for 32-bit and 64-bit installers.
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 Connection Server 6.0 or later. With Horizon 6 or later, the HTML Access component is automatically installed during an upgrade of Connection Server.
If you already installed the HTML Access component separately for Horizon 7 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.
- On the 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.
If the portal-links-html-access.properties file does not exist and the oslinks.properties file does, open the <installation-directory>\VMware\VMware View\Server\broker\webapps\portal\WEB-INF\oslinks.properties file to modify the URLs to use for downloading specific installer files.Note:
Customizations for Horizon 7 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.
- 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.Note:
The oslinks.properties file can only be used to configure the links to the specific installer files. It does not support the other options listed below.
Disable HTML Access
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
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
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 Connection Server, as described in the next step.
General link to download installer:
32-bit Windows installer:
64-bit Windows installer:
Windows Phone installer:
32-bit Linux installer:
64-bit Linux installer:
Mac OS X installer:
Chrome OS installer:
Change the URL for the Help link in the login page
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.
- 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 or the oslinks.properties file from the previous step. For example, to place the files in a downloads directory on the 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.
- Restart the Horizon Web Component service.