Compaq AAR-88LB-TE manual

Reliable T ransaction Router Migration Guide Order Number: AA–R88LB–TE June 1999 This guide explains how to migrate from Reliable T ransaction Router™ (RTR) V ersion 2 to RTR V ersion 3 on OpenVMS™ systems, and provides information on new and obsolete features. Revision/Update Information: This guide supersedes the Reliable T ransaction Rou[...]

First Printing, December 1997 Revised, June 1999 COMP AQ COMPUTER CORPORA TION SHALL NOT BE LIABLE FOR TECHNICAL OR EDI‘ ERRORS OR OMISSIONS CONT AINED HEREIN, NOR FOR INCIDENT AL OR CONSEQUENTIAL DAMAGES RESUL TING FROM THE FURNISHING, PERFORMANCE, OR USE OF THIS MA TERIAL. THIS INFORMA TION IS PROVIDED "AS IS" AND COMP AQ COMPUTER COR[...]

Contents Preface ............................................................ vii 1 Introduction 1.1 Why Migrate? ............................................... 1–1 1.2 Goals and Nongoals . . ........................................ 1–2 1.3 Reading Guidelines . . ........................................ 1–2 2 Installation 2.1 Cleaning Up the[...]

5 System Management 5.1 OpenVMS Quotas ............................................ 5–1 5.2 Startup .................................................... 5–1 5.3 Creating Facilities . . . ........................................ 5–1 5.3.1 Naming Nodes . . . ........................................ 5–1 5.3.2 Modifying Facility Configurations[...]

Index T ables 2–1 OpenVMS Limits . ........................................ 2–3 2–2 OpenVMS Disk Requirements ............................... 2–5 3–1 RTR Executables . ........................................ 3–1 5–1 Interoperability Between Nodes .............................. 5–2 5–2 Obsolete RTR V ersion 2 Monitor Pictures ....[...]

[...]

Preface This guide explains how to migrate a Reliable T ransaction Router (RTR) environment and RTR applications from RTR V ersion 2 to RTR V ersion 3. It assumes that the application continues to use the RTR V ersion 2 application programming interface (API) without change. It also provides information on new and obsolete features. Audience This g[...]

Related Documents The following documents provide more information about topics discussed in this guide: Document Title Description Reliable T ransaction Router Installation Guide Describes how to install Reliable T ransaction Router . Reliable T ransaction Router System Manager ’ s Manual Describes how to configure, manage, and monitor Reliable[...]

Convention Meaning monospace Indicates the actual commands, words, or characters that you type in a dialog box, at a command prompt, or system output. Note: Provides information of special importance. / A forward slash in command descriptions indicates that a command qualifier follows. . . . A horizontal ellipsis following an entry in a command li[...]

[...]

1 Introduction This document is intended to assist RTR V ersion 2 users to migrate to RTR V ersion 3. 1.1 Why Migrate? Migration to RTR V ersion 3 takes advantage of the new features and improved capabilities of RTR V ersion 3. These include: • Improved installation procedure using Polycenter Software Installation Utility (PCSI), not VMSINST AL ?[...]

Introduction 1.1 Why Migrate? • Support for subtransactions or nested transactions Additionally , other considerations are: • New features will be implemented in RTR V ersion 3, not in RTR V ersion 2 • Some software problems will be addressed only in RTR V ersion 3 and not in RTR V ersion 2 • Some improved capabilities are already available[...]

2 Installation The installation for RTR V ersion 3 has changed significantly from V ersion 2. In V ersion 2, the installation tool was VMSINST AL; for V ersion 3, the installation tool is PCSI. Follow instructions in the Reliable T ransaction Router Installation Guide to perform your RTR V ersion 3 installation. Note Reading Release Notes in RTR V[...]

Installation 2.2 Preserving the Old Environment 2.2 Preserving the Old Environment Applications that run in the RTR V ersion 2 environment on OpenVMS systems will run in the RTR V ersion 3 environment on OpenVMS systems. However , as part of your testing and verification of the new environment, you should check that an RTR V ersion 2 application r[...]

Installation 2.5 Process Quotas T able 2–1 OpenVMS Limits Limit Name OpenVMS Name V alue for ACP V alue for Application AST queue limit ASTlm 2000 or more Byte count limit Bytlm 32K + (32K * appn †) Not less than 100K Buffered I/O count limit BIOlm Not less than 3 * appn Direct I/O count limit DIOlm 2000 or more Paging file limit Pgflquo Not [...]

