TIBCO Rendezvous®

Installation
Software Release 8.4
February 2012
Important Information
SOME TIBCO SOFTWARE EMBEDS OR BUNDLES OTHER TIBCO SOFTWARE. USE OF SUCH EMBEDDED
OR BUNDLED TIBCO SOFTWARE IS SOLELY TO ENABLE THE FUNCTIONALITY (OR PROVIDE LIMITED
ADD-ON FUNCTIONALITY) OF THE LICENSED TIBCO SOFTWARE. THE EMBEDDED OR BUNDLED
SOFTWARE IS NOT LICENSED TO BE USED OR ACCESSED BY ANY OTHER TIBCO SOFTWARE OR FOR
ANY OTHER PURPOSE.
USE OF TIBCO SOFTWARE AND THIS DOCUMENT IS SUBJECT TO THE TERMS AND CONDITIONS OF A
LICENSE AGREEMENT FOUND IN EITHER A SEPARATELY EXECUTED SOFTWARE LICENSE
AGREEMENT, OR, IF THERE IS NO SUCH SEPARATE AGREEMENT, THE CLICKWRAP END USER
LICENSE AGREEMENT WHICH IS DISPLAYED DURING DOWNLOAD OR INSTALLATION OF THE
SOFTWARE (AND WHICH IS DUPLICATED IN THE LICENSE FILE) OR IF THERE IS NO SUCH SOFTWARE
LICENSE AGREEMENT OR CLICKWRAP END USER LICENSE AGREEMENT, THE LICENSE(S) LOCATED
IN THE “LICENSE” FILE(S) OF THE SOFTWARE. USE OF THIS DOCUMENT IS SUBJECT TO THOSE TERMS
AND CONDITIONS, AND YOUR USE HEREOF SHALL CONSTITUTE ACCEPTANCE OF AND AN
AGREEMENT TO BE BOUND BY THE SAME.
This document contains confidential information that is subject to U.S. and international copyright laws and
treaties. No part of this document may be reproduced in any form without the written authorization of TIBCO
Software Inc.
TIBCO, The Power of Now, TIB, Information Bus, Rendezvous, TIBCO Rendezvous and Messaging Appliance
are either registered trademarks or trademarks of TIBCO Software Inc. in the United States and/or other
countries.
EJB, Java EE, J2EE, and all Java-based trademarks and logos are trademarks or registered trademarks of Sun
Microsystems, Inc. in the U.S. and other countries.
All other product and company names and marks mentioned in this document are the property of their
respective owners and are mentioned for identification purposes only.
THIS SOFTWARE MAY BE AVAILABLE ON MULTIPLE OPERATING SYSTEMS. HOWEVER, NOT ALL
OPERATING SYSTEM PLATFORMS FOR A SPECIFIC SOFTWARE VERSION ARE RELEASED AT THE SAME
TIME. SEE THE README FILE FOR THE AVAILABILITY OF THIS SOFTWARE VERSION ON A SPECIFIC
OPERATING SYSTEM PLATFORM.
THIS DOCUMENT IS PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR
IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT.
THIS DOCUMENT COULD INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICAL ERRORS.
CHANGES ARE PERIODICALLY ADDED TO THE INFORMATION HEREIN; THESE CHANGES WILL BE
INCORPORATED IN NEW EDITIONS OF THIS DOCUMENT. TIBCO SOFTWARE INC. MAY MAKE
IMPROVEMENTS AND/OR CHANGES IN THE PRODUCT(S) AND/OR THE PROGRAM(S) DESCRIBED IN
THIS DOCUMENT AT ANY TIME.
THE CONTENTS OF THIS DOCUMENT MAY BE MODIFIED AND/OR QUALIFIED, DIRECTLY OR
INDIRECTLY, BY OTHER DOCUMENTATION WHICH ACCOMPANIES THIS SOFTWARE, INCLUDING
BUT NOT LIMITED TO ANY RELEASE NOTES AND "READ ME" FILES.
Copyright © 1997–2012 TIBCO Software Inc. ALL RIGHTS RESERVED.
TIBCO Software Inc. Confidential Information
 | iii

Contents

Figures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .vii

Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix

New or Modified Sections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii
Manual Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xiv
Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv
TIBCO Rendezvous Documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv
Typographical Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvii
Connecting with TIBCO Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xx
How to Join TIBCOmmunity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xx
How to Access All TIBCO Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xx
How to Contact TIBCO Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xx

Chapter 1 Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1
Before You Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Directory Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Platform-Specific Installation Procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Chapter 2 UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5
Before You Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Running rvd with Increased Scheduling Priority . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Size and Time to Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Installing Several Instances on One File System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Select the Installation Package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Run the Installer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Review the Administrator’s Checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Chapter 3 Microsoft Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11

Select and Run the Installer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Check the README File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

TIBCO Rendezvous Installation

iv
| Contents
Windows Registry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Review the Administrator’s Checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Chapter 4 VMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Log In as SYSTEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Check TCP/IP Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
VMS Installation Package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
ZIP Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
File Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Mount the Distribution Media . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Check Storage Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Install the Rendezvous Product Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Verify Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Daemon Privilege and Priority . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
OPER. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
ALTPRI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Starting the Rendezvous Daemon at Boot Time. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Parameters for rvd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Byte Limit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Total Non-Paged Storage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Page File Quota . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Channel Count . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
User Accounts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Review the Administrator’s Checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
C++ Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Rebuilding the C++ Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Additional Information for VMS Programmers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Compile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Chapter 5 IBM i . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
IBM i Installation Package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Post-Installation Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Check the AAREADME File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Review the Administrator’s Checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

Chapter 6 Universal Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

Before Installing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

TIBCO Rendezvous Installation

 Contents v
|
Destination Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Installer Account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Installer Log File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Disk Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Install TIBCO Rendezvous. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Install in GUI Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Install in Console Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Install in Silent Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Uninstalling TIBCO Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Uninstall in GUI Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Uninstall in Silent Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .55

TIBCO Rendezvous Installation

vi
| Contents

TIBCO Rendezvous Installation

 | vii

Figures

Figure 1 IBM i: Beginning the Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

TIBCO Rendezvous Installation

viii
| Figures

TIBCO Rendezvous Installation

 | ix

Tables

Table 1 General Typographical Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvii

Table 2 Syntax Typographical Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviii
Table 3 Distribution Directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Table 4 Installation Procedure by Platform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Table 5 UNIX Installation Directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Table 6 Microsoft Windows Distribution Directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Table 7 VMS Distribution Directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Table 8 VMS Distribution Directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Table 9 VMS Installation Size (in blocks) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Table 10 IBM i Distribution Directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

TIBCO Rendezvous Installation

x
| Tables

TIBCO Rendezvous Installation

 New or Modified Sections
