Difference between revisions of "X-Cart:Installation"

From X-Cart 4 Classic
Jump to: navigation, search
Line 1: Line 1:
how to install X-Cart
+
==How to install X-Cart==
 +
 
 +
== Troubleshooting ==
 +
 
 +
===Error: "Warning no such file or directory: ./COPYRIGHT".===
 +
 
 +
This or similar errors occur if some of X-Cart files are missing. They could be lost during FTP upload to the server or accidentally deleted. You should re-upload X-Cart distribution to your host and try to run installation script again.
 +
 
 +
===Fatal error: Can't connect to the MySQL server" on step 2 of installation===
 +
 
 +
Possible causes are as follows:
 +
 
 +
a) Incorrect username/password/database name of your MySQL database. You should contact your hosting administrators and ask them to specify correct access information for MySQL database (please note, this information is case sensitive).
 +
 
 +
b) If your MySQL server and X-Cart are located on different hosts there is a possibility that connection from your host to MySQL server is disabled. You should contact your hosting administrator to ask if there are any restrictions of this kind.
 +
 
 +
===Installation suddenly freezes on step 3 (importing data)===
 +
 
 +
Some mis-configured MySQL servers drop connection when feeding big amount of data from PHP script (during installation X-Cart pumps several megabytes of data into the database). You may try to restart installation process from the beginning. If you still cannot succeed you can install X-Cart manually (look for details in the INSTALL file in the X-Cart distribution or in the corresponding section of X-Cart manual).
  
 
[[Category:X-Cart user manual]][[Category:X-Cart developer guide]]
 
[[Category:X-Cart user manual]][[Category:X-Cart developer guide]]

Revision as of 16:16, 7 December 2009

How to install X-Cart

Troubleshooting

Error: "Warning no such file or directory: ./COPYRIGHT".

This or similar errors occur if some of X-Cart files are missing. They could be lost during FTP upload to the server or accidentally deleted. You should re-upload X-Cart distribution to your host and try to run installation script again.

Fatal error: Can't connect to the MySQL server" on step 2 of installation

Possible causes are as follows:

a) Incorrect username/password/database name of your MySQL database. You should contact your hosting administrators and ask them to specify correct access information for MySQL database (please note, this information is case sensitive).

b) If your MySQL server and X-Cart are located on different hosts there is a possibility that connection from your host to MySQL server is disabled. You should contact your hosting administrator to ask if there are any restrictions of this kind.

Installation suddenly freezes on step 3 (importing data)

Some mis-configured MySQL servers drop connection when feeding big amount of data from PHP script (during installation X-Cart pumps several megabytes of data into the database). You may try to restart installation process from the beginning. If you still cannot succeed you can install X-Cart manually (look for details in the INSTALL file in the X-Cart distribution or in the corresponding section of X-Cart manual).