AutoDirector troubleshooting guide

The following information may be useful if you are having trouble installing or using AutoDirector.

If you experience technical difficulties, we can install the full version of AutoDirector for you on a web host of your choice (please contact us for details).

1. Setup error parsing autodirector.ini

The following error can occur when running setup.php: Warning: Error parsing ./autodirector.ini

The error can occur if your ini file contains any of the following characters: ! " $ & = ; ~ | ( ) [ ] { }

To fix the problem, either remove those characters, or use double-quotes (") around the setting, e.g.

MYSQLDBPASS="mysql$pass!word;"

2. MySQL database connection errors

In most cases, the MySQL host will be 'localhost', but you should check with your ISP. Some run the database on another server or require a specific host name.

ISPs often prefix the database and user name with your account ID. For example, if your account is 'mysite' and you created a database named 'autodirector' with a user named 'dbuser', your database name could be 'mysite_autodirector' with a user name of 'mysite_dbuser'.

Most control panels will display the connection parameters once you have created your database and user.

3. PHP 4.x cannot connect to MySQL 4.x or 5.x

MySQL 4.x and above introduced new methods of storing database user passwords. If PHP 4.x cannot connect to your database, run the following command from the MySQL command line:

SET PASSWORD FOR 'autodirectordb_user'@'localhost' = OLD_PASSWORD('autodirectordb_pass');

4. Problems generating data files

The AutoDirector 'data' folder must:

  1. be available from the internet, e.g. http://www.yoursite.com/autodirector/data/, and
  2. have permission set so your web server can write files within that folder.

On Linux/Apache systems, the permission setting is 755 (rwxr-xr-x). This can be set using an FTP client or telnet/SSH session, e.g:

chmod 755 data

If this does not fix the problem, try a setting of 777 (rwxrwxrwx).

If the setup still fails, your ISP may be restricting write permissions. You should consult their support pages or contact them directly and ask how you permit PHP scripts to write files within a chosen folder.

In some cases, file writing may be permitted within your 'cgi-bin' folder. You could copy the AutoDirector files to that location and attempt the setup again.

If you have telnet/SSH access, you could also try setting Apache as the owner of the data folder:

chown -R apache data

5. Problems uploading images

Vehicle pictures can be uploaded if:

  1. Your server can write to the AutoDirector data folder (see above).
  2. PHP file uploading is configured, and
  3. the PHP GD graphics library extension is installed.

The AutoDirector setup will report whether file uploading and the GD library are available. You should check your php.ini file and consult the PHP configuration documentation for more information.

AutoDirector will work if uploads or the GD library are not configured, but the vehicle editing screen will not show the image upload section.

6. Showroom page problems

The AutoDirector showroom adheres to web standards, so you should ensure you use a DOCTYPE at the top of the page containing your showroom, i.e.

<!DOCTYPE html>
or
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">

The information box allows you to enter characters such as pound and euro signs. If these characters are replaced with a '?' when you view your showroom, check your HTML page encoding and perhaps try using 'utf-8' or 'iso-8859-1' in the HTML <head>

<meta http-equiv="content-type" content="text/html;charset=UTF-8" />

Finally, if you are experiencing strange problems, check that you have uploaded the AutoDirector files correctly. When using FTP, check that all files are uploaded in ASCII format, except for the .jpg and .gif images which use BINARY format.

7. AutoDirector control panel problems

If you are experiencing strange problems when accessing the AutoDirector control panel, ensure you are not running any advert blocking or webpage filtering software, e.g. AdBlock or Proxomitron.

8. Unable to log on

Early versions of PHP 5.x may exhibit cookie handling problems. If you cannot log in to the AutoDirector control panel following a successful installation, try upgrading to the latest version of PHP 5. You should also clear your browser's cookies for the domain where AutoDirector is hosted.

9. AutoDirector installation service

We can recommend suitable ISPs and offer an installation service if you have difficulties installing AutoDirector on your system. Please contact us for details.

v1.9 available for download now

©2017 AutoDirector. This page can be found at http://autodirector.co.uk/troubleshooting.php