| xi

New or Modified Sections

UNIX Installation Directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Microsoft Windows Distribution Directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Install in GUI Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Uninstall in GUI Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

TIBCO Rendezvous Installation

xii
| New or Modified Sections

TIBCO Rendezvous Installation

 | xiii

Preface

TIBCO Rendezvous® is a messaging infrastructure product.

TIBCO is proud to announce the latest release of TIBCO Rendezvous®. This
release is the latest in a long history of TIBCO products that leverage the power of
the Information Bus® to enable truly event-driven IT environments. To find out
more about how TIBCO Rendezvous and other TIBCO products are powered by
TIB® technology, please visit us at [Link].
This manual describes installation of TIBCO Rendezvous software. It is part of the
documentation set for Rendezvous Software Release 8.4.0.

This software may be available on multiple operating systems. However, not

all operating system platforms for a specific software version are released at the
same time. Please see the [Link] file for the availability of this software
version on a specific operating system platform.

Topics

• Manual Organization, page xiv

• Related Documentation, page xv
• Typographical Conventions, page xvii
• Connecting with TIBCO Resources, page xx

TIBCO Rendezvous Installation

xiv
| Manual Organization

Manual Organization

This book includes one chapter for each group of related operating system
platforms.

TIBCO Rendezvous Installation

 Preface xv
|

Related Documentation

This section lists documentation resources you may find useful.

TIBCO Rendezvous Documentation

The documentation road map shows the relationships between the books and
online references in this product’s documentation set.

z/OS Only

z/OS Installation
Installation Concepts and Configuration

COBOL
Administration C Reference
Reference

C++ Reference

Configuration
COM Reference
Tools

Java Reference
RVDM JMX
MBean API
.NET Reference
Reference Pages

Legend PDF HTML

The following documents form the Rendezvous documentation set:

• TIBCO Rendezvous Concepts
Read this book first. It contains basic information about Rendezvous
components, principles of operation, programming constructs and
techniques, advisory messages, and a glossary. All other books in the
documentation set refer to concepts explained in this book.
• TIBCO Rendezvous C Reference
Detailed descriptions of each datatype and function in the Rendezvous C API.
Readers should already be familiar with the C programming language, as well
as the material in TIBCO Rendezvous Concepts.

TIBCO Rendezvous Installation

xvi
| Related Documentation

• TIBCO Rendezvous C++ Reference

Detailed descriptions of each class and method in the Rendezvous C++ API.
The C++ API uses some datatypes and functions from the C API, so we
recommend the TIBCO Rendezvous C Reference as an additional resource.
Readers should already be familiar with the C++ programming language, as
well as the material in TIBCO Rendezvous Concepts.
• TIBCO Rendezvous Java Reference
Detailed descriptions of each class and method in the Rendezvous Java
language interface. Readers should already be familiar with the Java
programming language, as well as the material in TIBCO Rendezvous Concepts.
• TIBCO Rendezvous .NET Reference
Detailed descriptions of each class and method in the Rendezvous .NET
interface. Readers should already be familiar with either C# or Visual Basic
.NET, as well as the material in TIBCO Rendezvous Concepts.
• TIBCO Rendezvous COM Reference
Detailed descriptions of each class and method in the Rendezvous COM
component. Readers should already be familiar with the programming
environment that uses COM and OLE automation interfaces, as well as the
material in TIBCO Rendezvous Concepts.
• TIBCO Rendezvous Administration
Begins with a checklist of action items for system and network administrators.
This book describes the mechanics of Rendezvous licensing, network details,
plus a chapter for each component of the Rendezvous software suite. Readers
should have TIBCO Rendezvous Concepts at hand for reference.
• TIBCO Rendezvous Configuration Tools
Detailed descriptions of each Java class and method in the Rendezvous
configuration API, plus a command line tool that can generate and apply
XML documents representing component configurations. Readers should
already be familiar with the Java programming language, as well as the
material in TIBCO Rendezvous Administration.
• TIBCO Rendezvous Installation
Includes step-by-step instructions for installing Rendezvous software on
various operating system platforms.
• TIBCO Rendezvous Release Notes
Lists new features, changes in functionality, deprecated features, migration
and compatibility information, closed issues and known issues.

TIBCO Rendezvous Installation

 Preface xvii
|

Typographical Conventions

The following typographical conventions are used in this manual.

Table 1 General Typographical Conventions

Convention Use
TIBCO_HOME Many TIBCO products must be installed within the same home directory. This
directory is referenced in documentation as TIBCO_HOME. The value of
ENV_HOME
TIBCO_HOME depends on the operating system. For example, on Windows
TIBRV_HOME systems, the default value is C:\tibco.
Other TIBCO products are installed into an installation environment. Incompatible
products and multiple instances of the same product are installed into different
installation environments. An environment home directory is referenced in
documentation as ENV_HOME. The default value of ENV_HOME depends on the
operating system. For example, on Windows systems the default value is
C:\tibco.

TIBCO Rendezvous installs into a version-specific directory inside TIBCO_HOME.

This directory is referenced in documentation as TIBRV_HOME. The value of
TIBRV_HOME depends on the operating system. For example on Windows
systems, the default value is C:\tibco\rv\8.4.

code font Code font identifies commands, code examples, filenames, pathnames, and
output displayed in a command window. For example:
Use MyCommand to start the foo process.

bold code Bold code font is used in the following ways:

font
• In procedures, to indicate what a user types. For example: Type admin.
• In large code samples, to indicate the parts of the sample that are of
particular interest.
• In command syntax, to indicate the default parameter for a command. For
example, if no parameter is specified, MyCommand is enabled:
MyCommand [enable | disable]

TIBCO Rendezvous Installation

xviii Typographical Conventions
|

Table 1 General Typographical Conventions (Cont’d)

Convention Use
italic font Italic font is used in the following ways:
• To indicate a document title. For example: See TIBCO FTL Concepts.
• To introduce new terms For example: A portal page may contain several
portlets. Portlets are mini-applications that run in a portal.
• To indicate a variable in a command or code syntax that you must replace.
For example: MyCommand PathName

Key Key name separated by a plus sign indicate keys pressed simultaneously. For
combinations example: Ctrl+C.
Key names separated by a comma and space indicate keys pressed one after the
other. For example: Esc, Ctrl+Q.

The note icon indicates information that is of special interest or importance, for
example, an additional action required only in certain circumstances.

The tip icon indicates an idea that could be useful, for example, a way to apply
the information provided in the current section to achieve a specific result.

The warning icon indicates the potential for a damaging situation, for example,
data loss or corruption if certain steps are taken or not taken.

Table 2 Syntax Typographical Conventions

