Scheduling AP Test or Vulnerability Assessment

Once you have created a profile (by importing or through the GUI), you can schedule an AP Test or a Vulnerability Assessment to run. This is done with a record named scheduled_test.

The scheduled_test record can part of an import file that creates a profile or it can be its own separated import file. If it is part of an import file that creates a profile, all scheduled_test records must be entered at the end of the file.

The fields for a scheduled_test record are:

Note

All fields have an equivalent field in the GUI.

• Is this a scheduled AP Test (versus Vulnerability Assessment)-enter true for AP Test; false for Vulnerability Assessment.
• Profile name
• Scope [BSS MAC address or path to folder separated by a slash (/)]
• Number of retries
• Switch Sensors on retry (true or false)
• Signal threshold
• Last seen time in minutes
• Skip test on sensor busy (true or false)
• Filter on SSID (true or false)
• Time to wait for Sensor in minutes
• Number of tests (assessments) to run in parallel
• Prefer OTA tests (true or false)
• Schedule name
• Schedule type (daily, intraday, monthly, weekly, or onetime):
  • Daily has the following sub-fields:
    • hours (the hour of the day)
    • minutes (the minute of the hour)
    • type (interval, weekdays, or weekends)-interval means run in every x days. weekdays means run on weekdays. weekends means run on weekends.
    • interval (in days)-an interval of 1 means every day; an interval of 4 means every four days (this sub-field is only used if type is interval)
  • Intraday has the following sub-fields:
    • hours (the hour of the day)
    • minutes (the minute of the hour)
    • number of hours between runs (must be > 1)
  • Monthly has the following sub-fields:
    • hours (the hour of the day)
    • minutes (the minute of the hour)
    • months to run [colon(:) delimited]; i.e., January:February:etc
    • type (day, last, or specific)-day means run on the nth day of the month. last means run on last day of the month. specific means run on the last, first, second, third, fourth, or fifth occurrence on the specified day of the week (Monday, Tuesday, Wednesday, etc).
  • Weekly has the following sub-fields:
    • hours (the hour of the day)
    • minutes (the minute of the hour)
    • days to run [colon(:) delimited]; i.e., Sunday:Wednesday
    • interval (weeks between runs)
  • Onetime has the following sub-fields:
    • hours (the hour of the day) minutes (the minute of the hour)
    • month (1 - 12 with 1 being January and 12 being December)
    • day of the month (1 - 31)
    • year (i.e., 2012)

Examples:

scheduled_test,TRUE,APT_ProfileName1,00:11:22:33:44:55,2,TRUE,-70,10,TRUE,TRUE,10,20,Schedule1,onetime,6,30,5,5,2012
scheduled_test,FALSE,WVA_ProfileName1,ADSP/UnplacedDevices,2,TRUE,-70,10,TRUE,TRUE,10,20,TRUE,Schedule2,daily,interval,10,20,1