.werks/5783

   1 Title: Introduced background jobs for longer running task
   2 Level: 2
   3 Component: wato
   4 Compatible: compat
   5 Edition: cre
   6 Version: 1.5.0b1
   7 Date: 1519899875
   8 Class: feature
   9
  10 A new mechanism has been introduced allowing certain tasks to be run as background processes.
  11 Currently the following areas are included
  12 <ul>
  13 <li>Host renaming</li>
  14 <li>Agent baking (Enterprise Edition)</li>
  15 <li>Report generation (Enterprise Edition)</li>
  16 </ul>
  17
  18 Once a background job is triggered, an overview page provides additional information
  19 regarding the progress. You can also stop and delete background jobs, if applicable.
  20 Keep in mind that some jobs - in detail host renaming and agent baking - lock certain areas
  21 in WATO to prevent further configurations as long the background process is running.
  22
  23 Each background has a working directory located in <tt>~/var/check_mk/background_jobs</tt> with
  24 a statusfile named <tt>jobstatus.mk</tt>. If the background job generates stdout data it will
  25 be shown in the job details page. Job Exceptions are also shown in the details page and, in addition,
  26 written to <tt>~/var/log/web.log</tt>.
  27
  28 Keep in mind, old background jobs will be automatically removed after 30 days or if the maximum amount
  29 of jobs for a job type has been reached. These limits are currently not configurable and hardcoded
  30 <ul>
  31 <li>Reporting has a limit of 100</li>
  32 <li>Host renaming has a limit of 50</li>
  33 </ul>
  34 This cleanup routine is regularly called through a multisite cronjob.