Page History

Anchor
top top

It  It enables the website to handle the load created by many page requests by using an intelligent mechanism that returns pages without having to regenerate them completely. The XperienCentral caching module is also tailored to not interfere with visitor interaction and personalization.

...

...

Architecture and Overview

Caching occurs in the frontend server processes and has links with JSP rendering [D] and the time stamps table [E], As you can see in the image below. A page request [A] from a website visitor goes through some filters [B] and arrives at the caching module [C].

Image Removed

 Image Added

The actions inside the caching module [C] can be summarized as follows (see image below):

...

1. [A] Retrieve the timestamp of the page (or SSI) by performing a query on the Timestamp database. The database is not always queried but instead the timestamps are also cached in the caching module. The timestamp is compared with the date of the file in the cache. If the timestamp is newer then the file is returned [D], otherwise the page has to be rendered.
2. [B] The page must be regenerated, therefore a request goes from the caching module to the backend servlet in order to render the page. This takes some time and it’s the slowest scenario. After the page has been rendered, it is stored as a file in the cache directory [C] and the page is returned.

Image Removed

 Image Added

Back to Top 

...

Pages and Server Side Includes

...

In XperienCentral, page parts can be cached. This is done using Server Side Includes (SSIs). This is a common mechanism whereby tags are placed inside the (HTML/JSP) source code. These SSI tags refer to other pieces of code and can be referenced by local file path or URL. When the application server encounters an SSI tag it will request the SSI and add the generator code to the page. The following is an example of an SSI tag: 

<!--#include virtual="/web/show?id=68644&langid=43&contentid=5&elementHolder=68637&jelly=true ssiObjectClassName=nl.gx.webmanager.cms.mediarepository.MediaCollectionElement&ssiObjectId=68647&webid=26098" -->

...

This SSI tag will render a Content Overview element with the ID 68647. There are more parameters that describe the element’s context, for example a. Page ID, Content Item ID, web initiative channel ID, and so forth.

An SSI Example: the Poll Element

Polls are elements that can change quite often when a lot of people vote, therefore it is better to use an SSI for the Poll Element. In a basic situation where you add a poll element to a page, the page.jsp is used as a starting point. The page.jsp will require the /pagepart/content.jspf, which will call the /element/pollElement.jspf. Before we look into this .jspf let’s examine the /element/pollElement.xml file: 

<presentation>
   <name>WM pollelement</name>
   <display-name>WM Poll element</display-name>
   <scope>PollElement</scope>
   <include>WM pollelement form</include>
   <include>WM pollelement result</include>
   <property>
   ...
   </property>
   <ssi>
      <presentation>pollElementSsi</presentation>
   </ssi>
</presentation>

...

An extra SSI node is included that points to a special SSI presentation. In this case it points to the /element/pollElementSsi.jspf file (see marked lines). Because of this SSI presentation the default pollElement.jspf is not used, but instead the /pollElementSsi.jspf is rendered. 

<wm:link var="ssiLink" ssiObjectId="${pollElement.id}" ssiObjectClassName="nl.gx.webmanager.cms.element.PollElement" passOn="${passOn}" cachetimeout="120" />
${ssiLink.ssiTag}

To see the SSI in action on a page you have to perform the following steps:

1. First make sure you can log in to your application server as an administrator. For Tomcat this involves editing the file /conf/tomcat-users.xml in the Tomcat directory. Example:
   
   

   Code Block
   theme Eclipse
   <?xml version='1.0' encoding='utf-8'?> <tomcat-users> <role rolename="wmadmin"/> <user username="wmadmin" password="123456" roles="wmadmin"/> </tomcat-users>

   
   
   

2. Restart Tomcat and go to the URL http://<hostname>:<port>/web/admin. Enter the username and password.
3. Create a page in XperienCentral and add a Poll element. Enter some information in the poll element and publish the page.
4. Open the page on the backend hostname: open a new tab/window in your browser and go to  http://<hostname>:<port>/web/show. This will show the homepage of your website without using the cache. Navigate to the page with the poll element.

