Sun Microsystems 3 - page 201

Monitoring and Managing Two-Phase Commit

Chapter 6 Managing Process Execution 201

Because of this two-phase commit capability, an iIS engine transaction and an

application transaction can be combined into a higher level distributed transaction.

The constituent transactions are placed in a PREPARE phase before either can

commit. If either of the constituent transactions cannot be placed in a PREPARE

phase, then the other is rolled back to its original state. In other words, the

distributed transaction only commits if both constituent transactions commit,

guaranteeing that application state and process state are synchronized.

The iIS two-phase commit protocol also facilitates synchronization between

different activities—or sessions—in a given process instance. For example, if Client

Application A (session A) has already prepared an AbortProcess for the process

instance, and Client Application B (session B) tries to complete or abort an activity

belonging to that process instance, an exception is raised on session B indicating

that session A is going to abort the same process instance.

The iIS two-phase commit protocol makes it possible to include the following iIS

engine operations in a transactional context:

•creating a process

•aborting a process

•starting an activity

•completing an activity

•aborting an activity

When included in a transactional context, these operations are automatically

placed in a PREPARE phase before being explicitly committed or rolled back. For

example, any StartActivity or CompleteActivity operation would be automatically

placed in a PREPARE phase.

By being placed in a transactional context, these iIS transactions can be

synchronized, as described above, with application update transactions. The client

application simply prepares any application (database update) operations it needs

to make. If the application transaction can be successfully placed in a PREPARE

phase, then the client application can commit both the application transaction and

the iIS engine transaction. If the application transaction cannot be successfully

placed in a PREPARE phase, then the client application should roll back the iIS

engine transaction.

All iIS objects associated with a prepared transaction are unavailable for further

operations until the client application explicitly commits or rolls back the

transaction.

Contents

