Compaq AA-Q88CE-TE manual

ReliableTransactionRouter

SystemManager’s Manual

Order Number: AA-Q88CE-TE

June, 1999

This manual describes how to conﬁgure, manage and monitor Reliable

Transaction Router,Version 3.2 (RTR).

Revision/Update Information: This manual supersedes Version 3.1D

of the System Manager’s Manual

Software Version: Reliable Transaction Router, Version

3.2

Compaq Computer Corporation

Houston, Texas

Contents

Main Page Contents Preface 1 Introduction 2 Starting and Setting Up RTR 3 Partition Management 4 Transaction Management 5 RTR Monitoring 6 RTR Command Line Interface Page A Creating Monitor Pictures B Server Shadowing and Recovery C XA Support D RTR Utility Error Messages E RTR log messages Index Figures Tables Page Page Preface Purpose of this Manual Intended Audience Structure of Document Page Table 1 Conventions Used in this Guide filesystem user input [y] name number Page Introduction 1.1 Getting Started START 1.2 Entering Commands 1.2 Entering Commands 1.3 Online Help error-identification 1.3 Online Help error-identification @file-spec 1.4 Command Procedures 1.5 Remote Commands 1.5 Remote Commands Starting and Setting Up RTR 2.1 Introduction facility 2.2 Setting UpAn Example Page 2.2 Setting UpAn Example SHOW RTR %RTR-F-SPUJOUFIL CREATE JOURNAL/SUPERSEDE 2.3 Creating a Recovery Journal MODIFY JOURNAL 2.3 Creating a Recovery Journal 2.4 Changing a Facility stop rtr /abort Page 2.5 Setting up Callout Servers Callout 2.5 Setting up Callout Servers 2.6 Router Load Balancing /balanced set facility/[no]balance set facility create facility/router=tr1,tr2,tr3.. 2.7 RTR Privileges 2.7 RTR Privileges rtroper 2.8 RTR ACP Virtual Memory Sizing 2.8.1 OpenVMS Virtual Memory Sizing Page 2.8.2 UNIX Virtual Memory Sizing 2.9 Network Transports 2.9.1 Specifying the Link Transport Protocol 2.9 Network Transports 2.9.2 Using RTR with DHCP and Internet Tunnels rtr rtrd /etc/services 2.9 Network Transports inetd dlogin AUTOEXEC.BAT 2.9.3 Interoperation with RTR Version 2 Using DECnet 2.10 Network Protocol Selection on OpenVMS tcp. dna. RTR$STARTUP.COM 2.11 Running RTR as a Service on Windows NT 2.11 Running RTR as a Service on Windows NT 2.11.1 Customizing the RTR Windows NT Service 2.11.2 Files Created by the RTR Windows NT Service 2.12 How RTR Selects Processing-states (Roles) for Nodes 2.12.1 Role Assignment for Backend Node Partitions Page Page 2.12.2 Router Selection Page Partition Management 3.1 Overview 3.1.1 What is a Partition? 3.1.2 What is Partition Management? 3.2 Partition Naming 3.2 Partition Naming ks_type = rtr_keyseg_partition rtr_keyseg_t 3.2.1 Default Partition Names 3.2.2 Programmer Supplied Names 3.4 Binding Server Channels to Named Partitions 3.5 Entering Partition Commands 3.5 Entering Partition Commands 3.5.1 Command Line Usage 3.5.2 Programmed Partition Management 3.5 Entering Partition Commands rtr_mt_closed 3.6 Managing Partitions 3.6.1 Controlling Shadowing 3.6.2 Controlling Transaction Presentation /SUSPEND rtr_partition_state_resume newState /RESUME 3.6.4 Controlling the Active Site 3.6.5 Controlling Failover /FAILOVER_POLICY= newPolicy /FAILOVER_POLICY /FAILOVER_POLICY=COMPATIBLE_PRE_V32 3.6.6 Controlling Transaction Replay 3.7 Displaying Partition Information 3.7 Displaying Partition Information Transaction Management 4.1 Overview DUMP JOURNAL 4.1.1 Exception Transactions SET PARTITION/RECOVERY_RETRY_COUNT=nn SET TRANSACTION/STATE=EXCEPTION /NEW_STATE=DONE 4.1.2 Transaction State Changes Page RTR Monitoring 5.1 Introduction .mon monitor file RTR MONITOR /FACILITY Table 51 (Cont.) Standard Monitor Pictures /LINK=link-name 5.2.1 Monitor ACCFAIL (Link Acceptance Failures) 5.2.2 Monitor ACP2APP process-id 5.2.3 Monitor Active 5.2.4 Monitor APP2ACP 5.2.5 Monitor Broadcast 5.2.6 Monitor Calls 5.2.7 Monitor Channel 5.2.8 Monitor Connects 5.2.9 Monitor Event 5.2.10 Monitor Facility /FACILITY 5.2.11 Monitor Flow 5.2.12 Monitor Group txn cnt 5.2.13 Monitor IPC 5.2.14 Monitor IPCRATE 5.2.15 Monitor Journal 5.2.16 Monitor Link /LINK=link-name 5.2.17 Monitor Netbytes 5.2.18 Monitor Netstat 5.2.19 Monitor Partit node$facility_partition-id partition name 5.2.20 Monitor Queues 5.2.21 Monitor Quorum node/roles 5.2.22 Monitor Recovery 5.2.23 Monitor Rejects 5.2.24 Monitor Rejhist 5.2.25 Monitor Response 5.2.26 Monitor Rolequorum 5.2.27 Monitor Routers 5.2.28 Monitor Routing 5.2.29 Monitor RSCBE 5.2.30 Monitor RTR 5.2.31 Monitor Stalls 5.2.32 Monitor System 5.2.33 Monitor TPS 5.2.34 Monitor Trafc 5.2.35 Monitor Trans 5.2.36 Monitor V2CALLS 5.2.37 Monitor XA Page RTR Command Line Interface at CLI level CALL RTR_ACCEPT_TX 6.1 Introduction /NODE=node-list Page CALL RTR_ACCEPT_TX CALL RTR_ACCEPT_TX CALL RTR_ACCEPT_TX Page CALL RTR_BROADCAST_EVENT Page Page Page CALL RTR_CLOSE_CHANNEL CALL RTR_CLOSE_CHANNEL CALL RTR_CLOSE_CHANNEL CALL RTR_ERROR_TEXT CALL RTR_ERROR_TEXT sts CALL RTR_GET_TID CALL RTR_GET_TID CALL RTR_GET_TID CALL RTR_OPEN_CHANNEL Page Page high-bound unsigned string signed unsigned Page cannot key-type CALL RTR_CLOSE_CHANNEL CALL RTR_PREPARE_TX rtr_mt_prepared rtr_mt_accepted RTR_MAX_BLOB_LEN rtr_mt_prepared Page CALL RTR_RECEIVE_MESSAGE Page Page CALL RTR_REJECT_TX CALL RTR_REJECT_TX CALL RTR_REJECT_TX Page CALL RTR_REPLY_TO_CLIENT Page CALL RTR_SEND_TO_SERVER CALL RTR_RECEIVE_MESSAGE Page CALL RTR_REQUEST_INFO CALL RTR_REQUEST_INFO CALL RTR_REQUEST_INFO Page CALL RTR_SEND_TO_SERVER pmsg msgfmt send_to_server() msgfmt msglen pmsg msglen Page Page CALL RTR_START_TX Page Page CLEAR CLEAR Page CREATE FACILITY RTR$DEFAULT_FACILITY /BACKEND /FRONTEND /ROUTER Page Page Page CREATE JOURNAL df /dev /rtrjnl Page CREATE PARTITION CREATE PARTITION partition_name Page Page DEFINE /KEY OpenVMS DCL DEFINE /KEY DEFINE /KEY /STATE DEFAULT RTR DEFINE /KEY /ECHO /NOTERMINATE /NOLOCK_STATE /LOCK_STATE DEFAULT state-name /NOSET_STATE SHOW RTR /NOTERMINATE /TERMINATE Page DELETE FACILITY DELETE FACILITY Page DELETE JOURNAL DELETE JOURNAL Page DELETE PARTITION DELETE PARTITION Page DISPLAY BAR DISPLAY BAR damping-factor /VALUE=CURRENT /RATE interval /RATE=60 Page Page DISPLAY NUMERIC DISPLAY NUMERIC damping-factor /VALUE=CURRENT decimal-places /RATE interval /RATE=60 Page Page DISPLAY STRING DISPLAY STRING Page /WIDTH=0 Page DISPLAY SYMBOLIC DISPLAY SYMBOLIC DISPLAY SYMBOLIC DISPLAY SYMBOLIC DISPLAY TEXT DISPLAY TEXT MONITOR/FACILITY=facility-name facility-name process-id node-name MONITOR/LINK=node-name Page DO DO Page FLUSH NAME_CACHE FLUSH NAME_CACHE EXECUTE EXIT EXTEND FACILITY FE FETRBE facnam NFE rtr_open_channel /BACKEND /FRONTEND /ROUTER Page Page Page LOG LOG Page MODIFY JOURNAL MODIFY JOURNAL maximum_allowed target MODIFY JOURNAL OpenVMS Example MONITOR /COUNT nr-updates node$facility$partition-id Delay-seconds Page QUIT RECALL RECALL command-specifier or either RECALL/ALL REGISTER RESOURCE MANAGER (REGISTER RM) RTR$DEFAULT_RESOURCE UNREGISTER RESOURCE MANAGER SHOW RESOURCE MANAGER Page SCROLL SCROLL SET ENVIRONMENT SET ENVIRONMENT SET FACILITY SET FACILITY quorate /QUORUM_THRESHOLD=n /BROADCAST_MINIMUM_RATE=2000 /BROADCAST_MINIMUM_RATE=nnnn SET FACILITY quorum_threshold Page SET LINK SET LINK SHOW LINK/COUNTER link-name SHOW LINK/STATUS Page Page Page SET LOG SET LOG /FILE /OPERATOR SET LOG SET MODE SET MODE /NOGROUP /GROUP SET MODE SET MODE SET NODE SET NODE SET NODE set link [isolated-node]/enable set node/noisolate SET NODE SET PARTITION partition_name facility_name:partition_name Page CREATE PARTITION SET TRANSACTION transaction_id new_state Page SHOW CHANNEL SHOW CHANNEL SHOW CHANNEL call rtr_open_channel() CLI_CHN2 CLI_CHN RTR$DEFAULT_CHANNEL SHOW CLIENT SHOW CLIENT SHOW CLIENT SHOW DISPLAY SHOW DISPLAY SHOW DISPLAY CALLS SHOW DISPLAY DISPLAY SHOW ENVIRONMENT SHOW FACILITY SHOW FACILITY facility-name Facility-name /CONFIGURATION /LINK /STATE DELETE FACILITY Page SHOW JOURNAL SHOW JOURNAL SHOW JOURNAL DELETE JOURNAL INITIALIZE JOURNAL SHOW KEY SHOW KEY /NOIF_STATE SHOW KEY Page SHOW LINK SHOW LINK node-name Node-name SHOW LINK /FACILITY/STATE SET LINK SHOW FACILITY/LINK SHOW LOG SHOW LOG SHOW LOG rtr_logfile.log SHOW MODE SHOW MODE Page SHOW NODE SHOW NODE SHOW NODE SHOW PARTITION Last Rcvy BE: Txns Rcvrd: Page Page SHOW PROCESS SHOW PROCESS /COUNTER SHOW PROCESS SHOW PROCESS Page SHOW RESOURCE MANAGER (SHOW RM) SHOW RESOURCE MANAGER (SHOW RM) SHOW RESOURCE MANAGER (SHOW RM) SHOW RTR SHOW RTR SHOW RTR STOP RTR SHOW SEGMENT SHOW SEGMENT definition SHOW SEGMENT Page SHOW SERVER SHOW SERVER Page Page SHOW TRANSACTION Page Page SPAWN SPAWN SPAWN START RTR users of RTR relations cache_pages partitions ast-limit time-limit buffer-limit io-buffered io-direct enqueue-limit max-links job-table-quota file-limit page-file subprocess-limit max-working-set extent working-set Page STOP RTR STOP RTR STOP RTR STOP RTR TRIM FACILITY TRIM FACILITY Page Page UNREGISTER RESOURCE MANAGER (UNREGISTER RM) A Creating Monitor Pictures monitor file RTR MONITOR counters A.1 Interactive Denition of a Monitor Picture $TIME MONITOR MYPICTURE MYPICTURE.MON /Y A.2 Substitution Symbols $TIME:5 $TIME A.3 Arithmetic Expressions and Operators Page A.3 Arithmetic Expressions and Operators /AVERAGE=() Page B Server Shadowing and Recovery both similar same B.3 The RTR Journal System B.3 The RTR Journal System B.4 Shadow Site Failure and Journaling B.4 Shadow Site Failure and Journaling B.4.1 Maximum Journal Size max_segments_per_disk * disk_blocks_per_segment Cluster C1 B.5 Standby for Shadows Cluster C2 B.6 Performance B.6 Performance B.7 Shadows in Action B.8 Application Considerations B.8 Application Considerations B.9 Server States B.9 Server States Figure B2 Server States Server Shadowing and Recovery B7 B.10 Client States B.10 Client States B.11 Partition States B.11 Partition States S i P SHOW PARTITION/FULL Page C XA Support rtr_mt_msg1_uncertain C.1 Introduction C.1.1 MONITOR XA C.2 Microsoft DTC Support D RTR Utility Error Messages Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page E RTR log messages Page Page Page Page Page Page Page Page Page Page Page Page Page Index A B C D E F G H I N O P Q R T U V W X