Magento installations are not the easiest tasks to undertake. Many times issues are created through no fault of your own.


If for any reason any installation has caused the entire Magento site to crash, causing your website to not load, the first thing you need to do is to check for a maintenance.flag file in your Magento root directory. This file gets created if a critical error has occurred with Magento. Just delete this file to restore website functionality. 

These information only apply to Magento 1.

We've written these tips to help you diagnose what might have gone wrong during your installed. These solutions cover most installations mistakes.

First Steps

Please ensure you have read the installation guide thoroughly. It is very detailed and includes troubleshooting to just about every possible problem.

We have found that 90% of all installation problems are the result of skipping steps in the installation guide, not reading the installation guide, or not reading the troubleshooting section of the installation guide, so please read the installation guide thoroughly for best results. 

If you have read the guide and followed all the steps and still have an issue, here are 4 other common issues we have seen.

Solution #1 - Reupload Files

Re-upload all files. There are a lot of files to upload. If even one file is not uploaded, then there will be fatal errors. It is very easy for the FTP client to report a failed transfer and to not notice. Re-uploading them all will help resolve this possibility.

Solution #2 - System Compliation Disabled

System compilation was not disabled prior to installation. To resolve this, manually edit the file [magento root]/includes/config.php and put a “#” in front of any “define(…)” statements.

Remember :  After installing a new extension, you cannot just enable system compilation. You need to re-run System Compilation.

Solution #3 - Database Updated Improperly

Magento possibly installed the databases tables prior to all files being uploaded.

To fix this issue, look in the core_resource database table and delete the [identifier]_setup row. The [identifier] is the software identify found in your admin panel in Extendware -> Software -> Manage Software.

For example, the identifier for “Extendware Core” is “ewcore”, so the row that is ewcore_setup should be deleted.

Solution #4 - Refresh Magento Cache

The magento cache needs to be refreshed. Due this in the admin panel or if that is not possible rename / delete [magento root]/var/cache (or whatever the relevant backend is like apc, etc, restart it).

Didn't solve your problem? 

If you have done the above four steps and still are seeing errors, please contact our friendly support so we can help you resolve the issues.