Order Number: AA-JD83E-TE VAX Data Distributor Installation Guide November 1990 This manual describes how to install VAX Data Distributor Version 2.2. Revision/Update Information: This manual is a revision and super- sedes previous versions. OPERATING SYSTEM: VMS SOFTWARE VERSION: VAX Data Distributor Version 2.2 Digital Equipment Corporation __________ Copyright ©1987, 1988, 1989, 1990 The following are trademarks of Digital Equipment Corporation: ALL-IN-1, CDD/Plus, DEC, DEC/CMS, DECdecision, DECdtm, DECforms, DECintact, DEC/MMS, DECnet, DECtp, DECtrace, DECwindows, MicroVAX, ULTRIX, UNIBUS, VAX, VAX ACMS, VAX Ada, VAX BASIC, VAX C, VAX CDD, VAXcluster, VAX COBOL, VAX DATATRIEVE, VAX DBMS, VAXELN, VAX FMS, VAX FORTRAN, VAX Pascal, VAX RALLY, VAX Rdb/ELN, VAX Rdb/VMS, VAX RMS, VAX SPM, VAXstation, VAX TEAMDATA, VIDA, VMS, VT, and the DIGITAL Logo. The following are third-party trademarks: IBM is a registered trademark and DB2 is a trademark of International Business Machines Corporation; IDMS/R is a trademark of Cullinet Software, Inc.; ORACLE is a trademark of the ORACLE Corporation. This document was prepared using VAX DOCUMENT, Version 1.2 Contents PREFACE vi CHAPTER 1 PREPARING TO INSTALL VAX DATA DISTRIBUTOR 1-1 1.1 REQUIRED OPERATING SYSTEM COMPONENTS 1-1 1.2 PREREQUISITE AND OPTIONAL SOFTWARE 1-2 1.2.1 Prerequisite Software 1-2 1.2.2 Optional Software 1-3 1.3 PREREQUISITE HARDWARE 1-3 1.4 LICENSE REGISTRATION 1-3 1.5 SPECIAL REQUIREMENTS FOR INSTALLING DATA DISTRIBUTOR 1-5 1.6 VAXCLUSTER SYSTEM CONSIDERATIONS 1-6 1.7 INSTALLATION PROCEDURE REQUIREMENTS 1-6 1.7.1 Time 1-6 1.7.2 Privileges 1-7 1.7.3 Disk Space 1-8 1.7.4 System Parameters 1-8 1.7.5 Process Account Quotas 1-9 1.7.6 VMSINSTAL Requirements 1-9 1.7.7 Backing Up Your System Disk 1-10 1.7.8 Data Distributor Requirements 1-10 1.8 CREATING A VMS RIGHTS DATABASE 1-11 CHAPTER 2 INSTALLING VAX DATA DISTRIBUTOR 2-1 2.1 GENERAL INFORMATION 2-1 2.1.1 Accessing Online Release Notes 2-2 2.1.2 Locating Files Added to the System 2-2 2.1.3 Considerations in Running the Installation Verification Procedure (IVP) 2-2 2.1.4 Aborting the Installation 2-3 iii Contents 2.2 THE INSTALLATION PROCEDURE 2-3 2.2.1 Invoking VMSINSTAL 2-3 2.2.2 Installation Questions 2-5 2.2.3 Informational Messages 2-13 2.2.4 Running the Installation Verification Procedure (IVP) 2-13 2.2.5 Completing the Installation Procedure 2-14 2.3 ERROR RECOVERY 2-14 CHAPTER 3 AFTER INSTALLING VAX DATA DISTRIBUTOR 3-1 3.1 LOADING LICENSES IN A VAXCLUSTER SYSTEM 3-2 3.2 PREPARING THE TRANSFER DATABASE 3-2 3.2.1 Creating the Transfer Database 3-3 3.2.2 Converting the Transfer Database 3-4 3.3 EDITING THE SYSTEM STARTUP FILE 3-7 3.4 EDITING THE SYSTEM SHUTDOWN FILE 3-8 3.5 STARTING TRANSFER MONITORS IN A VAXCLUSTER 3-9 3.6 USING DATA DISTRIBUTOR AND VIDA WITH IDMS/R TOGETHER 3-9 3.7 USING DATA DISTRIBUTOR AND VIDA FOR DB2 TOGETHER 3-11 3.8 USING DATA DISTRIBUTOR AND RDBACCESS FOR ORACLE TOGETHER 3-13 3.9 ENHANCING DATA DISTRIBUTOR PERFORMANCE 3-15 3.10 REBOOTING THE SYSTEM 3-16 3.11 VAX DATA DISTRIBUTOR COMMAND PROCEDURES 3-16 3.11.1 DDAL$START_TR_MON.COM File 3-16 3.11.2 DDAL$STOP_TR_MON.COM File 3-17 3.12 RUNNING THE INSTALLATION VERIFICATION PROCEDURE (IVP) 3-17 3.13 DETERMINING AND REPORTING PROBLEMS 3-19 iv Contents APPENDIX A SAMPLE INSTALLATION A-1 APPENDIX B FILES INSTALLED ON YOUR SYSTEM B-1 TABLES 1-1 Disk Space Requirements 1-8 v _____________________________________________________________________ Preface This manual describes how to install VAX Data Distributor Version 2.2. The installation procedure uses VMSINSTAL. VAX Data Distributor is referred to as Data Distributor throughout this document. ___________________________________________________________________ Intended Audience Those responsible for installing and maintaining Data Distributor should review this manual before beginning the installation proce- dure. You must have access to a privileged account to install Data Distributor. ___________________________________________________________________ Product Compatibility For information on the compatibility of other software products with this version of Data Distributor, refer to the System Support Addendum (SSA) that comes with the Software Product Description (SPD). You can use the SPD/SSA to verify which versions of your operating system are compatible with this version of Data Distributor. ___________________________________________________________________ Structure This manual contains three chapters and two appendixes: Chapter 1 Describes how to prepare for the installation. vi Preface Chapter 2 Walks you through the installation procedure. Chapter 3 Describes the tasks to perform after successfully completing the installation. Appendix A Contains a sample log of the installation procedure. Appendix B Contains the directory location for the files that are copied to your system during the installation. ___________________________________________________________________ Related Manuals You can find detailed information and guidelines about installing software on your VMS system and related system management tasks in the VMS documentation set. You can find additional information about Data Distributor in the following manuals: o VAX Data Distributor Handbook-Provides information, guidelines, and examples for distributing all or portions of VAX Rdb/VMS or VIDA databases in a network. o VAX Data Distributor Release Notes-Describes new and changed features, problems corrected in this release, and current restrictions. Always check the VAX Data Distributor Release Notes for informa- tion that might affect installation. ___________________________________________________________________ Conventions In examples, an implied carriage return occurs at the end of each line, unless otherwise noted. You must press the RETURN key at the end of a line of input. vii Preface This manual uses the following conventions: Color In printed manuals, color in examples shows user input. $ The dollar sign represents the DIGITAL Command Language prompt. This symbol indicates that the DCL interpreter is ready for input. ___________________________________________________________________ References to Products Data Distributor documentation to which this manual belongs often refers to products by their abbreviated names: o VAX CDD/Plus software is referred to as CDD/Plus. o VAX Data Distributor software is referred to as Data Distributor. o VAX Rdb/VMS software is referred to as Rdb/VMS. o VIDA with IDMS/R[TM] software is referred to as VIDA, unless differentiation from the VIDA for DB2[TM] product is necessary. o VIDA for DB2 software is referred to as VIDA, unless differen- tiation from the VIDA with IDMS/R product is necessary. o DEC RdbAccess for VMS, ORACLE Server software is referred to as RdbAccess for ORACLE. viii Chapter 1 Preparing to Install VAX Data Distributor This chapter discusses the preparations and requirements necessary for installing Data Distributor. If you are responsible for the installation, read this manual in its entirety before you begin to install the Data Distributor software. Your bill of materials (BOM) and indented bills report (BIL) specify the number and contents of your media. Be sure to verify the contents of your kit with this information. If your kit is damaged or if you find that parts of it are missing, contact your Digital representative. Data Distributor provides online release notes. Digital strongly recommends that you read the release notes before proceeding with the installation. For information on accessing the online release notes, see Section 2.1.1. 1.1 Required Operating System Components The VMS operating system comes with a variety of support options, or classes. Classes include such features as networking and RMS journaling. To use Data Distributor, your system should be running a version of VMS that includes the following classes: o Network Support Preparing to Install VAX Data Distributor 1-1 o Programming Support o Secure User's Environment o Utilities For a complete list of required classes, see the Software Support Addendum (SSA) that comes with the Software Product Description (SPD). 1.2 Prerequisite and Optional Software This section discusses the software you must have installed on your system before installing Data Distributor. The section also includes information about optional software that you can use with Data Distributor. The SSA contains a complete list of prerequisite and optional software and their required version numbers. The SSA is part of the SPD. 1.2.1 Prerequisite Software To install Data Distributor Version 2.2, you must have installed on your system: o VMS operating system Version 5.3 or higher o Rdb/VMS Version 4.0 You must have completed all database conversions, including any on databases created with Data Distributor Version 2.1 or earlier. See the VAX Rdb/VMS Installation Guide Version 4.0 or higher for information on database conversion. NOTE Data Distributor requires an additional conversion step for a transfer database. After converting the transfer database to the Rdb/VMS Version 4.0 database format and 1-2 Preparing to Install VAX Data Distributor installing Data Distributor, you must then convert the transfer database using a command procedure provided by Data Distributor. Section 3.2.2 describes the conversion procedure for the transfer database. If you plan to use Data Distributor to transfer data between two or more nodes, you must also install DECnet. Refer to the SSA for availability and required versions of prerequisite software. 1.2.2 Optional Software Data Distributor Version 2.2 is compatible with the following Digital software products: o VIDA with IDMS/R o VIDA for DB2 o RdbAccess for ORACLE Please refer to the SSA for a complete list of compatible products and their required version numbers. The SSA is part of the SPD. 1.3 Prerequisite Hardware You can install Data Distributor only when your system meets or exceeds the minimum hardware requirements specified in the SSA, included with the SPD. 1.4 License Registration You must register the Data Distributor license through the VMS License Management Facility (LMF) in accordance with the license agreement signed by your site. The license registration informa- tion you need is contained in the Product Authorization Key (PAK) Preparing to Install VAX Data Distributor 1-3 that is shipped with Data Distributor. The PAK is a paper certifi- cate that contains information about the license you have to run a particular piece of software. During installation, the system asks whether or not you have registered the Data Distributor license and loaded the appro- priate authorization key. You must register the PAK information in the LICENSE database and load your license for Data Distributor before you start the installation. Otherwise, the Installation Verification Procedure (IVP) does not run, and you cannot use the Data Distributor software. To register a license under VMS, first log in to the system man- ager's account, SYSTEM. Then choose one of the following ways to register and load the license: o Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. When it prompts you for information, respond with data from your PAK. o At the DCL prompt, issue the LICENSE REGISTER command using the appropriate qualifiers that correspond to PAK information. Then issue the LICENSE LOAD DATA-DISTRIBUTOR command to load the license. If you plan to use Data Distributor on more than one node in a VAXcluster, you must perform a license load on the other nodes after you complete this installation. Refer to Section 3.1 for further information. For complete information on using LMF, see the License Management Utility Manual in the VMS documentation set. 1-4 Preparing to Install VAX Data Distributor 1.5 Special Requirements for Installing Data Distributor You should install Data Distributor on a standalone system. If users are logged in when you are installing Data Distributor, the installation could fail. To ensure successful installation, perform the following steps: 1. Make sure no users are currently logged in to the system. 2. Make sure all batch jobs are completed. 3. Disable all logins. 4. Make sure transfer monitors (one for each node if you have a VAXcluster) are shut down if you have a previous version of Data Distributor installed. 5. Make sure you have installed Rdb/VMS Version 4.0 or higher, including the Rdb/VMS license. 6. Make sure CDD/Plus is started up if it is installed on your system. NOTE Data Distributor does not require your system to have CDD/Plus installed. However, if the full CDD/Plus CDDSHR image (not the CDDSHR image provided by VMS) is al- ready installed, the Data Distributor Installation Verification Procedure (IVP) requires starting CDD/Plus before Data Distributor is installed. Otherwise, the Data Distributor IVP fails and the installation pro- cedure stops. Data Distributor displays the following error message, or one similar to it, for an image refer- enced by CDDSHR.EXE: Preparing to Install VAX Data Distributor 1-5 %DCL-W-ACTIMAGE, error activating image CDDSHR -CLI-E-IMGNAME, image file $222$DUA3:[SYS14.][SYSLIB]CDDSHR.EXE;1 -SYSTEM-F-PROTINSTALL, protected images must be installed After a failure of this type, start CDD/Plus using the CDD/Plus-supplied SYS$STARTUP:CDDSTRTUP.COM command procedure. For more information about starting CDD/Plus, refer to the VAX CDD/Plus Installation Guide. 1.6 VAXcluster System Considerations If you plan to use Data Distributor in a VAXcluster system, note the following requirements: o Before installing Data Distributor, ensure that a VMS rights database exists on every node in the VAXcluster system on which you plan to run Data Distributor. Refer to Section 1.8 for the required procedures. o After successfully installing Data Distributor, perform a license load on each node in the VAXcluster system. Section 3.1 describes the procedure. 1.7 Installation Procedure Requirements The following sections discuss the requirements for installing Data Distributor. 1.7.1 Time Installing Data Distributor on a standalone VAX 11/780 system takes approximately 10 minutes, not including the Installation Verification Procedure (IVP). The automatic IVP takes approxi- mately 10 minutes. Thus, installing Data distributor and run- ning the IVP on a standalone VAX 11/780 system takes less than 25 1-6 Preparing to Install VAX Data Distributor minutes, depending on the type of media you use and your system configuration. However, you should allow approximately 30 minutes to perform the entire installation procedure, including the procedures you perform before and after the installation. 1.7.2 Privileges To install Data Distributor, you must be logged in to an account that has SETPRV or at least the following privileges: o CMKRNL o WORLD o SYSPRV (with which you can modify privileges to include SETPRV) VMSINSTAL turns off BYPASS privilege at the start of the installa- tion. On most systems, the SYSTEM account has SETPRV and is used to install software. The procedures described in this installation guide refer to the SYSTEM account, but they are the same for any account with SETPRV. If your account does not have SETPRV but does have SYSPRV, you must modify the privileges to include SETPRV. This section shows you how to check and change the privileges for your account. To check the default privileges of the SYSTEM account, log in under user name SYSTEM, and enter this DCL command: $ SHOW PROCESS/PRIVILEGES If the account lacks SETPRV, you cannot install Data Distributor. You have two options: o Ask your system manager to use the VMS Authorize utility (AUTHORIZE) to modify the default privileges of the account to include SETPRV. Preparing to Install VAX Data Distributor 1-7 o Run AUTHORIZE and make the changes yourself, if your account has SYSPRV: $ SET DEFAULT SYS$SYSTEM $ RUN AUTHORIZE UAF> MODIFY SYSTEM/PRIVILEGES=(SETPRV) UAF> EXIT After you make this change, you must log out and log back in for the new privileges to take effect. 1.7.3 Disk Space You must provide sufficient free disk storage space to handle peak requirements during the installation. After Data Distributor is installed, less storage is required. Table 1-1 summarizes the storage requirements for Data Distributor. Table_1-1:_Disk_Space_Requirements________________________________ Blocks During Kit_________________Installation________Blocks_After_Installation_ Data Distributor 6000 3000 Version_2.2_______________________________________________________ To determine the number of free disk blocks on the current system disk, enter the following command at the DCL prompt: $ SHOW DEVICE SYS$SYSDEVICE 1.7.4 System Parameters Data Distributor requires no additional system parameter settings beyond those required for VAX Rdb/VMS. If you have VAX Rdb/VMS Version 4.0 correctly installed on your system, you can install Data Distributor without adjusting any system parameters. 1-8 Preparing to Install VAX Data Distributor 1.7.5 Process Account Quotas Data Distributor requires no additional quota settings beyond those required for VAX Rdb/VMS. If you have VAX Rdb/VMS Version 4.0 correctly installed on your system, you can install Data Distributor without adjusting any quotas. 1.7.6 VMSINSTAL Requirements When you invoke VMSINSTAL, it checks to see if you have performed the following tasks: o Set your default device and directory to SYS$UPDATE o Logged in to a privileged account o Set adequate quotas for installation VMSINSTAL also determines if any users are logged in to the sys- tem. VMSINSTAL requires the installation account to have quotas with the following minimum values: ASTLM = 24 BIOLM = 18 BYTLM = 20,480 DIOLM = 18 ENQLM = 2000 FILLM = 50 PGFLQUOTA = 20,000 If VMSINSTAL detects any problems during installation, it notifies you and asks if you want to continue. In some instances, you can enter YES to continue. To stop the installation and correct the situation, enter NO or press Return. Then correct the problem and restart the installation. Preparing to Install VAX Data Distributor 1-9 1.7.7 Backing Up Your System Disk At the beginning of the installation, VMSINSTAL asks if you have backed up your system disk. Digital recommends that you do a system disk backup before installing any software. Backing up the system disk is a standard precaution for the installation of any VMS layered product. Use the backup procedures established at your site. For details on performing a system disk backup, see the section on the Backup Utility in the VMS System Management Subkit. 1.7.8 Data Distributor Requirements The Data Distributor installation procedure checks the following items: o Rdb/VMS and Data Distributor licenses registered and loaded o Minimum VMS version o Rdb/VMS version o Disk space o System parameters o Installation account quotas o VMS rights database If VMSINSTAL encounters problems in any of these areas, it termi- nates the installation procedure. You must correct the problems and then restart the installation process. 1-10 Preparing to Install VAX Data Distributor Refer to Section 3.1 for information on loading licenses. See the appropriate sections in this chapter for information about requirements for the VMS version, the Rdb/VMS version, disk space, system parameters, installation account quotas, and the VMS rights database. 1.8 Creating a VMS Rights Database Before you can install Data Distributor, a VMS rights database must exist on every standalone system or on every node in a VAXcluster on which Data Distributor is running. To check for the existence of a VMS rights database on your node, set default to SYS$SYSTEM and get a directory listing. If a system logical, RIGHTSLIST, is defined, make sure that the RIGHTSLIST.DAT file is present in the directory that the RIGHTSLIST system logical points to. If the system logical is not defined, the RIGHTSLIST.DAT file should be present in the SYS$SYSTEM directory. If the RIGHTSLIST.DAT file does not exist in either of these two di- rectories, you must create the rights database. Use the CREATE /RIGHTS command in the VMS Authorize utility: $ SET DEFAULT SYS$SYSTEM $ RUN AUTHORIZE UAF> CREATE/RIGHTS UAF> EXIT Once a rights database exists on your system, make sure the SYSTEM identifier is defined in the rights database. Check whether the SYSTEM identifier exists on your system by using the SHOW /IDENTIFIER command in the VMS Authorize Utility: $ SET DEFAULT SYS$SYSTEM $ RUN AUTHORIZE UAF> SHOW/IDENTIFIER SYSTEM UAF> EXIT Preparing to Install VAX Data Distributor 1-11 If the SYSTEM identifier does not exist, you must add it to your rights database by using the ADD/IDENTIFIER/USER command in the VMS Authorize utility: $ SET DEFAULT SYS$SYSTEM $ RUN AUTHORIZE UAF> ADD/IDENTIFIER/USER=SYSTEM UAF> EXIT The protection of the rights database file, RIGHTSLIST.DAT, must be set for World Read privilege. Set the protection using the following command: $ SET PROTECTION=(W:R) RIGHTSLIST.DAT For more information on creating and maintaining a VMS rights database, see the documentation on VMS system security and the VMS Authorize utility. 1-12 Preparing to Install VAX Data Distributor Chapter 2 Installing VAX Data Distributor This chapter describes how to install Data Distributor Version 2.2. Section 2.2 contains a step-by-step description of the in- stallation procedure. 2.1 General Information This section includes information about the following topics: o Accessing release notes o Locating installed files o Running the Installation Verification Procedure (IVP) o Aborting the installation Installing VAX Data Distributor 2-1 2.1.1 Accessing Online Release Notes Data Distributor provides online release notes. You must specify OPTIONS N when you invoke VMSINSTAL to see the online release notes question. This question comes near the beginning of the installation. You should review the release notes in case they contain any in- formation about changes that occurred in the installation pro- cedure after the installation guide was published. If you are starting the installation over again and have already reviewed the release notes, you do not need to specify OPTIONS N. Once Data Distributor has been installed, the release notes are located in the following file: SYS$HELP:DDAL022.RELEASE_NOTES Hardcopy release notes are included with the Data Distributor documentation set. 2.1.2 Locating Files Added to the System The list of files added to the system during the Data Distributor installation procedure is copied to a file on your system. Refer to Appendix B for details. 2.1.3 Considerations in Running the Installation Verification Procedure (IVP) The IVP for Data Distributor verifies that the software was in- stalled properly. During installation, you are asked if you want to run the IVP as part of the installation. If you respond YES, VMSINSTAL runs the IVP. Digital recommends that you run the veri- fication procedure. 2-2 Installing VAX Data Distributor After Data Distributor is installed, you can run the IVP indepen- dently to verify that the software is available on your system. In addition, you might want to run the IVP after a system failure to be sure that users can access Data Distributor. See Section 3.12 to learn about running the IVP independent of the installation. NOTE To execute the IVP, the Rdb/VMS monitor must be running on your system. 2.1.4 Aborting the Installation To abort the installation procedure at any time, press Ctrl/y. This deletes all files created up to that point and exits. You can then start the installation again. 2.2 The Installation Procedure The Data Distributor installation process consists of a series of questions and informational messages. The following sections describe this process. NOTE You can install Data Distributor on a single CPU system or from any node on a VAXcluster. 2.2.1 Invoking VMSINSTAL To start the installation, invoke the VMSINSTAL command procedure from a privileged account, such as the SYSTEM account. VMSINSTAL is in the SYS$UPDATE directory. Use the following syntax to invoke VMSINSTAL: @SYS$UPDATE:VMSINSTAL saveset-name device-name OPTIONS N Installing VAX Data Distributor 2-3 saveset-name The installation name for the product. For Data Distributor, use the following installation name: DDAL022 device-name The name of the device on which you plan to mount the media. For example, MTA0: is the device name for a tape drive. It is not necessary to use the console drive for this installation. However, if you do use the console drive, you should replace any media you removed once the installation is complete. OPTIONS N An optional parameter that indicates you want to see the release notes question. If you do not include the OPTIONS N parameter, VMSINSTAL does not ask you about the release notes. You should review the release notes before you proceed with the installation in case they contain new information about the installation. There are several other options you can select when you invoke VMSINSTAL. See the VMS documentation on software installation in the VMS System Management Subkit for information on these options. If you specify more than one option, separate the options with commas, for example: OPTIONS A,N. The following example invokes VMSINSTAL to install Data Distributor from tape drive MTA0: and shows the system response. This example uses the OPTIONS N release note parameter. $ @SYS$UPDATE:VMSINSTAL DDAL022 MTA0: OPTIONS N VAX/VMS Software Product Installation Procedure V5.3 It is 1-MAY-1990 at 09:05. Enter a question mark (?) at any time for help. 2-4 Installing VAX Data Distributor If you do not supply either the product name or the device name, VMSINSTAL prompts you for this information later on in the instal- lation procedure. VMSINSTAL does not prompt you for any options, so be sure to include the OPTIONS N parameter on the VMSINSTAL command line to access the release notes during installation. 2.2.2 Installation Questions This section discusses the questions that appear during installa- tion. Appendix A contains a sample installation procedure showing how the questions can be answered. Each question is marked with an asterisk (*) at the beginning of the line. Some questions show the default response in brackets, for example [YES]. To use the default response, press Return. Installing VAX Data Distributor 2-5 Perform the following steps to install Data Distributor: 1. System backup VMSINSTAL asks if you are satisfied with your system backup. You should always back up your system disk before you perform an installation. If you are satisfied with the backup of your system disk, press Return. Otherwise, enter NO to discontinue the installation. After you back up your system disk, you can restart the installation. * Are you satisfied with the backup of your system disk [YES]? 2. Mounting the media You should now mount the first distribution volume on the device you specified when you invoked VMSINSTAL. The device name appears in the line preceding the question. VMSINSTAL then asks if you are ready to continue with the installation. If you respond YES to indicate that you are ready, VMSINSTAL displays a message that the media containing Data Distributor has been mounted on the specified device and that the installa- tion has begun. For example: Please mount the first volume of the set on MTA0:. * Are you ready? YES %MOUNT-I-MOUNTED, DDAL MOUNTED ON _$$MTA0: (NODE 1) The following products will be processed: DDAL V2.2 Beginning installation of DDAL V2.2 at 09:06 %VMSINSTAL-I-RESTORE, Restoring product saveset A... If you entered the wrong device name when you invoked VMSINSTAL and need to restart the installation, enter NO in response to the "Are you ready?" question. To abort the installation for other reasons, press Ctrl/y. 3. Release Notes 2-6 Installing VAX Data Distributor If you specified OPTIONS N when you invoked VMSINSTAL, VMSINSTAL asks a release notes question. You have four op- tions for handling the release notes under VMS Version 5.3 or higher. For VMS Version 5.3 or higher, you see the following display: The release notes included with this kit are always copied to SYS$HELP. 1. Display release notes 2. Print release notes 3. Both 1 and 2 4. None of the above * Select option [2]: Installing VAX Data Distributor 2-7 If you are installing Data Distributor Version 2.2 for the first time and have not previously reviewed the release notes, select option 2. The release notes for Data Distributor are quite long and should be read thoroughly before you proceed any further with the installation. If you have already reviewed the release notes and are restart- ing the installation, select option 4. Regardless of the op- tion, the installation procedure moves the release notes into SYS$HELP. Select one of the following options: o Option 1 VMSINSTAL immediately displays the release notes on the console terminal. You can terminate the display at any time by pressing Ctrl/c. o Option 2 VMSINSTAL prompts you for the name of the print queue that you want to use: * Queue name [SYS$PRINT]: You can press Return to send the file to the default output print device, or you can enter another queue name. o Option 3 VMSINSTAL immediately displays the release notes on the console terminal. It then prompts you for a queue name and prints the release notes on the output print device you selected. o Option 4 VMSINSTAL neither displays nor prints a copy of the release notes. 4. Continuing the installation 2-8 Installing VAX Data Distributor The installation procedure now asks if you want to continue the installation. To continue, enter YES. Otherwise, press Return. A message indicates that the release notes are copied to a file in the SYS$HELP directory. For example: * Do you want to continue the installation [N]?: YES %VMSINSTAL-I-RELMOVED, The product's release notes have been successfully moved to SYS$HELP. The release notes are located in the following file: SYS$HELP:DDAL022.RELEASE_NOTES Installing VAX Data Distributor 2-9 5. License Registration The installation procedure displays license information about your product and then asks if you have registered and loaded your authorization key for Data Distributor. For example: Product: DATA-DISTRIBUTOR Producer: DEC Version: 2.2 Release Date: 25-AUG-1990 * Does this product have an authorization key registered and loaded? If you have not registered and loaded your authorization key, you must answer "NO" to this question. You must register and load your product authorization key to complete the instal- lation successfully. If you have not, stop the installation, register and load your product authorization key, and restart the installation. If you encounter any LMF error messages, refer to the VMS License Management Utility Manual. 6. Package to be installed The installation procedure now displays the name of the package you are installing: Installation procedures for VAX Data Distributor V2.2-0 7. Checking system requirements The installation procedure displays the following message while checking several system requirements: Checking system requirements ... Checking user limits ... The installation procedure displays an error message and aborts if the procedure finds that your system does not have the following software and hardware requirements: o VMS Version 5.3 or higher 2-10 Installing VAX Data Distributor o Rdb/VMS Version 4.0 or higher o Adequate disk space (at least 2800 free blocks) o BYTLM (byte limit) is at least 20,480 o FILLM (file limit) is at least 50 o ENQLM (lock request quota) is at least 2000 o ASTLM (AST queue limit) is at least 24 o BIOLM (buffered I/O count limit) is at least 18 o DIOLM (direct I/O count limit) is at least 18 o PGFLQUOTA (page file quota) is at least 20,000 If you encounter an error at this point, take steps to meet your system requirements and then restart the installation procedure. 8. Choosing to purge files You have the option to purge files that are superseded by this installation and that exist from previous versions of Data Distributor. Purging is recommended; however, if you need to keep files from the previous version, enter NO in response to the question. * Do you want to purge files replaced by this installation [YES]? 9. Choosing to run the IVP The installation procedure now asks if you want to run the IVP. The Data Distributor IVP makes sure that the installation is successful. Digital recommends that you run the IVP. * Do you want to run the IVP after the installation [YES]? Installing VAX Data Distributor 2-11 Section 3.12 describes how to run the IVP independent of the installation procedure. The independent IVP allows you a way to check that Data Distributor software components are functioning correctly after the product is installed. 10.Choosing to continue the installation procedure The installation procedure displays a message indicating the approximate time to complete the installation. If you entered YES to the previous question about running the IVP, the instal- lation procedure also displays the time required for the IVP to run. Before the actual installation begins, you have the option of terminating the procedure. To complete the installation on a standalone VAX 11/780 will take approximately: 10 minutes to install 10 minutes to run the IVP All required questions have been asked. You may terminate the installation procedure at this time. * Do you want to continue the installation? [YES]? If you enter YES, the installation procedure displays messages indicating that the actual installation has started. %VMSINSTAL-I-RESTORE, Restoring product saveset B... %VMSINSTAL-I-RESTORE, Restoring product saveset C... If you respond NO, the Data Distributor installation procedure terminates. 2-12 Installing VAX Data Distributor 2.2.3 Informational Messages At this point, the installation procedure displays a number of informational messages that report on the progress of the in- stallation. There are no further questions. If the installation procedure has been successful up to this point, VMSINSTAL displays a message about system command files, creates system disk directo- ries, moves the new or modified files to their target directories, updates help files, and updates DCL tables, if necessary. If you asked for files to be purged, that work is done now. Refer to Appendix A for examples of informational messages that VMSINSTAL displays. 2.2.4 Running the Installation Verification Procedure (IVP) If you chose to run the IVP, VMSINSTAL runs it now. When the IVP runs successfully, you see the following display: COPYRIGHT (c) 1987, 1988, 1989, 1990 BY DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASS. ************************************************************* The VAX Data Distributor IVP verifies that all critical files are in place and all its components are functional. ************************************************************* Executing IVP for: VAX Data Distributor V2.2-0 ************************************************************* Creating the Transfer Database... ************************************************************* ************************************************************* Starting the Transfer Monitor... ************************************************************* Installing VAX Data Distributor 2-13 ************************************************************* Running VAX Data Distributor... ************************************************************* ************************************************************* VAX Data Distributor IVP completed successfully ************************************************************* IVP completed for: VAX Data Distributor V2.2-0 2.2.5 Completing the Installation Procedure The following messages indicate that the entire installation procedure is complete: Installation of DDAL V2.2 completed at 09:22 VMSINSTAL procedure done at 09:22 You can now log out of the privileged account: $ LOGOUT SYSTEM logged out at 1-MAY-1990 09:22:12.18 VMSINSTAL deletes or changes entries in the process symbol tables during installation. Therefore, if you are going to continue using the system manager's account and you want to restore these symbols, log out and log in again. 2.3 Error Recovery If errors occur during installation or when the IVP is running, VMSINSTAL displays failure messages. If the installation fails, you see the following message: %VMSINSTAL-E-INSFAIL, The installation of DDAL V2.2 has failed. 2-14 Installing VAX Data Distributor If the IVP fails, you see these messages: ************************************************************* VAX Data Distributor IVP failed See SYS$UPDATE:DDAL$IVP.LOG for errors ************************************************************* Errors can occur during installation if any of the following conditions exist: o The Rdb/VMS monitor is not running o The operating system version is incorrect o The prerequisite software version is incorrect o The quotas necessary for successful installation are insuffi- cient o The system parameter values for successful installation are insufficient o The VMS help library is currently in use o The product license has not been registered and loaded For descriptions of the error messages generated by these con- ditions, see the VMS documentation on system messages, recovery procedures, and VMS software installation. If you are notified that any of these conditions exist, take the appropriate action as described in the message. (You might need to change a system parameter or increase an authorized quota value.) For information on installation requirements, see Chapter 1. Installing VAX Data Distributor 2-15 Chapter 3 After Installing VAX Data Distributor After you install Data Distributor, you must perform a number of tasks. You also have the option of performing others. Read each section to determine whether or not it contains required or optional tasks for your site. The list of tasks follows: o Register and load the Data Distributor license o Create or convert a transfer database o Edit the system startup file o Edit the system shutdown file o Start the transfer monitor on every node in the cluster if you plan to run Data Distributor in a VAXcluster o Create command files for installing and deinstalling VIDA images if you plan to use VIDA with Data Distributor o Check user account parameters o Reboot the system After Installing VAX Data Distributor 3-1 o Modify Data Distributor command procedures if necessary This chapter also explains how to run the Installation Verification Procedure (IVP) independently after the software has been in- stalled. Finally, this chapter suggests what to do when you find an error in either the software or the documentation. 3.1 Loading Licenses in a VAXcluster System You must perform the following tasks before you install Data Distributor: 1. Register the Data Distributor license in the LICENSE database on the installing system. 2. Load the license on that same system. After you perform these procedures and install Data Distributor, you now must load the license on each of the other nodes in your VAXcluster. To load the Data Distributor license on each node in the cluster, enter the following command: $ LICENSE LOAD DATA-DISTRIBUTOR %LICENSE-I-LOADED, DEC DATA-DISTRIBUTOR was successfully loaded with 0 units. LMF displays a message showing that the license loaded prop- erly. For further information about loading licenses, see the VMS License Management Utility Manual in the VMS Documentation set. 3.2 Preparing the Transfer Database This section describes how to create and convert a transfer database. 3-2 After Installing VAX Data Distributor If you plan to install Data Distributor on a VAXcluster, you can have one transfer monitor for each node on the cluster, but you can have only one transfer database for each cluster. NOTE If you have installed Data Distributor on a cluster so that each node has a transfer monitor and a transfer database, you run the risk of having two transfers with the same name defined to access the same database. Replication transfer definitions are stored in the source database as well as in the transfer database. If you have more than one transfer database on your system, you might have two transfers with the same name trying to access the same source database. Both transfers are started, but inconsistent results can occur in the target databases. Problems can also arise if you have several transfer databases on one VAXcluster system and you have trans- fers of the same name trying to target the same existing database. Ensuring that you have only one transfer database in a cluster environment always resolves this problem. 3.2.1 Creating the Transfer Database You must create the transfer database if you do not already have one on your system or cluster. If for any reason you need to create a new transfer database when you already have one, you must stop the transfer monitors and delete the old transfer database before you create a new one. Run the command procedure to create a transfer database after you finish installing Data Distributor. You must have write access to the target directory to create the transfer database. Enter the following command at the DCL prompt to invoke the command procedure: $ @SYS$MANAGER:DDAL$CREATE_TR_DB.COM After Installing VAX Data Distributor 3-3 This command procedure prompts you for a location in which to store the transfer database. The default location is SYS$COMMON:[SYSEXE]. The name of the transfer database file is DDAL$TR_DB.RDB. You can specify a different device and directory as long as both cur- rently exist. Data Distributor always sets the database file name to DDAL$TR_DB.RDB. In a VAXcluster environment, the location you specify for the transfer database should be accessible from all nodes in the cluster. The command procedure displays the default location as a prompt to the user to specify a disk and a directory for the transfer database location. In the following example, the user specifies DISK1 as the device and [DBA.DDIS] as the directory. Transfer Database location : DISK1:[DBA.DDIS] After you enter the device and directory specifications, Data Distributor displays the location and the name of the database. *** Transfer Database is DISK1:[DBA.DDIS]DDAL$TR_DB Because the transfer database contains privileged information, the device and directory you specify should be protected from casual access. The transfer monitor, which uses the transfer database, runs with special privileges, so it can always access the transfer database regardless of the protection you have on the transfer database directory. 3.2.2 Converting the Transfer Database If you already have a transfer database on your system or cluster, you must convert it before you can use the new version of Data Distributor. Two different kinds of conversion must be done: o The first type of conversion, mentioned in Section 1.2.1, requires that all existing Rdb/VMS databases be converted to the new Rdb/VMS database format after installation of Rdb/VMS Version 4.0. Refer to the VAX Rdb/VMS Installation Guide for 3-4 After Installing VAX Data Distributor information about converting databases to the Rdb/VMS Version 4.0 format. o The second type of conversion, required by Data Distributor, adds new columns and tables to the Data Distributor tables in a transfer database. It also changes the internal format of existing transfer definitions to conform with changes made in Data Distributor Version 2.1. To convert your database, you must execute the DDAL$CONVERT_TR_DB.COM command procedure from a privileged account with a system UIC. Before you run the procedure, be sure that Data Distributor is not running. (You need to check that Data Distributor is not running on all nodes if it is installed in a VAXcluster.) Do not con- vert the transfer database when it is in use. Enter the following command at the DCL prompt to invoke the conversion procedure: $ @SYS$MANAGER:DDAL$CONVERT_TR_DB.COM The conversion command procedure asks for responses to the follow- ing five questions: o What is the file specification for the transfer database? Enter an explicit file specification or logical name. o Did you remember to shut down Data Distributor on all machines in your VAXcluster (if you have one) or on your system (if it is not part of a VAXcluster)? Conversion should not occur while Data Distributor is running. o Did you remember to make a backup copy of the transfer database as a normal precaution before running this conversion proce- dure? Conversion does not make a copy of the existing transfer database before making changes to it; in the interest of safety, make a copy of the transfer database. After Installing VAX Data Distributor 3-5 o Are you satisfied that the transfer database is in a format that can be read by the latest version of Rdb/VMS? You must convert existing Rdb/VMS databases to the disk format of Rdb/VMS Version 4.0; refer to the VAX Rdb/VMS Installation Guide for instructions. o Do you wish the conversion to take place? This question gives you a last chance to abort; a YES response starts the conversion of the transfer database. The first question asks for the file specification or the logical name of the transfer database you want to convert. The system logical name for the system's transfer database is DDAL$TRANSFER_ DATABASE. The last four questions require YES or NO responses. If you answer NO to any of the last four questions, the procedure ends, no changes are made to the transfer database, and control is returned to DCL command level. After you enter a file specification and answer YES to the re- maining questions, the conversion procedure displays a series of informational messages and a statistical summary. For example: ... Adding fields and relations ... Converting stored transfer definitions Conversion not needed for the transfer named SALARY_RANGES Conversion not needed for the transfer named JOB_CODES Converted definition for transfer named MA_EMP Converted definition for transfer named NH_EMP Converted definition for transfer named ALL_EMP --------------------------------------------------- 3-6 After Installing VAX Data Distributor Number of transfers converted . . . . . . . . 3 Number of transfers not requiring conversion . 2 Number of transfers with conversion errors . . 0 ---- Total number of transfer definitions . 5 --------------------------------------------------- All transfer definitions have been processed. Now setting the database revision number. Finally, the conversion command procedure ends with the following message: Conversion of the transfer database to VAX Data Distributor V2.2 format has completed. For further steps needed in order to resume operation of Data Distributor, consult Data Distributor documentation. Make sure to protect the device and directory you specify for the transfer database. Because the transfer monitor runs with special privileges, it can always access the transfer database regardless of the protection you have on the transfer database directory. 3.3 Editing the System Startup File Edit the following system startup file to start Data Distributor automatically when your system is booted: SYS$MANAGER:SYSTARTUP_V5.COM Add a line to the startup file to run the transfer monitor startup command procedure, DDAL$START_TR_MON.COM. Be sure to place this new line after the line to process the Rdb/VMS startup file. If VIDA is installed on your system, you must edit the file SYS$MANAGER:SYSTARTUP_V5.COM to install the VIDA images mentioned in Section 3.6 and Section 3.7. If RdbAccess for ORACLE is installed on your system, you must edit the file SYS$MANAGER:SYSTARTUP_V5.COM to install the RdbAccess for ORACLE images mentioned in Section 3.8. After Installing VAX Data Distributor 3-7 If Rdb/ELN is not installed on your system, no additional edits are necessary. If Rdb/ELN is installed on your system, you must edit your SYS$MANAGER:SYSTARTUP_V5.COM file to install the Rdb/ELN images as follows: $ @SYS$MANAGER:RDBB$STARTUP.COM The DDAL$START_TR_MON command procedure requires two parameters: the transfer database location and the log file location. You must include these parameters in the line that invokes the DDAL$START_ TR_MON command procedure. The transfer database location must be the same one that you specified when you created the transfer database. Data Distributor sets the transfer database file name to DDAL$TR_ DB.RDB. The name of the log file includes the node on which the log file is located. The format is: DDAL$node-name_TR_MON.LOG The following example shows the new line added after the one that invokes the Rdb/VMS RMONSTART command procedure. The transfer database location is DISK1:[DBA.DDIS]. In this example, the log file location is the same: $ @SYS$MANAGER:RMONSTART.COM $ @SYS$STARTUP:DDAL$START_TR_MON.COM DISK1:[DBA.DDIS] DISK1:[DBA.DDIS] $ @SYS$MANAGER:VIDA_INSTALL.COM $ @SYS$MANAGER:VIDA2_INSTALL.COM $ @SYS$MANAGER:VIDAO_INSTALL.COM $ @SYS$MANAGER:RDBB$STARTUP.COM 3.4 Editing the System Shutdown File Edit the following file to stop Data Distributor automatically when the system is shut down: SYS$MANAGER:SYSHUTDWN.COM 3-8 After Installing VAX Data Distributor You must add a line to the shutdown file, SYSHUTDWN.COM, to stop the transfer monitor. Be sure to place this new line before the lines that process the Rdb/VMS shutdown files. In a VAXcluster environment, this line must be added to the SYSHUTDWN.COM file and executed on each node in the cluster. In the following example, just the first line was added: $ @SYS$MANAGER:DDAL$STOP_TR_MON.COM $ @SYS$MANAGER:RMONSTOP.COM $ @SYS$MANAGER:VIDA_DEINSTALL.COM $ @SYS$MANAGER:VIDA2_DEINSTALL.COM $ @SYS$MANAGER:VIDAO_DEINSTALL.COM 3.5 Starting Transfer Monitors in a VAXcluster You can install Data Distributor from any node on the cluster. Once you have performed the installation, you must start the transfer monitor on every node in the cluster. To do this, execute the command procedure @SYS$STARTUP:DDAL$START_TR_MON from every node. If you have added the SYS$STARTUP:DDAL$START_TR_MON command line to the SYSTARTUP_V5.COM file for each node, a transfer monitor is automatically started on that node as you reboot each node on the cluster. See Section 3.3 for more information. 3.6 Using Data Distributor and VIDA with IDMS/R Together If you plan to use Data Distributor to access VIDA with IDMS/R databases, you must use the VMS Install utility (INSTALL) to install the following VIDA with IDMS/R images: o SYS$SHARE:VIDASHR.EXE o SYS$SHARE:SNA3270SH.EXE After Installing VAX Data Distributor 3-9 o SYS$MESSAGE:SNA3270MG.EXE o SYS$MESSAGE:VIDA_MESSAGE.EXE The VMS operating system requires that all image files activated by a privileged image be installed using the Install utility. Data Distributor has a privileged image that must activate the VIDA with IDMS/R images in the SYS$SHARE directory as well as message file images that are subordinate to the images in SYS$SHARE. When the system shuts down and comes back up again, these images are no longer installed. To ensure that the VIDA with IDMS/R images are always available to Data Distributor, create a command procedure and locate that procedure in a file such as SYS$MANAGER:VIDA_INSTALL.COM. Then, edit the SYSTARTUP_V5.COM file to add a line that automatically runs the procedure at system startup. Here are the contents of the command file: $! $! A command file to make the VIDA with IDMS/R images known to $! Data Distributor $! $ INSTALL :== $INSTALL/COMMAND $ INSTALL ADD SYS$SHARE:VIDASHR.EXE ADD SYS$SHARE:SNA3270SH.EXE ADD SYS$MESSAGE:SNA3270MG.EXE ADD SYS$MESSAGE:VIDA_MESSAGE.EXE EXIT $ EXIT Add the line that invokes this procedure to the SYSTARTUP_V5.COM file, just after the line that invokes the DDAL$START_TR_MON.COM procedure. For example: $ @SYS$STARTUP:[SYSMGR]:DDAL$START_TR_MON.COM DISK1:[DBA.DDIS] DISK1:[DBA.DDIS] $ @SYS$COMMON:[SYSMGR]:VIDA_INSTALL.COM 3-10 After Installing VAX Data Distributor Also include the VIDA shutdown file as part of the system shutdown procedure. Here are the contents of the command file: $ ! $ ! A command file to deinstall VIDA with IDMS/R images needed by $ ! Data Distributor $ ! $ INSTALL:==$INSTALL/COMMAND $ INSTALL REMOVE SYS$SHARE:VIDASHR.EXE REMOVE SYS$SHARE:SNA3270SH.EXE REMOVE SYS$MESSAGE:SNA3270MG.EXE REMOVE SYS$MESSAGE:VIDA_MESSAGE.EXE EXIT $ EXIT Add the line that invokes this procedure to the SYSHUTDWN.COM file in SYS$MANAGER after the line that invokes the DDAL$STOP_TR_ MON.COM procedure. For example: $ @SYS$COMMON:[SYSMGR]DDAL$STOP_TR_MON.COM $ @SYS$COMMON:[SYSMGR]VIDA_DEINSTALL.COM 3.7 Using Data Distributor and VIDA for DB2 Together VIDA for DB2 consists of two products: VIDA Client for DB2 and VIDA Server for DB2. VIDA Client for DB2 is installed on a VAX system. VIDA Server for DB2 is installed on an IBM system. These two software components of VIDA for DB2 allow VMS users to re- trieve data from IBM database 2 (DB2) data tables on an IBM system to create VIDA for DB2 databases that VMS users can access. If you plan to use Data Distributor to access VIDA for DB2 databases, you must use the VMS Install utility (INSTALL) to install the following VIDA for DB2 images: o SYS$SHARE:VIDA2SHR.EXE After Installing VAX Data Distributor 3-11 o SYS$SHARE:SNALU62SH.EXE o SYS$MESSAGE:VIDA2$MESSAGE.EXE The VMS operating system requires that all image files activated by a privileged image be installed using the Install utility. Data Distributor has a privileged image that must activate the VIDA for DB2 images in the SYS$SHARE directory as well as message file images that are subordinate to the images in SYS$SHARE. When the system shuts down and comes back up again, these images are no longer installed. To ensure that the VIDA for DB2 images are always available to Data Distributor, create a command procedure and locate it in a file such as SYS$MANAGER:VIDA2_INSTALL.COM. Then edit the SYSTARTUP_V5.COM file to add a line that automatically runs the procedure at system startup. Here are the contents of the command file: $! $! A command file to make the VIDA for DB2 images known to $! Data Distributor $! $ INSTALL :== $INSTALL/COMMAND $ INSTALL ADD SYS$SHARE:VIDA2SHR.EXE ADD SYS$SHARE:SNALU62SH.EXE ADD SYS$MESSAGE:VIDA2$MESSAGE.EXE EXIT $ EXIT Add the line that invokes this procedure to the SYSTARTUP_V5.COM file just after the line that invokes the DDAL$START_TR_MON.COM procedure. For example: $ @SYS$STARTUP:[SYSMGR]:DDAL$START_TR_MON.COM DISK1:[DBA.DDIS] DISK1:[DBA.DDIS] $ @SYS$COMMON:[SYSMGR]:VIDA2_INSTALL.COM 3-12 After Installing VAX Data Distributor Also include the VIDA shutdown file as part of the system shutdown procedure. Here are the contents of the command file: $ ! $ ! A command file to deinstall VIDA for DB2 images needed by $ ! Data Distributor $ ! $ INSTALL:==$INSTALL/COMMAND $ INSTALL REMOVE SYS$SHARE:VIDA2SHR.EXE REMOVE SYS$SHARE:SNALU62SH.EXE REMOVE SYS$MESSAGE:VIDA2$MESSAGE.EXE EXIT $ EXIT Add the line that invokes this procedure to the SYSHUTDWN.COM file in SYS$MANAGER after the line that invokes the DDAL$STOP_TR_ MON.COM procedure. For example: $ @SYS$COMMON:[SYSMGR]DDAL$STOP_TR_MON.COM $ @SYS$COMMON:[SYSMGR]VIDA2_DEINSTALL.COM 3.8 Using Data Distributor and RdbAccess for ORACLE Together Data Distributor uses RdbAccess for ORACLE as an interface to ORACLE databases. This interface enables you to create transfers that copy some or all of an ORACLE source database to an Rdb/VMS target database. If you plan to use Data Distributor to access ORACLE databases, you must use the VMS Install utility (INSTALL) to install the following RdbAccess for ORACLE images: o SYS$SHARE:VIDAOSHR.EXE o SYS$SHARE:VIDAOS.EXE After Installing VAX Data Distributor 3-13 o SYS$MESSAGE:VIDAO$MESSAGE.EXE The VMS operating system requires that all image files activated by a privileged image be installed using the Install utility. Data Distributor has a privileged image that must activate the RdbAccess for ORACLE images in the SYS$SHARE directory as well as message file images that are subordinate to the images in SYS$SHARE. When the system shuts down and comes back up again, these images are no longer installed. To ensure that the RdbAccess for ORACLE images are always avail- able to Data Distributor, create a command procedure and locate it in a file such as SYS$MANAGER:VIDAO_INSTALL.COM. Then edit the SYSTARTUP_V5.COM file to add a line that automatically runs the procedure at system startup. Here are the contents of the command file: $! $! A command file to make the RdbAccess for ORACLE images known to $! Data Distributor $! $ INSTALL :== $INSTALL/COMMAND $ INSTALL ADD SYS$SHARE:VIDAOSHR.EXE ADD SYS$SHARE:VIDAOS.EXE ADD SYS$MESSAGE:VIDAO$MESSAGE.EXE EXIT $ EXIT Add the line that invokes this procedure to the SYSTARTUP_V5.COM file just after the line that invokes the DDAL$START_TR_MON.COM procedure. For example: $ @SYS$STARTUP:[SYSMGR]:DDAL$START_TR_MON.COM DISK1:[DBA.DDIS] DISK1:[DBA.DDIS] $ @SYS$COMMON:[SYSMGR]:VIDAO_INSTALL.COM 3-14 After Installing VAX Data Distributor Also include a RdbAccess for ORACLE shutdown file as part of the system shutdown procedure. The following example shows the contents of the command file that you should create: $ ! $ ! A command file to deinstall RdbAccess for ORACLE images needed by $ ! Data Distributor $ ! $ INSTALL:==$INSTALL/COMMAND $ INSTALL REMOVE SYS$SHARE:VIDAOSHR.EXE REMOVE SYS$SHARE:VIDAOS.EXE REMOVE SYS$MESSAGE:VIDAO$MESSAGE.EXE EXIT $ EXIT Add the line that invokes this procedure to the SYSHUTDWN.COM file in SYS$MANAGER after the line that invokes the DDAL$STOP_TR_ MON.COM procedure. For example: $ @SYS$COMMON:[SYSMGR]DDAL$STOP_TR_MON.COM $ @SYS$COMMON:[SYSMGR]VIDAO_DEINSTALL.COM 3.9 Enhancing Data Distributor Performance The performance of Data Distributor's copy process is to some degree affected by the parameters established for a user in the system authorization file. This correlation occurs because the copy process runs under the account of the user who defines a transfer. For good copy process performance, transfer definer accounts should use the same user account parameters that are recommended by Rdb/VMS. See the VAX Rdb/VMS Guide to Database Maintenance and Performance for more information on user account parameters. After Installing VAX Data Distributor 3-15 3.10 Rebooting the System Reboot the system after you have installed Data Distributor; initialized or converted the transfer database; installed re- lated products, such as, VIDA; and, edited the two command files SYSTARTUP_V5.COM and SYSHUTDWN.COM. A system reboot verifies that Data Distributor is available for use. If you suspended one or more data transfers before you shut down the system, you might want to restart them after you reboot the system. 3.11 VAX Data Distributor Command Procedures This section provides information about the command procedures that start and stop the transfer monitor: o SYS$STARTUP:DDAL$START_TR_MON.COM o SYS$MANAGER:DDAL$STOP_TR_MON.COM The following sections describe the changes you might have to make in these files. 3.11.1 DDAL$START_TR_MON.COM File The DDAL$START_TR_MON command procedure starts a transfer monitor. This procedure runs every time the system boots if you have added the line that invokes it to the SYSTARTUP_V5.COM file. If you run the procedure interactively, you must run it from an account that has either VMS SETPRV or all these individual VMS privileges: CMKRNL, DETACH, SYSLCK, SYSNAM, TMPMBX, and WORLD. The procedure installs SYS$SYSTEM:DDAL$COPY_PROCESS, a Data Distributor executable image, and the following Rdb/VMS images: o SYS$SHARE:RDBSHR.EXE o SYS$MESSAGE:RDMSMSG.EXE 3-16 After Installing VAX Data Distributor o SYS$MESSAGE:RDBMSGS.EXE Normally, the Rdb/VMS startup procedure, RMONSTART.COM, does not install these Rdb/VMS images. However, if you installed them as part of another layered product's startup procedure that is started prior to Data Distributor, you might want to modify the DDAL$START_TR_MON.COM file to avoid having them reinstalled. Consider also that DDAL$START_TR_MON.COM first removes and then reinstalls these images. Therefore, these files might not be installed with all the attributes required by other applica- tions. In this situation, you might want to modify the way Data Distributor's command file installs these images. 3.11.2 DDAL$STOP_TR_MON.COM File The DDAL$STOP_TR_MON command procedure stops a transfer monitor. This procedure runs every time the system shuts down if you have added the line that invokes it to the SYSHUTDWN.COM file. If you run the procedure interactively, you must run it from an account that has either VMS SETPRV or all these individual VMS privileges: CMKRNL, SYSNAM, SYSPRV, and WORLD. The procedure removes the SYS$SYSTEM:DDAL$COPY_PROCESS executable image. It does not remove the Rdb/VMS images discussed in the section on the DDAL$START_TR_MON.COM file. However, you might want to modify the DDAL$STOP_TR_MON.COM files to remove these images if you have no other applications that require these files to be installed. 3.12 Running the Installation Verification Procedure (IVP) When you install Data Distributor, the VMSINSTAL program asks if you want to run the automatic IVP at the end of the installation. You should answer YES to this question. To ensure that the IVP will end successfully, make sure that Rdb/VMS is running and Data Distributor is shut down before you start the IVP. After Installing VAX Data Distributor 3-17 The Data Distributor IVP checks that all critical files have been installed on your system in the correct locations. It also checks that all the Data Distributor components are functioning. No user interaction is required to run the IVP. You can run the automatic IVP any time after installation to con- firm that Data Distributor is running correctly. Running the IVP after installation requires you to run the IVP from a privileged account with a system UIC. The account must have either VMS SETPRV or all these individual VMS privileges: CMKRNL, DETACH, SYSLCK, SYSNAM, SYSPRV, TMPMBX, and WORLD. Use the following commands to invoke the IVP: $ SET DEFAULT SYS$TEST $ @DDAL$IVP When the IVP executes without any problems, you see a mes- sage indicating a successful completion. If the IVP fails, the procedure creates a log file that contains detailed in- formation about the cause of the failure. The log file name is SYS$UPDATE:DDAL$IVP.LOG. The Data Distributor IVP runs the DDAL$START_TR_MON.COM and DDAL$STOP_TR_MON.COM procedures to start up and shut down the transfer monitor, respectively. Therefore, the following three images are reinstalled by the IVP: o SYS$SHARE:RDBSHR.EXE o SYS$MESSAGE:RDMSMSG.EXE o SYS$MESSAGE:RDBMSGS.EXE Refer to Section 3.11 for more information about how these images are affected by running the command procedures, DDAL$START_TR_ MON.COM and DDAL$STOP_TR_MON.COM. The information about the effect of running these procedures is especially relevant when the IVP is run immediately after the Data Distributor installation, that is, before you modify the 3-18 After Installing VAX Data Distributor DDAL$START_TR_MON.COM or DDAL$STOP_TR_MON.COM procedures. 3.13 Determining and Reporting Problems If you encounter a problem while using Data Distributor, report it to Digital. Depending on the nature of the problem and the type of support you have, you can take one of the following actions: o Call Digital if your software contract or warranty agreement entitles you to telephone support. o Submit a Software Performance Report (SPR). o Fill out and submit a Reader's Comments form if the problem deals with Data Distributor documentation. Reader's Comments forms are at the back of each hardcopy manual. Use the form from the manual in which you found the error. Include the section and page number. Review the Software Product Description (SPD) and Warranty Addendum for an explanation of warranty. If you encounter a prob- lem during the warranty period, report the problem as indicated above or follow alternate instructions provided by Digital for reporting SPD nonconformance problems. After Installing VAX Data Distributor 3-19 Appendix A Sample Installation This appendix contains a sample installation of Data Distributor Version 2.2 installed under VMS Version 5.3. This sample was run on a system that had no previous version of Data Distributor installed. The sample installation assumes that DECnet has been shut down, that no users are logged on to your system, and that OPTIONS N is specified to print the release notes. The Installation Verification Procedure (IVP) runs at the end of the installation. $ @SYS$UPDATE:VMSINSTAL DDAL022 $111$MUA1: OPTIONS N VAX/VMS Software Product Installation Procedure V5.3-2 It is 14-AUG-1990 at 19:26. Enter a question mark (?) at any time for help. * Are you satisfied with the backup of your system disk [YES]? Please mount the first volume of the set on MTA0:. * Are you ready? yes %MOUNT-I-MOUNTED, DDAL mounted on _MTA0: (READ) The following products will be processed: DDAL V2.2 Beginning installation of DDAL V2.2 at 19:26 Sample Installation A-1 %VMSINSTAL-I-RESTORE, Restoring product save set A ... Release notes included with this kit are always copied to SYS$HELP. Additional Release Notes Options: 1. Display release notes 2. Print release notes 3. Both 1 and 2 4. None of the above * Select option [2]: 2 * Queue name [SYS$PRINT]: SYS$PRINT %VMSINSTAL-I-RELMOVED , The product's release notes have been successfully moved to SYS$HELP. Product: DATA-DISTRIBUTOR Producer: DEC Version: 2.2 Release Date: 1-JUL-1990 * Does this product have an authorization key registered and loaded? YES Installation procedures for VAX Data Distributor V2.2-0 Checking system requirements ... Checking user limits ... * Do you want to purge files replaced by this installation [YES]? YES * Do you want to run the IVP after the installation [YES]? YES To complete the installation on a standalone VAX 11/780 will take approximately: 10 minutes to install 10 minutes to run the IVP All required questions have been asked. You can terminate the installation procedure at this time. A-2 Sample Installation * Do you want to continue the installation [YES]? YES %VMSINSTAL-I-RESTORE, Restoring product save set B ... %VMSINSTAL-I-RESTORE, Restoring product save set C ... ************************************************************* SYSTEM MANAGER: The following command line MUST be added to the system startup command file SYS$MANAGER:SYSTARTUP_V5.COM for all nodes that will be running VAX Data Distributor: $ @SYS$STARTUP:DDAL$START_TR_MON tr-db-loc tm-log-loc The following command line should be added to the system shutdown command file SYS$MANAGER:SYSHUTDWN.COM for all nodes that will be running VAX Data Distributor: $ @SYS$MANAGER:DDAL$STOP_TR_MON The VAX Data Distributor Installation Verification Procedure (IVP) has been provided in SYS$COMMON:[SYSTEST]. It can be invoked at any later time by using the following commands: $ SET DEFAULT SYS$COMMON:[SYSTEST.DDAL] $ @SYS$COMMON:[SYSTEST]DDAL$IVP ************************************************************* %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... COPYRIGHT (c) 1987, 1988, 1989, 1990 BY DIGITIAL EQUIPMENT CORPORATION, MAYNARD, MA ************************************************************* The VAX Data Distributor IVP verifies that all critical files are in place and all its components are functional. ************************************************************* Executing IVP for: VAX Data Distributor V2.2-0 Sample Installation A-3 ************************************************************* Creating the Transfer Database... ************************************************************* ************************************************************* Starting the Transfer Monitor... ************************************************************* ************************************************************* Running VAX Data Distributor... ************************************************************* ************************************************************* VAX Data Distributor IVP completed successfully ************************************************************* IVP completed for: VAX Data Distributor V2.2-0 Installation of DDAL V2.2 completed at 19:41 VMSINSTAL procedure done at 19:41 $ log SYSTEM logged out at 14-AUG-1990 19:48:13.37 A-4 Sample Installation Appendix B Files Installed on Your System The Data Distributor installation procedure installs a number of files on your system. At the end of the Data Distributor instal- lation, the procedure creates a list of the files and stores the list in the following location: SYS$COMMON:[SYSMGR.VAXINFO$PRODUCTS]DDAL022_FILES.DAT Each file specification in the files list has a flag attached to it. The flags are meant for future use by Digital. Digital does not support any use of these flags for this release. Files Installed on Your System B-1