Installation 2.6 Journal Issues 2.6.1 Removing the Old Journal T o verify that the new journal is running correctly , use the DUMP JOURNAL command to verify that transactions are processing as expected, and to be sure that all transactions have completed before bringing down RTR to install RTR V ersion 3. There is no need to save the old journal ?[...]

Installation 2.8 Memory and Disk Requirements T able 2–2 OpenVMS Disk Requirements Requirement RTR V ersion 2 RTR V ersion 3 Disk space (installation) 40,000 blocks (20MB) 50,000 blocks (25MB) Disk space (permanent) 24,000 blocks (12MB) 36,000 blocks (18MB) 2.9 Rollback to RTR V ersion 2 T o restore the RTR V ersion 2 environment if RTR V ersion [...]

[...]

3 Architectural Changes RTR V ersion 3 introduces certain process and other architectural changes. The following sections highlight these changes. 3.1 RTR Daemon Process In RTR V ersion 3, a new RTR daemon process (called RTRD) is used by the RTRACP process to build TCP/IP connections for internode links. The RTR daemon process is present only on s[...]

Architectural Changes 3.3 The Shared Library (LIBRTR.EXE) T able 3–1 (Cont.) RTR Executables RTR V ersion 2 RTR V ersion 3 RTRRTL No longer apply . 3.4 The ACP Process The RTR Application Control Process (ACP) handles application control, and has the process name RTRACP . This is unchanged from RTR V ersion 2. 3.5 Interprocess Communication In RT[...]

Architectural Changes 3.8 Quorum Issues 3.8 Quorum Issues Network partitioning in RTR V ersion 3 is based on a router and backend count, whereas in RTR V ersion 2 it was based on quorum. However , quorum is still used in RTR V ersion 3; state names and some quorum-related displays have changed. Additionally , the quorum-related condition of a node [...]

[...]

4 Network Issues W ith RTR V ersion 3, two network transports are available: • DECnet (default on OpenVMS) • TCP/IP At least one transport is required. If a destination supports both transports, RTR V ersion 3 can use either . Any node can run either protocol, but the appropriate transport software must be running on that node. For example, for[...]

Network Issues 4.3 Specifying a Preferred T ransport 4.3 Specifying a Preferred T ransport During installation, the system manager can specify either transport, using logical names RTR_DNA_FIRST or RTR_TCP_FIRST . For example, in the RTR$ST ARTUP .COM file (found in SYS$ST ARTUP), the following line specifies DECnet as the default transport: $ DE[...]

