Moving a Store's Data Directory

These instructions are written for the server administrator rather than the merchant, because they require the creation of auth files and access to the command line interface of the server.

Moving a Store

This method of moving a store involves copying the store's data directory to the new server.

1. Verify that both servers are running the same version of ShopSite. Do not attempt to move a store and upgrade it at the same time. If the old server is running an older version of ShopSite, upgrade it before moving the store.
2. In most situations, you will need a new store.auth file for the new store. Contact your ShopSite reseller to obtain the new file.

   Note:

   If you will be using the same domain name for the new store that you had for the old store (for example, www.mystore.com), you may have run into problems when you are ready to test the new store while the old store is still running. Read about creating a hosts file on your computer for help with this issue.

3. On the new server, use the new auth file (or the temporary one) to install a new store.
4. On the old server, go to the store's data directory and create a tar file from all files except the storeid.auth file. For example, if you have commandline access to the data directory on a Linux/FreeBSD/Solaris server, you could do something like this:

   $ cd ~/www/data
   $ mv storeid.auth ..
   $ tar cvf storedata.tar *
   $ mv ../storeid.auth .

   Note:

   When using FTP (or SCP, or SFTP, etc) all transfers of files from/to the ShopSite data directory should be done in Binary mode.

5. FTP the tar file to the store's data directory on new server.
6. Untar the file into the store's data directory on the new server. This copies over the vast majority of the store's configuration information, plus the store's products and pages databases.
7. Follow the instructions for copying over any media files and HTML files, and making a few configuration changes.

Finishing Up the Move

These steps copy across images and custom HTML files used in the store, and set a few configuration options that are not stored in the data directory.

1. Copy the media directory from the old store to the new store, or upload images to the new store, including any product and page graphics, and any custom buttons.
2. For ShopSite stores that were using a real-time credit card processor, go to Commerce Setup > Payment and reselect the correct payment processor. You should not need to reenter the settings for that processor.
3. If the store is older than ShopSite 11 and using the old reports, set the location of the server access logs. Located in Reports > Configure Reports.
4. If the storefront URL is different, or if the URL of the ShopSite images directory is different, you may need to update any hardcoded URLs throughout the store configuration, such as the URLs of buttons, URLs in the store header and footer, etc.
5. Enable these other options in the new store if you had them enabled in the old store:
   • Customize the order system. Located in Commerce Setup > Order System.
   • Enable the use of SSL in ShopSite and the Shopping Cart. Located in Preferences > Hosting Service.
   • For ShopSite Pro stores with Associates, verify the URLs that Associate referrals go through.
   • For ShopSite Pro stores, upload any custom pages. Located in Merchandising > Custom Pages.
   • For ShopSite Pro stores, enter the path to a custom CGI. Located in Merchandising > Order API. (You must first copy the custom CGI to the new server.)
   • For ShopSite Pro and Manager stores, set the Publish options. Located in Utilities > Publish.
6. Publish your new ShopSite store and place a test order.
7. Once you have tested your new store, direct all traffic to your new store.

   Note:

   If you used a temporary auth file for the new store, switch to the real auth file by following these steps: •Copy the real auth file into the store's data directory. •Delete the temporary auth file. •Rename the real auth file to storeid.auth. •Change the fields in Preferences > Hosting Service to reflect the store's domain name rather than the IP address. •Go to Images, select all of the images in the list and click Reset Image Attributes. •Go to Utilities > Publish and do a full regeneration of the store.

8. Give the DNS servers and your customers about one week to find your new store. Once all traffic has ceased at the old store, retrieve all order information, then close (remove) the store.

ShopSite Help and Resource Center Last updated: December 13, 2011 Give Feedback

ShopSite Shopping Cart Software