Gallery3:User guide:Gallery3:Troubleshooting - Gallery Codex
Personal tools

Gallery3:User guide:Gallery3:Troubleshooting

From Gallery Codex

Previous chapter: Uploading photos and videos Back to the user guide main page Next chapter: Embedding Gallery 3 in Drupal


Troubleshooting and common errors

On this page you can find the most common problems and errors and information how to troubleshoot and hopefully fix them. Some information provided here is for advanced users so if you have problems following any of the tips on this page please head to the forums and post your problems there after reading the next paragraph "Getting help on the Gallery forums"


Getting help on the Gallery forums


If you are stuck with a problem or you don't exactly understand the troubleshooting provided on this page you can head to the forums to get some more help. If you do please follow these rules:

Search before you post It is likely that someone else has had the same problem before you and you will find the solution by just looking for it
Make sure you are using the latest version Check if there is a newer version of Gallery 3, any modules you are using and your current theme available. Especially if you see display problems (misaligned icons etc.) your theme might need updating. If there is please upgrade your installation by following the instructions provided here (Gallery 3), here (modules) and here (themes). It might be that the issue you are experiencing has already been fixed in the updated version.
Provide as many details as possible To make it easier for others to help you with you problem please be as precise as possible. A good problem description should include:
  • Exact steps to reproduce the issue
Example:
  • Install module "Example module"
  • Create an album
  • Click on "add some (photos)"
  • The exact error message you are seeing on the screen
  • The contents of your log files (see paragraph "General troubleshooting: Log files" below)
  • The version of Gallery you are using
  • If you don't mind others visiting your Gallery: the URL of your Gallery (e.g. http://www.example.com/gallery3/index.php)
Be polite Gallery 3 and it's modules and themes are developed by a community of enthusiasts who are not getting paid for the hard work they put into developing, maintaining and supporting this great piece of software that you can use for free and for whatever purpose you want. Please keep this in mind when something breaks your Gallery 3 installation.
Be patient The developers and community members have day time jobs, families, hobbies etc. For this reason it might take some time before you get a response. Please be a bit patient if no one has time to answer straight away. For most of the developers and community members

General troubleshooting


Fix your Gallery

There is a Fix your Gallery task on the Admin -> Maintenance page that might fix some common issues, like the breadcrumb not looking right.

Gallery3 FAQ

There is some good information on the FAQ page that you should look though as well.

Log files

Gallery 3 is setup to not display errors / error details by default to avoid confidential information being revealed to non-admins. It will however save error information in log files. The log files are located in "/var/logs" and are a great help to troubleshoot problems with your installation. Therefore if you cannot figure out the solution to your problem by yourself and need help from the forums please do the following:

  • Do the steps necessary to get the error (e.g. if you get a blank screen when trying to access Gallery 3 just do that)
  • Download the log file with the current date in the file name to your local PC (e.g. using an FTP client)
  • Remove all confidential information from the file such as usernames, domain names etc.
  • Post the contents of the log files on the forums together with detailed information how to reproduce the error etc. (see previous paragraph "Getting help on the Gallery forums".

Installation errors


There are a few things that can go wrong during the installation of Gallery 3. The following are the most common errors:


Error "We're having trouble creating a place for your photos..." when accessing the installer

Cause Gallery 3 needs a place to store your photos, videos, thumbnails etc. This folder has to be writable by PHP scripts and must be called "var". It has to be created in the folder of your Gallery 3 installation (the folder with "index.php" in it).
How to solve this Create a folder called "var" in the folder of your Gallery 3 installation (using your FTP client or if you have SSH access by typing "mkdir var" without the quotes) and give it enough permissions so that it is writable (if you are unsure just set the permissions to 777 using your FTP client or if you have SSH access by typing "chmod 777 var" without the quotes which should work for 99% of all webservers). Unfortunately setting the right permissions varies from hoster to hoster so if this fails for you then please contact your web hoster and ask for detailed instruction how to get this folder writable for PHP scripts.


Error "We were unable to connect to your MySQL server..." when clicking on "Continue"

Cause Gallery 3 needs a MySQL database to store information on photos, users etc. This error indicates that you have entered either a wrong server name/IP address, user name or password for the database.
How to solve this Make sure to enter the correct login details for the database you have created for your Gallery 3 installation. If you have problems please have a look at the documentation of your webhoster on how to create and use MySQL databases. Please note that the user name and password you have to enter on the installer are those of the database not the ones you want to login to your Gallery 3 installation (the latter will be created automatically by the installer).


Error "We were unable to connect to your MySQL server..." when clicking on "Continue"

Cause Gallery 3 needs a MySQL database to store information on photos, users etc. This error indicates that you have entered either a wrong server name/IP address, user name or password for the database.
How to solve this Make sure to enter the correct login details and server name / IP address for the database you have created for your Gallery 3 installation. If you have problems please have a look at the documentation of your webhoster on how to create and use MySQL databases. Please note that the user name and password you have to enter on the installer are those of the database not the ones you want to login to your Gallery 3 installation (the latter will be created automatically by the installer).


Error "The database you provided already has Gallery 3 tables in it..." when clicking on "Continue"

Cause The database you have specified on the installation screen is used or has been used by a different Gallery 3 installation.
How to solve this This error may result from different scenarios and solution depends on that. Here are the most common:

You are trying to do a fresh installation of Gallery 3

If you are trying to do a fresh installation of Gallery and you have backed up your database and var folder before (see Installing and upgrading Gallery 3 for instructions how to do this) or you want to start from scratch without any previous photos, videos, users etc. then you can simply drop all Gallery 3 tables in the database you want to use (e.g. using PHPMyAdmin or any other database administration tool provided by your webhoster).
If you haven't backed up your database or var folder but you want to restore all content you had before please do this before attempting the re-install. More detailed information on how to do this can be found here

You are trying to install a second Gallery 3 on your webserver

If you want to have two gallery 3 installation running side by side you can either create a second database for the second Gallery 3 installation or you can specify a table prefix for the second installation (this has to be a different prefix than the one used by the first installation if you have used any)



Errors with themes



I cannot apply a new theme or after applying my new theme nothing happens. The site still looks the same.

Cause Most themes do not include the admin area so after you apply a new theme it will not change. You might also be using and outdated version of either Gallery 3 or the theme you are trying to apply or you are trying to use a theme for Gallery 2.
How to solve this
  • Check the front end of your site. If the front end is also not changed please have a look at your log files (see General Troubleshooting -> Log Files) on this page for more details.
  • Make sure your Gallery 3 is up to date and that you have the latest version of the theme you want to apply.
  • Be aware that Gallery 2 themes are not compatible with Gallery 3. For more details how to download and install themes for Gallery 3 please read this codex page.

Image related issues


Previous chapter: Uploading photos and videos Back to the user guide main page Next chapter: Embedding Gallery 3 in Drupal
advertisements