web server - Borland Technical Publications

web server - Borland Technical Publications web server - Borland Technical Publications

techpubs.borland.com
from techpubs.borland.com More from this publisher
12.11.2014 Views

OpenJMS Important When there are multiple messaging applications in the partition, and each of them uses a distinct datasource for application data, the two-phase commit optimization is not possible for each of those applications. The two-phase commit optimization will work only with the one that has the same datasource as OpenJMS. OpenJMS can persist data in only one datasource for all applications in a partition, regardless of the number of applications in that partition. So, if a partition has multiple applications and each application stores its data in its own separate database, you can make OpenJMS datasource to point to only one of those databases. The application that stores its data in this database will achieve the 2PC optimization. Configuring Security with OpenJMS Note The authentication and security features that come with OpenJMS version 0.7.6. work with the following BES configurations: 1 OpenJMS authentication with TCP Connector 2 OpenJMS authentication with VBJ-based RMI Connector HTTPS and TCPS connections are not supported in BES 6.5 release. The following XML code in openjms.xml file shows an example of how to turn on security for configurations 1 and 2 above only. It provides a list of authenticated users: 3 OpenJMS authentication with VBJ-based RMI connector using BES security Refer to the /examples/security/Readme.html document on how to configure security for this configuration. Refer to the OpenJMS documentation in /jms/openjms/docs directory for details on how to use security in OpenJMS. Specifying Partition Level Properties for OpenJMS To integrate OpenJMS as a partition level service in BES, it is introduced as a new service in the partition's configuration. The following properties are for OpenJMS in the partition.xml file. This file is located in /var/domains/base/ configurations//mos//adm/properties directory. The following code in the partition.xml file (located in /var/domains/base/ configurations//mos//adm/properties directory) creates OpenJMS as a partition level service: -

OpenJMS openjms.clean_messages_on_startup="true" openjms.datasource="serial://datasources/OpenJmsDataSource" openjms.sql_file="adm/openjms/conf/openjms.sql" openjms.datasource_lookup_interval="1" openjms.max_datasource_lookup_retries="1" /> The properties are described in the table below: Table 24.1 Partition level porperties for OpenJMS Property Name Description Default Value lifecycle.class openjms.configfile openjms.home openjms.clean_messages_on_startup Used to add an inprocess JMS service. In case of OpenJMS this property has to have a value of com.borland.jms.JmsPartitionServic e. The reflection based code of the partition launcher dynamically detects if the class specified in this property is in the Java CLASSPATH. If it finds it, it tries to load and start the service. This property specifies the location of the configuration file. The location is relative to the current working directory of your partition. This file is the central place where configuration of OpenJMS is stored. This file is needed for the embedded OpenJMS service to come up with a BES partition. This file also contains the list of JNDI objects (Queues, and Topics) that need to be created as part of the OpenJMS service startup. This property specifies where OpenJMS is installed. OpenJMS uses the value specified here to locate various resources. This property indicates whether to clean up the database tables containing JMS messages across partition restart. Currently, this property is only available for JDataStore. For other databases, you must delete messages manually. com.borland.jm s.JmsPartition Service adm/openjms/ conf/ openjms.xml /jms/openjms true 234 BES Developer’s Guide

OpenJMS<br />

openjms.clean_messages_on_startup="true"<br />

openjms.datasource="serial://datasources/OpenJmsDataSource"<br />

openjms.sql_file="adm/openjms/conf/openjms.sql"<br />

openjms.datasource_lookup_interval="1"<br />

openjms.max_datasource_lookup_retries="1" /><br />

<br />

The properties are described in the table below:<br />

Table 24.1<br />

Partition level porperties for OpenJMS<br />

Property Name Description Default Value<br />

lifecycle.class<br />

openjms.configfile<br />

openjms.home<br />

openjms.clean_messages_on_startup<br />

Used to add an inprocess JMS<br />

service. In case of OpenJMS this<br />

property has to have a value of<br />

com.borland.jms.JmsPartitionServic<br />

e. The reflection based code of the<br />

partition launcher dynamically<br />

detects if the class specified in this<br />

property is in the Java<br />

CLASSPATH. If it finds it, it tries to<br />

load and start the service.<br />

This property specifies the location<br />

of the configuration file. The location<br />

is relative to the current working<br />

directory of your partition. This file is<br />

the central place where<br />

configuration of OpenJMS is stored.<br />

This file is needed for the embedded<br />

OpenJMS service to come up with a<br />

BES partition. This file also contains<br />

the list of JNDI objects (Queues,<br />

and Topics) that need to be created<br />

as part of the OpenJMS service<br />

startup.<br />

This property specifies where<br />

OpenJMS is installed. OpenJMS<br />

uses the value specified here to<br />

locate various resources.<br />

This property indicates whether to<br />

clean up the database tables<br />

containing JMS messages across<br />

partition restart. Currently, this<br />

property is only available for<br />

JDataStore. For other databases,<br />

you must delete messages<br />

manually.<br />

com.borland.jm<br />

s.JmsPartition<br />

Service<br />

adm/openjms/<br />

conf/<br />

openjms.xml<br />

/jms/openjms<br />

true<br />

234 BES Developer’s Guide

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!