1   2   3   4

12. You will be notified if the installation was successful.

Note. At this final stage of X-Cart installation you receive the so-called Auth (authentication) code. You will be requested to enter this code at the first stage of installation if you decide to reinstall X-Cart. This code is used to prevent unauthorized re-installation of X-Cart and you will also need it to install X-Cart modules (if you decide to purchase them). If you forget the code, you may look it up at any time in include/install.php file.

Picture 9: Installation wizard: installation complete.

You can use the links on this final page to access the different zones of your newly installed store.

13. Do one of the following:

• If you are not going to change the selected layout in the future, you can delete install.php file from the server. Use your FTP client, or issue rm install.php shell command from the terminal to remove the install.php file.
• If you need to keep install.php, modify it by setting the $installation_auth_code variable. This will prevent unauthorized access.

14. If your server is UNIX based, change the file permissions for the config.php file. Issue the following command:

chmod 644 config.php

Installing X-Cart Manually

This section assumes that your server is UNIX-based, you have terminal access to it and possess basic UNIX knowledge. (It is not necessary to install X-Cart manually. Installation wizard will allow you to access all options and it is recommended to use install.php script).

1. Ensure that your server meets the minimum requirements.
2. Upload the X-Cart distribution to your server by using your FTP client, put it where you want inside your web tree, then uncompress it using the following command:

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

or

tar -xzvf x-cart-X.X.tgz

3. Edit the X-Cart main configuration file, config.php. X-Cart distribution includes a sample config.php, which you can modify. You can use vi text editor, or any other text editor you like. You will need to edit the following entries:

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

These entries represent the MySQL server name, the MySQL user name, the MySQL database name, the MySQL password, the server host name, the secure server host name and the installation directory.

4. Setup the proper permissions for files and directories, issue the following shell commands:

> cd xcart
> cp -R .pgp.def .pgp # If you are planning to use the 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 X-Cart database. If the database already contains tables with names used by X-Cart, these tables will be dropped and created anew, with new data inserted. Issue the following shell commands:

> 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 products 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.

Revision date: Jan 31, 2006

1   2   3   4