Skip to main content

Command line

The command line format for Snow Inventory Agent for macOS is:

snowagent [options] [<command> [<arguments>]]

Some command lines require superuser privileges. To temporarily gain superuser privileges, send the command line as an argument to the command sudo.

sudo /opt/snow/snowagent test
Global optionDescription
-w <dir>Override working directory that is otherwise inherited from shell/environment
-vEnable verbose mode, bump all logging to max level (enable all tags)
-c snowagent.configRead the configuration file from the given location instead of the default one.
This should be considered a one-time operation as it does not change other behaviors of the agent.
-data-dir <dir>Override the data directory (regardless of configuration).
When this option is used, only the directory of the inventory result file will be changed. The log file will still be placed in the default location.
-log-dir <dir>Override log directory (regardless of configuration)
-? or -hPrint help text and exit
CommandDescription
copyrightShow copyright notice
manifestPrint the manifest in JSON format and exit
scanScan the current device and create a snowpack file in the target destination (as set by configuration). This will start a scan regardless of any schedule or other configuration. It will not start a scan if there's a running scan in progress. After the scan is completed the agent will exit. The scan result is not automatically sent.
sendSend files from the data directory. Files that are successfully sent are deleted.
testRun a self-test. Check configuration and server connectivity, then exit with a 0 (if successful) otherwise with a non-zero exit code
updateCheck for updates now, and install if any are found.
  • Option: -package <location>
    Function: Use an update package from a specific location
Updates can be provided from Snow Inventory Server or a local .snowpack file.
Note: When updating the snowagent file, the xMetering2 file, and JAR files, such as Snow Inventory Java Scanner, the accompanying SIGN file must also be included.
versionPrint the current snowagent version and exit