From jbosscache-commits at lists.jboss.org Tue Aug 25 19:10:02 2009 Content-Type: multipart/mixed; boundary="===============8199858467184825856==" MIME-Version: 1.0 From: jbosscache-commits at lists.jboss.org To: jbosscache-commits at lists.jboss.org Subject: [jbosscache-commits] JBoss Cache SVN: r8199 - in enterprise-docs/tags/JBoss_EAP_5_0_0: Cache_Tutorial/en-US and 1 other directory. Date: Tue, 25 Aug 2009 19:10:02 -0400 Message-ID: <200908252310.n7PNA2G0005988@svn01.web.mwc.hst.phx2.redhat.com> --===============8199858467184825856== Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Author: irooskov(a)redhat.com Date: 2009-08-25 19:10:02 -0400 (Tue, 25 Aug 2009) New Revision: 8199 Modified: enterprise-docs/tags/JBoss_EAP_5_0_0/Cache_FAQ/en-US/JBoss_Cache_Frequen= tly_Asked_Questions.xml enterprise-docs/tags/JBoss_EAP_5_0_0/Cache_Tutorial/en-US/JBoss_Cache_Tu= torial.xml Log: updated files Modified: enterprise-docs/tags/JBoss_EAP_5_0_0/Cache_FAQ/en-US/JBoss_Cache_= Frequently_Asked_Questions.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- enterprise-docs/tags/JBoss_EAP_5_0_0/Cache_FAQ/en-US/JBoss_Cache_Freque= ntly_Asked_Questions.xml 2009-08-24 15:19:10 UTC (rev 8198) +++ enterprise-docs/tags/JBoss_EAP_5_0_0/Cache_FAQ/en-US/JBoss_Cache_Freque= ntly_Asked_Questions.xml 2009-08-25 23:10:02 UTC (rev 8199) @@ -1,14 +1,12 @@ - + = General Information - What is JBoss Cache? @@ -47,25 +45,21 @@ do= cumentation website. = - + = @@ -76,18 +70,12 @@ = - JBoss Cache has an active community of developers = and contributors. The project was founded by - Bela - Ban - and is currently led by Manik Surtani. Jason Green= e is the lead for the POJO Cache subsystem, - and other - contributors both past and present include Ben Wan= g, Harald Gliebe, Brian Stansberry, Vladimir - Blagojevic, Mircea Markus, Jimmy Wilson, Galder Za= marre=C3=B1o and Elias Ross. + JBoss Cache has an active community of developers = and contributors. The project was founded by Bela Ban and is currently led = by Manik Surtani. Jason Greene is the lead for the POJO Cache subsystem, an= d other contributors both past and present include Ben Wang, Harald Gliebe,= Brian Stansberry, Vladimir Blagojevic, Mircea Markus, Jimmy Wilson, Galder= Zamarre=C3=B1o and Elias Ross. = - + = - + = - + = - + = @@ -221,7 +209,7 @@ = - + = - JBoss Cache - Core + JBoss Cache: Core = = - + = @@ -1205,6 +1193,7 @@ + = Cache Loaders @@ -1235,8 +1224,6 @@ JBoss Cache currently ships with several cache l= oader implementations, including: - - @@ -1285,7 +1272,6 @@ - = @@ -1300,26 +1286,30 @@ production environment, or if used in such an environment, it= should be used with due care and sufficient understanding of these limitations. + - Due to the way the FileCacheLoader r= epresents a tree structure on disk + Due to the way the FileCacheLo= ader represents a tree structure on disk (directories and - files) traversal is inefficient for deep t= rees. + files) traversal is inefficient for deep t= rees. - Usage on shared filesystems like NFS= , Windows shares, etc. should be avoided as + Usage on shared filesystems li= ke NFS, Windows shares, etc. should be avoided as these do - not implement proper file locking and can = cause data corruption. + not implement proper file locking and can = cause data corruption. - Usage with an isolation level of NON= E can cause corrupt writes as multiple threads - attempt to write to the same file. + Usage with an isolation level = of NONE can cause corrupt writes as multiple threads + attempt to write to the same file. - File systems are inherently not tran= sactional, so when attempting to use your + + + File systems are inherently not transactional, so when attempting = to use your cache in a transactional context, failures when writi= ng to the file (which happens during the commit phase) cannot be recovered. + - + As a rule of thumb, it is recommended that the Fil= eCacheLoader not be used in a highly concurrent, transactional or stressful environment, and its us= e is restricted to testing. @@ -1444,16 +1434,12 @@ = - Can I migrate a JDBCacheLoader or FileCacheLoade= r based cache store containing data formatted - with - JBoss Cache 1.x.x to JBoss Cache 2.0 format? + Can I migrate a JDBCacheLoader or FileCacheLoade= r based cache store containing data formatted with JBoss Cache 1.x.x to JBo= ss Cache 2.0 format? = - Yes. See "Transforming Cache Loaders" section wi= thin the "Cache Loaders" section located in - the - JBoss Cache Users' Guide. + Yes. See "Transforming Cache Loaders" section wi= thin the "Cache Loaders" section located in the JBoss Cache Users' Guide. @@ -1464,7 +1450,7 @@ Is the TCPDelegatingCacheLoader resilient to TCPCa= cheServer restarts? - + = As of JBoss Cache 2.1.0, the answer is yes. See th= e Users' Guide for details on how to configure @@ -1477,8 +1463,8 @@ restarting your application that uses the cache. + = - @@ -1487,14 +1473,12 @@ = - I am having problems getting JBoss Cache to work= , where can I get information on - troubleshooting? + I am having problems getting JBoss Cache to work= , where can I get information on troubleshooting? Troubleshooting section can be found in the foll= owing - wiki link - . + wiki link. Modified: enterprise-docs/tags/JBoss_EAP_5_0_0/Cache_Tutorial/en-US/JBoss_C= ache_Tutorial.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- enterprise-docs/tags/JBoss_EAP_5_0_0/Cache_Tutorial/en-US/JBoss_Cache_T= utorial.xml 2009-08-24 15:19:10 UTC (rev 8198) +++ enterprise-docs/tags/JBoss_EAP_5_0_0/Cache_Tutorial/en-US/JBoss_Cache_T= utorial.xml 2009-08-25 23:10:02 UTC (rev 8199) @@ -1,7 +1,6 @@ - JBossCache Tutorial Introduction @@ -38,32 +37,23 @@ Configuration = First download the JBoss Cache 3.x distribution from - the download page. You will need the ALL distribution ( - jbosscache-core-3.X.Y.GA-all.zip). - Unzip it, and you will get a directory containing the distributio= n, such as - jbosscache-core-3.X.Y - . - For the sake of this tutorial, I will refer to this as - ${JBOSSCACHE_HOME} - . + the download page. You will need the all di= stribution (jbosscache-core-3.X.Y.GA-all.zip). Unzip it,= and you will get a directory containing the distribution, such as jbosscache-core-3.X.Y. For the sake of this tutorial, I will ref= er to this as ${JBOSSCACHE_HOME}. = - The configuration files are located in - ${JBOSSCACHE_HOME}/etc. You can - modify the behavior of the cache by editing the various configura= tion files. + The configuration files are located in ${JBOSSCACHE_H= OME}/etc. You can modify the behavior of the cache by editing the= various configuration files. = - log4j.xml - Logging output. You can enab= le logging, specify log levels or + log4j.xml: Logging output. You can enabl= e logging, specify log levels or change the name and path to the log file. = - config-samples/total-replication.xml - C= ache configuration file used for this tutorial. + config-samples/total-replication.xml: Ca= che configuration file used for this tutorial. @@ -86,10 +76,10 @@ The GUI is run by: - Changing to the + Changing to the ${JBOSSCACHE_HOME}/tutorial - directory (e.g.,cd ${JBOSSCACHE_HOME}/tutorial) - And then running the ant script (e.g.,ant r= un) + directory (e.g.,cd ${JBOSSCACHE_HOME}/tutorial) + And then running the ant script (e.g.,ant run) = @@ -98,22 +88,19 @@ view of the JVM in the lower pane. - The BeanShell view is preset with the following variables: + The BeanShell view is preset with the following variables: - - cache - - a reference to the org.jboss.cache.Cache interface, used by the GUI instance. + + cache: a reference to the org.j= boss.cache.Cache interface, used by the GUI instance. - - root - - a reference to the root org.jboss.cache.Node instance for the above cache. + + root: a reference to the root o= rg.jboss.cache.Node instance for the above cache. - - transactionManager - - a reference to the registered javax.transaction.= TransactionManager instance. + + transactionManager: a reference to the r= egistered javax.transaction.TransactionManager instance.= - The references made available to the BeanShell window point to th= e same cache instance used by the tree view in + The references made available to the BeanShell window point= to the same cache instance used by the tree view in the GUI above. @@ -128,19 +115,18 @@ = Tutorials - Note that it is recommended that you shut down and restart the GUI f= or each of the following tutorials, to - ensure clean caches every time. + It is recommended that you shut down and restart the= GUI for each of the following tutorials, to + ensure clean caches every time.
Caches and Nodes - For this tutorial, start a single instance of the GUI. In this= tutorial, we will: + For this tutorial, start a single instance of the GUI. In this= tutorial, we will: = - Create nodes under the root node. - Remove nodes under the root node, both individual= ly and recursively. - Add and remove data from nodes. + Create nodes under the root node. + Remove nodes under the root node, both indi= vidually and recursively. + Add and remove data from nodes. - = 1. Set up the Fqns you need. In the BeanShell pane, create = 3 Fqn variables: