Difference between revisions of "Installation"

From Zen Cart(tm) Wiki
Jump to: navigation, search
 
(8 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
{{Template:menuBarInstallation}}
 
{{Template:menuBarInstallation}}
== Introduction ==
+
[[Category:Installation]]
In order to get Zen Cart&trade; functioning on a computer <strong> you have root access to </strong> you will need to to the following:
+
==Introduction==
* Install and configure PHP.
+
If you don't find the information you need here, a tutorial discussing installation of zen cart can be found [http://tutorials.zen-cart.com/index.php?article=107 here].  Briefly stated, you will need to:
* Install and configure Apache.
+
*Get a server.
* Download and install Zen Cart.
+
*Make sure you have the prerequisite software
 +
*Download the Zen Cart&reg; software and upload it to your server.
 +
*Create a couple of configuration files.
 +
*Configuration
 +
*Post Installation Steps
 +
**Configure Zen Cart&reg;.
 +
**Security.
 +
**[optional] create a local copy for development and testing.
 +
==Useful Tools==
 +
A list of [[Useful_Tools|useful software tools]] which you will find handy when working with customizing your Zen Cart&reg; (or websites in general) [[Useful_Tools|here]].
 +
==Get a server==
 +
You need to make sure that you have access to a server which can handle Zen Cart&reg;. 
 +
*If you want to install Zen Cart&reg; on a local PC (for development and testing, or because you have your own IP address and want to run a private server), you need to follow the instruction [[Installation:LocalServer|here]]. 
 +
*If you do not yet have a host, you can choose one from [http://www.zen-cart.com/hosting a list of compatible hosts].
 +
*If you already have a host, you need to make sure they provide the [[Installation:Requirements|required software]]. Check to see if your host provides specific instructions for installing Zen Cart&reg;.
  
Most Zen Cart&trade; users will pay for a web hosting company to administer their servers, in which case your web host will take care of the first 2 steps, and you need only concern yourself with the finalHowever many users find it useful to install a local copy to a privately administered PC, for the purpose of development and testing.
+
Often host providers provide one-click installs, or their own private tutorials for how to set up Zen Cart&reg; on their systems.  Check first for their documentationThe remainder of this page discusses how to set up Zen Cart&reg; on a remote host using FTP.
  
The instructions for the first two steps vary heavily depending on the OS of the computer you wish to install Zen Cart on.  Therefore separate instructions are provided for the three major OS's.
+
You will need to create and have access to a MySQL database on your server. You should consult your webhost's documentation for assistanceYou need the following permissions on your MySQL user: SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP.  On an hSphere host, this would be "dba" access, or at least read/write.  
  
Below you can find the software requirements for Zen Cart 1.3.x.
+
== Get the prerequisite software ==
 +
To administer your Zen Cart&reg; site, you need the following software:
 +
*An FTP client, for example [http://winscp.net/ WinSCP].
 +
*A text editor.  '''No, MS Word is not a text editor'''.  Pick one you like, there are countless. Try [http://notepad-plus.sf.net Notepad++].
  
== Requirements ==
+
==Upload Zen Cart&reg; to your Server==
The '''minimum''' suggested server requirements for running Zen Cart&trade; v1.3.x and higher are:
+
* Go [http://www.zen-cart.com/ here] and download the most recent version of Zen Cart&reg;.
 +
* Unzip the package to a folder on your local PC.
 +
* Use FTP to transfer the contents of the Zen Cart&reg; folder (and files) to your webserver.  Where should you put it?  That depends on your webserver.  You'll have to figure it out with them. Normally you would put the files in the already-existing public_html or htdocs folder which you find on your server.
  
* PHP 4.3.2 or higher (PHP 4.4.x for optimal performance),
+
==Create configuration files==
 +
You will need to create a couple of configuration files, and change their permissions (using the chmod or permissions feature of your FTP client) to 777 (read-write-execute for anyone). Note that [ZENHOME] below means the folder where you've put the Zen Cart&reg; contents.
 +
*[ZENHOME]/include/dist-configure.php
 +
*[ZENHOME]/admin/dist-configure.php
  
* Apache 1.3.x
+
==Set folder permissions==
 +
You will need to change the permissions on the following directories to 777 (note [ZENHOME] refers to the directory containing your Zen Cart&reg; files).
 +
*[ZENHOME]/cache
 +
*[ZENHOME]/images -- <strong> do this folder recursively </strong> (all subfolders, and all their subfolders, and all their...).
 +
*[ZENHOME]/includes/languages/english/html_includes/ -- recursively
 +
*[ZENHOME]/media
 +
*[ZENHOME]/pub
 +
*[ZENHOME]/admin/backups
 +
*[ZENHOME]/admin/images/graphs
  
* MySQL 3.2x or higher
+
Other folders and files can have permissions of either 644 (typical) or 444 (rare) depending on your webserver configuration.
  
* Register Globals may be on or off
+
==Post-Installation==
 +
You will now want to configure your Zen Cart&reg; installation.
  
* PHP Safe_Mode = '''off''' (recommended)
+
===General===
 +
For starters, take a look at [[Basic_Checklist|this admin checklist]].
  
 +
===Security===
 +
Steps for securing your Zen Cart&reg; installation are discussed in [[Important_Site_Security_Recommendations]]
  
The '''ideal''' server configuration is:
+
===Create a local copy for development and testing ===
 
+
This topic is discussed in detail  [[LocalCopySite|by clicking here]].
* PHP 4.4.x or higher
 
 
 
* Apache 1.3.x or 2.x
 
 
 
* MySQL 3.2x or 4.0.x  (with significant memory resources devoted to the MySQL processes)
 
 
 
* Register Globals = off
 
 
 
* PHP Safe_Mode = off
 
 
 
===Caveats===
 
;
 
; CURL : Many shipping and payment modules require [http://curl.haxx.se/ CURL] to be installed and compiled with php.
 
; SSL & HTTPS : Support for HTTPS may be required depending on the payment methods being accepted. The use of SSL during account creation and checkout is recommended.
 
; PHP as CGI : If you are running on a Unix/Linux host with [http://www.zen-cart.com/wiki/index.php/Troubleshoot_-_PHP_as_CGI PHP running as CGI], you may have some difficulties. In Linux, it is recommended to use PHP as an Apache module, not as a CGI app, unless you have server-level control of configuring the CGI options and advanced knowledge of tuning the server to function optimally.
 
; Zen Cart&trade; : Using Zen Cart&trade; v1.3.x+ with a PHP version lower than 4.3.2 will result in problems with maintaining sessions.
 
; PHP5 : PHP5 is not officially supported by Zen Cart&trade; v1.3.x at this time since it hasn't been exhaustively tested; however, many shopowners are successfully running their shops on servers using PHP5. The development of v1.3.x is using constructs that are more compliant with PHP5 but full specific testing for PHP5 is not a primary goal of the 1.3.x series.  Zen Cart&trade; v2.0.0 is built on PHP5, and will require PHP 5.2 as a minimum.
 
; MySQL 4.1.x : MySQL 4.1.x uses an encryption scheme that is not 100% supported by PHP4 on older servers, so may not work with Zen Cart&trade; v1.3.x unless your host has upgraded their support for compatibility between the two systems.
 
; MySQL 5 :MySQL 5 has some tighter constraints on various SQL statement constructs.  Zen Cart&trade; v1.2.x requires some coding alterations in order to work in a MySQL5 environment. Zen Cart&trade; v1.3.x has repaired these constructs and thus is expected to be compatible. Exhaustive testing has not yet been completed. You can use a simple [[mysql5 patch|patch on v1.2.x]] until then.
 
 
 
 
 
 
 
== Getting the code ==
 
#Download the latest code [http://sourceforge.net/project/showfiles.php?group_id=83781&package_id=171544 here]. This will take you to [http://www.sourceforge.net/ SourceForge], which is where the files are distributed from. On that page you can choose the file you wish to download. You will be asked to select a mirror site (mirrors are different servers where the same files are hosted, but scattered around the world). It's best to choose one close to your own geographic location.
 
#Using a tool like [http://www.winzip.com/ WinZip] or [http://www.rarlab.com/ WinRAR], you can extract the distribution files to your local computer.
 
 
 
 
 
If you need to access an older version of Zen Cart&trade;, you can find those files [http://sourceforge.net/project/showfiles.php?group_id=83781 here].
 
  
  
 
[[Category:Installation]]
 
[[Category:Installation]]

Latest revision as of 00:24, 28 February 2015


Introduction

If you don't find the information you need here, a tutorial discussing installation of zen cart can be found here. Briefly stated, you will need to:

  • Get a server.
  • Make sure you have the prerequisite software
  • Download the Zen Cart® software and upload it to your server.
  • Create a couple of configuration files.
  • Configuration
  • Post Installation Steps
    • Configure Zen Cart®.
    • Security.
    • [optional] create a local copy for development and testing.

Useful Tools

A list of useful software tools which you will find handy when working with customizing your Zen Cart® (or websites in general) here.

Get a server

You need to make sure that you have access to a server which can handle Zen Cart®.

  • If you want to install Zen Cart® on a local PC (for development and testing, or because you have your own IP address and want to run a private server), you need to follow the instruction here.
  • If you do not yet have a host, you can choose one from a list of compatible hosts.
  • If you already have a host, you need to make sure they provide the required software. Check to see if your host provides specific instructions for installing Zen Cart®.

Often host providers provide one-click installs, or their own private tutorials for how to set up Zen Cart® on their systems. Check first for their documentation. The remainder of this page discusses how to set up Zen Cart® on a remote host using FTP.

You will need to create and have access to a MySQL database on your server. You should consult your webhost's documentation for assistance. You need the following permissions on your MySQL user: SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP. On an hSphere host, this would be "dba" access, or at least read/write.

Get the prerequisite software

To administer your Zen Cart® site, you need the following software:

  • An FTP client, for example WinSCP.
  • A text editor. No, MS Word is not a text editor. Pick one you like, there are countless. Try Notepad++.

Upload Zen Cart® to your Server

  • Go here and download the most recent version of Zen Cart®.
  • Unzip the package to a folder on your local PC.
  • Use FTP to transfer the contents of the Zen Cart® folder (and files) to your webserver. Where should you put it? That depends on your webserver. You'll have to figure it out with them. Normally you would put the files in the already-existing public_html or htdocs folder which you find on your server.

Create configuration files

You will need to create a couple of configuration files, and change their permissions (using the chmod or permissions feature of your FTP client) to 777 (read-write-execute for anyone). Note that [ZENHOME] below means the folder where you've put the Zen Cart® contents.

  • [ZENHOME]/include/dist-configure.php
  • [ZENHOME]/admin/dist-configure.php

Set folder permissions

You will need to change the permissions on the following directories to 777 (note [ZENHOME] refers to the directory containing your Zen Cart® files).

  • [ZENHOME]/cache
  • [ZENHOME]/images -- do this folder recursively (all subfolders, and all their subfolders, and all their...).
  • [ZENHOME]/includes/languages/english/html_includes/ -- recursively
  • [ZENHOME]/media
  • [ZENHOME]/pub
  • [ZENHOME]/admin/backups
  • [ZENHOME]/admin/images/graphs

Other folders and files can have permissions of either 644 (typical) or 444 (rare) depending on your webserver configuration.

Post-Installation

You will now want to configure your Zen Cart® installation.

General

For starters, take a look at this admin checklist.

Security

Steps for securing your Zen Cart® installation are discussed in Important_Site_Security_Recommendations

Create a local copy for development and testing

This topic is discussed in detail by clicking here.