Main Page Contents Page Page Page Page Page Page Page Page Page List of Figures Page List of Procedures Page Page Page Preface Product Name Change Audience for This Guide Organization of This Guide Text Conventions This section provides information about the conventions used in this document. Syntax Statements Other Documentation Resources iPlanet Integration Server Documentation Online Help Documentation Roadmap iIS Example Programs Viewing and Searching PDF Files Page Page Chapter 1 Introduction: iIS Process Management What Is an iIS Process Engine? Page Multiple Engine Systems Figure 1-1 An iIS Process Management System iIS Process Engine Components Minimal Engine Configuration Page Failover Configuration Page Full Configuration: Failover and Load Balancing Combined What Does an iIS Process Engine Do? iIS Process Management Tasks Setting up and Maintaining an iIS System Setting Up an iPlanet UDS Runtime Environment Installing iIS Process Management Software Setting Up and Maintaining Central Development Repositories Managing iIS Process Engines Managing Registration Managing Process Execution iIS Process Management Tools iIS Console Conductor Script Utility Custom System Management Tools Repository Management Tools Dump/Restore Facilities Page Chapter 2 Setting Up an iIS Process Management System Preparation: Setting up an iPlanet UDS Runtime Environment iIS Process System Components Figure 2-1 Components of an iIS Process System iIS Backbone iIS Process System Software Page Page Compiled and Interpreted Engine Components iIS Process System Configuration Page Figure 2-2 iIS Process System Configuration Page Setting Up an iIS Process System iIS Process System Setup Procedure The iIS Installation Program Central Server Installation Engine Server Installation Development Client Installation Runtime Client Installation Configuring and Starting Your iIS Engines Maintaining an iIS Process System Adding New Nodes to an iIS System Moving an iIS Engine Creating a New iIS Repository Server Moving an iIS Repository Server Creating a Private iIS Repository Upgrading an iIS System Uninstalling an iIS System Chapter 3 The iIS Console Overview Page Starting the iIS Console Using the cconsole Command The iIS Console Main Window Main Viewing Panel Menu Bar Mouse Popup Menu Online Help Setting Password Protection for iIS Console Exiting iIS Console Using iIS Console Windows Using the Mouse Window Refresh Behavior Filtering iIS Console Lists Operators Specifying Values Example Filter Expression Sorting iIS Console Lists Using List Views iIS Console Main Window Command Summary The following tables summarize the commands available from the iIS Console main window. Environment Menu View Menu Engine Menu Monitor Menu Help Menu Page Chapter 4 Managing Engines Production Engines Versus Development Engines NOTE Do not use the same engine for both development and production. Configuring an Engine Engine Component Partitioning Page Page Figure 4-2 Typical Engine Partitioning Scheme Engine Startup Properties Page Engine Configuration File A sample configuration file is reproduced below: The engine properties specified in the configuration file are described in the following table: Page Customizing Engine Database Schema Page How to Configure a New Engine Page Page Page Page Page Page Page Page Duplicating an Engine Configuration Deleting an Engine Configuration Starting an Engine Governor Engine Unit Page Primary Engine Unit Startup Phases Database Service How to Start an Engine Page Page Reconfiguring an Engine How to Reconfigure an Engine Page How to Dynamically Modify Database Logging How to Tune Process Execution Monitoring and Changing Engine States Monitoring Engines and Engine Components Monitoring the Engine Monitoring Engine Components Page Governor In the case of a governor the following information is provided: Database service In the case of a database service the following information is provided: Changing Engine States Changing Engine Unit States About Recovering State Information Shutting Down Engine Components Managing an Engine Database Database Management Issues Growth of the Database Failure of the Database Recovering Data Dumping and Restoring Data Dumping Database Tables Using the Dump/Restore Application Page Page Using the Dump Command-line Utility Restoring Database Tables Preserving Engine Database Schema Customizations Using the Dump/Restore Application Page Using the Restore Command-line Utility Dump/Restore Environment Variables Chapter 5 Managing Registrations About Registration Page What Does Registration Do? Page Registration in Production Environments What Does Unregistration Do? Engine Registration Manager About Aliases Registering iIS Distributions Registration Order Performing Registrations Page Upgrading Registrations Unregistering iIS Distributions Registering Aliases Page Unregistering Aliases Viewing Registrations for an Engine Unregistering a Distribution Monitoring Instances of a Registered Process Definition Performing Application Upgrades Monolithic Upgrades Rolling Upgrades Page Chapter 6 Managing Process Execution Introduction Engine Sessions Disrupted Sessions Page Explicitly Suspended Sessions Explicitly Terminated Sessions Activity States Page Figure 6-1 Activity State Transitionsfrom Creation to Termination Activity State Process Execution Step Activity Types Process Execution Process Instance Creation Process Instance Execution Activity Creation Activity Execution Offered Activities Queued Activities Subprocess Activities Automatic Activities Activity Termination Completed Activities Aborted Activities Process Instance Termination Completed Process Instances Aborted Process Instances Monitoring and Managing Engine Sessions Monitoring the State of a Session Page Managing Sessions Suspending or Terminating Sessions Sending and Broadcasting Messages to Sessions Page Monitoring and Managing Process Execution Page Managing Process Instances Checking the Status of a Process Instance Page Page Aborting a Process Instance Managing Activity Instances Checking the Status of an Activity Changing the State of an Activity Page Managing Activity Queues Checking the Status of an Activity Queue Reprioritizing a Queued Activity Page Managing Timer Instances Checking the Status of a Timer Page Managing Process Attributes Checking the Value and Lock State of a Process Attribute Changing a Process Attribute Value Removing a Process Attribute Lock Checking for Bottlenecks in Process Execution Analyzing Process Execution History Log Schema State Values Monitoring and Managing Two-Phase Commit Page Page Managing Two-Phase Commit Operations Chapter 7 Troubleshooting Introduction Page Process Engine Alarms Window Monitoring Alarms Page Viewing Alarms Page Engine Log Files Page iIS Console Trace Window Messages and Message Filters Specifying Message Filters iIS Message Filters Using the iIS Console Trace Window Setting Message Filters Page Special Example: Write Client Messages to Trace Window iIS Console Engine Event Filter Window Engine Event Types Using the iIS Console Engine Event Filter Window Page Page Filtering Engine Events Performance Charts Viewing Performance Indicators Page Page Logging Performance Information Page Chapter 8 Using the Conductor Script Utility Overview Conductor Script Help Starting Conductor Script Using the Cscript Command Working with Conductor Script General Conductor Script Operations Writing and Executing Scripts Comments Operating System and File Management Commands Page Managing iIS Process Engines with Conductor Script Starting an Engine Starting Individual Engine Components Page Example Manual Startup Scenario Monitoring Engines and Engine Components Monitoring the Engine Monitoring Individual Engine Components Page Changing Engine States Changing Engine Unit States Shutting Down Engine Components Managing Registrations with Conductor Script Making iIS Library Distributions Page Page Registering iIS Library Distributions Unregistering iIS Library Distributions Page Managing Process Execution with Conductor Script Monitoring and Managing Engine Sessions Page Monitoring and Managing Process Execution Managing Process Instances Managing Activity Instances Managing Activity Queues Managing Timers Managing Process Attributes Checking for Bottlenecks in Process Execution Page Page Monitoring and Managing Two-Phase Commit Transactions Monitoring Two-Phase Commit Operations Managing Two-Phase Commit Operations Page Appendix A Conductor Script Commands Conductor Script Command Summary Page Environment Mode Commands Engine Mode Commands: Engine Management Page Engine Mode Commands: Process Execution Management Page Page Page Page Component Mode Commands The Conductor Script engine component mode commands work only for the current component. Generic component A few commands work for any current component. One command applies only if the current component is an engine unit. Engine Unit Conductor Script Commands AbortActivity AbortAllProcesses AbortProcess BroadcastMessage CommitTransaction CompleteActivity ConsultActivity Page CreateActivity CreateFilter Event Type Object Class Object Instance Operators Examples DelegateActivity Page DeleteFilter FindDBService FindEngine FindGovernor FindNode FindParentEngine FindPrimary FindUnit FlushLog IIOPServer ListActivities ListActivityQueues ListConductorDistributions ListEngines ListFilters ListProcesses Options ListRegistrations ListSessions ListTimers ListTransactions MakeConductorDistribution ModLogFlags ReadyActivity RegisterAlias RegisterAssignmentRules RegisterProcessDefinition RegisterUserProfile RegisterValidation RemoveReadLock RemoveWriteLock RollbackActivity RollbackTransaction SendMessage SetAttributeValue SetPassword SetPrimary SetQueuedActivityPriority SetState SetTimer SetTimerDeadline SetTimerElapsed ShowActivity ShowActivityQueue ShowConfiguration ShowEngine ShowLogFlags ShowProcess ShowSession ShowStatus engine: engine unit: database service: governor: primary engine unit: Page ShowTimer Shutdown StartActivity StartDBService StartEngine StartGovernor StartTimer StartUnit Page StopTimer SuspendAllSessions SuspendSession TerminateAllSessions TerminateSession Uninstall UnRegisterAlias UnRegisterAssignmentRules UnRegisterProcessDefinition UnRegisterUserProfile WaitForStartup Page Page Appendix B Engine Database Schema Database Tables by Category Page Alphabetical Listing of Tables Page Database Schema Reference Current State Tables Page Page Page Page Page Page Page Page Page Page Page Page Page Registration Tables History Log Tables Page Page Page Page Page Page Page Page Page State Values Page Index A B C D E Page F G H I L M N O P Q R S T U V W