Getting Started:
Installing the Shopping System

Purpose:

This section provides the steps required to install the GoldPaint Shopping System in your domain. The section on Privileges and Directory Permissions should be reviewed first

 

Who should read:

Those responsible for installing the system. This is also an excellent overview of the system for database support personal and ISP's.

Outline:

1. Summary of Installation
2. File Location and Directory Worksheet
3. Your Confirmation Letter
4. Downloading the System
5. Where to Install GoldPaint Software Files?
6. Installing Files
7. The Install Wizard
8. Common Installation Errors

Return to Table of Contents
Go to Privileges and Directory Permissions

Summary of Installation

1) Complete your installation worksheet
2) Obtain your confirmation letter with system key.
2) Download the appropriate binary from http://www.goldpaint.com/download.html
3) Unarchive the tar or zip file into the tameroot directory.
4) Copy tame to your cgi-bin and make sure it's executable.
5) Browser access !install.tam and follow wizards instructions.

File Location and Directory Worksheet

By answering the questions below, you will have all the path, file locations and names necessary for the installation of your system.

What operating system does your domain server user?

Do you have 2MB of space for the GoldPaint Software?

Do you have enough space for your product database?

What is the path and name of your domain? (use in place of yourdomain in examples)

Where are your cgi scripts loaded? Normally, it is the cgi-bin, but other names are occasionally used. (use in place of yourcgi in examples)

What is the name of your shop?

Your Confirmation Letter

Once you have purchased the GoldPaint Software you will receive a confirmation letter. This letter contains pointers to the software for download, manuals and examples. In addition this email contains your system key. Below is a sample letter for reference.

Dear New GoldPaint User,

To install your GoldPaint Shopping System from ClickShop Com, please download the appropriate file for your platform from:
http://www.goldpaint.com/downlaod.html
and find our user manual at:
http://www.goldpaint.com/docshop
and additional examples at:
http://www.goldpaint.com/examples

If you are installing on a Windows95 or a NT system then when you unzip the file in your selected tameroot directory, make sure that you are using a 32bit unzip utility that supports long path names. There is an excellent version of this at: http://www.winzip.com/winzip/ If you use WinZip make sure that you have checked the "Use Folder names" option.

Here is the key for your domain:

You will need to paste this key into the install wizard.

UNDER NO CIRCUMSTANCES ATTEMPT TO MANUALLY TYPE THIS KEY INTO THE INSTALL WIZARD; INSTEAD COPY IT TO THE CLIPBOARD AND PASTE IT INTO THE BROWSER.

Sincerely, ClickShop Com

Downloading the System

Downloading the system is simple. You will need access to a browser, the type of server where the software is to be loaded, and at least 2MB of space on the domain server where your software will reside.

Go to http://www.goldpaint.com/download.html and select the proper software download for your server type. The system will automatically download the software to your system in the directory of your choice.

Your software is now ready for GoldPaint system installation.

Where to Install GoldPaint Software Files?

The tameroot directory is the root of the directory tree where tame keeps all it's data files and source code files.

The tameroot directory is generally named "tame" and the tameroot should never be under the web document area. This is because sensitive customer data and configuration information is stored under this directory. The "tame" directory can be inside a user's account, or in the server admin directory, or virtually any other relatively secure place other than in the web document tree.

The placement of this directory in a secure location will protect your system and ensure that it functions effectively.

The tameroot directory has two primary sub-directories: global and a web mirror. The global files contains all the GoldPaint program files. The web mirror directory will maintain a mirror image of the shops you create using the GoldPaint program.

Installing Files

Note: Read the directory permissions chapter before attempting to install the shopping system. If the directory permissions are incorrect, the installation will not be complete.

1. After you have created or designated the tameroot directory as outlined in the directory permissions section, put the archived file you downloaded into the tameroot directory.
   
   
2. Unarchive the file with the directory recursion option active. This means you must use an archive software which allows the file being opened to create both files and sub-directories. When this is complete a global directory tree is created and filled with the shopping system files.
   
   UNIX User Note: To open the download file, first use gunzip or zcat to open the *.gz file. Second, use tar to expand the resulting *.tar file.
   
   Windows User Note: To open the download file, an unzip package such as winzip with recursion active will expand the *.zip download file.
   
   
3. Verify that all the files and directories in the global directory tree have the same permissions that you gave the tameroot.
   
   
4. Copy the tame binary or tame.exe to the cgi-bin directory or other cgi directory you have selected on your installation worksheet.
   
   UNIX System Note: Depending on which directory permission scheme you are implementing, you may need to change the group name or sticky bit on the tame binary. Make sure the tame binary is executable for all permissions.
   
   
5. Start your browser and access the install wizard using the appropriate URL:
   
   Note: A browser with table support is required, Netscape is recommended
   
   UNIX/BSD: http://yourdomain/yourcgi/tame/!install.tam
   
   WinNT: http://yourdomain/yourcgi/tame.exe/!install.tam
   
   WinNT IIS: http://yourdomain/scripts/tame.exe/!install.tam?
   
   If your server requires extra path elements to access your cgi-bin then include them in the above URL. Use your worksheet as a reference.
   
   
6. Follow the install wizard's instructions.
   
   NT User Note: If the TAMICONS and example shop files fail to be copied to the web directories, tame probably can not access the cmd.exe file and the copy command. Check the permissions on your system directory.
   
   
7. To begin setting up your mall and shops see the Administration Screens section and go to the examples using your browser.
   
   http://yourdomain/yourcgi/tame/examples/index.tam
   
   
8. For problems/help, contact support@goldpaint.com.

The Install Wizard

The install wizard is a browser based process which will lead you through all the required steps to install the GoldPaint Shopping System on your system. Once the wizard is loaded you will need to provide path and directory name from your installation worksheet.

The install wizard will provide you with a list of directory path and file locations. Verify each of these is appropriate for your installation and continue the installation.

Next the system will request your system key. CUT the system key from your confirmation letter and PASTE it into the text box. DO NOT try to type in the key! Select continue to complete the installation.

Using the information you provided, the install wizard will place all files in the appropriate locations and verify that the system is functioning correctly.

If you receive an error during the installation, read the information provided and make the correction indicated. For additional help, see the common error section or contact support@goldpaint.com for support.

Common Installation Errors

GoldPaint does not operate once installed.

Verify the directory permission are correct. Also, the wrong tame binary may have been selected from the ClickShop Com download list. Verify that you are using the correct download system.

 

GoldPaint can not find all the folders and files it needs to install.

Your unarchive software was not recursive; therefore, no sub-directories were created. Check your tame directory and verify that the global directory has the appropriate sub-directories. See the directory tree in Privileges and Directory Permissions.

 

GoldPaint can not find the cgi directory.

Verify the path to the cgi directory. Often a sub-directory in the path between the root web and the cgi directory has been inadvertently eliminated.

created: 3/13/97 Katherine C. Davis