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
- Addition of
debug
command - Separate admin tools on port 22222
- New
ee system
sub-commands
debug
Command
Usage
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