Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
Next revision Both sides next revision
litespeed_wiki:cpanel:whm-plugin-lscwp-management [2018/05/11 19:10]
Eric Leu [Cache Root Setup]
litespeed_wiki:cpanel:whm-plugin-lscwp-management [2018/05/29 18:39]
Eric Leu
Line 1: Line 1:
 ====== WHM Plugin - LiteSpeed Cache For WordPress Management ====== ====== WHM Plugin - LiteSpeed Cache For WordPress Management ======
 The LiteSpeed WHM plugin contains a section for managing LiteSpeed Cache for WordPress. ​ This wiki entry will guide you through the different operations and management actions you can take when using our plugin. The LiteSpeed WHM plugin contains a section for managing LiteSpeed Cache for WordPress. ​ This wiki entry will guide you through the different operations and management actions you can take when using our plugin.
-{{:​litespeed_wiki:​cpanel:​whm3-1.png?​|}} ​\\ +{{:​litespeed_wiki:​cpanel:​whm-31.png?800|}} 
-{{:​litespeed_wiki:​cpanel:​whm3-2.png?​|}} \\+
 If you do not see the **LiteSpeed Cache For WordPress Management** section on your LiteSpeed WHM plugin screen, please upgrade LiteSpeed Web Server to 5.1.x at the minimum. If you do not see the **LiteSpeed Cache For WordPress Management** section on your LiteSpeed WHM plugin screen, please upgrade LiteSpeed Web Server to 5.1.x at the minimum.
  
 You must have a license with LSCache enabled to use these features. **[[litespeed_wiki:​licenses:​add-lscache|How To Get LSCache]]** You must have a license with LSCache enabled to use these features. **[[litespeed_wiki:​licenses:​add-lscache|How To Get LSCache]]**
- 
-===== Getting Started ===== 
-**Cache Root Setup** is a one-time action, and is actually the //first thing you need to do// before you can try any of the other options. Once the cache root has been set up for the first time, there will be no need to do it again, and you will be free to use the other options at will. 
- 
-{{:​litespeed_wiki:​cpanel:​whm3-4.png?​|}} \\ 
-From the initial plugin screen you should be presented with 3 different options under the **LiteSpeed Cache For WordPress Management** section. \\ 
-{{:​litespeed_wiki:​cpanel:​whm3-3.png?​|}}\\ 
- 
-  * **Manage Cache Installations** allows you to manage LiteSpeed Cache for WordPress on your individual WordPress installations. 
-  * **Mass Enable Cache** & **Mass Disable Cache** can be used to enable/​disable LiteSpeed Cache for WordPress on all discovered WordPress installations which are not flagged (more on flags later). 
-  * **LSCWP Version Manager** displays the currently active LSCache for WordPress version (more on the Active Version later). It also allows you to adjust this active LSCache for WordPress version and to upgrade and downgrade LSCache for WordPress installations based on their current version. 
  
 ===== Cache Root Setup ===== ===== Cache Root Setup =====
-{{:​litespeed_wiki:​cpanel:​whm3-5.png?|}}+Click **WHM Plugin > LiteSpeed Configuration > Cache Root Setup** 
 +{{:​litespeed_wiki:​cpanel:​whm-33.png?800|}}
  
-This screen searches for Server level cache root definitions in either the ''/​usr/​local/​apache/​conf/​includes/​pre_main_global.conf''​ file or in the LiteSpeed Web Server Web Admin under ''​Server > Cache > Cache Storage Settings > Storage Path'' ​setting.+This screen searches for Server level cache root definitions in either the ''/​usr/​local/​apache/​conf/​includes/​pre_main_global.conf''​ file or in the LiteSpeed Web Server Web Admin under **Server > Cache > Cache Storage Settings > Storage Path** setting. ​\\ 
 +{{:​litespeed_wiki:​cpanel:​whm-34.png?​800|}}
  
 If it is defined in ''​pre_main_global.conf''​ it should look something like this: If it is defined in ''​pre_main_global.conf''​ it should look something like this:
Line 41: Line 32:
 Where ''​lscache''​ is the CacheRoot path. In this case, the VHost level cache root will be set to ''/​home/<​user_folder>/​lscache''​ Where ''​lscache''​ is the CacheRoot path. In this case, the VHost level cache root will be set to ''/​home/<​user_folder>/​lscache''​
  
