Persistent-store

From Resin 3.0

(Difference between revisions)
Jump to: navigation, search
 
Line 1: Line 1:
 
[[Category:Configuration]] [[Category:Cluster]]
 
[[Category:Configuration]] [[Category:Cluster]]
 +
 +
The <persistent-store> configures persistent storage for distributed objects like sessions.  The session-config must have a <use-persistent-store/> to use the store.
  
 
{|
 
{|
Line 5: Line 7:
 
|-
 
|-
 
|type||file, jdbc, or cluster||required
 
|type||file, jdbc, or cluster||required
|+
+
|-
 
||init|persistent-store specific configuration||
 
||init|persistent-store specific configuration||
 
|}
 
|}
Line 40: Line 42:
 
|triplicate||stores sessions on two backup servers||true (3.0.20 and later)
 
|triplicate||stores sessions on two backup servers||true (3.0.20 and later)
 
|}
 
|}
 +
 +
= Example =
 +
 +
<resin xmlns="http://caucho.com/ns/resin">
 +
 +
<server>
 +
  <cluster>
 +
    <srun server-id="a" port="6810"/>
 +
    <srun server-id="b" port="6811"/>
 +
    <srun server-id="c" port="6812"/>
 +
  </cluster>
 +
 +
  <persistent-store type="cluster">
 +
    <init path="file:/tmp/caucho/qa/session"
 +
            triplicate="true"/>
 +
  </persistent-store>
 +
 +
  <web-app-default>
 +
    <session-config use-persistent-store="true"/>
 +
  </web-app-default>
 +
 +
  <host id=''>
 +
    <web-app id='/'>
 +
    </web-app>
 +
  </host>
 +
</server>
 +
</resin>

Revision as of 16:31, 6 June 2006


The <persistent-store> configures persistent storage for distributed objects like sessions. The session-config must have a <use-persistent-store/> to use the store.

tag description default
type file, jdbc, or cluster required
init|persistent-store specific configuration

Contents

type="file"

The file store is suitable only for single-server configurations which want to persist the session start over server restarts. It is useful for development servers, letting you keep sessions across web-app restarts.

tag description default
path the path to the persistence directory required

type="jdbc"

The jdbc store uses a database server to persist the sessions. Requires Resin Professional.

tag description default
data-source a configured <[database]> required

type="cluster"

Uses TCP connections to replicate sessions across the cluster. Requires Resin Professional. In 3.0.20 and later, the sessions are backed up onto two servers, meaning any two servers can go down without loss of session information.

tag description default
path a directory where the sessions will be stored required
triplicate stores sessions on two backup servers true (3.0.20 and later)

Example

<resin xmlns="http://caucho.com/ns/resin">

<server>
  <cluster>
    <srun server-id="a" port="6810"/>
    <srun server-id="b" port="6811"/>
    <srun server-id="c" port="6812"/>
  </cluster>

  <persistent-store type="cluster">
    <init path="file:/tmp/caucho/qa/session"
           triplicate="true"/>
  </persistent-store>

  <web-app-default>
    <session-config use-persistent-store="true"/>
  </web-app-default>

  <host id=>
    <web-app id='/'>
    </web-app>
  </host>
</server>
</resin>
Personal tools