Initialization Tests

Quick Introduction

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.

Error Messages

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.