CONTENTS Title Page Copyright Page Preface 1 Introduction 1.1 Getting started 1.2 Entering commands 1.3 Online help 1.4 Command procedures 1.5 Defining keys 1.6 Initial command procedure 1.7 Remote commands 2 Starting and Setting Up RTR 2.1 Introduction 2.2 Setting Up-An Example 2.3 Initializing a Recovery Journal 2.4 Changing a Network 2.5 Setting up Call-out Servers 2.6 Router Load Balancing 3 Monitoring RTR 3.1 Introduction 3.2 Standard Monitor Pictures 3.2.1 Monitor Active 3.2.2 Monitor Cache 3.2.3 Monitor Calls 3.2.4 Monitor Channel 3.2.5 Monitor CHMDATA 3.2.6 Monitor CHMMSG 3.2.7 Monitor Congestion 3.2.8 Monitor Delayproc 3.2.9 Monitor Facility 3.2.10 Monitor Failure 3.2.11 Monitor Flow 3.2.12 Monitor INBYTES 3.2.13 Monitor INMESSAGES 3.2.14 Monitor INPACKETS 3.2.15 Monitor Journal 3.2.16 Monitor Link 3.2.17 Monitor Locks 3.2.18 Monitor Memory 3.2.19 Monitor MSGACPSYS 3.2.20 Monitor OUTBYTES 3.2.21 Monitor OUTMESSAGES 3.2.22 Monitor OUTPACKETS 3.2.23 Monitor Packets 3.2.24 Monitor Partition 3.2.25 Monitor Process 3.2.26 Monitor Queue 3.2.27 Monitor Quorum 3.2.28 Monitor Recovery 3.2.29 Monitor Response 3.2.30 Monitor Routing 3.2.31 Monitor Routers 3.2.32 Monitor RTR 3.2.33 Monitor Stalls 3.2.34 Monitor System 3.2.35 Monitor TOPTPS 3.2.36 Monitor TPS 3.2.37 Monitor Traffic 4 RTR Utility Command Reference ADD FACILITY ATTACH CLEAR CREATE FACILITY CREATE JOURNAL DEFINE /KEY DELETE FACILITY DELETE JOURNAL DISPLAY BAR DISPLAY NUMERIC DISPLAY SYMBOLIC DISPLAY TEXT DO EXTEND FACILITY INITIALIZE JOURNAL MODIFY JOURNAL MONITOR PRINT RECALL SCROLL SET ENVIRONMENT SET FACILITY SET LINK SET LOG SET MODE SET NODE SHOW CHANNEL SHOW DISPLAY SHOW ENVIRONMENT SHOW FACILITY SHOW JOURNAL SHOW KEY SHOW LINK SHOW LOG SHOW MODE SHOW NODE SHOW PARTITION SHOW PROCESS SHOW REQUESTER SHOW RTR SHOW SEGMENT SHOW SERVER SHOW TRANSACTION SPAWN START REMOTE_CLIENT_HANDLER START RTR STOP REMOTE_CLIENT_HANDLER STOP RTR TRIM FACILITY 5 DCL Interface to RTR System Services 5.1 Introduction 5.2 Examples 6 RTR System Services Command Reference SYS$ABORT_TX SYS$COMMIT_TX SYS$DCL_TX_PRC SYS$DEQ_TX SYS$ENQ_TX SYS$START_TX SYS$SYNCH SYS$VOTE_TX A Troubleshooting RTR Applications A.1 RTR START RTR Qualifier Values A.2 DECnet Parameters A.3 Enabling RTR logging A.4 Starting a Facility A.5 Analyzing RTR Application Performance A.6 Using the Snapshot Procedure A.7 Making an RTRACP dump B Creating Monitor Pictures B.1 Interactive definition of a monitor picture B.2 Example of a monitor file B.3 Substitution symbols B.4 Arithmetic Expressions and Operators B.5 Counters C Quorum Consensus C.1 What is Quorum Consensus? C.1.1 Quorum Establishment and Negotiation C.1.2 Quorum and Lost Links C.2 Router and Backend Quorum C.3 Quorum: A Simple Case C.4 Quorum: Inconsistent Views C.5 Network partitioning C.6 Quorum Commands and Quorum Troubleshooting C.6.1 Monitor Quorum Display C.6.2 Quorum Error Example D Server Shadowing and Recovery D.1 Primary and Secondary Roles D.2 Automatic features D.2.1 Shadow Events D.3 The RTR Journal System D.4 Shadow Site Failure and Journaling D.5 Standby for Shadows D.5.1 Server Flag Interpretation D.6 Performance D.7 Shadows in Action D.8 Application considerations D.9 Server states D.10 Requester states D.11 Partition states E Flow Control E.1 Reason for flow control E.2 Analyzing Traffic Throughput E.3 Effects of flow control E.4 How Flow Control works F RTR Utility error messages G RTR log messages EXAMPLES 2-1 Local configuration of each node 2-2 Remote setup from one node 2-3 Reconfiguration Using DELETE and CREATE 2-4 Reconfiguration Using EXTEND FACILITY 2-5 Configuration of call-out servers 5-1 Requester 5-2 Server 5-3 Combined requester and server B-1 Interactive picture definition B-2 TPS monitor file B-3 Arithmetic Operators Examples E-1 RTR MONITOR CALLS E-2 RTR MONITOR TRAFFIC E-3 RTR MONITOR DELAY E-4 RTR MONITOR FACILITY E-5 RTR MONITOR LINK E-6 RTR MONITOR CHMDATA E-7 RTR MONITOR MEMORY E-8 RTR MONITOR FLOW FIGURES 2-1 Configuration example 2-2 Extend Configuration example B-1 Interactively defined monitor picture B-2 TPS monitor picture C-1 Quorum: A simple case C-2 Quorum: Inconsistent Views C-3 Quorum: Two Islands C-4 Quorum: Large Island Lost D-1 Four Node Shadow/Standby Configuration D-2 Server States D-3 Requester States D-4 Partition States TABLES 3-1 Standard monitor pictures 3-2 Monitor Partition, States 3-3 Monitor Recovery, States 4-1 Key names 6-1 Key types B-1 Substitution symbols B-2 Arithmetic Operators in Display Commands B-3 Facility Counters B-4 Link Counters B-5 Node Counters B-6 Process Counters B-7 Partition Counters E-1 Per Facility Counters E-2 Per Link Counters