Convention Use
[ ] An optional item in a command or code syntax.
For example:
MyCommand [optional_parameter] required_parameter

| A logical OR that separates multiple items of which only one may be chosen.
For example, you can select only one of the following parameters:
MyCommand para1 | param2 | param3

TIBCO Rendezvous Installation

 Preface xix
|

Table 2 Syntax Typographical Conventions

Convention Use
{ } A logical group of items in a command. Other syntax notations may appear
within each logical group.
For example, the following command requires two parameters, which can be
either the pair param1 and param2, or the pair param3 and param4.
MyCommand {param1 param2} | {param3 param4}

In the next example, the command requires two parameters. The first parameter
can be either param1 or param2 and the second can be either param3 or param4:
MyCommand {param1 | param2} {param3 | param4}

In the next example, the command can accept either two or three parameters.
The first parameter must be param1. You can optionally include param2 as the
second parameter. And the last parameter is either param3 or param4.
MyCommand param1 [param2] {param3 | param4}

TIBCO Rendezvous Installation

xx
| Connecting with TIBCO Resources

Connecting with TIBCO Resources

How to Join TIBCOmmunity

TIBCOmmunity is an online destination for TIBCO customers, partners, and
resident experts. It is a place to share and access the collective experience of the
TIBCO community. TIBCOmmunity offers forums, blogs, and access to a variety
of resources. To register, go to [Link]

How to Access All TIBCO Documentation

You can access TIBCO documentation here:
[Link]

How to Contact TIBCO Support

For comments or problems with this manual or the software it addresses, contact
TIBCO Support as follows:
• For an overview of TIBCO Support, and information about getting started
with TIBCO Support, visit this site:
[Link]
• If you already have a valid maintenance or support contract, visit this site:
[Link]
Entry to this site requires a user name and password. If you do not have a user
name, you can request one.

TIBCO Rendezvous Installation

 |1

Chapter 1 Introduction

This manual contains step-by step instructions for installing TIBCO Rendezvous®
software, release 8.4.0.

Topics

• Before You Install, page 2

• Platform-Specific Installation Procedures, page 4

TIBCO Rendezvous Installation

2
| Chapter 1 Introduction

Before You Install

Before you begin to install the software, do these items first:

• Read Compatibility with Earlier Releases on page 36 in TIBCO Rendezvous
Concepts.
• Read about any late-breaking changes, described in package inserts and
README files.

• Read the TIBCO Software Inc. License Agreement included with the product.
• Read the appropriate chapters for your platforms.
• Review the section Do This First—Administrator’s Checklist on page 1 in
TIBCO Rendezvous Administration.

TIBCO Rendezvous Installation

 Directory Structure 3
|

Directory Structure

When you install Rendezvous software, the installation directory contains these
subdirectories:

Table 3 Distribution Directories

Subdirectory Status
bin Required to develop or run Rendezvous programs.
Contents: executable files, shared libraries (DLL files).

lib Required to develop Rendezvous programs.

include Required to develop Rendezvous programs.

doc Optional on-line documentation (PDF and HTML).

src Optional source code for example programs.

TIBCO Rendezvous Installation

4
| Chapter 1 Introduction

Platform-Specific Installation Procedures

Each supported platform dictates a different installation procedure. Table 4

guides you to the appropriate procedures for the platforms at your site.

Table 4 Installation Procedure by Platform

Platform See
UNIX Chapter 2 on page 5

Microsoft Windows Chapter 3 on page 11

VMS Chapter 4 on page 17

IBM i Chapter 5 on page 35

z/OS See TIBCO Rendezvous for z/OS Installation

and Configuration

TIBCO Rendezvous Installation

 |5

Chapter 2 UNIX

Topics

• Before You Install, page 6

• Select the Installation Package, page 7
• Run the Installer, page 9
• Review the Administrator’s Checklist, page 10

TIBCO Rendezvous Installation

6
| Chapter 2 UNIX

Before You Install

Please consider these items before you install Rendezvous software on one or
more UNIX platforms.

Running rvd with Increased Scheduling Priority

You can improve performance by running the Rendezvous daemon (rvd) with
increased scheduling priority.
To arrange for increased priority, log in as root before running the INSTALL
program; when INSTALL asks if you wish to run the Rendezvous daemon as
setuid root, answer y (yes).
If you have already installed the Rendezvous software and want to change its
scheduling priority, use the UNIX chown and chmod commands to set the
Rendezvous daemon (rvd) to run as root.
Certain UNIX platforms let you set privileges (and hence, scheduling priority)
based on groups. That approach also works well for the Rendezvous daemon.
When rvd runs as root, it raises its scheduling priority, and then restores normal
user privileges (before executing any calls). File access does not occur while
running with special privileges.

Size and Time to Install

Rendezvous software requires approximately 6 megabytes of storage and takes
less than 10 minutes to install. Instructions for installation follow.

Installing Several Instances on One File System

When installing on UNIX platforms, you can (serially) install several instances of
Rendezvous software in different directories on the same file system.

TIBCO Rendezvous Installation

 Select the Installation Package 7
|

Select the Installation Package

Download the appropriate installation package for your platforms and variant, or
locate it on the distribution DVD.
Installer package names concatenate three parts:
• Prefix TIB_rv_8.4.0_
• Core string denoting the operating system and hardware for which the
package is appropriate; see Table 5
(For the latest changes, see the README file.)
• Suffix indicating the archive type (for example .[Link])

Table 5 UNIX Installation Directories (Sheet 1 of 2)

Installer Package
OS Hardware Suffix Notes

General Information
The following UNIX installer packages include both 32-bit and 64-bit components, except as noted
below.

AIX 5.3, 6.1, 7.1 IBM RS/6000 aix53_power

HP/UX 11i HP-PA RISC hpux111_hppa

(v1, v2, v3)
IA64 (Itanium) hpux112_ia64

Mac OS X 10.5+ Intel macosx_x86 32-bit and 64-bit

components.

Novell SUSE Linux Intel linux26gl23_x86

Enterprise 11
Novell SUSE Linux
Enterprise 10 SP1

Novell SUSE Linux IBM zSeries linux26gl24_zseries 64-bit only.

Enterprise Server 11
Sold separately.
for IBM zSeries (11.3,
11.4)

TIBCO Rendezvous Installation

8
| Chapter 2 UNIX

Table 5 UNIX Installation Directories (Sheet 2 of 2)

Installer Package
OS Hardware Suffix Notes

Red Hat Enterprise Intel linux26gl23_x86

Linux 4, 5 (AS, ES)
Red Hat Enterprise
Linux 5 (Advanced
Platform, Classic)

Red Hat Enterprise Intel 64-bit linux26gl23_x86

Linux 6

Solaris 10 Intel sol10_x86

