JBoss.orgCommunity Documentation
BLACKTIE_SCHEMA_DIR: the directory which contains all xsd schema files.
BLACKTIE_CONFIGURATION_DIR: the directory which contains all config files. If not assigned, current directory will be used.
We need btconfig.xml for all servers and client, and individual <SERVICE>.xml for all services.
The latest schemas for all configuration can be found at: http://www.jboss.org/blacktie/docs/index.html
The btconfig.xml is the most significant runtime configuration file for BlackTie. The content of its structure is defined and validated against the btconfig.xsd file which ships with each version of BlackTie.
ipv6 note
It is important to note that if you are using the sample btconfig.xml files and you are using ipv6 you will most likely need to change the word localhost to localhost4. Ways to check if this is neccesary are:
In your hosts file is the entry for localhost 127.0.0.1 or ::1
If you telnet to localhost does it start with "Trying ::1..."
The configuration includes:
DOMAIN: A user defined name for the domain
VERSION: The version of BlackTie software that is allowed to operate in this domain
MACHINES: The list of machines and paths to executables
SERVERS: The list of servers
SERVER: A server configuration element
MACHINE-REF: A reference to the machne
SERVICES: The list of services at a server
SERVICE: The key attributes of this element are: advertised - should the server automatically launch this service, function_name - the C function name (NOTE: Must be declspec(dllexport) exported on win32), java_class_name - the fully qualified class of the service for java Services
LIBRARY_NAME: The name of the .so or .dll library that exports the symbol, this is restricted by the mandatory "configuration" attribute which will restrict this XA_RESOURCE to the BLACKTIE_CONFIGURATION environment variable/-c parameter
SIZE: The number of dispatcher threads to handle requests
XA_RESOURCES: The list of configured XA resources available at any client/server in this domain
XA_RESOURCE: A configuration of XA_RESOURCE, note that the "configuration" attribute will restrict this XA_RESOURCE to the BLACKTIE_CONFIGURATION environment variable/-c parameter
ORB: The configuration to connect to the transaction service
MQ: The configuration to connect to the message broker
JMX: The url of the JMX agent
ENV_VARIABLES: Special key/value pairs can be specified here, known ENV_VARIABLEs are defined below, note that the "configuration" attribute will restrict this XA_RESOURCE to the BLACKTIE_CONFIGURATION environment variable/-c parameter
BUFFERS: The buffer configuration.
More information on services is available Chapter 4, Services .
The list of ENV_VARIABLES that are supported is:
LOG4CXXCONFIG is used for logging
RC_LOG_NAME The name of the recovery log file
JMXURL The URL to use to connect to the JMX kernel
QueueReaperInterval: The period of time in seconds to wait before assuming a service has disconnected and pruning its queue
More information on buffer configuration is available Chapter 3, Using Buffers with BlackTie .