InterWorx Cron Documentation

Purpose:

This document will give the reader an overview of the cron processes that run tasks on an InterWorx-CP server. It will explain what they are, why they are important, and what the repercussions would be if they were disabled or deleted.

Audience:

Advanced System Administrators.

WARNING: Do not edit the iworx or system cron unless you know exactly what you are doing and are well versed in both InterWorx and Linux.. This document will attempt to explain what the repercussions of doing so could be, but as always with something this complex it is possible that other unforeseen things might happen resulting in a malfunctioning server and lost data. If you choose to edit anything always remember to make backups. This is presented here for informational purposes only and is NOT supported.

Overview:

The following cron process are run by the iworx system user and should not be deleted or edited unless there is a specific reason to do so.

# crontab -u iworx -l

27, 32, 37, 42, 47, 52, 57, 2, 7, 12, 17, 22 * * * * cd /home/interworx/cron ;./iworx.pex --fively

31, 46, 1, 16 * * * * cd /home/interworx/cron ; ./iworx.pex --fifteenly

20 * * * * cd /home/interworx/cron ; ./iworx.pex --hourly

49 20, 2, 8, 14 * * * cd /home/interworx/cron ; ./iworx.pex --quad_daily

10 21 * * * cd /home/interworx/cron ; ./iworx.pex --daily

44 23 * * 5 cd /home/interworx/cron ; ./iworx.pex --weekly

18 0 8 * * cd /home/interworx/cron ; ./iworx.pex --monthly

Configuring Cron in the iworx.ini file

In the file /home/interworx/iworx.ini

[iworx.cron]
bandwidth="/home/interworx/cron/bandwidth.pex"
clearpasswordreset="/home/interworx/cron/clearpasswordreset.pex"
dns="/home/interworx/cron/dns.pex"
ip="/home/interworx/cron/ip.pex"
iworx="/home/interworx/cron/iworx.pex"
license="/home/interworx/cron/license.pex"
monitor="/home/interworx/cron/monitor.pex"
mysql="/home/interworx/cron/mysql.pex"
rrd="/home/interworx/cron/rrd.pex"
runtime="fively"
spam="/home/interworx/cron/spam.pex"
stats="/home/interworx/cron/stats.pex"
storage="/home/interworx/cron/storage.pex"
update="/home/interworx/cron/update.pex"

Cron Error Log

If you need to know if a particular cron process is running, the cron error log is located /var/log/cron. Run tail -10 /var/log/cron to view the last 10 entries.

InterWorx CRON Processes

The InterWorx cron file is encrypted, however here is a summary of each process run by the iworx user and what it does.

cron fively (runs every five minutes)

fively - rrd graphs updated, dns exported, and if in the iworx.ini has runtime=fively (the default) it does bandwidth and storage calculations too

cron fifteenly (runs every fifteen minutes)

fifteenly - bandwidth and storage if runtime=fifteenly

cron hourly (runs every hour)

hourly - bandwidth and storage if runtime=hourly

cron quad_daily (runs every day -- every six hours)

quad_daily - license.sync, and bandwidth and storage if runtime=quad_daily

cron daily (run every 24 hours)

daily - OS update, bayes training, and bandwidth and storage if runtime=daily

Specifically:

  • yum - does the equivalent of yum check-update; yum update;
  • stats - runs through all domains and does all stats programs, and rotates the logs upon completion.
  • spamassassin training - uses "sa-learn" to train messages in users' Learn Spam / Learn Ham folders.

cron weekly (runs every 7 days)

does not do anything at the moment.

cron monthly (runs every month}

does not do anything at the moment.

System Cron Processes

The Cron processes above, run by the iworx user are the ones that most InterWorx sysadmins will be interested in, however there are other system cron processes (generally run by root) which support InterWorx, and deserve a mention.

cron fively (runs every five minutes)

cron fifteenly (runs every fifteen minutes)

cron hourly (runs every hour)

cron quad_daily (runs every day -- every six hours)

cron weekly (runs every 7 days)

cron monthly (runs every month}

Post a Comment

Your email is never published nor shared. Required fields are marked *

*
*

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>

Powered by WP Hashcash