X-Cart Installation Manual
==========================

$Id: INSTALL,v 1.46.2.2 2004/02/05 12:25:43 mclap Exp $

Dear Customer,
Thank you  for choosing X-Cart.  We hope this manual will help you install this
software on  your  site in  several minutes!  If  you experience  some problems
during installation, don't hesitate to contact us at http://www.x-cart.com/, we
would be pleased to help you.

I.    SYSTEM REQUIREMENTS
II.   INSTALLING X-CART USING INSTALLATION WIZARD
III.  INSTALLING X-CART MANUALLY
IV.   I'VE INSTALLED X-CART. WHAT'S NEXT ?
V.    REPORTING BUGS AND PROBLEMS
VI.   WHAT IS SMARTY ?
VII.  UPGRADE NOTES

                                 *  *  *  *  *

I. SYSTEM REQUIREMENTS
======================

    1.  Web server with support for PHP version 4.0.6 or better.

        Your php.ini should match the following requirements:
        a. track_vars is enabled.
        b. safe_mode is disabled

        (all these values are default)
		
		This functions should not be included in the disabled functions list at
        php.ini: exec, popen, system.
	
        For help on this visit the PHP site at http://www.php.net.

    2.  The web server must have support for MySQL databases.  You will need to
        have access to  MySQL  database,  i.e.  to know the  MySQL server name,
        database name, username and password for MySQL access.

    3.  The server perfomance,  recommended for X-Cart to run on it, depends on
        how many visitors your store will have. Unpacked distribution of X-Cart
        requires about 3 megabytes of disk space,  but you may need more if you
        are going to use additional files and own templates for X-Cart.

    4.  The  database size used by  X-Cart depends on  the number of  products,
        customers and orders stored in it.  For example, for small shops it may
        be 1 megabyte, for medium 10, and for huge stores over 100 megabytes.

    5.  Net:SSLeay perl module, CURL or libCURL module is  required for some of
		the on-line credit card processing modules and for UPS shipping module.

    6.  EXPAT extension for php, is required for the Intershipper, UPS or USPS
        shipping modules.

                                 *  *  *  *  *

II. INSTALLING X-CART USING INSTALLATION WIZARD
===============================================

This section explains  how to install X-Cart using  X-Cart Installation Wizard.
It  assumes you  understand how  to unpack TAR archives,  what are  file access
permissions and  how to change them.  If you have  problems with  installation,
please refer to X-Cart Manual, or contact us and we can do the installation for
you.

1.  Ensure that you meet the minimum requirements.

2.  Uncompress the X-Cart  distribution archive anywhere inside  your web tree.
    On Unix-based server  with terminal access to it,  you can do it  using the
    following command:

    gunzip < x-cart-X.X.tgz | tar -xvf -
    or
    tar -xzvf x-cart-X.X.tgz

