TIBCO Rendezvous Installation

|i
TIBCO Rendezvous®
Installation
Software Release 8.3.0
July 2010
TIBCO Rendezvous Installation
ii
|
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 TIBCO Rendezvous Installation)
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.
TIB, TIBCO, TIBCO Adapter, Predictive Business, Information Bus, The Power of Now, 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.TXT 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–2010 TIBCO Software Inc. ALL RIGHTS RESERVED.
TIBCO Software Inc. Confidential Information
TIBCO Rendezvous Installation
| iii
Contents
Figures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .vii
Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
New or Modified Sections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii
Manual Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xiv
Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv
TIBCO Product Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv
Typographical Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvii
How to Contact TIBCO Customer 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
Mount the Distribution Media . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Select the Installation Package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Run the Installer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Older Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Review the Administrator’s Checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Chapter 3 Microsoft Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13
Mount the Distribution Media . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Select and Run the Installer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Check the README File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
TIBCO Rendezvous Installation
iv
| Contents
Windows Registry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Review the Administrator’s Checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Chapter 4 VMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Log In as SYSTEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Check TCP/IP Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Obtain the Installation Package. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
ZIP Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
File Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Mount the Distribution Media . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Check Storage Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Install the Rendezvous Product Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Verify Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Daemon Privilege and Priority . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
OPER. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
ALTPRI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Starting the Rendezvous Daemon at Boot Time. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Parameters for rvd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Byte Limit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Total Non-Paged Storage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Page File Quota . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Channel Count . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31
31
31
32
32
User Accounts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Review the Administrator’s Checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
C++ Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Rebuilding the C++ Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Additional Information for VMS Programmers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Compile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Chapter 5 IBM i . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Run the Installation Program. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Post-Installation Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Check the AAREADME File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Review the Administrator’s Checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Chapter 6 Universal Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Before Installing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
TIBCO Rendezvous Installation
Contents v
|
Destination Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Installer Account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Installer Log File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Disk Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Install TIBCO Rendezvous. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Install in GUI Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Install in Console Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Install in Silent Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Uninstalling the Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Uninstall in GUI Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Uninstall in Silent Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .61
TIBCO Rendezvous Installation
vi
| Contents
TIBCO Rendezvous Installation
| vii
Figures
Figure 1
IBM i: Beginning the Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Table 6
Microsoft Windows Distribution Directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Table 7
VMS Distribution Directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Table 8
VMS Distribution Directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Table 9
VMS Installation Size (in blocks) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Table 10
IBM i Distribution Directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Table 11
Universal Uninstaller—Command Line Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
TIBCO Rendezvous Installation
x
| Tables
TIBCO Rendezvous Installation
New or Modified Sections
| xi
New or Modified Sections
UNIX Installation Directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Microsoft Windows Distribution Directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
TIBCO Rendezvous Installation
xii
| New or Modified Sections
TIBCO Rendezvous Installation
| xiii
Preface
This manual describes installation of TIBCO Rendezvous® software. It is part of
the documentation set for Rendezvous Software Release 8.3.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 readme.txt 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
•
How to Contact TIBCO Customer Support, 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 Product Documentation
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 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 Installation
xvi
| Related Documentation
•
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
All TIBCO products are installed under the same directory. This directory is
referenced in documentation as TIBCO_HOME. The value of TIBCO_HOME
depends on the operating system. For example, on Windows systems, the
default value is C:\tibco.
TIBRV_HOME
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.3.0.
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
font
Bold code font is used in the following ways:
•
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]
italic font
Italic font is used in the following ways:
•
To indicate a document title. For example: See TIBCO ActiveMatrix
BusinessWorks 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
TIBCO Rendezvous Installation
xviii Typographical Conventions
|
Table 1 General Typographical Conventions (Cont’d)
Convention
Use
Key
combinations
Key name separated by a plus sign indicate keys pressed simultaneously. For
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
| How to Contact TIBCO Customer Support
How to Contact TIBCO Customer Support
For comments or problems with this manual or the software it addresses, please
contact TIBCO Support as follows.
•
For an overview of TIBCO Support, and information about getting started
with TIBCO Product Support, visit this site:
http://www.tibco.com/services/support
•
If you already have a valid maintenance or support contract, visit this site:
http://support.tibco.com
Entry to this site requires a username and password. If you do not have a
username, 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.3.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 37 in TIBCO Rendezvous
Concepts.
•
Read about any late-breaking changes, described in the package inserts and
the README files. There is a README file for each platform, located on the DVD,
in the same directory as the installation 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 13
VMS
Chapter 4 on page 21
IBM i
Chapter 5 on page 39
z/OS
See TIBCO Rendezvous for z/OS Installation
and Configuration
TIBCO Rendezvous Installation
|5
Chapter 2
UNIX
Topics
•
Before You Install, page 6
•
Mount the Distribution Media, page 7
•
Select the Installation Package, page 8
•
Run the Installer, page 10
•
Review the Administrator’s Checklist, page 11
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
Mount the Distribution Media 7
|
Mount the Distribution Media
Insert the Rendezvous distribution DVD into the DVD drive.
Use the appropriate operating system command(s) to mount the DVD.
TIBCO Rendezvous Installation
8
| Chapter 2
UNIX
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.3.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 .tar.gz)
Table 5 UNIX Installation Directories (Sheet 1 of 2)
OS
Hardware
Installer Package
Suffix
Notes
General Information
The following UNIX installer packages include both 32-bit and 64-bit components, except as noted
below.
AIX 5.2, 5.3, 6.1
IBM RS/6000
aix52_power
Free BSD 6.2
Intel
fbsd6_x86
Requires 6.2 stable.
32-bit components only.
HP/UX 11i
(v1, v2, v3)
HP-PA RISC
hpux111_hppa
IA64 (Itanium)
hpux112_ia64
Mac OS X 10.5+
Intel
macosx_x86
32-bit and 64-bit
components.
Mac OS X 10.4
PowerPC
macosx104_power
32-bit components only.
Uses an older version of the
universal installer.
Does not support RVDM.
Does not support Java.
TIBCO Rendezvous Installation
Select the Installation Package 9
|
Table 5 UNIX Installation Directories (Sheet 2 of 2)
OS
Hardware
Installer Package
Suffix
Novell SUSE Linux
Enterprise 10 SP1
Intel
linux26gl23_x86
Red Hat Enterprise
Linux 4, 5 (AS, ES)
Intel
linux26gl23_x86
IA64 (Itanium)
linux24gl23_ia64
Notes
Red Hat Enterprise
Linux 5 (Advanced
Platform, Classic)
Red Hat Enterprise
Linux 4 (AS, ES)
Does not support RVDM.
Requires older installer.
64-bit components only.
Intel
sol10_x86
Sun SPARC
sol8_sparc
Intel (32-bit only)
sol9_x86
Sun SPARC
sol8_sparc
Solaris 8
Sun SPARC
sol8_sparc
Tru64 UNIX 5.1b
HP Alpha
tru6451_alpha
Solaris 10
Solaris 9
32-bit components only.
Does not support RVDM.
Does not support port
reuse.
Does not support Java.
Requires older installer.
64-bit components only.
TIBCO Rendezvous Installation
10
| Chapter 2
UNIX
Run the Installer
If Table 5 on page 8 mentions that the platform you are installing requires the
older installer, then install using the steps in this section.
Otherwise, proceed to Chapter 6, Universal Installer, on page 47, and follow the
installation instructions there. When installation is complete, see Do This First—
Administrator’s Checklist on page 1 in TIBCO Rendezvous Administration.
Older Installer
1. Change working directory to the directory you selected in step 1. For example:
$ cd
CD_mount_point/TRU6451/ALPHA
2. Run the install program from that directory:
$ ./install
(Some operating systems translate the name of this program into upper case—
INSTALL.)
The Rendezvous installation program copies the required files.
To abort the installation at any time, press the interrupt key, (on most
platforms, Control-c).
The Rendezvous installation process prompts you to answer questions about
the installation. Default answers appear inside brackets. To select the default
answer, press the Return key. When answering installation questions: it is
equivalent to type yes or y; it is equivalent to type no or n; upper and lower
case are equivalent.
Several UNIX platforms include their own installation facilities (for example,
Solaris). The Rendezvous installation program cooperates with some of the
these facilities, and transfers control to them, if you desire.
3. Add the directory $TIBRV_DIR/lib to the library path environment variable.
You can find the name of this variable in the installer output.
TIBCO Rendezvous Installation
Review the Administrator’s Checklist 11
|
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
12
| Chapter 2
UNIX
TIBCO Rendezvous Installation
| 13
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
•
Mount the Distribution Media, page 14
•
Select and Run the Installer, page 15
•
Check the README File, page 17
•
Windows Registry, page 18
•
Review the Administrator’s Checklist, page 19
TIBCO Rendezvous Installation
14
| Chapter 3
Microsoft Windows
Mount the Distribution Media
Insert the Rendezvous distribution DVD into the DVD drive.
TIBCO Rendezvous Installation
Select and Run the Installer 15
|
Select and Run the Installer
Installation adds a Windows program group for Rendezvous software.
For Windows NT only, the user ID that runs this installation procedure
determines which path is updated by the setup program:
•
If you run the installation program as an administrator, it adds Rendezvous
software to the machine’s path, and any user who logs in to the computer will
have access to the Rendezvous directory.
•
If you run the installation program as a non-administrative user, it adds
Rendezvous software to that user’s path.
1. Locate the appropriate installation package for your platform on the
distribution DVD. 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
O/S Platform
Hardware
Platform
Windows Vista
Business Edition
Installer Package
Notes
Intel
(32-bit)
TIB_rv_8.3.0_win_x86_vc8.zip
For developers
using
Visual Studio
2005 (VC8) and
Visual Studio
2008 (VC9).
Intel
(64-bit)
TIB_rv_8.3.0_win_x86_64_vc8.zip
For developers
using
Visual Studio
2005 (VC8) and
Visual Studio
2008 (VC9).
Windows XP
Windows 2003 Server
Windows 2008 Server
Windows 7
Windows Vista
Business Edition 64-bit
Windows XP 64-bit
Windows 2003 Server
64-bit
Windows 2008 Server
64-bit
Windows 7 64-bit
TIBCO Rendezvous Installation
16
| Chapter 3
Microsoft Windows
2. Proceed to Chapter 6, Universal Installer, on page 47, 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 17
|
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
18
| 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 413 in TIBCO Rendezvous Administration.
TIBCO Rendezvous Installation
Review the Administrator’s Checklist 19
|
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
20
| Chapter 3
Microsoft Windows
TIBCO Rendezvous Installation
| 21
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 22
•
Check TCP/IP Services, page 23
•
Obtain the Installation Package, page 24
•
Mount the Distribution Media, page 25
•
Install the Rendezvous Product Software, page 27
•
Verify Installation, page 28
•
Daemon Privilege and Priority, page 29
•
Starting the Rendezvous Daemon at Boot Time, page 30
•
Parameters for rvd, page 31
•
User Accounts, page 33
•
Review the Administrator’s Checklist, page 34
•
Additional Information for VMS Programmers, page 36
TIBCO Rendezvous Installation
22
| Chapter 4
VMS
Log In as SYSTEM
Log in to the SYSTEM account.
TIBCO Rendezvous Installation
Check TCP/IP Services 23
|
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 varies depending on hardware; see
Table 7.)
Table 7 VMS Distribution Directories
Platform
Hardware Platform
TCP/IP Version
OpenVMS Alpha v.7.3-2 or later
HP Alpha
HP TCP/IP Services V5.4 (or later)
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
24
| Chapter 4
VMS
Obtain the 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
OpenVMS Alpha v.7.3-2
or later
HP Alpha
TIB_rv_8.3.0_vms73_alpha.zip
OpenVMS Itanium v.8.2
or later
HP
Integrity/Itanium
TIB_rv_8.3.0_vms82_ia64.zip
Platform
Notes
Does not
support
Java.
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:
http://h71000.www7.hp.com/openvms/freeware/index.html?jumpid=/go/openvms/freeware
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 25
|
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
26
| 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
Total
TIBCO Rendezvous Installation
500
8500
Install the Rendezvous Product Software 27
|
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:[kits.rv-8-3-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 24).
$ unzip
installation_package -d DKA100:[kits.rv-8-3-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-083 dka100:[kits.rv-8-3-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-3-08-3-0 dka100:[kits.rv-8-3-0]
TIBCO Rendezvous Installation
28
| 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 29
|
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
30
| 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 31
|
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
32
| 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 34 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 33
|
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 login.com file.
TIBCO Rendezvous Installation
34
| 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 35
|
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).
(On OpenVMS Alpha we have not seen this type of incompatibility with C++
compilers.)
Rebuilding the C++ Library
Source files for the Rendezvous C++ library are located in this directory:
TIBRV:[SRC.LIBRVCPP]
To rebuild the library, use this command procedure:
TIBRV:[COM]MAKE_LIBRVCPP.COM
To recreate the Rendezvous C++ library, TIBRV:[LIB]LIBTIBRVCPP.OLB, 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
36
| 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 37
|
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
38
| Chapter 4
VMS
TIBCO Rendezvous Installation
| 39
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 40
•
Run the Installation Program, page 41
•
Post-Installation Instructions, page 43
•
Check the AAREADME File, page 45
•
Review the Administrator’s Checklist, page 46
TIBCO Rendezvous Installation
40
| 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
Run the Installation Program 41
|
Run the Installation Program
This procedure installs the Rendezvous software.
1. On the Rendezvous distribution DVD, locate the appropriate installer
package for your platform, as listed in Table 10. (For the latest changes, see the
readme.txt file.)
Table 10 IBM i Distribution Directories
Platform
Installer Package
Notes
IBM i
TIB_rv_8.3.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 (TIBRV.SAV) 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(2TRV400) 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(2TRV400) DEV(*SAVF) SAVF(libname/TIBRV)
libname is the library where you created the save file, in step 3b.
TIBCO Rendezvous Installation
42
| 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('/qsys.lib/tibrv.lib/tibrvifsfl.file')
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 . . . . . . . . . . . >
Device . . . . . . . . . . . . >
+ for more values
Optional part to be restored .
Type of object to be restored
Language for licensed program
Output . . . . . . . . . . . . .
Release . . . . . . . . . . .
Replace release . . . . . . . .
Save file . . . . . . . . . . .
Library . . . . . . . . . . .
F3=Exit F4=Prompt F5=Refresh
F13=How to use this display
TIBCO Rendezvous Installation
2TRV400 Character value
*SAVF
Name, *SAVF
*BASE
*ALL
*PRIMARY
*NONE
*FIRST
*ONLY
TIBRV
QTEMP
*BASE, 1, 2, 3, 4, 5, 6,7...
*ALL, *PGM, *LNG
Character value, *PRIMARY...
*NONE, *PRINT
Character value, *FIRST
Character value, *ONLY, *NO
Name
Name, *LIBL, *CURLIB
F10=Additional parameters
F24=More keys
More...
F12=Cancel
Post-Installation Instructions 43
|
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 mycompany.com, and the
machine name is mymachine, then put mymachine.mycompany.com in the host
table.
4. For Java programs, set the CLASSPATH environment variable to include
/usr/tibco/tibrv/lib/tibrvj.jar.
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
ADDENVVAR
ADDENVVAR
/* start it */
/* For Java with qsh, set these vars */
ENVVAR(QIBM_MULTI_THREADED) VALUE(Y)
ENVVAR(CLASSPATH) +
VALUE(’/usr/tibco/tibrv/libtibrvj.jar’)
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
44
| 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 45
|
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
46
| 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
| 47
Chapter 6
Universal Installer
This chapter presents installation and uninstallation using TIBCO Universal
Installer.
Topics
•
Before Installing, page 48
•
Install TIBCO Rendezvous, page 50
•
Uninstalling the Software, page 58
TIBCO Rendezvous Installation
48
| 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 49
|
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
50
| Chapter 6
Universal Installer
Install TIBCO Rendezvous
Install a TIBCO Rendezvous product using one of the following modes:
•
Install in GUI Mode on page 50
•
Install in Console Mode on page 56
•
Install in Silent Mode on page 57
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.
5. The Welcome screen appears. Click Next.
TIBCO Rendezvous Installation
Install TIBCO Rendezvous 51
|
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
52
| Chapter 6
Universal Installer
7. Install all features by clicking Typical or choose the features to install by
clicking Custom. After making your choice, click Next.
TIBCO Rendezvous Installation
Install TIBCO Rendezvous 53
|
8. If you selected Custom, in step 7, a screen similar to the following appears. If
you did not select Custom, proceed to step 10. Unselect the check box next to
the features you do not want to install, and click Next.
TIBCO Rendezvous Installation
54
| Chapter 6
Universal Installer
9. The Installation Environment screen appears. Specify a location for installing
Rendezvous.
TIBCO Rendezvous Installation
Install TIBCO Rendezvous 55
|
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
56
| Chapter 6
Universal Installer
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
Install TIBCO Rendezvous 57
|
Install in Silent Mode
The following procedure explains how to install a TIBCO Rendezvous product in
silent mode. The TIBCOUniversalInstaller.silent 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 TIBCOUniversalInstaller.silent 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 TIBCOUniversalInstaller.silent 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="myFile.silent"
If you are using the TIBCOUniversalInstaller.silent 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, com.tibco.installer.util.TIBCOInstaller,
dbg.Debug, Executing Event:::OnEndInstall
TIBCO Rendezvous Installation
58
| Chapter 6
Universal Installer
Uninstalling the Software
Uninstall in GUI Mode
Use the following procedure to uninstall the software:
1. Stop all TIBCO Rendezvous processes.
2. Run the uninstaller:
Navigate to TIBCO_HOME\_uninstall and run the universal_uninstall
executable.
3. The Welcome screen appears. Click Next.
4. To uninstall only TIBCO Rendezvous, select Custom Uninstall.
To uninstall all TIBCO products (installed using the universal installer), select
Typical Uninstall. After making your choice, click Next.
TIBCO Rendezvous Installation
Uninstalling the Software 59
|
5. If you selected Custom Uninstall, then in the next screen select the specific
products to uninstall. The choices include only TIBCO products that you
installed using the universal installer.
6. Click the Uninstall button to remove the selected products.
Uninstall in Silent Mode
The following procedure explains how to uninstall a TIBCO Rendezvous product
in silent mode.
1. Stop all TIBCO Rendezvous processes.
2. Run the uninstaller:
Navigate to TIBCO_HOME\_uninstall and run the universal_uninstall
executable with this command line.
universal_uninstall -V uninstallProductID="rv" -V uninstallProductVersion="8.3.0"
-silent
TIBCO Rendezvous Installation
60
| Chapter 6
Universal Installer
General Command Line
The general form of the command line gives flexibility.
universal_uninstall_executable_filename -V uninstallProductID="product_id" -V
uninstallProductVersion="version" -silent
Table 11 Universal Uninstaller—Command Line Parameters
Parameter
Description
uninstallProductID="product_id"
When present, uninstall only this product.
When absent, uninstall all TIBCO products.
uninstallProductVersion="version"
When present, uninstall only this version.
When absent, uninstall all versions.
TIBCO Rendezvous Installation
| 61
Index
A
M
ALTPRI privilege, VMS 29
Microsoft Windows 13
B
N
byte limit, VMS 31
netmbx, VMS 33
C
O
customer support xx
OPER privilege, VMS 29
D
P
directory structure 3
disk space 49
page file quota, VMS 31
R
I
root priority, UNIX 6
Install TIBCO Rendezvous 50
installer log file 49
S
L
log file 49
setuid root, UNIX 6
support, contacting xx
SYSGEN parameters, VMS 31
TIBCO Rendezvous Installation
62
| Index
T
TCP/IP services, VMS 23
technical support xx
temporary disk space 49
TIBCO_HOME xvii
tmpmbx, VMS 33
U
uninstall 58
UNIX 5
V
VMS 21
W
Windows 13
TIBCO Rendezvous Installation