The following sections discuss how to download and install prerequisite software and install Magento CE or EE on a system running:<\/p>\n
- \n
- Ubuntu 10 or later, or CentOS 6<\/li>\n
- Apache 2.x<\/li>\n
- nginx 1.7.x<\/li>\n
- PHP 5.4 and required extensions<\/li>\n
- MySQL database<\/li>\n<\/ul>\n
SELinux Prerequisite<\/h3>\n
Security Enhanced Linux (SELinux)<\/a> enables CentOS and Ubuntu administrators greater access control over their servers. If you’re using SELinux and<\/em> Apache must initiate a connection to another host, you must run the commands discussed in this section.<\/p>\n
If Apache and the database server are on the same host, you can skip this section and continue with Opening Ports In Your Firewall<\/a>.<\/p>\n
To enable Apache to initiate a connection to another host with SELinux enabled:<\/p>\n
- \n
- To determine if SELinux is enabled, use the following command:\n
getenforce<\/pre>\n
Enforcing<\/code> displays to confirm that SELinux is running.<\/li>\n- Enter one of the following commands:\n
- \n
- CentOS\n
setsebool -P httpd_can_network_connect=1<\/pre>\n<\/li>\n
- Ubuntu\n
setsebool -P apache2_can_network_connect=1<\/pre>\n<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n
Opening Ports In Your Firewall<\/h3>\n
Depending on your security requirements, you might find it necessary to open port 80 and other ports in your firewall. Because of the sensitive nature of networking security, Magento strongly recommends you consult with your IT department before proceeding. Following are some suggested references:<\/p>\n
Creating phpinfo.php<\/h4>\n
phpinfo.php<\/code><\/a> displays a large amount of information about PHP and its extensions. Add the following code anywhere in your web server’s docroot:<\/p>\n<?php\n\/\/ Show all information, defaults to INFO_ALL\nphpinfo();<\/pre>\n
To view the results, enter the following URL in your browser’s location or address field:<\/p>\n
http:\/\/web-server-ip-or-host<\/em>\/phpinfo.php<\/pre>\n
Installing phpmyadmin<\/h4>\n
phpmyadmin<\/code> is an easy-to-use, free database administration utility. You can use it to check and manipulate the contents of your database. You must log in tophpmyadmin<\/code> as the MySQL database administrative user.<\/p>\nFor more information about
phpmyadmin<\/code>, see the phpmyadmin home page<\/a>.<\/p>\nFor more detailed information about installation, see the phpmyadmin installation documentation<\/a>.<\/p>\n
To install phpmyadmin on CentOS:<\/p>\n
- \n
- Download the epel RPM for the version of CentOS you’re using. A sample follows.\n
cd \/tmp\nwget http:\/\/download.fedoraproject.org\/pub\/epel\/6\/i386\/epel-release-6-8.noarch.rpm\nrpm -ivh epel-release-6-8.noarch.rpm<\/pre>\n<\/li>\n
- Install
phpmyadmin<\/code> as follows:\nyum -y install phpmyadmin<\/pre>\n<\/li>\n
- Authorize access to phpmyadmin from your machine’s IP address.\n
- \n
- Open the following file for editing:\n
vim \/etc\/httpd\/conf.d\/phpMyAdmin.conf<\/pre>\n<\/li>\n
- Replace the following IP address with your IP address\n
#Require ip 127.0.0.1<\/pre>\n
For example,<\/p>\n
Require ip 192.51.100.101<\/pre>\n<\/li>\n
- Replace the following IP with your IP address\n
#Allow from 127.0.0.1<\/pre>\n
For example,<\/p>\n
Allow from 192.51.100.101<\/pre>\n<\/li>\n<\/ol>\n<\/li>\n
- Save your changes to
\/etc\/httpd\/conf.d\/phpMyAdmin.conf<\/code> and exit the text editor.<\/li>\n- Restart Apache.\n
service httpd restart<\/pre>\n<\/li>\n
- To use phpmyadmin, enter the following command in your browser’s address or location field:\n
http:\/\/host-or-ip-address<\/em>\/phpmyadmin<\/pre>\n<\/li>\n
- When prompted, log in using your MySQL database
root<\/code> or administrative user’s user name and password.<\/li>\n<\/ol>\nCreating a Magento Database Instance<\/h3>\n
This section discusses how to create a new database instance for Magento. Although a new database instance is recommended, you can optionally install Magento into an existing database instance. If you choose to do that, skip this section and continue with Installing Optional Sample Data<\/a>.<\/p>\n
![\"\"](\"https:\/\/easy-admin.ca\/my_uploads\/2015\/12\/magento-009.png\")
Note<\/strong>: Before you continue, review the information about MySQL discussed in Prerequisites<\/a>.<\/div>\nTo create a new database instance:<\/p>\n
- \n
- Log in to your database server as any user.<\/li>\n
- Enter the following commands in the order shown to create a database instance named
magento<\/code>:\nmysql -u root -p \n#Enter the remaining commands at the mysql> prompt.\n\ncreate database magento;\nGRANT ALL ON magento.* TO magento@localhost IDENTIFIED BY 'magento';<\/pre>\n<\/li>\n
- For MySQL versions between 5.0.2 and 5.1.6, you must enter this command:\n
GRANT SUPER ON *.* TO 'magento'@'localhost';<\/pre>\n<\/li>\n
- After you’re done, enter
exit<\/code><\/code><\/li>\n- Test the database instance.\n
mysql -u magento -p<\/pre>\n
Messages similar to the following display to confirm you successfully created the database instance. If errors display, repeat the preceding commands.<\/p>\n
Welcome to the MySQL monitor. Commands end with ; or \\g.\nYour MySQL connection id is 20\nServer version: 5.1.67 Source distribution\n\nCopyright (c) 2000, 2012, Oracle and\/or its affiliates. All rights reserved.\n\nOracle is a registered trademark of Oracle Corporation and\/or its\naffiliates. Other names may be trademarks of their respective\nowners.\n\nType 'help;' or '\\h' for help. Type '\\c' to clear the current input statement.<\/pre>\n<\/li>\n<\/ol>\n
Extracting the Magento Installation Archive<\/h3>\n
Extract the Magento installation archive on your web server’s docroot.<\/p>\n
The path on Ubuntu is typically
\/var\/www<\/code><\/p>\nThe path on CentOS is typically
\/var\/www\/html<\/code><\/p>\nExamples follow:<\/p>\n
- \n
- Ubuntu\n
cd \/var\/www\ncp \/path<\/em>\/magento-install-archive<\/em> .\ntar -zxf magento-install-archive-name<\/em><\/pre>\n<\/li>\n
- CentOS\n
cd \/var\/www\/html\ncp \/path<\/em>\/magento-install-archive-name<\/em> .\ntar -zxf magento-install-archive<\/em><\/pre>\n<\/li>\n<\/ul>\n
To optionally install Magento sample data, continue with the next section.<\/p>\n
To install Magento without sample data, continue with Setting File and Directory Ownership and Privileges<\/a>.<\/p>\n
Installing Optional Sample Data<\/h3>\n
Magento provides sample data you can optionally install to give you an idea of what products look like in the Admin Panel and in your web store. You can use this sample data to learn how Magento works and to experiment with custom themes.<\/p>\n
You must install sample data on the file system and in the database before<\/em> you install Magento.<\/p>\n
Note<\/strong>: Only if your database is shared between more than one Magento installation<\/em>. Database table names used by the sample data are not configurable. To use sample data with a new Magento installation, you must manually add a prefix to all sample data tables and use the same prefix when you install Magento.<\/div>\nTo skip sample data installation, continue with Setting File and Directory Ownership and Privileges<\/a>.<\/p>\n
To install Magento sample data:<\/p>\n
- \n
- Download the sample data from one of the locations discussed in Getting Magento CE or EE<\/a>.<\/li>\n
- If necessary, transfer the sample data to your Magento server.<\/li>\n
- On your Magento server, extract the sample data archive to a directory other than your Magento installation directory.<\/li>\n
- Make note of the path to the sample data’s
media<\/code> subdirectory.<\/li>\n- Change to the
[your Magento install dir]\/media<\/code> directory.\n#Ubuntu example\ncd \/var\/www\/magento\/media\n\n#CentOS example\ncd \/var\/www\/html\/magento\/media<\/pre>\n<\/li>\n
- As a user with privileges to write to the Magento installation directories (typically the web server user), copy the sample data’s
media<\/code> directory and subdirectories to your Magento installation directory.
\nFor example, to copy Magento sample data from\/home\/username<\/code> to\/var\/www\/magento<\/code>, enter<\/p>\ncp -R \/home\/username\/media\/* .<\/pre>\n<\/li>\n
- Magento CE 1.9 and Magento EE 1.14 only<\/em>. You must also copy the sample data’s
skin<\/code> directory to[your Magento install dir]\/skin<\/code> as follows:
\nFor example, to copy Magento skin files from\/home\/username\/skin<\/code> to\/var\/www\/magento\/skin<\/code>, enter<\/p>\ncd [your Magento install dir]\/skin\ncp -R \/home\/username\/skin\/* .<\/pre>\n<\/li>\n
- Import the CE or EE sample data into your MySQL database as follows:\n
mysql -u root -p magento-db-instance-name<\/em> < path-to-sample-data-extract-dir<\/em>\/sample-data-filename<\/em>.sql<\/pre>\n
EE 1.14 example<\/p>\n
mysql -u root -p magento < \/home\/username\/magento_sample_data_for_1.14.0.0.sql<\/pre>\n<\/li>\n<\/ol>\n
Setting File and Directory Ownership and Privileges<\/h3>\n
Magento recommends the following ownership and privilege settings for files and directories in the Magento installation directory:<\/p>\n
- \n
- The Magento installation directory and all subdirectories are owned by the web server user.
\nThis enables the web server to change files in these subdirectories but other users cannot access them (except a higher-level user such asroot<\/code>).<\/li>\n- All directories have 700 permissions (
drwx------<\/code>).
\n700 permissions give full control (that is, read\/write\/execute) to the owner and no permissions to anyone else.<\/li>\n- All files have 600 permissions (
-rw-------<\/code>).
\n600 permissions mean the owner can read and write but other users have no permissions.<\/li>\n<\/ul>\nNote<\/strong>: The way you set permissions and ownership depends on whether Magento is running on a dedicated or hosted system:<\/p>\n
- \n
- Hosted<\/em>: A Magento server located on a hosting provider. A hosted<\/em> system typically does not enable you to elevate to
root<\/code>. The web server typically runs as an ordinary user. Magento assumes you log in as this user to start and stop the web server and that you already own all the files and directories in the Magento installation directory. You can usechmod<\/code> to change permissions on files and directories.<\/li>\n- Dedicated<\/em>: A Magento server you control and operate. Unlike a hosted system, you can elevate to
root<\/code> and, asroot<\/code>, you can use thechown<\/code> andchmod<\/code> commands to set ownership and privileges in the Magento installation directory.<\/li>\n<\/ul>\nTo set privileges and ownership:<\/p>\n
- \n
- Log in to your Magento server.<\/li>\n
- Change to your Magento installation directory:\n
#Ubuntu example\ncd \/var\/www\/magento\n\n#CentOS example\ncd \/var\/www\/html\/magento<\/pre>\n<\/li>\n
- Dedicated Magento server only<\/em>. Enter the following command to set ownership of the Magento installation directory and all its subdirectories:\n
chown -R web-server-user-name<\/em> .<\/pre>\n
For example, on Ubuntu where Apache usually runs as
www-data<\/code>, enter<\/p>\nchown -R www-data .<\/pre>\n<\/li>\n
- Enter the following commands to set directory permissions to 700 and file permissions to 600:\n
find . -type d -exec chmod 700 {} \\;\nfind . -type f -exec chmod 600 {} \\;<\/pre>\n<\/li>\n<\/ol>\nInstalling Magento CE or EE<\/h2>\n
This section discusses how to run the Magento installer, using Magento EE as an example. The Magento CE installer has exactly the same options; only the appearance is different.<\/p>\n
Important<\/strong>: The procedure that follows assumes that your web server and database server are on the same host. If they are installed on different hosts, additional tasks are required. Get help<\/a> before you continue your installation.<\/div>\nTo install Magento CE or EE:<\/p>\n
- \n
- Complete all of the tasks discussed earlier in this article.<\/li>\n
- Enter the following URL in your web browser’s address or location field:\n
web-server-ip-or-host<\/em>:port<\/em>\/magento-path<\/em>\/magento<\/pre>\n
For example, if your web server is
http:\/\/www.example.com<\/code>, listens on port 80, and Magento is installed in the web server docroot’smagento<\/code> subdirectory, enter<\/p>\nhttp:\/\/www.example.com\/magento<\/pre>\n
Select the check box that indicates you agree to the terms and conditions, and click Continue<\/strong>.<\/li>\n
- On the Localization page, enter the following information.
\n - On the Localization page, enter the following information.
- Enter the following commands to set directory permissions to 700 and file permissions to 600:\n
- Dedicated<\/em>: A Magento server you control and operate. Unlike a hosted system, you can elevate to
- All directories have 700 permissions (
- CentOS\n
- For MySQL versions between 5.0.2 and 5.1.6, you must enter this command:\n
- Restart Apache.\n
- Authorize access to phpmyadmin from your machine’s IP address.\n
- Download the epel RPM for the version of CentOS you’re using. A sample follows.\n
- Enter one of the following commands:\n
- To determine if SELinux is enabled, use the following command:\n
![\"\"](\"https:\/\/easy-admin.ca\/my_uploads\/2015\/12\/magento-002.png\")
<\/li>\n![\"\"](\"https:\/\/easy-admin.ca\/my_uploads\/2015\/12\/magento-003.png\")
<\/p>\n![\"\"](\"https:\/\/easy-admin.ca\/my_uploads\/2015\/12\/magento-004.png\")
<\/li>\n![\"\"](\"https:\/\/easy-admin.ca\/my_uploads\/2015\/12\/magento-005.png\")
Important<\/strong>: If errors display, you must resolve them before continuing.<\/div>\n<\/li>\n![\"\"](\"https:\/\/easy-admin.ca\/my_uploads\/2015\/12\/magento-006.png\")
<\/li>\n![\"\"](\"https:\/\/easy-admin.ca\/my_uploads\/2015\/12\/magento-007.png\")
<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n![\"\"](\"https:\/\/easy-admin.ca\/my_uploads\/2015\/12\/magento-008.png\")
<\/li>\n<\/ol>\n