Managing Cron jobs

From ULYSSIS documentation

Cron is a job scheduler, a utility that can be used to execute shell commands at specific points in time. These jobs are also called Cron jobs, and can be edited using the crontab command.

The Crontab Command

To edit the cron table (crontab) file, you will use the crontab command. The crontab command has a few options:

  • crontab -e: Edit the crontab for the current user
  • crontab -l: List the cron jobs for the current user
  • crontab -r: Remove all cron jobs for the current user (Use the -i option to prompt before deleting)

Editing The Crontab

Perform these steps to edit the crontab.

  • Execute the crontab -e command
  • If this is the first time editing the crontab, a prompt will appear asking you to specify your text editor. If you don't know what to reply, we suggest you choose nano.
  • If everything is performed correctly, a file should appear.
  • You can edit this file. (Remember that everything after # is a comment)

To add a new line to the file, you should follow this format:

┌───────────── minute (0 - 59)
│ ┌───────────── hour (0 - 23)
│ │ ┌───────────── day of month (1 - 31)
│ │ │ ┌───────────── month (1 - 12)
│ │ │ │ ┌───────────── day of week (0 - 6) (Sunday to Saturday;
│ │ │ │ │                                       7 is also Sunday)
│ │ │ │ │
│ │ │ │ │
* * * * *  command to execute

You can use an asterisk (*) if a field does not matter. For example:

0 * * * * python somescript.py

will run python somescript.py every hour.

1 0 15 * 0 somecommand

will run somecommand every month the 15th day or if the day is a Sunday, at 1 past midnight (00:01).

Real-life Example: Scheduling Drush Updates

Drush and Cron can be used to update Drupal automatically.

  • First, run the crontab -e command. More info can be found in the previous section.
  • Next, add the following line to the file:
0 0 * * * cd /path/to/your/drupal/folder/ && drush pm-update http://your.website.url

This will execute the cd /path/to/your/drupal/folder/ command, changing the current directory to your drupal folder, and the drush pm-update -l http://your.website.url command, updating Drupal, every day, at midnight. The && indicates a new command follows.

  • Finally, save and exit the file and you're good to go!