Sun SPARC sol8_sparc

Solaris 9 Sun SPARC sol8_sparc

Solaris 8 Sun SPARC sol8_sparc

TIBCO Rendezvous Installation

 Run the Installer 9
|

Run the Installer

Proceed to Chapter 6, Universal Installer, on page 43, and follow the installation
instructions there. When installation is complete, see Do This First—
Administrator’s Checklist on page 1 in TIBCO Rendezvous Administration.

TIBCO Rendezvous Installation

10
| Chapter 2 UNIX

Review the Administrator’s Checklist

The TIBCO Rendezvous Administration begins with a checklist for system

administrators. Review the steps in that list now, and complete the steps that are
appropriate for your site.

See
Do This First—Administrator’s Checklist on page 1 in TIBCO Rendezvous
Administration.

TIBCO Rendezvous Installation

 | 11

Chapter 3 Microsoft Windows

The Rendezvous installation procedures for all Windows platforms are identical.

Images in this chapter might not exactly match the images on your screen.

Topics

• Select and Run the Installer, page 12

• Check the README File, page 13
• Windows Registry, page 14
• Review the Administrator’s Checklist, page 15

TIBCO Rendezvous Installation

12
| Chapter 3 Microsoft Windows

Select and Run the Installer

Installation adds a Windows program group for Rendezvous software.

1. Locate the appropriate installation package for your platform. Package names
incorporate the operating system and hardware for which the package is
appropriate; see Table 6. (For the latest changes, see the README file.)

Table 6 Microsoft Windows Distribution Directories

Hardware
O/S Platform Platform Installer Package Notes

Windows Vista Intel TIB_rv_8.4.0_win_x86_vc8.zip For developers

Business Edition (32-bit) using Visual
Studio 2008
Windows XP
(VC9).
Windows 2003 Server
Windows 2008 Server
Windows 7

Windows Vista Intel TIB_rv_8.4.0_win_x86_64_vc8.zip For developers

Business Edition 64-bit (64-bit) using Visual
Studio 2008
Windows XP 64-bit
(VC9).
Windows 2003 Server
64-bit Windows
64-bit
does not support
Windows 2008 Server COM.
64-bit
Windows 7 64-bit

2. Proceed to Chapter 6, Universal Installer, on page 43, and follow the

installation instructions there. When installation is complete, return to
complete the instructions in the remainder of this chapter.

TIBCO Rendezvous Installation

 Check the README File 13
|

Check the README File

The README file contains up-to-the-minute information about the Rendezvous

software release, and a template for license ticket requests. We recommend that
you scan it for the latest news.

TIBCO Rendezvous Installation

14
| Chapter 3 Microsoft Windows

Windows Registry

You can arrange for Rendezvous components to run automatically by registering

them as Microsoft Windows services.

See
Register Windows Services on page 8 in TIBCO Rendezvous Administration
Windows Services on page 415 in TIBCO Rendezvous Administration.

TIBCO Rendezvous Installation

 Review the Administrator’s Checklist 15
|

Review the Administrator’s Checklist

The TIBCO Rendezvous Administration begins with a checklist for system

administrators. Review the steps in that list now, and complete the steps that are
appropriate for your site.

See
Do This First—Administrator’s Checklist on page 1 in TIBCO Rendezvous
Administration.

TIBCO Rendezvous Installation

16
| Chapter 3 Microsoft Windows

TIBCO Rendezvous Installation

 | 17

Chapter 4 VMS

Follow these instructions to install Rendezvous software on VMS platforms.

Installation on VMS platforms uses the VMSINSTAL utility, which is described in
the OpenVMS system management documentation.

VMS does not support the PGM variant.

Topics

• Log In as SYSTEM, page 18

• Check TCP/IP Services, page 19
• VMS Installation Package, page 20
• Mount the Distribution Media, page 21
• Install the Rendezvous Product Software, page 23
• Verify Installation, page 24
• Daemon Privilege and Priority, page 25
• Starting the Rendezvous Daemon at Boot Time, page 26
• Parameters for rvd, page 27
• User Accounts, page 29
• Review the Administrator’s Checklist, page 30
• Additional Information for VMS Programmers, page 32

TIBCO Rendezvous Installation

18
| Chapter 4 VMS

Log In as SYSTEM

Log in to the SYSTEM account.

TIBCO Rendezvous Installation

 Check TCP/IP Services 19
|

Check TCP/IP Services

Rendezvous software will operate properly only if you have installed and started
HP TCP/IP Services, or a fully-compliant third-party TCP/IP product. (The
appropriate release number of that software may vary; see Table 7.)

Table 7 VMS Distribution Directories

Platform Hardware Platform TCP/IP Version

OpenVMS Itanium v.8.2 or later HP Integrity/Itanium HP TCP/IP Services V5.5 (or later)

Although you can successfully install the Rendezvous files without running
TCP/IP services, the Rendezvous installation verification procedure will fail if
TCP/IP services have not been started.

TIBCO Rendezvous Installation

20
| Chapter 4 VMS

VMS Installation Package

The distribution DVD contains the Rendezvous software for VMS platforms, as
shown in Table 8. These files are also available for download from the TIBCO web
site.

Table 8 VMS Distribution Directories

Hardware
Platform Installer Package Notes
Platform
OpenVMS Itanium HP TIB_rv_8.4.0_vms82_ia64.zip Does not support
v.8.2 or later Integrity/Itanium Java or RVDM.
This package
provides only 32-bit
API and daemons.

ZIP Files
Installation packages are zipped (compressed) using the VMS free software ZIP
utility. To preserve the file attributes, unzip them on a VMS computer (and not on
a PC or UNIX computer).
Utilities to decompress zip files are available on the HP OpenVMS Freeware
distributions, or at the HP web site:
[Link]

File Attributes
When copying VMS save sets through a Windows PC or UNIX computer, the
resulting files do not retain the proper file attributes. As a result, the VMS BACKUP
utility cannot read them to install them.
To rectify this situation, copy the files to a computer running VMS, and use this
command to restore the correct file attributes:
$ SET FILE/ATTR=(RFM:FIX,RAT:NONE,LRL:8192) TIBRV*.%

TIBCO Rendezvous Installation

 Mount the Distribution Media 21
|

Mount the Distribution Media

Insert the Rendezvous distribution DVD into the DVD drive.

The mount command automatically determines that the DVD is formatted
according to ISO 9660, but you must specify the record format for the backup save
sets. For example:
$ MOUNT /MEDIA=CDROM /UNDEF=FIX:NONE:8192 /OVERRIDE=ID DVD_device

TIBCO Rendezvous Installation

22
| Chapter 4 VMS

Check Storage Space

Table 4 approximates the space required for Rendezvous installation on VMS

