CRON-ONLY TROUBLESHOOTING GUIDE

General Inquries & Unclassified
1

ICTN6780
ICTN67801577×997 430 KB

:compass: CRON-ONLY TROUBLESHOOTING GUIDE

:one: CORE PRINCIPLE

Your system should:

:check_mark: Run core Dolibarr automation :check_mark: Ignore third-party WhatsApp module errors :check_mark: Never let external modules break cron execution

:backhand_index_pointing_right: WhatsApp = optional paid plugin :backhand_index_pointing_right: Cron = system-critical engine

:two: CLEAN CRON ARCHITECTURE

:check_mark: Active cron method (correct setup)

URL-based cron (wget)

:check_mark: Endpoint:

https://YOUR-DOMAIN/public/cron/cron_run_jobs_by_url.php

:check_mark: Execution interval:

*/5 * * * *

:check_mark: Log file:

/home/USER/billingdata/dolibarr_cron.log

:three: FINAL CRON JOB (PRODUCTION SAFE)

*/5 * * * * /usr/bin/wget -qO- "https://YOUR-DOMAIN/public/cron/cron_run_jobs_by_url.php?securitykey=***&userlogin=***" >> /home/USER/billingdata/dolibarr_cron.log 2>&1

:four: HOW TO VERIFY CRON IS HEALTHY

:green_circle: Live monitoring

tail -f /home/USER/billingdata/dolibarr_cron.log

Healthy signs:

  • qualifiedResult of run_jobs = OK
  • Job re-scheduled
  • 0 KO

:green_circle: Manual test

wget -qO- "https://YOUR-DOMAIN/public/cron/cron_run_jobs_by_url.php?securitykey=***&userlogin=***"

:five: IGNORING WHATSAPP ERRORS (IMPORTANT)

You may still see:

Unknown column 'whatsapp_sent_date'

:red_circle: This is NOT a cron failure

It is:

  • A third-party module issue
  • A database mismatch in WhatsApp plugin
  • Not related to core cron execution

:brain: STRATEGY: ISOLATE IT

Option A (Recommended)

Leave it installed, ignore logs

Option B (Cleaner system)

Disable WhatsApp module:

Dolibarr → Modules → WhatsApp → Disable

Option C (Advanced)

Fix plugin separately (only if needed for business use)

:six: WHAT CRON SHOULD CARE ABOUT

Your cron engine should ONLY care about:

:check_mark: Invoices :check_mark: Payments :check_mark: Email reminders :check_mark: Subscriptions :check_mark: System cleanup :check_mark: Scheduled jobs

:seven: WHAT CRON SHOULD IGNORE

:cross_mark: WhatsApp errors :cross_mark: Third-party plugin SQL issues :cross_mark: Deprecated plugin warnings :cross_mark: External API failures (non-core)

:eight: CLEAN HEALTH CHECK MODEL

Component Status
Cron execution :white_check_mark: MUST WORK
Core jobs :white_check_mark: MUST WORK
Logging :white_check_mark: MUST WORK
WhatsApp module :cross_mark: OPTIONAL / IGNORE
Third-party plugins :warning: Isolated

:nine: BEST PRACTICE FOR STABILITY

:check_mark: Keep cron minimal :check_mark: Avoid plugin dependencies in cron flow :check_mark: Use core Dolibarr jobs only :check_mark: Treat external modules as “non-blocking”

:ten: FINAL STATE OF YOUR SYSTEM

Your setup is now:

  • :green_circle: Stable cron engine
  • :green_circle: Core automation running
  • :green_circle: Logs functioning
  • :yellow_circle: WhatsApp errors isolated (non-blocking)

:rocket: SUMMARY

  • :backhand_index_pointing_right: Cron is your backbone
  • :backhand_index_pointing_right: WhatsApp is a paid extension layer
  • :backhand_index_pointing_right: They must NEVER be coupled