Installation Guide: © 2004 - 2010 Simbirsk Technologies LTD

Installation Guide
© 2004 - 2010 Simbirsk Technologies Ltd.

2 CS-Cart Reference Guide
These instructions are the same for all CS-Cart editions and apply to CS-Cart Community, CS-Cart Professional and
CS-Cart Multi-Vendor.
Before the Installation

There are a few things that you need to have and do before you begin installing CS-Cart. These are:
1. Check that your web server meets the minimum system requirements.
2. Ensure that you can access your web server via shell or FTP.
3. Connect to your MySQL server and create a database for CS-Cart.
4. Check that you know a License number for CS-Cart unless you are going to install the trial version.
5. Download the latest release of CS-Cart from the File Area of your Help Desk account
(helpdesk.cs-cart.com) or from the CS-Cart website (www.cs-cart.com/trial.html), if you are installing the trial version.
Installation
Step 1: Download and Extract
First download the compressed distribution package with the CS-Cart files to your local computer.
Now you need to place the files in a web accessible directory on your server or hosting account. This can be either the
web root or any of its subdirectories like <web_root>/store/. If you nest the files directly in the web root, the store
home page will have the URL like http://www.example.com/index.php . Otherwise, the URL will contain the name
of the subdirectory right after the domain name, for example, http://www.example.com/store/index.php .
If you have shell access to your web server and are comfortable with using a console terminal, upload the
compressed distribution package to the required directory on your web server and extract the archive using one of the
following shell commands.
gunzip < cscart_v2.1.x.tgz | tar -xvf -

or
tar -xzvf cscart_v2.1.x.tgz

If there is only FTP access available, extract the archive on your local computer and then use your favorite FTP client to
put the files from the package to the required directory on your web server. Make sure you retain the original file and
directory structure.

Installation 3
Step 2: Adjust File Permissions

Change the original file permissions as advised below.
> chmod 666 config.local.php

> chmod -R 777 catalog
> chmod -R 777 images
> chmod -R 777 skins
> chmod -R 777 var
chmod 666 command makes the file readable and writeable for the file owner, group and other users.
chmod -R 777 command makes the directory and all the included files and subdirectories readable, writeable and
executable for all users.
Step 3: Run the Installation Wizard

Point your favorite web browser to run the installation script.
If you placed the CS-Cart files directly in the web root, open http://www.example.com/install/
If you placed the CS-Cart files to a subdirectory like <web_root>/store/, open http://www.example.com/store/
install/
Make sure to replace the www.example.com part from the examples with your true domain name.
This will open the Installation Wizard that will guide you through the installation. It is important to complete every step of
the Wizard until you see a screen saying that the installation is complete.

Step 3.1: License Agreement

Please thoughtfully read the CS-Cart License Agreement, and select the check box below the text of the Agreement to
confirm that you agree with the conditions of the Agreement. If you do not agree with any part of the Agreement, stop the
installation by closing the current page of the web browser.
If it is not the first time that you have been installing CS-Cart to this directory, the Wizard will ask you to enter the Auth
Code for the CS-Cart installation. This is a protection from unauthorized access to the installation script.
Click on Next to continue.

Installation 5
Step 3.2: Checking Server Environment

At this step, the Wizard checks that your web server meets the minimum system requirements to run CS-Cart. If some of
the tested parameters are indicated as failed, you need to fix them before you can proceed to the next step of the Wizard
and continue the installation.

Step 3.3: Host And Database Settings

At this step, you need to provide the details of your web server host and MySQL server as well as specify your License
number and define other parameters.
The fields in this form mean as follows:
Server host name - DNS name of the server on which you are installing CS-Cart.
Server host directory - Web directory where CS-Cart files are located.
Secure server host name - DNS name of the secure server to ensure HTTPS access to your store.
Secure server host directory - Web directory on the secure server where CS-Cart files are located.
MySQL server host - DNS name or the IP-address of your MySQL server.
MySQL database name - Name of your MySQL database.
MySQL user - Username for your MySQL user account.
MySQL password - Password for your MySQL user account.
Secret key to encrypt orders data - Custom sequence of alphanumerical symbols to be used as the key for
the Blowfish encryption algorithm. This is used to conform to the Protect Cardholder Data part of PCI Data
Security standards.
Administrator e-mail - Email address of the store administrator at which you will receive email notifications.
License number - Your CS-Cart license number. If you are installing the trial version, simply leave this field
blank.
Additional languages - Select the languages that must be available in the store.
Install demo data - If selected, the Wizard will import a sample product catalog and some other demo data so
you can test the store.
Step 3.4: Updating the Database

The installation script updates the CS-Cart configuration, creates database tables and populates the database with
demo data if you have selected to do so.

Installation 7
Step 3.5: Choosing a Skin

At this step, you need to choose a skin for the storefront by selecting the skin name from the drop-down box. A preview of
the selected skin is available below the box.
Step 3.6: Installing the Skin

Now the Wizard is installing the skin that you have selected at the previous step.

Step 3.7: Summary

This is the final step of the Wizard where the script reports of the successful installation and provides links to the
storefront and the Administration panel as well as your credentials to access the Administration panel. Pay special
attention to the alphanumeric code included in the message. This is the authorization code (Auth code) to run the
installation script again.
After the Installation

Once the installation is complete, it is strongly recommended that you take the following steps to protect the current
installation and the CS-Cart source code.
1. Rename the directory install/ or make it password protected.
2. Change the default administrator password.
3. Remove the distribution package from the web accessible directory on your server.
4. Change the access permissions for the configuration file config.local.php as advised below.
> chmod 644 config.local.php
The chmod 644 command leaves the file readable and writeable for the file owner and makes it readable for all
other system users. The file contents cannot be viewed in a browser though.

Installation Guide: © 2004 - 2010 Simbirsk Technologies LTD

Uploaded by

Copyright:

Available Formats

Installation Guide: © 2004 - 2010 Simbirsk Technologies LTD

Uploaded by

Document Information

Original Description:

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Installation Guide: © 2004 - 2010 Simbirsk Technologies LTD

Uploaded by

Copyright:

Available Formats

Installation Guide

© 2004 - 2010 Simbirsk Technologies Ltd.

Before the Installation

gunzip < cscart_v2.1.x.tgz | tar -xvf -

tar -xzvf cscart_v2.1.x.tgz

© 2004 - 2010 Simbirsk Technologies Ltd.

Step 2: Adjust File Permissions

> chmod 666 config.local.php

Step 3: Run the Installation Wizard

© 2004 - 2010 Simbirsk Technologies Ltd.

Step 3.1: License Agreement

Click on Next to continue.

© 2004 - 2010 Simbirsk Technologies Ltd.

Step 3.2: Checking Server Environment

Click on Next to continue.

© 2004 - 2010 Simbirsk Technologies Ltd.

Step 3.3: Host And Database Settings

Step 3.4: Updating the Database

© 2004 - 2010 Simbirsk Technologies Ltd.

Step 3.5: Choosing a Skin

Click on Next to continue.

Step 3.6: Installing the Skin

© 2004 - 2010 Simbirsk Technologies Ltd.

Step 3.7: Summary

After the Installation

> chmod 644 config.local.php

© 2004 - 2010 Simbirsk Technologies Ltd.

You might also like