 

















             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

             <xxx>       This one- to three-character symbol
                         indicates that you press a key on the
                         terminal. For example: <RET> indicates
                         the RETURN key, <ESC> indicates the
                         ESCAPE key.

             <CTRL/x>    This symbol indicates that you press
                         the CTRL key at the same time as
                         you press another key; for example,
                         <CTRL/C>, <CTRL/Y>, 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 <RET> 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 <RET>, 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 <CTRL/Y>, 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 <CTRL/Y> 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 <RET>.
             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 <CTRL/Z> and the program returns you to
             the menu. Enter <CTRL/Z> 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 <RET> to start, or CTRL/Z to exit.

             If you press <RET>, 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 <RET>. 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 <CTRL/Z>.

             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 <RET>.
             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 <CTRL/D> 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 <RET> to start, or e to exit.

             If you press <RET>, 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 <RET>. 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 <CTRL/D>.

             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]? <RET>

               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]? <RET>

                            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]? <RET>

               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 <RET> 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]: <RET>

               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]: <RET>
               Ethernet circuit cost [4]: <RET>
               Router priority [64]: <RET>

                   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]:<RET>

                       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]: <RET>
               Name of circuit associated with line l0 [l0]: <RET>
               Circuit l0 default state [ON]: <RET>
               Circuit l0 cost [5]: <RET>

               Line 1 name [SYN-1]: <RET>
               Line SYN-1 default state [ON]: <RET>
               Name of circuit associated with line SYN-1 [SYN-1]: <RET>
               Circuit SYN-1 default state [ON]: <RET>
               Circuit SYN-1 cost [5]: <RET>

          Example VMS Installation and Configuration          A-5

 






               Line 2 name [SYN-2]: l2
               Line l2 default state [ON]: <RET>
               Name of circuit associated with l2 [l2]: c2
               Circuit c2 default state [ON]: off
               Circuit c2 cost [5]: <RET>

               Line 3 name [SYN-3]: <RET>
               Line SYN-3 default state [ON]: <RET>
               Name of circuit associated with line SYN-3 [SYN-3]: <RET>
               Circuit SYN-3 default state [ON]: <RET>
               Circuit SYN-3 cost [5]: <RET>

               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]: <RET>

               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 <RET> 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]: <RET>

                              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]: <RET>
               Router priority [64]: <RET>

                 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]: <RET>
               Name of circuit associated with line l0 [l0]: <RET>
               Circuit l0 default state [ON]: <RET>
               Circuit l0 cost [5]: <RET>

               Line 1 name [SYN-1]: <RET>
               Line SYN-1 default state [ON]: <RET>
               Name of circuit associated with line SYN-1 [SYN-1]: <RET>
               Circuit SYN-1 default state [ON]: <RET>
               Circuit SYN-1 cost [5]: <RET>

               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]: <RET>








































          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
