Upgrading

• Backup all your data. For example, to back up your database using MySQL, you could do:

  mysqldump --add-drop-table -h localhost -u fastframe -p fastframe | bzip2 -c > fastframe.bak.sql.bz2

• Backup all your FastFrame files (including applications). Using an FTP program download your FastFrame directory to your local computer.

You can obtain the latest version of FastFrame and it’s applications, in either .tar.gz format or .zip format, from: http://www.codejanitor.com/download/fastframe

Bleeding-edge development versions of FastFrame and its applications are available via SVN at http://svn.codejanitor.com/

To upgrade your FastFrame files, follow the following instructions:

1. Rename your FastFrame directory so it matches the one that comes in the download. For example:

   mv /usr/local/apache/htdocs/fastframe /usr/local/apache/htdocs/FastFrame-3.1

2. Move the FastFrame source file that you downloaded to the root directory of your FastFrame installation. For example:

   mv FastFrame-3.1.tar.gz /usr/local/apache/htdocs

3. Unzip or untar the source file. For example:

   cd /usr/local/apache/htdocs
   tar xzfv FastFrame-3.1.tar.gz

4. Move the FastFrame directory back to its original location. For example:

   mv /usr/local/apache/htdocs/FastFrame-3.1 /usr/local/apache/htdocs/fastframe

If you are upgrading a specific application, follow these steps:

1. Move the application source file that you downloaded to your apps/ directory which is in your FastFrame/ directory. For example:

   mv checkout-3.1.tar.gz /usr/local/apache/htdocs/fastframe/apps

2. Unzip or untar the source file. For example:

   cd /usr/local/apache/htdocs/fastframe/apps
   tar xzfv checkout-3.1.tar.gz

This step needs to be done for both FastFrame and any applications you upgrade.

FastFrame is careful not to overwrite your configuration files when you upgrade. However, you do need to compare the new conf.php.dist against your conf.php file in the config/ directory to see if any new configuration options were added.

If you are upgrading an application you will also need to do this for the menu.php file.

In order to safely upgrade your database each release has a update script which will upgrade the database for FastFrame and all installed applications. It is located in the scripts/ directory in FastFrame’s root directory. The file names have the following pattern: updatedb_oldVersionNumber_newVersionNumber.php. For example: updatedb_30_31.php would upgrade your database from version 3.0 to 3.1.

Note: If you are upgrading from a version older than the immediately previous release, you need to run each update script in sequential order.

That’s it! You should test your installation by loading up the test page in your browser. The test page is in your root FastFrame directory. For example:

http://your-server/FastFrame/test.php