Scheduling

<< Click to Display Table of Contents >>

RayVentory Scan Engine > 12.6 u4 > User Guide > Inventory Agent > Usage 

Scheduling

The following operations can be automated by setting up scheduling:

 

OS inventory

Oracle Database Discovery and Inventory

Upload of discovery/inventory results

Download of configuration data

SaaS Discovery

Horizon connection metering

Arbitrary commands

 

Inventory Agent for Windows uses the Windows Task Scheduler to execute its scheduled tasks. On UNIX/Linux, cron is used instead.

 

A scheduled task is defined in the configuration file by a single line, which needs to follow a specific set of rules:

 

<command>:<options>:<schedule-pattern>

 

Valid values for command are:

 

Command

Description

command

Executes an arbitrary command.

encrypt

Encrypts all credentials which are not marked as encrypted by the $$ prefix.

getconfig

Download a configuration file.

horizon

Gather Horizon connection information.

oracle

Runs Oracle database inventory.

saas

Runs SaaS discovery.

settings

Applies the registry settings and usage metering whitelist from the Inventory Agent configuration file to the system scheduler resp. registry and whitelist file.

upload

Uploads the results.

 

The triggering-pattern is inspired by cron. On Windows, this pattern is interpreted to translate it to the Windows Task Scheduler triggering scheme. Therefore, only a small subset of cron triggering patterns, including the keywords logon and logoff can be used for Windows.

 

finger1

Be aware:

The schedule trigger startup and logon are not available for non-windows and can only be used for windows devices.

 

Overview of possible schedule patterns:

<Minute> <Hour> <DayOfMonth> <Month> <DayOfWeek>

 

Character

Description

(1) <Minute>

Minute.
Either a value (0-59) or * for unspecified value.

(2) <Hour>

Hour.
Either a value (0-23) or * for unspecified value.

 
(3) <DayOfMonth>
 

The day of the month.
Either a value (1-31) or * for unspecified value.

(4) <Month>

The month.
Either a value (1-12) or * for unspecified value.

(5) <DayOfWeek>

The day of the week.
Either a value (0-6) or * for unspecified value. Use 0 for Sunday, 1 for Monday, 2 for Tuesday etc.

 

Examples:

schedule:getconfig::25 0 * * *

Download a new configuration file every day at 00:25.

 

schedule:saas::26 0 * * *

Run a SaaS discovery every day at 00:26.

 

schedule:inventory:-o IncludeDirectory=/opt:30 0 * * *

Run an inventory with an additional command-line option for NDTRACK, every day at 00:30.

 

schedule:oracle:-o user=smith -o pass=tiger -o asSysDBA=true:33 0 * * *

Run an Oracle discovery and inventory with an additional command-line option for ORATRACK, every day at 00:33.

 

schedule:upload::45 0 * * *

Upload the discovery, metering and inventory results, every day at 00:45.

schedule:saas::logon

Run a SaaS discovery on logon.