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 options
| Global option | Description |
|---|---|
| -w <dir> | Override working directory that is otherwise inherited from shell/environment. |
| -v | Enable verbose mode, bump all logging to max level (enable all tags). |
| -c snowagent.config | Read 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 -h | Print help text and exit. |
Commands
| Command | Description |
|---|---|
| cloud | Used by the agent during the cloud application metering process. Added as a scheduled task. For more information, see the cloud application metering technical description. Can be executed manually for troubleshooting purposes. |
| copyright | Show copyright notice. |
| manifest | Print the manifest in JSON format and exit. |
| scan | Scan 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. |
| send | Send files from the data directory. Files that are successfully sent are deleted. |
| test | Run a self-test. Check configuration and server connectivity, then exit with a 0 (if successful) otherwise with a non-zero exit code. |
| update | Check for updates now, and install if any are found.
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. |
| version | Print the current snowagent version and exit. |