Documentation

Installation Manual

System Requirements
Installation
Localhost Installation
Core Upgrade

System Requirements

PHP version 5.2 or above. PHP configuration should include the following options (all these values are default):

	Register Globals: Off
	Magic Quotes GPC: Off
	File Uploads: On
	Session Auto Start: Off

MySQL database version 4.1 or above.
PHP CURL is required for operation of several payment gateways and systems

php GD library
ZIP is On

AbanteCart will not work properly (or at all) without these technologies.

AbanteCart runs on most server configurations, Windows or Linux based servers that utilize different PHP configurations.

Installation

The instructions below are about AbanteCart installation on a hosting server accessible on the Internet.The first step is to uncompress the AbanteCart distribution package (the 'abantecart_vX.X.X.tgz' or 'abantecart_vX.X.X.zip' file) anywhere on your local computer.

Note: you can uncompress the distribution package on your local computer using any TAR- or ZIP-compatible archive software, e.g. WinRAR (http://www.rarlab.com)

Linux Install

Upload all the files and folders from downloaded archive to your server from the your local PC folder, where you unarchived AbanteCart distribution package.

Note: you can upload all the files to your server by FTP software, e. g. Filezilla (http://filezilla-project.org).

This can be to anywhere of your choice.

e.g. /public_html/store or /public_html

For Linux/Unix make sure the following folders and files are writable.

chmod 0777 system/config.php

chmod 0777 system/

chmod 0777 system/cache/

chmod 0777 system/logs/

chmod 0777 image/

chmod 0777 image/thumbnails/

chmod 0777 download/

chmod 0777 extensions/

chmod 0777 admin/system/backup/

Note: If you do not have terminal access to your server, you can change file access permissions using an FTP client. Most of them have the "Change permissions" or "Change mode" functions. With the help of the function you are to set the permissions for the 'config.php' file and the directories listed above. The 'chmod 666 config.php' command means that you must set 666 permissions (in other words, read, write and execute permissions for the file user, group and other) for the 'config.php' file. Other commands (e.g. 'chmod -R 777 catalog') mean that you must set the same 777 permissions for the directory, its subdirectories and all the files under these directories. Please refer to your FTP client documentation for more detailed instructions on setting file permissions.

Make sure you have installed a MySQL Database which has a Mysql user assigned to it.

DO NOT USE YOUR ROOT USERNAME AND ROOT PASSWORD

Visit the store homepage

e.g. http://www.yourdomainname.com or http://www.yourdomainname.com/store/

Follow the onscreen instructions.

Delete the install directory.

Windows Install

Upload all the files and folders from the your local PC folder, where you unarchived AbanteCart distribution package.

Note: you can upload all the files to your server by FTP software, e. g. Filezilla (http://filezilla-project.org)

This can be to anywhere of your choice.

e.g. /wwwroot/store or /wwwroot

For Windows make sure the following folders and file permissions allow Read and Write.

system/config.php

system/

system/cache/

system/logs/

image/

image/data/

image/thumbnails/

download/

Make sure you have installed a MySQL Database which has a user assigned to it.

DO NOT USE YOUR ROOT USERNAME AND ROOT PASSWORD

Visit the store homepage

e.g. http://www.yourdomainname.com or http://www.yourdomainname.com/store/

Follow the onscreen instructions.

Now you should follow the Installation Wizard. The installation progress is shown in the Installation steps at the top of page.

License Agreement

Please read the license agreement. If you accept its statements, select theI agree to the license check box and click on the Continue button.

Checking Requirements

This phase checks your PHP configuration;MySQL configuration, and checks for PHP CURL, ZIP & GD support on your server;

Write permissions to files.

Write permissions to folders.

If all tests are passed, you should click the Continue button. Otherwise, contact your server administrator or hosting support.

Host And Database Settings

Now the Installation Wizard needs to know some details about your web server

You should fill in the following fields:

Database Host: Usually it is named 'localhost', but in order to be certain, refer to the Databases page in your website control panel or contact your hosting provider;

User: MySQL user login name;

Password: MySQL user password;

Database Name: MySQL database name;

Database Prefix: MySQL database prefix. Leave it blank if you have not. Some database tables has a name which consists of two parts: a table prefix and the specific database name itself. The use of prefix allows several web applications to utilize one database.

Note: Database info varies by hosting provider and is out of the scope of this document. Consult your provider's support/documentation for instructions.

Admin section unique name: Will be used in the following address: http://www.yourdomainname.com/index.php?s=your_admin where yourdomainname.com is the name of your new online store. This brings you to your Admin Login Panel

Username: login name to your Admin Panel;

Passwod: password to your Admin Panel;

E-Mail: Enter a real e-mail into the field. The default administrator e-mail, company e-mail (of Order, Support, etc. departments) and contact form recipient's email will be used the value of this field.