<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<body link="#355491" alink="#4262a1" vlink="#355491" style="background: #e2e2e2; margin: 0; padding: 20px;">
<div>
<table cellpadding="0" bgcolor="#FFFFFF" border="0" cellspacing="0" style="border: 1px solid #dadada; margin-bottom: 30px; width: 100%; -moz-border-radius: 6px; -webkit-border-radius: 6px;">
<tbody>
<tr>
<td>
<table border="0" cellpadding="0" cellspacing="0" bgcolor="#FFFFFF" style="border: solid 2px #ccc; background: #dadada; width: 100%; -moz-border-radius: 6px; -webkit-border-radius: 6px;">
<tbody>
<tr>
<td bgcolor="#000000" valign="middle" height="58px" style="border-bottom: 1px solid #ccc; padding: 20px; -moz-border-radius-topleft: 3px; -moz-border-radius-topright: 3px; -webkit-border-top-right-radius: 5px; -webkit-border-top-left-radius: 5px;">
<h1 style="color: #333333; font: bold 22px Arial, Helvetica, sans-serif; margin: 0; display: block !important;">
<!-- To have a header image/logo replace the name below with your img tag -->
<!-- Email clients will render the images when the message is read so any image -->
<!-- must be made available on a public server, so that all recipients can load the image. -->
<a href="http://community.jboss.org/index.jspa" style="text-decoration: none; color: #E1E1E1">JBoss Community</a></h1>
</td>
</tr>
<tr>
<td bgcolor="#FFFFFF" style="font: normal 12px Arial, Helvetica, sans-serif; color:#333333; padding: 20px; -moz-border-radius-bottomleft: 4px; -moz-border-radius-bottomright: 4px; -webkit-border-bottom-right-radius: 5px; -webkit-border-bottom-left-radius: 5px;"><h3 style="margin: 10px 0 5px; font-size: 17px; font-weight: normal;">
JBossCache
</h3>
<span style="margin-bottom: 10px;">
modified by <a href="http://community.jboss.org/people/manik.surtani%40jboss.com">Manik Surtani</a> in <i>JBoss Cache</i> - <a href="http://community.jboss.org/docs/DOC-10242">View the full document</a>
</span>
<hr style="margin: 20px 0; border: none; background-color: #dadada; height: 1px;">
<div class="jive-rendered-content"><blockquote class="jive-quote"><span style="font-size: 14pt;"><span style="color: #ff0000;"><strong>NOTE:</strong></span> If you use JBoss Cache, you really should consider migrating to <a class="jive-link-external-small" href="http://ww.infinispan.org">Infinispan</a>, which supercedes JBoss Cache.  It does all JBoss Cache does, and much, much more, is more robust, performs better, and has a far more active community.</span><br/></blockquote><h2><span>What is JBoss Cache</span></h2><h5>JBoss Cache consists of two <em>editions</em></h5><ul><li type="ul"><p><strong>core</strong> - a replicated, distributed, transactional tree-structured cache</p></li><li type="ul"><p><strong>pojo</strong> (formerly JBossCacheAop) - a layer on top of the core cache, providing you with an API-less feature set and giving you a more 'pojo' feel to your application with minimal intrusion.</p></li></ul><h5>Upcoming editions</h5><ul><li><strong>searchable</strong> - this edition bolts on a search indexer to the cache, allowing you to query the cache using efficient Lucene queries.  See the <a class="jive-link-wiki-small" href="http://community.jboss.org/docs/DOC-10286">JBoss Cache Searchable</a> wiki page for more info.</li></ul><h2><span>Versions</span></h2><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>The current stable release, recommended for general use, is <strong>JBoss Cache 3.2.2.GA <em>"Malagueta"</em></strong>.  Note that this is <strong>not</strong> binary-compatible with <strong>JBoss Cache 1.x</strong> and if you need that level of binary compatibility the recommended version is <strong>JBoss Cache 1.4.1 <em>"Cayenne"</em></strong>.  Naga <strong><em>is</em></strong> compatible with <strong>JBoss Cache 2.x</strong> though.</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><h2><span>Learning about JBoss Cache</span></h2><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>A <a class="jive-link-wiki-small" href="http://community.jboss.org/docs/DOC-12843"><span class="active_link">tutorial</span> and <span class="active_link">FAQ</span></a> for both core and pojo editions are provided, along with the <a class="jive-link-wiki-small" href="http://community.jboss.org/docs/DOC-12843">formal <span class="active_link">user guide</span></a>- which should be considered <strong><em>required </em></strong>reading, <em><strong>before</strong></em> asking questions on the users' forum!  <span> :) </span></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>JBoss Cache can be used either inside JBoss, with a different application server, or as a standalone product.</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Here is <a class="jive-link-wiki-small" href="http://community.jboss.org/docs/DOC-12843">official <span class="active_link">JBossCache</span> main documentation page</a>. This wiki page will serve for some additional materials.</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><em>Want to help us translate JBoss Cache documentation to a language of your choice?  See the <a class="jive-link-wiki-small" href="http://community.jboss.org/docs/DOC-10261">JBossCacheDocI18n</a> page!</em></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><h2><span> Troubleshooting</span></h2><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Here is the page for some tips on <a class="jive-link-wiki-small" href="http://community.jboss.org/docs/DOC-10288">troubleshooting JBoss Cache</a>.</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><h2><span>More information</span></h2><ul><li type="ul"><p><strong>Migrating from JBoss Cache 1.x.x to 2.x.x?</strong>  Then read <a class="jive-link-wiki-small" href="http://community.jboss.org/docs/DOC-10246">JBossCache200Migration</a></p></li><li type="ul"><p><strong>JBossCache on J2EE servers</strong>:</p><ul><li type="ul"><p>JBoss Cache 1.4.x is always available and runs transparently on JBoss AS 4.x.</p><ul><li type="ul"><p>JBoss Cache 1.4.x has been tested on J2SE 1.4 and Java SE 5.0.  While it <em>may</em> work on Java SE 6, this hasn't been extensively tested.</p></li></ul></li><li type="ul"><p>JBoss Cache 2.x is always available and runs transparently on the upcoming JBoss AS 5.x.</p><ul><li type="ul"><p>JBoss Cache 2.x does not have support for J2SE 1.4 and <em>requires</em> either Java SE 5.0 or Java SE 6, both of which are extensively tested with JBoss Cache 2.x.</p></li><li type="ul"><p>For information on running JBoss Cache 2.x under J2SE 1.4, see this wiki page: <a class="jive-link-wiki-small" href="http://community.jboss.org/docs/DOC-10263">JBossCacheHabaneroJava1.4</a></p></li></ul></li><li type="ul"><p><a class="jive-link-wiki-small" href="http://community.jboss.org/docs/DOC-10254">JBossCacheAsCompatibility</a> - a HOWTO for running JBoss Cache 2.x under JBoss AS 4.x safely.</p></li><li type="ul"><p><a class="jive-link-wiki-small" href="http://community.jboss.org/docs/DOC-10252">JBossCacheAndWebLogic</a> - for a quick HOWTO on running JBoss Cache under BEA WebLogic 8.1, utilising a startup and shutdown class to initialize the cluster-wide caching service.</p></li><li type="ul"><p><a class="jive-link-wiki-small" href="http://community.jboss.org/docs/DOC-10250">JBossCacheAndWAS</a> For a quick overview on how to run JBossCache in WebSphere</p></li><li type="ul"><p><a class="jive-link-external-small" href="http://wiki.jboss.org/wiki/Wiki.jsp?page=JBossCacheAndWAS_6.x">JBossCacheAndWAS_6.x</a> - for a quick HOWTO on running JBoss Cache under WebSphere 6.x series</p></li></ul></li><li type="ul"><p><strong>Hibernate integration:</strong>  See <a class="jive-link-wiki-small" href="http://community.jboss.org/docs/DOC-10265">JBossCacheHibernate</a> for information and tips on using JBossCache as a 2nd-level cache in <a class="jive-link-external-small" href="http://www.hibernate.org">Hibernate</a></p></li><li type="ul"><p><strong>Building JBossCache:</strong>  Check out the README files in the src distribution or SVN checkout.</p></li><li type="ul"><p><strong>MVCC:</strong> With JBoss Cache 3 "<em>Naga</em>", we have deprecated <strong>optimistic</strong> and <strong>pessimistic</strong> locking in favour of <strong>MVCC</strong>.  Read all about it <a class="jive-link-external-small" href="http://jbosscache.blogspot.com/2008/07/mvcc-has-landed.html">here</a>.</p></li><li type="ul"><p><strong>Buddy Replication:</strong> Have trouble replicating a lot of state to many machines in a cluster (whether using JBoss Cache, or other techs that use JBoss Cache such as http state replication)?  Read <a class="jive-link-wiki-small" href="http://community.jboss.org/docs/DOC-10255">JBossCacheBuddyReplication</a> and <a class="jive-link-wiki-small" href="http://community.jboss.org/docs/DOC-10256">JBossCacheBuddyReplicationDesign</a>!</p></li><li type="ul"><p><strong>JDBC-based cache loader:</strong> see <a class="jive-link-wiki-small" href="http://community.jboss.org/docs/DOC-10864">JDBCCacheLoader</a> for information and tips on how to configure JDBCCacheLoader with various DBMS.</p></li><li type="ul"><p><strong>Accessing and Monitoring JBoss Cache using JMX</strong>:  <a class="jive-link-wiki-small" href="http://community.jboss.org/docs/DOC-10270">JBossCacheMBeans</a> describes how to access JBoss Cache using its JMX MBeans.  With JBoss Cache 1.3.0, this is also possible when running in a standalone (e.g., non-server) JDK 5.0 environment.</p></li><li type="ul"><p><strong>Clustering patterns library</strong>: <a class="jive-link-wiki-small" href="http://community.jboss.org/docs/DOC-10294">The clustering patterns library</a> contains configuration strategies for high availability using JBoss Cache.</p></li><li type="ul"><p><strong>Running JBoss Cache with the JGroups Multiplexer</strong> : See <a class="jive-link-wiki-small" href="http://community.jboss.org/docs/DOC-10274">JBossCacheMultiplexer</a></p></li><li type="ul"><strong>Monitoring</strong>: See <a class="jive-link-wiki-small" href="http://community.jboss.org/docs/DOC-12832">Jopr - JBossCache plugin</a> for monitoring JBoss Cache instances within JBoss AS.</li><li type="ul"><strong>Groovy</strong>: Want to use JBoss Cache with Groovy and Grails?  See this <a class="jive-link-external-small" href="http://grails.org/JBossCache+Plugin">plugin</a>.</li></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><h2><span> Upgrading and Compatibility Information</span></h2><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><h3><span> JBoss Cache developer's page</span></h3><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>For <strong>Subversion</strong> information, tags and branches, and tips on developing and debugging JBoss Cache, see <a class="jive-link-external-small" href="https://www.jboss.org/community/docs/DOC-10259">JBossCacheDevelopment</a>.</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><h3><span> JBoss Cache & JGroups version compatibility</span></h3><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>See <a class="jive-link-external-small" href="http://labs.jboss.com/portal/jbosscache/compatibility/index.html">http://labs.jboss.com/portal/jbosscache/compatibility/index.html</a> for details</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><h3><span> JBoss Cache & JDK Requirements</span></h3><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><table><tbody><tr><th style=";"><p>JBoss Cache Version</p></th><th style=";"><p>JDK Compatibility</p></th></tr><tr><td style=";"><p>1.2, 1.2.1, 1.2.2, 1.2.3</p></td><td style=";"><p>J2SE 1.3, J2SE 1.4, JavaSE 5.0</p></td></tr><tr><td style=";"><p>1.2.4.X</p></td><td style=";"><p>J2SE 1.4, JavaSE 5.0</p></td></tr><tr><td style=";"><p>>= 1.3.0</p></td><td style=";"><p>Runs with J2SE 1.4 and JavaSE 5.0. Needs JavaSE 5.0 to build.</p></td></tr><tr><td style=";"><p>>= 2.0.0</p></td><td style=";"><p>J2SE 5.0, J2SE 6</p></td></tr></tbody></table><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><h1>Other editions</h1><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Aside from JBoss Cache - Core Edition, we also ship:</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><ul><li><a class="jive-link-wiki-small" href="http://community.jboss.org/docs/DOC-11611">JBoss Cache - POJO Edition</a></li><li><a class="jive-link-wiki-small" href="http://community.jboss.org/docs/DOC-10286">JBoss Cache - Searchable Edition</a></li></ul></div>
<div style="background-color: #f4f4f4; padding: 10px; margin-top: 20px;">
<p style="margin: 0;">Comment by <a href="http://community.jboss.org/docs/DOC-10242">going to Community</a></p>
<p style="margin: 0;">Create a new document in JBoss Cache at <a href="http://community.jboss.org/choose-container!input.jspa?contentType=102&containerType=14&container=2052">Community</a></p>
</div></td>
</tr>
</tbody>
</table>
</td>
</tr>
</tbody>
</table>
</div>
</body>
</html>