____________________________________________________ DIGITAL DSNlink Version 2.2C for OpenVMS Installation Guide February 26, 1999 This document describes the installation of DSNlink Version 2.2C, an engineering change order (ECO) kit. Installing the DSNlink Version 2.2 for OpenVMS software is a prerequisite. Revision/Update Information: This is a revised document. Operating System and Version: OpenVMS VAX Version 6.2 or higher Software Version: DSNlink Version 2.2C for OpenVMS ________________________________________________________________ © Digital Equipment Corporation 1999. All Rights Reserved. The information in this document is subject to change without notice and should not be construed as a commitment by Digital Equipment Corporation. Digital Equipment Corporation assumes no responsibility for any errors that may appear in this document. Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013. The following are trademarks of Digital Equipment Corporation: Bookreader, DEC, DECnet, DECserver, DECstation, DECsystem, DECwindows, Digital, OpenVMS, ULTRIX, UNIBUS, VAX, VAX DOCUMENT, VAXft, VAXstation, VMS, VMScluster, and the DIGITAL logo. The following are third-party trademarks: 3Com and U.S. Robotics are registered trademarks of 3Com Corporation or its subsidiaries. Hayes is a trademark of Hayes Microcomputer Products, Inc. MNP is a registered trademark of Microcom, Inc. Motif is a registered trademark of Open Software Foundation, Inc. MultiModem and Multi-Tech are trademarks of Multi-Tech Systems, Inc. NCSA Mosaic is a trademark of the University of Illinois. MultiNet is a registered trademark of Cisco Systems, Inc. Netscape is a trademark of Netscape Communications Corporation. OPTIMA is a trademark of Hayes Microcomputer Products, Inc. OSF, OSF/1, OSF/Motif, and Motif are registered trademarks of the Open Software Foundation, Inc. PostScript is a registered trademark of Adobe Systems Inc. Practical Peripherals is a registered trademark of Practical Peripherals, Inc. UNIX is a registered trademark in the United States and other countries, licensed exclusively through X/Open Company, Ltd. Windows 95 and Windows NT are registered trademarks of Microsoft Corporation. All other trademarks and registered trademarks are the property of their respective holders. The MD5 software contained in this product is derived from the RSA Data Security, Inc. MD5 Message-Digest Algorithm. This document was prepared using VAX DOCUMENT, Version 2.1. _________________________________________________________________ Contents Preface................................................... v 1 Preparing to Install DSNlink 1.1 Preinstallation Checklist........................ 1-1 1.2 A Correction to the DSNlink Version 2.2 Installation Guide............................... 1-3 1.3 Kit Contents..................................... 1-4 2 A Sample DSNlink Version 2.2C for OpenVMS Installation 2.1 A Sample Installation............................ 2-1 2.2 Postinstallation Tasks........................... 2-5 Examples 2-1 Sample DSNlink Version 2.2C Installation ...... 2-1 Tables 1-1 DSNlink Version 2.2C Kit Sizes ............... 1-2 1-2 Required System Parameters .................... 1-3 Digital Internal Use Only iii _________________________________________________________________ Preface The Purpose of the Kit DSNlink Version 2.2C contains bug fixes and some new features for DSNlink Version 2.2. For more information, see the DSNlink Version 2.2C Release Notes. Audience This guide is intended for the system manager who installs DSNlink software. Where to Get DSNlink Kits DSNlink Version 2.2 for OpenVMS is a prerequisite to DSNlink Version 2.2C. If you have not installed DSNlink Version 2.2, you can get it from the following locations: o The DSNlink website: http://www.support.compaq.com/dsnlink/ Click on Download Kits. o This anonymous FTP directory: ftp.support.compaq.com Set default to the directory that contains the kit you want to install. For example: ftp> cd /public/DSNlink/ovms-alpha/ Or: ftp> /public/DSNlink/ovms-vax/ The directory and file names are case-sensitive. Be sure to type them as shown above. The Readme files with each kit explain how to proceed. v 1 _________________________________________________________________ Preparing to Install DSNlink This section describes the preinstallation requirements for DSNlink Version 2.2C. 1.1 Preinstallation Checklist Use the following checklist <> to ensure that your system has the prerequisites for installing DSNlink Version 2.2C for OpenVMS: < Install DSNlink Version 2.2 for OpenVMS and perform the postinstallation tasks. For the location of the documentation and software, see the Preface. To see if DSNlink is installed, use this command: $ DSN SHOW VERSION If DSNlink Version 1.2 for OpenVMS is installed, the command is not recognized. < Rename any modem scripts you want to continue using. The DSNlink Version 2.2C installation procedure overwrites your current modem scripts with new scripts if the script names are identical. If you use a modem and want to continue using its dialer script, rename the script to keep. For example: $ SET DEFAULT DSN$DATA $ RENAME CO2264.DDSF_SRC CO2264_KEEP.DDSF_SRC After the installation, rename the script back to its original name. For more information about modem scripts, see the DSNlink Version 2.2C for OpenVMS Release Notes. Preparing to Install DSNlink 1-1 Preparing to Install DSNlink 1.1 Preinstallation Checklist < Make sure you have enough disk space. The following are the kit sizes for the Alpha and VAX kits after the installation: Table_1-1_DSNlink_Version_2.2C_Kit_Sizes___________________ Platform__Size_in_Blocks___________________________________ Alpha 9,900 VAX_______10,000___________________________________________ The combined kit, which you download, is approximately 18,500 blocks. The installation procedure deletes the unneeded files. For example, if you install DSNlink on an Alpha system, DSNlink deletes the files for VAX systems. < Verify that the account from which you will install DSNlink has SETPRV or at least the following privileges: CMKRNL DETACH NETMBX SYSPRV SYSNAM SYSLCK TMPMBX WORLD < Make sure there are no running DSNlink Version 2.2 for OpenVMS modem daemons. The installation procedure checks for running modem daemons. If any are found, a prompt asks if you want to have the installation procedure stop them. Answering Y or Yes interrupts the processes and daemons, which could annoy users. Answering N or No causes the installation procedure to exit. Note that users can continue to use DSNlink on other non-modem transports, such as TCP/IP, during the installation. < Make sure the Queue Manager is running. < Verify that the queue SYS$BATCH exists. 1-2 Preparing to Install DSNlink Preparing to Install DSNlink 1.1 Preinstallation Checklist < Back up your system disk. 1.2 A Correction to the DSNlink Version 2.2 Installation Guide The DSNlink Version 2.2 for OpenVMS Installation Guide has incorrect minimum values for the MAXBUF parameter. The value was listed as 1200 for both Alpha and VAX. It should be 8192 for both systems. Table 1-2 lists the minimum required SYSGEN values for installing and running DSNlink Versions 2.2 and 2.2C. Table_1-2_Required_System_Parameters_______________________ SYSGEN_Parameter______Minimum_Value________________________ SCSNODE Must be defined SCSSYSTEMID Must be defined MAXBUF Alpha: 8192 VAX: 8192 TTY_ALTYPAHD[1] Alpha: 2048 VAX: 2048 GBLPAGES Alpha: 6623 VAX: 6754 GBLSECTIONS Alpha: 21 VAX: 33 [1]TTY_ALTYPAHD_is_checked_only_if_you_choose_the_modem____ transport. ___________________________________________________________ Also, the Installation Guide states that if you enter more than one access number when installing DSNlink Version 2.2, only the first access number is tested during the installation verification procedure (IVP). That is incorrect. DSNlink tests all access numbers you enter during the installation procedure. If any access number fails, the Network Exerciser messages notify you. Preparing to Install DSNlink 1-3 Preparing to Install DSNlink 1.3 Kit Contents 1.3 Kit Contents The DSNlink Version 2.2C kit contains the following items: o DSNLINKC022.A - the save set for both Alpha and VAX systems o The release notes: DSNLINK022C_RELEASE_NOTES.TXT - the text version DSNLINK022C_RELEASE_NOTES.PS - the PostScript version o The installation guide (this document): DSNLINK022C_INSTALL_GUIDE.TXT - the text version DSNLINK022C_INSTALL_GUIDE.PS - the PostScript version 1-4 Preparing to Install DSNlink 2 _________________________________________________________________ A Sample DSNlink Version 2.2C for OpenVMS Installation Before you start a DSNlink Version 2.2C installation, verify that your system meets the prerequisites listed in Section 1.1. 2.1 A Sample Installation Example 2-1 shows a sample DSNlink Version 2.2C installation on an Alpha system. The DSNlink kit was previously copied to the SYS$UPDATE directory. Example 2-1 Sample DSNlink Version 2.2C Installation $ SET DEFAULT SYS$UPDATE $ @VMSINSTAL DSNLINKC022 ddcu:[dir]1 OpenVMS AXP Software Product Installation Procedure V6.2 It is 1-FEB-1999 at 12:12. Enter a question mark (?) at any time for help. %VMSINSTAL-W-NOTSYSTEM, You are not logged in to the SYSTEM account. %VMSINSTAL-W-ACTIVE, The following processes are still active: DECW$SERVER_0 DECW$MWM DECW$Clock DECW$TE_005C DECW$TE_005F DECW$TE_0064 DECW$TE_006D line-000 * Do you want to continue anyway [NO]? Y * Are you satisfied with the backup of your system disk [YES]? Y (continued on next page) Digital Internal Use Only A Sample DSNlink Version 2.2C for OpenVMS Installation 2-1 A Sample DSNlink Version 2.2C for OpenVMS Installation 2.1 A Sample Installation Example 2-1 (Cont.) Sample DSNlink Version 2.2C Installation The following products will be processed: DSNLINKC V2.2 Beginning installation of DSNLINKC V2.2 at 12:12 %VMSINSTAL-I-RESTORE, Restoring product save set A ... * Do you wish to continue the installation [NO]? Y %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP. ******************************************************************************** © Digital Equipment Corporation, 1989-1999. All Rights Reserved. This software has been installed and enabled to enhance the maintenance services provided by DIGITAL. Use of this software by anyone other than DIGITAL maintenance personnel is not permitted without a license. Customers who have signed a DIGITAL Service Agreement ("Agreement") have been granted such a license for their own use on equipment covered by the Agreement. Any other use, copying or license to any other party whatsoever is not permitted. DIGITAL reserves the right to remove or disable this software at its discretion. Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c) (1) (ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III, as applicable. Motif is a registered trademark of the Open Software Foundation, Inc. The MD5 software contained in this product is derived from the RSA Data Security, Inc. MD5 Message-Digest Algorithm. This product includes software developed by the University of California, Berkeley and its contributors: Copyright (c) 1983, 1986, 1987, 1988, 1993 The Regents of the University of California. All rights reserved. ******************************************************************************** (continued on next page) Digital Internal Use Only 2-2 A Sample DSNlink Version 2.2C for OpenVMS Installation A Sample DSNlink Version 2.2C for OpenVMS Installation 2.1 A Sample Installation Example 2-1 (Cont.) Sample DSNlink Version 2.2C Installation Note: You can enter a question mark (?) when prompted for input and a detailed explanation will be displayed about what information is needed. %DSNLINKC-I-PREINSTALL, Checking for required privileges %DSNLINKC-I-PREINSTALL, Checking for minimum version of OpenVMS %DSNLINKC-I-PREINSTALL, Checking for minimum version of DSNlink %DSNLINKC-I-PREINSTALL, Checking for existing DSNlink directory tree %DSNLINKC-I-PREINSTALL, Checking for sufficient free blocks on system disk %DSNLINKC-I-PREINSTALL, Checking for executing Queue Manager %DSNLINKC-I-PREINSTALL, Checking for SYS$BATCH batch queue %DSNLINKC-I-PREINSTALL, Checking for running DSNlink modem processes DSNlink modem processes are currently running on this system. In order to continue with this installation, they must be shut down, which will terminate all existing modem links. If you decide to proceed, this installation procedure will shut down the DSNlink modem processes. * Do you want to continue with the installation of DSNlink? [NO]? Y 2 %DSNLINKC-I-PREINSTALL, Starting shutdown of DSNlink... Job DSN$SHUTDOWN (queue SYS$BATCH, entry 4) started on SYS$BATCH %DSNLINKC-I-PREINSTALL, Shutdown of DSNlink completed * Do you want to purge files replaced by this installation [YES]? Y 3 All installation questions have been answered. The rest of the installation will proceed automatically and may take up to 10 minutes, depending on your system type. %DSNLINKC-I-PRODAT, Providing files to DSN$DATA... %DSNLINKC-I-PROLIB, Providing images to DSN$LIBRARY... %DSNLINKC-I-PROEXE, Providing images to DSN$SYSTEM... (continued on next page) Digital Internal Use Only A Sample DSNlink Version 2.2C for OpenVMS Installation 2-3 A Sample DSNlink Version 2.2C for OpenVMS Installation 2.1 A Sample Installation Example 2-1 (Cont.) Sample DSNlink Version 2.2C Installation %DSNLINKC-I-PROUTL, Providing image to DSN$UTILITIES... %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... DSN-I-SECURE, Setting the owner and protection on the DSNlink directories DSN-I-SECURE, Setting the owner and protection on the DSNlink system files DSN-I-SECURE, Setting the owner and protection on all DSNlink files DSN-I-SECURE, Setting the owner and protection on specific DSNlink files DSN-I-SECURE, Owner and protection successfully set on all DSNlink files %DSNLINKC-I-POSTINSTALL, Recreating the DSNlink Route Map... %DSNLINKC-I-POSTINSTALL, Submitting DSN$STARTUP.COM to SYS$BATCH... Job DSN$STARTUP (queue SYS$BATCH, entry 5) started on SYS$BATCH Installation of DSNLINKC V2.2 completed at 12:13 Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY Creating installation data file: VMI$ROOT:[SYSUPD]DSNLINKC022.VMI_DATA VMSINSTAL procedure done at 12:14 $ The following refer to items in the previous sample installation: 1 Replace ddcu:[dir] with the file specification of the kit on your system. 2 This prompt appears only if there are running DSNlink modem process on your system. If you enter Yes or Y at the prompt to continue, the installation procedure stops the processes, which interrupts the DSNlink applications and may annoy the users. If you enter No or N, the installation stops. Digital Internal Use Only 2-4 A Sample DSNlink Version 2.2C for OpenVMS Installation A Sample DSNlink Version 2.2C for OpenVMS Installation 2.1 A Sample Installation 3 If you choose to purge the files replaced by the installation, DSNlink removes only the files for which there are new files in the kit. For a list, see the New Files and Images section in the DSNlink Version 2.2C for OpenVMS Release Notes. 2.2 Postinstallation Tasks The postinstallation tasks are as follows: o Be sure you have performed all the postinstallation procedures for DSNlink Version 2.2 for OpenVMS. o If you renamed a modem script to prevent it from being overwritten by the new modem script, rename it back to the original name. The DSNlink Version 2.2C installation is complete. Digital Internal Use Only A Sample DSNlink Version 2.2C for OpenVMS Installation 2-5