Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
Next revision Both sides next revision
cpanel:apache-configuration [2010-05-20 23:14:26]
garrett.plasky 		cpanel:apache-configuration [2010-05-20 23:24:00]
garrett.plasky
Line 5: Line 5:
 ==== Getting Started ==== ==== Getting Started ====
  
-The EA3 system can be invoked by two different methods. The first is through the WHM under **Main >> Software >> EasyApache (Apache Update)**. The other is through SSH: run the script <c>/scripts/easyapache</c> from a root-level SSH session. Both will present you with the same screen; the WHM version is shown below:+The EA3 system can be invoked by two different methods. The first is through the WHM under **Main >> Software >> EasyApache (Apache Update)**. The other is through SSH: run the script <c>/scripts/easyapache</c> from a root-level SSH session. Both will present you with the same screen and the WHM version is shown below:
 {{ :cpanel:easyapache.png?200&direct |EasyApache Initial Screen}} {{ :cpanel:easyapache.png?200&direct |EasyApache Initial Screen}}
  
Line 15: Line 15:
 This will lead you through a series of steps. The first is to select your **Apache Version**, which we always recommend the latest, currently Apache 2.2.((**Important:** If you must run PHP4 (not recommended), you should use Apache 1.3.))  This will lead you through a series of steps. The first is to select your **Apache Version**, which we always recommend the latest, currently Apache 2.2.((**Important:** If you must run PHP4 (not recommended), you should use Apache 1.3.)) 
  
-Next, you will chose your PHP major version. Here you can also select both PHP4 and PHP5 to run simultaneously, however this requires additional server configuration which is outside of the scope of this article. We strongly recommend PHP5.((http://www.computerworld.com.au/article/256464/php_4_dead_long_live_php_4/))+Next, you will chose your PHP major version. Here you can also select both PHP4 and PHP5 to run simultaneously, however this requires additional server configuration which is outside of the scope of this article. We strongly recommend PHP5.((http://www.internetnews.com/dev-news/article.php/3725291))
  
 On the next screen you will select your Minor PHP version. Generally speaking you want to go with the latest available version, however you should check PHP's [[http://www.php.net/ChangeLog-5.php|changelog]] to ensure the latest version does not have any major changes that will not break your scripts. If you find that it does, you can always run EasyApache again and downgrade a version. On the next screen you will select your Minor PHP version. Generally speaking you want to go with the latest available version, however you should check PHP's [[http://www.php.net/ChangeLog-5.php|changelog]] to ensure the latest version does not have any major changes that will not break your scripts. If you find that it does, you can always run EasyApache again and downgrade a version.
Line 21: Line 21:
 On the next and final screen, you will find the options for Apache and PHP when it comes to modules, loaders, and the like. This screen only lists the most commonly select options, and for a more complete list hit the //Exhaustive Options List// button. This will also take you to the list of PHP modules which cPanel's EA3 system supports. On the next and final screen, you will find the options for Apache and PHP when it comes to modules, loaders, and the like. This screen only lists the most commonly select options, and for a more complete list hit the //Exhaustive Options List// button. This will also take you to the list of PHP modules which cPanel's EA3 system supports.
  
-You will find the most common PHP modules here, however if you find that the one you are looking for is not supported, you may want to consider using a PEAR module, otherwise you can add custom compliation options according to cPanel's guide found [[http://www.cpanel.net/documentation/easyapache/ea3custom_flags.html|here]].+You will find the most common PHP modules here, however if you find that the one you are looking for is not supported, you may want to consider using a PEAR module, otherwise you can add custom compilation options according to cPanel's guide found [[http://www.cpanel.net/documentation/easyapache/ea3custom_flags.html|here]]. 
 + 
 +==== Followup ==== 
 + 
 +Once you have selected //Save and Build// the rebuild process with begin. cPanel builds from source, so the process generally takes anywhere from 15-30 minutes, depending on the speed of the server hardware. The webserver continues to function while the build happens in the background. Only near the end of the build process is the webserver stopped and the new build put in place. 
 + 
 +EA3 will rarely leave you with a broken system should the build fail for some reason. If it does indeed fail, it will automatically revert to the previously saved (and working) build. 
 + 
 +If the build completes successfully and you did not select a new PHP loader (such as SuPHP), then you are all set! If you did select a new loader, you will need to specify it as the default in **Main >> Service Configuration >> Apache Configuration >> PHP and SuExec Configuration**. 
 + 
 + 
 +{{tag>apache cpanel upgrade php easyapache}}