[jboss-svn-commits] JBL Code SVN: r34597 - in labs/jbosstm/trunk/ArjunaCore/docs/user_guide/Administration_Guide/DITA: tasks and 1 other directory.
jboss-svn-commits at lists.jboss.org
jboss-svn-commits at lists.jboss.org
Mon Aug 9 02:04:13 EDT 2010
Author: misty at redhat.com
Date: 2010-08-09 02:04:13 -0400 (Mon, 09 Aug 2010)
New Revision: 34597
Added:
labs/jbosstm/trunk/ArjunaCore/docs/user_guide/Administration_Guide/DITA/concepts/#recovery_manager.dita#
labs/jbosstm/trunk/ArjunaCore/docs/user_guide/Administration_Guide/DITA/concepts/failure_recovery_administration.dita
labs/jbosstm/trunk/ArjunaCore/docs/user_guide/Administration_Guide/DITA/concepts/recovery_manager_configuration_files.dita
labs/jbosstm/trunk/ArjunaCore/docs/user_guide/Administration_Guide/DITA/tasks/starting_the_recovery_manager.dita
Log:
Added some more tasks and concepts to do with recovery
Added: labs/jbosstm/trunk/ArjunaCore/docs/user_guide/Administration_Guide/DITA/concepts/#recovery_manager.dita#
===================================================================
--- labs/jbosstm/trunk/ArjunaCore/docs/user_guide/Administration_Guide/DITA/concepts/#recovery_manager.dita# (rev 0)
+++ labs/jbosstm/trunk/ArjunaCore/docs/user_guide/Administration_Guide/DITA/concepts/#recovery_manager.dita# 2010-08-09 06:04:13 UTC (rev 34597)
@@ -0,0 +1,59 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "../dtd/concept.dtd">
+<concept id="arjuna_core_starting_recovery_manager" xml:lang="en-us">
+ <title>Starting the recovery manager</title>
+
+
+<prolog>
+ <author type="creator">JBoss, Inc.</author>
+ <author type="contributor">Misty Stanley-Jones</author>
+ <publisher>Red Hat Engineering Content Services</publisher>
+ <copyright>
+ <copyryear year="2010"/>
+ <copyrholder>JBoss.org</copyrholder>
+ </copyright>
+ <critdates>
+ <created date="2010"/>
+ <revised modified="2010-Aug-06"/>
+ </critdates>
+ <metadata>
+ <keywords>
+ <indexterm>security</indexterm>
+ <indexterm>object store</indexterm>
+ <indexterm>limitations</indexterm>
+ </keywords>
+ <prodinfo>
+ <prodname>ArjunaCore</prodname>
+ <vrmlist>
+ <vrm version="4.12.0"/>
+ </vrmlist>
+ </prodinfo>
+ </metadata>
+ </prolog>
+
+
+ <conbody>
+ <p>
+
+ </p>
+
+ <!-- SAMPLE LINKS
+ <related-links>
+ <link href="../concepts/soapproxy.dita" format="dita" type="concept">
+ <linktext>SOAPProxy</linktext>
+ </link>
+<link href="../tasks/configure_soap.dita" format="dita" type="task">
+ <linktext>Configuring SOAP</linktext>
+ </link>
+
+ </related-links>
+ -->
+
+
+
+
+
+
+ </conbody>
+
+</concept>
Added: labs/jbosstm/trunk/ArjunaCore/docs/user_guide/Administration_Guide/DITA/concepts/failure_recovery_administration.dita
===================================================================
--- labs/jbosstm/trunk/ArjunaCore/docs/user_guide/Administration_Guide/DITA/concepts/failure_recovery_administration.dita (rev 0)
+++ labs/jbosstm/trunk/ArjunaCore/docs/user_guide/Administration_Guide/DITA/concepts/failure_recovery_administration.dita 2010-08-09 06:04:13 UTC (rev 34597)
@@ -0,0 +1,80 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "../dtd/concept.dtd">
+<concept id="arjuna_core_failure_recovery_administration" xml:lang="en-us">
+ <title>Failure recovery administration</title>
+
+
+ <prolog>
+ <author type="creator">JBoss, Inc.</author>
+ <author type="contributor">Misty Stanley-Jones</author>
+ <publisher>Red Hat Engineering Content Services</publisher>
+ <copyright>
+ <copyryear year="2010"/>
+ <copyrholder>JBoss.org</copyrholder>
+ </copyright>
+ <critdates>
+ <created date="2010"/>
+ <revised modified="2010-Aug-06"/>
+ </critdates>
+ <metadata>
+ <keywords>
+ <indexterm>security</indexterm>
+ <indexterm>object store</indexterm>
+ <indexterm>limitations</indexterm>
+ </keywords>
+ <prodinfo>
+ <prodname>ArjunaCore</prodname>
+ <vrmlist>
+ <vrm version="4.12.0"/>
+ </vrmlist>
+ </prodinfo>
+ </metadata>
+ </prolog>
+
+
+ <conbody>
+ <p>
+ The failure recovery subsystem of ArjunaCore will ensure that results of a
+ transaction are applied consistently to all resources affected by the
+ transaction, even if any of the application processes or the machine
+ hosting them crash or lose network connectivity. In the case of machine
+ (system) crash or network failure, the recovery will not take place until
+ the system or network are restored, but the original application does not
+ need to be restarted. –Recovery responsibility is delegated to the Recovery
+ Manager process. Recovery after failure requires that
+ information about the transaction and the resources involved survives the
+ failure and is accessible afterward: this information is held in the
+ ActionStore, which is part of the ObjectStore.
+ </p>
+ <p>
+ If the ObjectStore is destroyed or modified, recovery may not be possible.
+ </p>
+ <p>
+ Until the recovery procedures are complete, resources affected by a
+ transaction that was in progress at the time of the failure may be
+ inaccessible. For database resources, this may be reported as tables or
+ rows held by “in-doubt transactions”. For <apiname>Transactional Objects
+ for Java</apiname> resources, an attempt to activate the Transactional
+ Object (as when trying to get a lock) will fail.
+ </p>
+
+ <!-- SAMPLE LINKS
+ <related-links>
+ <link href="../concepts/soapproxy.dita" format="dita" type="concept">
+ <linktext>SOAPProxy</linktext>
+ </link>
+<link href="../tasks/configure_soap.dita" format="dita" type="task">
+ <linktext>Configuring SOAP</linktext>
+ </link>
+
+ </related-links>
+ -->
+
+
+
+
+
+
+ </conbody>
+
+</concept>
Added: labs/jbosstm/trunk/ArjunaCore/docs/user_guide/Administration_Guide/DITA/concepts/recovery_manager_configuration_files.dita
===================================================================
--- labs/jbosstm/trunk/ArjunaCore/docs/user_guide/Administration_Guide/DITA/concepts/recovery_manager_configuration_files.dita (rev 0)
+++ labs/jbosstm/trunk/ArjunaCore/docs/user_guide/Administration_Guide/DITA/concepts/recovery_manager_configuration_files.dita 2010-08-09 06:04:13 UTC (rev 34597)
@@ -0,0 +1,62 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "../dtd/concept.dtd">
+<concept id="recovery_manager_configuration_files" xml:lang="en-us">
+ <title>Recover manager configuration files</title>
+ <abstract>
+ The recovery manager uses a cascading system of configuration files.
+ </abstract>
+
+ <prolog>
+ <author type="creator">JBoss, Inc.</author>
+ <author type="contributor">Misty Stanley-Jones</author>
+ <publisher>Red Hat Engineering Content Services</publisher>
+ <copyright>
+ <copyryear year="2010"/>
+ <copyrholder>JBoss.org</copyrholder>
+ </copyright>
+ <critdates>
+ <created date="2010"/>
+ <revised modified="2010-Aug-06"/>
+ </critdates>
+ <metadata>
+ <keywords>
+ <indexterm>security</indexterm>
+ <indexterm>object store</indexterm>
+ <indexterm>limitations</indexterm>
+ </keywords>
+ <prodinfo>
+ <prodname>ArjunaCore</prodname>
+ <vrmlist>
+ <vrm version="4.12.0"/>
+ </vrmlist>
+ </prodinfo>
+ </metadata>
+ </prolog>
+
+
+ <conbody>
+ <p>
+ The RecoveryManager reads the properties defined in the following files, in order:
+ </p>
+ <ol>
+ <li><filepath>arjuna.properties</filepath></li>
+ <li><filepath>RecoveryManager.properties</filepath>, from the same directory as the <filepath>arjuna properties</filepath> file.</li>
+ </ol>
+ <p>
+ An entry for a property in the
+ <filepath>RecoveryManager.properties</filepath> file will override an entry
+ for the same property in the main TransactionService properties file. Most
+ of the entries are specific to the Recovery Manager.
+ </p>
+ <p>
+ A default version of <filepath>RecoveryManager.properties</filepath> is
+ supplied with the distribution. – This can be used without modification,
+ except possibly the debug tracing fields.
+ <!-- Glue
+ The rest of this section discusses the
+ issues relevant in setting the properties to other values (in the
+ order of their appearance in the default version of the file)
+ -->
+ </p>
+ </conbody>
+</concept>
Added: labs/jbosstm/trunk/ArjunaCore/docs/user_guide/Administration_Guide/DITA/tasks/starting_the_recovery_manager.dita
===================================================================
--- labs/jbosstm/trunk/ArjunaCore/docs/user_guide/Administration_Guide/DITA/tasks/starting_the_recovery_manager.dita (rev 0)
+++ labs/jbosstm/trunk/ArjunaCore/docs/user_guide/Administration_Guide/DITA/tasks/starting_the_recovery_manager.dita 2010-08-09 06:04:13 UTC (rev 34597)
@@ -0,0 +1,116 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<!-- This document was created with Syntext Serna Free. -->
+<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd" []>
+<task id="arjuna_core_starting_the_recovery_manager" xml:lang="en-us">
+
+ <title>Starting the recovery manager</title>
+
+ <prolog>
+ <author type="creator">JBoss, Inc.</author>
+ <author type="contributor">Misty Stanley-Jones</author>
+ <publisher>Red Hat Engineering Content Services</publisher>
+ <copyright>
+ <copyryear year="2010"/>
+ <copyrholder>JBoss.org</copyrholder>
+ </copyright>
+ <critdates>
+ <created date="2010"/>
+ <revised modified="2010-Aug-06"/>
+ </critdates>
+ <metadata>
+ <keywords>
+ <indexterm>Search</indexterm>
+ <indexterm>Terms</indexterm>
+ <indexterm>Here</indexterm>
+ </keywords>
+ <prodinfo>
+ <prodname>ArjunaCore</prodname>
+ <vrmlist>
+ <vrm version="4.12.0"/>
+ </vrmlist>
+ </prodinfo>
+ </metadata>
+ </prolog>
+
+ <taskbody>
+
+ <context>
+ <p>
+ The failure recovery subsystem of ArjunaCore requires that the
+ stand-alone Recovery Manager process be running for each ObjectStore
+ (typically one for each node on the network that is running ArjunaCore
+ applications). The RecoveryManager file is located in the arjunacore
+ jar file within the package
+ <codeph>com.arjuna.ats.arjuna.recovery.RecoveryManager</codeph>.
+ </p>
+
+ </context>
+
+ <steps>
+
+ <step>
+ <cmd>
+ To start the Recovery Manager, issue the command
+ <p><cmdname>java com.arjuna.ats.arjuna.recovery.RecoveryManager</cmdname>.</p>
+ </cmd>
+ </step>
+ <step>
+ <cmd>
+ To test whether the Recovery Manager is able to start, without starting it, append the <codeph>-test</codeph> flag.
+ </cmd>
+ <info>
+ <codeph>java com.arjuna.ats.arjuna.recovery.RecoveryManager -test</codeph>
+ </info>
+ </step>
+ </steps>
+
+ <result>
+ <p>
+ The recovery manager should now be running.
+ </p>
+ </result>
+
+ </taskbody>
+
+ <!-- LOTS OF SAMPLE RELATED LINKS
+ <related-links>
+
+ <link href="../concepts/database.dita" format="dita" type="concept">
+ <linktext>Database and Message Store</linktext>
+ </link>
+
+ <link href="../concepts/messagestore.dita" format="dita" type="concept">
+ <linktext>Message Store</linktext>
+ </link>
+
+ <link href="../concepts/registry.dita" format="dita" type="concept">
+ <linktext>Service Registry</linktext>
+ </link>
+
+ <link href="../concepts/databaseschema.dita" format="dita" type="concept">
+ <linktext>Database Schema</linktext>
+ </link>
+
+ <link href="../concepts/persistencelayer.dita" format="dita" type="concept">
+ <linktext>Persistence Layer</linktext>
+ </link>
+
+ <link href="../concepts/serviceregistry.dita" format="dita" type="concept">
+ <linktext>Service Registry</linktext>
+ </link>
+
+ <link href="../concepts/sql.dita" format="dita" type="concept">
+ <linktext>Structured Query Language</linktext>
+ </link>
+
+ <link href="../references/databasesettings.dita" format="dita" type="reference">
+ <linktext>Database Settings</linktext>
+ </link>
+
+ <link href="../tasks/extensions.dita" format="dita" type="task">
+ <linktext>Configuring Extensions</linktext>
+ </link>
+
+ </related-links>
+ -->
+</task>
More information about the jboss-svn-commits
mailing list