Actions

Help

Difference between revisions of "Install:Quick Install Magento"

From OpenLiteSpeed Wiki

m (Add The Correct PHP Path To The $Path Environment Variable: Removed unintended code block.)
m (Updated Installation link.)
 
(6 intermediate revisions by 2 users not shown)
Line 1: Line 1:
After [[Help:Installation|downloading and installing OpenLiteSpeed]], follow the instructions below to get your Magento site working. The installation process for Magento 1.x and Magento 2.0 are slightly different, so please ensure that you are following that steps for the the version you wish to install.
+
After [[Help:Installation_Guides|downloading and installing OpenLiteSpeed]], follow the instructions below to get your Magento site working. The installation process for Magento 1.x and Magento 2.0 are slightly different, so please ensure that you are following that steps for the the version you wish to install.
  
  
Line 13: Line 13:
  
 
:: '''Note:''' There are different versions of LSPHP (lsphp53, lsphp54, lsphp55, lsphp56, lsphp70, lsphp71) available. Please check your Magento version for PHP requirements.
 
:: '''Note:''' There are different versions of LSPHP (lsphp53, lsphp54, lsphp55, lsphp56, lsphp70, lsphp71) available. Please check your Magento version for PHP requirements.
 +
  
 
[http://www.litespeedtech.com/support/wiki/doku.php?id=litespeed_wiki:php:rpm#direct_lsws_to_the_location_of_the_installed_php Direct LSWS to the location of the installed PHP binary.] (In this example, PHP 5.6 is installed by default in <code>/usr/local/lsws/lsphp56/bin/lsphp</code>. In the WebAdmin Console, change the value of the '''External App > your_external_application > Command''' setting to reflect the PHP version you are using.)
 
[http://www.litespeedtech.com/support/wiki/doku.php?id=litespeed_wiki:php:rpm#direct_lsws_to_the_location_of_the_installed_php Direct LSWS to the location of the installed PHP binary.] (In this example, PHP 5.6 is installed by default in <code>/usr/local/lsws/lsphp56/bin/lsphp</code>. In the WebAdmin Console, change the value of the '''External App > your_external_application > Command''' setting to reflect the PHP version you are using.)
Line 26: Line 27:
  
 
== Set Up Magento On A Vhost ==
 
== Set Up Magento On A Vhost ==
Here we will use the default virtual host "Example".
+
Using the default "Example" virtual host:
  
 
# In the WebAdmin Console, navigate to '''Configuration > Virtual Hosts > Example > General > Index Files'''.
 
# In the WebAdmin Console, navigate to '''Configuration > Virtual Hosts > Example > General > Index Files'''.
Line 57: Line 58:
 
# Register or log in to [https://account.magento.com/customer/account/login/ Magento.com].
 
# Register or log in to [https://account.magento.com/customer/account/login/ Magento.com].
 
# [https://magento.com/tech-resources/download Download Magento from their release archive].
 
# [https://magento.com/tech-resources/download Download Magento from their release archive].
# copy/ftp the downloaded files into your server's document root. Magento should be put in a subdirectory of the virtual host. For example, <code>/usr/local/lsws/Example/html/magento</code>. (This puts all the files in the right directory for running Magento on the virtual host "Example".)
+
# copy/ftp the downloaded files into your server's document root. Magento should be put in a subdirectory of the virtual host. For example, <code>/usr/local/lsws/Example/html/magento</code>. (This puts all the files in the right directory for running Magento on the default "Example" virtual host.)
 
# Using Magento 1.9.3.1 as an example, uncompress the downloaded files with the following command: <code>tar -zxvf magento-1.9.3.1.tar.gz</code>
 
# Using Magento 1.9.3.1 as an example, uncompress the downloaded files with the following command: <code>tar -zxvf magento-1.9.3.1.tar.gz</code>
  
 
=== Change Ownership Of All Files In The Magento Directory ===
 
=== Change Ownership Of All Files In The Magento Directory ===
In order for the web server to have write permissions during installation, ownership of the uncompressed Magento Files must be changed to the "nobody" user. Using the "Example" virtual host as an example, do so with the following command:   
+
In order for the web server to have write permissions during installation, ownership of the uncompressed Magento Files must be changed to the "nobody" user. Using the default "Example" virtual host, do so with the following command:   
  
<code>chown -R nobody /usr/local/lsws/DEFAULT/html/magento</code>
+
<code>chown -R nobody /usr/local/lsws/Example/html/magento</code>
  
 
=== Add The Required Rewrite Rules To Your Virtual Host Settings ===
 
=== Add The Required Rewrite Rules To Your Virtual Host Settings ===
 +
Using the default "Example" virtual host:
 +
 
# In the  WebAdmin Console, navigate to '''Virtual Hosts > Example > Rewrite'''.
 
# In the  WebAdmin Console, navigate to '''Virtual Hosts > Example > Rewrite'''.
 
# Set '''Enable Rewrite''' to '''Yes'''.
 
# Set '''Enable Rewrite''' to '''Yes'''.
Line 146: Line 149:
  
 
=== Choose An Installation Directory For Magento 2 ===
 
=== Choose An Installation Directory For Magento 2 ===
Using the default "Example" virtual host, we create a directory for our Magento 2 installation and enter it.  
+
Using the default "Example" virtual host, we create a directory for our Magento 2 installation and enter into it.  
  
 
  cd /usr/local/lsws/Example/html
 
  cd /usr/local/lsws/Example/html
Line 155: Line 158:
 
Using Composer, we will now get the most recent Magento 2 package.
 
Using Composer, we will now get the most recent Magento 2 package.
  
<code>composer create-project --repository-url=https://repo.magento.com/ magento/project-community-edition .</code>  
+
<code><nowiki>composer create-project --repository-url=https://repo.magento.com/ magento/project-community-edition .</nowiki></code>  
  
  
You will then be prompted to enter your username and password for repo.magento.com.
+
You will then be prompted to enter a username and password for repo.magento.com using your Magento authentication keys.
  
 
     Authentication required (repo.magento.com):
 
     Authentication required (repo.magento.com):
Line 164: Line 167:
 
       password:
 
       password:
  
If you have not done so already, [http://devdocs.magento.com/guides/v2.0/install-gde/prereq/connect-auth.html Request An Account].
+
If you have not done so already, [http://devdocs.magento.com/guides/v2.0/install-gde/prereq/connect-auth.html Get your authentication keys].
  
 
=== Change Ownership Of All Files In The Magento Directory ===
 
=== Change Ownership Of All Files In The Magento Directory ===
In order for the web server to have write permissions during installation, ownership of the uncompressed Magento Files must be changed to the "nobody" user. Using the "Example" virtual host as an example, do so with the following command:   
+
In order for the web server to have write permissions during installation, ownership of the uncompressed Magento Files must be changed to the "nobody" user. Using the default "Example" virtual host, do so with the following command:   
  
 
<code>chown -R nobody /usr/local/lsws/Example/html/magento2</code>
 
<code>chown -R nobody /usr/local/lsws/Example/html/magento2</code>
  
 
=== Add The Required Rewrite Rules To Your Virtual Host Settings ===
 
=== Add The Required Rewrite Rules To Your Virtual Host Settings ===
 +
Using the default "Example" virtual host:
 +
 
# In the  WebAdmin Console, navigate to '''Virtual Hosts > Example > Rewrite'''.
 
# In the  WebAdmin Console, navigate to '''Virtual Hosts > Example > Rewrite'''.
 
# Set '''Enable Rewrite''' to '''Yes'''.
 
# Set '''Enable Rewrite''' to '''Yes'''.
 
# Add the following to the '''Rewrite Rules''' setting:
 
# Add the following to the '''Rewrite Rules''' setting:
  
     Options +FollowSymLinks
+
     RewriteRule ^/magento2/pub/static/version.+?/(.+)$ /magento2/pub/static/$1 [L]
     RewriteEngine on
+
     RewriteCond %{REQUEST_FILENAME} !-f
     RewriteBase /magento2/
+
     RewriteCond %{REQUEST_FILENAME} !-l
 +
    RewriteRule /magento2/pub/static/.* /magento2/pub/static.php?resource=$0 [L]
 +
 
 
     RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
 
     RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
 
     RewriteCond %{REQUEST_METHOD} ^TRAC[EK]
 
     RewriteCond %{REQUEST_METHOD} ^TRAC[EK]
Line 198: Line 205:
  
 
=== Fix css Loading Issue For Magento 2 Frontend/Backend ===
 
=== Fix css Loading Issue For Magento 2 Frontend/Backend ===
The last step is to fix a css loading issue present in new Magento 2 installations. Using the "Example" virtual host and assuming your Magento 2 installation is located under the <code>/magento2</code> subdirectory, we can do this with the following set of commands:
+
The last step is to fix a css loading issue present in new Magento 2 installations. Using the default "Example" virtual host and assuming your Magento 2 installation is located under the <code>/magento2</code> subdirectory, we can do this with the following set of commands:
  
 
  cd /usr/local/lsws/Example/html/magento2/
 
  cd /usr/local/lsws/Example/html/magento2/
Line 205: Line 212:
 
  rm -rf var/cache/*
 
  rm -rf var/cache/*
 
  chown -R nobody:nobody .
 
  chown -R nobody:nobody .
 
[[Category:Help]]
 

Latest revision as of 16:10, 14 December 2017

After downloading and installing OpenLiteSpeed, follow the instructions below to get your Magento site working. The installation process for Magento 1.x and Magento 2.0 are slightly different, so please ensure that you are following that steps for the the version you wish to install.


Install PHP Modules

The easiest way to install PHP for OpenLiteSpeed is through our CentOS repository. If the LiteSpeed Repository was not already installed and enabled during web server installation, follow this guide to do so.

Use the following command to install PHP with the required modules:

yum install lsphp56 lsphp56-common lsphp56-gd lsphp56-process lsphp56-mbstring lsphp56-mysql lsphp56-mcrypt lsphp56-pdo lsphp56-xml lsphp56-intl
Note: There are different versions of LSPHP (lsphp53, lsphp54, lsphp55, lsphp56, lsphp70, lsphp71) available. Please check your Magento version for PHP requirements.


Direct LSWS to the location of the installed PHP binary. (In this example, PHP 5.6 is installed by default in /usr/local/lsws/lsphp56/bin/lsphp. In the WebAdmin Console, change the value of the External App > your_external_application > Command setting to reflect the PHP version you are using.)

If you are not using RedHat or CentOS, or you prefer to build PHP manually, see our instructions on Building PHP for Magento.

Magento 2: You will need to set the value of "always_populate_raw_post_data" to -1 in the related php.ini file. In this example, this file would be /usr/local/lsws/lsphp56/etc/php.ini. You should also make any memory configuration changes here if your version of Magento requires it.

For Example:

   memory_limit = 768M
   max_execution_time = 18000
   session.auto_start = 0

Set Up Magento On A Vhost

Using the default "Example" virtual host:

  1. In the WebAdmin Console, navigate to Configuration > Virtual Hosts > Example > General > Index Files.
  2. Add "index.php".

Set up a MySQL database for Magento

Start by installing MySQL:

yum install mysql mysql-server

Magento 2: You will need mysql 5.6 or later. More information on installing MySQL 5.6 from a repo


Next start MySQL, log into your MySQL server, and create a Magento database instance.

service mysql start

mysql -u root -p

#Enter the following commands while logged in to MySQL.

mysql>create database magento;
mysql>GRANT ALL ON magento.* TO 'magento'@'localhost' IDENTIFIED BY 'magento';
mysql>flush privileges;

http://devdocs.magento.com/guides/m1x/install/installing_install.html#install-create-db

Magento 1 Installation

Download Magento 1

  1. Register or log in to Magento.com.
  2. Download Magento from their release archive.
  3. copy/ftp the downloaded files into your server's document root. Magento should be put in a subdirectory of the virtual host. For example, /usr/local/lsws/Example/html/magento. (This puts all the files in the right directory for running Magento on the default "Example" virtual host.)
  4. Using Magento 1.9.3.1 as an example, uncompress the downloaded files with the following command: tar -zxvf magento-1.9.3.1.tar.gz

Change Ownership Of All Files In The Magento Directory

In order for the web server to have write permissions during installation, ownership of the uncompressed Magento Files must be changed to the "nobody" user. Using the default "Example" virtual host, do so with the following command:

chown -R nobody /usr/local/lsws/Example/html/magento

Add The Required Rewrite Rules To Your Virtual Host Settings

Using the default "Example" virtual host:

  1. In the WebAdmin Console, navigate to Virtual Hosts > Example > Rewrite.
  2. Set Enable Rewrite to Yes.
  3. Add the following to the Rewrite Rules setting:
============>8============
    RewriteBase /magento

############################################
## Uncomment out the next line to enable light API calls processing

#    RewriteRule ^/api/([a-z][0-9a-z_]+)/?$ api.php?type=$1 [QSA,L]

############################################
## Rewrite API2 calls to api.php (by now it is REST only)

    RewriteRule ^/api/rest api.php?type=rest [QSA,L]

############################################
## Workaround for HTTP authorization in the CGI environment

    RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]

############################################
## TRACE and TRACK HTTP methods disabled to prevent XSS attacks

    RewriteCond %{REQUEST_METHOD} ^TRAC[EK]
    RewriteRule .* - [L,R=405]

############################################
## Redirect for mobile user agents

    #RewriteCond %{REQUEST_URI} !^/mobiledirectoryhere/.*$
    #RewriteCond %{HTTP_USER_AGENT} "android|blackberry|ipad|iphone|ipod|iemobile|opera mobile|palmos|webos|googlebot-mobile" [NC]
    #RewriteRule ^(.*)$ /mobiledirectoryhere/ [L,R=302]

############################################
## Always send 404 for missing files in these folders

    RewriteCond %{REQUEST_URI} !^/magento/(media|skin|js)/

############################################
## Never rewrite for existing files, directories, and links

    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteCond %{REQUEST_FILENAME} !-l

############################################
## Rewrite everything else to index.php

    RewriteRule .* /magento/index.php [L]

============>8============

IMPORTANT : These rules are written for installations located in subdirectory "magento". If your Magento installation is located in the server docroot instead of the suggested /magento subdirectory, remove "magento" from the rewrite rules containing it. For example, RewriteBase /magento would become RewriteBase /, and RewriteRule .* /magento/index.php [L] would become RewriteRule .* /index.php [L].

Note: These rewrite rules are taken directly from Magento's official site. Any questions regarding these rules would be best directed to the Official Magento Forums.

Perform A Graceful Restart

To make the previous server changes take affect, we must perform a graceful restart. In the WebAdmin Console, navigate to Actions > Graceful Restart.

Run The Magento Setup Wizard

In your browser, visit http://your_server_ip:8088/magento and follow the instructions.

Magento 2 Installation

The following instruction will walk you through installing a basic Magento 2 site on OpenLiteSpeed. If you would like more in depth information on installing and configuring Magento 2, please refer to the Official Magento 2 Installation Guide.

The following commands should be run as the root user.

Install Composer

Install composer with the following command:

yum install composer

Add The Correct PHP Path To The $Path Environment Variable

By default, Composer will check for PHP at system default location - usually /usr/bin/php. This can sometimes cause Composer's version checking to fail. To avoid this, we will add our PHP installation directory the $PATH environment variable. Using LSPHP-56 as an example, run the following command:

export PATH="/usr/local/lsws/lsphp56/bin/:$PATH"

Choose An Installation Directory For Magento 2

Using the default "Example" virtual host, we create a directory for our Magento 2 installation and enter into it.

cd /usr/local/lsws/Example/html
mkdir magento2
cd magento2

Get The Magento Software

Using Composer, we will now get the most recent Magento 2 package.

composer create-project --repository-url=https://repo.magento.com/ magento/project-community-edition .


You will then be prompted to enter a username and password for repo.magento.com using your Magento authentication keys.

   Authentication required (repo.magento.com):
     Username:
     password:

If you have not done so already, Get your authentication keys.

Change Ownership Of All Files In The Magento Directory

In order for the web server to have write permissions during installation, ownership of the uncompressed Magento Files must be changed to the "nobody" user. Using the default "Example" virtual host, do so with the following command:

chown -R nobody /usr/local/lsws/Example/html/magento2

Add The Required Rewrite Rules To Your Virtual Host Settings

Using the default "Example" virtual host:

  1. In the WebAdmin Console, navigate to Virtual Hosts > Example > Rewrite.
  2. Set Enable Rewrite to Yes.
  3. Add the following to the Rewrite Rules setting:
   RewriteRule ^/magento2/pub/static/version.+?/(.+)$ /magento2/pub/static/$1 [L]
   RewriteCond %{REQUEST_FILENAME} !-f
   RewriteCond %{REQUEST_FILENAME} !-l
   RewriteRule /magento2/pub/static/.* /magento2/pub/static.php?resource=$0 [L]
   RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
   RewriteCond %{REQUEST_METHOD} ^TRAC[EK]
   RewriteRule .* - [L,R=405]
   RewriteCond %{REQUEST_FILENAME} !-f
   RewriteCond %{REQUEST_FILENAME} !-d
   RewriteCond %{REQUEST_FILENAME} !-l
   RewriteRule .* /magento2/index.php [L] 

IMPORTANT : These rules are written for installations located in subdirectory "magento2". If your Magento installation is located in the server docroot instead of the suggested /magento2 subdirectory, remove "magento2" from the rewrite rules containing it. For example, RewriteBase /magento2/ would become RewriteBase /, and RewriteRule .* /magento2/index.php [L] would become RewriteRule .* /index.php [L].

Note: These rewrite rules are taken directly from Magento's official site. Any questions regarding these rules would be best directed to the Official Magento Forums.

Perform A Graceful Restart

To make the previous server changes take affect, we must perform a graceful restart. In the WebAdmin Console, navigate to Actions > Graceful Restart.

Run The Magento Setup Wizard

In your browser, visit http://your_server_ip:8088/magento and follow the instructions.

Fix css Loading Issue For Magento 2 Frontend/Backend

The last step is to fix a css loading issue present in new Magento 2 installations. Using the default "Example" virtual host and assuming your Magento 2 installation is located under the /magento2 subdirectory, we can do this with the following set of commands:

cd /usr/local/lsws/Example/html/magento2/
php bin/magento setup:static-content:deploy
php bin/magento indexer:reindex
rm -rf var/cache/*
chown -R nobody:nobody .