5. Add the following string to the URL of the page: /ssidebug=true and refresh the page. This should show the string we have seen in the previous paragraph, something like:
   
   
   

   Code Block
   theme Eclipse
   <!--#include virtual="/web/show?id=26111&langid=43&cachetimeout=120&elementHolder=26114&ssiObjectClassName=nl.gx.webmanager.cms.element.PollElement&ssiObjectId=72418"-->

   
   It’s possible to paste the marked part after your backend hostname and port number and open it in a browser. You will then see the code of the poll element and nothing else. This exercise shows that individual SSIs can be rendered on their own by passing the right parameters (such as elementHolder and ssiObjectClassName to a /web/show command.

...

Back to Top 

...

Working with the Caching Module

...

Enabling Caching

1. To enable caching go to frontend_system_settings  section of the General tab of Setup Tool and ensure that the allow_cache checkbox is selected.
2. You can test if it works by requesting several pages on the frontend. Verify whether there are subdirectories with numbers created in the cache directory (the default is /work/cache for local installations and /cache for production servers).
3. If you want to make sure that most pages are generated (and therefore in the cache) before a website goes live you can run the XperienCentral search engine.  

Cache Configuration Settings

You can find most of the caching settings in the  frontend_system_settings   section of the General tab of Setup Tool. The relevant cache options are: 

...

Caching Optimization in the Edit Environment

...

On the other hand be careful with very dynamic page sections. If you set a caching timeout for these types of page sections you might frustrate site editors because it takes too long for new content or content changes to show up. 

Back to Top

...

Clearing the Cache

In a normal situation XperienCentral takes care of the required actions to clear the cache when content is changed, added or removed. When an editor adds an element to a page the timestamp for the page will be set to the current date and time. The caching mechanism will notice this when the page is requested and the page will be regenerated.

...

To control the cache, navigate to Configure > Server configuration > [Caching]:

Image RemovedImage Added

To update the timestamps, select a time range for the objects you want to update and click [Update timestamps]. This can be done for the various items, so use common sense to clear the cache only for the relevant items.

If you are dealing with a live server with a significant load you have to be a bit more careful with updating the timestamps. For this purpose "soft timestamping" is available. By setting a soft timestamp, a special entry with ID 0 is created in the "sw_object" table. When a visitor requests a page, the timestamp of this page is compared with the "0" object. If the timestamp is older, a request is sent to regenerate the page , but and at the same time the cached version of the page is returned to the visitor, therefore the visitor doesn’t have to wait until the page is generated but instead they will get the cached page. The next vistor visitor will get the regenerated page. To use soft timestamping you have to click the [Update timestamps] button next to "General timestamp".

When you launch a new website, you can initialize the caching module by clicking on the [Update timestamps] button next to the "Initialize caching" label. This will create a timestamp entry for each page.

...

For debugging purposes it might be necessary to look at the timestamps more closely. Timestamps are stored in the XperienCentral external database in the following seven tables:

Back to Top

...

Anchor
debugging_the_xperiencentral_cache debugging_the_xperiencentral_cache

Debugging the XperienCentral Cache

You can visually inspect the parts of a content item that have been cached. To do so, you must be logged in to the website backend and the permission "Access debugging tools" in the Permission category "System utilities" must be enabled for your user role. To inspect/debug the cache, navigate to the content item you want to inspect on the website frontend and append the parameter ?cachedebug=true to the end of the URL For example:

https://www.gxsoftware.com/en/products.htm?cachedebug-true

The content item will reload and you will see cached content outlined in red. If you hover the mouse over the area, the cache ID for the content will appear in a tooltip. For example:

Image Added 

Back to Top 

...

Performance Checklist

The following checklist can be used to check the performance variables of a XperienCentral website. Performance involves more than XperienCentral and the caching module so other relevant settings are also taken into account.

...

• Make sure the URLs contain as little query string parameters as possible
  Recommendation: try to avoid using query string parameters to pass parameters to other pages or page sections. This will create more unique URLs and thus more pages have to be generated and not cached
  . How to check: use http://<hostname>/web/admin/status (Administrative Pages) to watch all incoming page requests.

• Use Server Side Includes (SSIs) for media overviews and queries
  Recommendation: Try to use SSIs for all Content Overview and query elements. This is also the default setting in the XperienCentral cleansite (the default set of JSPs that come with XperienCentral)
  . How to check: use http://<hostname>/<page-url/ssidebug=true to see all SSIs on a page. On pages that contain media collections you should see the SSI URLs.

• Don’t use too many Server Side Included (SSIs)
  Recommendation: More than 5 SSIs will more create more overhead and add more complexity to the caching mechanism
  . How to check: use http://<hostname>/<page-url/ssidebug=true to see all SSIs on a page.

• Avoid using hardcoded queries in JSPs
  Recommendation: hardcoded queries in JSPs don’t profit from the caching/timestamp mechanism and should therefore be avoided. Instead, use the XperienCentral query element or database pages.             

...

Back to Top 

...

FAQ

Q: Where can I find the cache directory?

A: The cache directory is set in the Setup Tool using cache_directory property . The default setting is /cachein the frontend_system_settings section on the General tab of the Setup Tool.

Q: What happens if the (application) server is restarted? Will the cache be emptied?

...

Q: Is it OK to remove the files from the cache directory or can the cache get corruptcorrupted?

A: No. The proxy will detect whether the file is present on disk. If not it will be regenerated and written to disk again.

Q: What happens if I clear all the timestamp tables?

A: No timestamps will be found for any object or page so the cached file will be returned automatically. This happens until a requested object is changed and saved again.

Back to Top