X-Cart Installation Manual ========================== $Id: INSTALL,v 1.51.2.2 2004/08/31 08:38:05 svowl 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! 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 c. file_uploads is enabled d. [PHP 5] register_long_arrays is enabled (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 your server meets the minimum requirements. 2. Uncompress the module distribution and upload the files into the X-Cart directory on the server. 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 -p < sql/dbclear.sql > mysql -u -p < sql/xcart_tables.sql > mysql -u -p < sql/xcart_data.sql > mysql -u -p < sql/xcart_language_.sql where is a language code (e.g. US, DE etc) > mysql -u -p < sql/states_.sql where can take these values: AU - for Australian states CA - Canada ES - Spain UK - United Kingdom (Great Britain) US - United States if you need demo store uploaded into database issue this command via shell or command line: > mysql -u -p < sql/xcart_demo.sql * * * * * IV. I'VE INSTALLED X-CART. WHAT'S NEXT ? ======================================== Your web store's customer interface is located at: http://www.yoursite.com/xcart-directory/ 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. * * * * * 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 All rights reserved. * * * * * Thank you for reading this far. We wish you success in your e-business. Yours, X-Cart Team.