JBoss.orgCommunity Documentation

JBossJTA Installation Guide

Stand-alone Installation Guide for JBossJTA

by Mark Little, Jonathan Halliday, Andrew Dinn, and Kevin Connor
edited by Misty Stanley-Jones

This manual uses several conventions to highlight certain words and phrases and draw attention to specific pieces of information.

In PDF and paper editions, this manual uses typefaces drawn from the Liberation Fonts set. The Liberation Fonts set is also used in HTML editions if the set is installed on your system. If not, alternative but equivalent typefaces are displayed. Note: Red Hat Enterprise Linux 5 and later includes the Liberation Fonts set by default.

Four typographic conventions are used to call attention to specific words and phrases. These conventions, and the circumstances they apply to, are as follows.

Mono-spaced Bold

Used to highlight system input, including shell commands, file names and paths. Also used to highlight keycaps and key combinations. For example:

The above includes a file name, a shell command and a keycap, all presented in mono-spaced bold and all distinguishable thanks to context.

Key combinations can be distinguished from keycaps by the hyphen connecting each part of a key combination. For example:

The first paragraph highlights the particular keycap to press. The second highlights two key combinations (each a set of three keycaps with each set pressed simultaneously).

If source code is discussed, class names, methods, functions, variable names and returned values mentioned within a paragraph will be presented as above, in mono-spaced bold. For example:

Proportional Bold

This denotes words or phrases encountered on a system, including application names; dialog box text; labeled buttons; check-box and radio button labels; menu titles and sub-menu titles. For example:

The above text includes application names; system-wide menu names and items; application-specific menu names; and buttons and text found within a GUI interface, all presented in proportional bold and all distinguishable by context.

Mono-spaced Bold Italic or Proportional Bold Italic

Whether mono-spaced bold or proportional bold, the addition of italics indicates replaceable or variable text. Italics denotes text you do not input literally or displayed text that changes depending on circumstance. For example:

Note the words in bold italics above — username, domain.name, file-system, package, version and release. Each word is a placeholder, either for text you enter when issuing a command or for text displayed by the system.

Aside from standard usage for presenting the title of a work, italics denotes the first use of a new and important term. For example:

Procedure 2.1. Installing Services in Linux / UNIX

  1. Log into the system with root privileges.

    The installer needs these privileges to create files in /etc.

  2. Change to JBOSS_HOME/services/installer directory.

    JBOSS_HOME refers to the directory where you extracted JBossJTA.

  3. Set the JAVA_HOME variable, if necessary.

    Set the JAVA_HOME variable to the base directory of the JVM the service will use. The base directory is the directory above bin/java.

    1. Bash: export JAVA_HOME="/opt/java"

    2. CSH: setenv JAVA_HOME="/opt/java"

  4. Run the installer script.

    ./install_service.sh

  5. The start-up and shut-down scripts are installed.

    Information similar to the output below is displayed.

         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
       

    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.

JBossJTA has been designed to be highly configurable at runtime through the use of various property attributes. 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 setter methods on the beans. At runtime, JBossJTA looks for the file jbossts-properties.xml, in a specific search order.

Where properties are defined in both the system properties by using the -D switch, and in the properties file, the value from the system property takes precedence. This facilitates overriding individual properties easily on the command line.

The properties file uses java.uil.Properties XML format, for example:

    
<entry key="CoordinatorEnvironmentBean.asyncCommit">NO</entry>
<entyr key="ObjectStoreEnvironmentBean.objectStoreDir">/var/ObjectStore</entry>
     
  

You can override the name of the properties file at runtime by specifying a new file using the com.arjuna.ats.arjuna.common.propertiesFile attribute variable.

Revision History
Revision 0Wed Sep 1 2010Misty Stanley-Jones
Conversion to Docbook
Revision 1Wed Apr 13 2010Tom Jenkinson
Taken from installation guide