Chapter 1: Installation
In this chapter:
- 1.1: Downloading your Installer Script
- 1.2: Uploading and Setting Permissions
- 1.3: Directory Structure
- 1.4: Final Install Procedure
- 1.5: Calling the Script
- 1.6: Troubleshooting
1.1: Downloading Your Installer Script
Rather than asking you to download a complex zip file, uploading, settings permissions, and running everything manually, EDatCat does the majority of this for you. You will grateful, as EDatCat is comprised of about 60 files. Downloading and installing EDatCat consists of giving our script some basic info about your site. Next. our script will generate a custom installer file based on your specs. You create and set permissions on 5 directories, upload your installer, set permissions, and run it. EDatCat does the rest. Installation should take no more than 5 minutes.
The installation of EDatCat begins on our main web site. During the first two steps, you will be asked to provide basic information about your server, your site, and your store. These first two steps are outlined below.
Step One.
Path to Perl5 on your server.
This is usually either /usr/bin/perl or usr/local/bin/perl
Full path to where the Edatcat CGI scripts will reside.
This should be the server path, e.g.-
/usr/home/your-site/www/cgi-bin
Full URL to where the EDatCat CGI scripts will reside.
For example: http://www.your-site.com/cgi-bin
File extension to be used for CGI scripts.
Either .cgi or .pl
File extension to be used for templates.
You may use .txt or no extension at all. If you
are using SSI templates for other static pages on your site, you can choose no extension
for EDatCat's templates and they can be used via SSI on the rest of your site.
3-letter code to be used to identify this site's catalog files.
This can be anything you want it to be. Your
scripts will be generated using this three-letter code. For example, if you
designate your code to be ABC, your main script will be called ABCstore.pl.
Administration password you would like to use.
Should be at least 8 characters.
URL to your site.
Your web address- http://www.your-site.com.
Absolute path to the URL above.
The server path to your root www directory. For
example: /usr/home/your-site/www
Your company's Store Name as it will appear on web pages.
This is fairly self-explanatory.
Step Two.
EDatCat will generate default setting for the below variables. You
may keep these settings or specify new locations for the directories below.
Directory path for uploaded image files.
Example: /usr/home/your-site/www/images/uploads
URL to uploaded image files.
Example:
http://www.your-site.com/images/uploads
Directory path to templates.
Example:
/usr/home/your-site/www/templates
URL to templates.
Example:
http://www.your-site.com/templates
Directory path to admin directory.
Example:
/usr/home/your-site/www/admin
URL to admin directory.
Example: http://www.your-site.com/admin
Note Concerning the final variables
below:
We strongly suggest that you place these directories outside the viewable
directory structure of your web site or in a directory that restricts listings.
Path to the directory where EdatCat will store shopping carts.
Example: /usr/home/your-site/catalog/carts
Path to where EdatCat will setup the data files.
Example:
/usr/home/your-site/catalog/data
On the next page, you will be given a link to your custom installer script, named using the three-letter code you specified (i.e.- ABCsetup.pl).
Right click with your mouse on this link and click "Save Target As..." (in IE) or "Save Link As..." (in Netscape). Save the file to your computer.
Your next step is to create directories and upload and set permissions on your installer.