Agent installer command-line reference (macOS)

Use the following installer command to install or upgrade the Agent on macOS-based devices:

sudo installer -pkg path ConnectedSetup.pkg -target volume [-dumplog] [-verbose]

To run the installer command, you must use the sudo command, which prompts you for the password of the macOS administrator account that you are currently using. To see the complete set of options that the installer command supports, use the command: sudo installer -h

The following table describes the most common command-line options used to install or upgrade the Agent. To uninstall the Agent, see Uninstall the Agent from the command line.

Option Description
-pkg path

Sets the path to the installation package.

-dumplog (Optional) Writes detailed log information to both the standard error output and a /var/log/install.log file.
-target volume

Sets the volume of the Applications folder where the installer stores the Agent's application files.
-verbose (Optional) Displays more descriptive information than the standard output.
EXPORTKEYCHAINITEMS Exports the Connected keychain entries to an encrypted file at User's Connected folder. This file will be read by 24.4 or above agent during upgrade.

TIP: To ensure silent installation or upgrade of macOS Agents, redirect both standard output and standard error to files. For example, the following command redirects messages and errors to the files msg.txt and error.txt, respectively:

sudo installer –pkg ConnectedSetupUSW.pkg -target / -dumplog –verbose >msg.txt 2>error.txt

These options do not affect Agent registration after initial installation, which is always interactive.

Examples

The following examples represent some common uses of the installer command to install and uninstall an Agent assigned to the US-West (USW) data center.

Example 1

Install the Agent in the active volume using the installation package that resides in the current directory:

sudo installer –pkg ConnectedSetupUSW.pkg -target /

Example 2

Install the Agent in the active volume and generate a verbose log file, Connected_Install.log:

sudo installer –pkg ConnectedSetupUSW.pkg -target / -dumplog –verbose 2>Connected_Install.log

Example 3

Manually export the Connected Keychain entries to an encrypted file:

open -n /Connected.app --args --EXPORTKEYCHAINITEMS