MyBB Documentation

Task Manager

The 1.6 Documentation is no longer maintained and some information may be outdated.

The MyBB 1.6 series reached end of life on October 1, 2015.

This means there will be no more security or maintenance releases for these series and forums running these versions of MyBB may be at risk of unfixed security issues. All administrators are strongly encouraged to upgrade their forums to the latest release of MyBB as soon as possible.

Tools & Maintenance: Task Manager

The task manager section in the Admin CP allows you to manage the scheduled tasks that are run on your forum. Scheduled tasks are run at the specified time(s), on the specified day(s), in the specified month(s). Tasks run specified PHP files located in the inc/tasks directory.

The task listing page displays the name of the task, its description, the time of the next run, and whether or not it is enabled. From the task listing page, you can choose to edit the task, enable/disable the task, delete the task, or run the task.

Tools & Maintenance: Add Task
Title 
Name for the task.
Short Description 
A short description explaining the purpose of this task.
Task File 
The file located in the inc/tasks directory that will be run when this task is run. You are provided a select list of the tasks located in the directory.
Time: Minutes 
The minutes of the hour (between 0 and 59) this task should be run. Use an asterisk (*) to have the task run every minute.
Time: Hours 
The hours of the day (between 0 and 23) this task should be run. Use an asterisk (*) to have the task run every hour.
Time: Days of Month 
The days of the month (between 1 and 31) this task should be run. Use an asterisk (*) to have the task run every day, or if you wish to specify weekdays for this task to be run.
Time: Weekdays 
The days of the week this task should be run. Select "Every Weekday" to have it run every day of the week (this will override any other selections for this setting). Hold down CTRL to select multiple days.
Time: Months 
The months this task should be run. Select "Every Month" to have this task run every month (this will override any other selections for this setting). Hold down CTRL to select multiple months.
Enable Logging? 
Should logging be enabled for this task?
Task enabled? 
Should this task be enabled (be run at the times specified)?
Tools & Maintenance: Task Logs

The "Weekly Backup" task can be used to periodically back up your MyBB database, but its use is recommended only for small boards, because it might slow down the board when it takes its time to complete. If you have it running as a task but notice the board is slow when the backup task is running, then use a cron job instead. Below is an example for MySQL.

Create a shell script named, for example, ~/forum_backup.sh:

now=`date +%Y-%m-%dT%H-%M` ; mysqldump -u <MYBB_USER> --password=<MYBB_PASSWORD> --skip-opt --add-drop-table --complete-insert --create-options --disable-keys=FALSE --extended-insert=FALSE --lock-tables --skip-set-charset --skip-comments --dump-date <MYBB_DBNAME> > $now.sql ; zip -m $now.zip $now.sql

These parameters configure the mysqldump to be very close to the format of the backups generated via Admin CP. In particular, one INSERT per line vs. multi-value INSERTs allow for easier visual comparison of dumps using visual diff tools.

To create a cron job for automatically executing that backup, run:

 cmod +x ~/forum_backup.sh
 crontab -e
 # in the crontab editor, enter a CRON expression like:
 0 4 * * * ~/forum_backup.sh  # run the backup every day at 4am

Note that having backups on the server won't protect you from a server failure, or losing access to the server. Make sure you transfer the backups from the server to an off-site location.

The task logs allow you to see all tasks that have been run in the past thirty days that have logging enabled. You are shown the task name, the day and time it was run, and additional data that relates to the task.

Logs older than 30 days are automatically deleted.







Admin CP
Home Dashboard - Preferences - Version Check - MyBB Credits
Configuration Settings - Banning - Custom Profile Fields - Smilies - Word Filters - MyCode - Languages - Post Icons - Help Documents - Plugins - Attachment Types - Moderator Tools - Spiders/Bots - Calendars - Warning System - Thread Prefixes
Forums & Posts Forum Management - Forum Announcements - Moderation Queue - Attachments
Users & Groups Users - Groups - User Titles - Banning - Admin Permissions - Mass Mail - Group Promotions
Templates & Style Themes - Templates
Tools & Maintenance System Health - Cache Manager - Task Manager - Recount and Rebuild - PHP Info - Database Backups - Optimize Database - File Verification - Administrator Log - Moderator Log - User Email Log - System Mail Log - User Warning Log - Statistics

Edit this page on GitHub