5 System Management A number of changes that affect system management have been introduced with RTR V ersion 3. The following sections describe these changes. 5.1 OpenVMS Quotas RTR V ersion 2 used OpenVMS quota values specified on the RTR ST ART command or calculated defaults. Because RTR V ersion 3 uses dynamic allocation (with the exception of [...]

System Management 5.4 Interoperability 5.4 Interoperability All supported operating systems can interoperate together in the RTR environment, as described in T able 5–1. T able 5–1 Interoperability Between Nodes RTR V ersion 3 nodes interoperate with... Description Other RTR V ersion 2 nodes In RTR V ersion 3, RTR uses data marshalling (examina[...]

System Management 5.5 Monitoring T able 5–3 New RTR V ersion 3 Monitor Pictures Picture Description accfail Shows most recent links on which a connection attempt was declined. acp2app Shows RTRACP-to-application message counts. app2acp Shows application-to-RTRACP message counts. broadcast Shows information about RTR user events by process. connec[...]

System Management 5.5 Monitoring 5.5.5 History Screens New monitor screens that show partition state or network connection history include MONITOR accfail and MONITOR rscbe. 5.6 Remote Command Support W ith the new support for TCP/IP , you can execute commands on remote systems using the rsh utility . T o use this feature, check your operating syst[...]

System Management 5.1 1 Interpreting Output from SHOW Commands T able 5–4 (Cont.) Changed SHOW COMMANDS Command Description SHOW TRANSACTION W ith the SHOW TRANSACTION command, you can now specify display for a frontend, backend, or router . SHOW F ACILITY/LINK The SHOW F ACILITY/LINK command provides new information on states. SHOW P ARTITION /F[...]

System Management 5.12 Comparing RTR V ersion 2 and V ersion 3 Utility Commands T able 5–6 (Cont.) New OpenVMS RTR Utility Commands Command Name Description QUIT Exits RTR. REGISTER RM 1 Registers resource managers with the current transaction manager . SET P ARTITION Sets partition properties. SET TRANSACTION Changes the state of a transaction. [...]

6 Running V ersion 2 Applications In this chapter the term OpenVMS API refers to the Reliable T ransaction Router for OpenVMS V ersion 2. The term Portable API refers to the API used in Reliable T ransaction Router for OpenVMS V ersion 3. W ith RTR V ersion 3, the Portable API provides: • Portability over a wide range of language and machine envi[...]

Running V ersion 2 Applications 6.1 Comparison of OpenVMS API and Portable API T able 6–1 OpenVMS API and Portable API Comparison OpenVMS API (V ersion 2) Portable API (V ersion 3) $dcl_tx_prc( ) rtr_open_channel( ) $start_tx( ) rtr_start_tx( ) [optional] $commit_tx( ) rtr_accept_tx( ) $abort_tx( ) rtr_reject_tx( ) $vote_tx( ) rtr_accept_tx( ) rt[...]

Running V ersion 2 Applications 6.2 Recompiling and Relinking 6.2.1 RTR V ersion 2 Applications Running on RTR V ersion 3 • Linking V ersion 2 applications Existing RTR V ersion 2 applications will run if they have been linked against RTRSHR. (RTRSHR has been superseded by LIBRTR.EXE. Existing RTR V ersion 2 application executables will run witho[...]

Running V ersion 2 Applications 6.3 Running Applications Installed with Privileges 6.3 Running Applications Installed with Privileges W ith RTR V ersion 2, RTR calls execute in kernel mode; with RTR V ersion 3, RTR runs in application process mode, normally user mode. 6.3.1 Running Clients That Share Channels W ith RTR V ersion 2, clients that star[...]

Running V ersion 2 Applications 6.6 Threaded Applications 6.6 Threaded Applications W ith RTR V ersion 3, applications that rely on threading may not work exactly the same way they worked with RTR V ersion 2 on OpenVMS. Applications that use kernel threads with RTR V ersion 2 will not work with RTR V ersion 3. RTR V ersion 2 was thread-reentrant, b[...]

[...]

7 Performance T ips W ith RTR V ersion 3, there are several considerations for improving performance. These are described in the following sections. 7.1 Process Quotas OpenVMS process quotas should be increased to accomodate the use of mailboxes for processes. Check the RTR Installation Guide for the specific formula to use. 7.2 Journal Sizing W i[...]

Performance Tips 7.6 Simultaneous Multiprocessing 7.6 Simultaneous Multiprocessing W ith RTR V ersion 2, threaded applications could use Symmetric Multiprocessing (SMP) effectively . In RTR V ersion 3, SMP will not provide the performance advantages of RTR V ersion 2. The single control process of RTRACP in RTR V ersion 3 does not take advantage of[...]

8 Problem Diagnosis and Reporting RTR V ersion 3 provides a new error log and logical names to assist tracing errors including: • the RTR operator log file, capturing events that occur , and useful for diagnosis of problems • the RTR_ERROR.LOG file • the dump file (.DMP), a binary crash dump that, if needed, must be sent to your support se[...]

Problem Diagnosis and Reporting 8.4 Producing and Directing a T race or set trace/subsystem=(API, CIF, CRM) Starts the trace on subsystems API, CIF and CRM. 4. set mode/nounsupported Sets mode to supported. . T race continues. . T race continues. 5. set mode/unsupp Sets mode to unsupported. 6. set trace Stops the trace. 7. set mode/nounsupp Sets mo[...]

Index A ABORT command, 6–3 ANAL YZE/SYSTEM, 8–2 API OpenVMS, 6–1 Portable, 6–1 API (defined), vii B Back ends, 2–2 C Cache, 3–2 Call RTR_<routine>, 5–6 Call stack, 8–1 Channel number, 6–3 CLI, 5–4 Command ABORT, 6–3 CREA TE P ARTITION, 5–6 DELETE P ARTITION, 5–6 DISPLA Y STRING, 5–6 DUMP JOURNAL, 2–4, 5–6 EXEC[...]

M MONITOR, 7–1 Monitor pictures, 5–2 MONITOR QUORUM, 3–3 Multihoming, 4–1 Multiple network transports, 4–1 N Name server, 4–1 Nested transactions, 1–2 Network partition, 3–3 O OpenVMS API, 6–1 P Partition network, 3–3 Partition states server-process, 3–3 PCSI (defined), 1–1 Pictures monitor, 5–2 Portable API, 6–1 Proces[...]