Skip to main content

The scanning process

The Snow Inventory Agent for macOS scans the computers regularly. The default schedule is every day at 09:00.

You can configure a custom scan schedule, for example at 01:00 every day, at 04:05 every Sunday, or at 00:30 on the first of every month. The scan schedule is defined in /Library/LaunchDaemons/com.snowsoftware.Inventory.plist.

When the scan is completed, the agent sends the inventory file with the scan data to a Snow Inventory endpoint (Snow Inventory Server or Snow Extender). If the agent for some reason cannot send data to the endpoint, it will try again with the next scheduled scan. The inventory data file is stored until the data has been sent successfully. The maximum number of unsent inventory files that will be stored is decided by the setting key send.max_scan_result_backlog_count in the system settings element in the agent configuration file.

File scanning

The macOS agent gathers information by scanning the file systems.

To include or exclude directories or files from the scan, use the <Software><Include> and <Software><Exclude> elements in the agent configuration file. See Configure file system scan for a description of how to use the elements to configure a file system scan.

File system types not scanned by the agent

The following file system types are excluded from the scan:

  • Any file system types listed in Software/Exclude/FileSystem in the agent configuration file.

  • File system types that are excluded from the scan by default, shown in the table below.

Excluded file system types










Configure the agent to scan a maximum of once a day

If you need the scheduled to be performed more often than once a day—for example, if the computer is turned off most of the time—but still only want to produce one scanning result per day, you can use the following configuration:

  • In the system settings element of the agent configuration file, set the setting key env.allowonlyonescanperday to true.

        <Setting key="env.allowonlyonescanperday" value="true" />

When the setting key is set to true, the agent will check when the last scan was performed before it starts a new one. If the last scan was run the same day, the agent will not start a new scan.

Note that the agent will not perform the check if the scan is run from the command line.