[jboss-svn-commits] JBL Code SVN: r36904 - in labs/jbosstm/trunk/ArjunaJTA: docs and 3 other directories.
jboss-svn-commits at lists.jboss.org
jboss-svn-commits at lists.jboss.org
Wed Apr 13 09:53:29 EDT 2011
Author: tomjenkinson
Date: 2011-04-13 09:53:29 -0400 (Wed, 13 Apr 2011)
New Revision: 36904
Added:
labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/
labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/JBossJTA_Administration_Guide.ent
labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/JBossJTA_Administration_Guide.xml
labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/JBossJTA_Runtime_Information.xml
Removed:
labs/jbosstm/trunk/ArjunaJTA/docs/ArjunaTA_Installation_And_Administration_Guide/
labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Additional_JAR_Requirements.xml
labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/ArjunaCore_Runtime_Information.xml
labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/ArjunaTA_Installation_And_Administration_Guide.ent
labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/ArjunaTA_Installation_And_Administration_Guide.xml
labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Logging.xml
labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Operating_System_Services.xml
labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Preparing_Your_System.xml
labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Setting_Properties.xml
labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/publican-maven.cfg
Modified:
labs/jbosstm/trunk/ArjunaJTA/build.xml
labs/jbosstm/trunk/ArjunaJTA/docs/ArjunaTA_Development_Guide/en-US/Book_Info.xml
labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Author_Group.xml
labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Book_Info.xml
labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Chapter.xml
labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Errors_And_Exceptions.xml
labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Failure_Recovery_Administration.xml
labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Introduction.xml
labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/ObjectStore_Management.xml
labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Preface.xml
labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Revision_History.xml
labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Selecting_The_JTA_Implementation.xml
labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Starting_And_Stopping_Transaction_Manager.xml
labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/publican.cfg
Log:
JBTM-820 separated the administration and installation guides
Modified: labs/jbosstm/trunk/ArjunaJTA/build.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaJTA/build.xml 2011-04-13 13:34:33 UTC (rev 36903)
+++ labs/jbosstm/trunk/ArjunaJTA/build.xml 2011-04-13 13:53:29 UTC (rev 36904)
@@ -54,11 +54,21 @@
<if>
<istrue value="${publican}" />
<then>
- <exec dir="docs/ArjunaTA_Installation_And_Administration_Guide" executable="publican">
+ <exec dir="docs/administration_guide" executable="publican">
<arg value="build"/>
<arg value="--langs=en-US"/>
<arg value="--formats=pdf,html"/>
</exec>
+ <exec dir="docs/installation_guide" executable="publican">
+ <arg value="build"/>
+ <arg value="--langs=en-US"/>
+ <arg value="--formats=pdf,html"/>
+ </exec>
+ <exec dir="docs/quick_start" executable="publican">
+ <arg value="build"/>
+ <arg value="--langs=en-US"/>
+ <arg value="--formats=pdf,html"/>
+ </exec>
<exec dir="docs/ArjunaTA_Development_Guide" executable="publican">
<arg value="build"/>
<arg value="--langs=en-US"/>
@@ -103,4 +113,4 @@
</target>
-</project>
\ No newline at end of file
+</project>
Modified: labs/jbosstm/trunk/ArjunaJTA/docs/ArjunaTA_Development_Guide/en-US/Book_Info.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaJTA/docs/ArjunaTA_Development_Guide/en-US/Book_Info.xml 2011-04-13 13:34:33 UTC (rev 36903)
+++ labs/jbosstm/trunk/ArjunaJTA/docs/ArjunaTA_Development_Guide/en-US/Book_Info.xml 2011-04-13 13:53:29 UTC (rev 36904)
@@ -7,7 +7,7 @@
<title>ArjunaTA Development Guide</title>
<subtitle>Development reference guide for the ArjunaTA implementation of the JTA API</subtitle>
<productname>ArjunaTA</productname>
- <productnumber>4.14.0</productnumber>
+ <productnumber>4.15.0</productnumber>
<edition>0</edition>
<pubsnumber>0</pubsnumber>
<abstract>
Deleted: labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Additional_JAR_Requirements.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaJTA/docs/ArjunaTA_Installation_And_Administration_Guide/en-US/Additional_JAR_Requirements.xml 2011-04-13 13:08:25 UTC (rev 36902)
+++ labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Additional_JAR_Requirements.xml 2011-04-13 13:53:29 UTC (rev 36904)
@@ -1,12 +0,0 @@
-<?xml version='1.0' encoding='utf-8' ?>
-<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "ArjunaCore_Installation_Guide.ent">
-%BOOK_ENTITIES;
-]>
-<chapter>
- <title>Additional JAR Requirements</title>
- <para>
- To use all of the facilities available within ArjunaCore, you need to add all of the JAR files contained in the <filename>lib/</filename> directory of the distribution to the <varname>CLASSPATH</varname>.
- </para>
-</chapter>
-
Deleted: labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/ArjunaCore_Runtime_Information.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaJTA/docs/ArjunaTA_Installation_And_Administration_Guide/en-US/ArjunaCore_Runtime_Information.xml 2011-04-13 13:08:25 UTC (rev 36902)
+++ labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/ArjunaCore_Runtime_Information.xml 2011-04-13 13:53:29 UTC (rev 36904)
@@ -1,17 +0,0 @@
-<?xml version='1.0' encoding='utf-8' ?>
-<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "ArjunaCore_Administration_Guide.ent">
-%BOOK_ENTITIES;
-]>
-<chapter>
- <title>ArjunaCore Runtime Information</title>
- <para>
- Compile-time configuration information is available via class
- <classname>com.arjuna.common.util.ConfigurationInfo</classname>. Runtime configuration is embodied in the various
- <!-- Should this be <classname><replaceable>name</replaceable>EnvironmentBean</classname> classes?
- --><name>EnvironmentBean classes, see the configuration section of the user guide. These beans have
- corresponding <!--<interfacename>MBean</interfacename>? -->MBean interfaces and may be linked to JMX for remote
- inspection of the configuration if desired.
- </para>
-</chapter>
-
Deleted: labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/ArjunaTA_Installation_And_Administration_Guide.ent
===================================================================
--- labs/jbosstm/trunk/ArjunaJTA/docs/ArjunaTA_Installation_And_Administration_Guide/en-US/ArjunaTA_Installation_And_Administration_Guide.ent 2011-04-13 13:08:25 UTC (rev 36902)
+++ labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/ArjunaTA_Installation_And_Administration_Guide.ent 2011-04-13 13:53:29 UTC (rev 36904)
@@ -1,4 +0,0 @@
-<!ENTITY PRODUCT "ArjunaTA">
-<!ENTITY BOOKID "ArjunaTA_Installation_And_Administration_Guide">
-<!ENTITY YEAR "2010">
-<!ENTITY HOLDER "JBoss.org">
Deleted: labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/ArjunaTA_Installation_And_Administration_Guide.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaJTA/docs/ArjunaTA_Installation_And_Administration_Guide/en-US/ArjunaTA_Installation_And_Administration_Guide.xml 2011-04-13 13:08:25 UTC (rev 36902)
+++ labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/ArjunaTA_Installation_And_Administration_Guide.xml 2011-04-13 13:53:29 UTC (rev 36904)
@@ -1,32 +0,0 @@
-<?xml version='1.0' encoding='utf-8' ?>
-<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "ArjunaTA_Installation_And_Administration_Guide.ent">
-%BOOK_ENTITIES;
-]>
-<book>
- <xi:include href="Book_Info.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="Preface.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <part>
- <title>Installation</title>
- <xi:include href="Preparing_Your_System.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="Operating_System_Services.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="Logging.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="ObjectStore_Management.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="Additional_JAR_Requirements.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="Setting_Properties.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- </part>
- <part>
- <title>Administration</title>
- <!-- <xi:include href="Chapter.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />-->
- <xi:include href="Introduction.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="Starting_And_Stopping_Transaction_Manager.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="ObjectStore_Management.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="ArjunaCore_Runtime_Information.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="Failure_Recovery_Administration.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="Errors_And_Exceptions.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="Selecting_The_JTA_Implementation.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-
- </part>
- <xi:include href="Revision_History.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <index />
-</book>
Modified: labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Author_Group.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaJTA/docs/ArjunaTA_Installation_And_Administration_Guide/en-US/Author_Group.xml 2011-04-13 13:08:25 UTC (rev 36902)
+++ labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Author_Group.xml 2011-04-13 13:53:29 UTC (rev 36904)
@@ -1,6 +1,6 @@
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE authorgroup PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "ArjunaCore_Administration_Guide.ent">
+<!ENTITY % BOOK_ENTITIES SYSTEM "JBossJTA_Administration_Guide.ent">
%BOOK_ENTITIES;
]>
<authorgroup>
Modified: labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Book_Info.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaJTA/docs/ArjunaTA_Installation_And_Administration_Guide/en-US/Book_Info.xml 2011-04-13 13:08:25 UTC (rev 36902)
+++ labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Book_Info.xml 2011-04-13 13:53:29 UTC (rev 36904)
@@ -1,29 +1,26 @@
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE bookinfo PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "ArjunaCore_Administration_Guide.ent">
+<!ENTITY % BOOK_ENTITIES SYSTEM "JBossJTA_Administration_Guide.ent">
%BOOK_ENTITIES;
]>
-<bookinfo id="book-ArjunaTA_Installation_And_Administration_Guide">
- <title>ArjunaTA Installation And Administration Guide</title>
- <subtitle>Installation and Administration of the ArjunaTA toolkit, which implements the JTA API in the ArjunaCore
- Transaction Service</subtitle>
- <productname>ArjunaTA</productname>
- <productnumber>4.14.0</productnumber>
- <edition>1</edition>
- <pubsnumber>1</pubsnumber>
- <!--
- <abstract> <para> A short overview and summary of the book's subject and purpose, traditionally no more than
- one paragraph long. Note: the abstract will appear in the front matter of your book and will also be placed in
- the description field of the book's RPM spec file. </para> </abstract>
- -->
- <corpauthor>
- <inlinemediaobject>
- <imageobject>
- <imagedata fileref="Common_Content/images/title_logo.svg" format="SVG" />
- </imageobject>
- </inlinemediaobject>
- </corpauthor>
- <xi:include href="Common_Content/Legal_Notice.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="Author_Group.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+<bookinfo id="book-JBossJTA_Administration_Guide">
+ <title>JBossJTA Administration Guide</title>
+ <subtitle>Administration of the &PRODUCT; toolkit, which implements the JTA API in the &PRODUCT;
+ Transaction Service</subtitle>
+ <productname>&PRODUCT;</productname>
+ <productnumber>4.15.0</productnumber>
+ <edition>1</edition>
+ <pubsnumber>1</pubsnumber>
+ <!-- <abstract> <para> A short overview and summary of the book's subject and purpose, traditionally no more than one paragraph long. Note: the abstract
+ will appear in the front matter of your book and will also be placed in the description field of the book's RPM spec file. </para> </abstract> -->
+ <corpauthor>
+ <inlinemediaobject>
+ <imageobject>
+ <imagedata fileref="Common_Content/images/title_logo.svg" format="SVG" />
+ </imageobject>
+ </inlinemediaobject>
+ </corpauthor>
+ <xi:include href="Common_Content/Legal_Notice.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Author_Group.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
</bookinfo>
Modified: labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Chapter.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaJTA/docs/ArjunaTA_Installation_And_Administration_Guide/en-US/Chapter.xml 2011-04-13 13:08:25 UTC (rev 36902)
+++ labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Chapter.xml 2011-04-13 13:53:29 UTC (rev 36904)
@@ -1,6 +1,6 @@
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "ArjunaCore_Administration_Guide.ent">
+<!ENTITY % BOOK_ENTITIES SYSTEM "JBossJTA_Administration_Guide.ent">
%BOOK_ENTITIES;
]>
<chapter>
Modified: labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Errors_And_Exceptions.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaJTA/docs/ArjunaTA_Installation_And_Administration_Guide/en-US/Errors_And_Exceptions.xml 2011-04-13 13:08:25 UTC (rev 36902)
+++ labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Errors_And_Exceptions.xml 2011-04-13 13:53:29 UTC (rev 36904)
@@ -1,6 +1,6 @@
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "ArjunaTA_Administration_Guide.ent">
+<!ENTITY % BOOK_ENTITIES SYSTEM "JBossJTA_Administration_Guide.ent">
%BOOK_ENTITIES;
]>
<chapter>
@@ -17,7 +17,7 @@
<listitem>
<para>
The application has run out of memory, and has thrown an <systemitem>OutOfMemoryError</systemitem>
- exception. <application>ArjunaTA</application> has attempted to do some cleanup, by running the garbage
+ exception. <application>&PRODUCT;</application> has attempted to do some cleanup, by running the garbage
collector, before re-throwing the exception. This is probably a transient problem and retrying the invocation
should succeed.
</para>
Modified: labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Failure_Recovery_Administration.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaJTA/docs/ArjunaTA_Installation_And_Administration_Guide/en-US/Failure_Recovery_Administration.xml 2011-04-13 13:08:25 UTC (rev 36902)
+++ labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Failure_Recovery_Administration.xml 2011-04-13 13:53:29 UTC (rev 36904)
@@ -1,13 +1,13 @@
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "ArjunaTA_Administration_Guide.ent">
+<!ENTITY % BOOK_ENTITIES SYSTEM "JBossJTA_Administration_Guide.ent">
%BOOK_ENTITIES;
]>
<chapter>
<title>Failure Recovery Administration</title>
<para>
- The failure recovery subsystem of ArjunaTA will ensure that results of a transaction are applied consistently to
+ The failure recovery subsystem of &PRODUCT; 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
@@ -32,8 +32,8 @@
<title>The Recovery Manager</title>
<para>
- The failure recovery subsystem of ArjunaTA requires that the stand-alone Recovery Manager process be running for
- each <systemitem>ObjectStore</systemitem> (typically one for each node on the network that is running ArjunaTA
+ The failure recovery subsystem of &PRODUCT; requires that the stand-alone Recovery Manager process be running for
+ each <systemitem>ObjectStore</systemitem> (typically one for each node on the network that is running &PRODUCT;
applications). The <filename>RecoveryManager</filename> file is located in the arjunacore JAR file within the
package <package>com.arjuna.ats.arjuna.recovery.RecoveryManager</package>. To start the Recovery Manager issue the
following command:
@@ -145,7 +145,7 @@
</para>
<note>
<para>
- In previous versions of <application>ArjunaTA</application>, there was no contact mechanism, and the back-off
+ In previous versions of <application>&PRODUCT;</application>, there was no contact mechanism, and the back-off
period needed to be long enough to avoid catching transactions in flight at all. From 3.0, there is no such
risk.
</para>
@@ -153,7 +153,7 @@
<para>
Two recovery modules, implementations of the
<interfacename>com.arjuna.ats.arjuna.recovery.RecoveryModule</interfacename> interface, are supplied with
- <application>ArjunaTA</application>. These modules support various aspects of transaction recovery, including JDBC
+ <application>&PRODUCT;</application>. These modules support various aspects of transaction recovery, including JDBC
recovery. It is possible for advanced users to create their own recovery modules and register them with the
Recovery Manager. The recovery modules are registered with the RecoveryManager using
<methodname>RecoveryEnvironmentBean.recoveryModuleClassNames</methodname>. These will be invoked on each pass of the
@@ -191,12 +191,12 @@
<listitem>
<para>
One TransactionStatusManager item is created by every application process that uses
- <application>ArjunaTA</application>. It contains the information that allows the RecoveryManager to
+ <application>&PRODUCT;</application>. It contains the information that allows the RecoveryManager to
determine if the process that initiated the transaction is still alive, and its status. The expiry time for
these items is set by the property
<property>com.arjuna.ats.arjuna.recovery.transactionStatusManagerExpiryTime</property>, expressed in
hours. The default is 12, and 0 (zero) means never to expire.The expiry time should be greater than the
- lifetime of any single processes using <application>ArjunaTA</application>.
+ lifetime of any single processes using <application>&PRODUCT;</application>.
</para>
</listitem>
</varlistentry>
Modified: labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Introduction.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaJTA/docs/ArjunaTA_Installation_And_Administration_Guide/en-US/Introduction.xml 2011-04-13 13:08:25 UTC (rev 36902)
+++ labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Introduction.xml 2011-04-13 13:53:29 UTC (rev 36904)
@@ -1,21 +1,21 @@
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "ArjunaTA_Administration_Guide.ent">
+<!ENTITY % BOOK_ENTITIES SYSTEM "JBossJTA_Administration_Guide.ent">
%BOOK_ENTITIES;
]>
<chapter>
<title>Introduction</title>
<para>
Apart from ensuring that the run-time system is executing normally, there is little continuous administration needed
- for the ArjunaTA software. Refer to <xref linkend="important_points_for_administrators" /> for some specific
+ for the &PRODUCT; software. Refer to <xref linkend="important_points_for_administrators" /> for some specific
concerns.
</para>
<itemizedlist id="important_points_for_administrators">
<title>Important Points for Administrators</title>
<listitem>
<para>
- The present implementation of the ArjunaTA system provides no security or protection for data. The objects
- stored in the ArjunaTA object store are (typically) owned by the user who ran the application that created
+ The present implementation of the &PRODUCT; system provides no security or protection for data. The objects
+ stored in the &PRODUCT; object store are (typically) owned by the user who ran the application that created
them. The Object Store and Object Manager facilities make no attempt to enforce even the limited form of
protection that Unix/Windows provides. There is no checking of user or group IDs on access to objects for either
reading or writing.
@@ -37,7 +37,7 @@
There is presently no support for version control of objects or database reconfiguration in the event of class
structure changes. This is a complex research area that we have not addressed. At present, if you change the
definition of a class of persistent objects, you are entirely responsible for ensuring that existing instances
- of the object in the Object Store are converted to the new representation. The ArjunaTA software can neither
+ of the object in the Object Store are converted to the new representation. The &PRODUCT; software can neither
detect nor correct references to old object state by new operation versions or vice versa.
</para>
</listitem>
Added: labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/JBossJTA_Administration_Guide.ent
===================================================================
--- labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/JBossJTA_Administration_Guide.ent (rev 0)
+++ labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/JBossJTA_Administration_Guide.ent 2011-04-13 13:53:29 UTC (rev 36904)
@@ -0,0 +1,4 @@
+<!ENTITY PRODUCT "JBossJTA">
+<!ENTITY BOOKID "JBossJTA_Administration_Guide">
+<!ENTITY YEAR "2010">
+<!ENTITY HOLDER "JBoss.org">
Added: labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/JBossJTA_Administration_Guide.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/JBossJTA_Administration_Guide.xml (rev 0)
+++ labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/JBossJTA_Administration_Guide.xml 2011-04-13 13:53:29 UTC (rev 36904)
@@ -0,0 +1,19 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "JBossJTA_Administration_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<book>
+ <xi:include href="Book_Info.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Preface.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <!-- <xi:include href="Chapter.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> -->
+ <xi:include href="Introduction.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Starting_And_Stopping_Transaction_Manager.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="ObjectStore_Management.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="JBossJTA_Runtime_Information.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Failure_Recovery_Administration.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Errors_And_Exceptions.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Selecting_The_JTA_Implementation.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="Revision_History.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <index />
+</book>
Added: labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/JBossJTA_Runtime_Information.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/JBossJTA_Runtime_Information.xml (rev 0)
+++ labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/JBossJTA_Runtime_Information.xml 2011-04-13 13:53:29 UTC (rev 36904)
@@ -0,0 +1,17 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "JBossJTA_Administration_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<chapter>
+ <title>&PRODUCT; Runtime Information</title>
+ <para>
+ Compile-time configuration information is available via class
+ <classname>com.arjuna.common.util.ConfigurationInfo</classname>. Runtime configuration is embodied in the various
+ <!-- Should this be <classname><replaceable>name</replaceable>EnvironmentBean</classname> classes?
+ --><name>EnvironmentBean classes, see the configuration section of the user guide. These beans have
+ corresponding <!--<interfacename>MBean</interfacename>? -->MBean interfaces and may be linked to JMX for remote
+ inspection of the configuration if desired.
+ </para>
+</chapter>
+
Deleted: labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Logging.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaJTA/docs/ArjunaTA_Installation_And_Administration_Guide/en-US/Logging.xml 2011-04-13 13:08:25 UTC (rev 36902)
+++ labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Logging.xml 2011-04-13 13:53:29 UTC (rev 36904)
@@ -1,35 +0,0 @@
-<?xml version='1.0' encoding='utf-8' ?>
-<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "ArjunaTA_Installation_Guide.ent">
-%BOOK_ENTITIES;
-]>
-<chapter>
- <title>Logging</title>
- <para>
- The recovery manager and the transaction server services produce log files which are located in the
- <filename>services/logs/</filename> directory. Two log files are created per service.
- </para>
- <variablelist>
- <varlistentry>
- <term><filename><replaceable>service-name</replaceable>-service.log</filename></term>
- <listitem>
- <para>
- Contains information regarding whether the service is stopped, started, restarted, or in another state.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><filename><replaceable>service-name</replaceable>.log</filename></term>
- <listitem>
- <para>
- Contains information logged from the actual service.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- <para>
- To configure what information is logged in these files, edit the appropriate LOG4J configuration files located in
- <filename>services/config/</filename>.
- </para>
-</chapter>
-
Modified: labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/ObjectStore_Management.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaJTA/docs/ArjunaTA_Installation_And_Administration_Guide/en-US/ObjectStore_Management.xml 2011-04-13 13:08:25 UTC (rev 36902)
+++ labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/ObjectStore_Management.xml 2011-04-13 13:53:29 UTC (rev 36904)
@@ -1,6 +1,6 @@
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "ArjunaTA_Administration_Guide.ent">
+<!ENTITY % BOOK_ENTITIES SYSTEM "JBossJTA_Administration_Guide.ent">
%BOOK_ENTITIES;
]>
<chapter>
Deleted: labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Operating_System_Services.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaJTA/docs/ArjunaTA_Installation_And_Administration_Guide/en-US/Operating_System_Services.xml 2011-04-13 13:08:25 UTC (rev 36902)
+++ labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Operating_System_Services.xml 2011-04-13 13:53:29 UTC (rev 36904)
@@ -1,161 +0,0 @@
-<?xml version='1.0' encoding='utf-8' ?>
-<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "ArjunaTA_Installation_Guide.ent">
-%BOOK_ENTITIES;
-]>
-<chapter>
- <title>Operating System Services</title>
-
- <section>
- <title>Microsoft Windows Server</title>
- <para>
- Four scripts, located in the <filename>Services\bin\windows</filename> folder, install and uninstall the recovery manager and transaction server services.
- </para>
- <variablelist>
- <title>Installation Scripts for Microsoft Windows</title>
- <varlistentry>
- <term>Recovery Manager Service</term>
- <listitem><para><filename>InstallRecoveryManagerService-NT.bat</filename></para></listitem>
- </varlistentry>
- <varlistentry>
- <term>Transaction Server</term>
- <listitem><para><filename>InstallTransactionServiceService-NT.bat</filename></para></listitem>
- </varlistentry>
- </variablelist>
- <variablelist>
- <title>Uninstallation Scripts for Microsoft Windows</title>
- <varlistentry>
- <term>Recovery Manager Service</term>
- <listitem><para><filename>UninstallRecoveryManagerService-NT.bat</filename></para></listitem>
- </varlistentry>
- <varlistentry>
- <term>Transaction Server</term>
- <listitem><para><filename>UninstallTransactionServerService-NT.bat</filename></para></listitem>
- </varlistentry>
- </variablelist>
- <note>
- <para>
- Each of the scripts requires administrative privileges.
- </para>
- </note>
- <para>
- After running any of the scripts, a status message indicates success or failure.
- </para>
-
- </section>
-
- <section>
- <title>Linux / UNIX</title>
-
- <procedure>
- <title>Installing Services in Linux / UNIX</title>
- <step>
- <title>Log into the system with <systemitem>root</systemitem> privileges.</title>
- <para>
- The installer needs these privileges to create files in <filename>/etc</filename>.
- </para>
- </step>
- <step>
- <title>Change to <filename><replaceable>JBOSS_HOME</replaceable>/services/installer</filename> directory.</title>
- <para>
- <filename><replaceable>JBOSS_HOME</replaceable></filename> refers to the directory where you extracted ArjunaTA.
- </para>
- </step>
- <step>
- <title>Set the <varname>JAVA_HOME</varname> variable, if necessary.</title>
- <para>
- Set the <varname>JAVA_HOME</varname> variable to the <firstterm>base directory</firstterm> of the JVM the service will use. The base directory is the directory above <filename>bin/java</filename>.
- </para>
- <substeps>
- <step>
- <para>Bash: <command>export JAVA_HOME="/opt/java"</command></para>
- </step>
- <step>
- <para>CSH: <command>setenv JAVA_HOME="/opt/java"</command></para>
- </step>
- </substeps>
- </step>
- <step>
- <title>Run the installer script.</title>
- <para>
- <command>./install_service.sh</command>
- </para>
- </step>
- <step>
- <title>The start-up and shut-down scripts are installed.</title>
- <para>Information similar to the output below is displayed.</para>
- <screen>
- Adding $JAVA_HOME (/opt/java) to $PATH in
- /opt/arjuna/ats-3.2/services/bin/solaris/recoverymanagerservice.sh
- Adding $JAVA_HOME (/opt/java) to $PATH in
- /opt/arjuna/ats-3.2/services/bin/solaris/transactionserverservice.sh
- Installing shutdown scripts into /etc/rcS.d:
- K01recoverymanagerservice
- K00transactionserverservice
- Installing shutdown scripts into /etc/rc0.d:
- K01recoverymanagerservice
- K00transactionserverservice
- Installing shutdown scripts into /etc/rc1.d:
- K01recoverymanagerservice
- K00transactionserverservice
- Installing shutdown scripts into /etc/rc2.d:
- K01recoverymanagerservice
- K00transactionserverservice
- Installing startup scripts into /etc/rc3.d:
- S98recoverymanagerservice
- S99transactionserverservice
- </screen>
- <para>
- The start-up and shut-down scripts are installed for each run-level. Depending on your specific operating system, you may need to explicitly enable the services for automatic start-up.
- </para>
- </step>
- </procedure>
-
- <procedure>
- <title>Uninstalling Services in Linux / UNIX</title>
- <step>
- <title>Log into the system with <systemitem>root</systemitem> privileges.</title>
- <para>
- The installer needs these privileges to delete files in <filename>/etc</filename>.
- </para>
- </step>
- <step>
- <title>Change to <filename><replaceable>JBOSS_HOME</replaceable>/services/installer</filename> directory.</title>
- <para>
- <filename><replaceable>JBOSS_HOME</replaceable></filename> refers to the directory where you extracted ArjunaTA.
- </para>
- </step>
-
- <step>
- <title>Run the installation script with the <option>-u</option> option.</title>
- <para>
- <command>./install_services.sh -u</command>
- </para>
- </step>
- <step>
- <title>The start-up and shut-down scripts are removed.</title>
- <para>
- Messages like the ones below indicate that the start-up and shut-down scripts have been removed successfully.
- </para>
- <screen>
- Removing startup scripts from /etc/rc3.d:
- S98recoverymanagerservice
- S99transactionserverservice
- Removing shutdown scripts from /etc/rcS.d:
- K01recoverymanagerservice
- K00transactionserverservice
- Removing shutdown scripts from /etc/rc0.d:
- K01recoverymanagerservice
- K00transactionserverservice
- Removing shutdown scripts from /etc/rc1.d:
- K01recoverymanagerservice
- K00transactionserverservice
- Removing shutdown scripts from /etc/rc2.d:
- K01recoverymanagerservice
- K00transactionserverservice
- </screen>
- </step>
- </procedure>
- </section>
-</chapter>
-
Modified: labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Preface.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaJTA/docs/ArjunaTA_Installation_And_Administration_Guide/en-US/Preface.xml 2011-04-13 13:08:25 UTC (rev 36902)
+++ labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Preface.xml 2011-04-13 13:53:29 UTC (rev 36904)
@@ -1,16 +1,16 @@
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "ArjunaTA_Administration_Guide.ent">
+<!ENTITY % BOOK_ENTITIES SYSTEM "JBossJTA_Administration_Guide.ent">
%BOOK_ENTITIES;
]>
-<preface id="pref-ArjunaTA_Administration_Guide-Preface">
+<preface id="pref-JBossJTA_Administration_Guide-Preface">
<title>Preface</title>
<section>
<title>Prerequisites</title>
<para>
- ArjunaTA works in conjunction with ArjunaCore. In addition to the documentation here, consult the ArjunaCore
- documentation, which ships as part of ArjunaCore and is also available on the JBoss Transaction Service website
+ &PRODUCT; works in conjunction with &PRODUCT;. In addition to the documentation here, consult the &PRODUCT;
+ documentation, which ships as part of &PRODUCT; and is also available on the JBoss Transaction Service website
at <ulink url="http://www.jboss.org/jbosstm" />.
</para>
</section>
Deleted: labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Preparing_Your_System.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaJTA/docs/ArjunaTA_Installation_And_Administration_Guide/en-US/Preparing_Your_System.xml 2011-04-13 13:08:25 UTC (rev 36902)
+++ labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Preparing_Your_System.xml 2011-04-13 13:53:29 UTC (rev 36904)
@@ -1,41 +0,0 @@
-<?xml version='1.0' encoding='utf-8' ?>
-<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "ArjunaTA_Installation_Guide.ent">
-%BOOK_ENTITIES;
-]>
-<chapter>
- <title>Preparing Your System</title>
- <procedure>
- <title>Pre-Installation Steps</title>
- <para>
- Before installing the ArjunaTA software, we recommend the following administrative steps be taken, assuming a default configuration for ArjunaTA.
- </para>
- <step>
- <title>Install the distribution into the required location.</title>
- <para>
- Typically, the distribution is extracted from a <filename>.ZIP</filename> file.
- </para>
- </step>
- <step>
- <title>Specify the Location for the Object Store</title>
- <para>
- ArjunaTA requires a minimum object store for storing the outcome of transactions in the event of system crashes. The location of this should be specified in the properties file using the <property>ObjectStoreEnvironmentBean.objectStoreDir</property> key or by using environment
- variable:
- </para>
- <screen><command>java –DObjectStoreEnvironmentBean.objectStoreDir =C:\temp foo.</command></screen>
- </step>
- <step>
- <title>Optional: Specify the sub-directory within the Object Store root.</title>
- <para>
- By default, all object states will be stored within the <filename>defaultStore/</filename> sub-directory of the
- object store root. For instance, if the object store root is
- <filename>/usr/local/Arjuna/TransactionService/ObjectStore</filename>, the subdirectory
- <filename>/usr/local/Arjuna/TransactionService/ObjectStore/defaultStore/</filename> is used.
- </para>
- <para>
- To change this subdirectory, set the <property>ObjectStoreEnvironmentBean.localOSRoot</property> or
- <property>com.arjuna.ats.arjuna.objectstore.localOSRoot</property> property variable accordingly.
- </para>
- </step>
- </procedure>
-</chapter>
Modified: labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Revision_History.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaJTA/docs/ArjunaTA_Installation_And_Administration_Guide/en-US/Revision_History.xml 2011-04-13 13:08:25 UTC (rev 36902)
+++ labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Revision_History.xml 2011-04-13 13:53:29 UTC (rev 36904)
@@ -1,26 +1,40 @@
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "ArjunaTA_Administration_Guide.ent">
+<!ENTITY % BOOK_ENTITIES SYSTEM "JBossJTA_Administration_Guide.ent">
%BOOK_ENTITIES;
]>
-<appendix id="appe-ArjunaTA_Administration_Guide-Revision_History">
+<appendix id="appe-JBossJTA_Administration_Guide-Revision_History">
<title>Revision History</title>
<simpara>
<revhistory>
<revision>
- <revnumber>0</revnumber>
- <date>Wed Sep 1 2010</date>
- <author>
- <firstname>Misty</firstname>
- <surname>Stanley-Jones</surname>
- <email>misty at redhat.com</email>
- </author>
- <revdescription>
- <simplelist>
- <member>Conversion to Docbook</member>
- </simplelist>
- </revdescription>
+ <revnumber>0</revnumber>
+ <date>Wed Sep 1 2010</date>
+ <author>
+ <firstname>Misty</firstname>
+ <surname>Stanley-Jones</surname>
+ <email>misty at redhat.com</email>
+ </author>
+ <revdescription>
+ <simplelist>
+ <member>Conversion to Docbook</member>
+ </simplelist>
+ </revdescription>
</revision>
+ <revision>
+ <revnumber>1</revnumber>
+ <date>Wed Apr 13 2011</date>
+ <author>
+ <firstname>Tom</firstname>
+ <surname>Jenkinson</surname>
+ <email>tom.jenkinson at redhat.com</email>
+ </author>
+ <revdescription>
+ <simplelist>
+ <member>Separation of installation and administration information</member>
+ </simplelist>
+ </revdescription>
+ </revision>
</revhistory>
</simpara>
</appendix>
Modified: labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Selecting_The_JTA_Implementation.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaJTA/docs/ArjunaTA_Installation_And_Administration_Guide/en-US/Selecting_The_JTA_Implementation.xml 2011-04-13 13:08:25 UTC (rev 36902)
+++ labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Selecting_The_JTA_Implementation.xml 2011-04-13 13:53:29 UTC (rev 36904)
@@ -1,6 +1,6 @@
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "ArjunaCore_Administration_Guide.ent">
+<!ENTITY % BOOK_ENTITIES SYSTEM "JBossJTA_Administration_Guide.ent">
%BOOK_ENTITIES;
]>
<chapter>
@@ -15,7 +15,7 @@
<entry>Purely local JTA</entry>
<entry>
<para>
- Only non-distributed JTA transactions are executed. This is the only version available with the ArjunaTA
+ Only non-distributed JTA transactions are executed. This is the only version available with the &PRODUCT;
distribution.
</para>
</entry>
@@ -24,8 +24,9 @@
<entry>Remote, CORBA-based JTA</entry>
<entry>
<para>
- Executes distributed JTA transactions. This functionality is provided by the ArjunaJTS distribution and requires
- a supported CORBA ORB. Consult the ArjunaJTS Installation and Administration Guide for more information.
+ Executes distributed JTA transactions. This functionality is provided by the JTS distribution and requires
+ a supported CORBA ORB.
+ Consult the JTS Installation and Administration Guide for more information.
</para>
</entry>
</row>
@@ -33,20 +34,26 @@
</tgroup>
</informaltable>
<para>
- Both of these implementations are fully compatible with the transactional JDBC driver provided with ArjunaTA.
+ Both of these implementations are fully compatible with the transactional JDBC driver.
</para>
<procedure>
<title>Selecting the local JTA implementation</title>
<step>
<para>
- Set the property <varname>JTAEnvironmentBean.jtaTMImplementation</varname> to value
- <literal>com.arjuna.ats.internal.jta.transaction.arjunacore.TransactionManagerImple</literal>.
+ Set the property
+ <varname>JTAEnvironmentBean.jtaTMImplementation</varname>
+ to value
+ <literal>com.arjuna.ats.internal.jta.transaction.arjunacore.TransactionManagerImple</literal>
+ .
</para>
</step>
<step>
<para>
- Set the property <varname>JTAEnvironmentBean.jtaUTImplementation</varname> to value
- <literal>com.arjuna.ats.internal.jta.transaction.arjunacore.UserTransactionImple</literal>.
+ Set the property
+ <varname>JTAEnvironmentBean.jtaUTImplementation</varname>
+ to value
+ <literal>com.arjuna.ats.internal.jta.transaction.arjunacore.UserTransactionImple</literal>
+ .
</para>
</step>
</procedure>
Deleted: labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Setting_Properties.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaJTA/docs/ArjunaTA_Installation_And_Administration_Guide/en-US/Setting_Properties.xml 2011-04-13 13:08:25 UTC (rev 36902)
+++ labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Setting_Properties.xml 2011-04-13 13:53:29 UTC (rev 36904)
@@ -1,51 +0,0 @@
-<?xml version='1.0' encoding='utf-8' ?>
-<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "ArjunaTA_Installation_Guide.ent">
-%BOOK_ENTITIES;
-]>
-<chapter id="chap-ArjunaTA_Installation_Guide-Test_Chapter">
- <title>Setting Properties</title>
- <para>
- ArjunaTA has been designed to be highly configurable at runtime through
- the use of various property attributes. <!--, which will be described in
- subsequent sections.-->Although these attributes can be provided at runtime
- on the command line, it may be more convenient to specify them through a
- single properties file or via <methodname>setter</methodname> methods on the
- beans. At runtime, ArjunaTA looks for the file
- <filename>jbossts-properties.xml</filename>, in a specific search order.
- </para>
- <orderedlist>
- <listitem><para>A location specified by a system property<!--Which one? -->, allowing the normal search path to be overridden.</para></listitem>
- <listitem><para>The directory from which the application was executed.</para></listitem>
- <listitem><para>The home directory of the user that launched ArjunaTA.</para></listitem>
- <listitem><para><varname>java.home</varname></para></listitem><!-- Is that like $JAVA_HOME? -->
- <listitem><para>The <varname>CLASSPATH</varname>, which normally includes the installation's
- <filename>etc/</filename> directory.</para></listitem>
- <listitem><para>A default set of properties embedded in the <filename>JAR</filename> file.</para></listitem>
- </orderedlist>
- <para>
- Where properties are defined in both the system properties by using the <parameter>-D</parameter> switch, and in the
- properties file, the value from the system property takes precedence. This facilitates overriding individual
- properties easily on the command line.
- </para>
- <para>
- The properties file uses <filename>java.uil.Properties</filename> XML format, for example:
- </para>
- <programlisting>
- <![CDATA[
-<entry key="CoordinatorEnvironmentBean.asyncCommit">NO</entry>
-<entyr key="ObjectStoreEnvironmentBean.objectStoreDir">/var/ObjectStore</entry>
- ]]>
- </programlisting>
- <para>
- You can override the name of the properties file at runtime by specifying a new file using the
- <varname>com.arjuna.ats.arjuna.common.propertiesFile</varname> attribute variable.
- </para>
- <note>
- <para>
- Unlike earlier releases, there is no longer one properties file name per module. This properties file name key is
- now global for all JBoss Transaction Service components in the JVM.
- </para>
- </note>
-</chapter>
-
Modified: labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Starting_And_Stopping_Transaction_Manager.xml
===================================================================
--- labs/jbosstm/trunk/ArjunaJTA/docs/ArjunaTA_Installation_And_Administration_Guide/en-US/Starting_And_Stopping_Transaction_Manager.xml 2011-04-13 13:08:25 UTC (rev 36902)
+++ labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/en-US/Starting_And_Stopping_Transaction_Manager.xml 2011-04-13 13:53:29 UTC (rev 36904)
@@ -1,6 +1,6 @@
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "ArjunaTA_Administration_Guide.ent">
+<!ENTITY % BOOK_ENTITIES SYSTEM "JBossJTA_Administration_Guide.ent">
%BOOK_ENTITIES;
]>
<chapter>
Deleted: labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/publican-maven.cfg
===================================================================
--- labs/jbosstm/trunk/ArjunaJTA/docs/ArjunaTA_Installation_And_Administration_Guide/publican-maven.cfg 2011-04-13 13:08:25 UTC (rev 36902)
+++ labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/publican-maven.cfg 2011-04-13 13:53:29 UTC (rev 36904)
@@ -1,7 +0,0 @@
-# Config::Simple 4.59
-# Wed Sep 1 15:11:59 2010
-
-xml_lang: en-US
-type: Book
-brand: jboss-community
-tmp_dir: target/publican/ArjunaTA_Installation_And_Administration_Guide
Modified: labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/publican.cfg
===================================================================
--- labs/jbosstm/trunk/ArjunaJTA/docs/ArjunaTA_Installation_And_Administration_Guide/publican.cfg 2011-04-13 13:08:25 UTC (rev 36902)
+++ labs/jbosstm/trunk/ArjunaJTA/docs/administration_guide/publican.cfg 2011-04-13 13:53:29 UTC (rev 36904)
@@ -4,4 +4,4 @@
xml_lang: en-US
type: Book
brand: jboss-community
-tmp_dir: ../../build/ArjunaTA_Installation_And_Administration_Guide
+tmp_dir: target/publican
More information about the jboss-svn-commits
mailing list