computers. To estimate the amount of free space required on the target device,
add the figures for the components you want to install.
If the target device and the system device are not the same, then installation
requires that amount of free space on both devices (the space on the system device
is used for temporary storage during the installation).

Table 9 VMS Installation Size (in blocks)

Components Size (in blocks)

Runtime Environment 3500

Development Environment 5000

Example Source 500

Total 9000

TIBCO Rendezvous Installation

 Install the Rendezvous Product Software 23
|

Install the Rendezvous Product Software

The installation procedure requires your input. The most important items you
supply are the target location for the Rendezvous files, and the environment to
install (development or runtime environment).
The installation procedure takes less than 10 minutes.

Installation Steps 1. Create a disk directory for the installation kit.

$ create/directory DKA100:[[Link]-8-4-0]

2. Change the default directory to the root directory of the DVD drive, or
transfer the installation package zip file to a disk directory and change the
default directory to that directory. For example:
$ set default DQA0:[000000]

3. Unzip the installation package (see ZIP Files on page 20).

$ unzip installation_package -d DKA100:[[Link]-8-4-0]

4. Retrieve and read the release notes, which are in the sys$help directory. For
example, to retrieve the release notes without installing Rendezvous software,
use these commands:
$ @sys$update:vmsinstal tibrv-084 dka100:[[Link]-8-4-0] -
$_ options N

5. Install the product software. Specify the product name and directory on the
command line to VMSINSTAL. For example:
$ @sys$update:vmsinstal tibrv-8-4-08-4-0 dka100:[[Link]-8-4-0]

TIBCO Rendezvous Installation

24
| Chapter 4 VMS

Verify Installation

We recommend that you verify correct operation of Rendezvous software. You

can verify installation at any time by invoking the command
TIBRV:[COM]QUICK_TEST.COM.

The test procedure starts the Rendezvous daemon, starts a listening program, and
sends three messages. The listening program receives the three messages and
displays them on the screen or console.
Then the procedure prints a sample of correct output. Visually compare the
sample with the actual results above it. If they match in all details except for
process ID numbers and timestamps, then Rendezvous software is installed and
operating correctly.

TIBCO Rendezvous Installation

 Daemon Privilege and Priority 25
|

Daemon Privilege and Priority

OPER
To send multicast and broadcast messages, the Rendezvous daemon must have
OPER privilege. Without this privilege, Rendezvous programs will not be able to
create transport objects.
The best way to ensure this privilege is to install the Rendezvous daemon with
OPER privilege. The file TIBRV_STARTUP.COM does this automatically.

ALTPRI
The Rendezvous daemon process is as an extension of the operating system’s
network device driver. To avoid data loss, it must respond immediately to
network I/O. To ensure immediate response, the daemon must run at elevated
priority—preempting interactive users and the processes that support them.
The daemon executable always runs with ALTPRI privilege, which enables
elevated priority. This privilege is in effect whether the daemon starts
automatically or explicitly. You do not need to configure anything to set this
privilege.

TIBCO Rendezvous Installation

26
| Chapter 4 VMS

Starting the Rendezvous Daemon at Boot Time

You can start a permanent daemon at boot time, by adding a line to the start-up
file SYS$MANAGER:SYSTARTUP_VMS.COM:
$! This line is already present in the start-up file.
$ @SYS$STARTUP:TIBRV_STARTUP.COM
$! Add this line immediately after it.
$ @TIBRV:[com]RVD_PROC_START

However, it is not necessary to start the Rendezvous daemon at boot time,

because programs start it automatically as needed.

TIBCO Rendezvous Installation

 Parameters for rvd 27
|

Parameters for rvd

This section describes VMS parameters affect Rendezvous daemon operation.

Byte Limit
High message rates consume significant space in non-paged storage.
The byte limit parameter restricts the amount of non-paged storage that a VMS
process can use. If rvd fails during accept(), exceeding its byte count quota,
raise this resource limit.
The Rendezvous daemon requires sufficient non-paged buffer space for
messages. The actual requirement depends on the speed of the network, the
network card, the processors, and the message data rate. We recommend a value
of 6000000.

Boot Time When starting the Rendezvous daemon at boot time, the SYSTEM account’s bytlm
parameter controls this resource limit. To set this parameter, modify these
commands appropriately:
$ set def sys$system
$ run authorize
UAF> mod SYSTEM /bytlm=6000000

Automatic Start When programs start the Rendezvous daemon automatically, the SYSGEN
parameter PQL_DBYTLM specifies this resource limit. Set an appropriate value
using the AUTOGEN tool.

Total Non-Paged Storage

The SYSGEN parameters NPAGEDYN and NPAGEDYNVIR specify the total pool of
non-paged storage. (In contrast, the byte limit specifies the fraction of this pool
that each process may use.)
The pool begins at boot time with size NPAGEDYN, and automatically expands as
needed, up to a limit of NPAGEVIR. We recommend that you monitor the pool to
ensure sufficient space. For example:
$ show memory
$ show memory /pool /full

If the pool is too small, use the AUTOGEN tool to set an appropriate size.

TIBCO Rendezvous Installation

28
| Chapter 4 VMS

Page File Quota

The Rendezvous daemon process requires sufficient virtual address buffer space
to retain outbound messages for the duration of the reliability interval. To
calculate the actual requirement, estimate the maximum number of bytes per
reliability window for all Rendezvous message activity, add space for future
expansion, then divide by 512 (the number of bytes per block).
(The factory default reliability interval is 60 seconds. For a complete discussion
the concept of reliability, the various ways to control it, the interaction among
those ways, and reasonable values, see Reliability and Message Retention Time on
page 35 in TIBCO Rendezvous Administration.)

Boot Time When starting the Rendezvous daemon at boot time, the SYSTEM account’s
pgflquo parameter controls this resource limit. To set this parameter, modify
these commands appropriately:
$ set def sys$system
$ run authorize
UAF> mod SYSTEM /pgflquo=1000000

Automatic Start When programs start the Rendezvous daemon automatically, the SYSGEN
parameter PQL_DPGFLQUOTA controls this resource limit. Set an appropriate value
using the AUTOGEN tool.

Channel Count
In addition to the usual requirements for I/O channels, rvd uses I/O channels in
two more ways:
• Each client connection from a network transport object consumes one channel.
• Each UDP and PGM service that those clients access consumes one channel.

The special SYSGEN parameter CHANNELCNT determines the maximum number of

I/O devices that a process can access. Although most systems set a sufficiently
high value, we recommend that you estimate the number of channels that rvd
requires, and verify that the limit is significantly larger than your estimate. For
example:
$ mc sysgen
SYSGEN> show channelcnt

If rvd fails during accept(), reporting invalid I/O channels, raise this resource
limit using the AUTOGEN tool.

