Limited Availability: Install Horizon Agent on a macOS Machine

Before You Begin

• Complete all preparation steps in the Prepare a Physical macOS Machine for Desktop Deployment section.
• Download the Horizon Agent for macOS installer package (OmnissaHorizonAgent-YYMM-y.y.y-xxxxxxx.dmg) from Omnissa Customer Connect. In the filename, YYMM is the marketing version number, y.y.y is the internal version number, and xxxxxxx is the build number.
• Confirm you have administrator credentials on the macOS machine.
• Open a Terminal window or establish an SSH session on the machine.

Install Horizon Agent using the installer

1. In Finder, navigate to the downloaded .dmg file.
2. Double-click OmnissaHorizonAgent-YYMM-y.y.y-xxxxxxx.dmg to launch the installer.
3. Follow the prompts in the Horizon Agent installation program.
4. Enter the administrator username and password.
5. Review and accept the license agreement.
6. Select the destination disk (the macOS system volume).
7. Select the installation options you require. See the Horizon Agent Installation Options for macOS section for available options.
8. Click Install and complete the installation.
9. When the installation completes, restart the macOS machine.

Install Horizon Agent Silently

To install Horizon Agent without user interaction, use the installer command-line tool:

export HZN_BROKERURL=<broker-fqdn>
export HZN_USERNAME=<admin-username>
export HZN_PASSWORD='<password>'
export HZN_DOMAIN=<domain>

sudo -E bash "/Volumes/Horizon Agent for macOS/InstallHorizonAgent.app/Contents/MacOS/InstallHorizonAgent"

After the installation finishes, confirm the agent service is running:

sudo launchctl list | grep omnissa

Horizon Agent Installation Options for macOS

The following table describes the installation options available for Horizon Agent on macOS.

Note: USB Redirection and Smart Card Redirection are not available options for Horizon Agent for macOS.