When you first install the software, the init.php script will be run. This script will gather information about your
MySQL database and then perform some tests to make sure that your installation is setup properly. If any of the tests
fail, an error message will be displayed. Details on the error messages you may receive are covered in this file.
Below is a list of most of the error messages you can possibly receive, including a description of what you can do
to resolve the problem.
- Can't connect to local MySQL server through socket '/path/to/mysql.sock' or
Can't connect to MySQL server on 'hostname'
These two error messages indicate one of two things. Either the MySQL server is not up and running, or the
MySQL hostname you provided is not valid. Contact your server administrator to make sure MySQL is functioning
properly on your server and to verify that you are using the correct hostname.
- Access denied for user: 'username@hostname' (Using password: YES/NO)
This error message indicates you are using an invalid username/password combination. Contact your server
administrator to verify that you are using the correct MySQL username and password.
- Could not connect to database with supplied values
This error message is a combination of the previous two. It is a general error message that could indicate
the MySQL server is offline or your username/password combination is not valid. You will need to contact
your server administrator to make sure MySQL is functioning properly and to make sure you have the correct
username and password.
- Access denied for user: 'username@hostname' to database 'database'
This error indicates that you have either entered an invalid database name, or you do not have permissions
to use the database name you provided. You will need to contact your server administrator and ask them to
verify that you are using the correct database name and that you have permissions to use that database.
- Cannot write to [directory] directory.
This error message indicates that the directory listed in the [directory] position has either not been
created or does not have the correct permissions set on it. Make sure all directories listed in the installation
documentation have been created, and set their permissions to 777.