Upgrading ImageFolio Pro Edition 2.2

This document covers the upgrade installation of BizDesign ImageFolio Pro Edition 2.2 on Unix and Windows systems. If you are installing from scratch, you may wish to read Installing ImageFolio Pro Edition 2.2.

What You Will Need

• A licensed copy of ImageFolio Pro Edition 2.2 in Zip format
• A basic understanding of HTML
• A familiarity of installing Perl scripts
• A Zip decompression utility, such as WinZip (Win), or MacZip (Mac), or Stuffit Expander (Mac)
• A text editor, such as EditPlus (Win) or BBEdit (Mac)
• An FTP (File Transfer Protocol) utility, such as WS_FTP (Win), CuteFTP (Win), or Fetch (Mac)
• An image editor, such as Adobe Photoshop or Paint Shop Pro
• A Web server running Perl 5 or greater (either ActivePerl, MacPerl or the standard Perl distribution)
• Ability to run CGI scripts on your Web server

ImageFolio Upgrade Installation

1. Backup the following files and directories prior to upgrading ImageFolio (if they exist).
   
   
   • cgi-bin/data
     
   • cgi-bin/templates
     
   • cgi-bin/admin/user.db
     
   • cgi-bin/data/index.txt
     
   • cgi-bin/data/catdesc.txt
     
   • cgi-bin/data/categories.txt
     
   
   
2. Using a Zip decompression utility, extract the contents of ImageFolio*.zip to a new directory on your personal computer.
   
   You should see the following top-level directories:
   
   

   cgi-bin - this contains all of your scripts and data directories
   
   if_images - this contains all of the images used by ImageFolio
   
   gallery - your future multimedia gallery directory

3. Using an FTP utility, login to your Web server. Your ISP should have provided you with a username, password, and details for transferring files to your server.
   
   
4. Upload all of the files and all of the directories in the cgi-bin directory to a directory where you can execute CGI scripts on your server (usually cgi-bin). Make sure you transfer all files in ASCII text mode! If you are upgrading from Basic Edition v. 2.2, do not overwrite your data/catdesc.txt file.
   
   

   Permissions settings for Unix/Linux users...

   • Set permissions on all *.cgi files (in both the cgi-bin and cgi-bin/admin directories) to 755 (rwxr-xr-x).
   • Set permissions on the data directory to 777 (rwxrwxrwx).
   • Set permissions on the data/catdesc.txt file to 666 (rwxrw-rw-).
   • Set permissions on the cgi-bin/data/cache directory to 777 (rwxrwxrwx).
   • Set permissions on the cgi-bin/data/backup directory to 777 (rwxrwxrwx).
   • Set permissions on the cgi-bin/admin/sessions directory to 777 (rwxrwxrwx).
   • Set permissions on the cgi-bin/admin/user.db file to 666 (rwxrw-rw-).
   • Do not set permissions on any other files.

5. Upload the if_images directory to any Web accessible location on your server other than the cgi-bin. Transfer all files in BINARY mode, except for imageprotect.js and cookie.js, which must be transferred in ASCII text mode. Overwrite any existing files. The if_images directory contains many new images and files that are used for user interface details, navigation, and media protection.
   
   
6. Using a text editor, open all *.cgi files (from cgi-bin and cgi-bin/admin directories) and verify that the first line of each script points to the proper location of Perl on your server, unless yours is #!/usr/bin/perl.
   
   

   Note for Unix/Linux users...
   Most text editors are set up to save files with Windows line endings. If you experience server errors when executing a script, you may need to change/set the preferences in your text editor to save files with Unix line endings.

7. Using a text editor, open config.pl (from the cgi-bin directory) and admin_config.pl (from the cgi-bin/admin directory) and answer all of the questions. These are your ImageFolio configuration files and all variables regarding your server will need to be defined within these files. If you have trouble determining server paths, download and install this Perl script.
   
   
8. Save any modified files, then, using an FTP utility, login to your server and upload the files you modified. Be sure to overwrite existing files to preserve any permissions settings.
   
   
9. Now test the Admin area. Type in the URL to admin.cgi (it's in your cgi-bin/admin directory). Enter the username Admin and the password ImageFolio (case sensitive) when asked for it.
   
   
10. While still in the Admin area, click on the link (left side) that says Rebuild Index. This will index your gallery. It will also build or rebuild two files, index.txt and categories.txt inside you data directory. If it does not, check you settings in admin_config.pl and try again.

    Note...
    You will need to rebuild your index on a frequent basis when you add new content. New files added will be viewable, but will not be searchable, unless you rebuild your index after those files have been added.

11. Open your Web browser and type in the URL to imageFolio.cgi. If everything was installed correctly, you will see that your gallery has been updated. Click on the any category to verify that everything is working properly. If things do not look correct, check your paths and settings in config.pl and try again.