Command line Reference

Custom paster commands are provided to enable scripting of house keeping tasks such as quarantine management and Database maintenance.

Command options and help

These commands may take options to get details on the supported options run:

paster baruwa
paster COMMAND_NAME -h or paster help COMMAND_NAME

Quarantine management

paster prune-quarantine /etc/baruwa/production.ini

Deletes quarantined files older than ms.quarantine.days_to_keep. This is set in the /etc/baruwa/production.ini file

Quarantine reports

paster send-quarantine-reports-ng /etc/baruwa/production.ini

Generates an email report of the quarantined messages. This command allows you to specify the number of days the report should cover as well as the maximum number of messages to return. The following switches allow you to specify periods.

  • -o NUM_DAYS, --newer-than=NUM_DAYS Report on messages this number of days back
  • -m MAX_MSGS, --max-records=MAX_MSGS Maximum number of messages to return
  • -i ORG_ID, --org-id=ORG_ID Process only this organization’s accounts
  • -e EXCLUDE_ORG, --excluded-org=EXCLUDE_ORG Exclude this organization’s accounts

Database maintenance

paster prune-database /etc/baruwa/production.ini

Deletes records older than 30 days from the messages table of the database, and archives them to the archive table. It deletes records older than 90 days from the archives table. These defaults can be configured in the configuration file as the following options:

  • baruwa.messages.keep.days
  • baruwa.archive.keep.days

The following options allow you to specify the periods of the records that need to be processed.

  • -d --days records older than this number are deleted from messages
  • -a --adays records older than this number are deleted from archives

Spamassassin rule description updates

paster update-sa-rules /etc/baruwa/production.ini

Updates the Spamassassin rule descriptions in the database.

PDF reports

paster send-pdf-reports-ng /etc/baruwa/production.ini

Sends PDF reports by email. This command allows you to specify the report type [domain, user], report period [daily, weekly, monthly] and the number of days to report on. The following switches allow you to specify the options.

  • -t REPORT_TYPE, --report-type=REPORT_TYPE Report type [user, domain]
  • -p REPORT_PERIOD, --report-period=REPORT_PERIOD Report period [daily, weekly, monthly]
  • -d NUMBER_OF_DAYS, --number-of-days=NUMBER_OF_DAYS Restrict to number of days
  • -i ORG_ID, --org-id=ORG_ID Process only this organization’s accounts
  • -e EXCLUDE_ORG, --excluded-org=EXCLUDE_ORG Exclude this organization’s accounts

Mail queue Stats updates

paster update-queue-stats /etc/baruwa/production.ini

Query the inbound and outbound queues and write stats to the database.

Delta search index updates

paster update-delta-index --index messages --realtime /etc/baruwa/production.ini
paster update-delta-index --index archive /etc/baruwa/production.ini

The messages and archive index have deltas to ensure that indexing is efficient the above commands merge the delta index with the main index and remove id’s from the realtime index that have been indexed to disk indexes.

The messages index has a real time index while archive does not.

Create an administrator account

paster create-admin-user -u USERNAME -p PASSWORD -e EMAIL -t TIMEZONE /etc/baruwa/production.ini

Create an administrator account

Change user password

paster change-user-password --username USERNAME /etc/baruwa/production.ini

Changes an accounts password, This is the only way to change an administrator account’s password as it cannot be changed via the web interface.

Generate list of top spammers

paster send-top-spammer-list -e EMAIL [-m -s SPAMSCORE -p REPORT_PERIOD -d] /etc/baruwa/production.ini

Generates a list of top spammers and emails or displays it.

  • -e EMAIL, --email=EMAIL Email address to send data to
  • -m, --include-message-count Include the number messages received
  • -d, --dry-run Print to stdout do not send email
  • -n NUM, --messages-sent=NUM Return senders with message counts equal to or greater than
  • -s SPAMSCORE, --spam-score-threshold=SPAMSCORE Count messages with spam scores equal to or greater than
  • -p REPORT_PERIOD, --report-period=REPORT_PERIOD Report period [daily, weekly, monthly]

Generates list of clean senders

paster send-whitelist-data -e EMAIL [-m -s SPAMSCORE -p REPORT_PERIOD -d] /etc/baruwa/production.ini

Generates a list of top ham senders for whitelisting.

  • -e EMAIL, --email=EMAIL Email address to send data to
  • -m, --include-message-count Include the number messages received
  • -d, --dry-run Print to stdout do not send email
  • -n NUM, --messages-sent=NUM Return senders with message counts equal to or greater than
  • -s SPAMSCORE, --spam-score-threshold=SPAMSCORE Count messages with spam scores equal to or greater than
  • -p REPORT_PERIOD, --report-period=REPORT_PERIOD Report period [daily, weekly, monthly]