home *** CD-ROM | disk | FTP | other *** search
/ Practical Internet Web Designer 90 / PIWD90.iso / pc / contents / ecommerce / software / osCommerce.exe / oscommerce-2.2ms2 / INSTALL < prev    next >
Text File  |  2003-07-12  |  5KB  |  161 lines
  1. $Id: INSTALL,v 1.13 2003/07/12 09:38:07 hpdl Exp $
  2.  
  3. osCommerce 2.2 Milestone 2 Installation Guide
  4. Copyright (c) osCommerce 2003
  5.  
  6. *** The information presented here is old. It will be updated throughout   ***
  7. *** the osCommerce 2.2 Milestone path.                                     ***
  8.  
  9. ------------------------------------------------------------------------------
  10. Quick Installation Steps
  11. ------------------------------------------------------------------------------
  12.  
  13. Once having downloaded the archive from the downloads page, follow these steps
  14. to get the online shop running:
  15.  
  16. 1. Extract the files from within the package
  17.  
  18.    unzip oscommerce-2.2ms2.zip
  19.  
  20.    -- or --
  21.  
  22.    tar -xzf oscommerce-2.2ms2.tar.gz
  23.  
  24.    -- or --
  25.  
  26.    use your favourite graphical application to extract the files, such as
  27.    WinZip (http://www.winzip.com)
  28.  
  29. 2. This creates a directory called 'oscommerce-2.2ms2'. Enter this directory
  30.    and copy the 'catalog' directory to the webroot path of your webserver:
  31.  
  32.    cd oscommerce-2.2ms2
  33.    cp -R catalog /usr/local/apache/htdocs/
  34.  
  35.    For this example, '/usr/local/apache/htdocs/' is used as the webroot path
  36.    of the Apache webserver.
  37.  
  38.    Do the same for the 'admin' directory but rename the directory to a
  39.    unique and secret name. This directory does not have to reside inside the
  40.    catalog directory, though may need to be manually configured.
  41.  
  42. 3. Using your favourite browser, go to the following address:
  43.  
  44.    http://[your site]/catalog/install
  45.    
  46.    and follow the instructions on the screen.
  47.  
  48. IF YOU PREFER TO DO IT MANUALLY READ HERE:
  49.  
  50. 1. Create the 'osCommerce' database and import the sample data:
  51.  
  52.    mysqladmin create osCommerce
  53.    mysql osCommerce < ./install/oscommerce.sql
  54.  
  55.    To check if the tables have been successfully imported, you can list them
  56.    by using mysqlshow:
  57.  
  58.    mysqlshow osCommerce
  59.  
  60. 4. View the file catalog/includes/configure.php and make necessary changes. 
  61.  
  62. Now you can use your browser to view the pages which should be located at
  63. 'http://localhost/catalog/'. You can also use your browser, or a graphics
  64. viewer/editor, to view the database model which is located in the directory
  65. where you extracted the files
  66. 'oscommerce-2.2ms2/tep_database_model-pr2.1.gif'.
  67.  
  68. ------------------------------------------------------------------------------
  69. Apache/SSL/PHP Installation
  70. ------------------------------------------------------------------------------
  71.  
  72. This is a quick guide to install PHP as a dynamic apache module with SSL
  73. features.
  74.  
  75. It is recommended to read through the documentation of each package for a more
  76. in-depth installation guide.
  77.  
  78. The individual packages are available at:
  79.  
  80.   OpenSSL.......: http://www.openssl.org
  81.   MOD_SSL.......: http://www.modssl.org
  82.   Apache........: http://www.apache.org
  83.   PHP...........: http://www.php.net
  84.   Zend Optimizer: http://www.zend.com
  85.  
  86. 1. Extract the files from their packages:
  87.  
  88.    tar -xzf openssl-0.9.6.tar.gz
  89.    tar -xzf mod_ssl-2.8.1-1.3.19.tar.gz
  90.    tar -xzf apache_1.3.19.tar.gz
  91.    tar -xzf php-4.0.4pl1.tar.gz
  92.    tar -xzf ZendOptimizer-1.0.0-PHP_4.0.4-FreeBSD4.0-i386.tar.gz
  93.  
  94. 2. To install SSL support in Apache, we need to first install the OpenSSL
  95.    package:
  96.  
  97.    cd openssl-0.9.6
  98.    ./config
  99.    make
  100.    make test
  101.    make install
  102.    cd ..
  103.  
  104. 3. Once OpenSSL is installed, it is now possible to install Apache with
  105.    MOD-SSL:
  106.  
  107.    cd mod_ssl-mod_ssl-2.8.1-1.3.19
  108.    ./configure --with-apache=../apache_1.3.19 --with-ssl=../openssl-0.9.6
  109.    cd ../apache_1.3.19
  110.    ./configure --enable-module=ssl --enable-module=so
  111.    make
  112.    make certificate
  113.    make install
  114.    cd ..
  115.  
  116. 4. Once Apache is installed, PHP can be installed as a dynamic module (DS0):
  117.  
  118.    cd php-4.0.4pl1
  119.    ./configure --with-mysql=/usr/local/mysql --disable-debug \
  120.                --with-apxs=/usr/local/apache/bin/apxs
  121.    make
  122.    make install
  123.    cp php.ini-dist /usr/local/lib/php.ini
  124.    cd ..
  125.  
  126. 5. Edit the configuration files for Apache (httpd.conf) and PHP (php.ini).
  127.    Make sure the following is in the httpd.conf file:
  128.  
  129.    LoadModule php4_module libexec/libphp4.so
  130.    AddType application/x-httpd-php .php
  131.  
  132.    If you have ClearModuleList somewhere in the httpd.conf file, then you must
  133.    add this line:
  134.  
  135.    AddModule mod_php4.c
  136.  
  137. 6. To install ZendOptimizer v1.0, you must be using atleast PHP 4.0.4 with
  138.    debugging disabled:
  139.  
  140.    cd ZendOptimizer-1.0.0-PHP_4.0.4-FreeBSD4.0-i386
  141.    mkdir /usr/local/Zend
  142.    mkdir /usr/local/Zend/lib
  143.    cp ZendOptimizer.so /usr/local/Zend/lib
  144.  
  145.    Add the following to the php.ini
  146.  
  147.    zend_optimizer.optimization_level=15
  148.    zend_extension="/usr/local/Zend/lib/ZendOptimizer.so"
  149.  
  150. 7. To start Apache with SSL:
  151.  
  152.    /usr/local/apache/bin/apachectl startssl
  153.  
  154.    Or, without SSL:
  155.  
  156.    /usr/local/apache/bin/apachectl start
  157.  
  158.  
  159. After the installation, you can create a file in the webroot directory which
  160. contains <?php phpinfo(); ?> to see the php configuration variables. 
  161.