Completing the iTop installation for workflow management

Overview

In order to operate properly, iTop maintenance operations and asynchronous tasks must be executed on a regular basis. In order to ease the installation, all the background tasks have been grouped to be launched from a single file: webservices/cron.php

The following features require the activation of cron.php

For more information about cron.php, check the iTop Wiki

Scheduling cron.php on Windows

  1. Copy the file <itop root>/webservices/cron.distrib to <itop root>/webservices/cron.params (requires administator privileges)
  2. If you care about security: move the file <itop root>/webservices/cron.params into a directory not in the scope of the web server (Apache), and make it be readable only by the account that will execute the cron
  3. Edit the file cron.params to set the credentials used for cronified tasks
  4. Edit the file <itop root>/webservices/cron.cmd, and set the relevant path for your installation of PHP.
  5. Schedule the execution of cron.cmd:
    schtasks.exe /create /tn "iTop CRON" /sc minute /mo 1 /tr "\"<itop root>/webservices/cron.cmd\""

Scheduling cron.php on Linux/Unix

  1. Copy the file <itop root>/webservices/cron.distrib to <itop root>/webservices/cron.params (requires administator privileges)
  2. If you care about security: move the file <itop root>/webservices/cron.params into a directory not in the scope of the web server (Apache), and make it be readable only by the account that will execute the cron
  3. Edit the file cron.params to set the credentials used for cronified tasks
  4. Edit the crontab and add the following line:
    * * * * * /usr/bin/php <itop root>/webservices/cron.php --param_file=<itop root>/webservices/cron.params