Upgrading From Version 3.0.x or 3.1.x

Introduction

The upgrade procedure for going from version 3.0.x or 3.1.x to 3.5.x is more involved than a simple patch. This new version of the software has many new features and updates, so some special instructions are required. The upgrade procedure is listed below along with information covering the major changes that appear in this new version.

Important Notes

Before you start the upgrade there are a few important items that need to be mentioned. First of all, the 3.5.x version now requires ImageMagick 6.0.0 or newer. We recommend version 6.0.8 for complete compatibility. If you have an older version or are not sure what version is installed, contact your server administrator and have them upgrade or confirm that at least version 6.0.0 is installed.

The TGP page template system and page building process has undergone a significant overhaul which will require that you update all of your TGP page templates. Because of this you should allow enough time not only to update the software files, but also to update your TGP page templates. This document discusses some of the major changes, so it is recommended that you read those before you upgrade. You may also want to read over the TGP Page Templates and Page Building Overview sections of the manual before you upgrade.

Upgrading

The first thing you should do is make a backup from your current installation so that you can restore it if necessary. Use the instructions in the software manual for the version you are using to do a database backup before you start the upgrade process.

The next step is to upload the new tables file from the 3.5.x distribution. This will need to go in the data directory of your installation, replacing the current copy of that file. Once that is done upload the ags3.x.x.cgi file from the utilities directory of the software distribution. It will need to go in the same directory as your ags.pl file and have it's permissions set to 755. This script will convert your MySQL database to the new format. You will need to access it through your browser, and it will automatically run and update your database.

Once the ags3.x.x.cgi file has been executed successfully you can delete some of the old files that are no longer needed. In the templates directory of your installation you can remove all of the files that start with cpanel. That would include all of these files:

cpanel_2257.tpl
cpanel_addaccount.tpl
cpanel_addmoderator.tpl
cpanel_addpermanent.tpl
cpanel_analyzeperm.tpl
cpanel_analyze.tpl
cpanel_backup.tpl
cpanel_blacklist.tpl
cpanel_breakdowncat.tpl
cpanel_breakdown.tpl
cpanel_categoryedit.tpl
cpanel_cheats.tpl
cpanel_cropcomplete.tpl
cpanel_crop.tpl
cpanel_deletegallery.tpl
cpanel_deletethumb.tpl
cpanel_duplicates.tpl
cpanel_editaccount.tpl
cpanel_editmoderator.tpl
cpanel_editpermanent.tpl
cpanel_emaileditor.tpl
cpanel_email.tpl
cpanel_error.tpl
cpanel_frameset.tpl
cpanel_galleries.tpl
cpanel_html.tpl
cpanel_icons.tpl
cpanel_importperm.tpl
cpanel_import.tpl
cpanel_info.tpl
cpanel_ipresolve.tpl
cpanel.js
cpanel_langeditor.tpl
cpanel_main.tpl
cpanel_menu.tpl
cpanel_nothumbs.tpl
cpanel_options.tpl
cpanel_quickban.tpl
cpanel_quickgalleries.tpl
cpanel_quickperm.tpl
cpanel_quickscan.tpl
cpanel_raw.tpl
cpanel_reciprocals.tpl
cpanel_rejecteditor.tpl
cpanel_requests.tpl
cpanel_reviewdone.tpl
cpanel_review.tpl
cpanel_scanner.tpl
cpanel_showaccounts.tpl
cpanel_showmoderators.tpl
cpanel_showpermanents.tpl
cpanel_skippedcat.tpl
cpanel_skippeddupe.tpl
cpanel_status.tpl
cpanel_submit.tpl
cpanel_templates.tpl
cpanel_upload.tpl

Once these files have been deleted you can begin uploading the new files from the 3.5.x distribution. Below is a list of the files that you will need to upload. If a file with the same name already exists, it should be overwritten by the new file. If Perl 5 is not located at /usr/bin/perl be sure to update the first line of all .cgi files with the correct path to Perl on your server. Make sure you upload all of the files in ASCII mode! The 3.5.x version has several new files so you should check your file permissions. The recommended file permissions are listed below. Once all of the files have been uploaded, make sure the permissions on the cron.cgi and scanner.cgi files to 777. You can then bring up the patch.cgi script in your browser which will update those two files with the correct settings. After that has been successfully completed, change the permissions back to 755 on the cron.cgi and scanner.cgi files.

Now you can login to the software control panel. The first thing you should do is visit the Edit Options interface. There are some new options that you may want to configure. Even if you do not make any changes, be sure to save your settings so that the software can verify that all of the files and directories it needs have been created.

There are now several things you will need to check and update before you begin using the software as normal.
  1. Your TGP pages and their templates will have been imported, however the templates from the previous version will not work in the 3.5.x version. You will need to update them with the new template options and directives which are covered in the TGP Page Templates section of the software manual.

  2. If you are using cron for any of the software functions you will need to update your crontab entries. The Cron section of the software manual covers the settings you will need to use for the cron based functions.

  3. If you are using the click tracking feature of the software, be sure to update your go.php script with the latest version. You will need to configure the go.php script as in the previous versions. This is described in the Click Tracking section of the software manual.

  4. Control panel accounts will need to be updated. There are some new privileges and some that have been changed, so you will need to edit each account to assign the correct privileges to each.

  5. Before you can use the gallery scanner you will need to create a new configuration. The previous configurations will have been removed as they will not work with the new version.

  6. Check your category configuration through the Manage Categories interface to make sure your categories are setup how you want them. If you had the software setup to display the category name on the preview thumbnails, you will need to configure some annotations and then update your categories to use those annotations.
Overview of Major Changes

This section will outline the major changes that have been made in going from 3.0.x/3.1.x to the new 3.5.x version. As you can see there have been many changes to the software in this version. The list above outlines some of the major changes, however there are also many other small changes that should make your experience as the administrator much easier.