---

To install ShopSite on your UNIX server, all you need is your favorite Web browser and ftp or telnet access to your server.

If you are upgrading from a previous version of ShopSite, please use the upgrading instructions.

Table of Contents

I. Pre-Installation Considerations

II. Planning ShopSite Directories

III. Run the Install Program

IV. Configure the Web Server

V. Build Your Store!

VI. Install Language Packs

VII. Troubleshooting

VIII. Installing on a Virtual Server

---

Pre-Installation Considerations

• Before installing ShopSite, make sure that your system meets the minimum hardware and software requirements.

• Be sure your Web server software is working correctly, including user authentication. If your Web server is not working, you cannot install ShopSite. If you do not have a Web server, a good one is Apache. It is free. ShopSite works with all NCSA compatible Web servers such as Netscape and Microsoft's IIS.

• You will need to have at least version 5.003 of Perl if you are installing ShopSite Manager or Pro. You can download the latest version at Perl's Web site. You will have to compile Perl for your server. It seems complicated, but just keep hitting "return" to accept the default configurations, and the whole process should go smoothly. Perl is also free.

Planning ShopSite Directories

If your server is a Cobat Raq, read the special instructions.

The ShopSite SC install program will prompt you for the locations of five directories:

• Executable files are put in two separate directories, a "ShopSite Directory" and a "Shopping Cart Directory". These directories need to be aliased in your server and accessible through URLs.
  ® You should put these directories in or under your server's cgi-bin directory. As a security measure, you should configure your server to only serve CGI programs from the cgi-bin directories, not text files or HTML files.
• Graphics used by all ShopSite stores are stored in a separate directory that must be accessible by the Web server. The recommended directory is shopsite-images under your Web server's document root.
• Your store needs a "Data" directory to hold its databases of products and pages.
  ® Set the permissions on the "Data" directory so that your Web server can access it, but make sure that it cannot be accessed from a browser. In other words, do not put the "Data" directory under the Web server's document root directory.
• Your store also needs an "HTML Output" directory to store its HTML files, which are the generated pages for the store. The storefront URL must be aliased to the store's HTML Output directory.
  ® Put the HTML Output Directory wherever your existing HTML goes.

  Note that the images for each store are kept in a media subdirectory of the store's HTML Output Directory, and you may want to configure FTP access to the media directory.

Plan the directory locations before starting the installation. An example directory structure might look like this:

 home

  httpd

      cgi-bin

       ss = ShopSite Directory,

               aliased to URL of ShopSite CGIs, such as

               http://www.xyz.com/cgi-bin/ss

       sc = Shopping Cart Directory,

                 aliased to URL of Shopping Cart CGIs, such as

                 http://www.xyz.com/cgi-bin/sc

      html

       shopsite-images

       StoreName = HTML Output Directory, aliased to 

                      Store Front URL defined in store.auth file

          Store pages

          media - you may need FTP access

              Store images

      data

          StoreName = Data Directory

Run the Install Program

Once you have downloaded the compressed installation program, you can easily install ShopSite using just your browser.

1. Use an FTP client to connect to shopsite.com.
2. Log in, using the username and password that were given to you for downloading the ShopSite software.
3. Navigate to the directory for your server platform.
4. Use a binary-mode transfer to download the zip file for your ShopSite version and platform. For example, the file for ShopSite SC running on Solaris Sparc servers is named shopsite-sc-solaris-sparc.zip. Put the file in the directory from which you will run the install. This must be a directory where CGI programs can execute and write.
5. 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.
6. 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.
7. Unzip the install file.

8. Copy the store.auth file into the directory containing the install files.
9. Set permissions on the files and the directory and in your Web server so that you can execute the wwwinstall.cgi and info.cgi programs from your Web browser.

10. Point your browser to the wwwinstall.cgi file in the installation directory.

11. On the first screen, click Install a Store.

12. On the next screen, enter values in the various fields and click OK. You must fill in all of the fields or the installation program will not work.

13. The installation program begins installing ShopSite and shows you the results of the install. If there were any errors, change the appropriate fields and click the OK button again.

14. If you downloaded any patch files, install them now. 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.
15. Copy the patch file over the existing file.
16. Repeat the last two steps for each patch file that you downloaded.

Configure the Web Server

Configure the Web server to recognize the new directories:

• Alias the ShopSite URL to point to the "ShopSite Directory".
• Alias the Shopping Cart URL to point to the "Shopping Cart Directory".

ShopSite requires Apache-style passwords, using .htaccess files. If you are using a Netscape server, you can configure it to use .htaccess files by following the instructions at the Netscape site.

Build Your Store!

Once you've installed the software, you're ready to build your store! Point your browser to start.cgi in the directory where you installed the CGIs. After entering your username and password, you'll see the first page of the ShopSite Store Setup Wizard, which will guide you through the process of building a store.

You can click the "?" in the upper right-hand corner of any screen to get help on that screen, and to access the searchable ShopSite help system and knowledgebase.

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:

1. Verify that you have successfully installed an English store by following the instructions in Section III.
2. Unzip or untar the language pack files into the directory that you run the ShopSite installation from.
3. Install another store, and assign the new language to it.

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.

Troubleshooting

If your installation did not work, pay attention to the error messages you receive; they should point you in the right direction. If that fails, try checking the following:

• Are file permissions set correctly for all the directories that you specified? Not having file permissions and ownership set correctly is the number one installation problem that users run into. Specifically, the UNIX user account under which CGIs are executed needs to be able to write in those CGI directories.

• Is your Web server configured correctly?

• Did you enter the same store ID and URL that you told the salesperson when the store.auth file was originally created? If you've changed your mind, you'll need a new store.auth file.

• Was the store.auth file in the same directory as the installation program? If so, it should have created a new file called yourstoreid.auth in your store's data directory.

If you still can't solve the problem, visit the ShopSite Software Support Web site and search our online resources.

Installing on a Virtual Server

On most virtual servers, the directory paths that you can see from a telnet session are not the same as when viewed from a Web browser. Keep this in mind when specifying the paths used by the browser-based install program.

• Ensure there is a tmp directory at the virtual root, or tar will produce errors.
• Make sure that the Web Server has access to the tar executable.

Iserver (Verio) Install Issues

• The Web Server does not have access to the tar executable. Copy the tar program from /bin/tar to usr/bin/tar under your home directory. For example:

        cp /bin/tar ~/usr/bin/tar
        chmod ug=rx ~/usr/bin/tar
      

• As of this writing the default perl version on Iserver is 4.0. Find a 5.004 (or later) version and copy to ~/usr/bin/perl5 or similar directory accessible to the web server. Don't forget to make the file executable ('x'). For example:

        cp /usr/local/bin/perl5.004 ~/usr/bin/perl5
      

auth