Command-line parameters

The USS Agent for Mac OS X software supports command-line parameters which can be used as part of scripts to install or control the agent after installation.

Pre-installation Command Line Parameters

If you intend to script the installation of the USS Agent, or manually install from the command line, the parameters in the table below can be used.

The command line parameters can be used like so:

Installing

sudo ./UssAgent\ Installer.app/Contents/MacOS/UssAgent\ Installer -q -u <username> -p <password> [-h <hostname>] [-d <domain>]

Uninstalling

sudo ./UssAgent\ Uninstaller.app/Contents/MacOS/UssAgent\ Uninstaller -s -a <admin_password>

It is best practice to create a new administrator user for provisioning and assign a limited Role to the user containing the Mac OS X - Agent - Provisioning permission.
Parameter
Description
Example
Required?

-u

The username of a valid USS administrator account with provisioning rights.

-u user@clouduss.com

Yes

-p

The password for the account specified with the -u parameter.

-p p4ssw0rd

Yes

-d

The Cloud Domain to use if the username specified by -u does not use the @clouduss.com domain. If this is not specified, the installer will auto-detect.

-d clouduss.com

No

-h

The hostname to register the agent as. If it is absent, it will be automatically detected. If this is not specified, the installer will auto-detect.

-h maclaptop

No

-a

The tamper-proof admin password for the agent to used during uninstall, as specified in the Agent Configuration Profile in use.

-a s3cr3t

Yes

-c

The ID of the configuration profile to apply during installation. This can be found in the Advanced section of the Mac OS X Agent Configuration profile section. If it is absent, the default profile will be used (if available).

-c 5

No

Post-installation Command Line Parameters

If you wish to configure and control the USS Agent software after installation, you can use the special ManualUpdater tool, which is available from the download section.

The ManualUpdater tool support the following parameters:

Parameter
Description

-h

Show the available parameters

-S [--start] password

Starts the USS Agent service with the given tamper-proof password

-s [--stop] password

Stops the USS Agent service with the given tamper-proof password

-r [--regenerate] password

Regenerate the SSL certificate. The tamper-proof password is required.

-R [--reconfigure]

Reconfigures the agent, and requires the following options:

-a [--admin_password] password - the tamper-proof password

-u [--username] username - the username to use

-p [--password] password - the password for the given username

-n [--hostname] hostname - the hostname to use

-d [--domain] api_domain

Specify an API Domain to use for this transaction. For example, -d 'clouduss.com'

Examples

These examples may need to run with elevation.

Start the service:

sudo ManualUpdater -S p4ssw0rd

Stop the service:

sudo ManualUpdater -s p4ssw0rd

Reconfigure the service:

sudo ManualUpdater -R -a p4ssw0rd -u anotheruser@clouduss.com -p password -n myhostname

How did we do?