Linux Agent to Horizon Client Redirection

Horizon Linux Agent only supports browser-based URL redirection to Horizon Clients (Windows, Mac, and Linux).

To use agent-to-client redirection, perform the following configuration tasks.

1. Install the Omnissa URL Redirection extension. The extension is available for Chrome or Microsoft Edge. For more information, see Installing Browser Extensions for URL Content Redirection.

2. Install the Linux Agent with URL Redirection.

• Run the installer with the --url-redirection flag

  • Normal Installation: sudo ./install_viewagent --url-redirection

  • RPM-based Installation: sudo /usr/lib/omnissa/viewagent/bin/viewSetup.sh --url-redirection

3. Configure redirected URLs.

• Add the URLs that need to be redirected in the clientrules section of /etc/omnissa/url-config.json based on your redirection protocol (HTTP or HTTPS).

  • URL format and rule syntax scenarios:

    • Rule: .*mycompany.com redirects all URLs containing mycompany.com, including the parent page. For example, http://mycompany.com.

    • Rule: .*.mycompany.com only redirects to subdomains and not the parent page. For example, http://app.mycompany.com.

    • Multiple URL’s should be separated using semicolons (;). For example, "clientRules": "www.yahoo.com;.*bing.com;.*.omnissa.com".

4. Apply the configuration by running the following command to read the config file, etc/omnissa/url-config.json, and apply those rules configurations by creating internal file systems which are needed.

• Command: sudo /usr/lib/omnissa/viewagent/VVC/vchan_plugins/urlRedirection/horizon-url-protocol-launch-helper install

Notes:

• The enable key in /etc/omnissa/url-config.json activates the URL Redirection feature. Set that value to 1 to enable URL Redirection. Set the value to 0 to disable URL Redirection.

• Uninstalling the Linux Agent removes all files related to the URL Redirection feature except the rules configuration file /etc/omnissa/url-config.json. When reinstalling the Linux Agent, an administrator won't need to add the rules again. However, the administrator will need to run the command in Step 4 to install the URL Redirection feature.