DECrouter 2000 Installation Procedures Order No. AA-JH81B-TN SUPERSESSION/UPDATE INFORMATION: This is a revised man- ual OPERATING SYSTEM AND VERSION: VAX/VMS V4.7, V5.0, V5.1 ULTRIX-32 V2.2, V3.0 SOFTWARE VERSION: DECrouter 2000 V1.1 DIGITAL First Printing October 1987 Revised February 1989 The information in this document is subject to change without notice and should not be construed as a com- mitment 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 ac- cordance with the terms of such license. No responsibility is assumed for the use or reliabil- ity of software on equipment that is not supplied by Digital Equipment Corporation or its affiliated com- panies. Copyright ©1989 by Digital Equipment Corporation All Rights Reserved Printed in UK The READER'S COMMENTS form on the last page of this doc- ument requests the user's critical evaluation to as- sist in preparing future documentation. The following are trademarks of Digital Equipment Corporation: DEC MASSBUS UNIBUS DEC/MMS MicroVAX VAX DECnet Packetnet VAXcluster DECsystem-10 PDP VMS DECSYSTEM-20 Q-bus VT DECUS Q22-bus DECwriter RSTS DIBOL RSX DIGITAL This manual was produced by the Wide Area Communications Environment group in Reading, England. _______________________________________________________ Contents How to Use This Manual 1 Installation Guidelines 1.1 Introduction ......................... 1-1 1.2 Pre-Installation Preparations ........ 1-2 1.2.1 Checking Disk Space................. 1-2 1.2.2 Distribution Kits................... 1-3 1.3 Installation Time .................... 1-4 2 Installation Procedures for VAX/VMS 2.1 Installing the DECrouter 2000 Software 2-1 2.1.1 Starting the Installation........... 2-1 2.1.2 Release Notes....................... 2-3 2.1.3 Tailoring the Installation.......... 2-5 2.2 Installing on Multiple Load Hosts .... 2-9 2.3 Installing on a VAXcluster .......... 2-10 iii 3 Configuring the Databases for VMS Load Hosts 3.1 Configuring the Load Host Database ... 3-2 3.1.1 Preparation for the Configuration Procedure............................3-4 3.1.2 Running ROUCONFIG................... 3-4 3.1.2.1 List Known DECrouters (Option 1) .. 3-6 3.1.2.2 Add a DECrouter (Option 2) ........ 3-7 3.1.2.3 Swap an Existing DECrouter (Option 3)................................ 3-10 3.1.2.4 Delete an Existing DECrouter (Option 4)................................ 3-11 3.1.2.5 Restoring Existing DECrouters (Option 5)................................ 3-11 3.1.3 Restoring the Configuration Automatically.......................3-12 3.2 Configuring the DECrouter 2000's Permanent Database................... 3-12 3.2.1 Running ROUSETUP................... 3-14 3.3 Loading the Software and Checking the Installation......................... 3-19 3.3.1 Loading the Software............... 3-20 3.3.2 Running the ICP.................... 3-23 3.3.3 Checking the DECrouter 2000 System Installation........................3-24 4 Installation Procedures for ULTRIX 4.1 Installing the DECrouter 2000 Software 4-1 4.2 Tailoring the Installation ........... 4-2 4.3 Installing on Multiple Load Hosts .... 4-3 iv 5 Configuring the Databases for ULTRIX Load Hosts 5.1 Configuring the Load Host Database ... 5-2 5.1.1 Preparation for the Configuration Procedure............................5-3 5.1.2 Running rouconfig................... 5-4 5.1.2.1 List Known DECrouters (Option 1) .. 5-5 5.1.2.2 Add a DECrouter (Option 2) ........ 5-6 5.1.2.3 Swap an Existing DECrouter (Option 3)................................. 5-9 5.1.2.4 Delete an Existing DECrouter (Option 4)................................ 5-10 5.1.2.5 Restoring Existing DECrouters (Option 5)................................ 5-10 5.2 Configuring the DECrouter 2000's Permanent Database................... 5-11 5.2.1 Running rousetup................... 5-12 5.3 Loading the Software and Checking the Installation......................... 5-17 5.3.1 Loading the Software............... 5-18 5.3.2 Checking the DECrouter 2000 System Installation........................5-19 A Example VMS Installation and Configuration B Example ULTRIX Installation and Configuration v C Lists of Files Installed C.1 For VAX/VMS Load Hosts ............... C-1 C.2 For ULTRIX Load Hosts ................ C-2 Tables 1-1 Disk Space Required for the DECrouter 2000 Software................................ 1-2 1-2 Media Used to Install the DECrouter 2000 Software................................ 1-3 1-3 Pre-Installation Information ........... 1-4 vi _______________________________________________________ How to Use This Manual Manual Objectives This manual describes how to: _ Install the DECrouter 2000 software on to the load host. _ Configure the load host database, so that the soft- ware can be down-line loaded on to the hardware unit. _ Configure the DECrouter 2000 permanent database. _ Load the DECrouter 2000. Intended Audience This manual is for system and network managers who are familiar with networking concepts and the DECnet prod- ucts. vii The system manager is responsible for installing and configuring the software on to one or more load hosts. The system manager is also responsible for checking that the software can load and dump. The network manager is responsible for configuring the DECrouter 2000. The manual assumes that readers understand and have some experience of: _ Local Area Networks (LANs) _ Wide Area Networks (WANs) _ Installation of software products on VAX/VMS or ULTRIX systems _ DECnet-VAX (if using a VMS load host) _ DECnet-ULTRIX (if using an ULTRIX load host) Structure of the Manual The manual has 5 chapters and 3 appendixes. VMS system managers should read Chapters 1 and 2, and refer to Appendixes A and C. VMS network managers should read Chapters 1 and 3, and refer to Appendixes A and C. ULTRIX system managers should read Chapters 1 and 4, and refer to Appendixes B and C. ULTRIX network managers should read Chapters 1 and 5, and refer to Appendixes B and C. Chapter 1 contains information you will need before in- stalling the software. Chapter 2 explains how to install the software on to a VMS load host. viii Chapter 3 explains how to configure the VMS load host database and the DECrouter 2000 database. This chap- ter also explains how to load the DECrouter 2000. Chapter 4 explains how to install the software on to an ULTRIX load host. Chapter 5 explains how to configure the ULTRIX load host database and the DECrouter 2000 database. This chap- ter also explains how to load the DECrouter 2000. Appendix A is an example of installing and configur- ing the software on a VMS host. Appendix B is an example of installing and configur- ing the software on an ULTRIX host. Appendix C lists the files installed for VMS and ULTRIX load hosts. Associated Manuals For more information on the DECrouter 2000, refer to: _ DECrouter 2000 Problem Solving Guide _ DECrouter 2000 Management Guide You may also find the Routing and Networking Overview useful in explaining routing concepts and terminology. All three of these manuals are in the same binder as this manual. The following provide information about the hardware used with the DECrouter 2000 software: _ Installing the DEC MicroServer _ Installing the DEC MicroServer-SP _ DEC MicroServer Systems Configuration Card ix _ DEC MicroServer-SP Systems Configuration Card If a VAX/VMS system is being used as a load host, you are expected to be familiar with the following manu- als: _ VMS Networking Manual _ VMS Network Control Program Reference Manual _ VMS Install Utility Manual If an ULTRIX system is being used as a load host, you are expected to be familiar with the following manu- als: _ ULTRIX-32 System Guide _ The DECnet-ULTRIX documentation set, in particular the DECnet-ULTRIX Guide to Network Management and the DECnet-ULTRIX User's and Programmer's Guide Manual Conventions This one- to three-character symbol indicates that you press a key on the terminal. For example: indicates the RETURN key, indicates the ESCAPE key. This symbol indicates that you press the CTRL key at the same time as you press another key; for example, , , and so on. Red print indicates commands and data that you enter. x Italics indicate variable information. xi ______________________________________________________1 Installation Guidelines 1.1 Introduction The installation procedure consists of the following steps: 1.Installing the distribution software on the load host(s) 2.Configuring the load host database 3.Configuring the DECrouter 2000 permanent database 4.Down-line loading the DECrouter 2000 software on to the hardware unit The load host can be any VAX/VMS or ULTRIX Phase IV DECnet node and must be connected to the same Ethernet as the hardware unit. If you use a VAX/VMS system as the load host, the sys- tem must be running V4.7, V5.0 or V5.1. If you use an ULTRIX system as a load host, the system must be run- ning at least V2.2 or V3.0 of ULTRIX-32. The load host is used to store the DECrouter 2000 soft- ware image which is down-line loaded on to the DECrouter 2000. The load host also stores the configuration database and is used to receive up-line dumps from the DECrouter 2000. Installation Guidelines 1-1 You are advised to install the DECrouter 2000 software on at least two load hosts. This means that you can still down-line load the image to the DECrouter 2000 and re- ceive dumps when one load host is unavailable. To in- stall the software on to a second load host, simply re- peat the installation procedure. If your load hosts are within a VAXcluster, refer to Section 2.3 for details of how to use VAXcluster nodes as load hosts. 1.2 Pre-Installation Preparations Before you install the DECrouter 2000 software on the load host, you need to: _ Ensure that there is enough free disk space for the DECrouter 2000 image and configuration file. _ Check that there is enough room on the load host sys- tem to receive up-line dumps from the DECrouter 2000. 1.2.1 Checking Disk Space Check your disk space by entering the command: $ SHOW DEVICE ddnn Table 1-1 shows how much disk space is needed to in- stall the software. Table 1-1 Disk Space Required for the DECrouter ___________2000_Software____________________________ ______________________VAX/VMS_System__ULTRIX_System_ Installation per 2100 blocks 1075K bytes DECrouter 2000 1-2 DECrouter 2000 Installation Procedures Table 1-1 (Cont.) Disk Space Required for the ___________________DECrouter_2000_Software__________ ______________________VAX/VMS_System__ULTRIX_System_ Up-line Dumps per 5000 blocks 2560K bytes dump________________________________________________ 1.2.2 Distribution Kits The DECrouter 2000 software is installed from a TK50 cassette, from an RX33 floppy or magnetic tape. Table 1-2 Media Used to Install the DECrouter 2000 ___________Software_________________________________ Media_Type____________Number________________________ TK50s 1 Magnetic tapes 1 RX33s___________________1___________________________ Before you install the software on to the load host, complete Table 1-3. During the installation, you will need to refer to this table for information about your load system and the DECrouter 2000. You will also need to refer to the configuration card which is situated on the front of the hardware unit. If there is a default answer for any question asked dur- ing the installation, the answer will be given in square brackets. So, if the default password is DECNET, it will appear as [DECNET]. Installation Guidelines 1-3 Table_1-3__Pre-Installation_Information_____________ Ethernet_address______________________________________________________________________________________ DECnet_address________________________________________________________________________________________ DECnet_node_name______________________________________________________________________________________ Load_host_node_name(s)________________________________________________________________________________ Load_host_service_circuit_name(s)_____________________________________________________________________ ____________________________________________________ The Ethernet address is the physical address of the DEC MicroServer hardware unit, which can be found on a la- bel on the rear of the unit. The Ethernet address is also listed on the configuration card which is attached to the front of the hardware unit. The DECnet address is the address assigned to the DECrouter 2000, and the DECnet node name is its node name. The load host node names are the names of the nodes that will down-line load the DECrouter 2000. DIGITAL suggests that you complete the above table, and then complete the required information about load hosts on the configuration card once the DECrouter 2000 in- stallation has been successfully completed. Refer to Appendix C for a list of those files which are installed on to the load host. 1.3 Installation Time The installation of the DECrouter 2000 should take ap- proximately 15 minutes. 1-4 DECrouter 2000 Installation Procedures ______________________________________________________2 Installation Procedures for VAX/VMS This chapter explains how to install the DECrouter 2000 software on to a VAX/VMS load host. During the instal- lation you will need the information that you supplied in Table 1-3. 2.1 Installing the DECrouter 2000 Software 2.1.1 Starting the Installation To install the DECrouter 2000 software, carry out the following procedure: Log in to the system manager's privileged account. Check you have set default to the disk that is to receive the DECrouter 2000 software; typically, this is the sys- tem disk (with the logical name SYS$SYSDEVICE). Check that the disk has enough free space for the DECrouter 2000 image and configuration file to be installed. Remember to include enough space for up-line dumps from the DECrouter 2000. Refer to Table 1-1 for details of how much free disk space you need on your system to install the DECrouter 2000 software. Installation Procedures for VAX/VMS 2-1 To start the installation procedure, enter the follow- ing commands: $ SET DEFAULT SYS$UPDATE $ @VMSINSTAL ROU011 device-identifier OPTIONS N where device-identifier is the name of the device that the distribution kit is mounted on. The format for the device name is ddcu: where dd is the device code, c is the controller letter, and u is the unit number. For example: if you wish to install from MUA0: answer MUA0. NOTE VMSINSTAL turns off the BYPASS priv- ilege Using the OPTIONS N facility allows you to print and/or read the Release Notes. The procedure displays: VAX/VMS Software Product Installation Procedure V5.0 It is date at time Enter a question mark (?) at any time for help. If DECnet is currently running on your system, the pro- cedure 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 turn DECnet off to install the software, you may answer YES to this question. The pro- cedure 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, answer NO to this question. If you answer NO, the procedure exits, and 2-2 DECrouter 2000 Installation Procedures the DECrouter 2000 software will not be installed. When you have backed up your system disk, you can start the installation procedure again. Answer YES when you have a good backup copy of the disk. Please mount the first volume of the set on device-identifier Are you ready? Enter YES, and a message is displayed confirming that the media is mounted. The procedure then displays the following messages: The following products will be processed: ROU V1.1 Beginning installation of ROU V1.1 at time %VMSINSTAL-I-RESTORE, Restoring product saveset A... You will then be asked about the Release Notes. 2.1.2 Release Notes The procedure displays the options for printing and dis- playing the Release Notes. You are recommended to print and read the Release Notes before continuing the in- stallation. Release Notes Options: 1. Display release notes 2. Print release notes 3. Both 1 and 2 4. Copy release notes to SYS$HELP 5. Do not display, print or copy release notes. * Select option [2]: Installation Procedures for VAX/VMS 2-3 NOTE If you are using a VAX/VMS load host which is running V4.7, then only options 1, 2 and 3 will be avail- able. Select one of these options. DIGITAL recommends that you choose Option 2. If you select Option 1, the fol- lowing is displayed: VMI$COMMON:[SYSUPD.DECSERVER]ROU011.RELEASE_NOTES;1 The Release Notes are displayed on your terminal and will start scrolling on your screen. If you select Option 2, you are asked on which queue you wish the file to be printed: * Queue name [SYS$PRINT]: Enter or specify another print queue. If you select Option 3, you are asked on which queue you wish the file to be printed and then the Release Notes will be displayed on your terminal. If you select Option 4, the release notes are copied to the SYS$HELP directory. When the Release Notes have been queued to a printer, displayed on your terminal or copied to SYS$HELP, the procedure asks: * Do you want to continue the installation [N]? If you enter , you can stop the procedure and read the Release Notes. If you do this, the following mes- sage is displayed: VMSINSTAL procedure done at hh:mm 2-4 DECrouter 2000 Installation Procedures While reading the Release Notes, check for any issues that are likely to affect the installation of the DECrouter 2000 software. The VMSINSTAL procedure creates a file for the Release Notes called ROU011.RELEASE_NOTES in the SYS$COMMON:[DECSERVER] directory once this direc- tory has been created. The Release Notes are also copied to the SYS$HELP directory and the following message is displayed: %VMSINSTAL-I-RELMOVED, The products release notes have been successfully moved to SYS$HELP. If you stop VMSINSTAL to read the Release Notes, restart the procedure by entering the following command: $ @VMSINSTAL ROU011 device-identifier 2.1.3 Tailoring the Installation If you do not stop VMSINSTAL, or if you have restarted the procedure, VMSINSTAL will continue to install the DECrouter 2000 software. The procedure asks: * Do you want to purge files replaced by this installation [YES]? Answer YES if you wish to purge files from any previ- ous installations of the DECrouter 2000 software. The procedure then asks: Do you want the TRACE utility [YES]? Answer YES if you wish to install the TRACE utility. Refer to the DECrouter 2000 Problem Solving Guide for details of this utility. The procedure then asks if you have a product license installed. The VMS License Management Facility is avail- able with VMS V5.0. It is a management tool which en- ables you to register, manage and track software li- censes on line. You do not need a license to install Installation Procedures for VAX/VMS 2-5 and operate the DECrouter V1.1 software. However, DIGITAL recommends that you do install a license so that you can keep your database of layered products up to date. Refer to the VMS License Management Utility Manual in the VMS documentation set for further information. 2-6 DECrouter 2000 Installation Procedures Does this product have an authorization key registered and loaded? If you answer NO then you are asked: Do you wish to exit [YES] If you answer NO to this question the following mes- sage is displayed: You do not need to install a license for the DECrouter 2000 V1.1 software. However, DIGITAL recommends that you do install a license so that the database of layered products is kept up to date. The installation procedure continues by copying the con- tents of the distribution volume to a subdirectory in SYS$UPDATE. The procedure then copies the distribution files from SYS$UPDATE to their respective directories. (See Appendix C for details of which files are installed in which di- rectories.) You may remove the distribution media from the device at this stage. If you decide to cancel the installation of the DECrouter 2000 software at any time by entering , the fol- lowing is displayed after a short time delay: %VMSINSTAL-F-CTRLY, Installation canceled via CTRL/Y. %VMSINSTAL-F-UNEXPECTED, Installation terminated due to unexpected event. VMSINSTAL procedure done at hh:mm 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 in- stalled) some old DECrouter 2000 files. Therefore, you should reinstall the product. Installation Procedures for VAX/VMS 2-7 The procedure then checks the definition for the sys- tem logical, MOM$LOAD. This definition is in the sys- tem startup file - SYSTARTUP_V5.COM. If you have al- ready defined MOM$LOAD, the procedure asks if you wish to redefine MOM$LOAD, and if you do, will automatically redefine the logical name for you. MOM$LOAD must include SYS$COMMON:[DECSERVER]. If MOM$LOAD is already correctly defined, the question is not asked. The next stages of the installation allow you to mod- ify the DECrouter 2000 software for your system. The procedure displays the following messages. The installation is now complete. After exiting from VMSINSTAL, do the following: 1. If the definition for MOM$LOAD in the site-specific system start-up file does not contain SYS$SYSROOT:[DECSERVER], you must edit your site-specific system start-up file so that it defines the logical MOM$LOAD as a search string with a value equal to itself and the element SYS$SYSROOT:[DECSERVER]. For example: DEFINE/SYSTEM/EXEC/NAME_ATTRIBUTE=NO_ALIAS/NOLOG MOM$LOAD - "current-search-string",SYS$SYSROOT:[DECSERVER] This command allows the location of the DECrouter image to be defined each time the system is rebooted, so the system will load correctly. 2. Configure your DECrouter 2000 into the load host's database. Execute the command procedure called ROUCONFIG.COM which is in the SYS$SYSROOT:[DECSERVER] directory. If you have already executed this procedure from previous installations, you only need to configure any additional DECrouter units. All previously defined DECrouter units will still be configured within the load host's database. Refer to Chapter 3 of the DECrouter 2000 Installation Procedures for further details. 3. Set up the DECrouter 2000 permanent database before powering up the hardware. Execute the command procedure called ROUSETUP.COM which is in the SYS$SYSROOT:[DECSERVER] directory. ROUSETUP.COM generates an ICP which checks that the DECrouter 2000 is fully operational. Refer to Chapter 3 of the DECrouter 2000 Installation Procedures for further details. 2-8 DECrouter 2000 Installation Procedures If you wish to modify the DECrouter 2000 database for your specific networking requirements, execute the ROUPERM.EXE program which is in the SYS$SYSTEM directory. This program is described in the DECrouter 2000 Management Guide. 4. REMINDER: The release notes for the DECrouter 2000 are in SYS$HELP. If you have requested the TRACE utility, the follow- ing message is also displayed. 5. A command file SYS$MANAGER:NETTRACE_INSTALL.COM has been created to install the TRACE utility. Edit your site-specific system start-up file to execute this file each time your system is booted. %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... Installation of ROU V1.1 completed at time VMSINSTAL procedure done at time Once you have edited your start-up procedure, run the configuration procedures, ROUCONFIG.COM to configure the load host's database and ROUSETUP.COM to configure the DECrouter 2000's perma- nent database. Refer to Chapter 3 for details of these procedures. 2.2 Installing on Multiple Load Hosts You are advised to install the DECrouter 2000 software on to at least one other load host. The second load host can down-line load the software to the DECrouter 2000 if the first load host is not available. The second load host can also be used to receive up-line dumps from the DECrouter 2000. You can use any VAX/VMS Phase IV DECnet node as a load host provided the node is connected to the same Ethernet as the hardware unit, and is running at V5.0 of VAX/VMS. Installation Procedures for VAX/VMS 2-9 To install the DECrouter 2000 software on to one or more additional load hosts, repeat the installation proce- dure given in Section 2.1. 2.3 Installing on a VAXcluster If you install the DECrouter 2000 software on to a node within a VAXcluster, the image will be copied to the SYS$COMMON area. In order to down-line load and up-line dump the DECrouter 2000 from the VAXcluster, you should run ROUCONFIG on one node within the VAXcluster. You should then re-run ROUCONFIG with the RESTORE option on the other VAXcluster nodes that you wish to use as load hosts for your DECrouter 2000. Refer to Section 3.1 for details. Remember to redefine MOM$LOAD on each node you are us- ing as a load host within the VAXcluster. 2-10 DECrouter 2000 Installation Procedures ______________________________________________________3 Configuring the Databases for VMS Load Hosts This chapter describes the configuration procedure for: _ The VMS load host database _ The DECrouter 2000 permanent database The chapter also explains how to load the DECrouter 2000. The load host database contains information on the DECrouter 2000s that are to use the load host for down-line load- ing the DECrouter 2000 software. You need to config- ure the database before you can down-line load the DECrouter 2000 software. The DECrouter 2000 permanent database contains the in- formation required for the DECrouter 2000 to communi- cate with other nodes in the network. After you have installed the software on to the load host, you should first run ROUCONFIG.COM to set up the load host database, and then run ROUSETUP.COM to set up the DECrouter 2000's permanent database. Refer to Section 3.1 for details of ROUCONFIG.COM, and refer to Section 3.2 for details of ROUSETUP.COM. Configuring the Databases for VMS Load Hosts 3-1 NOTE You must not load the DECrouter 2000 until you have run these two com- mand procedures. If you load the DECrouter 2000 before you have set up the databases, the DECrouter 2000 may attempt to use an incorrect con- figuration which could disrupt nor- mal network operation. Refer to Section 3.3 for details of how to load the DECrouter 2000. 3.1 Configuring the Load Host Database This configuration process is controlled by a menu-driven procedure called ROUCONFIG.COM which allows you to de- fine, modify and delete entries about DECrouter 2000s in the load host's database. The ROUCONFIG.COM file is copied to the SYS$SYSROOT:[DECSERVER] directory during the installation procedure. The ROUCONFIG procedure allows you to: _ List the DECrouter 2000s defined in the load host database. _ Add an entry for a new DECrouter 2000 in the load host database which will identify the DECrouter 2000 on the Ethernet. _ Swap an existing DECrouter 2000 for a new one. If you swap a DECrouter 2000, all the original DECrouter 2000 characteristics are retained, but the Ethernet address of the new unit is substituted for the orig- inal one. 3-2 DECrouter 2000 Installation Procedures _ Delete an entry for a DECrouter 2000 from the load host database. When you delete an entry, the load host no longer recognizes the DECrouter 2000, so is no longer a load host for that DECrouter 2000. Database entries are deleted when the network is reconfig- ured or when you assign a DECrouter 2000 to another load host. _ Restore existing DECrouter 2000s to your DECnet load database. This copies DECrouter 2000 entries from the load host database to the DECnet load database, so reconfiguring the DECnet load database. This is useful when you copy your local DECnet database from a central DECnet database which does not contain en- tries for the DECrouter 2000s. ROUCONFIG modifies the following databases: 1.The load host database (containing information about the DECrouter 2000s) which is displayed when you se- lect the List option from the menu. This database is stored in the file called ROUCONFIG.DAT in the SYS$COMMON:[DECSERVER] directory. 2.The volatile DECnet load host database. 3.The permanent DECnet load host database. During the ROUCONFIG.COM procedure, information is some- times transferred from the load host database to the DECnet database. ROUCONFIG keeps these two databases synchronized. ROUCONFIG enables the service circuit that will be used to down-line load the DECrouter 2000 software from the load host to the DECrouter 2000. Configuring the Databases for VMS Load Hosts 3-3 3.1.1 Preparation for the Configuration Procedure Before you run the ROUCONFIG.COM procedure, perform the following checks: 1.Ensure that DECnet is running on your load host node, and that NCP (the Network Control Program) has been installed. 2.Ensure that you know the DECnet node name and DECnet node address for each DECrouter 2000 you want to add to the database. The DECnet node name and address can be found on the configuration card which is on the front of the hardware unit and in Table 1-3 in this manual. 3.Ensure that you know the Ethernet address of each DECrouter 2000 you want to add to the database. The Ethernet address can be found on the back of the hard- ware unit, on the configuration card on the front of the hardware unit, and in Table 1-3 in this man- ual. 3.1.2 Running ROUCONFIG ROUCONFIG is an interactive, menu-driven procedure. When the menu is displayed, select an option and enter . You can obtain HELP by entering a ?. When you have fin- ished answering the questions on a selected option, the program returns you to the menu. If you want to exit from an option without making any changes, enter and the program returns you to the menu. Enter at the menu to exit from the procedure. If you have selected the Add, Delete or Swap options, NCP messages may be displayed when you have completed the option. If an error message is displayed, the op- eration may not have been successful. Refer to the VMS System Messages and Recovery Procedures Manual for de- tails of these messages. 3-4 DECrouter 2000 Installation Procedures If you run ROUCONFIG on a single system, the software must already be installed on that load host. If your load host is a member of a VAXcluster, the distribu- tion software can be installed on any node within the VAXcluster - not necessarily the node on which you are running the procedure. NOTE If you have installed the DECrouter 2000 software on to more than one load host, you must run ROUCONFIG for each load host. First run ROUCONFIG on one load host, and then re-run ROUCONFIG with the RESTORE param- eter on the other load hosts. Log into the system account, or any account with OPER and SYSPRV privileges, and enter the following commands: $ SET DEFAULT SYS$SYSROOT:[DECSERVER] $ @ROUCONFIG ROUCONFIG checks that DECnet is running. If DECnet is down, a warning message is displayed and the procedure exits. If this happens, start DECnet before executing the procedure again. If the data file (called ROUCONFIG.DAT) does not ex- ist, the procedure creates the file and displays the following message: The database file: ROUCONFIG.DAT could not be found, a new file will be created for you. You are then reminded that each DECrouter 2000 must have a unique DECnet node name and DECnet node address. The procedure asks if you want to continue or exit as fol- lows: Press to start, or CTRL/Z to exit. If you press , ROUCONFIG displays the following: Configuring the Databases for VMS Load Hosts 3-5 DECrouter Configuration Procedure Menu of Options 1 - List known DECrouters 2 - Add a DECrouter 3 - Swap an existing DECrouter 4 - Delete an existing DECrouter 5 - Restore existing DECrouters CTRL/Z - Exit from this procedure Your choice: Select the number that corresponds to the option you want and press . Sections 3.1.2.1 to 3.1.2.5 de- scribe the options. 3.1.2.1 List Known DECrouters (Option 1) If you select this option, the contents of the ROUCONFIG.DAT file is displayed in seven columns. For example: DECnet DECnet Router Service Address Node Type Circuit Ethernet Address Load File Dump File ------- ------ ------ ------- ---------------- --------- --------- 12.1001 KANGA DR2000 UNA-0 08-00-2B-02-CC-24 ROU011.SYS ROUKANGA.DMP 12.1002 KOALA DR2000 UNA-0 08-00-2B-02-AA-23 ROU011.SYS ROUKOALA.DMP Total of 2 DECrouter(s) defined. The display shows information about the load host database including the names of the load and dump files used by the database. A DECrouter 2000 dumps its memory into a DECrouter 2000 dump file either as a result of a failure or in response to a request by the network manager. This file can be used for diagnosing any problems that may arise when using a DECrouter 2000. If a DECrouter 2000 repeatedly 3-6 DECrouter 2000 Installation Procedures crashes and an up-line dump is produced, copy the dump to a suitable form of media and send it with a Software Performance Report (SPR) to DIGITAL. Refer to the DECrouter 2000 Problem Solving Guide for details of how to sub- mit an SPR. The naming convention used for the load and dump files is as follows: ROU011.SYS ROUrouter.DMP where router is the node name of the DECrouter 2000. 3.1.2.2 Add a DECrouter (Option 2) If you select this option, you can add a new entry to the load host database. When you define a new entry you must supply: 1.The DECrouter type 2.A unique DECnet node name for the DECrouter 2000 3.A unique DECnet node address for the DECrouter 2000 4.The Ethernet address of the DECrouter 2000 5.The name of the load host's service circuit which will be used to down-line load the DECrouter 2000 The DECrouter 2000's DECnet node name and address, its Ethernet address and the name of the load host's ser- vice circuit can be found in Table 1-3 in this manual. You will be prompted to supply the above information as follows. DECrouter type (DR200, DR2000, X25ROU): Configuring the Databases for VMS Load Hosts 3-7 Specify DR2000 for a DECrouter 2000, which allows you to use up to four synchronous lines. If you specify DR200, you can use the DECrouter 200 which has up to eight asyn- chronous lines. Refer to the DECrouter 200 documenta- tion for details of this product. If you specify X25ROU, you can use the X25router 2000 which has up to four syn- chronous lines which can be used for DECnet and X.25 links. Refer to the X25router 2000 documentation for details of this product. DECnet node name for unit: Specify the DECnet node name for the DECrouter 2000. This node name consists of up to six alphanumeric char- acters (one of which must be a letter). The name must be unique for your DECnet network. DECnet node address for unit: Specify the DECnet node address for the DECrouter 2000. This is a decimal number from 1 to 1023 and must be unique for your DECnet network. If your network is divided into areas, include the area number within the address (the area address is inserted in front of the node address). For example, if an address is 12.1001, 12 is the area number and 1001 is the node number. If you omit the area number, the area number of the current load host is used as a default. Ethernet address for unit (nn-nn-nn-nn-nn-nn): Specify the Ethernet address of the DECrouter 2000. This address is situated on the configuration card which is on the front of the hardware unit. If the address is not on the card, it can be found on a label on the back of the hardware unit. Enter the Ethernet address as six pairs of hexadecimal digits, with a hyphen separating each pair. For example: 08-00-2B-02-AA-23 DECnet Service Circuit-ID [default-id]: 3-8 DECrouter 2000 Installation Procedures Specify the service circuit for your load host's Ethernet controller type as follows: _ UNA-n for DEUNA or DELUA _ QNA-n for DEQNA, DELQA or DESQA _ BNT-n for DEBNT _ BNA-n for DEBNA _ SVA-n for DESVA were n is an integer. Whenever you run this configuration procedure, you will be asked for the service circuit-ID. The first time you are asked for the circuit-ID, the default response will be determined by the processor type of the VAX/VMS load host. If you specify a different service circuit-ID, this new circuit-ID becomes the new default. Once you have specified the service circuit-ID, ROUCONFIG adds the new entry to the database, and sets SERVICE ENABLED on the circuit. This will allow the load host to down-line load the DECrouter 2000 software image to the DECrouter 2000. NOTE When ROUCONFIG sets SERVICE ENABLED on the circuit, the circuit may be turned off and then turned on again which may cause events to be logged. If a DECnet NCP error message is displayed while you are adding a DECrouter 2000 to the database, the en- try will be added to the ROUCONFIG.DAT file, but will not be added to the DECnet database. Therefore, you should immediately use Option 4 to delete the entry, locate and correct the condition that is responsible for the DECnet error, and return to Option 2 to add the entry again. Configuring the Databases for VMS Load Hosts 3-9 If you specify a node address that is already defined in the database, a ROUCONFIG.COM error is displayed, nothing is added to the database, and the Add option is exited. 3.1.2.3 Swap an Existing DECrouter (Option 3) If you select this option, you can swap an existing DECrouter 2000 for a new hardware unit. You need only specify the Ethernet address of the new unit. All the other char- acteristics of the original unit are retained in the database. The procedure displays the following message: If you use this option, and you have more than one load host for the DECrouter, you must modify the database for each load host. To do this, execute ROUCONFIG on each load host, and select the SWAP option. The procedure asks: What is the node name of the DECrouter you want to swap: Specify the node name of the existing DECrouter 2000 that you want to replace. The configuration procedure displays the Ethernet address of the old unit and asks the following question: DECrouter node-name at Ethernet address nn-nn-nn-nn-nn-nn is being swapped. Enter the Ethernet address of the new DECrouter to replace node-name. Specify the Ethernet address of the new unit. This ad- dress is situated on the configuration card which is on the front of the hardware unit. If the address is not on the card, it can be found on a label on the back of the hardware unit. Enter the Ethernet address as six pairs of hexadecimal digits, with a hyphen separating each pair. 3-10 DECrouter 2000 Installation Procedures 3.1.2.4 Delete an Existing DECrouter (Option 4) If you select this option, you can delete a DECrouter 2000 from the database. Deleting is used when you re- configure the network or change the load hosts. ROUCONFIG prompts you for the name of the DECrouter 2000 as fol- lows: What is the DECnet node name of the unit you want to delete: (CTRL/Z to return to menu) Specify the DECnet node name of the DECrouter 2000 you want to delete. The procedure checks that there is an entry for the specified node name in the database, re- moves the entry, and returns you to the menu. If the entry does not exist, ROUCONFIG informs you about this, and returns you to the menu. 3.1.2.5 Restoring Existing DECrouters (Option 5) If you select this option, you can restore to your load host's DECnet node database all the DECrouter 2000s you have defined using ROUCONFIG. The restore option af- fects both the volatile and the permanent DECnet databases. If your network contains a large number of nodes, you may store your DECnet node database on a remote, cen- tral node and copy this database to each node at sys- tem start-up. DIGITAL advises that you do not define DECrouter 2000s in the central database. When your DECrouter 2000s are not defined in the central database, you must add them each time you copy your local DECnet database from the central database. Use this option to restore existing DECrouter 2000 configurations. Configuring the Databases for VMS Load Hosts 3-11 The following messages confirm that the configurations have been restored. Restoring existing DECrouters from local database. Local database successfully restored. 3.1.3 Restoring the Configuration Automatically You can use an automated command procedure to restore the local database. Run ROUCONFIG.COM with the RESTORE parameter: $ @ROUCONFIG RESTORE The RESTORE parameter by-passes the menu and allows you to include the restore procedure in your system start- up procedures. If you want to restore the down-line load database (the DECnet load database) for your DECrouter 2000s at system start-up, include the following state- ment in your system startup after the command line that loads DECnet. @SYS$SYSROOT:[DECSERVER]ROUCONFIG RESTORE NOTE It is recommended that any DECrouter 2000s running V1.0 be reconfigured with V1.1 software so that the next time they are down-line loaded, there will not be a need for the V1.0 soft- ware. 3.2 Configuring the DECrouter 2000's Permanent Database The DECrouter 2000's permanent database is configured by running the command procedure called ROUSETUP.COM. Usually, running this command procedure is all you need to do to set up the permanent database. 3-12 DECrouter 2000 Installation Procedures If you wish to tailor the database to your specific net- working requirements, you should run the ROUPERM pro- gram which is documented in the DECrouter 2000 Management Guide. The ROUSETUP configuration procedure consists of a se- ries of questions which allow you to set up the fol- lowing in the DECrouter 2000's permanent database: _ The node name. _ The type of routing node and hardware type. _ The access control strings required to protect the database. _ The line(s) used, and their associated parameters. _ The circuit(s) used, and their associated parame- ters. ROUSETUP is an interactive procedure. You simply sup- ply the information requested by the displayed ques- tion. You can obtain HELP by entering a ?, and you can exit from the procedure by entering . If you run ROUSETUP on a single system, the software must already be installed on that system. If your load host is a member of a VAXcluster, the distribution soft- ware can be installed on any node within the VAXcluster - not necessarily the node where you are running the procedure. NOTE If you have a DECrouter 2000 con- figured with V1.0 software and you want to run a high speed line, then you must delete the existing router first. Do this by running ROUCONFIG and then reconfigure the DECrouter 2000 with the V1.1 software. Configuring the Databases for VMS Load Hosts 3-13 3.2.1 Running ROUSETUP Log into the system account, or any account with OPER and SYSPRV privileges, and enter the following commands: $ SET DEFAULT SYS$SYSROOT:[DECSERVER] $ @ROUSETUP The procedure starts by displaying the following mes- sage: This command procedure sets up the permanent database for the DECrouter 2000. Usually, executing this procedure is all you need to do to set up the database. The procedure consists of a series of questions. If you need help with answering a question, enter ? as a response and the HELP text will be displayed. The procedure first asks you for the node name of the DECrouter 2000. DECrouter 2000 node name: Enter the node name of the DECrouter 2000. The DECnet node name for your DECrouter 2000 consists of from 1 to 6 alphanumeric characters, one of which must be al- phabetic. This name identifies the DECrouter 2000 within the network. You are then asked whether you are running the DECrouter 2000 on a DEMSA or a DEMSB. DECrouter 2000 type [DEMSA, DEMSB] If you answer DEMSA, the procedure asks what type of router you want the DECrouter 2000 to be set up as. A DECrouter 2000 can be either an AREA (Level 2) router or a ROUTING IV (Level 1) router. An AREA router can forward packets from one area within a network to an- other area. A ROUTING IV router can only forward pack- ets within its own area. Do you want node-name to be an AREA router [NO]: 3-14 DECrouter 2000 Installation Procedures The procedure then asks you about the Ethernet circuit cost to be used with the DECrouter 2000. Ethernet circuit cost [4]: Specify a value in the range 1 to 63. The cost is a value assigned to a circuit between two adjacent nodes. Packets are routed along paths with the smallest cost. You are now asked about the router priority for the DECrouter 2000. Router priority [64]: Specify a value in the range 1 to 127. The router with the highest priority will become the designated router for the Ethernet. If you have a DEMSA, you are then asked to specify the number of lines that you want to use with the DECrouter 2000. The procedure displays the following: The DECrouter 2000 supports the following combinations of lines, line speeds and ports. Specify the type you require. Type Number of lines Maximum speed Ports (bits per second) 1 4 64K 0, 1, 2, 3 2 2 256K 0, 1 3 1 2.084M 0 Type [1]: The DECrouter 2000 running on the DEMSA can support three types of operation. Each type has certain lines, line speeds and ports associated with it. For speeds of up to 64K bits per second for each line, specify type 1. For speeds of up to 256K bits per second for each line, specify type 2. For speeds of up to 2.084M bits per sec- ond for each line, specify type 3. Configuring the Databases for VMS Load Hosts 3-15 The procedure then displays how the DECrouter 2000 will be configured. For example: node-name will be configured as a ROUTING IV router with 4 lines each capable of operating at speeds up to 64K bits/s If you have a DEMSB, the following will be displayed: node-name will be configured as a ROUTING IV router with 1 line operating at 19.2K bits/s. You are then prompted for the following information about the lines you have set up - (if you have a DEMSB there will only be one): _ The line name. The default line name is SYN-n where n is the port on the hardware that the line uses. For example: Line 1 name [SYN-1]: If you do not use the default, you should specify a string of between 1 and 16 characters for the line name. _ The line state. The default line state is ON. For example: Line line-name state [ON]: The status of the line can be ON or OFF. _ The name of the circuit associated with the line. The default circuit name is the same as the line name. For example: Name of circuit associated with line line-name [line-name]: If you do not use the default, you should specify a string of between 1 and 16 characters for the cir- cuit name. 3-16 DECrouter 2000 Installation Procedures _ The state of the circuit. The default circuit state is ON. For example: Circuit circuit-name state [ON]: The status of the circuit can be ON or OFF. _ The cost for the circuit. The default value is 5. For example: Circuit circuit-name cost [5]: Specify a value between 1 and 63 for the circuit cost. The cost is a value assigned to a circuit between two adjacent nodes. Packets are routed on paths with the least cost. You will now be asked about the access control infor- mation which will be used to control who can alter the database and who can use the TRACE utility from a VMS node (if installed). For each set of information, spec- ify a username and password. The username and password each consist of 1-16 alphanumeric or punctuation char- acters. You will be asked to verify your entry for the password. NOTE You are strongly advised to set up a username and password for the NML object. If you do not, any user within the network can modify your DECrouter 2000. Enter the username and password to be used to control access to the DECrouter. This information must be supplied whenever the lines and circuits on the DECrouter 2000 are being modified. If this information is not specified, anyone can modify the DECrouter 2000. NML Username [NONE]: NML Password: Verification: Configuring the Databases for VMS Load Hosts 3-17 Remember what you have specified for the username and password, as you will need to use it in order make fu- ture modifications to the DECrouter 2000 database. The procedure then asks about the username and password for the TRACE utility. NOTE You are strongly advised to set up a username and password for the TRACE utility. If you do not, any user within the network with TRACE in- stalled on their VMS node can mon- itor the traffic on your DECrouter 2000. Enter the username and password to be used for the TRACE utility. This information must be supplied when using the TRACE utility on the DECrouter. If this information is not specified, anyone can monitor traffic on the DECrouter 2000. TRACE Username [NONE]: TRACE Password: Verification: Remember what you have specified for the username and password, as you will need to specify the information when you use the TRACE utility. Once you have supplied all the required information, the procedure checks for an existing configuration file. If there is already a file for this DECrouter 2000 node, the following is displayed: A configuration file for node-name already exists. Do you want to create another [YES]: If you answer YES, the old file will be renamed to SYS$COMMON:[DECSERVER]ROUnodename.OLD. 3-18 DECrouter 2000 Installation Procedures The procedure then displays the following message. The following commands will be executed to create the permanent database: The procedure then lists the commands it will use to create the permanent database and asks: Do you want these commands to be executed [YES]: Answer YES, and the permanent database will be created for you. The procedure displays the following messages: Rouperm V1.1, DECrouter 2000 Configuration Program %ROUPERM-I-NEWRTR this is a new DECrouter %ROUPERM-I-FILNEW new configuration file created If you answer NO, you should re-run the ROUSETUP pro- cedure in order to create the permanent database. Once the permanent database has been created, the procedure displays: Generating an Installation Checkout Procedure (ICP) for the DECrouter. This is a command file that can be run at any time after both the hardware and software installation is completed. The ICP will verify that the DECrouter 2000 has been installed correctly. The ICP will be called "SYS$COMMON:[DECSERVER]ROU_node name.ICP" Now you have set up the databases, you can load the DECrouter 2000 and check the installation by running the ICP. 3.3 Loading the Software and Checking the Installation There are three stages in checking the installation. _ First check the load host installation by down-line loading the DECrouter 2000 software image. _ Then run the ICP. Configuring the Databases for VMS Load Hosts 3-19 _ Finally check the DECrouter 2000 system by issuing a few NCP commands. Refer to Sections 3.3.1 to 3.3.3 for details. When you check the load host installation, you can con- firm that: _ The correct files are in the correct directory. _ The entry for the DECrouter 2000 in the database is correct. _ The down-line load has worked. When you run the ICP, you can check the DECrouter 2000 installation. When you check the DECrouter 2000 system, you can con- firm that: _ The correct version of the software is running on the DECrouter 2000. _ The hardware unit works with the DECrouter 2000 soft- ware. 3.3.1 Loading the Software First enable event logging on the load host by issu- ing the following commands: $ REPLY/ENABLE=NETWORK $ RUN SYS$SYSTEM:NCP NCP>SET LOGGING MONITOR EVENT 0.3,7 NCP>SET LOGGING MONITOR EVENT 225.0 NCP>SET LOGGING MONITOR STATE ON Then down-line load the DECrouter 2000 software image on to the hardware unit by plugging the unit into the power supply. As the hardware unit comes up, it goes through a series of diagnostic checks and then auto- matically requests the down-line load of the software image from the load host. Once the load is complete, 3-20 DECrouter 2000 Installation Procedures the display on the rear of the hardware unit will dis- play a moving pattern which indicates that the soft- ware is running. The DECrouter 2000 then attempts to down-line load the permanent configuration database created by ROUSETUP. When loading the software, the DECrouter 2000 will try for 5 minutes to load the permanent database, and then reboots if the database cannot be loaded. If no errors are reported, you can assume that the load has been successful. You can ensure that the load file and the permanent database have loaded correctly by check- ing for 0.3 events. For example: %%%%%%%%%%% OPCOM 19-JAN-1989 17:53:52.20 %%%%%%%%%%% (from node KANGA at 19-JAN-1989 17:53:42.15) Message from user DECNET on KANGA DECnet event 0.3, automatic line service From node 12.53 (KANGA), 19-JAN-1989 17:53:42.12 Circuit UNA-0, Load, Requested, Node = 12.541 (ROO) File = MOM$LOAD:ROO011.SYS, Operating system Ethernet address = 08-00-2B-04-4D-C7 %%%%%%%%%%% OPCOM 19-JAN-1989 17:54:23.15 %%%%%%%%%%% (from node KANGA at 19-JAN-1989 17:54:23.63) Message from user DECNET on KANGA DECnet event 0.3, automatic line service From node 12.313 (KANGA), 19-JAN-1989 17:54:23.61 Circuit UNA-0, Load, Successful, Node = 12.541 (ROO) File = MOM$LOAD:ROO011.SYS, Operating system Ethernet address = 08-00-2B-04-4D-C7 %%%%%%%%%%% OPCOM 19-JAN-1989 18:31:26.02 %%%%%%%%%%% (from node KANGA at 19-JAN-1989 18:31:15.99) Message from user DECNET on KANGA DECnet event 0.3, automatic line service From node 12.53 (KANGA), 19-JAN-1989 18:31:15.98 Circuit UNA-0, Load, Requested, Node = 12.541 (ROO) File = MOM$LOAD:ROUROO, Operating system, Ethernet address=AA-00-04-00-1D-AA Configuring the Databases for VMS Load Hosts 3-21 %%%%%%%%%%% OPCOM 19-JAN-1989 18:31:34.07 %%%%%%%%%%% (from node KANGA at 19-JAN-1989 18:31:24.05) Message from user DECNET on KANGA DECnet event 0.3, automatic line service From node 12.53 (KANGA), 19-JAN-1989 18:31:24.03 Circuit UNA-0, Load, Successful, Node = 12.541 (ROO) File = MOM$LOAD:ROUROO, Operating system, Ethernet address=AA-00-04-00-1D-AA The following messages are examples of unsuccessful at- tempts to load the DECrouter 2000 and the permanent database. %%%%%%%%%%% OPCOM 19-JAN-1989 18:31:06.02 %%%%%%%%%%% (from node KANGA at 19-JAN-1989 18:30:55.99) Message from user DECNET on KANGA DECnet event 0.3, automatic line service From node 12.53 (KANGA), 19-JAN-1989 18:30:55.98 Circuit UNA-0, Load, Line communication error %SYSTEM-F-TIMEOUT, device timeout Node = 12.541 (ROO), File = MOM$LOAD:ROO011.SYS Operating system, Ethernet address = 08-00-2B-04-4D-C7 %%%%%%%%%%% OPCOM 19-JAN-1989 18:31:26.82 %%%%%%%%%%% (from node KANGA at 19-JAN-1989 18:31:16.79) Message from user DECNET on KANGA DECnet event 225.0 From node 12.541 (ROO), 19-JAN-1989 18:31:15.54 Error in Permanent Database Configuration, Executor Node [-6, 3999] %%%%%%%%%%% OPCOM 19-JAN-1989 18:31:27.27 %%%%%%%%%%% (from node KANGA at 19-JAN-1989 18:31:16.82) Message from user DECNET on KANGA DECnet event 225.0 From node 12.541 (ROO), 19-JAN-1989 18:31:15.94 Error in Permanent Database Configuration, Circuit ETHERNET [-22, 901] If these events are logged, correct the problem, and try to reload the software. This may mean that you have to re-run the ROUCONFIG and/or ROUSETUP procedures. If load problems still occur, check that the hardware is working correctly. 3-22 DECrouter 2000 Installation Procedures If the hardware is working correctly, the problem is probably due to the load host. Check the load host database and make sure that you have entered the correct Ethernet address for the DECrouter 2000. Check that the DECrouter 2000 images are in the correct directory and that DECnet is running. Check for any event messages. Refer to the DECrouter 2000 Problem Solving Guide for full details of how to solve problems that may occur when using the DECrouter 2000 software and the hardware unit. 3.3.2 Running the ICP You can use the ICP at any time to check that the in- stallation has worked correctly. Run the ICP by issu- ing the following command: $ @MOM$LOAD:ROU_node name.ICP where node name is the name of the DECrouter 2000. The following message is displayed: DECrouter 2000 installation checkout procedure for node node name This procedure will check that the installation of the DECrouter 2000 node name completed successfully. If the ICP completes with no problems, the following message is displayed: %ROU-S-SUCCESS, node name installation checkout procedure successful. If the ICP fails, you will see an NCP message which in- dicates why the ICP has failed. For example: %NCP-F-CONNEC, unable to connect to listener SYSTEM-F-UNREACHABLE, remote node is not currently reachable followed by: %ROU-F-FAILED, node name installation checkout procedure failed. Configuring the Databases for VMS Load Hosts 3-23 Correct the problem shown in the NCP message and re- run the ICP. 3.3.3 Checking the DECrouter 2000 System Installation Issue the following NCP commands in order to check that the DECrouter 2000 system is working correctly. 1.Issue the SET EXECUTOR NODE command to specify the DECrouter 2000 as the executor node. For example: NCP>SET EXECUTOR NODE KOALA USER username - _PASSWORD password where username and password are the username and pass- word that you have specified for the NML object in ROUSETUP.COM. 2.Use the SHOW EXECUTOR command to check that the DECrouter 2000 is running, and that the correct version of the software is loaded. For example: Node Volatile Summary as of 15-JAN-1989 15:38:47 Executor node = 12.54 (KOALA) State = on Identification = DECrouter 2000 V1.1 BL10 Active links = 1 3.Use the SHOW KNOWN CIRCUITS command to check that the circuits are working correctly. For example: Known Circuit Volatile Status as of 15-JAN-1989 15:39:04 Circuit State Loopback Adjacent Block Name Node Size SYN-0 on 12.5 (KANGA) 576 SYN-1 on -starting ETHERNET on 12.22 (ROO) 576 12.23 (POSSUM) 576 4.Issue the CLEAR EXECUTOR NODE command to return to your VAX/VMS node. 3-24 DECrouter 2000 Installation Procedures ______________________________________________________4 Installation Procedures for ULTRIX This chapter explains how to install the DECrouter 2000 software on to an ULTRIX load host. During the instal- lation you will need to provide the information that you supplied in Table 1-3. 4.1 Installing the DECrouter 2000 Software To install the DECrouter 2000 software, carry out the following procedure: Log in to the system as superuser. Check that the disk has enough free space for the DECrouter 2000 image and configuration file to be installed. Remember to include enough space for up-line dumps from the DECrouter 2000. Refer to Table 1-1 for details of how much free disk space you need on your system to install the DECrouter 2000 software. To install DECrouter 2000 you have to have a mop_mom process running. Check that it is running by issuing the command: ps -x Installation Procedures for ULTRIX 4-1 and looking for /etc/mop_mom If you do not have a mop_mom process running then start it by issuing the command: /etc/mop_mom Next, issue the following command: cd /usr/lib/dnet Execute the following command to copy all the files from the distribution medium to the disk: setld -l /dev/device See the ULTRIX-32 Programmer's Manual for a complete description of the setld command. 4.2 Tailoring the Installation Configure your DECrouter 2000 into the load host's database. Execute the command procedure called rouconfig which is in the /usr/lib/dnet directory. If you have already executed this procedure from previous installations, you only need to configure any additional DECrouter units. All previously defined DECrouter units will still be configured within the load host's database. Refer to Chapter 3 of the DECrouter 2000 Installation Procedures for further details. Set up the DECrouter 2000 permanent database before pow- ering up the hardware. Execute the command procedure called rousetup which is in the /usr/lib/dnet direc- tory. If you wish to modify the DECrouter 2000 database for your specific networking requirements, execute the rouperm program which is in the /usr/lib/dnet. This program is described in the DECrouter 2000 Management Guide. 4-2 DECrouter 2000 Installation Procedures The release notes for the DECrouter 2000 are in a file called rou011.release_notes in the /usr/lib/dnet di- rectory. To print the Release Notes issue the lpr com- mand and specify the release notes file (rou011.release_ notes). While reading the Release Notes, check for any issues that are likely to affect the operation of the DECrouter software. Refer to Appendix C for a list of the files contained in the DECrouter 2000 distribution software. 4.3 Installing on Multiple Load Hosts You are advised to install the DECrouter 2000 software on to at least one other load host. The second load host can down-line load the software to the DECrouter 2000 if the first load host is not available. The second load host can also be used to receive up-line dumps from the DECrouter 2000. You can use any ULTRIX Phase IV DECnet node as a load host provided the node is connected to the same Ethernet as the hardware unit and is running at least V2.2 of ULTRIX. To install the DECrouter 2000 software on to more than one load host, repeat the installation procedure given in Section 4.1. Installation Procedures for ULTRIX 4-3 ______________________________________________________5 Configuring the Databases for ULTRIX Load Hosts This chapter describes the configuration procedure for: _ The ULTRIX load host database _ The DECrouter 2000 permanent database The chapter also explains how to load the DECrouter 2000. The load host database contains information on the DECrouter 2000s that are to use the load host for down-line load- ing the DECrouter 2000 software. You need to config- ure the database before you can down-line load the DECrouter software. The DECrouter 2000 permanent database contains the in- formation required for the DECrouter 2000 to communi- cate with other nodes in the network. After you have installed the software on to the load host, you should first run the shell script rouconfig to set up the load host database, and then run the shell script rousetup to set up the DECrouter 2000's perma- nent database. Refer to Section 5.1 for details of roucon- fig; refer to Section 5.2 for details of rousetup. Configuring the Databases for ULTRIX Load Hosts 5-1 NOTE You must not load the DECrouter 2000 until you have run these two com- mand procedures. Refer to Section 5.3 for details of how to load the DECrouter 2000. 5.1 Configuring the Load Host Database This configuration process is controlled by a menu-driven procedure called rouconfig which allows you to define, modify and delete entries about DECrouters in the load host's database. The rouconfig file is copied to your system during the installation procedure. The rouconfig script allows you to: _ List the DECrouters defined in the load host database. _ Add an entry for a new DECrouter in the load host database which will identify the DECrouter on the Ethernet. _ Swap an existing DECrouter for a new one. If you swap a DECrouter, all the original DECrouter character- istics are retained, but the Ethernet address of the new unit is added to the database. _ Delete an entry for a DECrouter from the load host database. When you delete an entry, the load host no longer recognizes the DECrouter, so is no longer a load host for that DECrouter. Database entries are deleted when the network is reconfigured or when you assign a DECrouter to another load host. 5-2 DECrouter 2000 Installation Procedures _ Restore existing DECrouters to your DECnet load database. This copies DECrouter entries from the load host database to the DECnet load database, so reconfiguring the DECnet load database. This is useful when you copy your local DECnet database from a central DECnet database which does not contain entries for the DECrouters. rouconfig modifies the following databases: 1.The load host database (containing information about the DECrouters) which is displayed when you select the List option from the menu. This database is stored in the file called rouconfig.dat. 2.The volatile DECnet load host database. 3.The permanent DECnet load host database. When running the rouconfig script, information is some- times transferred from the load host database to the DECnet database. rouconfig keeps these two databases synchronized. rouconfig enables the service circuit that will be used to down-line load the DECrouter software from the load host to the DECrouter. 5.1.1 Preparation for the Configuration Procedure Before you run the rouconfig script, perform the fol- lowing checks: 1.Ensure that DECnet is running on your load host node, and that ncp (the Network Control Program) has been installed. 2.Ensure that you know the DECnet node name and DECnet node address for each DECrouter you want to add to the database. The DECnet node name and address can be found on the configuration card on the front of the hardware unit and in Table 1-3 in this manual. Configuring the Databases for ULTRIX Load Hosts 5-3 3.Ensure that you know the Ethernet address of each DECrouter you want to add to the database. The Ethernet address can be found on the back of the hardware unit, on the configuration card) on the front of the hard- ware unit and in Table 1-3 in this manual. 5.1.2 Running rouconfig rouconfig is an interactive menu-driven procedure. When the menu is displayed, select an option and enter . You can obtain HELP by entering a ?. When you have fin- ished answering the questions on a selected option, the program returns you to the menu. If you want to exit from an option without making any changes, enter 6 and the program returns you to the menu. Enter to exit from the procedure. If you have selected the Add, Delete or Swap options, ncp messages may be displayed when you have completed the option. If an error message is displayed, the op- eration may not have been successful. Therefore you should repeat the operation. To run rouconfig, the software must already be installed on the load host. Log in as superuser, and enter the following commands: cd /usr/lib/dnet ./rouconfig rouconfig checks that DECnet is running. If DECnet is down, a warning message is displayed and the procedure exits. If this happens, start DECnet before running the script again. You are first reminded that each DECrouter must have a unique DECnet node name and DECnet node address. The procedure asks if you want to continue or exit as fol- lows: 5-4 DECrouter 2000 Installation Procedures Press to start, or e to exit. If you press , rouconfig displays the following: DECrouter Configuration Procedure Menu of Options 1 - List known DECrouters 2 - Add a DECrouter 3 - Swap an existing DECrouter 4 - Delete an existing DECrouter 5 - Restore existing DECrouters 6 - Exit from this procedure Your choice: Select the number that corresponds to the option you want and press . Sections 5.1.2.1 to 5.1.2.5 de- scribe the options. 5.1.2.1 List Known DECrouters (Option 1) If you select this option, the contents of the roucon- fig.dat file is displayed as seven columns. For exam- ple: DECnet DECnet Router Service Address Node Type Circuit Ethernet Address Load File Dump File ------- ------ ------ ------- ---------------- --------- --------- 12.1001 KANGA DR2000 UNA-0 08-00-2B-02-CC-24 rou011.sys ROUKANGA.DMP 12.1002 KOALA DR2000 UNA-0 08-00-2B-02-AA-23 rou011.sys ROUKOALA.DMP Total of 2 DECrouter(s) defined. (Press RETURN for menu) The display shows information about the load host database including the names of the load and dump files used by the database. Configuring the Databases for ULTRIX Load Hosts 5-5 A DECrouter dumps its memory into a DECrouter dump file either as a result of a failure or in response to a re- quest by the network manager. This file can be used for diagnosing any problems that may arise when using a DECrouter. If a DECrouter repeatedly crashes and an up-line dump is produced, copy the dump to a suitable form of me- dia and send it with a Software Performance Report (SPR) to DIGITAL. Refer to the DECrouter 2000 Problem Solving Guide for details on how to submit an SPR. The naming convention used for the load and dump files is as follows: rou011.sys rourouter.DMP where router is the node name of the DECrouter. 5.1.2.2 Add a DECrouter (Option 2) If you select this option, you can add a new entry to the load host database. When you define a new entry you must supply: 1.The DECrouter type 2.A unique DECnet node name for the DECrouter 2000 3.A unique DECnet node address for the DECrouter 2000 4.The Ethernet address of the DECrouter 5.The name of the load host's service circuit which will be used to down-line load the DECrouter 2000 The DECrouter 2000's DECnet node name and address, its Ethernet address and the name of the load host's ser- vice circuit can be found in Table 1-3 in this manual. You will be prompted to supply the above information as follows: DECrouter type (DR200, DR2000): 5-6 DECrouter 2000 Installation Procedures Specify DR2000 for a DECrouter 2000, which allows you to use up to four synchronous lines. If you specify DR200, you can use the DECrouter 200 which has up to eight asyn- chronous lines. Refer to the DECrouter 200 documenta- tion for details of this product. DECnet node name for unit: Specify the DECnet node name for the DECrouter. This node name consists of up to six alphanumeric charac- ters (one of which must be a letter). The name must be unique for your DECnet network. DECnet node address for unit: Specify the DECnet node address for the DECrouter. This is a decimal number from 1 to 1023 and must be unique for your DECnet network. If your network is divided into areas, include the area number within the address (the area address is inserted in front of the node address). For example, if an address is 12.1001, 12 is the area number and 1001 is the node number. If you omit the area number, the area number of the current load host is used as a default. Ethernet address for unit (nn-nn-nn-nn-nn-nn): Specify the Ethernet address of the DECrouter. This ad- dress is situated on the configuration card) which is on the front of the hardware unit. If the address is not on the card, it can be found on a label on the back of the hardware unit. Enter the Ethernet address as six pairs of hexadecimal digits, with a hyphen separating each pair. For example: 08-00-2B-02-AA-23. DECnet Service Circuit-ID [default-id]: Specify the service circuit for your load host's Ethernet controller type as follows: _ UNA-n for DEUNA or DELUA _ QNA-n for DEQNA, DELQA or DESQA Configuring the Databases for ULTRIX Load Hosts 5-7 _ BNT-n for DEBNT _ BNA-n for DEBNA _ SVA-n for DESVA were n is an integer. Whenever you run this configuration procedure, you will be asked for the service circuit-ID. The first time you are asked for the circuit-ID, the default response will be determined by the processor type of the ULTRIX load host. If you specify a different service circuit-ID, this new circuit-ID becomes the new default. Once you have specified the service circuit-ID, roucon- fig adds the new entry to the database, and sets SERVICE ENABLED on the circuit. This will allow the load host to down-line load the DECrouter software image to the DECrouter. NOTE When rouconfig sets SERVICE ENABLED on the circuit, the circuit may be turned off and then turned on again which may cause events to be logged. If a DECnet ncp error message is displayed while you are adding a DECrouter to the database, the entry will be added to the rouconfig.dat file, but will not be added to the DECnet database. Therefore, you should immedi- ately use Option 4 to delete the entry, locate and cor- rect the condition that is responsible for the DECnet error, and return to Option 2 to add the entry again. If you specify a node address that is already defined in the database, a rouconfig error is displayed, noth- ing is added to the database and the Add option is ex- ited. 5-8 DECrouter 2000 Installation Procedures 5.1.2.3 Swap an Existing DECrouter (Option 3) If you select this option, you can swap an existing DECrouter for a new hardware unit. You need only specify the Ethernet address of the new unit. All the other characteristics of the original unit are retained in the database. The procedure displays the following message: If you use this option, and you have more than one load host for the DECrouter, you must modify the database for each load host. To do this, execute ROUCONFIG on each load host, and select the SWAP option. The procedure asks: What is the node name of the DECrouter you want to swap: Specify the node name of the existing DECrouter that you want to replace. The configuration procedure dis- plays the Ethernet address of the old unit and asks the following question: DECrouter node-name at Ethernet address nn-nn-nn-nn-nn-nn is being swapped. Enter the Ethernet address of the new DECrouter to replace node-name. Specify the Ethernet address of the new unit. This ad- dress is situated on the configuration card) which is on the front of the hardware unit. If the address is not the card, it can be found on a label on the back of the hardware unit. Enter the Ethernet address as six pairs of hexadecimal digits, with a hyphen separating each pair. Configuring the Databases for ULTRIX Load Hosts 5-9 5.1.2.4 Delete an Existing DECrouter (Option 4) If you select this option, you can delete a DECrouter from the database. Deleting is used when you reconfig- ure the network or change the load hosts. rouconfig prompts you for the name of the DECrouter as follows: Enter the DECnet node name of the DECrouter you want to delete, or press 6 to return to menu: Specify the DECnet node name of the DECrouter you want to delete. The procedure checks that there is an en- try for the specified node name in the database, and removes the entry and returns you to the menu. If the entry does not exist, rouconfig informs you about this, and returns you to the menu. 5.1.2.5 Restoring Existing DECrouters (Option 5) If you select this option, you can restore to your load host's DECnet node database all the DECrouters you have defined using rouconfig. The restore option affects both the volatile and permanent DECnet databases. The following messages confirm that the configurations have been restored: Restoring existing DECrouters from local database. Local database successfully restored. NOTE It is recommended that all DECrouter 2000s running V1.0 be reconfigured with V1.1 software so that the next time they are down-line loaded, there will not be a need for the V1.0 soft- ware. 5-10 DECrouter 2000 Installation Procedures 5.2 Configuring the DECrouter 2000's Permanent Database The DECrouter 2000's permanent database is configured by running the shell script called rousetup. Usually, running this command procedure is all you need to do to set up the permanent database. If you wish to tailor the database to your specific net- working requirements, you should run the rouperm pro- gram which is documented in the DECrouter 2000 Management Guide. The rousetup configuration script consists of a series of questions which allow you to set up the following in the DECrouter 2000's permanent database: _ The node name _ The type of routing node _ The access control strings required to protect the database _ The lines used with their associated parameters _ The circuits used with their associated parameters rousetup is an interactive procedure. You simply sup- ply the information requested by the displayed ques- tion. You can obtain HELP by entering a ?, and you can exit from the procedure by entering . To run rousetup, the software must already be installed on the system. NOTE If you have a DECrouter 2000 con- figured with V1.0 software and you want to run a high speed line, then you must delete the existing router first. Do this by running ROUCONFIG Configuring the Databases for ULTRIX Load Hosts 5-11 and then reconfigure the DECrouter 2000 with the V1.1 software. 5.2.1 Running rousetup Log in as superuser and enter the following command: ./usr/lib/dnet/rousetup The procedure starts by displaying the following mes- sage: This shell script sets up the permanent database for the DECrouter 2000. Usually, executing this script is all you need to do to set up the database. The script consists of a series of questions. If you need help with answering a question, enter ? as a response and the HELP text will be displayed. The procedure first asks you for the node name of the DECrouter 2000. DECrouter 2000 node name: Enter the node name of the DECrouter 2000. The DECnet node name for your DECrouter 2000 consists of from 1 to 6 alphanumeric characters, one of which must be al- phabetic. This name identifies the DECrouter within the network. You are then asked whether you are running the DECrouter 2000 on a DEMSA or a DEMSB. DECrouter 2000 type [DEMSA, DEMSB] If you answer DEMSA, the procedure asks what type of router you want the DECrouter 2000 to be set up as. Do you want node-name to be an AREA router [NO]: 5-12 DECrouter 2000 Installation Procedures A DECrouter 2000 can be either an AREA (Level 2) router or a ROUTING IV (Level 1) router. An AREA router can forward packets from one area within a network to another area. A ROUTING IV router can only forward packets within its own area. The procedure then asks you about the Ethernet circuit cost to be used with the DECrouter 2000. Ethernet circuit cost [4]: Specify a value in the range 1 to 63. The cost is a value assigned to a circuit between two adjacent nodes. Packets are routed along paths with the smallest cost. You are now asked about the router priority for the DECrouter 2000. Router priority [64]: Specify a value in the range 1 to 127. The router with the highest priority will become the designated router for the Ethernet. If you are running DECrouter 2000 on a DEMSA, you are then asked about the number of lines that you want to use with the DECrouter 2000. The procedure displays the following: The DECrouter 2000 supports the following combinations of lines, line speeds and ports. Specify the type you require. Type Number of lines Maximum speed Ports (bits per second) 1 4 64K 0, 1, 2, 3 2 2 256K 0, 1 3 1 2.084M 0 Type [1]: Configuring the Databases for ULTRIX Load Hosts 5-13 The type specifies how you are going to use the DECrouter 2000. The DECrouter 2000 can support three types of op- eration. Each type has certain lines, line speeds and ports associated with it. For speeds of up to 64K bits per second for each line, specify type 1. For speeds of up to 256K bits per second for each line, specify type 2. For speeds of up to 2.084M bits per second spec- ify type 3. The procedure then displays how the DECrouter 2000 will be configured. If you have a DEMSA the following will be displayed: node-name will be configured as a ROUTING IV router with 4 lines each capable of operating at speeds up to 64 Kb If you have a microsDEMSB, the following will be dis- played: node-name will be configured as a ROUTING IV router with 1 line capable of operating at a speed of 19.2Kb. You are then prompted for the following information about the lines you have set up: _ The line name. The default line name is SYN-n where n is the port on the hardware that the line uses. For example: Line 1 name [SYN-1]: If you do not use the default, you should specify a string of between 1 and 16 characters for the line name. _ The line state. The default line state is ON. For example: Line line-name state [ON]: The status of the line can be ON or OFF. 5-14 DECrouter 2000 Installation Procedures _ The name of the circuit associated with the line. The default circuit name is the same as the line name. For example: Name of circuit associated with line line-name [linename]: If you do not use the default, you should specify a string of between 1 and 16 characters for the cir- cuit name. _ The state of the circuit. The default circuit state is ON. For example: Circuit circuit-name state [ON]: The status of the circuit can be ON or OFF. _ The cost for the circuit. The default value is 5. For example: Circuit circuit-name cost [5]: Specify a value between 1 and 63 for the circuit cost. The cost is a value assigned to a circuit between two adjacent nodes. Packets are routed on paths with the least cost. You will now be asked about the access control infor- mation which will be used to control who can alter the database and who can use the TRACE utility from a VMS node (if installed). For each set of information, spec- ify a username and password. The username and password each consist of 1-16 alphanumeric or punctuation char- acters. You will be asked to verify your entry for the password. NOTE You are strongly advised to set up a username and password for the NML object. If you do not do so, any user within the network can mod- ify your DECrouter 2000. Configuring the Databases for ULTRIX Load Hosts 5-15 Enter the username and password to be used to control access to the DECrouter. This information must be supplied whenever the lines and circuits on the DECrouter 2000 are being modified. If this information is not specified, anyone can modify the DECrouter 2000. NML Username [NONE]: NML Password: Verification: Remember what you have specified for the username and password, as you will need to supply the information in order make future modifications to the DECrouter 2000 database. The procedure then asks about the username and password for the TRACE utility. NOTE You are strongly advised to set up a username and password for the TRACE utility. If you do not do so, any user within the network with TRACE installed on their VMS node can mon- itor the traffic on your DECrouter 2000. Enter the username and password to be used for the TRACE utility. This information must be supplied when using the VMS TRACE utility on the DECrouter 2000. If this information is not specified, anyone can monitor traffic on the DECrouter 2000. TRACE Username [NONE]: TRACE Password: Verification: Remember what you have specified for the username and password, as you will need to supply the information when you use the TRACE utility from a VMS system. Once you have supplied all the required information, the procedure checks for an existing configuration file. If there is already a file for this DECrouter node, the following is displayed: 5-16 DECrouter 2000 Installation Procedures A configuration file for node-name already exists. Do you want to create another [YES]: If you answer YES, the old file will be saved in the /usr/lib/dnet directory. The procedure then displays the following message: The following commands will be executed to create the permanent database: The procedure then lists the commands it will use to create the permanent database and then asks: Do you want these commands to be executed [YES]: Answer YES, and the permanent database will be created for you. If you answer NO, you should re-run the rousetup script in order to create the permanent database. 5.3 Loading the Software and Checking the Installation There are two stages in checking the installation. First you should check the load host installation by down- line loading the DECrouter software image, and then you should check the DECrouter system by issuing a few ncp commands. Refer to Sections 5.3.1 and 5.3.2 for details. When you check the load host installation, you can con- firm that: _ The correct files are in the correct directory. _ The entry for the DECrouter in the database is cor- rect. _ The down-line load has worked. When you check the DECrouter system, you can confirm that: _ The correct version of the software is running on the DECrouter. Configuring the Databases for ULTRIX Load Hosts 5-17 _ The hardware unit works with the DECrouter software. 5.3.1 Loading the Software Down-line load the DECrouter software image on to the hardware unit by plugging the unit into the power sup- ply. As the hardware unit comes up, it goes through a series of diagnostic checks and then automatically re- quests the down-line load of the software image from the load host. Once the load is complete, the display on the rear of the hardware unit will display a mov- ing pattern which indicates that the software is run- ning. The DECrouter 2000 then attempts to down-line load the permanent configuration database created by rousetup. When loading the software, the DECrouter 2000 will try for 5 minutes seconds to load the permanent database, and then reboots if the database cannot be loaded. If there are problems with loading the software, you may have to re-run the rouconfig and/or rousetup scripts. If load problems still occur, check that the hardware is working correctly. Refer to the DECrouter 2000 Problem Solving Guide for details. If the hardware is working correctly, the problem is probably due to the load host. Check the load host database and make sure that you have entered the correct Ethernet address for the DECrouter. Check that the DECrouter im- ages are in the correct directory and that DECnet is running. 5-18 DECrouter 2000 Installation Procedures 5.3.2 Checking the DECrouter 2000 System Installation Issue the following ncp commands in order to check that the DECrouter system is working correctly. 1.Issue the set executor node command to specify the DECrouter as the executor node. For example: ncp>set executor node koala user username password password where username and password are the username and pass- word that you have specified for the NML object in rousetup. 2.Use the show executor command to check that the DECrouter is running, and that the correct version of the soft- ware is loaded. For example: Node Volatile Summary as of 15-JAN-1989 20:38:47 Executor node = 12.54 (KOALA) State = on Identification = DECrouter 2000 V1.1 BL4 Active links = 1 3.Use the show known circuits command to check that the circuits are working correctly. For example: Known Circuit Volatile Status as of 15-JAN-1989 15:39:04 Circuit State Loopback Adjacent Block Name Node Size BEAN on 12.5 (KANGA) 576 ETHERNET on 12.22 (ROO) 576 12.23 (POSSUM) 576 PEA on -starting 4.Issue the clear executor node command to return to your ULTRIX node. Configuring the Databases for ULTRIX Load Hosts 5-19 ______________________________________________________A Example VMS Installation and Configuration $@sys$update:vmsinstal rou011 mua0: VAX/VMS Software Product Installation Procedure V5.0 It is 23-JAN-1989 at 17:34. Enter a question mark (?) at any time for help. %VMSINSTAL-W-DECNET, Your DECnet network is up and running. * Do you want to continue anyway [NO]? y * Are you satisfied with the backup of your system disk [YES]? Please mount the first volume of the set on MUA0:. * Are you ready? y %MOUNT-I-MOUNTED, ROU mounted on POSSUM$MUA0: The following products will be processed: ROU V1.1 Beginning installation of ROU V1.1 at 17:36 %VMSINSTAL-I-RESTORE, Restoring product saveset A... Release Notes Options: 1. Display release notes 2. Print release notes 3. Both 1 and 2 4. Copy release notes to SYS$HELP 5. Do not display, print or copy release notes * Select option [3]: 4 * Do you want to continue the installation [N]? VMSINSTAL procedure done at 17:40 %VMSINSTAL-I-RELMOVED, The product release notes have been successfully moved to SYS$HELP. Example VMS Installation and Configuration A-1 $@sys$update:vmsinstal rou011 mua0: * Do you want to purge files replaced by this installation [YES]? y * Do you want the TRACE utility [YES]? y %CREATE-I-EXISTS, VMI$ROOT:[DECSERVER] already exists %LIBRAR-S-REPLACED, module TRACE replaced in VMI$ROOT:[SYSHLP]HELPLIB.HLB;2 The system logical MOM$LOAD is already defined as POSSUM:[SYS7.SYSROOT.][MOM$SYSTEM] To load the DECrouter 2000, MOM$LOAD should be redefined as: POSSUM:[SYS7.SYSROOT.][MOM$SYSTEM],SYS$SYSROOT:[DECSERVER] * Do you want to redefine this now [YES]? The installation is now complete. After exiting from VMSINSTAL, do the following: 1. If the definition for MOM$LOAD in the site- specific system start-up file does not contain SYS$SYSROOT:[DECSERVER], you must edit your site-specific system start-up file so that it defines the logical MOM$LOAD as a search string with a value equal to itself and the element SYS$SYSROOT:[DECSERVER]. For example: DEFINE/SYSTEM/EXEC/NAME_ATTRIBUTE=NO_ALIAS/NOLOG MOM$LOAD - "current-search-string",SYS$SYSROOT:[DECSERVER] This command allows the location of the DECrouter image to be defined each time the system is rebooted, so the system will load correctly. 2. Configure your DECrouter 2000 into the load host's database. Execute the command procedure called ROUCONFIG.COM which is in the SYS$SYSROOT:[DECSERVER] directory. If you have already executed this procedure from previous installations, you only need to configure any additional DECrouter units. All previously defined DECrouter units will still be configured within the load host's database. Refer to Chapter 3 of the DECrouter 2000 Installation Procedures for further details. 3. Set up the DECrouter 2000 permanent database before powering up the hardware. Execute the command procedure called ROUSETUP.COM which is in the SYS$SYSROOT:[DECSERVER] directory. ROUSETUP.COM generates an ICP which checks that the DECrouter 2000 is fully operational. Refer to Chapter 3 of the DECrouter 2000 Installation Procedures for further details. A-2 DECrouter 2000 Installation Procedures If you wish to modify the DECrouter 2000 database for your specific networking requirements, execute the ROUPERM.EXE program which is in the SYS$SYSTEM directory. This program is described in the DECrouter 2000 Management Guide. 4. REMINDER: The release notes for the DECrouter 2000 are in a file called ROU011.RELEASE_NOTES which is in the SYS$SYSROOT:[DECSERVER] directory. 5. A command file SYS$MANAGER:NETTRACE_INSTALL.COM has been created to install the TRACE utility. Edit your system site- specific start-up file to execute this file each time your system is booted. %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories.. Installation of ROU V1.1 completed at 17:41 VMSINSTAL procedure done at 17:41 $@sys$sysroot:[decserver]rouconfig You must assign a unique DECnet node name and DECnet node address for each DECrouter that you are going to configure. If at any time, you specify a node name or node address that has already been defined within the network, the previous definition will be replaced by what you have specified for the DECrouter. Enter to start, or CTRL/Z to exit. DECrouter Configuration Procedure Menu of Options 1 - List known DECrouters 2 - Add a DECrouter 3 - Swap an existing DECrouter 4 - Delete an existing DECrouter 5 - Restore existing DECrouters CTRL/Z - Exit from this procedure Your choice: 1 DECnet DECnet Router Service Ethernet Address Node Type Circuit Address Load File Dump File ------- ------ ------ ------- -------- --------- - --------- Total of 0 DECrouters defined. (Press RETURN for menu) Example VMS Installation and Configuration A-3 DECrouter Configuration Procedure Menu of Options 1 - List known DECrouters 2 - Add a DECrouter 3 - Swap an existing DECrouter 4 - Delete an existing DECrouter 5 - Restore existing DECrouters CTRL/Z - Exit from this procedure Your choice: 2 Enter ? if you require help, enter CTRL/Z to return to menu without adding a unit to the database. DECrouter type (DR200, DR2000, X25ROU): dr2000 DECnet node name for unit: koala DECnet node address for unit: 12.999 Ethernet address for unit (nn-nn-nn-nn-nn-nn): 08- 00-2b-03-11-22 DECnet Service Circuit-ID [QNA-0]: If you get an error message now, the new unit will not be added to the database, and you should delete the entry from the directory using the delete option. DECrouter Configuration Procedure Menu of Options 1 - List known DECrouters 2 - Add a DECrouter 3 - Swap an existing DECrouter 4 - Delete an existing DECrouter 5 - Restore existing DECrouters CTRL/Z - Exit from this procedure Your choice: 1 DECnet DECnet Router Service Address Node Type Circuit Ethernet Address Load File Dump File ------- ------ ------ ------- ---------------- -- ------- --------- 12.999 TOM DR2000 QNA-0 08-00-2b-03-11-22 ROU011.SYS ROUTOM.DMP Total of 1 DECrouters defined. DECrouter Configuration Procedure Menu of Options A-4 DECrouter 2000 Installation Procedures 1 - List known DECrouters 2 - Add a DECrouter 3 - Swap an existing DECrouter 4 - Delete an existing DECrouter 5 - Restore existing DECrouters CTRL/Z - Exit from this procedure Your choice: ^z $@sys$sysroot:[decserver]rousetup This command procedure sets up the permanent database for the DECrouter 2000. Usually, executing this procedure is all you need to do to set up the database. The procedure consists of a series of questions. If you need help with answering a question, enter ? as a response and the HELP text will be displayed. DECrouter 2000 node name: koala DECrouter 2000 type [DEMSA, DEMSB] DEMSA Do you want KOALA to be an AREA router [NO]: Ethernet circuit cost [4]: Router priority [64]: The DECrouter 2000 supports the following combinations of lines, line speeds and ports. Specify the type you require. Type Number of lines Maximum speed Ports (bits per second) 1 4 64K 0, 1, 2, 3 2 2 256K 0, 1 3 1 2.084M 0 Type [1]: KOALA will be configured as a ROUTING IV router with 4 lines each capable of operating at speeds up to 64 Kb Line 0 name [SYN-0]: l0 Line l0 default state [ON]: Name of circuit associated with line l0 [l0]: Circuit l0 default state [ON]: Circuit l0 cost [5]: Line 1 name [SYN-1]: Line SYN-1 default state [ON]: Name of circuit associated with line SYN-1 [SYN-1]: Circuit SYN-1 default state [ON]: Circuit SYN-1 cost [5]: Example VMS Installation and Configuration A-5 Line 2 name [SYN-2]: l2 Line l2 default state [ON]: Name of circuit associated with l2 [l2]: c2 Circuit c2 default state [ON]: off Circuit c2 cost [5]: Line 3 name [SYN-3]: Line SYN-3 default state [ON]: Name of circuit associated with line SYN-3 [SYN-3]: Circuit SYN-3 default state [ON]: Circuit SYN-3 cost [5]: Enter the username and password to be used to control access to the DECrouter. This information must be supplied whenever the lines and circuits on the DECrouter 2000 are being modified. If this information is not specified, anyone can modify the DECrouter 2000. NML Username [NONE]: dolphin NML Password: Verification: Enter the username and password to be used for the TRACE utility. This information must be supplied when using the TRACE utility on the DECrouter. If this information is not specified, anyone can monitor traffic on the DECrouter 2000. TRACE Username [NONE]: dolphin TRACE Password: Verification: The following commands will be executed to create the permanent database: A-6 DECrouter 2000 Installation Procedures set executor type routing iv set logging monitor event 0.0-9 set logging monitor event 2.0-1 set logging monitor event 4.2,16,19 set logging monitor event 5.0-21 set circuit ETHERNET router priority 64 set circuit ETHERNET cost 4 set line l0 device SYN-0 state on set circuit l0 line l0 state off set circuit l0 cost 5 set circuit l0 state on set line SYN-1 device SYN-1 state on set circuit SYN-1 line SYN-1 state off set circuit SYN-1 cost 5 set circuit l0 state on set line l2 device SYN-2 state on set circuit c2 line l2 state off set circuit c2 cost 5 set circuit l0 state off set line SYN-3 device SYN-3 state on set circuit SYN-3 line SYN-3 state off set circuit SYN-3 cost 5 set circuit l0 state on set object nml user dolphin password *Set* set object nettrace$ user dolphin password *Set* Do you want these commands to be executed [YES]: Generating an Installation Checkout Procedure (ICP) for the DECrouter. This is a command file that can be run at any time after both the hardware and software installation is completed. The ICP will verify that the DECrouter 2000 has been installed correctly. The ICP will be called "SYS$COMMON:[DECSERVER]ROU_ KOALA.ICP" Example VMS Installation and Configuration A-7 ______________________________________________________B Example ULTRIX Installation and Configuration # cd /usr/lib/dnet #setld -1 /dev/rmt0l Please make sure your installation tape is mounted and on- line. Ready (y/n) y Positioning tape... done. The subsets listed below are optional: ***Enter Subset Selections*** 1) DECrouter 2000 2) All of the Above 3) None of the Above Enter your choice(s): 1 You are installing the following subsets: DECrouter 2000 Is this correct (y/n)? y Copying DECrouter 2000 (ROUBASE011) from tape Verifying DECrouter 2000 (ROUBASE011) The installation is now complete. You should now do the following: Example ULTRIX Installation and Configuration B-1 1. Configure your DECrouter 2000 into the load host's database. Execute the procedure called rouconfig which is in /usr/lib/dnet/. If you have already executed this procedure from previous installations, you only need to configure any additional DECrouter units. All previously defined DECrouter units will still be configured within the load host's database. Refer to Chapter 5 of the DECrouter 2000 Installation Procedures for further details. 2. Set up the DECrouter 2000 permanent database before powering up the hardware. Execute the procedure called rousetup which is also in /usr/lib/dnet/. rousetup generates an ICP which checks that the DECrouter 2000 is fully operational. Refer to Chapter 5 of the DECrouter 2000 Installation Procedures for further details. If you wish to modify the DECrouter 2000 database for your specific networking requirements, execute rouperm which is in /usr/lib/dnet/.This program is described in the DECrouter 2000 Management Guide. 3. REMINDER: The release notes for the DECrouter 2000 are in a file called rou011.release_notes which is in /usr/lib/dnet/. csh# ./rouconfig You must assign a unique DECnet node name and DECnet node address for each new DECrouter that you are going to configure. If at any time you specify a node name or node address that has already been defined within the network, the previous definition will be replaced by what you have specified for the DECrouter. Please print/read the release notes. They are in the file /usr/lib/dnet/rou011.release_ notes Press to start or e to exit... DECrouter Configuration Procedure Menu of Options 1 - List known DECrouters 2 - Add a DECrouter 3 - Swap an existing DECrouter 4 - Delete an existing DECrouter 5 - Restore existing DECrouters B-2 DECrouter 2000 Installation Procedures 6 - Exit from this procedure Your choice: 1 There are no DECrouters defined in the data file DECrouter Configuration Procedure Menu of Options 1 - List known DECrouters 2 - Add a DECrouter 3 - Swap an existing DECrouter 4 - Delete an existing DECrouter 5 - Restore existing DECrouters 6 - Exit from this procedure Your choice: 2 Type a ? for help on a question, Type 6 for any question to return to menu without adding the unit DECrouter type (DR200, DR2000): dr2000 DECnet node name for unit: tom DECnet node address for unit: 12.999 Ethernet address for unit (nn-nn-nn-nn-nn-nn): 08- 00-2b-03-11-22 DECnet Service Circuit-ID [QNA-0]: DECrouter Configuration Procedure Menu of Options 1 - List known DECrouters 2 - Add a DECrouter 3 - Swap an existing DECrouter 4 - Delete an existing DECrouter 5 - Restore existing DECrouters 6 - Exit from this procedure Your choice: 1 Example ULTRIX Installation and Configuration B-3 DECnet DECnet Router Service Address Node Type Circuit Ethernet Address Load File Dump File ------ ----- ------ ------- ---------------- --------- --------- 12.999 TOM DR2000 QNA-0 08-00-2B-03-11-22 rou011.sys ROUTOM.DMP Total of 1 DECrouters defined. DECrouter Configuration Procedure Menu of Options 1 - List known DECrouters 2 - Add a DECrouter 3 - Swap an existing DECrouter 4 - Delete an existing DECrouter 5 - Restore existing DECrouters 6 - Exit from this procedure Your choice: 6 csh# ./rousetup This shell script sets up the permanent database for the DECrouter 2000. Usually, executing this script is all you need to do to set up the database. The script consists of a series of questions. If you need help with answering a question, enter ? as a response and the HELP text will be displayed. DECrouter 2000 node name: tom DECrouter 2000 type: [DEMSA, DEMSB] DEMSA Do you want tom to be an AREA router [NO]:yes Ethernet circuit cost [4]: Router priority [64]: The DECrouter 2000 supports the following combinations of lines, line speeds and ports. Specify the type you require. Type Number of lines Maximum speed Ports (bits per second) 1 4 64K 0, 1, 2, 3 2 2 256K 0, 1 3 1 2.084K 0 Type [1]: 2 tom will be configured as an AREA router with 2 lines each capable of operating at speeds up to 256 Kb B-4 DECrouter 2000 Installation Procedures Line 0 name [SYN-0]: l0 Line l0 default state [ON]: Name of circuit associated with line l0 [l0]: Circuit l0 default state [ON]: Circuit l0 cost [5]: Line 1 name [SYN-1]: Line SYN-1 default state [ON]: Name of circuit associated with line SYN-1 [SYN-1]: Circuit SYN-1 default state [ON]: Circuit SYN-1 cost [5]: Enter the username and password to be used to control access to the DECrouter. This information must be supplied whenever the lines and circuits on the DECrouter 2000 are being modified. If this information is not specified, anyone can modify the DECrouter 2000. NML Username [NONE]: dolphin NML Password: Verification: Enter the username and password to be used for the TRACE utility. This information must be supplied when using the VMS TRACE utility on the DECrouter 2000. If this information is not specified, anyone can monitor traffic on the DECrouter 2000. TRACE Username [NONE]: dolphin TRACE Password: Verification: The following commands will be executed to create the permanent database: set executor type area set logging monitor event 0.0-9 set logging monitor event 2.0-1 set logging monitor event 4.2,16,19 set logging monitor event 5.0-21 set circuit ETHERNET router priority 64 set circuit ETHERNET cost 4 set line l0 device SYN-0 state on set circuit l0 line l0 state off set circuit l0 cost 5 set circuit l0 state on set line SYN-1 device SYN-1 state on set circuit SYN-1 line SYN-1 state off set circuit SYN-1 cost 5 set circuit SYN-1 state on set object nml user dolphin password *set* set object nettrace$ user dolphin password *set* Example ULTRIX Installation and Configuration B-5 Do you want these commands to be executed [YES]: B-6 DECrouter 2000 Installation Procedures ______________________________________________________C Lists of Files Installed C.1 For VAX/VMS Load Hosts The following files are installed on to your VAX/VMS load host. Into the SYS$COMMON:[DECSERVER] directory: _ ROU011.SYS - the system image which is down-line loaded on to the DECrouter 2000. _ ROUSETUP.COM - the command procedure which sets up the DECrouter 2000's permanent database. _ ROUCONFIG.COM - the command procedure which sets up the load host database. _ ROU011.RELEASE_NOTES - the Release Notes. Into the SYS$SYSTEM directory: _ ROUPERM.EXE - the configurator program which is used to modify the permanent database. If you install the TRACE utility, the TRACE files are installed as follows: Into the SYS$SYSTEM directory: _ NETLTC.EXE - the local TRACE collector. Lists of Files Installed C-1 _ NETTRACE.EXE - the TRACE image. Into the SYS$HELP directory: _ TRACEHLP.HLB - the TRACE HELP file. _ ROUPERM.HLB - the HELP file for the configurator pro- gram. Into the SYS$LIBRARY directory: _ NETTRACE$KEY.INIT - the TRACE keypad _ NETTRACE$NSP_ANALYZE.EXE - the NSP protocol analyzer. _ NETTRACE$SYNC_ANALYZE.EXE - the SYNC protocol an- alyzer. _ NETTRACE$DDCMP_ANALYZE.EXE - the DDCMP protocol an- alyzer. _ NETTRACE$ROUTING_ANALYZE.EXE - the ROUTING proto- col analyzer. _ NETTRACE$ETHERNET_ANALYZE.EXE - the ETHERNET pro- tocol analyzer. Into the SYS$MANAGER directory: _ NETTRACE_INSTALL.COM - the command file which in- stalls the TRACE utility. Into the SYS$MESSAGE directory: _ NETTRACE_MESSAGES.EXE - the TRACE message file. C.2 For ULTRIX Load Hosts The following files are installed on to your ULTRIX load host in the /usr/lib/dnet directory. _ rou011.release_notes - the Release Notes. _ rou011.sys - the system image which is down-line loaded on to the DECrouter 2000. C-2 DECrouter 2000 Installation Procedures _ rouconfig - the command procedure which sets up the load host database. _ rousetup - the command procedure which sets up the DECrouter 2000's permanent database. _ rouperm - the configurator program which is used to modify the permanent database. _ rouperm_help.txt - the HELP file for the configu- rator program. Lists of Files Installed C-3 _______________________________________________________ Index A Database (cont'd.) Access control infor- creating permanent, mation, 3-13, 3-17, 3-19, 5-17 5-11, 5-15 load host, 3-3, 5-3 Add option, 3-7, 5-6 permanent DECnet, 3-3, rouconfig, 5-2 3-11, 5-3, 5-10 ROUCONFIG, 3-2 tailoring, 3-13, 5-11 Area number, 3-8, 5-7 volatile DECnet, 3-3, AREA router, 3-14, 5-13 3-11, 5-3, 5-10 DDCMP_ANALYZE.EXE, C-2 B DECnet database synchronized, Backup 3-3, 5-3 system disk, 2-2 permanent database, C 3-3, 5-3 running, 2-2, 3-4, 5-3 Circuit cost, 3-17, 5-15 volatile database, 3-3, Circuit name, 3-16, 5-15 5-3 Circuits, 3-13, 5-11 DECnet address, 1-4 Circuit state, 3-17, DECnet error, 3-9, 5-8 5-15 DECnet node address, Configuration file 3-4, 3-7, 5-3, 5-6 old, 3-18, 5-17 DECnet node name, 1-4, Controller letter, 2-2 3-4, 3-7, 5-3, 5-6 D DECrouter 200, 3-8 DECrouter 2000, 3-8, 5-7 Database add entry, 3-2, 5-2 AREA router, 3-14, 5-13 Index-1 DECrouter 2000 (cont'd.) DECrouter 2000 (cont'd.) cancel installation, number of lines used, 2-7 3-15, 5-13 configuration card, old configuration file, 1-3, 3-4, 5-3 3-18, 5-17 configuration file, permanent database, 2-1, 4-1 3-1, 3-12, 5-1, 5-11 configuring database, privileges for 3-12 to 3-19, 5-11 installation, 2-1, to 5-17 4-1 crashes, 3-7, 5-6 reinstalling, 2-7 DECnet address, 1-4 restore, 3-3 DECnet node name, 1-4 restore option, 5-3 delete option, 3-3, 5-2 ROUTING IV router, diagnostic checks, 3-14, 5-13 3-20, 5-18 software image, 1-1 distribution kits, 1-3 swap option, 3-2, 5-2 down-line loading, 1-1, tailoring installation, 2-9, 3-19, 3-20, 4-3, 2-5 5-17 type, 3-7, 3-15, 5-6, ethernet address, 1-4, 5-14 3-4, 5-4 up-line dumps, 1-1, hardware, 1-4 2-9, 4-3 image, 2-1, 4-1 VAXcluster, 2-10 level 1 router, 3-14, DECrouter 2000 database 5-13 rousetup, 5-1 level 2 router, 3-14, ROUSETUP, 3-1 5-13 DECrouter type, 3-8, 5-7 list option, 3-2, 5-2 Delete option, 3-9, load host, 1-1, 2-1, 3-11, 5-8, 5-10 2-9, 4-3 rouconfig, 5-2 load host database, ROUCONFIG, 3-3 3-1, 5-1 Device code, 2-2 load host information, Device identifier, 2-2 1-3 Disk space, 2-1, 4-1 loading, 3-20, 5-18 DECrouter 2000 load successful, 3-21 configuration file, load unsuccessful, 3-22 1-2 modifying software, 2-8 DECrouter 2000 image, node address, 3-4, 5-3 1-2 node name, 3-4, 3-10, up-line dumps, 1-2 5-3, 5-9 Distribution kits, 1-3 Distribution media, 1-3 Index-2 Distribution media H (cont'd.) HELP MicroVAX, 1-3 rouconfig, 5-4 RX33, 1-3 ROUCONFIG, 3-4 tape, 1-3 rousetup, 5-11 TK50, 1-3 ROUSETUP, 3-13 VAX, 1-3 Dump file, 3-6, 5-5 I naming, 3-7, 5-6 E ICP, 3-19 failure, 3-23 Ethernet address, 1-4, running, 3-23 Installation Checkout 3-4, 3-7, 3-8, 3-10, Procedure, 3-19 5-4, 5-6, 5-7, 5-9 K Ethernet circuit cost, 3-15, 5-13 KEY.INIT, C-2 Ethernet controller, 3-9, 5-7 L ETHERNET_ANALYZE.EXE, C-2 Level 1 router, 3-14, Event logging, 3-20 5-13 Example Level 2 router, 3-14, ULTRIX configuration, 5-13 B-1 License Management ULTRIX installation, Facility, 2-6 B-1 Line name, 3-16, 5-14 VMS configuration, A-1 Lines, 3-13, 3-15, 5-11, VMS installation, A-1 5-14 Exit Line speeds, 3-15, 5-14 rouconfig, 5-4 Line state, 3-16, 5-14 ROUCONFIG, 3-4 List option, 3-6, 5-5 rousetup, 5-11 rouconfig, 5-2 ROUSETUP, 3-13 ROUCONFIG, 3-2 F LMF, 2-6 Load file, 3-6, 3-21, Files 5-5 SYS$COMMON, C-1 naming, 3-7, 5-6 SYS$HELP, C-2 Load host, 1-1 SYS$LIBRARY, C-2 configuration database, SYS$MANAGER, C-2 1-1 SYS$MESSAGE, C-2 configuring database, SYS$SYSTEM, C-1 3-2 to 3-12, 5-2 to 5-10 Index-3 Load host (cont'd.) N database, 3-1, 3-3, ncp, 5-3 5-1, 5-3 commands, 5-17, 5-19 database information, error messages, 5-8 3-6, 5-5 messages, 5-4 DECnet volatile database NCP, 3-4 , 3-3, 5-3 commands, 3-20, 3-24 disk space, 1-2 error messages, 3-9 privileges, 2-1 messages, 3-4 problems, 3-23, 5-18 NETLTC.EXE, C-1 rousetup, 5-11 NETTRACE.EXE, C-2 ROUSETUP, 3-13 NETTRACE_INSTALL.COM, running rouconfig, 5-4 C-2 running ROUCONFIG, 3-5 NETTRACE_MESSAGES.EXE, second, 1-2, 2-9, 4-3 C-2 ULTRIX, 4-1 Network Control Program, ULTRIX-32, 1-1 3-4, 5-3 ULTRIX version, 1-1 NML object, 3-17, 5-15 unavailable, 1-2 NML password, 3-18, 5-16 VAX/VMS, 1-1 NML username, 3-18, 5-16 VAXcluster, 2-10, 3-5 Node address, 3-4, 3-7, VMS, 2-1 3-8, 5-3, 5-6, 5-7 VMS version, 1-1 Node name, 3-4, 3-7, Load host database configuring, 3-1, 5-1 3-8, 3-13, 3-14, 5-3, rouconfig, 5-1 5-6, 5-7, 5-11, 5-12 ROUCONFIG, 3-1 Node number, 3-8, 5-7 Load host information, NSP_ANALYZE.EXE, C-2 1-3 O Load host software, 1-1 Load host ULTRIX, 1-1 Options N, 2-2 Load successful, 3-21 release notes, 2-2 Load unsuccessful, 3-22 M P Media Password, 3-17, 5-15 mounted, 2-3 Permanent database Menu rousetup, 5-1 rouconfig, 5-5 ROUSETUP, 3-1 ROUCONFIG, 3-6 Physical address, 1-4 MOM$LOAD, 2-8 Ports, 3-15, 5-14 defining, 2-8, 2-10 Pre-installation system logical, 2-8 preparation, 1-2 Purging files, 2-5 Index-4 R ROUCONFIG (cont'd.) Release notes, 2-2, 2-3, privileges, 3-5 4-3 restore option, 3-5, displaying, 2-4 3-11, 5-10 file, 2-5 restoring configuration, help, 2-5 3-12 options, 2-3 running, 3-4 printing, 2-4, 4-3 service circuit, 3-3 reading, 2-5, 4-3 swap option, 3-10 Restore option, 3-11, VAXcluster, 2-10 5-10 ROUCONFIG.COM, C-1 rouconfig, 5-3 ROUCONFIG.DAT, 3-5 ROUCONFIG, 3-3 rouperm, 5-11, C-3 Restore parameter, 3-12 ROUPERM, 3-13 Restoring configuration, ROUPERM.EXE, C-1 3-12 ROUPERM.HLB, C-2 rou011.release_notes, rouperm_help.txt, C-3 rousetup, 5-1, 5-11, C-3 C-2 exiting, 5-11 ROU011.RELEASE_NOTES, HELP, 5-11 C-1 privileges, 5-12 rou011.sys, C-2 ROUSETUP, 3-1, 3-12 ROU011.SYS, C-1 exiting, 3-13 rouconfig, 5-1, 5-2, C-3 HELP, 3-13 add option, 5-6 privileges, 3-14 exiting, 5-4 VAXcluster, 3-13 HELP, 5-4 ROUSETUP.COM, C-1 list option, 5-5 Router priority, 3-15, menu, 5-5 5-13 menu options, 5-5 ROUTING IV router, 3-14, preparing to run, 5-3 5-13 privileges, 5-4 Routing type, 3-13, 5-11 running, 5-4 ROUTING_ANALYZE.EXE, C-2 service circuit, 5-3 swap option, 5-9 S ROUCONFIG, 3-1, 3-2 add option, 3-7 Service circuit, 3-9, delete option, 3-11, 5-7 5-10 DEBNA, 3-9, 5-8 exiting, 3-4 DEBNT, 3-9, 5-8 HELP, 3-4 DELQA, 3-9, 5-7 list option, 3-6 DELUA, 3-9, 5-7 menu, 3-6 DESQA, 3-9, 5-7 menu options, 3-6 DESVA, 3-9, 5-8 preparing to run, 3-4 DEUNA, 3-9, 5-7 Index-5 Service circuit (cont'd.) ULTRIX installation load host, 3-7, 5-6 (cont'd.) rouconfig, 5-3 example, B-1 ROUCONFIG, 3-3 ULTRIX load host, 1-1 SERVICE ENABLED, 3-9, files installed, C-2 5-8 Unit number, 2-2 SPR, 3-7, 5-6 Up-line dumps, 2-1, 3-7, Superuser, 4-1 4-1, 5-6 Swap option, 3-10, 5-9 Username, 3-17, 5-15 rouconfig, 5-2 ROUCONFIG, 3-2 V SYNC_ANALYZE.EXE, C-2 SYS$COMMON VAXcluster files, C-1 load host, 2-10, 3-5 SYS$HELP, C-2 ROUCONFIG, 2-10 files, C-2 ROUSETUP, 3-13 SYS$LIBRARY, C-2 VMS configuration files, C-2 example, A-1 SYS$MANAGER, C-2 VMSINSTAL, 2-2 files, C-2 completing, 2-9 SYS$MESSAGE, C-2 restarting, 2-5 files, C-2 VMS installation SYS$SYSTEM, C-1 example, A-1 files, C-1 VMS License Management System disk, 2-1 Facility, 2-6 System logical VMS load host, 1-1 MOM$LOAD, 2-8 files installed, C-1 System manager account, X 2-1 T X25router, 3-8 TRACEHLP.HLB, C-2 TRACE password, 3-18, 5-16 TRACE username, 3-18, 5-16 TRACE utility, 2-5, 3-17, 3-18, 5-15, 5-16 U ULTRIX configuration example, B-1 ULTRIX installation Index-6