How to integrate LiteMage into Magento v1

Knowledgebase Article

How to integrate LiteMage into Magento v1

LiteMage Cache is the world's fastest full page cache for Magento.

Built on top of LSCache and designed specifically for Magento, LiteMage can assemble both public and private blocks from cache by hole-punching through ESI to deliver the fastest full-page caching around.

IMPORTANT: The LiteMage extension for Magento needs to be installed for each Magento installation. Varnish cache, Redis and other full page caches must also be disabled ( including Magento built in full page cache ).

LiteMage is really easy to setup.

For each Magento Store, you will need to:

1) Enable the LiteMage Module

2) Install the LiteMage extension for Magento

3) Change the LiteMage extension's configuration to enable LiteMage

Let's start with:

Step 1) Enable the LiteMage Module -

Add the code below to the .htaccess file under the root directory of each Magento installation:

<IfModule Litespeed>
LiteMage on
</IfModule>

Step 2) - installing the LiteMage extension.

2.1) Log into the Magento Admin Panel. Navigate to System >> Configuration >> GENERAL(in the left side menu) >> Web >> Session Validation Settings >> set Use SID on Frontend to “No”.

If you currently have compilation enabled, please disable it by navigating to System >> Tools >> Compilation and clicking “Disable” at the top right:

2-2) Download the LiteMage Extension For Magento here: http://www.litespeedtech.com/products/cache-plugins/magento-acceleration/download#download

2-3) Go to: System >> Magento Connect >> Magento Connect Manager:

Enter your admin login details, then click on: Direct package file upload >> Choose File >> point your browser to the recently downloaded in step 1-2) LiteMage Extension For Magento >> click on Upload:

Step 3) Go to System >> Configuration and in the left side menu under “LITEMAGE CACHE”, click “LiteMage Configuration”, then click on General Settings and enable LiteMage Cache:

Please note: If you get a 404 error accessing the LiteMage Configuration, please log out and back into the admin panel.

You can run LiteMage extension for Magento in developement mode, enabling it just for specific set of IPs.

That's under the Developer Testing section, where you can enable LiteMage Cache only for the listed IPs:

To turn off LiteMage, set Enable LiteMage Cache to “No” and refresh the configuration cache.

Testing!

We suggest testing LiteMage in a pre-production environment.

If you have to test LiteMage on a live site, be sure to use Enable LiteMage Cache Only for Listed IPs.

This setting specifies certain IPs that will test caching while other IPs are served normally.

Use your browser's developer tool to check the response header for the HTML file.

This can usually be done by right clicking on the page and selecting some form of “Inspect”.

Then click on the “Network” tab in the inspector and reload the page.

If you see “X-LiteSpeed-Cache: hit,litemage” in the response header for the HTML file(usually listed first), then the page is being served by LiteMage Cache.

You should see “X-Litespeed-Cache:miss” for the first time visit page, then if you refresh the page, you should see “X-LiteSpeed-Cache: hit,litemage”.

If this is not the case, please verify if there is any step missed from above, or try this wiki for troubleshooting steps.

You can setup cache warmup to warmup your litmage to ensure visitors' browsing served from cache instead of backend php and avoid “X-Litespeed-Cache:miss”:

The default configuration for the LiteMage extension should work with most Magento installations out-of-box.

Related article: LiteMage Cache Warm Up in Magento v1

If you need any additional support or help installing and configuring LiteMage for your Magento store, please do not hesitate to contact us.