Difference between revisions of "Installation"

From Zen Cart(tm) Wiki
Jump to: navigation, search
(Getting the code)
 
(48 intermediate revisions by 9 users not shown)
Line 1: Line 1:
 
{{Template:menuBarInstallation}}
 
{{Template:menuBarInstallation}}
== Introduction ==
+
[[Category:Installation]]
== Required ==
+
==Introduction==
== Getting the code ==
+
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:
 +
*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_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®.
  
1. Download the latest code here:  [http://http://www.zen-cart.com/modules/mydownloads/singlefile.php?lid=14 Latest Release (Full Download)]
+
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 documentationThe remainder of this page discusses how to set up Zen Cart® on a remote host using FTP.
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 downloadYou 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.
 
  
(If you need to access an older version of Zen Cart™, you can find those files [http://sourceforge.net/project/showfiles.php?group_id=83781&package_id=125709 here]
+
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.  
  
2. Unzip the file you downloaded.
+
== Get the prerequisite software ==
Using a tool like WinZip or WinRAR, you can extract the distribution files to your local computer.
+
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++].
 +
 
 +
==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.
 +
 
 +
==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 -- <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
 +
 
 +
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&reg; installation.
 +
 
 +
===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]]
 +
 
 +
===Create a local copy for development and testing ===
 +
This topic is discussed in detail  [[LocalCopySite|by clicking here]].
 +
 
 +
 
 +
[[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.