________________________ Second Edition, 29 October 1990 __________ 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. The software described in this document is furnished under a license and may be used or copied only in accordance with the terms of such license. No responsibility is assumed for the use or reliability of software on equipment that is not supplied by Digital Equipment Corporation or its affiliated companies. 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. __________ Copyright ©1990 by Digital Equipment France All Rights Reserved. __________ The following are trademarks of Digital Equipment Corporation: DEC DIBOL UNIBUS DEC/CMS EduSystem VAX DEC/MMS IAS VAXcluster DECnet MASSBUS VMS DECsystem-10 PDP VT DECSYSTEM-20 PDT DECUS RSTS DECwriter RSX DIGITAL This document was prepared using VAX DOCUMENT, Version 1.1 Preface ________________________________________________________________ __________________________________________________________ Intended Audience This manual provides information for system managers and DIGITAL software specialists. The manual assumes that readers understand and also have some experience of: o Installation of software products on VAX/VMS o Wide Area Networks (WANs) o DECnet-VAX o DIGITAL's VAX ISDN product. __________________________________________________________ Purpose of this Document This manual explains how to install VAX ISDN and VAX ISDN ACCESS. Information about how to configure and start up the VAX ISDN Software is contained in the VAX ISDN Software Management Guide. vii __________________________________________________________ Associated Documentation __________________________________________________________ Terminology Throughout this document, the following terminology has been used: _____________________________________________________________ Term__________________Meaning________________________________ VAX ISDN Software The VAX ISDN Software in general, i.e. both VAX ISDN and VAX ISDN ACCESS VAX ISDN The full-function variety of the VAX ISDN Software VAX ISDN ACCESS The reduced-function variety of the VAX ______________________ISDN_Software-see_Section_1.1.1________ viii Chapter 1 Introduction ________________________________________________________________ This chapter provides an introduction to the software and its installation procedure. __________________________________________________________ 1.1 VAX ISDN Software Overview __________________________________________________________ 1.1.1 Product Variants There are two variants of the VAX ISDN product: o the full-function product "VAX ISDN" o an access-only variant, which is called "VAX ISDN ACCESS". VAX ISDN ACCESS allows users to access the VAX ISDN Call Control on remote nodes which are connected to an ISDN and which have VAX ISDN installed and running. VAX ISDN ACCESS uses a DECnet logical link to connect to the node to be con- trolled remotely. VAX ISDN ACCESS uses the link to transmit ISDN Call Control messages between the remote node and the local VAX user. VAX ISDN ACCESS only provides an interface to the VAX ISDN Call Control, and does not include the VAX ISDN Call Control software itself. It is meant to be used only on nodes that are not directly connected to the ISDN network. Introduction 1-1 __________________________________________________________ 1.1.2 Network Profiles Network profiles each contain a description of the character- istics of a particular ISDN network. The contents of the various Network Profiles for public ISDNs appear in the Public ISDN Network Information manual. NOTE You must use the correct Network Profile for your local ISDN network. Use of an incorrect Network Profile invalidates DIGITAL's support of the VAX ISDN Software. __________________________________________________________ 1.2 Installation Overview This software is installed by use of the VMSINSTAL utility. The procedure can be carried out by the customer himself at his own site. Whatever variant is used, the VAX ISDN software will re- quire DECnet-VAX to operate. The appropriate DECnet license, however, is not required for the operation of VAX ISDN on a single DECnet node. __________________________________________________________ 1.3 What Happens During Installation This section introduces the procedures you use when in- stalling VAX ISDN and VAX ISDN ACCESS. The procedures for installing VAX ISDN and VAX ISDN ACCESS are automated as far as possible. Throughout an installation, the procedures prompt you with questions that require a simple answer such as Yes or No. In many cases defaults have been set up. These are indicated in square brackets. To accept the default, simply press the key. 1-2 Introduction NOTE If you do not understand a prompt or are uncertain about the the information required at any point during the installation, enter a question mark (?) in answer to the prompt. You will be provided with on-line help about that prompt and about the information you should enter. Installation involves the following steps: 1. Executing VMSINSTAL.COM to copy the VAX ISDN Software files from the distribution kit to the system disk. 2. Executing the IVP (this can be done automatically as part of the installation procedure). 3. Adding the VAX ISDN Software startup file, ISDN$STARTUP.COM, to the SYSMAN startup database (for VAX ISDN only). 4. If necessary, updating the SYSGEN system parameters database. Note that if the VAX ISDN Software had pre- viously been installed on the system, the system parameter values may already be correct. 5. Rebooting the system (not necessary if installing VAX ISDN ACCESS and if no system parameters are changed). Introduction 1-3 Chapter 2 Preparing for Installation ________________________________________________________________ __________________________________________________________ 2.1 Distribution Kits The software is supplied in two kits: o the ISDN V1.1 kit, which supplies the software for config- uring a full-function VAX ISDN system o the ISDN ACCESS V1.1 kit, which supplies the software for configuring a VAX ISDN ACCESS system. The software is distributed on the following media: Table_2-1:_Media_for_Installation_of_VAX_ISDN________________ Medium________________Quantity_________Volume_Label__________ TK50 cassette 1 ISDN 1600 BPI magnetic 1 x 2400 feet ISDN tape CDROM (part of VMS CD) _____________________________________________________________ Preparing for Installation 2-1 Table_2-2:_Media_for_Installation_of_VAX_ISDN_ACCESS_________ Medium________________Quantity_________Volume_Label__________ TK50 cassette 1 ISDN-A 1600 BPI magnetic 1 x 2400 feet ISDN-A tape RX23 floppy disk 1 ISDN-A CDROM (part of VMS CD) _____________________________________________________________ The contents of the various kits are listed in Appendix C. __________________________________________________________ 2.2 Hardware Requirements The hardware requirements for the VAX ISDN Software are listed as part of the System Support Addendum for this product. Please refer to this document to verify that these requirements are met. NOTE The VAX ISDN Software currently only supports the DEC ISDNcontroller 100 ("DIV32" device) as interface to an ISDN network. The installation of the VAX ISDN software should therefore be performed on a VAX sys- tem that is equipped with a Q-Bus. No error will be reported, however, if this is not the case. 2-2 Preparing for Installation __________________________________________________________ 2.2.1 Checking the Disk Space Before you install the VAX ISDN products, check that the system disk has enough free space by entering the following command: $ SHOW DEVICE SYS$SYSDEVICE The information displayed includes the number of free blocks on the disk. Consult Table 2-3 in order to make sure that there is enough space to install your system. (If you try to install either of the VAX ISDN products with too few free blocks, the installation procedure will of course fail.) Table_2-3:_Disk_Space_Requirements___________________________ For Product Peak Requirement During _________________Itself______Installation____________________ VAX ISDN 1750 2200 blocks blocks VAX ISDN ACCESS 1020 1250 blocks blocks _____________________________________________________________ __________________________________________________________ 2.3 Software Requirements The only required software for the installation procedure itself is VMS. Please refer to the System Support Addendum document to see which VMS version(s) are supported. Preparing for Installation 2-3 __________________________________________________________ 2.4 Information Required for Installation Table 2-4 or Table 2-5 show the information which will be required during the installation. Table_2-4:_Installation_Information-VAX_ISDN_________________ Item_____________Value_______________________________________ Kit name ISDN LMF product ISDN name Load device VMS device name of the device which reads name the kit media, for example DUA1:. Network Profile One of the following: Identifier ATT AUST BRITISH FRENCH GERMAN JAPAN NORTHERN _____________________________________________________________ Table_2-5:_Installation_Information-VAX_ISDN_ACCESS__________ Item_____________Value_______________________________________ Kit name ISDN-ACCESS LMF product ISDN-ACCESS name Load device VMS device name of the device which reads name the kit media, for example DUA1:. _____________________________________________________________ 2-4 Preparing for Installation If you do not know the answers to any of these questions, obtain the missing values from your system manager, net- work administrator, or DIGITAL software specialist, before attempting the installation. __________________________________________________________ 2.5 Installing VAX ISDN on a Cluster In the case of a VAXcluster, VAX ISDN must be installed on each node that is going to run the software. One way to achieve this is to install VAX ISDN on any systems that are connected to the ISDN, and VAX ISDN ACCESS on the other VAX systems in the cluster. NOTE Before you install VAX ISDN or VAX ISDN ACCESS on any system in the cluster, you MUST ensure that VAX ISDN or VAX ISDN ACCESS are not running on any of the other VAXcluster systems during the installation, as described in Section 2.5.1. When you have finished installing the software on all the relevant nodes, you can start the VAX ISDN Software. Refer to Appendix C for details of which files are installed in the system-specific root area and which are installed in the common root area. __________________________________________________________ 2.5.1 How to Check if the VAX ISDN Software is Running The easiest way to check all the nodes on a cluster to see if VAX ISDN or VAX ISDN ACCESS is running, is to use the SYSMAN utility to issue an ISDN$NCP command on each node. If the message Preparing for Installation 2-5 %ISDN-W-NOTSTARTED is returned from every node (or ISDN$NCP does not exist on the node), then it is safe to start the installation. For example: $ run sys$system:sysman SYSMAN> set environment /cluster %SYSMAN-I-ENV, current command environment: Clusterwide on local cluster Username SYSTEM will be used on nonlocal nodes SYSMAN> do mcr isdn$ncp show line 0 The returned messages from each node will be in one of the following categories: 1. The message: %SYSMAN-I-OUTPUT, command execution on node JULIE followed by a normal display or error message from ISDN$NCP, in which case the node is running the VAX ISDN software. In such a case, the VAX ISDN software must be shut down before re-installing it. 2. The message: %SYSMAN-I-OUTPUT, command execution on node JEAN %ISDN-W-NOTSTARTED, VAX ISDN software not loaded which means that the VAX ISDN software is installed but not started, so it is safe to re-install. 3. The message: %SYSMAN-I-OUTPUT, command execution on node NICK %SYSTEM-F-NOSUCHOBJ, network object is unknown at remote node which means that the VAX ISDN has never been installed, so it is safe to install. 2-6 Preparing for Installation __________________________________________________________ 2.6 VAX ISDN and the License Management Facility (LMF) VAX ISDN and VAX ISDN ACCESS are known by the VMS License Management Facility (LMF) as ISDN and ISDN-ACCESS respec- tively. LMF has two classes of license, Availability and Capacity licenses. VAX ISDN and VAX ISDN ACCESS only support Availability licensing. Before VAX ISDN or VAX ISDN ACCESS can be run on a system, you must license the system by running the LICENSE utility. To license your system, you enter the information given on the Product Authorization Key (PAK), as described in Section 2.6.1 below. The PAK contains all the information you need to enter during license registration. You are recommended to license ISDN or ISDN-ACCESS before you run the corresponding Installation Verification Procedure. If you do not do this, either of the following messages will be displayed, depending on the product: Figure 2-1: "No license" Error Messages _____________________________________________________________ %ISDN-W-NOAUTH, DEC ISDN use is not authorized on this node %ISDN-W-NOAUTH, DEC ISDN-ACCESS use is not authorized on this node _____________________________________________________________ Preparing for Installation 2-7 __________________________________________________________ 2.6.1 Entering the PAK To activate the license registration procedure, enter the following command: $ @SYS$UPDATE:VMSLICENSE You will then be prompted for the details contained in the ISDN or ISDN-ACCESS PAK. Each question corresponds to a heading in the PAK. If you are installing on a cluster, you only need to perform this procedure on one node. Then enter the following command on each of the other nodes in the cluster that will be using the same ISDN license: $ LICENSE LOAD ISDN If you are licensing VAX ISDN ACCESS, enter the following command: $ LICENSE LOAD ISDN-ACCESS You can then install VAX ISDN or VAX ISDN ACCESS on the other nodes in the cluster as required. Refer to the VMS documentation set for further details on using the VMSLICENSE procedure and the LICENSE utility. __________________________________________________________ 2.6.2 Using VAX ISDN or VAX ISDN ACCESS If you have not licensed VAX ISDN or VAX ISDN ACCESS, and you try to start up VAX ISDN or to access the VAX ISDN Call Control (using either ISDN$NCP or ISDN$SA), then your re- quest will fail, and one of the LMF error messages shown in Figure 2-1 will be returned. In such cases you should install 2-8 Preparing for Installation the license as detailed in Section 2.6.1 above and then start the product. At any time, you can check that either license has been registered, enabled and loaded by issuing the following commands: $ LICENSE LIST to see if the license is in the license database (which is cluster-wide), and $ SHOW LICENSE to see if the license has been correctly loaded onto the local node. Preparing for Installation 2-9 Chapter 3 Installing VAX ISDN ________________________________________________________________ This chapter guides the reader through the procedure for installing VAX ISDN. If you are installing VAX ISDN ACCESS, refer instead to Chapter 4. __________________________________________________________ 3.1 Installing VAX ISDN Files from the Distribution Volume To install the VAX ISDN Software from the distribution vol- ume, you should carry out the following procedure at the system console. 1 Log in to the SYSTEM account. 2 Check that the disk has enough free space for VAX ISDN. Refer to Table 2-3 for details of how much free space you need on your system disk. 3 To start the installation procedure, enter the following command: $ @SYS$UPDATE:VMSINSTAL The procedure displays: VAX/VMS Software Product Installation Procedure (VMS_VER) It is date at time. Enter a question mark (?) at any time for help. Installing VAX ISDN 3-1 If DECnet is currently running on your system, the proce- dure warns you with the following message: %VMSINSTAL-W-DECNET, Your DECnet network is up and running. * Do you want to continue anyway [NO]? As you do not have to shut DECnet down in order to install VAX ISDN, you may answer YES to this question. 4 The procedure continues with: * Are you satisfied with the backup of your system disk [YES]? Make sure you have a good backup copy of the disk, as the installation will write to the system disk. If your system disk has not been backed up or you wish to make a fresh copy, answer NO; the procedure would then exit without installing the software. When you have backed up your system disk, you can start the installation procedure again. If you answer YES, the procedure continues. 5 Next it asks the following question: * Where will the distribution volumes be mounted: Enter the name of the device on which the volume contain- ing the VAX ISDN Software will be mounted. ddcu: is the device name, where dd is the device code, c is the con- troller letter, and u is the unit number. For example, MUA0:. 6 Next the procedure displays: Enter the products to be processed from the first distribution volume set. * Products: 3-2 Installing VAX ISDN 7 Enter: ISDN and (as normal) press . 8 The procedure responds with: * Enter installation options you wish to use (none): Enter n. This will request the display and/or printing of the Release Notes. If you specified a device which is not already mounted in step 5, then the installation procedure will continue as follows, otherwise it will proceed with step number 10 Please mount the first volume of the set on device * Are you ready? 9 Load the distribution volume (labelled ISDN) into the corresponding drive. Answer YES when you have done so. The procedure will then mount the volume on the device, and display a message such as this: %MOUNT-I-MOUNTED, ISDN mounted on _MUA0: 10 VMSINSTAL proceeds with: The following products will be processed: ISDN V1.1 Beginning installation of ISDN V1.1 at time Release notes included with this kit are always copied to SYS$HELP. Additional Release Notes Options: Installing VAX ISDN 3-3 1. Display release notes 2. Print release notes 3. Both 1 and 2 4. None of the above * Select option [2]: You should print or display the Release Notes and read them before continuing. 11 VMSINSTAL continues with: %VMSINSTAL-I-RESTORE, Restoring product saveset A ... %VMSINSTAL-I-RELMOVED , The product's release notes have been successfully moved to SYS$HELP. +---------------------------------------------------+ | VAX ISDN Software Installation Procedure. | +---------------------------------------------------+ Product: ISDN Producer: DEC Version: V1.1 Release Date: 30-NOV-1990 * Does this product have an authorization key registered and loaded? 12 Now answer either Y or N, depending on whether or not you have loaded the appropriate license, as described in Section 2.6. If you have answered Y and the license is not active, then the following warning is displayed: %ISDN-W-NOAUTH, DEC ISDN use is not authorized on this node If the license has not been loaded, the installation procedure will continue, but the Installation Verification Procedure will not be activated. The following message is then displayed: 3-4 Installing VAX ISDN %ISDN-W-NOIVP, the Installation Verification Procedure will not be executed You should execute the IVP after loading the appropriate license, as described in Section 2.6. 13 If, on the other hand, the license is active, the proce- dure continues with: * Do you want to run the IVP [YES]? Now press if you want to the Installation Verification Procedure to be run automatically at the end of the installation. 14 The procedure continues with: * Do you want to purge files replaced by this installation [YES]? 15 Now press if you want to purge files resulting from a previous installation. Note that if you are going to use the VAX ISDN Software on several nodes in a cluster, and are installing VAX ISDN or VAX ISDN-ACCESS on these nodes, the files installed in the SYS$COMMON area of the system disk are identical and should be purged. 16 Next the procedure asks you to specify the network identi- fier: VAX ISDN Software V1.1 contains network-specific code. In order to install the software correctly, you must identify which network you will be using by entering one of the following network identifier strings: Installing VAX ISDN 3-5 ATT AUST BRITISH FRENCH GERMAN JAPAN NORTHERN * Enter network identifier string: 17 Identify your local implementation of ISDN. The procedure responds with: Your country specific network profile has been configured. Installation continues... No More Questions. There may be a time delay of several minutes at this stage in the procedure. As you have now answered all the questions required for the installation, there is no need to watch the output, which will be like this: %VMSINSTAL-I-RESTORE, Restoring product saveset B ... %VMSINSTAL-I-RESTORE, Restoring product saveset C ... %VMSINSTAL-I-RESTORE, Restoring product saveset D ... 18 If you had previously installed VAX ISDN (or another communication product that makes use of NETTRACE) on your system, a series of messages may be displayed. These messages tell you that some existing files will not be updated. This is done to preserve user modifications to these files. 3-6 Installing VAX ISDN These are the messages you may see: %ISDN-I-FILEXISTS, VMI$ROOT:[SYSMGR]NETTRACE_SECURITY.COM already exists on system %ISDN-I-FILNOTINST, VMI$ROOT:[SYSMGR]NETTRACE_SECURITY.COM not installed %ISDN-I-FILEXISTS, VMI$ROOT:[SYSLIB]NETTRACE$KEY.INIT already exists on system %ISDN-I-FILNOTINST, VMI$ROOT:[SYSLIB]NETTRACE$KEY.INIT not installed %ISDN-I-FILEXISTS, VMI$ROOT:[SYSMGR]ISDN$SECURITY.COM already exists on system %ISDN-I-FILNOTINST, VMI$ROOT:[SYSMGR]ISDN$SECURITY.COM not installed %ISDN-I-FILEXISTS, VMI$ROOT:[SYSMGR]ISDN$STARTUP_SITE.COM already exists on system %ISDN-I-FILNOTINST, VMI$ROOT:[SYSMGR]ISDN$STARTUP_SITE.COM not installed 19 The procedure checks the system parameter MAXBUF. If it is less than 2048 bytes, the procedure issues the following warning: %ISDN-W-MAXBUFTOOSMALL, MAXBUF is too small, change from n to 2048. where n is the current value of the MAXBUF parameter. Change the value of the MAXBUF system parameter after you have installed VAX ISDN. See Section 3.2.3 for a description of how to do this. 20 Next the system will display a list of "things to do". More details on these are given in Section 3.2. Take heed of the advice given, the next time you see the DCL prompt. Installing VAX ISDN 3-7 Here is the corresponding display: * * * * * * * * * * * * * * * * * * * * * * * * * * * Upon completion of this installation, please follow the instructions below:- - using the following command, add the VAX ISDN product to the database of components to be automatically started when the system is booted:- $ RUN SYS$SYSTEM:SYSMAN SYSMAN> startup add file ISDN$STARTUP.COM [/node=(A,B,C)] - REBOOT the system * * * * * * * * * * * * * * * * * * * * * * * * * * * 21 When the last saveset has been copied, the proce- dure copies the distribution files from a subdirectory of SYS$UPDATE to their respective directories. (See Appendix C for details of which files are installed into which directories.) The following message is displayed then: %VMSINSTAL-I-MOVEFILES, files will now be moved to their target directories... 22 Now, if the license check at step 12 was successful and if you answered "YES" at step 13, the IVP will be run: ***************************************************** * * * ISDN V1.1 Installation Verification Procedure * * * ***************************************************** %ISDN-W-NOTSTARTED, VAX ISDN software not loaded %ISDN-I-IVPSUCCESS, ISDN V1.1 IVP was successful 3-8 Installing VAX ISDN The %ISDN-W-NOTSTARTED message is not necessarily dis- played; if it is displayed, ignore it. Installation of ISDN V1.1 completed at time Enter the products to be processed from the next distribution volume set. * Products: 23 You can now leave the VMSINSTAL procedure by pressing . You will then be returned to the DCL prompt: * Products: VMSINSTAL procedure done at time. $ You may then remove the distribution medium from the device. See Section 3.2 for what to do next. __________________________________________________________ 3.1.1 Installation Failures __________________________________________________________ 3.1.1.1 Incorrect Version of Operating System During the installation, the procedure checks that the ver- sion number of the operating system (VMS) is correct. If it is incorrect, the procedure exits after displaying the following message: This product requires VMS version V5.2-1 or later to install %VMSINSTAL-E-INSFAIL, The installation of ISDN V1.1 has failed Note that the correct version(s) are shown in the System Support Addendum. Installing VAX ISDN 3-9 __________________________________________________________ 3.1.1.2 Insufficient Disk Space During the installation, the procedure checks that there is sufficient space on your disk for the VAX ISDN files. Refer to Table 2-3 for details of how many free blocks you need on your system to install VAX ISDN. If there is not enough space, the procedure exits after displaying the following messages: %ISDN-E-NOSPACE, this installation requires nnnn blocks of disk space. %VMSINSTAL-E-INSFAIL, The installation of VAX ISDN V1.1 has failed. Make sure your system has sufficient free blocks before try- ing to install VAX ISDN again, by going through the procedure described in Section 2.2.1. __________________________________________________________ 3.1.1.3 Insufficient Global Pages If you receive the following message during installation: %INSTALL-E-FAIL, failed to REPLACE entry for DISK$VAXVMSRL052:DCLTABLES.EXE -SYSTEM-F-GPTFULL, global page table is full %INSTALL-W-DELETED, previous Known File Entry has been deleted then it will be necessary to increase the value of the sys- tem parameter GBLPAGES by 354. To do this, edit the file SYS$SYSTEM:MODPARAMS.DAT and add the line: ADD_GBLPAGES=354 Then issue the following command sequence: $ @SYS$UPDATE:AUTOGEN SAVPARAMS GENPARAMS $ @SYS$UPDATE:AUTOGEN SETPARAMS REBOOT This will cause AUTOGEN to recompute the system parameters and reboot. 3-10 Installing VAX ISDN __________________________________________________________ 3.1.1.4 User Interrupt If you decide to cancel the installation of VAX ISDN at any time by pressing , after a short time delay the following is displayed: %VMSINSTAL-F-CTRLY, Installation cancelled via CTRL/Y. %VMSINSTAL-F-UNEXPECTED, Installation terminated due to unexpected event. VMSINSTAL procedure done at time If you enter after the information message that the files are being moved to the target directories, your system will have some new and (if previously installed) some old VAX ISDN files. Therefore, you should reinstall the product. __________________________________________________________ 3.2 Post-Installation Procedure This section describes what must be done when the DCL prompt has reappeared, after exiting from VMSINSTAL. __________________________________________________________ 3.2.1 Setting up the VAX ISDN Software Please refer to the chapter entitled "VAX ISDN Operations" in VAX ISDN Software Management Guide for a detailed descrip- tion of how to configure the various VAX ISDN files on your node or cluster. For users in Japan, note also the appendix specific to them in said Guide. __________________________________________________________ 3.2.2 Updating the SYSMAN Startup Component Database After a reboot, the VAX ISDN Software can be started using the following command: Installing VAX ISDN 3-11 __________________________________________________________ 3.2.3 Updating System Parameters Update the system parameters to provide space for the data structures required by VAX ISDN. __________________________________________________________ 3.2.3.1 MAXBUF Parameter Make sure that the value of the MAXBUF parameter is set to at least 2048. Note that this is the current default value with VMS. If necessary, use SYSGEN to change this parameter. __________________________________________________________ 3.2.3.2 Using SYSGEN Log in under the system manager's account and run SYS$SYSTEM:SYSGEN. Within SYSGEN, then use the SHOW/MAJOR command to display the current values of the most significant system parameters. Use the SET command to specify new values for these parameters. For example: $ RUN SYS$SYSTEM:SYSGEN SYSGEN> use ACTIVE SYSGEN> show /major . . . SYSGEN> set MAXBUF 2048 SYSGEN> write ACTIVE SYSGEN> exit $ NOTE If you alter your SYSGEN parameters because of a VAX ISDN installation, you must update SYS$SYSTEM:MODPARAMS.DAT 3-12 Installing VAX ISDN so that subsequent use of the AUTOGEN procedure does not lose your changes. Use of the AUTOGEN procedure and of the file SYS$SYSTEM:MODPARAMS.DAT are described in the VMS documentation set. When you have changed the parameter values, reboot your system. __________________________________________________________ 3.2.4 Disk Backup Finally, when you have installed and configured VAX ISDN, and checked that the system is installed properly, back up the updated system disk and save the distribution kit for future updates. __________________________________________________________ 3.2.5 Reboot The ISDN software that you have installed will not come into operation until you have rebooted the system. __________________________________________________________ 3.3 Installation Verification Procedure This section explains how to check that the application has been installed correctly. __________________________________________________________ 3.3.1 The Verification Steps The Installation Verification Procedure, which is activated either automatically by VMSINSTAL or by the user, verifies that the various software components have been correctly installed on the system disk. Installing VAX ISDN 3-13 The IVP can be executed at any time after the installation (for troubleshooting purposes, for instance), by entering the following command: $ @SYS$TEST:ISDN$IVP __________________________________________________________ 3.3.2 Communication Verification As this requires specific ISDN controller hardware, the IVP does not check successful communication between the VAX ISDN Software and the ISDN itself. Please refer to the Troubleshooting chapter of VAX ISDN Software Management Guide for indications on this type of verification. 3-14 Installing VAX ISDN Chapter 4 Installing VAX ISDN ACCESS ________________________________________________________________ This chapter guides the reader through the procedure for installing VAX ISDN ACCESS. If you are installing VAX ISDN (full-function version), refer to Chapter 3 instead. __________________________________________________________ 4.1 Installing VAX ISDN ACCESS Files from the Distribution Volume To install the VAX ISDN Software from the distribution vol- ume, you should carry out the following procedure at the system console. 1 Log in to the SYSTEM account. 2 Check that the disk has enough free space for VAX ISDN ACCESS. Refer to Table 2-3 for details of how much free space you need on your system disk. 3 To start the installation procedure, enter the following command: $ @SYS$UPDATE:VMSINSTAL The procedure displays: Installing VAX ISDN ACCESS 4-1 VAX/VMS Software Product Installation Procedure (VMS_VER) It is date at time. Enter a question mark (?) at any time for help. If DECnet is currently running on your system, the proce- dure warns you with the following message: %VMSINSTAL-W-DECNET, Your DECnet network is up and running. * Do you want to continue anyway [NO]? As you do not have to shut DECnet down in order to install VAX ISDN, you may answer YES to this question. 4 The procedure continues with: * Are you satisfied with the backup of your system disk [YES]? Make sure you have a good backup copy of the disk, as the installation will write to the system disk. If your system disk has not been backed up or you wish to make a fresh copy, answer NO; the procedure would then exit without installing the software. When you have backed up your system disk, you can start the installation procedure again. If you answer YES, the procedure continues. 5 Next it asks the following question: * Where will the distribution volumes be mounted: Enter the name of the device on which the volume contain- ing the VAX ISDN Software will be mounted. ddcu: is the device name, where dd is the device code, c is the con- troller letter, and u is the unit number. For example, MUA0:. 4-2 Installing VAX ISDN ACCESS 6 Next the procedure displays: Enter the products to be processed from the first distribution volume set. * Products: 7 Enter: ISDN-ACCESS and (as normal) press . 8 The procedure responds with: * Enter installation options you wish to use (none): Enter n. This will request the display and/or printing of the Release Notes. If you specified a device which is not already mounted in step 5, then the installation procedure will continue as follows, otherwise it will proceed with step number 10 Please mount the first volume of the set on device * Are you ready? 9 Load the distribution volume (labelled ISDN-A) into the corresponding drive. Answer YES when you have done so. The procedure will then mount the volume on the device, and display a message such as this: %MOUNT-I-MOUNTED, ISDN mounted on _MUA0: Installing VAX ISDN ACCESS 4-3 10 VMSINSTAL proceeds with: The following products will be processed: ISDN-ACCESS V1.1 Beginning installation of ISDN-ACCESS V1.1 at time 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]: You should print or display the Release Notes and read them before continuing. 11 VMSINSTAL continues with: %VMSINSTAL-I-RESTORE, Restoring product saveset A ... %VMSINSTAL-I-RELMOVED , The product's release notes have been successfully moved to SYS$HELP. +----------------------------------------------------------+ | VAX ISDN-ACCESS Software Installation Procedure. | +----------------------------------------------------------+ Product: ISDN-ACCESS Producer: DEC Version: V1.1 Release Date: 30-NOV-1990 * Does this product have an authorization key registered and loaded? 12 Now answer either Y or N, depending on whether or not you have loaded the appropriate license, as described in Section 2.6. 4-4 Installing VAX ISDN ACCESS If you have answered Y and the license is not active, then the following warning is displayed: %ISDN-W-NOAUTH, DEC ISDN-ACCESS use is not authorized on this node If the license has not been loaded, the installation procedure will continue, but the Installation Verification Procedure will not be activated. The following message is then displayed: %ISDN-W-NOIVP, the Installation Verification Procedure will not be executed You should execute the IVP after loading the appropriate license, as described in Section 2.6. 13 If, on the other hand, the license is active, the proce- dure continues with: * Do you want to run the IVP [YES]? Now press if you want to the Installation Verification Procedure to be run automatically at the end of the installation. 14 The procedure continues with: * Do you want to purge files replaced by this installation [YES]? 15 Now press if you want to purge files resulting from a previous installation. Note that if you are going to use the VAX ISDN Software on several nodes in a cluster, and are installing VAX ISDN or VAX ISDN-ACCESS on these nodes, the files installed in the SYS$COMMON area of the system disk are identical and should be purged. The procedure responds with: No More Questions. Installing VAX ISDN ACCESS 4-5 There may be a time delay of several minutes at this stage in the procedure. As you have now answered all the questions required for the installation, there is no need to watch the output, which will be like this: %VMSINSTAL-I-RESTORE, Restoring product saveset B ... %VMSINSTAL-I-RESTORE, Restoring product saveset C ... 16 The procedure checks the system parameter MAXBUF. If it is less than 2048 bytes, the procedure issues the following warning: %ISDN-W-MAXBUFTOOSMALL, MAXBUF is too small, change from n to 2048. where n is the current value of the MAXBUF parameter. Change the value of the MAXBUF system parameter after you have installed VAX ISDN-ACCESS. See Section 4.2.1 for a description of how to do this. 17 When the last saveset has been copied, the proce- dure copies the distribution files from a subdirectory of SYS$UPDATE to their respective directories. (See Appendix C for details of which files are installed into which directories.) The following message is displayed then: %VMSINSTAL-I-MOVEFILES, files will now be moved to their target directories... 18 Now, if the license check at step 12 was successful and if you answered "YES" at step 13, the IVP will be run: ************************************************************ * * * ISDN-ACCESS V1.1 Installation Verification Procedure * * * ************************************************************ 4-6 Installing VAX ISDN ACCESS %ISDN-ACCESS-I-IVPSUCCESS, ISDN-ACCESS V1.1 IVP was successful Installation of ISDN-ACCESS V1.1 completed at time Enter the products to be processed from the next distribution volume set. * Products: 19 You can now leave the VMSINSTAL procedure by pressing . You will then be returned to the DCL prompt: * Products: VMSINSTAL procedure done at time. $ You may then remove the distribution medium from the device. See Section 4.2 for what to do next. __________________________________________________________ 4.1.1 Installation Failures __________________________________________________________ 4.1.1.1 Incorrect Version of Operating System During the installation, the procedure checks that the ver- sion number of the operating system (VMS) is correct. If it is incorrect, the procedure exits after displaying the following message: This product requires VMS version V5.2-1 or later to install %VMSINSTAL-E-INSFAIL, The installation of ISDN V1.1 has failed Note that the correct version(s) are shown in the System Support Addendum. Installing VAX ISDN ACCESS 4-7 __________________________________________________________ 4.1.1.2 Insufficient Disk Space During the installation, the procedure checks that there is sufficient space on your disk for the VAX ISDN ACCESS files. Refer to Table 2-3 for details of how many free blocks you need on your system to install VAX ISDN. If there is not enough space, the procedure exits after displaying the following messages: %ISDN-E-NOSPACE, this installation requires nnnn blocks of disk space. %VMSINSTAL-E-INSFAIL, The installation of VAX ISDN ACCESS V1.1 has failed. Make sure your system has sufficient free blocks before trying to install VAX ISDN ACCESS again, by going through the procedure described in Section 2.2.1. __________________________________________________________ 4.1.1.3 Insufficient Global Pages If you receive the following message during installation: %INSTALL-E-FAIL, failed to REPLACE entry for DISK$VAXVMSRL052:DCLTABLES.EXE -SYSTEM-F-GPTFULL, global page table is full %INSTALL-W-DELETED, previous Known File Entry has been deleted then it will be necessary to increase the value of the sys- tem parameter GBLPAGES by 354. To do this, edit the file SYS$SYSTEM:MODPARAMS.DAT and add the line: ADD_GBLPAGES=354 Then issue the following command sequence: $ @SYS$UPDATE:AUTOGEN SAVPARAMS GENPARAMS $ @SYS$UPDATE:AUTOGEN SETPARAMS REBOOT This will cause AUTOGEN to recompute the system parameters and reboot. 4-8 Installing VAX ISDN ACCESS __________________________________________________________ 4.1.1.4 User Interrupt If you decide to cancel the installation of VAX ISDN ACCESS at any time by pressing , after a short time delay the following is displayed: %VMSINSTAL-F-CTRLY, Installation cancelled via CTRL/Y. %VMSINSTAL-F-UNEXPECTED, Installation terminated due to unexpected event. VMSINSTAL procedure done at time If you enter after the information message that the files are being moved to the target directories, your system will have some new and (if previously installed) some old VAX ISDN ACCESS files. Therefore, you should reinstall the product. Installing VAX ISDN ACCESS 4-9 __________________________________________________________ 4.2 Post-Installation Procedure This section describes what must be done when the DCL prompt has reappeared, after exiting from VMSINSTAL. __________________________________________________________ 4.2.1 Updating System Parameters Update the system parameters to provide space for the data structures required by VAX ISDN ACCESS. __________________________________________________________ 4.2.1.1 MAXBUF Parameter Make sure that the value of the MAXBUF parameter is set to at least 2048. Note that this is the current default value with VMS. If necessary, use SYSGEN to change this parameter. __________________________________________________________ 4.2.1.2 Using SYSGEN Log in under the system manager's account and run SYS$SYSTEM:SYSGEN. Within SYSGEN, then use the SHOW/MAJOR command to display the current values of the most significant system parameters. Use the SET command to specify new values for these parameters. For example: 4-10 Installing VAX ISDN ACCESS $ RUN SYS$SYSTEM:SYSGEN SYSGEN> use ACTIVE SYSGEN> show /major . . . SYSGEN> set MAXBUF 2048 SYSGEN> write ACTIVE SYSGEN> exit $ NOTE If you alter your SYSGEN parameters because of a VAX ISDN ACCESS installation, you must update SYS$SYSTEM:MODPARAMS.DAT so that subsequent use of the AUTOGEN procedure does not lose your changes. Use of the AUTOGEN procedure and of the file SYS$SYSTEM:MODPARAMS.DAT are described in the VMS documentation set. When you have changed the parameter values, reboot your system. __________________________________________________________ 4.2.2 Disk Backup Finally, when you have installed and configured VAX ISDN ACCESS, and checked that the system is installed properly, back up the updated system disk and save the distribution kit for future updates. __________________________________________________________ 4.3 Installation Verification Procedure This section explains how to check that the application has been installed correctly. Installing VAX ISDN ACCESS 4-11 __________________________________________________________ 4.3.1 The Verification Steps The Installation Verification Procedure, which is activated either automatically by VMSINSTAL or by the user, verifies that the various software components have been correctly installed on the system disk. The IVP can be executed at any time after the installation (for troubleshooting purposes, for instance), by entering the following command: $ @SYS$TEST:ISDN$IVP_ACCESS __________________________________________________________ 4.3.2 Communication Verification As this requires specific ISDN controller hardware, the IVP does not check successful communication between the VAX ISDN Software and the ISDN itself. Please refer to the Troubleshooting chapter of VAX ISDN Software Management Guide for indications on this type of verification. 4-12 Installing VAX ISDN ACCESS Appendix A Example of a VAX ISDN Installation ________________________________________________________________ The following is an example of a VAX ISDN software installa- tion. Text entered by the user is shown in boldface. $ @sys$update:vmsinstal VAX/VMS Software Product Installation Procedure (VMS_VER) It is 19-DEC-1990 at 11:44. Enter a question mark (?) at any time for help. * Are you satisfied with the backup of your system disk [YES]? * Where will the distribution volumes be mounted: mua0: Enter the products to be processed from the first distribution volume set. * Products: isdn * Enter installation options you wish to use (none): n Please mount the first volume of the set on MUA0:. * Are you ready? yes %MOUNT-I-MOUNTED, ISDN mounted on _MUA0: The following products will be processed: ISDN V1.1 Beginning installation of ISDN V1.1 at 11:50 %VMSINSTAL-I-RESTORE, Restoring product saveset A ... Release notes included with this kit are always copied to SYS$HELP. Additional Release Notes Options: Example of a VAX ISDN Installation A-1 1. Display release notes 2. Print release notes 3. Both 1 and 2 4. None of the above * Select option [2]: 1 DUA0:[SYS0.SYSUPD.ISDN011]ISDN011.RELEASE_NOTES;1 Release notes for VAX ISDN, Version V1.1 At this point, the Release Notes are displayed on the screen; the user presses after reading each screen. Then the installation continues: End of VAX ISDN V1.1 release notes. * Do you want to continue the installation [NO]? yes %VMSINSTAL-I-RELMOVED , The product's release notes have been successfully moved to SYS$HELP. +-------------------------------------------------------+ | VAX ISDN Software Installation Procedure. | +-------------------------------------------------------+ Product: ISDN Producer: DEC Version: V1.1 Release Date: 30-NOV-1990 * Does this product have an authorization key registered and loaded? yes * Do you want to run the IVP after the installation [YES]? * Do you want to purge files replaced by this installation [YES]? VAX ISDN Software V1.1 contains network-specific code. In order to install the software correctly, you must identify which network you will be using by entering one of the following network identifier strings: A-2 Example of a VAX ISDN Installation ATT AUST BRITISH FRENCH GERMAN JAPAN NORTHERN * Enter network identifier string: french Your country specific network profile has been configured. Installation continues... No More Questions. %VMSINSTAL-I-RESTORE, Restoring product saveset B ... %ISDN-I-FILEXISTS, VMI$ROOT:[SYSMGR]NETTRACE_SECURITY.COM already exists on system %ISDN-I-FILNOTINST, VMI$ROOT:[SYSMGR]NETTRACE_SECURITY.COM not installed %ISDN-I-FILEXISTS, VMI$ROOT:[SYSLIB]NETTRACE$KEY.INIT already exists on system %ISDN-I-FILNOTINST, VMI$ROOT:[SYSLIB]NETTRACE$KEY.INIT not installed %VMSINSTAL-I-RESTORE, Restoring product saveset C ... %ISDN-I-FILEXISTS, VMI$ROOT:[SYSMGR]ISDN$STARTUP_SITE.COM already exists on system %ISDN-I-FILNOTINST, VMI$ROOT:[SYSMGR]ISDN$STARTUP_SITE.COM not installed %ISDN-I-FILEXISTS, VMI$ROOT:[SYSMGR]ISDN$SECURITY.COM already exists on system %ISDN-I-FILNOTINST, VMI$ROOT:[SYSMGR]ISDN$SECURITY.COM not installed %VMSINSTAL-I-RESTORE, Restoring product saveset D ... * * * * * * * * * * * * * * * * * * * * * * * * * * * Upon completion of this installation, please follow the instructions below:- - using the following command, add the ISDN product to the database of components to be automatically started when the system is booted:- $ RUN SYS$SYSTEM:SYSMAN SYSMAN> startup add file ISDN$STARTUP.COM [/node=(A,B,C)] - REBOOT the system Example of a VAX ISDN Installation A-3 * * * * * * * * * * * * * * * * * * * * * * * * * * * %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... ***************************************************** * * * ISDN V1.1 Installation Verification Procedure * * * ***************************************************** %ISDN-W-NOTSTARTED, VAX ISDN software not loaded %ISDN-I-IVPSUCCESS, ISDN V1.1 IVP was successful Installation of ISDN V1.1 completed at 12:02 Enter the products to be processed from the next distribution volume set. * Products: VMSINSTAL procedure done at 12:20 $ A-4 Example of a VAX ISDN Installation Appendix B Example of a VAX ISDN ACCESS Installation ________________________________________________________________ Text entered by the user is shown in boldface. $ @sys$update:vmsinstal VAX/VMS Software Product Installation Procedure (VMS_VER) It is 20-DEC-1990 at 11:02. Enter a question mark (?) at any time for help. * Are you satisfied with the backup of your system disk [YES]? * Where will the distribution volumes be mounted: mua0: Enter the products to be processed from the first distribution volume set. * Products: isdn-access * Enter installation options you wish to use (none): n Please mount the first volume of the set on MUA0:. * Are you ready? yes %MOUNT-I-MOUNTED, ISDN mounted on _MUA0: The following products will be processed: ISDN-ACCESS V1.1 Beginning installation of ISDN-ACCESS V1.1 at 11:08 %VMSINSTAL-I-RESTORE, Restoring product saveset A ... Release notes included with this kit are always copied to SYS$HELP. Additional Release Notes Options: Example of a VAX ISDN ACCESS Installation B-1 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]: Job ISDN011 (queue SYS$PRINT, entry 257) started on LPA0) * Do you want to continue the installation [NO]? yes %VMSINSTAL-I-RELMOVED , The product's release notes have been successfully moved to SYS$HELP. +---------------------------------------------------------------+ | VAX ISDN-ACCESS Software Installation Procedure. | +---------------------------------------------------------------+ Product: ISDN-ACCESS Producer: DEC Version: V1.1 Release Date: 30-NOV-1990 * Does this product have an authorization key registered and loaded? yes %ISDN-W-NOAUTH, DEC ISDN-ACCESS use is not authorized on this node %ISDN-W-NOIVP, the Installation Verification Procedure will not be executed Note that, in this example, a positive answer confirmed the license registration when, in fact, the VAX ISDN ACCESS license was not active. This is why the "ISDN-W-NOAUTH" message above was displayed in addition to the "ISDN-W-NOIVP" message. * Do you want to purge files replaced by this installation [YES]? No More Questions. %VMSINSTAL-I-RESTORE, Restoring product saveset B ... %ISDN-ACCESS-I-FILEXISTS, VMI$ROOT:[SYSLIB]NETTRACE$KEY.INIT already exists on system %ISDN-ACCESS-I-FILNOTINST, VMI$ROOT:[SYSLIB]NETTRACE$KEY.INIT not installed %VMSINSTAL-I-RESTORE, Restoring product saveset C ... %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... B-2 Example of a VAX ISDN ACCESS Installation Installation of ISDN-ACCESS V1.1 completed at 11:20 Enter the products to be processed from the next distribution volume set. * Products: VMSINSTAL procedure done at 11:21 $ Example of a VAX ISDN ACCESS Installation B-3 Appendix C Contents of the VAX ISDN Software Distribution Kits ________________________________________________________________ NOTE Except where otherwise stated, all the files installed as part of the VAX ISDN or VAX ISDN ACCESS installa- tion procedure are copied to the SYS$COMMON area of the system disk. __________________________________________________________ C.1 Contents of the VAX ISDN Distribution Kit The following release notes and help libraries are copied to the SYS$HELP directory: o ISDN011.RELEASE_NOTES o ISDN$NCP_HELP.HLB o TRACEHLP.HLB The following libraries are copied to the SYS$LIBRARY direc- tory: o ISDN$SA_DEF.H o ISDN$SA_DEF.L32 o ISDN$SA_DEF.MLB o ISDN$SA_DEF.PAS Contents of the VAX ISDN Software Distribution Kits C-1 o ISDN$SA_DEF.PEN o ISDN$SA_DEF.R32 o ISDN$SA.OLB o NETTRACE$KEY.INIT The following images are copied to the SYS$LOADABLE_IMAGES directory: o ISDN$DRIV.EXE o ISDN$L2.EXE# o ISDN$L3.EXE# o ISDN$CC.EXE o LES$DECNET.EXE o LES$DECNET_ALT.EXE o LES$LES.EXE o ISDN$NETPRF.EXE# o LES$TRACE.EXE o LES$TRACE_MBX.EXE o SDDRIVER.EXE o SDDRIVER.ULD The following DCL command files are copied to the SYS$MANAGER directory: o ISDN$NPF_SHOW.COM o ISDN$SECURITY.COM (this file is installed in the SYS$SPECIFIC area) o ISDN$SHUTDOWN.COM ___________________ # this file is network-dependent, and is chosen according to the operator's answer during the installation procedure C-2 Contents of the VAX ISDN Software Distribution Kits o ISDN$STARTUP_SITE.COM (this file is installed in the SYS$SPECIFIC area) o NETTRACE_INSTALL.COM o NETTRACE_SECURITY.COM The following message files are copied to the SYS$MESSAGE directory: o ISDN$MESSAGES.EXE o LES$ACP_MESSAGES.EXE o NETTRACE_MESSAGES.EXE The following shareable images are copied to the SYS$SHARE directory: o ISDN$ACPCODESHR.EXE o ISDN$ACPDATASHR.EXE o LES$ACP_CODE.EXE o NETTRACE$ISDN$L2_ANALYZE.EXE o NETTRACE$ISDN$L3_ANALYZE.EXE o NETTRACE$ISDN$CC_ANALYZE.EXE The following DCL command file is copied to the SYS$STARTUP directory: o ISDN$STARTUP.COM The following files are copied to the SYS$SYSTEM directory: o ISDN$NCP.EXE (this file is installed in the SYS$SPECIFIC area) o ISDN$LES_CONTROL.DAT o LES$STARTUP.EXE o LES$ACP.EXE Contents of the VAX ISDN Software Distribution Kits C-3 o NETLTC.EXE o NETTRACE.EXE The following DCL command file is copied to the SYS$TEST directory: o ISDN$IVP.COM __________________________________________________________ C.2 Contents of the VAX ISDN ACCESS Distribution Kit The following release notes and help libraries are copied to the SYS$HELP directory: o ISDN-ACCESS011.RELEASE_NOTES o ISDN$NCP_HELP.HLB o TRACEHLP.HLB The following libraries are copied to the SYS$LIBRARY direc- tory: o ISDN$SA_DEF.H o ISDN$SA_DEF.L32 o ISDN$SA_DEF.MLB o ISDN$SA_DEF.PAS o ISDN$SA_DEF.PEN o ISDN$SA_DEF.R32 o ISDN$SA_ACCESS.OLB o NETTRACE$KEY.INIT The following DCL command files is copied to the SYS$MANAGER directory: o NETTRACE_INSTALL.COM C-4 Contents of the VAX ISDN Software Distribution Kits The following message file is copied to the SYS$MESSAGE directory: o NETTRACE_MESSAGES.EXE The following shareable images are copied to the SYS$SHARE directory: o NETTRACE$ISDN$L2_ANALYZE.EXE o NETTRACE$ISDN$L3_ANALYZE.EXE o NETTRACE$ISDN$CC_ANALYZE.EXE The following files are copied to the SYS$SYSTEM directory: o ISDN$NCP.EXE (this file is installed in the SYS$SPECIFIC area) o NETTRACE.EXE o NETLTC.EXE The following DCL command file is copied to the SYS$TEST directory: o ISDN$IVP_ACCESS.COM Contents of the VAX ISDN Software Distribution Kits C-5