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 SC after downloading the install files.
- Backup 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-sc-OS.zip, where OS is the name of your server's operating system, such as shopsite-sc-bsd.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.
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 SC Mall to a New Version
(Scripted Install)
(Example: ShopSite SC 4.3 to ShopSite SC 5.0)
Follow this procedure if you currently use the scripts provided by Open Market to install ShopSite SC 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
- 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-sc-OS.zip, where OS is the name of your server's operating system, such as shopsite-sc-bsd.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-sc-solaris-sparc.zip
(The file name will vary, depending on your server platform.)
- Unzip the language zip file (only if installing a language pack).
> unzip sc-italiano.zip
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 SC 5.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
IV. Install Language Packs
(You do not need to perform this step if you will be hosting only English stores.)
To enable other languages besides English:
- On the ShopSite server, unzip or untar the language pack files into the directory that you run the ShopSite installation from.
- Install a new store by following the instructions in section IV of the ShopSite SC 5.0 Scripted Installation Instructions. When editing the config_store.aa file, set the MERCHANT_LOCALE variable to one of the locales for the new language.
Once you have a store installed with the new language, that language will appear in the drop-down list of languages in all other stores.
Upgrading a ShopSite SC Store to a New Service Level
(Example: ShopSite Manager 5.0 to ShopSite Pro 5.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!
Upgrading a ShopSite TX Mall to a New Version
(Example: ShopSite TX 4.3 to ShopSite TX 5.0)
Follow the steps below to upgrade your mall from a previous version of ShopSite TX to version 5.0. If you have written your own custom store installation scripts, click here for instructions on upgrading those scripts.
Note: |
ShopSite TX 5.0 only works with Transact 5. If your Transact system is not running version 5, you must upgrade your Transact system before upgrading to ShopSite 5.0.
|
I. Download and Unpack the Install Files
- Change ownership and permissions (optional). To install versions of ShopSite TX prior to version 4.1, you had to be logged in to the root account. That is no longer true, however, you must either run the upgrade as root, or change ownership and permission on all ShopSite files and directories to the UNIX_WEB_USER_ID. We recommend that you run the upgrade from the root account if you originally installed ShopSite from the root account.
- 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.
- Use a binary-mode transfer to download the zip file for your operating system and Transact version, according to the table, below.
ShopSite
Operating System |
Transact Version |
Download File |
| Solaris-Sparc |
Transact 5 |
tx-transact5-sparc.zip |
| Irix |
Transact 5 |
tx-irix.zip |
| Linux |
Transact 5 |
tx-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 tx-solaris-sparc.zip
(The file name will vary, depending on your server platform.)
- Unzip the language zip file (only if installing a language pack).
> unzip tx-italiano.zip
- Use FTP to move screen_pack*.tar to the tms-ts directory on the Transact system. This command also moves any language pack tar files that you may have downloaded.
II. Install the Screen Pack
- Log in to the Transact system as the Transact administrator.
- Go to the tms-ts subdirectory of the Transact installation.
- Untar the screen pack file:
> tar xvf screen_pack_tms-ts.tar
- Source the transact.cshrc file in the tms-ts/conf directory.
> source ./conf/transact.cshrc
- From the tms-ts directory, install the kit:
> ./screen_pack/install.screen_pack
- Restart the Web server. You should see the message:
OK: Screen_Pack installed in the registry
III. Install Language Packs
This step is only required if you are planning on hosting non-English stores with ShopSite TX.
- Log into the Transact system as the Transact administrator.
- Go to the tms-ts subdirectory of the Transact installation.
- Source the transact.cshrc file in the tms-ts/conf directory.
> source ./conf/transact.cshrc
- Untar the language screen pack file:
> tar xvf screen_pack_tms-ts-italiano.tar
IV. 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 TX 5.0 Content Server 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 that tar on Solaris complains about symbolic links longer than 99 characters, and may not include those links in the tar files.
V. Run the Upgrade Script
Update your mall with the following command:
% start_update_mall_tx.ksh config_mall.aa
Note that the upgrade process takes 20 seconds to upgrade each store on the Transact side, or about 180 stores per hour. That is in addition to the time required to upgrade all mall-wide files.
VI. Install Language Packs
(You do not need to perform this step if you will be hosting only English stores.)
To enable other languages besides English:
- On the ShopSite server, unzip or untar the language pack files into the directory that you run the ShopSite installation from.
- Install a new store by following the instructions in section IV of the ShopSite TX 5.0 Content Server Installation Instructions. When editing the config_store.aa file, set the MERCHANT_LOCALE variable to one of the locales for the new language.
Once you have a store installed with the new language, that language will appear in the drop-down list of languages in all other stores.
Upgrading a ShopSite TX Store to a New Service Level
(Example: ShopSite TX Manager 5.0 to ShopSite TX Pro 5.0)
- Make a copy of the store's store.auth file. The file is in the store's data directory.
- Obtain or create a new store.auth file for the store that indicates the new service level of the store.
- Copy the new store.auth file to the main ShopSite directory. Verify that the upgrade_auth_file.ksh script is in the same directory.
- Edit the config_store.aa file and set the variables as indicated in installation instructions. Be sure to set PRODUCT_TYPE to the new service level for the store.
- Run the upgrade_auth_file.ksh script, and pass in the config_store.aa file as the only argument:
% upgrade_auth_file.ksh config_store.aa
