Difference between revisions of "Installation"

From Zen Cart(tm) Wiki
Jump to: navigation, search
 
(3 intermediate revisions by the same user not shown)
Line 5: Line 5:
 
*Get a server.
 
*Get a server.
 
*Make sure you have the prerequisite software
 
*Make sure you have the prerequisite software
*Download the Zen Cart™ software and upload it to your server.
+
*Download the Zen Cart® software and upload it to your server.
 
*Create a couple of configuration files.
 
*Create a couple of configuration files.
 
*Configuration
 
*Configuration
 
*Post Installation Steps
 
*Post Installation Steps
**Configure Zen Cart™.
+
**Configure Zen Cart®.
 
**Security.
 
**Security.
 
**[optional] create a local copy for development and testing.
 
**[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==
 
==Get a server==
You need to make sure that you have access to a server which can handle Zen Cart™.   
+
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 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/index.php?main_page=infopages&pages_id=10 Zen Cart™'s list of certified hosts].   
+
*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™.
+
*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®.
  
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.
+
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 webhosts 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.  
+
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 ==
 
== Get the prerequisite software ==
To administer your Zen Cart™ site, you need the following software:
+
To administer your Zen Cart® site, you need the following software:
*An FTP client, for example [http://filezilla-project.org/ filezilla].
+
*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++].
+
*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==
+
==Upload Zen Cart® to your Server==
* Go [http://www.zen-cart.com/ here] and download the most recent version of Zen Cart™.
+
* 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.
 
* 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.
+
* 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==
 
==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.
+
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]/include/dist-configure.php
 
*[ZENHOME]/admin/dist-configure.php
 
*[ZENHOME]/admin/dist-configure.php
  
 
==Set folder permissions==
 
==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).
+
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]/cache
 
*[ZENHOME]/images -- <strong> do this folder recursively </strong> (all subfolders, and all their subfolders, and all their...).
 
*[ZENHOME]/images -- <strong> do this folder recursively </strong> (all subfolders, and all their subfolders, and all their...).
Line 49: Line 51:
 
Other folders and files can have permissions of either 644 (typical) or 444 (rare) depending on your webserver configuration.
 
Other folders and files can have permissions of either 644 (typical) or 444 (rare) depending on your webserver configuration.
  
==Post Installation==
+
==Post-Installation==
You will now want to configure your Zen Cart&trade; installation.
+
You will now want to configure your Zen Cart&reg; installation.
  
 
===General===
 
===General===
Line 56: Line 58:
  
 
===Security===
 
===Security===
Steps for securing your Zen Cart&trade; installation are discussed in [[Important_Site_Security_Recommendations]]
+
Steps for securing your Zen Cart&reg; installation are discussed in [[Important_Site_Security_Recommendations]]
  
 
===Create a local copy for development and testing ===
 
===Create a local copy for development and testing ===
This topic is discussed in detail  [[LocalCopySite|here]].
+
This topic is discussed in detail  [[LocalCopySite|by clicking 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.