Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
litespeed_wiki:cache:lscps:installation [2017/10/03 18:14] Lauren Song [Installation] |
litespeed_wiki:cache:lscps:installation [2020/01/21 15:27] Jackson Zhang [Installation] |
||
---|---|---|---|
Line 4: | Line 4: | ||
===== Pre-Installation Requirements ===== | ===== Pre-Installation Requirements ===== | ||
- | * LiteSpeed Web Server Enterprise Edition 5.0.10+. | + | * LiteSpeed Web Server Enterprise Edition 5.2.1 Build 7 or higher. |
- | * LSCache Module. (Included with a 2-CPU or higher license. Can be purchased as an add-on for VPS, Ultra VPS, and 1-CPU licenses.) | + | * LSCache Module. (Included with all current licenses and the 8-CPU legacy license. Can be purchased as an add-on for VPS, Ultra VPS, and 1-CPU licenses.) |
===== Installation ===== | ===== Installation ===== | ||
- | - Configure server- and/or virtual-host-level cache root and cache policy by selecting your setup in the Web Server Configuration section of the **[[litespeed_wiki:cache:common_installation#web_server_configuration|LiteSpeed Web Cache Common Installation Guide]]**. | + | - Configure server- and/or virtual-host-level cache root and cache policy by selecting your setup in the Web Server Configuration section of the [[litespeed_wiki:cache:common_installation#web_server_configuration|LiteSpeed Web Cache Common Installation Guide]]. |
- Disable any other page caches as these will interfere with LSCPS. | - Disable any other page caches as these will interfere with LSCPS. | ||
- | - [[https://www.litespeedtech.com/packages/prestashop/litespeedcache-1.1.0.zip|Download the LSCPS plugin]]. | + | - [[https://www.litespeedtech.com/products/cache-plugins/prestashop-acceleration/download|Download the LSCPS plugin]]. |
- | - Log in to your PrestaShop Admin, navigate to **Modules > Modules & Services**, and click on **Upload a Module**. | + | - Log in to your PrestaShop Admin |
+ | - Set **Advanced Parameters > Performance> Debug mode > Disable all overrides** to ''NO''. This is required to ensure proper functioning of the ESI hole-punching feature. | ||
+ | - Navigate to **Modules > Modules & Services**, and click on **Upload a Module**. | ||
- Select the LSCPS zip file. | - Select the LSCPS zip file. | ||
- Enable the module by navigating to **LiteSpeed Cache > Settings** and setting **Enable LiteSpeed Cache** to ''Yes''. | - Enable the module by navigating to **LiteSpeed Cache > Settings** and setting **Enable LiteSpeed Cache** to ''Yes''. | ||
+ | ==== Fixing an Error ==== | ||
+ | If you see the following error message, ''Directory /home/example/example.com/app/logs is not writable'', you can fix it like so: | ||
+ | |||
+ | touch /home/example/example.com/app/logs | ||
+ | chown example:example /home/example/example.com/app/logs | ||
+ | | ||
+ | Then, upload and install the module again. | ||
===== .htaccess Update ===== | ===== .htaccess Update ===== | ||
+ | |||
+ | When you enable or disable LiteSpeed Cache from the plugin, ''.htaccess'' file should be automatically updated. If the update failed, most time due to file permission, you can update it manually. | ||
At the top of your ''.htaccess'' file, located in the document root of your PrestaShop installation, add the following: | At the top of your ''.htaccess'' file, located in the document root of your PrestaShop installation, add the following: | ||
<code> | <code> | ||
- | ## LITESPEED CACHE PLUGIN ## | + | # LITESPEED_CACHE_START Do not remove this comment line, LiteSpeedCache plugin will automatically update this block |
<IfModule LiteSpeed> | <IfModule LiteSpeed> | ||
CacheLookup on | CacheLookup on | ||
</IfModule> | </IfModule> | ||
- | + | # LITESPEED_CACHE_END | |
- | ## LITESPEED CACHE PLUGIN ## | + | |
</code> | </code> |