CONTENTS Title Page Copyright Page Preface 1 Preparing to Install Rdb/VMS 1.1 Required Operating System Components 1.2 Prerequisite and Optional Software 1.2.1 Prerequisite Software 1.2.2 Optional Software 1.3 Prerequisite Hardware 1.4 VMS License Management Facility 1.5 Installing Multiple Licenses on a VAXcluster 1.6 Requirements for Installing Rdb/VMS V4.1 1.6.1 Recover All Rdb/VMS Databases 1.6.2 Back Up All Existing Rdb/VMS Databases 1.6.3 Upgrade Read-Only Storage Areas 1.6.4 Determine Disk Space Required to Install Rdb/VMS 1.6.5 Check for the RDB$REMOTE Account 1.6.6 CDD/Plus Considerations 1.6.7 SQL/Services Considerations 1.6.8 Shut Down the Rdb/VMS Monitor 1.6.9 VMS Privileges Required to Install Rdb/VMS 1.6.10 Process Account Quotas Required to Install Rdb/VMS 1.6.11 System Parameter Values Required to Install Rdb/VMS 1.6.11.1 Checking System Parameter Values 1.6.11.2 Calculating the Values for GBLPAGES and GBLSECTIONS 1.6.11.3 Changing System Parameter Values with AUTOGEN 1.6.11.4 Setting Dynamic System Parameters 1.6.12 Back Up Your System Disk 1.6.13 Avoid Giving Users Access to HELP 1.6.14 Prevent Interactive Users from Gaining Access to the System 1.6.15 Time Required to Install Rdb/VMS 1.7 Summation of Installation Requirements 1.7.1 VMSINSTAL Requirements 1.7.2 Rdb/VMS Requirements 2 Installing Rdb/VMS 2.1 Accessing the Online Release Notes 2.2 Installation Procedure 2.2.1 Invoking VMSINSTAL 2.2.2 Steps of the Installation Procedure 2.2.3 Completing the Installation Procedure 2.3 Errors That Cause the Installation to Fail 3 After Installing Rdb/VMS 3.1 Editing the System Files 3.1.1 Defining LNK$LIBRARY and SQL$USER to Ease Program Linking 3.1.2 Running RMONSTART.COM Manually or with the Installation Verification Procedure (IVP) 3.2 Modifying System Parameters 3.3 Rebooting the System 3.4 VAXcluster Considerations 3.4.1 Using SYSMAN to Load Licenses, Run Startup Procedures, and Run the IVP on Each Node 3.4.2 Executing RDBSERVER_NCP.COM in a VAXcluster Environment 3.5 User Account Requirements 3.6 Converting Existing Databases 3.7 Installing RMU with Privileges 3.8 Tailoring Your System 3.8.1 Defining SYS$LANGUAGES 3.8.2 Setting up DECtrace 3.8.3 Using the RDB$REMOTE Account for Remote Access 3.8.4 Moving Rdb/VMS Demonstration and Sample Database Files to Another Directory 3.8.5 Using Logical Names Created by the Installation Procedure 3.8.6 Displaying a List of Files Installed by Rdb/VMS 3.8.7 Modifying the SQL/Services Configuration File 3.9 Enhancing Rdb/VMS Performance 3.9.1 Tuning Your System 3.9.2 Installing Rdb/VMS Images as Shared 3.10 Running the Installation Verification Procedure (IVP) Separately 3.11 Returning the System to Original Settings 3.12 Using the DEINSTALL_DELETE Command Procedure 3.13 Determining and Reporting Problems 4 Using Multiple Versions of Rdb/VMS 4.1 Overview of Multiple Version Support in Rdb/VMS 4.2 General Instructions for Installing Multiversion Rdb/VMS 4.3 Using Multiversion Rdb/VMS 4.3.1 Establishing a Default Rdb/VMS Environment 4.3.2 Using the RDBVMS_SHOVER.COM Command with Layered Products 4.3.3 Linking Programs 4.3.4 Using LSE Templates in SQL 4.3.5 Accessing Remote Databases 4.3.6 Accessing Online Help 4.4 Changed Images 4.5 Accessing Multiple Versions of SQL/Services 4.5.1 Overview of Multiple Version Support in SQL/Services 4.5.2 Merging the V4.0 and V4.1 Configuration Files to Include Database Definitions 4.5.3 Using the SQLSRV$CONFIG_FILE Logical Name 4.5.4 Activating Configuration File Changes A VMS Security and Rdb/VMS A.1 VMS Privileges Used to Install Rdb/VMS A.2 VMS Privileges Required for RMU Commands A.3 VMS Privileges That Override Rdb/VMS Protection A.4 VMS Protection of Rdb/VMS Files A.5 Rdb/VMS Internal Protection A.6 Auditing B Installing the SQL/Services VMS API B.1 Who Should Install the SQL/Services VMS API? B.2 Preparing to Install the SQL/Services VMS API B.2.1 Prerequisite Software B.2.2 Requirements for Installing SQL/Services VMS API B.2.2.1 Time B.2.2.2 Privileges B.2.2.3 Disk Space B.2.2.4 VMSINSTAL Requirements B.2.2.5 Backing Up Your System Disk B.3 Installing the SQL/Services VMS API B.3.1 Accessing the Distribution Kit B.3.1.1 Accessing the Distribution Kit Using TCP/IP B.3.1.2 Accessing the Distribution Kit Using DECnet B.3.2 Installation Procedure B.3.3 Recovering from Errors B.4 After Installing the SQL/Services VMS API B.4.1 Determining Files Added to the System B.4.2 Running the IVP B.5 Sample Installation C Installing the SQL/Services MS-DOS API C.1 Preparing to Install the MS-DOS APIs C.1.1 Prerequisite Software C.1.2 Installation Procedure Requirements C.1.2.1 Time C.1.2.2 Disk Space C.1.2.3 Installation Program Requirements C.2 Installing the MS-DOS API C.2.1 Creating the DECnet-DOS Programming Interface Library for the MS-DOS API Only C.2.2 Copying and Running the Installation Program C.2.3 Verifying the Installation C.2.3.1 Running the MS-DOS API IVP C.2.3.2 Running the MS-DOS Windows API IVP C.2.4 Recovering from Errors C.3 After Installing the MS-DOS API C.3.1 Determining Files Added to the System C.3.2 Running the IVP C.4 Sample Installation D Installing the SQL/Services ULTRIX API D.1 Preparing to Install the ULTRIX API D.1.1 Prerequisite Software D.1.2 Installation Procedure Requirements D.1.2.1 Time D.1.2.2 Superuser Privileges D.1.2.3 Disk Space D.1.2.4 Installation Program Requirements D.2 Installing the ULTRIX API D.2.1 Installation Procedure D.2.2 Recovering from Errors D.3 After Installing the ULTRIX API D.3.1 Determining Files Added to the System D.3.2 Running the IVP D.4 Sample Installation E Installing the SQL/Services SunOS API E.1 Preparing to Install the SunOS API E.1.1 Prerequisite Software E.1.2 Installation Procedure Requirements E.1.2.1 Time E.1.2.2 Superuser Privileges E.1.2.3 Disk Space E.1.2.4 Installation Program Requirements E.2 Installing the SunOS API E.2.1 Installation Procedure E.2.2 Recovering from Errors E.3 After Installing the SunOS API E.3.1 Determining Files Added to the System E.3.2 Running the IVP E.4 Sample Installation F Installing the SQL/Services OS/2 API F.1 Preparing to Install the SQL/Services OS/2 API F.1.1 Prerequisite Software F.1.2 Installation Procedure Requirements F.1.2.1 Time F.1.2.2 Disk Space F.1.2.3 Installation Program Requirements F.2 Installing the SQL/Services OS/2 API F.2.1 Installation Procedure F.2.2 Verifying the Installation F.2.3 Recovering from Errors F.3 After Installing the SQL/Services OS/2 API F.3.1 Files Added to the System F.3.2 Running the IVP F.4 Sample Installation G Installing API Software for Macintosh Computers G.1 Preparing to Install the Macintosh APIs G.1.1 Prerequisite Software for the Macintosh Client System G.1.1.1 Macintosh API for MPW Prerequisite Software G.1.1.2 Macintosh API for THINK C Prerequisite Software G.1.1.3 PATHWORKS Components Needed for Installation G.1.2 Prerequisite Software for the VMS Server System G.1.3 Installation Procedure Requirements G.1.3.1 Time G.1.3.2 Disk Space G.1.3.3 Installation Program Requirements G.2 Adding and Mounting the Installation Volume G.2.1 Adding the SQLSRV$Volume Installation Volume to the Server G.2.2 Mounting the SQLSRV$Volume Installation Volume on the Macintosh G.3 Installing the Macintosh API for MPW G.3.1 The Macintosh API for MPW Installation Procedure G.3.2 Macintosh API for MPW Installation Files G.4 Installing the Macintosh API for THINK C G.4.1 The Macintosh API for THINK C Installation Procedure G.4.2 Macintosh API for THINK C Installation Files H Sample Installation: Full Development Kit H.1 Standard Installation H.2 Multiversion Installation EXAMPLES 4-1 Default SQL/Services Configuration File for Multiple Version Support 4-2 SQL/Services Configuration File Altered to Run V4.1 SQL/Services TABLES 1-1 Rdb/VMS Product Licenses 1-2 Process Account Quotas for the Installing Account 1-3 Required Minimum System Parameter Values 3-1 User Account Quotas for Using Rdb/VMS 3-2 SQL/Services Logical Names 3-3 Rdb/VMS Images 3-4 SQL and SQL/Services Images A-1 Security Controls Required to Use RMU Functions A-2 VMS Privileges That Override Rdb/VMS Privileges B-1 VMS API Disk Space Requirements B-2 Files Created on or Copied to VMS C-1 Files Created on or Copied to MS-DOS D-1 Files Created on ULTRIX E-1 Files Created on SunOS F-1 Files Created on or Copied to OS/2 G-1 Files for Macintosh API for MPW Installation G-2 Files for Macintosh API for THINK C Installation