EasyEngine 1.3 “Doctor” release with Debug command


Today, we are happy to bring EasyEngine 1.3 (codenamed “Doctor”).

This release has support for new debug command among other features. This release is delayed by almost a month from original planned date. But we hope that easy debugging will save your plenty of time going ahead. 🙂

New Features

  1. Addition of debug command
  2. Separate admin tools on port 22222
  3. New ee system sub-commands

debug Command


debug commands goal is to make debugging easy for WordPress sites and generally system.

Debugging a site

For a site, you can enable debugging using:

ee debug example.com

Above will put WordPress into debug mode, Enable xdebug profiling for PHP, PHP-FPM Slow-log, MySQL’s slow query log and nginx’s debug log! All this in just one command. You can refer debug doc to control individual options.

When you finish debugging, run following command to turn off debugging mode:

ee debug example.com --stop

Debugging entire system

Sometimes, it may happen that entire system needs debugging. You can run following command:

ee debug

Above will turn on php, mysql, nginx debugging. Please note that it will not enable any WordPress debugging.

When you finish debugging, run following command to turn off debugging mode:

ee debug --stop

For more details, please refer to docs. debug command comes with many options!

Debug Command Internals

Sperate PHP-FPM Pools

When you enable debugging on a site, it will not affect other sites PHP performance. EasyEngine has 2 separate PHP-FPM pools, one for production sites and one for debug sites. So debug sites will not penalise production sites with xdebug and slow-log. Though mysql-slowlog will be systemwide (atleast for now).

Interactive Mode

When you pass -i flag to any debug command, it will turn ON debugging, starts displaying log files right away on your screen till you press CTRL+C from keyword. EasyEngine will capture keyboard signal properly, turn OFF debugging and return command-line control.

You may want to start another terminal for usual work while you observer debug logs from different systems in a separate terminal window!

EasyEngine Admin Tools on Port 22222

Though EasyEngine is command line tool, there are plenty of web-based tools and scripts which can make server administration easy. We included few tool in past releases under /ee/ urls. /ee/ URLs involved some nginx rewrites which we did not like much. So from this release we have moved all admin tools to a dedicated port 22222.

You can find all admin tool details here.

New ee system sub-commands

We have added 4 subcommands to ee system: status, start, stop and restart.

ee system status will show you system (OS) status and also running status of php, mysql, nginx and postfix services.

start, stop and restart will act as a shortcut to start, stop and restart php, mysql, nginx and postfix services in one go!

Please note ee system restart won’t reboot your OS. We realised it sounds bit confusing when we started documenting it! We hope to solve confusion in future.

Updating EasyEngine

Updating EasyEngine is easy. Just fire ee update command.

If you run into any issue, please catch us on our easyengine support forum.

Links: EasyEngine Homepage | EasyEngine Github Repo | Debug Command | Admin Tools