02. Installation (and updates)

Fotis Evangelou edited this page Aug 24, 2016 · 13 revisions

Requirements

Engintron is fully compatible with CentOS version 5, 6 and 7 on both 32-bit and 64-bit platforms. Additionally, users have already reported a 100% compatibility with CloudLinux versions 6 & 7.

Engintron is also compatible with both EasyApache 3 and EasyApache 4 as of version 1.7.0.

Installing Engintron for the first time

Installation is a process that lasts only a few minutes. You'll need root SSH access to your cPanel server. Also check the current requirements (listed lower). If everything is ok, log in as root and type the following commands, one at a time:

cd /  
rm -f engintron.sh  
wget --no-check-certificate https://raw.githubusercontent.com/engintron/engintron/master/engintron.sh  
bash engintron.sh install

Or in one quick command to paste in the terminal:

cd /; rm -f engintron.sh; wget --no-check-certificate https://raw.githubusercontent.com/engintron/engintron/master/engintron.sh; bash engintron.sh install

The process will take a couple of minutes to complete and after that, Engintron will be installed on your cPanel server. Engintron has a nice user interface which is activated inside WHM, under the Plugins section. After installation, refresh WHM in your browser and you should see Engintron in the Plugins section (it's the absolute last section in WHM's sidebar).

In there, you'll find basic options to control Nginx, Apache and MySQL, all in one convenient place. Additionally, you can edit all of Nginx's configuration files (as well as some from Apache & MySQL) to get even more from Engintron (e.g. configure Engintron for use with CloudFlare). If however all you want is to accelerate both static & dynamic content delivery, then Engintron is already setup for you and you don't need to do anything more.

Inside the Engintron app dashboard you'll also find some handy utilities to monitor things like your Nginx access & error logs, check processes on your server or see incoming traffic on port 80.

Update (or re-install) Engintron

To re-install or update Engintron, either use Enginton's WHM app (there's a link to update/re-install Engintron) or if you prefer the terminal simply follow the same process as described in the installation section above.

HOWEVER, if you have customized any of the 5 main Nginx configuration files (nginx.conf, the 3 proxy_params_* files, default.conf), please back up your changes, so you can paste them back after the update. As of version 1.6.2, "custom_rules" is not changed on subsequent updates in order to maintain your custom Nginx configuration options like for example rules for CloudFlare. Engintron will always override the 5 configuration files mentioned earlier upon re-installation or update to ensure things always work as expected.

If for some reason you forget to do this, we got your back (shit can happen, right?). Login as root and navigate to Nginx's files to retrieve the backups of the configuration files which are automatically created when you re-install/update Engintron:

$ cd /etc/nginx
$ cat nginx.conf.bak
$ cat proxy_params_common.bak
$ cat proxy_params_dynamic.bak
$ cat proxy_params_static.bak
$ cat conf.d/default.conf.bak

This way you can view your previous changes so you can copy them to the new configuration files installed.

We HIGHLY recommend that any customizations to Nginx's configuration are only performed inside the custom_rules file. When you update Engintron, we can show you a copy of your previous "custom_rules" file so you can copy/paste or adapt any of your custom Nginx rules to the new release's "custom_rules" file.

Clone this wiki locally
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.