- Common Problems
- PDO Error Messages
- Common Errors
- "I get a blank white screen instead of the options page!"
- "I clicked install and got a blank white screen!"
- "Cannot connect to database" in the database options page
- Warning: PDO::__construct() [pdo.--construct]:  Argument invalid (trying to connect via unix://) OR "Checking database:Could not connect to the mysql server."
- The login page keeps redirecting me back to the login screen with no error
- Things sometimes don't load, the page flakes out, etc (eAccelerator)
- General weirdness in the Manager (not eAccelerator)
- Resource / Elements / File tree not appearing
- I can't login to the manager after installing!
- Could not connect to the database server. Check the connection properties and try again. Access Denied...
- The manager displays as plain text after installation
- Still Having Issues?
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 for your distribution.
- You are using at least PHP 5.1.1+, but not 5.1.6 or 5.2.0
- You are using MySQL later than 4.1.20, but not any iteration of MySQL 5.0.51 (including 5.0.51a).
- Clear the core/cache/ directory entirely before starting setup; sometimes improper file permissions can cause issues.
- Clear your browser cache and cookies
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):
If this fails, then your PDO setup is not configured correctly.
Here are some common problems that might occur during installation and their solutions:
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.
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.
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):
Warning: PDO::__construct() [pdo.--construct]:  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:
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):
Then delete the core/cache/config.cache.php file.
Unless, of course, you've changed these explicitly for some purpose of your own.
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:
or in your .htaccess in the modx root directory, if your server supports php_flag server directives:
On some systems, especially with shared hosting, there can be a problem with the compress_js and/or compress_css System Settings. Go to System -> System Settings and type 'compress' (without the quotes) in the search box at the upper right. Turn the two settings off, then log out, delete all files in the core/cache directory, clear your browser cache and cookies, and log back in.
If the Manager is messed up enough that you can't change the settings, see the note below about changing the two System Settings in the modx_system_settings table in the database with PhpMyAdmin.
The simple fix: clear your browser's cache, and log back into the manager.
A more complete solution:
- Under System Clear Cache
- Under Security Flush Permissions and then Flush Sessions
- This will dump everything and log you out
- Last step Clear your browser cache
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:
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.
|More common issues to come...|
The MODX manager loads compressed CSS and JS assets. Some server configuration See "JS Errors in the Manager due to Error 4
- Go into the DB using PhpMyAdmin and find the [table_prefix]_system_settings table (table_prefix is usually modx).
- Find the rows with key "compress_js" and "compress_css" and set their value to 0 and save them.
- Empty your core/cache/ directory.
- Clear your browser cache and cookies
- Log in to the manager.
This will allow you to use the manager without JS and CSS compression.
- Make sure your connectors/ folder has 0755 permission
If you're still having problems, post your error and your server environment information in our forums here, and we'll try and address your issue as soon as possible.