TIBCO Rendezvous Installation

 User Accounts 29
|

User Accounts

To run Rendezvous programs, user accounts must have netmbx and tmpmbx
privileges.
Rendezvous programs accept command line arguments. To set up these
arguments, each user must execute TIBRV:[COM]TIBRV_SETUP.COM. As a
convenience, we recommend referencing it in each user’s [Link] file.

TIBCO Rendezvous Installation

30
| Chapter 4 VMS

Review the Administrator’s Checklist

The TIBCO Rendezvous Administration begins with a checklist for system

administrators. Review the steps in that list now, and complete the steps that are
appropriate for your site.

See Also Do This First—Administrator’s Checklist on page 1 in TIBCO Rendezvous

Administration.

TIBCO Rendezvous Installation

 C++ Library 31
|

C++ Library

This section describes an inconsistency in the behavior of the HP C++ compiler.

On HP Integrity servers, version 7.3 of the C++ compiler uses a different name
mangling algorithm than version 7.1 used. As a result, programs compiled using
C++ compiler V7.3, cannot correctly link libraries compiled using C++ compiler
V7.1.
The Rendezvous C++ library in the installation package for OpenVMS Integrity is
compiled using C++ compiler V7.1. This library is not compatible with C++
compiler V7.3 on HP Integrity hardware.
If you are installing Rendezvous software on a computer where this library is
incompatible, you must rebuild the library from the source code (see Rebuilding
the C++ Library, below).

Rebuilding the C++ Library

Source files for the Rendezvous C++ library are located in this directory:
TIBRV:[[Link]]

To rebuild the library, use this command procedure:

TIBRV:[COM]MAKE_LIBRVCPP.COM

To recreate the Rendezvous C++ library, TIBRV:[LIB][Link], do these

steps:
1. Log on using the SYSTEM account.
2. Execute this command:
$ @TIBRV:[COM]MAKE_LIBRVCPP

This procedure compiles the source modules using the system default C++
compiler, creates the object library, and copies it to the TIBRV:[LIB] directory.

TIBCO Rendezvous Installation

32
| Chapter 4 VMS

Additional Information for VMS Programmers

Compile
On VMS platforms, Rendezvous programmers must define the C-compile
command appropriately.
For the HP C compiler:
$ CC :== CC/FLOAT=IEEE/IEEE_MODE=UNDERFLOW_TO_ZERO -
/PREFIX=ALL/INCLUDE_DIRECTORY=("/tibrv/include",[])

Rendezvous programmers using C++ (CXX) must define the CXX-compile

command appropriately.
For the HP C++ compiler:
$ CPP :== CXX/FLOAT=IEEE/IEEE_MODE=UNDERFLOW_TO_ZERO -
/PREFIX=ALL/WARNINGS=DISABLE=EXTRASEMI -
/INCLUDE_DIRECTORY=("/tibrv/include",[])

Link
Rendezvous API libraries are multi-threaded, so VMS scheduler upcalls can yield
significant performance improvements:
$ LINK/THREADS_ENABLE=UPCALLS

Migrating to Release 8.x

Forward Migration
In general, applications linked with shareable images migrate forward to new
versions of TIBCO Rendezvous without any need to relink; they usually operate
smoothly with newer shareable images.
Exception: In Rendezvous release 8.0, we reorganized the Rendezvous shareable
image libraries on OpenVMS platforms, in order to resolve issues with third-party
libraries. As a result, you must relink applications linked with shareable image
libraries when you upgrade across this division (from 7.5.4 or earlier, to 8.0 or
later, on OpenVMS).

Older Shareable Libraries

Applications that link with sharable images usually cannot run with older
shareable libraries (from earlier Rendezvous releases). The reason is that new

TIBCO Rendezvous Installation

 Additional Information for VMS Programmers 33
|

releases can introduce new entry points, which are absent from older shareable
libraries.
This incompatibility can cause problems if you link an application against a
current shareable library, and then distribute it to other host computers where it
runs with older shareable libraries.

TIBCO Rendezvous Installation

34
| Chapter 4 VMS

TIBCO Rendezvous Installation

 | 35

Chapter 5 IBM i

Follow these instructions to install Rendezvous software on IBM i platforms.

Installation on IBM i platforms uses the RSTLICPGM command, which is described
in the IBM i operating system documentation.

Topics

• Requirements, page 36
• IBM i Installation Package, page 37
• Post-Installation Instructions, page 39
• Check the AAREADME File, page 41
• Review the Administrator’s Checklist, page 42

TIBCO Rendezvous Installation

36
| Chapter 5 IBM i

Requirements

Rendezvous software requires IBM i with TCP/IP installed. For details, see the
IBM document TCP/IP Fastpath Setup.

IBM i does not support the PGM variant.

TIBCO Rendezvous Installation

 IBM i Installation Package 37
|

IBM i Installation Package

This procedure installs the Rendezvous software.

1. Locate the appropriate installer package for your platform, as listed in
Table 10. (For the latest changes, see the [Link] file.)

Table 10 IBM i Distribution Directories

Platform Installer Package Notes

IBM i TIB_rv_8.4.0_ibmi_power.zip Does not support RVDM.

2. On a Windows-based or UNIX-based system, unzip the installation package

in a temporary location.
3. On an IBM i system, do these steps:
a. Login as QSECOFR.
b. Create a save file on your IBM i system called TIBRV. Use the command
CRTSAVF to do this.

c. Copy the save file ([Link]) from the temporary (unzip) directory to
the save file you created in step b.
4. If another version of TIBCO Rendezvous is installed on your system, you
must uninstall it before installing this version.
a. Ensure that no TIBCO Rendezvous programs are running, and that TIBRV
is not in any user’s library list.
b. Use this command to uninstall:
DLTLICPGM LICPGM(2TIBRV2) RLS(*ALL)

c. Remove files from the Integrated File System (IFS).

Execute this command from the Command Entry screen:
QSH CMD(’rm -rf /usr/tibco/tibrv’)

5. Install using the command RSTLICPGM as follows:

RSTLICPGM LICPGM(2TIBRV2) DEV(*SAVF) SAVF(libname/TIBRV)

libname is the library where you created the save file, in step 3b.

TIBCO Rendezvous Installation

38
| Chapter 5 IBM i

6. To use Java, or to run or develop in the qsh environment, do this step after
RSTLICPGM completes:

