Installation Problems

When I run the installer, I just get a blank screen on random pages.
In most cases a blank page has turned out to be a server miss configuration of a certain requirement that is missing. Below you will find a method on how to debug what is wrong and to display some sort of error to help debug the case.

Turn on Error reporting
First you will have to open the file: install/include/debug.inc.php

Once you have that file open look for:
PHP Code:
error_reporting(0);


Replace that with:
PHP Code:
error_reporting(E_ALL);

Once you have done that try run the install script again, this time it should display some errors if any. Any errors that come up will bring you a step closer to figure out what is wrong. If no luck click on the "Support" link on top on where you can get support and report the errors you found.


When I run the installer, I get a page of code.
If when accessing the installer via your web browser you receive a page of code and not the installation start screen, this means that either PHP has not been installed or has not been configured properly. Please consult with your web host to see if this is the case.


I get an error like this 'access denied for user@localhost using password YES' when I submit the main form in STEP 3.
If you receive this error from mySQL it means that either the mySQL database name, mySQL username, mySQL password or mySQL host information is wrong. Please double check the information you entered making sure that passwords are typed correctly. In some cases, this information is case sensitive. If this error persists, please consult with your web host to check that the information you have is correct.


Upgrade Problems

During the upgrade the site went blank.
In most cases a blank page has turned out to be a server miss configuration of a certain requirement that is missing. Below you will find 2 methods on how to debug what is wrong and to display some sort of error to help debug the case.

1) Turn on Error reporting
First you will have to open the file: update/include/debug.inc.php

Once you have that file open look for:
PHP Code:
error_reporting(0);


Replace that with:
PHP Code:
error_reporting(E_ALL);

Once you have done that try run the install script again, this time it should display some errors if any. Any errors that come up will bring you a step closer to figure out what is wrong. If no luck click on the "Support" link on top on where you can get support and report the errors you found.


2) Check update log file
Script comes with a routine that logs anything the script does, including errors.
You can view this file: update/file/update.log
From there you can view any errors that come up. Any errors that come up will bring you a step closer to figure out what is wrong. If no luck click on the "Support" link on top on where you can get support and report the errors you found.


General Site Problems

After I install I just get a blank page.
In most cases a blank page has turned out to be a server miss configuration of a certain requirement that is missing. Below you will find a method on how to debug what is wrong and to display some sort of error to help debug the case.

Turn on Error reporting
First you will have to open the file: include/settings/common.sett.php

Once you have that file open look for:
PHP Code:
$_CONF['debug'] = 0;


Replace that with:
PHP Code:
$_CONF['debug'] = 1;

Once you have done that try your site again, this time it should display some errors if any. Any errors that come up will bring you a step closer to figure out what is wrong. If no luck click on the "Support" link on top on where you can get support and report the errors you found.


I get a "Internal Server Error" after install.
In most cases it might happen for CGI type of php installation, to be sure of the cause of your problem please check your server error logs. If you dont know where to find your error logs please contact your host and they will guide you to them.


My Index page shows up but none of the links work and some pages are blank or I get weird 404 errors.
If after update the main page of the site is displayed correctly but elements do not work, you should change the config parameter in "include/settings/server.sett.php" file by the following way:
From:
PHP Code:
 $_CONF['path_translated'] = true;

To:
PHP Code:
 $_CONF['path_translated'] = false;

(so, you should simply change "true" to "false")

If the above did not work and you are running Apache 2 then this might be what you need to fix. There is a certain build in Apache 2 that has a bug which can be found here when it comes to how it can handle the rewrite engine. To fix this you will need to open your main .htaccess file.

Near the top of that file you need to add:
Htaccess Code:
AcceptPathInfo On