Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
Next revisionBoth sides next revision
72:cms_prefetch [2020/08/25 07:29] tssr72:cms_prefetch [2020/10/21 12:39] – [CMS Prefetch Configuration] twn
Line 8: Line 8:
 === Configuration of the CMS Prefetch === === Configuration of the CMS Prefetch ===
  
-The default configuration of the CMS prefetch is found in <font inherit/Courier New,Courier,monospace;;inherit;;inherit>''<Stages installation path>/stages/conf/config.xml''</font> file:<code>+The default configuration of the CMS prefetch is found in <font inherit/Courier New,Courier,monospace;;inherit;;inherit>''<Stages installation path>/stages/conf/config.xml''</font> file:
  
 +<code>
 <stages-config> <stages-config>
  <properties>  <properties>
Line 17: Line 18:
  <property name="cms.prefetch.sleepMillisBetweenDocuments" value="0"/>  <property name="cms.prefetch.sleepMillisBetweenDocuments" value="0"/>
  <property name="cms.prefetch.workersCount" value="1"/>  <property name="cms.prefetch.workersCount" value="1"/>
- <property name="cms.prefetch.strategy.class" + <property name="cms.prefetch.strategy.class" value="AllDocumentsStrategy"/>
- value="de.methodpark.pkit.cms.prefetch.ClassicAllDocumentsStrategy"/>+
  </properties>  </properties>
  <cms> ... </cms>  <cms> ... </cms>
Line 27: Line 27:
 A more detailed description of these properties can be found in the following table: A more detailed description of these properties can be found in the following table:
  
-TBD+|==== Property ==== 
 + 
 +|==== Description ==== 
 + 
 +
 +| \\ 
 +   cms.prefetch.activated| \\ 
 +   In case no configuration management system is configured the prefetch service can be completely deactivated. \\ 
 +    \\ 
 +   Default: true| 
 +| \\ 
 +   cms.cache.refreshIntervalInMinutes| \\ 
 +   A new prefetch run will be started after this period of time. (In case of a too short interval it will be delayed until the previous run has finished) \\ 
 +    \\ 
 +   Default: 60| 
 +| \\ 
 +   cms.prefetch.sleepMillisBetweenDocuments| \\ 
 +   In case the prefetch service produces too much CPU load on the Stages server or on the CMS, it can be forced to pause for some time. This will of course lead to longer running prefetches. \\ 
 +    \\ 
 +   Default: 0| 
 +| \\ 
 +   cms.prefetch.workersCount| \\ 
 +   In case the prefetch does not finish its work within the specified referesh interval, the amount of worker threads utilized by the prefetch can be increased. This will lead to additional CPU load and load on the CMS. \\ 
 +    \\ 
 +   Default: 1| 
 +| \\ 
 +   cms.prefetch.strategy.class| \\ 
 +   Specifies the strategy implementation to use to update the document revision information. \\ 
 +    \\ 
 +   Default: AllDocumentsStrategy| 
 +| \\ 
 +   cms.prefetch.maxParallelTasks.<CMSType>| \\ 
 +   Where <CMSType> is the name of one of the \\ 
 +   CMS types specified by the cms-type Tag in the cms Section of config.xml. It will only be \\ 
 +   used by some of the available Strategies. E.g. CMSTypeStrategy. It can be used to restrict the amount of parallel tasks that work on the same type of CMS. \\ 
 +    \\ 
 +   Default: 1| 
 +| \\ 
 +   cms.prefetch.initialStart.hourOfDay| \\ 
 +   In case this property exists in config.xml, scheduling of the initial prefetch run will be delayed until the configured hour of the day. Valid values are (0-23). E.g. for 22 the first prefetch run will be delayed to 22:00. It has to be ensured that the Stages service is up and running at this timepoint. If this property does not exist the prefetch will start directly after starting the Stages service. \\ 
 +    \\ 
 +   Default: <not set; start immediatly>|
  
 === Strategies === === Strategies ===
Line 33: Line 74:
 The following prefetch strategies are currently available. The following prefetch strategies are currently available.
  
-//Classic all documents available// +//Classic all documents available//<code> 
-<code> + 
-class=de.methodpark.pkit.cms.prefetch.ClassicAllDocumentsStrategy+class=AllDocumentsStrategy
  
 </code> </code>
Line 43: Line 84:
 //Prefetch by CMS type strategy// //Prefetch by CMS type strategy//
 <code> <code>
-class=de.methodpark.pkit.cms.prefetch.PrefetchByCMSTypeStrategy+class=CMSTypeStrategy
  
 </code> </code>
Line 55: Line 96:
  <properties>  <properties>
  <property name="cms.prefetch.workersCount" value="8"/>  <property name="cms.prefetch.workersCount" value="8"/>
- <property name="cms.prefetch.strategy.class" + <property name="cms.prefetch.strategy.class" value="CMSTypeStrategy"/>
- value="de.methodpark.pkit.cms.prefetch.PrefetchByCMSTypeStrategy"/>+
  <property name="cms.prefetch.maxParallelTasks.SVN" value="1"/>  <property name="cms.prefetch.maxParallelTasks.SVN" value="1"/>
  <!--0 is mapped to unlimited, if nothing were configured it would  <!--0 is mapped to unlimited, if nothing were configured it would
Line 75: Line 115:
 These caches are persisted in the file system on the application server that runs Stages. These caches are persisted in the file system on the application server that runs Stages.
  
-To optimize the usage of memory on the application server, the administrator can configure the cache size+The cache size has a fixed size but will be configurable from Version 7.4.6.1, 7.5.2.1 and above.
- +
-**In Version VERSION and above**:+
  
-The property "cms.prefetch.memorycache.max.documents" and "cms.structure-prefetch.memorycache.max.repositories" can be used to set the maximum amount of objects, which should be cached in memory for the documents-cache and the repository-cache.+\\
  
-**Since Version**: 
  
-For a more accurate adjustment, the cache size can now be configured in MB. The corresponding properties are 
-"cms.structure-prefetch.memory.cache.repositories.maxSizeInMB" and "cms.prefetch.memory.cache.documents.maxSizeInMB"