a. Create a tibco directory in /usr (if it doesn't exist already).

CRTDIR ('/usr/tibco/tibrv')

b. Restore the file containing the Java files and the IFS file structure.
RST DEV('/[Link]/[Link]/[Link]')
OBJ(('/usr/tibco/tibrv/*'))

This command restores files to be placed in the Integrated File System in

the directory /usr/tibco, and places the .jar files for Java support in
/usr/tibco/tibrv/lib. It also creates symbolic links back to the installed
programs, service programs and source files so that you can run and
develop programs in qsh as you would in a UNIX or Windows
environment.

Figure 1 IBM i: Beginning the Installation

Restore Licensed Program (RSTLICPGM)

Type choices, press Enter.

Product . . . . . . . . . . . > 2TIBRV2 Character value

Device . . . . . . . . . . . . > *SAVF Name, *SAVF
+ for more values
Optional part to be restored . *BASE *BASE, 1, 2, 3, 4, 5, 6,7...
Type of object to be restored *ALL *ALL, *PGM, *LNG
Language for licensed program *PRIMARY Character value, *PRIMARY...
Output . . . . . . . . . . . . . *NONE *NONE, *PRINT
Release . . . . . . . . . . . *FIRST Character value, *FIRST
Replace release . . . . . . . . *ONLY Character value, *ONLY, *NO
Save file . . . . . . . . . . . TIBRV Name
Library . . . . . . . . . . . QTEMP Name, *LIBL, *CURLIB

More...
F3=Exit F4=Prompt F5=Refresh F10=Additional parameters F12=Cancel
F13=How to use this display F24=More keys

TIBCO Rendezvous Installation

 Post-Installation Instructions 39
|

Post-Installation Instructions

1. The initial library list must contain the Rendezvous library (TIBRV is the
default library name). Edit all relevant job descriptions to include it.
2. Rendezvous software requires multi-threading. Edit all relevant job
descriptions to enable multiple threads.

The example job description TIBRV/TIBRV illustrates items 1 and 2.

3. If your IBM i system is configured with a fully-qualified domain name, ensure

that the host table entry for your system contains the full name of the
computer. For example, if your domain name is [Link], and the
machine name is mymachine, then put [Link] in the host
table.
4. For Java programs, set the CLASSPATH environment variable to include
/usr/tibco/tibrv/lib/[Link].

5. To run Rendezvous programs using qsh, you must first set the environment
variable QIBM_MULTI_THREADED to the value Y (before starting qsh).

To set the values of items 4 and 5 automatically, create a CL program similar to this
example, and set the INLPGM parameter in the user profile to run it automatically
when the user logs in.
PGM /* start it */
/* For Java with qsh, set these vars */
ADDENVVAR ENVVAR(QIBM_MULTI_THREADED) VALUE(Y)
ADDENVVAR ENVVAR(CLASSPATH) +
VALUE(’/usr/tibco/tibrv/[Link]’)

Whether you set the variables manually or automatically, their values persists
until logout.

6. IBM imposes limitations on multi-threaded programs. Remember that all

Rendezvous programs are inherently multi-threaded.
You must run multithreaded programs either in batch or interactive batch
subsystems—not in the interactive subsystem. When submitting jobs using
SBMJOB, set the ALWMLTTHD parameter to (*YES).

TIBCO Rendezvous Installation

40
| Chapter 5 IBM i

You cannot run multi-threaded programs in the interactive environment. In

other words, you cannot use CALL from a terminal to start a program that uses
Rendezvous.

Error messages stating that pthread_create failed indicate that you have not
set QIBM_MULTI_THREADED, or you have used the CALL command to start a
Rendezvous program.

7. When you receive a license ticket file from TIBCO, do these steps:
a. Create a new source physical file named TIBRV in one of your libraries.
b. Put the license ticket file in a member of that file named TKT. (This
prevents accidental removal of the ticket files when you next upgrade
Rendezvous.)
c. Ensure that the library containing the ticket file is in the library list.
Rendezvous searches for TIBRV(TKT) in your library list, and uses the first
license file that it finds.

TIBCO Rendezvous Installation

 Check the AAREADME File 41
|

Check the AAREADME File

The AAREADME file contains up-to-the-minute information about the Rendezvous

software releases. We recommend that you scan it for the latest news.
The AAREADME file is located in the same library as the other Rendezvous software
components. A version that can be read on a PC is in the file README.400.

TIBCO Rendezvous Installation

42
| Chapter 5 IBM i

Review the Administrator’s Checklist

The TIBCO Rendezvous Administration begins with a checklist for system

administrators. Review the steps in that list now, and complete the steps that are
appropriate for your site.

See Also Do This First—Administrator’s Checklist on page 1 in TIBCO Rendezvous

Administration.

TIBCO Rendezvous Installation

 | 43

Chapter 6 Universal Installer

This chapter presents installation and uninstallation using TIBCO Universal

Installer.

Topics

• Before Installing, page 44

• Install TIBCO Rendezvous, page 46
• Uninstalling TIBCO Software, page 53

TIBCO Rendezvous Installation

44
| Chapter 6 Universal Installer

Before Installing

Destination Directory

If you are upgrading from Rendezvous 7.x (or earlier) or from any version of
Rendezvous installed as part of TRA, read this section.

The installers for Rendezvous 7.x (and earlier) installed the product into a
destination root directory defined by the TIBCO Runtime Environment (TRA)
environment. In contrast, the TIBCO Universal Installer installs into a destination
root directory defined by previous invocations of the Universal Installer. That is, if
you already installed another product using TIBCO Universal Installer, then the
destination root directory for that product becomes the destination root for all
subsequent products that use the Universal Installer.
In particular, installing Rendezvous 8 after an existing TRA leaves two versions of
Rendezvous in separate locations—the old version (installed with TRA) and the
new version. Other TIBCO products that depend on TRA use Rendezvous
daemons from the new version, but continue to use Rendezvous libraries from the
old version.

Installer Account

Microsoft Windows
You must have administrator privileges to install TIBCO Rendezvous. If you do
not have administrator privileges, the installer exits. You must then log out of the
system and log in as a user with the required privileges, or request your system
administrator to assign the privileges to your account.
If you intend to install the product on a network drive, you must ensure that the
account used for installation has permission to access the network drive.

UNIX
To install TIBCO Rendezvous, you can login either as a regular (non-root) user or
as super-user (root).
A graphic environment such as CDE or X Windows is required to run the installer
in GUI mode.

TIBCO Rendezvous Installation

 Before Installing 45
|

Installer Log File

The installer writes its log file to the User_Home/.TIBCO directory. For example, on
Windows, the installer writes its log to the C:\Documents and
Settings\user-name\.TIBCO directory.

Disk Space

Temporary Disk Space Required by the Installer

When a TIBCO Rendezvous package is unpacked, it is extracted into a temporary
folder. The installer requires at least 250 MB of free space in the temporary
directory. On Microsoft Windows, the temporary directory location is
%SystemDrive%:\Documents and Settings\user_name\Local Settings\Temp.
If your system does not have sufficient free disk space in the default temporary
directory, you can run the installer with a different temporary directory by using
the following option when starting the installer. For example:
TIBCOUniversalInstaller -is:tempdir \new_tmp

where \new_tmp has sufficient free disk space.

The installer calculates the disk space required in product home location for the
selected components. The calculation is done before the actual installation
(copying of files to system) begins. The installer will proceed only if sufficient free
disk space is available in product home location.
However, if disk space is consumed by another process while the installer is
copying the files, and if the required disk space is thereby reduced, the installer
may fail and will then give a failure message.
While performing installation, avoid running other processes that consume disk
space in product home location.

Disk Space After Installation

TIBCO Rendezvous can consume 500 MB of free space under TIBCO_HOME.

TIBCO Rendezvous Installation

46
| Chapter 6 Universal Installer

Install TIBCO Rendezvous

Install a TIBCO Rendezvous product using one of the following modes:

• Install in GUI Mode on page 46
• Install in Console Mode on page 51
• Install in Silent Mode on page 52

Install in GUI Mode

To install TIBCO Rendezvous using GUI mode, do these steps.
1. Open the physical media or download the TIBCO Rendezvous product
package.
2. Extract the TIBCO Rendezvous product archive file to a temporary directory.
3. Navigate to the temporary directory that contains the universal installer.
4. Run TIBCO Universal Installer (the executable file name is platform specific).
5. The Welcome screen appears. Click Next.

TIBCO Rendezvous Installation

 Install TIBCO Rendezvous 47
|

6. The License Agreement screen appears. After reading through the license text,
click I accept the terms of the license agreement and then click Next

TIBCO Rendezvous Installation

48
| Chapter 6 Universal Installer

7. Install all features by clicking Typical or choose the features to install by

selecting Customize Installation. After making your choice, click Next.

TIBCO Rendezvous Installation

 Install TIBCO Rendezvous 49
|

8. If you selected Customize Installation, in step 7, you may unselect check boxes
corresponding to features you do not want to install. Click Next to continue.
(If you did not select Custom, proceed to step 10.)

TIBCO Rendezvous Installation

50
| Chapter 6 Universal Installer

9. The Installation Environment screen appears. Specify a location for installing

Rendezvous.

10. The installer prepares the features for installation. A pre-install summary
screen appears. Click Install.
The installer copies files to the TIBCO_HOME directory.

TIBCO Rendezvous Installation

 Install TIBCO Rendezvous 51
|
Daemon Variant 11. Select the TIBCO Rendezvous daemon variant for this installation. Select
either TRDP or PGM (for background information, see PGM and TRDP on
page 18 in TIBCO Rendezvous Concepts). Click Next.

12. A post-install report summarizes the installation results. Click Finish to close
the installer window.

Install in Console Mode

The following procedure explains how to install the software in console mode.
1. Open the physical media or download the TIBCO Rendezvous package.
2. Extract the TIBCO Rendezvous archive file to a temporary directory.
3. Using a console window, navigate to the temporary directory that contains the
universal installer.
4. Run the installer using this command line:
TIBCOUniversalInstaller -console

5. Complete the installation by responding to the console window prompts.

TIBCO Rendezvous Installation

52
| Chapter 6 Universal Installer

Install in Silent Mode

The following procedure explains how to install a TIBCO Rendezvous product in
silent mode. The [Link] file is packaged in the
directory that contains the universal installer. You must edit the file with
information for your environment before launching the silent installation. The file
includes comments that describe the installation properties you can set.
While you can use the [Link] file, it is good practice
to copy the file to a different name and edit that file for the silent install.
If errors occur during installation, they will be listed in the installation log file (see
the User_Home/.TIBCO directory).
1. Open the physical media or download the TIBCO Rendezvous product
package.
2. Extract the TIBCO Rendezvous product archive file to a temporary directory.
3. Using a console window, navigate to the temporary directory that contains the
universal installer.
4. Copy the [Link] file and rename the copy.
5. Using a text editor, open the copied file and update the install location, and
features to install.
6. Run the installer using this command line:
TIBCOUniversalInstaller -silent -V responseFile="[Link]"

If you are using the [Link] file (rather than a

copy), you need not supply the file name and can use this command line:
TIBCOUniversalInstaller -silent

A line similar to the following is written to the installer log file when
installation completes:
... Install, [Link],
[Link], Executing Event:::OnEndInstall

Windows Platforms Only

Installation batch scripts (*.bat) on Windows platforms must invoke the
TIBCO Universaller Installer using the CALL command; for example:
CALL .\TIBCOUniversalInstaller -silent args

TIBCO Rendezvous Installation

 Uninstalling TIBCO Software 53
|

Uninstalling TIBCO Software

Uninstall in GUI Mode

To uninstall the software:
1. Run the uninstaller:
a. Navigate to TIBCO_HOME/tools/universal_installer.
b. Run the platform-specific installer executable.
2. Select Uninstall Products From Selected TIBCO Home Location, then click
Next.
3. The wizard provides uninstall options:
— Custom Uninstall (select TIBCO products to uninstall)
— Typical Uninstall (uninstall all TIBCO products)

Select either option, then click Next.

4. If you selected Custom Uninstall, select the checkboxes for products to

uninstall, then click Next.
5. The Pre-Uninstall Summary displays. Click Uninstall.
When uninstalling, a popup window displays asking to clean up the /tools
directory. Click Yes, clean it up.
6. The summary screen appears. Click Finish to exit the uninstall wizard. After
uninstalling the software, the uninstaller may prompt you to restart your
computer.
7. If you selected Typical Uninstall (uninstalling all TIBCO products) then
manually delete the directories under TIBCO_HOME.

Uninstall in Silent Mode

Silent uninstall is no longer supported in this version of the universal installer.

TIBCO Rendezvous Installation

54
| Chapter 6 Universal Installer

TIBCO Rendezvous Installation

 | 55

Index

A M
ALTPRI privilege, VMS 25 Microsoft Windows 11

B N
byte limit, VMS 27 netmbx, VMS 29

C O
customer support xx OPER privilege, VMS 25

D P
directory structure 3 page file quota, VMS 27
disk space 45

R
I
root priority, UNIX 6
Install TIBCO Rendezvous 46
installer log file 45

L setuid root, UNIX 6

support, contacting xx
log file 45 SYSGEN parameters, VMS 27

TIBCO Rendezvous Installation

56
| Index

T
TCP/IP services, VMS 19
technical support xx
temporary disk space 45
TIBCO_HOME xvii
tmpmbx, VMS 29

U
uninstalling the software 53
UNIX 5

V
VMS 17

W
Windows 11

TIBCO Rendezvous Installation