Upgrading a ShopSite Mall or Store
There are several different ShopSite upgrade procedures. Please use the correct procedure for your specific situation:
Use this procedure if you previously used your browser to install ShopSite after downloading the install files.
- Back up your ShopSite files before upgrading.
- Use an FTP client to connect to support.shopsite.com.
- Log in, using the username and password that were given to you for downloading the ShopSite software.
- Change to the appropriate subdirectory for your server's operating system (e.g., bsd, linux, solaris-sparc, etc.).
- Get the file shopsite-OS.zip, where OS is the name of your server's operating system, such as shopsite-linux.zip.
- Unzip the file on the ShopSite server. Place the files in the cgi directory from which you originally installed ShopSite.
- Set the permissions and ownership on wwwinstall.cgi and the tar files so that they are accessible
(rwx) by the Web server.
- There should be a file in the cgi-bin directory called
store.bak - rename it store.auth
- Run wwwinstall.cgi from the browser.
- Choose Update instead of New Install.
- 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.
- 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.
- ShopSite checks the permissions on all related directories before performing the upgrade. When all permissions are correct, click Continue Updating.
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 5.0 to ShopSite 6.0)
Follow this procedure if you currently use the scripts provided by ShopSite to install ShopSite stores. If you have written your own custom store installation scripts, click here for instructions on upgrading those scripts.
I. Download and Unpack the Install Files
- Back up your ShopSite files before upgrading.
- Use an FTP client to connect to shopsite.com.
- Log in, using the username and password that were given to you for downloading the ShopSite software.
- Navigate to the directory for your server platform.
- Get the file shopsite-OS.zip, where OS is the name of your server's operating system, such as shopsite-linux.zip.
- If you are going to install a non-English language pack, download that file now. You must use a different FTP username and password to access the language packs.
- 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 6.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
Upgrading a ShopSite Store to a New Service Level
(Example: ShopSite Manager 6.0 to ShopSite Pro 6.0)
- Make a copy of your store's store.auth file. The file should be in your store's data directory.
- 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.
- 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.
- Use your browser to access ShopSite and start using the features in your new service level!