-{{:​litespeed_wiki:​cpanel:​whm3-6.png?|}}+{{:​litespeed_wiki:​cpanel:​whm-35.png?800|}}
  
-**Set Missing Cache Roots** ​- Sets Server level and VHost level Cache Root definitions if they are detected as not set.+The **Set Missing Cache Roots** ​button sets Server level and VHost level Cache Root definitions if they are detected as not set.
  
 //**Note:** The Set Missing Cache Roots button will only appear if at least one of the two cache roots (Sever level and VHost level) is detected as not set.// //**Note:** The Set Missing Cache Roots button will only appear if at least one of the two cache roots (Sever level and VHost level) is detected as not set.//
 +
 +
 +===== Getting Started =====
 +
 +
 +From the initial plugin screen you should be presented with 3 different options under the **LiteSpeed Cache For WordPress Management** section.
 +
 +{{:​litespeed_wiki:​cpanel:​whm-32.png?​800|}}
 +
 +  * **Manage Cache Installations** allows you to manage LiteSpeed Cache for WordPress on your individual WordPress installations.
 +  * **Mass Enable Cache** & **Mass Disable Cache** can be used to enable/​disable LiteSpeed Cache for WordPress on all discovered WordPress installations which are not flagged (more on flags later).
 +  * **Version Manager** displays the currently active LSCache for WordPress version (more on the Active Version later). It also allows you to adjust this active LSCache for WordPress version and to upgrade and downgrade LSCache for WordPress installations based on their current version.
  
 ===== Manage Cache Installations ===== ===== Manage Cache Installations =====
 The manage view is where most of the magic happens. ​ Here you can manage LiteSpeed Cache for WordPress for your WordPress installations individually or in small groups. (There is nothing wrong with big groups, but that is what **Mass Enable Cache** and **Mass Disable Cache** are for) The manage view is where most of the magic happens. ​ Here you can manage LiteSpeed Cache for WordPress for your WordPress installations individually or in small groups. (There is nothing wrong with big groups, but that is what **Mass Enable Cache** and **Mass Disable Cache** are for)
  
-{{:​litespeed_wiki:​cpanel:​whm_manage.png?nolink|}}+The first time, a user may see only a **Scan** button available \\ 
 +{{:​litespeed_wiki:​cpanel:​whm-37.png?800|}} \\ 
 +After a scan and cache is enabled, it will look like this \\ 
 +{{:​litespeed_wiki:​cpanel:​whm-36.png?​800|}} \\
  
 Starting from the actual table we have the following fields: Starting from the actual table we have the following fields:
  
   * **Discovered WordPress Installations -**  This field will contain the path of each WordPress installation discovered during the last scan operation.   * **Discovered WordPress Installations -**  This field will contain the path of each WordPress installation discovered during the last scan operation.
 +
 +  * **Actions -** This field contains action buttons that perform a specific action only for the related WordPress installation. These actions include Enable/​Disable LiteSpeed Cache for WordPress, and Refresh Status which updates the current status of LiteSpeed Cache for WordPress for this installation only.
  
   * **Cache Status -** Displays the last known status of LiteSpeed Cache for WordPress for the listed WordPress installation.   * **Cache Status -** Displays the last known status of LiteSpeed Cache for WordPress for the listed WordPress installation.
  
-  * **Flag -** This field can either be blank or display a flag icon. While an installation is flagged, displaying the flag icon, it will be excluded from all future Mass Enable/​Disable operations+  * **Flag -** Click to set Flag/​Unflag. ​This field can either be blank or display a flag icon. While an installation is flagged, displaying the flag icon, it will be excluded from all future Mass Enable/​Disable operations. ​
- +
-  * **Actions -** This field contains action buttons that perform a specific action only for the related WordPress installation. These actions include Enable/​Disable LiteSpeed Cache for WordPress, Flag/Unflag this installation,​ and Refresh Status which updates the current status of LiteSpeed Cache for WordPress for this installation only.+
  
 Looking at the top row of buttons, we have **Scan/​Re-scan**,​ **Discover New**, and **Refresh Status**. Looking at the top row of buttons, we have **Scan/​Re-scan**,​ **Discover New**, and **Refresh Status**.
Line 79: Line 85:
  
 ===== Mass Enable Cache & Mass Disable Cache =====  ===== Mass Enable Cache & Mass Disable Cache ===== 
