Purpose of This Document
Who Should Read This Document
How This Document Is Organized
How to Use This Document
Opening the Document in a Web Browser
Printing from a Web Browser
Documentation Conventions
Related Documentation
BEA TUXEDO Documentation
BEA Publications
Other Publications
Contact Information
Documentation Support
Customer Support
The Administrator's Job
The Groundwork Phase
The Operational Phase
Roadmap for Your Responsibilities
Planning Your Configuration
Questions About the Design
Questions About Server Applications
Configuration and Run-time Administration
Tools for Configuration
Tools for Run-time Administration
BEA TUXEDO Web-based GUI
Command-line Interface
AdminAPI
What Is the Configuration File?
Two Forms of the Configuration File
Contents of the Configuration File
Setting Domain-wide Parameters
Identifying Information in the RESOURCES Section
Setting the Address of Shared Memory
Identifying the Master Machine
Setting the Application Type
Defining Access Control
Defining IPC Limits
Enabling Load Balancing
Setting Buffer Type and Subtype Limits
Setting the Number of Sanity Checks and Blocking Timeouts
Setting Conversation Limits
Setting the Security Level
Setting Parameters of Unsolicited Notification
Protecting Shared Memory
Configuring Machines
Identifying Machines in the MACHINES Section
Reserving the Physical Address and Machine ID
Identifying the Location of the Configuration File
Identifying the Locations of the System Software and Application Server Machines
Identifying the Location of the Log File
Specifying Environment Variable Settings for Processes
Overriding System-wide Parameters
Configuring Groups
Specifying a Group Name, Number, and LMID
Configuring Servers
Identifying Server Information in the SERVERS Section
Defining Server Name, Group, and ID
Using Server Command-Line Options
Setting the Order in Which Servers Are Booted
Identifying the Location of the Server Environment File
Identifying Server Queue Information
Defining Server Restart Information
Specifying a Server as Conversational
Defining Server Access to Shared Memory
Configuring Services
Identifying BEA TUXEDO Services in the SERVICES Section
Enabling Load Balancing
Controlling the Flow of Data by Service Priority
Specifying Different Service Parameters for Different Server Groups
Specifying a List of Allowable Buffer Types for a Service
Service Timeout Errors
Configuring Routing
Defining Routing Criteria in the ROUTING Section
Specifying Range Criteria in the ROUTING Section
Configuring Network Information
Specifying Information in the NETGROUPS Section
Sample Network Groups Configuration
Configuring the UBBCONFIG File with Netgroups
Starting Applications
Prerequisite Checklist
Booting the Application
Shutting Down Applications
Using tmshutdown
Clearing Common Problems
Common Startup Problems
Common Shutdown Problems
Why Distribute an Application?
Benefits of a Distributed Application
Characteristics of Distributing an Application
Using Data-dependent Routing
Characteristics of Data-dependent Routing
Example: A Distributed Application
Modifying and Creating the UBBCONFIG Sections for a Distributed Application
Modifying the GROUPS Section
Modifying the SERVICES Section
Creating the ROUTING Section
Example of UBBCONFIG Sections in a Distributed Application
Modifying the Domain Gateway Configuration File to Support Routing
What Is the Domains Gateway Configuration File?
Description of Parameters in the ROUTING Section of the DMCONFIG File
Terms and Definitions
Configuring Networked Applications
Example: A Network Configuration with Multiple Netgroups
The UBBCONFIG File for the Network Example
Assigning Priorities for Each Network Group
Running a Networked Application
Scheduling Network Data over Parallel Data Circuits
Network Data in Failover and Failback
Using Data Compression for Network Data
Using Link-Level Encryption
Understanding Transactions
Modifying the UBBCONFIG File to Accommodate Transactions
Specifying Application-Wide Transactions in the RESOURCES Section
Creating a Transaction Log (TLOG)
Defining Each Resource Manager (RM) and the Transaction Manager Server in the GROUPS Section
Enabling a Service to Begin a Transaction in the SERVICES Section
Modifying the Domain Configuration File to Support Transactions
Characteristics of the DMTLOGDEV, DMTLOGNAME, DMTLOGSIZE, MAXRDTRAN, and MAXTRAN Parameters
Characteristics of the AUTOTRAN and TRANTIME Parameters
Example: A Distributed Application Using Transactions
The RESOURCES Section
The MACHINES Section
The GROUPS and NETWORK Sections
The SERVERS, SERVICES, and ROUTING Sections
Benefits of Using BEA TUXEDO System Domains
What Is the Domains Gateway Configuration File?
Components of the DMCONFIG File
Configuring Local and Remote Domains
Setting Environment Variables
Building a Local Application Configuration File and a Local Domains Gateway Configuration File
Building a Remote Application Configuration File and a Remote Domains Gateway Configuration File
Example of a Domains-based Configuration
Defining the Local Domains Environment
Defining the Local and Remote Domains, Addressing, and Imported and Exported Services
Defining the Exported Services
Using Data Compression Between Domains
Ensuring Security in Domains
Creating a Domain Access Control List (ACL)
Routing Service Requests to Remote Domains
Workstation Terms
What Is a Workstation Client?
Illustration of an Application with Two Workstation Clients
How the Workstation Client Connects to an Application
Setting Environment Variables
Setting the Maximum Number of Workstation Clients
Configuring a Workstation Listener (WSL)
Format of the CLOPT Parameter
Command-line Options of the CLOPT Parameter
Modifying the MACHINES Section to Support Workstation Clients
Terms and Definitions
Overview of the BEA TUXEDO Queued Message Facility
Administrative Tasks
Setting the QMCONFIG Environment Variable
Using qmadmin, the /Q Administrative Interface
Creating an Application Queue Space and Queues
Modifying the Configuration File
Associating a Queue with a Group
Listing the /Q Servers in the SERVERS Section
Security Strategy
Configuring the RESOURCES SECURITY Parameter
Implementing Operating System Security
Implementing Application Password-level Security
Implementing Security via an Authentication Server
The Authentication Server
Adding, Modifying, and Deleting User Accounts
Adding, Modifying, and Deleting Groups
Implementing Security via Access Control Lists
Limitations of ACLs
Administering ACLs
Overview of System and Application Data
Components and Activities for Which Data Is Available
Where the Data Resides
How You Can Use the Data
Types of Data
Monitoring Methods
Using the tmadmin Command Interpreter
What Is tmadmin?
How a tmadmin Session Works
Running tmadmin Commands
Monitoring a Running System with tmadmin
Example: Output from tmadmin Commands
printqueue Output
printconn Data
printnet Command Output
printtrans Command Output
Case Study: Monitoring Run-time bankapp
Configuration File for bankapp
Output from Checking the Local IPC Resources
Output from Checking System-wide Parameter Settings
What Is the ULOG?
Purpose
How Is the ULOG Created?
How Is the ULOG Used?
Message Format
Location
What Is tlisten?
Purpose
How Is the tlisten Log Created?
Message Format
Location
What Is the Transaction Log (TLOG)?
How Is the TLOG Created?
How Is the TLOG Used?
Location
Creating and Maintaining Logs
How to Assign a Location for the ULOG
Creating a Transaction Log (TLOG)
Using Logs to Detect Failures
Analyzing the User Log (ULOG)
Analyzing the tlisten Log
Analyzing a Transaction Log (TLOG)
Maximizing Your Application Resources
When to Use MSSQ Sets
Enabling Load Balancing
Two Ways to Measure Service Performance Time
Assigning Priorities to Interfaces or Services
Characteristics of the PRIO Parameter
Bundling Services into Servers
When to Bundle Services
Enhancing Efficiency with Application Parameters
Setting the MAXACCESSERS, MAXSERVERS, MAXINTERFACES, and MAXSERVICES Parameters
Setting the MAXGTT, MAXBUFTYPE, and MAXBUFSTYPE Parameters
Setting the SANITYSCAN, BLOCKTIME, BBLQUERY, and DBBLWAIT Parameters
Setting Application Parameters
Determining IPC Requirements
Measuring System Traffic
Example: Detecting a System Bottleneck
Detecting Bottlenecks on UNIX Platforms
Detecting Bottlenecks on Windows NT Platforms
About Migration
Migration Options
Switching Master and Backup Machines
How to Switch the Master and Backup Machines
Examples: Switching Master and Backup Machines
Migrating a Server Group
Migrating a Server Group When the Alternate Machine Is Accessible from the Primary Machine
Migrating a Server Group When the Alternate Machine Is Not Accessible from the Primary Machine
Examples: Migrating a Server Group
Migrating Machines
Migrating Machines When the Alternate Machine Is Accessible from the Primary Machine
Migrating Machines When the Alternate Machine Is Not Accessible from the Primary Machine
Examples: Migrating a Machine
Canceling a Migration
Example: A Migration Cancellation
Migrating Transaction Logs to a Backup Machine
Dynamic Modification Methods
Procedures for Dynamically Modifying Your System
Suspending and Resuming Services
Advertising and Unadvertising Services
Changing Service Parameters (BEA TUXEDO System)
Changing the AUTOTRAN Timeout Value
Introduction to Dynamic Reconfiguration
Overview of the tmconfig Command Interpreter
What tmconfig Does
How tmconfig Works
Output from tmconfig Operations
General Instructions for Running tmconfig
Preparing to Run tmconfig
Running tmconfig: A High-level Walk-through
Input Buffer Considerations
Procedures
Adding a New Machine
Adding a Server
Activating a Newly Configured Server
Adding a New Group
Changing the Data-dependent Routing (DDR) for the Application
Changing Application-wide Parameters
Changing an Application Password
Final Advice About Dynamic Reconfiguration
Events
Event Classifications
List of Events
Setting Up Event Detection
Subscribing to Events
Application-specific Event Broker/Monitors
How an Event Broker/Monitor Might Be Deployed
How the Event Broker/Monitor Works
Distinguishing Between Types of Failures
Determining the Cause of an Application Failure
Determining the Cause of a BEA TUXEDO System Failure
Broadcasting Unsolicited Messages
Performing System File Maintenance
Creating a Device List
Destroying a Device List
Reinitializing a Device
Printing the Universal Device List (UDL)
Printing VTOC Information
Repairing Partitioned Networks
Detecting Partitioned Networks
Restoring a Network Connection
Restoring Failed Machines
Restoring a Failed Master Machine
Restoring a Failed Nonmaster Machine
Replacing System Components
Replacing Application Components
Cleaning Up and Restarting Servers Manually
Cleaning Up Resources Associated with Dead Processes
Cleaning Up Resources
Aborting or Committing Transactions
Aborting a Transaction
Committing a Transaction
Recovering from Failures When Transactions Are Used