osCommerce Release 2.2-CVS ($date$)

QUICK INSTALLATION STEPS
------------------------
 
Once having downloaded the archive from the downloads page,
follow these steps to get the online shop running:

1. Extract the files from within the package

   tar -xzf tep_catalog-pr2.1.tar.gz
 
2. This creates a directory called 'tep_catalog-pr2.1'. Enter
   this directory and copy the 'catalog' directory to your
   webroot directory of your webserver:

   cd tep_catalog-pr2.1
   cp -R catalog /usr/local/apache/htdocs/

   For this example, '/usr/local/apache/htdocs/' is used as
   the webroot root directory of apache.
 
3. Using your favourite browser, go to the following address:

   http://[your site]/catalog/install
   
   and follow the instructions on the screen.

IF YOU PREFER TO DO IT MANUALLY READ HERE:

1. Create the 'catalog' database and import the sample data:

   mysqladmin create catalog
   mysql catalog < ./install/oscommerce.sql

   To check if the tables have been successfully imported, you
   can list them by using mysqlshow:

   mysqlshow catalog
 
4. View the file catalog/includes/configure.php and make
   necessary changes. 

Note: You need to enable the option REPAIR_BROKEN_CART for
the application to run properly under PHP3.

Now you can use your browser to view the pages which should be
located at 'http://localhost/catalog/'. You can also use your
browser, or a graphics viewer/editor, to view the database
model which is located in the directory where you extracted
the files 'tep_catalog-pr2.1/tep_database_model-pr2.1.gif'. 


APACHE/SSL/PHP INSTALLATION
---------------------------

This is a quick guide to install PHP as a dynamic apache
module with SSL features.

It is recommended to read through the documentation of
each package for a more in-depth installation guide.
 
The individual packages are available at:

  OpenSSL.......: http://www.openssl.org
  MOD_SSL.......: http://www.modssl.org
  Apache........: http://www.apache.org
  PHP...........: http://www.php.org
  Zend Optimizer: http://www.zend.com

1. Extract the files from their packages:

   tar -xzf openssl-0.9.6.tar.gz
   tar -xzf mod_ssl-2.8.1-1.3.19.tar.gz
   tar -xzf apache_1.3.19.tar.gz
   tar -xzf php-4.0.4pl1.tar.gz
   tar -xzf ZendOptimizer-1.0.0-PHP_4.0.4-FreeBSD4.0-i386.tar.gz
 
2. To install SSL support in Apache, we need to first install
   the OpenSSL package:
 
   cd openssl-0.9.6
   ./config
   make
   make test
   make install
   cd ..
 
3. Once OpenSSL is installed, it is now possible to install
   Apache with MOD-SSL:
 
   cd mod_ssl-mod_ssl-2.8.1-1.3.19
   ./configure --with-apache=../apache_1.3.19 --with-ssl=../openssl-0.9.6
   cd ../apache_1.3.19
   ./configure --enable-module=ssl --enable-module=so
   make
   make certificate
   make install
   cd ..
 
4. Once Apache is installed, PHP can be installed as a dynamic
   module (DS0):
 
   cd php-4.0.4pl1
   ./configure --with-mysql=/usr/local/mysql --disable-debug --with-apxs=/usr/local/apache/bin/apxs
   make
   make install
   cp php.ini-dist /usr/local/lib/php.ini
   cd ..
 
5. Edit the configuration files for Apache (httpd.conf)
   and PHP (php.ini). Make sure the following is in the
   httpd.conf file:
 
   LoadModule php4_module libexec/libphp4.so
   AddType application/x-httpd-php .php
 
   If you have ClearModuleList somewhere in the httpd.conf
   file, then you must add this line:
 
   AddModule mod_php4.c
 
6. To install ZendOptimizer v1.0, you must be using atleast 
   PHP 4.0.4 with debugging disabled:
 
   cd ZendOptimizer-1.0.0-PHP_4.0.4-FreeBSD4.0-i386
   mkdir /usr/local/Zend
   mkdir /usr/local/Zend/lib
   cp ZendOptimizer.so /usr/local/Zend/lib
 
   Add the following to the php.ini
 
   zend_optimizer.optimization_level=15
   zend_extension="/usr/local/Zend/lib/ZendOptimizer.so"
 
7. To start Apache with SSL:

   /usr/local/apache/bin/apachectl startssl

   Or, without SSL:

   /usr/local/apache/bin/apachectl start


After the installation, you can create a file in the webroot
directory which contains <?php phpinfo(); ?> to see the
php configuration variables.