Contents

Preface
Purpose of This Document
How to Use This Document
Related Documentation
Contact Information

Introduction to Administration
The Administrator's Job
  The Groundwork Phase
  The Operational Phase
  Differences Between the WLE and BEA TUXEDO Systems
Roadmap for Your Responsibilities
Planning Your Configuration
  Questions About the Design
  Questions About Server Applications

Administration Tools
Configuration and Run-time Administration
  Tools for Configuration
  Tools for Run-time Administration
BEA Administration Console
Command-line Interface
AdminAPI

Creating a Configuration File
About the Configuration File
  Build Environment
  Forms of the Configuration File
  Configuration File Content
Administrative Requirements and Hints
  Administrative Requirements
  Reliability Requirements
  Performance Hint
Configuring RESOURCES
  Setting the Address of Shared Memory
  Identifying the Master Machine
  Setting the Application Type
  Defining Access Control (BEA TUXEDO Servers)
  Defining IPC Limits
  Enabling Load Balancing
  Setting Buffer Type and Subtype Limits
  Setting the Number of Sanity Checks and Timeouts
  Setting Conversation Limits (BEA TUXEDO Servers)
  Setting the Security Level
  Setting Parameters of Unsolicited Notification (BEA TUXEDO Servers)
  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 User Log File
  Specifying Environment Variable Settings for Processes
  Overriding System-wide Parameters
Configuring Groups
  Specifying a Group Name, Number, and LMID
  Sample GROUPS Section
Configuring Servers
  Identifying Server Information in the SERVERS Section
  Defining Server Name, Group, and ID
  Using Server Command-Line Options
  Starting the Java Server
  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 (BEA TUXEDO Servers)
  Defining Server Access to Shared Memory
Configuring Services (BEA TUXEDO System)
  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
Configuring Interfaces (WLE Servers)
  Specifying CORBA Interfaces in the INTERFACES Section
  Specifying a FACTORYROUTING Criteria
  Enabling Load Balancing
  Controlling the Flow of Data by Interface Priority
  Specifying Different Interface Parameters for Different Server Groups
Configuring Routing
  Defining Routing Criteria in the ROUTING Section
  Specifying Range Criteria in the ROUTING Section
  Example: Factory-based Routing in the University Production Sample Application (WLE Servers)
  Example: Factory-based Routing in the Bankapp Sample Application (WLE Servers)
Configuring Network Information
  Specifying Information in the NETGROUPS Section
  Sample NETGROUPS Configuration
  Configuring the UBBCONFIG File with Netgroups

Starting and Shutting Down Applications
Starting Applications
  Prerequisite Checklist
  Booting the Application
Shutting Down Applications
Using tmshutdown
Clearing Common Problems
  Common Startup Problems
  Common Shutdown Problems

Distributing Applications
Why distribute an application?
  Benefits of a Distributed Application
  Characteristics of Distributing an Application
Using Factory-based Routing (WLE Servers)
  Characteristics of Factory-based Routing
  Example: Factory-based Routing
Using Data-dependent Routing (BEA TUXEDO Servers)
  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 (BEA TUXEDO Servers)
  What is the Domains gateway configuration file?
  Description of Parameters in the ROUTING Section of the DMCONFIG File

Building Networked Applications
Terms and Definitions
Configuring Networked Applications
Example: A Network Configuration
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
  Balancing Network Request Loads
  Using Link-level Encryption (BEA TUXEDO Servers)

Configuring Transactions
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 an Interface to Begin a Transaction in the INTERFACES Section (WLE Servers)
  Enabling a Service to Begin a Transaction in the SERVICES Section (BEA TUXEDO Servers)
Modifying the Domain Configuration File to Support Transactions (BEA TUXEDO Servers)
  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

Managing Interface Repositories (WLE System)
Administration Considerations
Using Administration Commands to Manage Interface Repositories
  Prerequisites
  Creating and Populating an Interface Respository
  Displaying or Extracting the Content of an Interface Repository
  Deleting an Object from an Interface Repository
Configuring the UBBCONFIG File to Start One or More Interface Repository Servers

Configuring Multiple Domains (WLE System)
  Benefits of Multiple Domains
  Interdomain Communication
  Functions of Multiple-domain Configuration Elements
Configuring Multiple Domains
  The UBBCONFIG File
  The Domain Configuration (DMCONFIG) File
  The factory_finder.ini File
  DM_REMOTE_FACTORIES
  DM_LOCAL_FACTORIES
Types of Domain Configurations
  Directly Connected Domains
  Indirectly Connected Domains
Examples: Configuring Multiple Domains
  Sample UBBCONFIG Files

Working with Multiple Domains (BEA TUXEDO System)
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 Remote Domains Environment
  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

Managing Workstation Clients (BEA TUXEDO System)
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

Managing Remote Client Applications (WLE Systems)
Terms and Definitions
Remote Client Overview
  Illustration of an Application with Remote Clients
  How the Remote Client Connects to an Application
Setting Environment Variables
Setting the Maximum Number of Remote Clients
Configuring a Listener for a Remote Client
  Format of the CLOPT Parameter
Modifying the UBBCONFIG File to Support Remote Clients
Configuring Outbound IIOP for Remote Joint Client/Servers
  Functional Description
Using the ISL Command to Configure Outbound IIOP Support
  Types of Object References
  User Interface

Managing Queued Messages (BEA TUXEDO System)
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

Securing Applications
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 (BEA TUXEDO System)
  Limitations of ACLs
  Administering ACLs

Monitoring a Running System
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

Monitoring Log Files
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)

Tuning Applications
Maximizing Your Application Resources
When to Use MSSQ Sets (BEA TUXEDO Servers)
Enabling Load Balancing
  Two Ways to Measure Service Performance Time
Using Multithreaded JavaServers
Assigning Priorities to Interfaces or Services
  Characteristics of the PRIO Parameter
Bundling Services into Servers (BEA TUXEDO 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

Migrating Applications
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

Dynamically Modifying Systems
Dynamic Modification Methods
Procedures for Dynamically Modifying Your System
  Suspending and Resuming Services (BEA TUXEDO Servers)
  Advertising and Unadvertising Services (BEA TUXEDO Servers)
  Changing Service Parameters (BEA TUXEDO Servers) or Interface Parameters (WLE Servers)
  Changing the AUTOTRAN Timeout Value

Dynamically Reconfiguring Applications
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 Factory-based Routing (FBR) for an Interface
  Changing the Data-dependent Routing (DDR) for the Application
  Changing Application-wide Parameters
  Changing an Application Password
Final Advice About Dynamic Reconfiguration

Event Broker/Monitor (BEA TUXEDO System)
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

Administrative Reference (WLE System)
  idl2ir
  ir2idl
  irdel
  ISL
  TMFFNAME
  TMIFRSVR
  factory_finder.ini

Troubleshooting Applications
Distinguishing Between Types of Failures
  Determining the Cause of an Application Failure
  Determining the Cause of a WLE or BEA TUXEDO System Failure
Broadcasting Unsolicited Messages (BEA TUXEDO System)
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 (BEA TUXEDO System)
Replacing Application Components
Cleaning Up and Restarting Servers Manually
  Cleaning Up Resources
Checking the Order in Which Servers Are Booted (WLE Servers)
Checking Hostname Format and Capitalization (WLE Servers)
Some Clients Fail to Boot (WLE Servers)
Aborting or Committing Transactions
  Aborting a Transaction
  Committing a Transaction
Recovering from Failures When Transactions Are Used