You are viewing a plain text version of this content. The canonical link for it is here.
Posted to jcs-dev@jakarta.apache.org by as...@apache.org on 2004/07/14 05:51:35 UTC
cvs commit: jakarta-turbine-jcs/xdocs UsingJCSBasicWeb.xml RemoteAuxCache.xml LocalCacheConfig.xml LateralTCPAuxCache.xml IndexedDiskAuxCache.xml index.xml BasicJCSConfiguration.xml
asmuts 2004/07/13 20:51:35
Modified: xdocs UsingJCSBasicWeb.xml RemoteAuxCache.xml
LocalCacheConfig.xml LateralTCPAuxCache.xml
IndexedDiskAuxCache.xml index.xml
BasicJCSConfiguration.xml
Log:
Updated documentation. Removed stratum subpackage reference. Modified the disk cache doc.
Revision Changes Path
1.2 +12 -12 jakarta-turbine-jcs/xdocs/UsingJCSBasicWeb.xml
Index: UsingJCSBasicWeb.xml
===================================================================
RCS file: /home/cvs/jakarta-turbine-jcs/xdocs/UsingJCSBasicWeb.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- UsingJCSBasicWeb.xml 7 Apr 2002 16:55:20 -0000 1.1
+++ UsingJCSBasicWeb.xml 14 Jul 2004 03:51:35 -0000 1.2
@@ -123,9 +123,9 @@
<source><![CDATA[
package com.genericbookstore.data;
-import org.apache.stratum.jcs.JCS;
+import org.apache.jcs.JCS;
// in case we want to set some special behavior
-import org.apache.stratum.jcs.engine.behavior.IElementAttributes;
+import org.apache.jcs.engine.behavior.IElementAttributes;
public class BookVObjManager
{
@@ -352,10 +352,10 @@
# sets the default aux value for any non configured caches
jcs.default=DC,RFailover
jcs.default.cacheattributes=
- org.apache.stratum.jcs.engine.CompositeCacheAttributes
+ org.apache.jcs.engine.CompositeCacheAttributes
jcs.default.cacheattributes.MaxObjects=1000
jcs.default.cacheattributes.MemoryCacheName=
- org.apache.stratum.jcs.engine.memory.lru.LRUMemoryCache
+ org.apache.jcs.engine.memory.lru.LRUMemoryCache
jcs.default.elementattributes.IsEternal=false
jcs.default.elementattributes.MaxLifeSeconds=3600
jcs.default.elementattributes.IdleTime=1800
@@ -368,20 +368,20 @@
# should be defined for the storage of group attribute list
jcs.system.groupIdCache=DC,RFailover
jcs.system.groupIdCache.cacheattributes=
- org.apache.stratum.jcs.engine.CompositeCacheAttributes
+ org.apache.jcs.engine.CompositeCacheAttributes
jcs.system.groupIdCache.cacheattributes.MaxObjects=10000
jcs.system.groupIdCache.cacheattributes.MemoryCacheName=
- org.apache.stratum.jcs.engine.memory.lru.LRUMemoryCache
+ org.apache.jcs.engine.memory.lru.LRUMemoryCache
# CACHE REGIONS AVAILABLE
# Regions preconfigured for caching
jcs.region.bookCache=DC,RFailover
jcs.region.bookCache.cacheattributes=
- org.apache.stratum.jcs.engine.CompositeCacheAttributes
+ org.apache.jcs.engine.CompositeCacheAttributes
jcs.region.bookCache.cacheattributes.MaxObjects=1200
jcs.region.bookCache.cacheattributes.MemoryCacheName=
- org.apache.stratum.jcs.engine.memory.lru.LRUMemoryCache
+ org.apache.jcs.engine.memory.lru.LRUMemoryCache
jcs.region.bookCache.elementattributes.IsEternal=false
jcs.region.bookCache.elementattributes.MaxLifeSeconds=7200
jcs.region.bookCache.elementattributes.IdleTime=1800
@@ -393,16 +393,16 @@
# Primary Disk Cache -- faster than the rest because of memory key storage
jcs.auxiliary.DC=
- org.apache.stratum.jcs.auxiliary.disk.indexed.IndexedDiskCacheFactory
+ org.apache.jcs.auxiliary.disk.indexed.IndexedDiskCacheFactory
jcs.auxiliary.DC.attributes=
- org.apache.stratum.jcs.auxiliary.disk.indexed.IndexedDiskCacheAttributes
+ org.apache.jcs.auxiliary.disk.indexed.IndexedDiskCacheAttributes
jcs.auxiliary.DC.attributes.DiskPath=/usr/opt/bookstore/raf
# Remote RMI Cache set up to failover
jcs.auxiliary.RFailover=
- org.apache.stratum.jcs.auxiliary.remote.RemoteCacheFactory
+ org.apache.jcs.auxiliary.remote.RemoteCacheFactory
jcs.auxiliary.RFailover.attributes=
- org.apache.stratum.jcs.auxiliary.remote.RemoteCacheAttributes
+ org.apache.jcs.auxiliary.remote.RemoteCacheAttributes
jcs.auxiliary.RFailover.attributes.RemoteTypeName=LOCAL
jcs.auxiliary.RFailover.attributes.FailoverServers=scriptserver:1102
jcs.auxiliary.RFailover.attributes.GetOnly=false
1.2 +7 -7 jakarta-turbine-jcs/xdocs/RemoteAuxCache.xml
Index: RemoteAuxCache.xml
===================================================================
RCS file: /home/cvs/jakarta-turbine-jcs/xdocs/RemoteAuxCache.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- RemoteAuxCache.xml 7 Apr 2002 16:55:20 -0000 1.1
+++ RemoteAuxCache.xml 14 Jul 2004 03:51:35 -0000 1.2
@@ -110,9 +110,9 @@
<source><![CDATA[
# Remote RMI Cache set up to failover
jcs.auxiliary.RFailover=
- org.apache.stratum.jcs.auxiliary.remote.RemoteCacheFactory
+ org.apache.jcs.auxiliary.remote.RemoteCacheFactory
jcs.auxiliary.RFailover.attributes=
- org.apache.stratum.jcs.auxiliary.remote.RemoteCacheAttributes
+ org.apache.jcs.auxiliary.remote.RemoteCacheAttributes
jcs.auxiliary.RFailover.attributes.FailoverServers=
localhost:1102,localhost:1103
jcs.auxiliary.RC.attributes.RemoveUponRemotePut=true
@@ -126,10 +126,10 @@
#Regions preconfirgured for caching
jcs.region.testCache1=DC,RFailover
jcs.region.testCache1.cacheattributes=
- org.apache.stratum.jcs.engine.CompositeCacheAttributes
+ org.apache.jcs.engine.CompositeCacheAttributes
jcs.region.testCache1.cacheattributes.MaxObjects=1000
jcs.region.testCache1.cacheattributes.MemoryCacheName=
- org.apache.stratum.jcs.engine.memory.lru.LRUMemoryCache
+ org.apache.jcs.engine.memory.lru.LRUMemoryCache
]]></source>
</subsection>
<subsection name="Server Configuration">
@@ -181,13 +181,13 @@
# sets the default aux value for any non configured caches
jcs.default=DC,RCluster1
jcs.default.cacheattributes=
- org.apache.stratum.jcs.engine.CompositeCacheAttributes
+ org.apache.jcs.engine.CompositeCacheAttributes
jcs.default.cacheattributes.MaxObjects=1000
jcs.auxiliary.RCluster1=
- org.apache.stratum.jcs.auxiliary.remote.RemoteCacheFactory
+ org.apache.jcs.auxiliary.remote.RemoteCacheFactory
jcs.auxiliary.RCluster1.attributes=
- org.apache.stratum.jcs.auxiliary.remote.RemoteCacheAttributes
+ org.apache.jcs.auxiliary.remote.RemoteCacheAttributes
jcs.auxiliary.RCluster1.attributes.RemoteTypeName=CLUSTER
jcs.auxiliary.RCluster1.attributes.RemoveUponRemotePut=false
jcs.auxiliary.RCluster1.attributes.ClusterServers=localhost:1103
1.2 +6 -6 jakarta-turbine-jcs/xdocs/LocalCacheConfig.xml
Index: LocalCacheConfig.xml
===================================================================
RCS file: /home/cvs/jakarta-turbine-jcs/xdocs/LocalCacheConfig.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- LocalCacheConfig.xml 7 Apr 2002 16:55:20 -0000 1.1
+++ LocalCacheConfig.xml 14 Jul 2004 03:51:35 -0000 1.2
@@ -58,7 +58,7 @@
# sets the default aux value for any non configured caches
jcs.default=DC,RFailover
jcs.default.cacheattributes=
- org.apache.stratum.jcs.engine.CompositeCacheAttributes
+ org.apache.jcs.engine.CompositeCacheAttributes
jcs.default.cacheattributes.MaxObjects=1000
]]></source>
<p>
@@ -82,7 +82,7 @@
<source><![CDATA[
jcs.region.testCache=DC,RFailover
jcs.region.testCache.cacheattributes=
- org.apache.stratum.jcs.engine.CompositeCacheAttributes
+ org.apache.jcs.engine.CompositeCacheAttributes
jcs.region.testCache.cacheattributes.MaxObjects=1000
]]></source>
<p>
@@ -117,9 +117,9 @@
</p>
<source><![CDATA[
jcs.auxiliary.DC=
- org.apache.stratum.jcs.auxiliary.disk.DiskCacheFactory
+ org.apache.jcs.auxiliary.disk.DiskCacheFactory
jcs.auxiliary.DC.attributes=
- org.apache.stratum.jcs.auxiliary.disk.DiskCacheAttributes
+ org.apache.jcs.auxiliary.disk.DiskCacheAttributes
jcs.auxiliary.DC.attributes.DiskPath=c:/dev/cache/raf
]]></source>
<p>
@@ -134,9 +134,9 @@
</p>
<source><![CDATA[
jcs.auxiliary.RFailover=
- org.apache.stratum.jcs.auxiliary.remote.RemoteCacheFactory
+ org.apache.jcs.auxiliary.remote.RemoteCacheFactory
jcs.auxiliary.RFailover.attributes=
- org.apache.stratum.jcs.auxiliary.remote.RemoteCacheAttributes
+ org.apache.jcs.auxiliary.remote.RemoteCacheAttributes
jcs.auxiliary.RFailover.attributes.RemoteTypeName=LOCAL
jcs.auxiliary.RFailover.attributes.FailoverServers=
localhost:1102,localhost:1101
1.2 +2 -2 jakarta-turbine-jcs/xdocs/LateralTCPAuxCache.xml
Index: LateralTCPAuxCache.xml
===================================================================
RCS file: /home/cvs/jakarta-turbine-jcs/xdocs/LateralTCPAuxCache.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- LateralTCPAuxCache.xml 7 Apr 2002 16:55:20 -0000 1.1
+++ LateralTCPAuxCache.xml 14 Jul 2004 03:51:35 -0000 1.2
@@ -51,9 +51,9 @@
</p>
<source><![CDATA[
jcs.auxiliary.LTCP=
- org.apache.stratum.jcs.auxiliary.lateral.LateralCacheFactory
+ org.apache.jcs.auxiliary.lateral.LateralCacheFactory
jcs.auxiliary.LTCP.attributes=
- org.apache.stratum.jcs.auxiliary.lateral.LateralCacheAttributes
+ org.apache.jcs.auxiliary.lateral.LateralCacheAttributes
jcs.auxiliary.LTCP.attributes.TransmissionTypeName=TCP
jcs.auxiliary.LTCP.attributes.TcpServers=
localhost:1111,localhost:1112
1.2 +16 -8 jakarta-turbine-jcs/xdocs/IndexedDiskAuxCache.xml
Index: IndexedDiskAuxCache.xml
===================================================================
RCS file: /home/cvs/jakarta-turbine-jcs/xdocs/IndexedDiskAuxCache.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- IndexedDiskAuxCache.xml 7 Apr 2002 16:55:20 -0000 1.1
+++ IndexedDiskAuxCache.xml 14 Jul 2004 03:51:35 -0000 1.2
@@ -21,7 +21,7 @@
<subsection name="Disk Indexing">
<p>
- The Indexed Disk Auxiliary Cache follows, perhaps, the fastest
+ The Indexed Disk Auxiliary Cache follows the fastest
pattern of disk caching. Items are stored at the end of a file
dedicated to the cache region. The first byte of each disk entry
specifies the length of the entry. The start position in the file
@@ -32,6 +32,13 @@
as fast as a map lookup and the retrieval of the item only requires 2
disk accesses.
</p>
+ <p>
+ When items are removed from the disk cache, the location of the available
+ block on the storage file is recorded in a sorted preferential array of a
+ size not to exceed the maximum number of keys allowed in memory. This allows
+ the disk cache to reuse empty spots, thereby keeping the file size to a
+ minimum.
+ </p>
</subsection>
<subsection name="Purgatory">
@@ -65,22 +72,23 @@
referenced by <code>DC</code>. It uses files located in the
"DiskPath" directory.
</p>
+ <p>
+ The Disk indexes are equipped with an LRU storage limit. The maximum
+ number of keys is configured by the so the maxKeySize parameter.
+ </p>
<source><![CDATA[
jcs.auxiliary.DC=
- org.apache.stratum.jcs.auxiliary.disk.indexed.IndexedDiskCacheFactory
+ org.apache.jcs.auxiliary.disk.indexed.IndexedDiskCacheFactory
jcs.auxiliary.DC.attributes=
- org.apache.stratum.jcs.auxiliary.disk.indexed.IndexedDiskCacheAttributes
+ org.apache.jcs.auxiliary.disk.indexed.IndexedDiskCacheAttributes
jcs.auxiliary.DC.attributes.DiskPath=g:\dev\jakarta-turbine-stratum\raf
+jcs.auxiliary.DC.attributes.maxKeySize=100000
]]></source>
</subsection>
<subsection name="TODO">
<p>
The Indexed Disk Auxiliary Cache will eventually be equiped
- with real-time defragmentation and periodic index storage.
- This will increase the persistence reliability and minimize
- the file size. Disk indexes may eventually require an LRU storage
- so the file size can be reduced by removing old records. Currently
- there is no maximum file size configuration.
+ with periodic index storage.
</p>
</subsection>
</section>
1.2 +1 -1 jakarta-turbine-jcs/xdocs/index.xml
Index: index.xml
===================================================================
RCS file: /home/cvs/jakarta-turbine-jcs/xdocs/index.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- index.xml 8 Apr 2002 19:22:11 -0000 1.1
+++ index.xml 14 Jul 2004 03:51:35 -0000 1.2
@@ -46,7 +46,7 @@
<p>
These features provide a framework with no point of failure,
allowing for full session failover including session data across
- up to 256 servers.
+ multiple servers.
</p>
</section>
</body>
1.2 +21 -20 jakarta-turbine-jcs/xdocs/BasicJCSConfiguration.xml
Index: BasicJCSConfiguration.xml
===================================================================
RCS file: /home/cvs/jakarta-turbine-jcs/xdocs/BasicJCSConfiguration.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- BasicJCSConfiguration.xml 7 Apr 2002 16:55:20 -0000 1.1
+++ BasicJCSConfiguration.xml 14 Jul 2004 03:51:35 -0000 1.2
@@ -28,10 +28,10 @@
jcs.default=
jcs.default.cacheattributes=
- org.apache.stratum.jcs.engine.CompositeCacheAttributes
+ org.apache.jcs.engine.CompositeCacheAttributes
jcs.default.cacheattributes.MaxObjects=1000
jcs.default.cacheattributes.MemoryCacheName=
- org.apache.stratum.jcs.engine.memory.lru.LRUMemoryCache
+ org.apache.jcs.engine.memory.lru.LRUMemoryCache
]]></source>
<p>
If you want to add memory shrinking then you can add these
@@ -51,9 +51,9 @@
</p>
<source><![CDATA[
jcs.auxiliary.DC=
- org.apache.stratum.jcs.auxiliary.disk.indexed.IndexedDiskCacheFactory
+ org.apache.jcs.auxiliary.disk.indexed.IndexedDiskCacheFactory
jcs.auxiliary.DC.attributes=
- org.apache.stratum.jcs.auxiliary.disk.indexed.IndexedDiskCacheAttributes
+ org.apache.jcs.auxiliary.disk.indexed.IndexedDiskCacheAttributes
jcs.auxiliary.DC.attributes.DiskPath=g:/dev/jakarta-turbine-stratum/raf
]]></source>
<p>
@@ -69,10 +69,10 @@
<source><![CDATA[
jcs.system.groupIdCache=DC
jcs.system.groupIdCache.cacheattributes=
- org.apache.stratum.jcs.engine.CompositeCacheAttributes
+ org.apache.jcs.engine.CompositeCacheAttributes
jcs.system.groupIdCache.cacheattributes.MaxObjects=10000
jcs.system.groupIdCache.cacheattributes.MemoryCacheName=
- org.apache.stratum.jcs.engine.memory.lru.LRUMemoryCache
+ org.apache.jcs.engine.memory.lru.LRUMemoryCache
]]></source>
<p>
If you want to predefine a specific region, say called
@@ -81,10 +81,10 @@
<source><![CDATA[
jcs.region.testCache1=DC
jcs.region.testCache1.cacheattributes=
- org.apache.stratum.jcs.engine.CompositeCacheAttributes
+ org.apache.jcs.engine.CompositeCacheAttributes
jcs.region.testCache1.cacheattributes.MaxObjects=1000
jcs.region.testCache1.cacheattributes.MemoryCacheName=
- org.apache.stratum.jcs.engine.memory.lru.LRUMemoryCache
+ org.apache.jcs.engine.memory.lru.LRUMemoryCache
jcs.region.testCache1.cacheattributes.UseMemoryShrinker=true
jcs.region.testCache1.cacheattributes.MaxMemoryIdleTimeSeconds=3600
jcs.region.testCache1.cacheattributes.ShrinkerIntervalSeconds=60
@@ -97,9 +97,9 @@
</p>
<source><![CDATA[
jcs.auxiliary.LTCP=
- org.apache.stratum.jcs.auxiliary.lateral.LateralCacheFactory
+ org.apache.jcs.auxiliary.lateral.LateralCacheFactory
jcs.auxiliary.LTCP.attributes=
- org.apache.stratum.jcs.auxiliary.lateral.LateralCacheAttributes
+ org.apache.jcs.auxiliary.lateral.LateralCacheAttributes
jcs.auxiliary.LTCP.attributes.TransmissionTypeName=TCP
jcs.auxiliary.LTCP.attributes.TcpServers=localhost:1111
jcs.auxiliary.LTCP.attributes.TcpListenerPort=1110
@@ -137,42 +137,43 @@
jcs.default=DC,LTCP
jcs.default.cacheattributes=
- org.apache.stratum.jcs.engine.CompositeCacheAttributes
+ org.apache.jcs.engine.CompositeCacheAttributes
jcs.default.cacheattributes.MaxObjects=1000
jcs.default.cacheattributes.MemoryCacheName=
- org.apache.stratum.jcs.engine.memory.lru.LRUMemoryCache
+ org.apache.jcs.engine.memory.lru.LRUMemoryCache
# System CACHE REGION
jcs.system.groupIdCache=DC,LTCP
jcs.system.groupIdCache.cacheattributes=
- org.apache.stratum.jcs.engine.CompositeCacheAttributes
+ org.apache.jcs.engine.CompositeCacheAttributes
jcs.system.groupIdCache.cacheattributes.MaxObjects=10000
jcs.system.groupIdCache.cacheattributes.MemoryCacheName=
- org.apache.stratum.jcs.engine.memory.lru.LRUMemoryCache
+ org.apache.jcs.engine.memory.lru.LRUMemoryCache
# PRE-DEFINED CACHE REGIONS
jcs.region.testCache1=DC,LTCP
jcs.region.testCache1.cacheattributes=
- org.apache.stratum.jcs.engine.CompositeCacheAttributes
+ org.apache.jcs.engine.CompositeCacheAttributes
jcs.region.testCache1.cacheattributes.MaxObjects=1000
jcs.region.testCache1.cacheattributes.MemoryCacheName=
- org.apache.stratum.jcs.engine.memory.lru.LRUMemoryCache
+ org.apache.jcs.engine.memory.lru.LRUMemoryCache
jcs.region.testCache1.cacheattributes.UseMemoryShrinker=true
jcs.region.testCache1.cacheattributes.MaxMemoryIdleTimeSeconds=3600
jcs.region.testCache1.cacheattributes.ShrinkerIntervalSeconds=60
# AVAILABLE AUXILIARY CACHES
jcs.auxiliary.DC=
- org.apache.stratum.jcs.auxiliary.disk.indexed.IndexedDiskCacheFactory
+ org.apache.jcs.auxiliary.disk.indexed.IndexedDiskCacheFactory
jcs.auxiliary.DC.attributes=
- org.apache.stratum.jcs.auxiliary.disk.indexed.IndexedDiskCacheAttributes
+ org.apache.jcs.auxiliary.disk.indexed.IndexedDiskCacheAttributes
jcs.auxiliary.DC.attributes.DiskPath=g:/dev/jakarta-turbine-stratum/raf
+jcs.auxiliary.DC.attributes.maxKeySize=100000
jcs.auxiliary.LTCP=
- org.apache.stratum.jcs.auxiliary.lateral.LateralCacheFactory
+ org.apache.jcs.auxiliary.lateral.LateralCacheFactory
jcs.auxiliary.LTCP.attributes=
- org.apache.stratum.jcs.auxiliary.lateral.LateralCacheAttributes
+ org.apache.jcs.auxiliary.lateral.LateralCacheAttributes
jcs.auxiliary.LTCP.attributes.TransmissionTypeName=TCP
jcs.auxiliary.LTCP.attributes.TcpServers=localhost:1111
jcs.auxiliary.LTCP.attributes.TcpListenerPort=1110
---------------------------------------------------------------------
To unsubscribe, e-mail: turbine-jcs-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: turbine-jcs-dev-help@jakarta.apache.org