3.  Go to the X-Cart installation directory and change file access permissions.
    On Unix-based server  with terminal  access to it  you can do it  using the
    following commands:

    > cd xcart
	> chmod 777 .
    > chmod 666 config.php
	> chmod 755 admin/spam.sh
	> chmod 755 payment/*.pl

4.  Open in your browser X-Cart Installation Wizard at the following URL:

    http://www.yoursite.com/xcart_directory/install.php

    Then follow the instructions provided by the Installation Wizard.

5.  Finally you should setup proper permissions  to protect files from writing.

    You should also:
	Modify install.php by setting $installation_auth_code variable if you
	will be using it in the future. This will prevent from unauthorized access. 
    On Unix-based server with terminal access to it  you can do it
    using the following commands:

    > chmod 644 config.php
	> chmod 755 .

                                 *  *  *  *  *

III. INSTALLING X-CART MANUALLY (for advanced users)
====================================================

This section assumes that  your server is Unix-based,  you have terminal access
to it and possess basic Unix knowledge.

1.  Ensure that you meet the minimum requirements.

2.  Uncompress the X-Cart distribution anywhere inside your web tree.

3.  Edit the X-Cart main configuration file, "config.php".  X-Cart distribution
    includes a sample "config.php", which you can modify. You will need to edit
    the following entries:

    $sql_host ='%SQL_HOST%';
    $sql_user ='%SQL_USER%';
    $sql_db ='%SQL_DB%';
    $sql_password ='%SQL_PASSWOD%';
    $xcart_http_host ="%HTTP_HOST%";
    $xcart_https_host ="%HTTPS_HOST%";
    $xcart_web_dir ="%WEB_DIR%";

    These entries represent MySQL server name,  MySQL username,  MySQL database
    name and MySQL password.

4.  Setup proper permissions for files and directories:

    > cd xcart
	> cp -R .pgp.def .pgp			# If you are planning to use PGP encryption
	> mkdir templates_c
	> mkdir files
	> mkdir catalog
	> mkdir log
	> cp -Rp skin1_original skin1
    > chmod 777 templates_c
    > chmod 777 files
	> chmod 777 catalog
	> chmod 777 log
    > chmod -R 777 skin1
	> chmod 755 admin/spam.sh
	> chmod 755 payment/*.pl

5.  Setup the X-Cart database. In case the database contains tables with names,
    which are used by X-Cart, they will be dropped.

    > cd xcart
    > mysql -u <username> -p<password> <database_name> < sql/dbclear.sql
    > mysql -u <username> -p<password> <database_name> < sql/xcart_tables.sql
 	> mysql -u <username> -p<password> <database_name> < sql/xcart_data.sql
if you need demo store uploaded into database issue this command via shell or command line:
	> mysql -u <username> -p<password> <database_name> < sql/xcart_demo.sql
	> mysql -u <username> -p<password> <database_name> < sql/states_<Country>.sql
	where <Country> can take these values:
	CA
	US
	UK
	  
  
                                 *  *  *  *  *

IV. I'VE INSTALLED X-CART. WHAT'S NEXT ?
========================================

Your web store's customer interface is located at:

http://www.yoursite.com/xcart-directory/customer/

There are default user accounts in your copy of X-Cart system.
You may easily change/delete them.

a. Administrator account (valid in X-Cart Pro version only):
Usertype: Administrator
Username: admin
Password: admin
Interface URL: http://www.yoursite.com/xcart-directory/admin/

b. Provider account (valid in X-Cart Pro version only):
Usertype: provider
Username: provider
Password: provider
Interface URL: http://www.yoursite.com/xcart-directory/provider/

c. Provider account (valid in X-Cart Gold version only):
Usertype: Provider
Username: master
Password: master
Interface URL: http://www.yoursite.com/xcart-directory/provider/

d. 'Root' provider account (valid in X-Cart Pro version only):
Usertype: Provider
Username: root
Password: root
Interface URL: http://www.yoursite.com/xcart-directory/provider/

For more information about  operating X-Cart and how  to create and manage your
own on-line store, please refer to X-Cart Manual.

                                 *  *  *  *  *

V. REPORTING BUGS AND PROBLEMS
==============================

Please report bugs and suggestions  to the developer using the contact forms at

http://www.x-cart.com/

                                 *  *  *  *  *

VI.  WHAT IS SMARTY ?
=====================

Smarty is a PHP-based template engine.  X-Cart uses it to provide  X-Cart store
owners with unlimited  capabilities of customizing X-Cart's  design and layout.
You can get more information on Smarty at the following URL:

http://smarty.php.net/manual/en/

                                 *  *  *  *  *

VII. UPGRADE NOTES
===================

For detailed information about upgrading X-Cart please refer to the UPGRADE.readme file.

                                 *  *  *  *  *

X-Cart
Copyright (c) 2001-2004 Ruslan R. Fazliev <rrf@rrf.ru>
All rights reserved.

                                 *  *  *  *  *

Thank you for reading this far. We wish you success in your e-business.
Yours,
X-Cart Team.
