Upgrading a ShopSite Mall or Store

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

• Upgrading a ShopSite Store or Mall to a New Version (browser-based install)
• Upgrading a ShopSite Store to a New Service Level
• Upgrading or Replacing a Store's auth File

Note that all of the above procedures apply to servers running a Linux or FreeBSD-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 10 or 11sp2 to ShopSite Manager 12
or ShopSite Pro 11sp1 to ShopSite Pro 12)

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. Use an FTP client to connect to support.shopsite.com.

 

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

 

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

 

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. 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. Unzip the file on the ShopSite server. Place the files in the CGI directory from which you originally installed ShopSite.

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. There should be a file in the cgi-bin directory called store.bak - rename it store.auth

 

10. Run wwwinstall.cgi from the browser.

 

11. Choose Update instead of New Install.

 

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. 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. ShopSite checks the permissions on all related directories before performing the upgrade. When all permissions are correct, click Continue Updating.

 

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. Copy the patch file over the existing file.

     

    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 Store to a New Service Level
(Example: ShopSite Manager 12 to ShopSite Pro 12)

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

 

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. 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. 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:

• Upgrading a store from Starter to Manager or Pro, or from Manager to Pro
• Activating new features in a new version of ShopSite
• Changing the domain name of your store

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