Differences

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

--- litespeed_wiki:cache:litemage:administration [2015/10/30 13:59]
Michael Alegre [Add Your IP to the Admin IPs List]
+++ litespeed_wiki:cache:litemage:administration [2016/05/06 15:51] (current)
Rob Holda
@@ Line 5: / Line 5: @@
 ===== Enabling LiteMage Administrative Privilege Browser Commands =====
-There are three methods of enabling LiteMage administrative privilege browser commands for your Magento site. The one you choose to use will depend on the mode you would like LiteMage to be in at the time as well as the type of commands you would like access to. All debug-related commands will contain "LITEMAGE_DEBUG". Refer to the [[#all_administrative_privilege_browser_commands|All Administrative Privilege Browser Commands]] section for a full list of administrative privilege commands.
+There are three methods of enabling LiteMage administrative privilege browser commands for your Magento site. The one you choose to use will depend on the mode you would like LiteMage to be in at the time as well as the type of commands you would like access to.
-==== Debug Mode ====
+==== Debug-Related Browser Commands ====
-By putting LiteMage in debug mode you are essentially giving any IP that can access the site permission to use debug-related administrative privilege browser commands with regard to LiteMage. It is not recommended to do this unless your Magento site is only accessible by you at the time.
+The following are two methods of enabling debug-related browser commands on your Magento site.
+All debug-related commands will contain "LITEMAGE_DEBUG".
+=== Enabling Debug Mode ===
+By putting LiteMage in debug mode you are giving any IP that can access your site permission to use debug-related browser commands with regard to LiteMage. It is not recommended to do this unless your Magento site is only accessible by you at the time.
 To enable Debug Mode, log in to the Magento Admin Panel and navigate to System -> Configuration. Under "LITEMAGE CACHE" in the left side menu, click "LiteMage Configuration". Under "Developer Testing" set **Enable Debug** to "Yes".
-==== Enable LiteMage For Certain IPs Only ====
+=== Enable LiteMage For Certain IPs Only ===
-By enabling LiteMage for certain IPs only, you are essentially giving permission to use debug-related administrative privilege browser commands with regard to LiteMage to those specific IPs as well as disabling LiteMage for all other traffic to your site. This setting can be very useful for debugging.
+By enabling LiteMage for certain IPs only, you are giving permission to use debug-related browser commands with regard to LiteMage to those specific IPs as well as disabling LiteMage for all other traffic to your site. This setting can be very useful for debugging.
 To enable LiteMage for certain IPs only, log in to the Magento Admin Panel and navigate to System -> Configuration. In the left hand 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.
-==== Add Your IP to the Admin IPs List ====
+==== All Browser Commands ====
-This is the most direct and least obtrusive way of enabling all administrative privilege browser commands (including debug-related commands). Although it can be less useful for debugging, LiteMage will remain enabled for all visitors to your site and only the IPs listed will have permission to use all administrative privilege browser commands.
+The following method will enable all available browser commands (including debug-related browswer commands).
+=== Add Your IP to the Admin IPs List ===
+This is the most direct and least obtrusive way of enabling administrative privilege browser commands for specific IPs. This can be less useful for debugging, as LiteMage will remain enabled for all visitors to your site.
 To add your IP to the Admin IPs list, log in to the Magento Admin Panel and navigate to System ->  Configuration. In the left hand side menu under "LITEMAGE CACHE", click "LiteMage Configuration". Under "General Settings" add the desired IPs to the **Admin IPs** field.
@@ Line 32: / Line 42: @@
   * **?LITEMAGE_CTRL=PURGE** - This command allows you to purge the current page from cache without having to go through the Magento Admin Panel.
   * **/litemage/admin/purge?tags=** - This command is used to purge any page containing a certain item, category, or cms page by ID number. The command should be followed by a comma separated list of tags and ID numbers where the tag can be P(for product), C(for catalog), or G(for cms page), followed by a dot and the desired numeric ID. \\ \\ For Example: ''your_site_url/litemage/admin/purge?tags=P.345,C.4,G.1'' \\  \\ This is very useful in cases where your Magento database is updated by an external program. In these cases you can use GET with this parameter in a script to automate purging the affected products, categories, or cms pages. \\ \\ **Note:** This is not necessary if updating only through the Magento Admin Panel. When a product is saved in the Magento Admin Panel, not only the product page but also all the related category pages will be automatically purged.
+===== LiteMage Cache Cleanup =====
+Like most caches, LiteMage Cache needs to be periodically cleaned to prevent the cache storage from growing too large. Deleting these files by flushing the cache through Magento could slow down your site and it would instead be preferable to do this cleaning in a separate process. To this end LiteMage will only mark files as "expired" when the cache is flushed instead of deleting them outright. To do the actual cleaning, we have included a **cleanlitemage.sh** script in the ''admin/misc'' directory of your LSWS installation directory.
+This script takes from one to three plus input parameters, which are as follows:
+  * ''**-priv <age_mins>**'' - **(Optional)** - Determines the maximum age (in minutes) of items stored in the private cache. The default value is 60 minutes. If set, value must be greater than 0.
+  * ''**-pub <age_mins>**'' - **(Optional)** - Determines the maximum age (in minutes) of items stored in the public cache. The default value is 0, meaning public cache will not be purged. If set, value must be greater than 10.
+  * ''**<litemage_cache_dir1> ... <litemage_cache_dir9>**'' - **(Required)** - Specifies one or more LiteMage cache storage directories separated by spaces. Each directory must contain the ''/priv'' directory.
+**Note:** The values (in minutes) used for ''**-priv**'' and ''**-pub**'' should be set higher than **Default Private Cache TTL (seconds)** and **Default Public Cache TTL (seconds)** in LiteMage's Configuration settings in the Magento Admin Panel. This will ensure that you are only purging expired files.
+**Tip:** Once you have found a combination of settings that keeps your cache size reasonable, you can then include this script in a cron job to automate the process.