Installation¶

Before installing and activating the LSCache plugin, deactivate all other full-page cache plugins.

Prerequisites¶

PHP Prerequisites¶

If you are using a control panel, simply choose the appropriate PHP version in the panel.

If you are using LiteSpeed Web Server Native Mode, execute the following steps from the command line:

php -v

This command returns the PHP version used by the command line interface. This version may be different than the one used by LiteSpeed. If the version number does not match the version used by LiteSpeed, you run the risk of compatibility issues.

which php

This command returns the location of the command line PHP binary, probably /usr/local/bin/php. Enter the returned directory (if the which command did't return anything, we recommend trying /usr/local/bin/ or /usr/bin/), like so:

cd /usr/local/bin

Change the current PHP binary name to something different as a backup using the mv command and create a symbolic link to the LiteSpeed PHP binary (or copy the binary itself into the current directory).

mv /usr/bin/php /usr/bin/php-orig
ln -s /usr/local/lsws/lsphp70/bin/php /usr/bin/php

If the steps were done correctly, running the php -v command should now return a version number matching LiteSpeed's PHP version.

Extension Installation¶

Assuming that the Prerequisites mentioned above have been met, you are ready to begin installation.

Log In¶

Access a terminal as the Magento directory owner (e.g. user1) and cd into the Magento 2 root directory. If logged in as root, run the su user1 command first to become the Magento directory owner.

Set Deploy Mode¶

If the current deploy mode is set to default, you can install LiteMage 2 without changing it. If the current deploy mode is set to production, you will have to set the deploy mode to developer before installation, and change it back to production once installation is complete, like so:

php bin/magento deploy:mode:set developer

Get LiteMage Package¶

There are two ways to get the LiteMage 2 package: composer and direct download.

Composer¶

Use composer to get the latest LiteMage 2 package, like so:

composer require litespeed/module-litemage

To get a specific version, add the version number. For example:

composer require litespeed/module-litemage:2.0.4

This will download the LiteMage 2 package from packagist.org, and install it into the vendor/litespeed directory.

You will need to provide your username(public key) and password(private key) authentication for repo.magento.com. If you have not done so already, Get your authentication keys.

Direct Download¶

Download the package file from GitHub, and unzip the source package, like so:

unzip magento2-LiteSpeed_LiteMage-master.zip

In the Magento 2 root directory, create the required LiteMage directory with the following command:

mkdir -p app/code/Litespeed/Litemage

Move the previously downloaded files into the newly created LiteMage directory, like so:

mv /path/to/magento2-LiteSpeed_LiteMage-master/* app/code/Litespeed/Litemage/

Confirm File Ownership¶

Confirm that the owner of the files is consistent with the other Magento store files.

Enable LiteMage¶

Enable LiteMage 2 in Magento with the following command:

php bin/magento module:enable Litespeed_Litemage

Upgrade Magento's Setup¶

Upgrade Magento's setup, like so:

php bin/magento setup:upgrade

Recompile¶

Recompile using the single-tenant or multi-tenant compiler. The single-tenant compiler has some known issues in earlier versions of Magento. If you are running Magento 2.0.6 or later AND have one Magento store, please use the following command:

php bin/magento setup:di:compile

If you are running Magento 2.0.5 or earlier, please use this command instead:

php bin/magento setup:di:compile-multi-tenant

Reset Deploy Mode¶

If desired, You may now switch your deploy mode back to production with the following command:

php bin/magento deploy:mode:set production

Enable LiteMage¶

1. Add the following lines to the top of your Magento 2 root directory .htaccess file:

   <IfModule LiteSpeed>
   LiteMage on
   </IfModule>
   

2. Log into the Magento admin page.
3. In Store > Configuration > Advanced > System, make sure LiteMage is enabled and selected under the Full Page Cache setting.
4. In System > Cache Management, refresh the Configuration and Page Cache cache types. Page Cache should be enabled. If it isn't, then LiteMage cannot work and LiteMage Cache Management statistics won't show up.

<Directory /path/to/your/magento_store_installation>
  AllowOverride All
</Directory>

Update LiteMage¶

The steps involved in updating LiteMage 2 to a newer version in the future, should be almost identical to the steps performed during installation. The only difference occurs when downloading a new package. At this point, if you installed LiteMage 2 using the GitHub method, you must remove the old package files and download the new package files through GitHub. (Composer update steps are identical to installation)

Verify Your Site is Being Cached¶

You can verify a page is being served from LiteMage Cache through the following steps:

1. From a non-logged-in browser, open the developer tools and navigate to your site. Open the Network tab.
2. Refresh the page.
3. Click the first resource. This should be an HTML file. For example, if your page is http://example.com/magento/, your first resource should either be something like example.com/magento/ or magento/.
4. If you see headings similar to

   X-LiteSpeed-Cache: miss, litemage
   X-LiteSpeed-Cache-Control:public,max-age=1800
   X-LiteSpeed-Tag:B1_F,B1_ 
   

   (for example), this means the page had not yet been cached, but that LiteSpeed has now stored it for future use.
5. Reload the page and you should see X-LiteSpeed-Cache: hit, litemage in the response header. This means the page is being served by LSCache and is configured correctly.
6. If you don't see X-LiteSpeed-Cache: hit, litemage or X-LiteSpeed-Cache: miss, litemage, then there is a problem with the LSCache configuration.