Troubleshooting Installation

\\

{toc}

h2. Common Problems

First off, make sure:

* You have eAccelerator disabled during install. eAccelerator can cause problems when doing the heavy lifting during the install process.
* You followed all the directions [here|Installation] for your distribution.
* You are using at least PHP 5.1.1+, but not 5.1.6 or 5.2.0

h2. PDO Error Messages

If you are getting PDO-related error messages during install, before proceeding to specific error messages as below, please confirm that your PDO configuration is setup correctly. You can do so by running this code (replace user/password/database/host with your setup):

{code}<?php
/* Connect to an ODBC database using driver invocation */
$dsn = 'mysql:dbname=testdb;host=localhost';
$user = 'dbuser';
$password = 'dbpass';

try {
$dbh = new PDO($dsn, $user, $password);
} catch (PDOException $e) {
echo 'Connection failed: ' . $e->getMessage();
}
?>
{code}
If this fails, then your PDO setup is not configured correctly.

h2. Common Error Messages

Here are some common problems that might occur during installation and their solutions:

h3. "I get a blank white screen instead of the options page\!"

You probably copied config.inc.tpl to config.inc.php, which is incorrect. Make the config.inc.php file an empty, writable file.

If you renamed the config.inc.tpl to config.inc.php, rename it back to config.inc.tpl and create a blank file named config.inc.php that is writable.

h3. "I clicked install and got a blank white screen\!"

Make sure your 'memory_limit' setting in php.ini is set to at least 32M. For slower servers, you might need to up it to 64M.

h3. "Cannot connect to database" in the database options page

One of the common causes of this problem is that you're using a non-standard port for MySQL. Try putting this syntax into the hostname field (replacing the data with your mysql server's host and port):

{quote}my.database.com;port=3307{quote}

h3. Warning: PDO::__construct() \[pdo.--construct\]: \[2002\] Argument invalid (trying to connect via unix://) OR "Checking database:Could not connect to the mysql server."

This means your MySQL socket is incorrectly configured. Usually this can be remedied by adding to (or updating) your php.ini:

{code}mysql.default_socket=/path/to/my/mysql.sock
mysqli.default_socket=/path/to/my/mysql.sock
pdo_mysql.default_socket=/path/to/my/mysql.sock
{code}

h3. The login page keeps redirecting me back to the login screen with no error

This can happen with older Revolution beta installs. To fix it, delete the following 3 system settings from the DB table `[prefix]\_system_settings` (where prefix is your table prefix):

* session_name
* session_cookie_path
* session_cookie_domain

Then delete the core/cache/config.cache.php file.

Unless, of course, you've changed these explicitly for some purpose of your own.

h3. Things sometimes don't load, the page flakes out, etc (eAccelerator)

Are you running eAccelerator? In some server configurations, this can cause problems. You might need to disable it. You can do so via your php.ini:

{code}eaccelerator.enable = 0;
eaccelerator.optimizer = 0;
eaccelerator.debug = 0;
{code}
or in your .htaccess in the modx root directory, if your server supports php_flag server directives:

{code}php_flag eaccelerator.enable 0
php_flag eaccelerator.optimizer 0
php_flag eaccelerator.debug 0

Additional, page "flake outs" may stem from items stored within your own browser's cache, which may result with the resource / elements / file tree not appearing due to old versions of javascript and other files being utilized on the client side.&nbsp; This can be verified by accessing the manager with a browser not previously utilized in doing so.&nbsp;

The simple fix: clear your browser's cache, and log back into the manager.

A more complete solution:&nbsp;
# {color:#000000}Under System Clear Cache{color}
# {color:#000000}Under Security Flush Permissions and then Flush Sessions{color}
# {color:#000000}This will dump everything and log you out{color}
# {color:#000000}Last step Clear your browser cache{color}

h3. I can't login to the manager after installing\!

If you're redirecting back to the login screen every time, try setting this in your .htaccess file in the root of your MODx install:

{code}php_value session.auto_start 0{code}

h3. Could not connect to the database server. Check the connection properties and try again. Access Denied...

Often on shared hosting, if you create a username for your database with an underscore (_) in it, it will cause problems. Ensure your database username does not contain an underscore, and try again.

h2. Still Having Issues?

If you're still having problems, post your error and your server environment information in [our forums here|http://modxcms.com/forums/index.php/board,378.0.html], and we'll try and address your issue as soon as possible.

{scrollbar}