Difference between revisions of "Installation"

From Zen Cart(tm) Wiki
Jump to: navigation, search
(Required)
 
(47 intermediate revisions by 9 users not shown)
Line 1: Line 1:
 
{{Template:menuBarInstallation}}
 
{{Template:menuBarInstallation}}
== Introduction ==
+
[[Category:Installation]]
== Required ==
+
==Introduction==
The '''Minimum''' suggested server requirements for running Zen Cart™ v1.2.x are:
+
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:
PHP 4.1.x or higher (PHP 4.3.x for optimal performance),  
+
*Get a server.
Apache 1.3.x
+
*Make sure you have the prerequisite software
MySQL 3.2x or higher.
+
*Download the Zen Cart® software and upload it to your server.
Register Globals may be on or off
+
*Create a couple of configuration files.
PHP safe_mode '''off''' recommended.
+
*Configuration
 +
*Post Installation Steps
 +
**Configure Zen Cart®.
 +
**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® (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®.
 +
*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 [[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®.
  
The '''Ideal''' server configuration is:
+
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.
PHP 4.3.x or higher
 
Apache 1.3.x or 2.x
 
MySQL 3.2x or 4.0.x
 
Register Globals = off
 
PHP Safe_Mode=off
 
  
'''''Other Things To Note:'''''
+
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.
  
'''NOTE:''' Many shipping and payment modules require cURL to be installed/compiled with php.
+
== Get the prerequisite software ==
 +
To administer your Zen Cart® 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++].
  
'''NOTE:''' Support for HTTPS may be required depending on the payment methods being accepted. The use of SSL during account creation and checkout is recommended.
+
==Upload Zen Cart® to your Server==
 +
* Go [http://www.zen-cart.com/ 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.
  
'''NOTE:''' There are known issues on servers running php v4.1.2. Most issues have a workaround available.
+
==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
  
'''PHP5'''
+
==Set folder permissions==
PHP5 is not officially supported by Zen Cart™ at the present time; however, many shopowners are successfully running their shops on servers using PHP5.
+
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 -- <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 4.1 and 5.x'''
+
Other folders and files can have permissions of either 644 (typical) or 444 (rare) depending on your webserver configuration.
MySQL 4.1.x uses an encryption scheme that is not 100% supported by PHP4, so may not work with Zen Cart unless you are using PHP5 ... which of course is not officially supported by Zen Cart yet.
 
  
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.
+
==Post-Installation==
Zen Cart&trade; has not been designed to use the advanced database features in MySQL5.
+
You will now want to configure your Zen Cart&reg; installation.
  
== Getting the code ==
+
===General===
 +
For starters, take a look at [[Basic_Checklist|this admin checklist]].
  
1. Download the latest code here:  [http://http://www.zen-cart.com/modules/mydownloads/singlefile.php?lid=14 Latest Release (Full Download)]
+
===Security===
This will take you to SourceForge, which is where our files are distributed from. On that page you can choose the file you wish to download.  You will be asked to select a "mirror" (mirrors are different servers where the same files are hosted, but scattered around the world)... best to choose one close to your own geographic location.
+
Steps for securing your Zen Cart&reg; installation are discussed in [[Important_Site_Security_Recommendations]]
  
(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&package_id=125709 here]
+
===Create a local copy for development and testing ===
 +
This topic is discussed in detail  [[LocalCopySite|by clicking here]].
  
2. Unzip the file you downloaded.
+
 
Using a tool like WinZip or WinRAR, you can extract the distribution files to your local computer.
+
[[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.