Upgrading a ShopSite Mall or Store

There are several different ShopSite upgrade procedures. Please use the correct procedure for your specific situation:

Note that all of the above procedures apply to servers running a UNIX-type operating system. For Windows 2000 servers, see the upgrading section of the Windows install instructions.

Upgrading a ShopSite Store or Mall to a New Version
(Browser-Based Install)
(Example: ShopSite Manager 5.x or 6.x to ShopSite Manager 7.0
or ShopSite Pro 6.0 to ShopSite Pro 6.3)

Use this procedure if you previously used your browser to install ShopSite after downloading the install files.

  1. Back up your ShopSite files before upgrading.

    2.  

  2. Use an FTP client to connect to support.shopsite.com.

    3.  

  3. Log in, using the username and password that were given to you for downloading the ShopSite software.

    4.  

  4. Change to the appropriate subdirectory for your server's operating system (e.g., bsd, linux, solaris-sparc, etc.).

    5.  

  5. Get the file shopsite-OS.zip, where OS is the name of your server's operating system, such as shopsite-linux.zip. Be sure to use a binary mode transfer.

    6.  

  6. If there is a patch directory in the operating system directory, cd to it. Download all of its contents to the install directory on your server. If there are patches, you will install them after completing the regular installation.

    7.  

  7. Unzip the file on the ShopSite server. Place the files in the CGI directory from which you originally installed ShopSite.
    8. Note:
    If you downloaded the zip file to your local PC and unzipped it there, use FTP to transfer it to the correct directory on the server. Be sure to use a binary mode transfer, otherwise the files will be corrupted.

     

  8. Set the permissions and ownership on wwwinstall.cgi and the tar files so that they are accessible (rwx) by the Web server.

    9.  

  9. There should be a file in the cgi-bin directory called store.bak - rename it store.auth

    10.  

  10. Run wwwinstall.cgi from the browser.

    11.  

  11. Choose Update instead of New Install.

    12.  

  12. Verify the location of the ShopSite directories on the next screen. It is recommended that you check the box to have ShopSite back up each directory before updating. Click Continue.

    13.  

  13. There may be an upgrade fee for each store in your mall that uses the new features in this version of ShopSite (read more about this). Choose whether to make the new features available to all stores during the upgrade or to make them available on a store-by-store basis at a later time. Merchants who cannot access the new features will see grayed-out buttons for those features. Click Continue.

    14.  

  14. ShopSite checks the permissions on all related directories before performing the upgrade. When all permissions are correct, click Continue Updating.

    15.  

  15. If you downloaded any patch files, install them now.

     

    1. Patches are usually a newer version of a cgi file that was originally installed as part of ShopSite, so each patch will have the same name as an existing file on your server. Locate the existing file in the ShopSite directories and make a copy of it or back it up to some other location.

      2.  

    2. Copy the patch file over the existing file.

      3.  

    3. Repeat the last two steps for each patch file that you downloaded.

If the server is running several copies of the software and sharing CGI's, then following this procedure once will upgrade every store. If they're not sharing CGI's, then you must repeat this procedure for every store.

Upgrading a ShopSite Mall to a New Version
(Scripted Install)
(Example: ShopSite 6.3 to ShopSite 7.0)

Follow this procedure if you currently use the scripts provided by ShopSite to install ShopSite stores.

I. Download and Unpack the Install Files

  1. Back up your ShopSite files before upgrading.

    2.  

  2. Use an FTP client to connect to support.shopsite.com.

    3.  

  3. Log in, using the username and password that were given to you for downloading the ShopSite software.

    4.  

  4. Navigate to the directory for your server platform.

    5.  

  5. Get the file shopsite-OS.zip, where OS is the name of your server's operating system, such as shopsite-linux.zip. Be sure to use a binary mode transfer.

    6.  

  6. If there is a patch directory in the operating system directory, cd to it. Download all of its contents to the install directory on your server. If there are patches, you will install them after completing the regular installation.

    7.  

  7. Unzip the ShopSite file.

    > unzip shopsite-solaris-sparc.zip

    (The file name will vary, depending on your server platform.)

II. Edit the config_mall.aa File

On the ShopSite server, edit the config_mall.aa file, per the instructions in section III.A of the ShopSite 7.0 Scripted Installation Instructions. It is strongly recommended that you set BACKUP_ON_UPDATE to YES to have the upgrade script tar up all ShopSite-related directories. Should something go wrong, you can untar the files to return to the previous version. The BACKUP_ON_UPDATE option can use quite a bit of disk space, so make sure you have enough before upgrading. The amount of disk space required depends on the number and size of stores in your mall.

Note: Tar on Solaris complains about symbolic links longer than 99 characters, and may not include those links in the tar files.

III. Run the Upgrade Script

Update your mall with the following command:

% start_update_mall_sc.ksh config_mall.aa

If you downloaded any patch files, install them now.

  1. Patches are usually a newer version of a cgi file that was originally installed as part of ShopSite, so each patch will have the same name as an existing file on your server. Locate the existing file in the ShopSite directories and make a copy of it or back it up to some other location.

    2.  

  2. Copy the patch file over the existing file.

    3.  

  3. Repeat the last two steps for each patch file that you downloaded.

Upgrading a ShopSite Store to a New Service Level
(Example: ShopSite Manager 7.0 to ShopSite Pro 7.0)

  1. Make a copy of your store's store.auth file. The file should be in your store's data directory.

    2.  

  2. Obtain a new store.auth file for your store from your ShopSite reseller. This new store.auth file must be built to indicate the new service level of your store.

    3.  

  3. Copy the new store.auth file to your store's data directory. Rename the file to yourstoreid.auth, where yourstoreid is the ID of your ShopSite store.

    4.  

  4. Use your browser to access ShopSite and start using the features in your new service level!

Upgrading or Replacing a Store's auth File

The "auth file" of a ShopSite store is a critical component that identifies the unique settings of that store. To make changes to any of those settings, you must get a new auth file from your ShopSite reseller and replace the existing one. Some of the reasons for replacing an auth file are:

To replace a store's auth file, follow the instructions for Upgrading a ShopSite Store to a New Service Level, above.

ShopSite Help and Resource Center
December 15, 2003
Give Feedback
© 2007, ShopSite, Inc.
ShopSite Shopping Cart Software