-{{:​litespeed_wiki:​cpanel:​screen_shot_2016-09-29_at_10.03.55_am.png?nolink|}}+{{:​litespeed_wiki:​cpanel:​whm-38.png?700|}}
  
 Both of these selections behave in a very similar way by allowing you to enable/​disable LiteSpeed Cache for WordPress en masse. Both of these selections behave in a very similar way by allowing you to enable/​disable LiteSpeed Cache for WordPress en masse.
Line 85: Line 91:
 When Mass Enabling/​Disabling LiteSpeed Cache for WordPress, all WordPress installations that are not currently flagged in the Manage screen will have LiteSpeed Cache for WordPress installed/​removed. If a WordPress installation is detected as manually disabled, the WHM plugin will flag it and skip it. During this operation, you should see the following output screen. When Mass Enabling/​Disabling LiteSpeed Cache for WordPress, all WordPress installations that are not currently flagged in the Manage screen will have LiteSpeed Cache for WordPress installed/​removed. If a WordPress installation is detected as manually disabled, the WHM plugin will flag it and skip it. During this operation, you should see the following output screen.
  
-{{:​litespeed_wiki:​cpanel:​screen_shot_2016-09-29_at_10.08.54_am.png?nolink|}}+{{:​litespeed_wiki:​cpanel:​whm-39.png?700|}}
  
 After this operation is complete you will get a short summary message letting you know how many installations had LiteSpeed Cache for WordPress enabled/​disabled successfully and how many failed, as well as how many flagged installations were detected and skipped over. You will also be provided with both an error log and a success log shown under these results listing the installations that were enabled and those that failed along with the related error messages. After this operation is complete you will get a short summary message letting you know how many installations had LiteSpeed Cache for WordPress enabled/​disabled successfully and how many failed, as well as how many flagged installations were detected and skipped over. You will also be provided with both an error log and a success log shown under these results listing the installations that were enabled and those that failed along with the related error messages.
- 
-{{:​litespeed_wiki:​cpanel:​screen_shot_2016-09-29_at_10.27.49_am.png?​nolink|}} 
  
 **Note:** If you have not performed a scan before clicking on Mass Enable/​Disable Cache buttons, or your previous scan data is unable to be read by the plugin, you will be asked to scan again. **Note:** If you have not performed a scan before clicking on Mass Enable/​Disable Cache buttons, or your previous scan data is unable to be read by the plugin, you will be asked to scan again.
  
 ===== Version Manager ===== ===== Version Manager =====
-{{:​litespeed_wiki:​cpanel:​screen_shot_2016-08-16_at_10.12.07_am.png?nolink|}}+{{:​litespeed_wiki:​cpanel:​whm-40.png?800|}}
  
   * **Set Active Version -** Allows you to change the Active Version of the LiteSpeed Cache for WordPress plugin. The Active Version is the LSCache for WordPress version that is used when the WHM plugin enables or mass enables caching for WordPress installations.   * **Set Active Version -** Allows you to change the Active Version of the LiteSpeed Cache for WordPress plugin. The Active Version is the LSCache for WordPress version that is used when the WHM plugin enables or mass enables caching for WordPress installations.
Line 165: Line 169:
  
 ===== Testing ===== ===== Testing =====
-Test your domains, you should see X-LiteSpeed-Cache:​ hit” in the response header. Check [[litespeed_wiki:​cache:​lscwp:​installation#​testing|here]] for detailed verification steps. ​+To test your domains, you should see ''​X-LiteSpeed-Cache:​ hit'' ​in the response header. Check [[litespeed_wiki:​cache:​lscwp:​installation#​testing|here]] for detailed verification steps. ​
  
-If X-LiteSpeed-Cache:​ hit” can not be seen, you may need to do more troubleshooting, for example: check if LScache feature has been enabled in your license, if other cache plugins have been disabled, or if cache root and cache policy have been set, etc.  ​+If ''​X-LiteSpeed-Cache:​ hit''​ cannot ​be seen, you may need to do more troubleshooting. For example: check if the LScache feature has been enabled in your license, if other cache plugins have been disabled, or if cache root and cache policy have been set, etc.  ​
  • Admin
  • Last modified: 2019/04/24 18:04
  • by Michael Alegre