You can configure the VMware Horizon Web Portal page to show or hide the icon for downloading Horizon Client, the icon for connecting to a remote desktop through HTML Access, and other links.
By default, the VMware Horizon Web Portal page shows both an icon for downloading and installing Horizon Client and an icon for connecting through HTML Access. The default values defined in the portal-links-html-access.properties file determine the download link that appears on the VMware Horizon Web Portal page.
Sometimes, you might want the links on the VMware Horizon Web Portal page 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 VMware Horizon Web 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 determines 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 directory. If this file is missing during the
HTML Access session, the download link directs 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://play.google.com/store/apps/details?id=com.vmware.view.client.android
link.winmobile=https://www.microsoft.com/en-us/store/p/vmware-horizon-client/9nblggh51p19
You can define installer links for specific client operating systems in the portal-links-html-access.properties file or the oslinks.properties file. For example, if you browse to the VMware Horizon Web Portal page from a macOS system, the link for the Horizon Client for Mac installer appears. For Linux clients, you can make separate links for 32-bit and 64-bit installers. For Chrome clients, you can substitute the link to Horizon Client for Chrome in the Chrome Web Store (https://chrome.google.com/webstore/detail/vmware-horizon-client-for/ppkfnjlimknmjoaemnpidmdlfchhehel).
Procedure
- On the Connection Server host, use a text editor to open the portal-links-html-access.properties file CommonAppDataFolder\VMware\VDM\portal\portal-links-html-access.properties directory.
The
CommonAppDataFolder directory is usually in the
C:\ProgramData directory. To show the
C:\ProgramData folder in Windows Explorer, use the Folder Options dialog box to show hidden folders.
If the portal-links-html-access.properties file does not exist, but the oslinks.properties file does exist, 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.
- Edit the configuration properties.
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 website. To disable an icon, which removes the icon from the web page, set the property to
false.
Note: The
oslinks.properties file can be used only to configure the links to the specific installer files.
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. 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 the Connection Server host, you can use relative URLs as described in the next step.
- General link to download installer:
link.download=https://server/downloads
- 32-bit Windows installer:
link.win32=https://server/downloads/VMware-Horizon-Client-x86-build#.exe
- 64-bit Windows installer:
link.win64=https://server/downloads/VMware-Horizon-Client-x86_64-build#.exe
- Windows Phone installer:
link.winmobile=https://server/downloads/VMware-Horizon-Client-build#.appx
- 32-bit Linux installer:
link.linux32=https://server/downloads/VMware-Horizon-Client-build#.x86.bundle
- 64-bit Linux installer:
link.linux64=https://server/downloads/VMware-Horizon-Client-build#.x64.bundle
- macOS installer:
link.mac=https://server/downloads/VMware-Horizon-Client-build#.dmg
- iOS installer:
link.ios=https://server/downloads/VMware-Horizon-Client-iPhoneOS-build#.ipa
- Android installer:
link.android=https://server/downloads/VMware-Horizon-Client-AndroidOS-build#.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 website. The Help link appears at the bottom of the login page. |
- To have users download installers from a location other than the VMware website, place the installer files on the HTTP server where the installer files reside.
This location must correspond to the URLs that you specified in the
portal-links-html-access.properties file or in 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 can then use relative URLs with the format /downloads/client-installer-file-name.
- Restart the Horizon Web Component service.