Differences

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

--- litespeed_wiki:cache:litemage:troubleshooting:debug [2015/10/28 14:20]
Michael Alegre [Enable certain IPs for testing/troubleshooting purposes]
+++ litespeed_wiki:cache:litemage:troubleshooting:debug [2016/05/06 15:12] (current)
Long Hu [Debugging LiteMage Cache]
@@ Line 1: / Line 1: @@
 ====== Debugging LiteMage Cache ======
+It is recommended to first deploy LiteMage Cache on a non-production environment for testing/debugging before deploying it on your production site. If you have to test LiteMage on your live site, you can [[#enable_litemage_for_only_certain_ips_for_testing_troubleshooting_purposes|enable LiteMage for only a few IPs during testing]]. Please disable all other full page caches as they will likely conflict with LiteMage.
-====  How to check if a page is served from LiteMage Cache ====
+=====  How to check if a page is served from LiteMage Cache =====
 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.
-==== How to enable the LiteMage log file ====
+===== How to enable the debug log =====
   - From the Magento Admin Panel: Navigate to System → Configuration and under "Advanced" in the left side menu, click "Developer". Under "Log Settings" set "Enabled" to "Yes". Make sure it is enabled within the store's scope as well.
   - From the Magento Admin Panel: Navigate to System → Configuration and under "LITEMAGE CACHE" in the left side menu, click "LiteMage Configuration". Under "Developer Testing" set "Enable Debug" to "Yes".
@@ Line 11: / Line 12: @@
 system.log will now be generated in magento_installation_directory/var/log.
-==== Enable LiteMage for only certain IPs for testing/troubleshooting purposes ====
+===== Enable LiteMage for only certain IPs for testing/troubleshooting purposes =====
 It is recommended to enable LiteMage Cache for only certain IPs when troubleshooting. To do this, from the Magento Admin Panel, navigate to System -> Configuration and in the left side menu under "LITEMAGE CACHE" click "LiteMage Configuration". Under "Developer Testing" add the desired IPs to the "Enable LiteMage Cache Only for Listed IPs" field.
-==== How to temporarily turn off LiteMage for certain URLs in browser ====
+===== Add your IP to Admin IPs to easily perform certain actions via browser =====
+For information on privileged browser commands, see our [[/litespeed_wiki:cache:litemage:administration#enabling_litemage_administrative_privilege_browser_commands|LiteMage Cache Administration page]].
+===== How to temporarily turn off LiteMage for certain URLs in browser =====
 You may want to confirm whether or not an issue on a particular site is being caused by LiteMage Cache being enabled but do not want to disable LiteMage Cache for everyone. You can do this by adding the GET parameter "LITEMAGE_DEBUG=NOCACHE" to the site's URL which will cause the page to not be served by LiteMage (available since 1.0.2).
@@ Line 30: / Line 35: @@
 http://your-magento-domainname/home-decor/books-music/alice-in-wonderland.html?LITEMAGE_DEBUG=NOCACHE
 </code>
-When checking the HTML response header for the page, "X-LiteSpeed-Cache: hit,litemage" should no longer be listed.
+This will retrieve the current page from the backend, bypassing LiteMage Cache. When checking the HTML response header for the page, "X-LiteSpeed-Cache: hit,litemage" should no longer be listed.
-This is the quickest way to debug LiteMage for specific URLs.
+This is useful for checking the accuracy of the currently cached version of a page and also the quickest way to debug LiteMage for specific URLs.
-====  How to check if ESI block holes are being properly punched ====
+=====  How to check if ESI block holes are being properly punched =====
-From LiteMage Extension 1.0.2 onwards, you can identify punched holes in a page by adding the Get parameter "LITEMAGE_DEBUG=SHOWHOLES".
+From LiteMage Extension 1.0.2 onward, you can display holes punched during the ESI process by adding the GET parameter "LITEMAGE_DEBUG=SHOWHOLES". This is useful for checking if all private blocks are being properly hole punched by LiteMage.
-To do this, first either set "Enable Debug" to "Yes" in the "Developer Testing" section under System > Configuration > LITEMAGE CACHE > LiteMage Configuration, or, in the same section, add your IP address to the list in "Enable LiteMage Cache Only for Listed IPs". You can now append "?LITEMAGE_DEBUG=SHOWHOLES" to the end of any LiteMage enabled URL and the injected blocks on the page will now be highlighted except for valueOnly blocks.
+To do this, navigate to System > Configuration > LITEMAGE CACHE > LiteMage Configuration and either set **Enable Debug** to "Yes" in the "Developer Testing" section under , add your IP address to the list in **Enable LiteMage Cache Only for Listed IPs** in the same section, or add your IP address to the list in **Admin IPs** under the "General Settings" section.
+You Should now be able to append "?LITEMAGE_DEBUG=SHOWHOLES" to the end of any LiteMage enabled URL and the injected blocks on the page will now be highlighted except for valueOnly blocks.
 For example:
+{{:litespeed_wiki:cache:lmshowholes.png?direct 800px|}}
+**Note:** If used, it is recommended to set **Enable Debug** back to "No" when finished.
+===== Need Additional Support? =====
-  http://your-magento-domainname/home-decor/books-music/alice-in-wonderland.html?LITEMAGE_DEBUG=SHOWHOLES
+For extensions that need some tweaking before being used with LiteMage, visit our [[litespeed_wiki:cache:litemage:supported_extensions#possible_modification_required|Supported 3rd Party Extensions page]].
-It is recommended to set "Enable Debug" back to "No" when finished.
+If you need any additional support or help installing, configuring, or troubleshooting LiteMage for your Magento store, have a look at our [[litespeed_wiki:cache:litemage:troubleshooting:support|LiteMage Support]] page.