This sections describes how to upgrade your Gallery from an old version to a new one. Upgrading is very easy, and you won't loose any data if you follow all the directions.
Upgrading to 1.4.1 may require additional steps. Please read the RELEASE_NOTES file included with 1.4.1 for further instructions.
Make a backup of your old Gallery installation. The easiest way to do this is to use the tar command.
tar -cz gallery > gallery-backup.tar.gz
On Windows, use something like WinZip to create an archive of your Gallery directory.
Put your Gallery into configuration mode. This is very important.
cd gallery
sh configure.sh (or configure.bat for Windows)
Download Gallery from the Gallery SF.net Download Page. Put the tarball in your gallery directory's parent directory.
Untar the new Gallery version over the old one.
tar -xvzf gallery-1.x.x.tar.gz
[list of new files]
Windows users: use WinZip to extract Gallery over the old installation
Re-run the configuration wizard. Afterward, put Gallery back into secure mode, as described in that guide.
Enjoy your upgraded Gallery!
Make a backup copy of your Gallery directory. Use your FTP client to download the old Gallery directory, just in case
Put your Gallery into configuration mode, by chmodding .htaccess and config.php 0777 and by chmodding the setup/ directory 0755.
Download Gallery from the Gallery SF.net Download Page. Untar it using tar or WinZip on your computer.
Using your FTP client, upload the new Gallery files over the old Gallery files. Yes, this will override the old Gallery files, but this is OK!
Re-run the configuration wizard. Afterward, put Gallery back into secure mode, as described in that guide.
Enjoy your upgraded Gallery!
If after you upgrade your Gallery, you get a blank screen or a PHP error (e.g. "function not found", etc...), don't panic. Your FTP client probably didn't override all the files. The solution is to delete all the Gallery files except config.php and your albums directory and re-upload Gallery (don't forget to re-run the configuration wizard).
Upgrading a Gallery installation you have modified can be difficult. By modified, we mean modifying the actual PHP code Gallery runs on. If you just made changes in the html_wrap/ or css/ directories, you should have no worries (you should have removed the .default extension from the files before modifying them, so that they won't get overridden when upgrading) and can proceed upgrading Gallery using one of the guides above.
If you indeed have modified some of the PHP code that Gallery uses, upgrading will be more difficult, but not totally impossible. It will be, however, extremely hard or impossible to upgrade a modified Gallery without shell access to the server. Keep this in mind. First, you'll need to download the original non-modified Gallery version that corresponds to the version you are currently using (i.e. if you modified Gallery 1.3.4, re-download an unmodified Gallery 1.3.4). Unpack it in the same directory that your modified Gallery is in, but name is something like orig_gallery/. You should now have two directories, gallery/ (or whatever your modified Gallery's directory name is) and orig_gallery/. Next, run this command:
diff -r -C 3 orig_gallery gallery > changes.txt
You now have a patch file containing the changes you made. Next, download the newest version of Gallery (the one you want to upgrade to). "cd" to the parent directory of the new unpacked Gallery. Run this command:
patch < changes.txt
The odds are that this won't completely work, because we may have made changes to the same line you changed, causing patch to get confused. However, it's worth a try.