 

















             X25router 2000

             Installation Procedures (VMS)


             Order No. AA-JH75B-TN


             SUPERSESSION/UPDATE INFORMATION:  This is a revised man-
                                               ual


             OPERATING SYSTEM AND VERSION:     VMS V4.7, V5.0, V5.1,
                                               V5.2


             SOFTWARE VERSION:                 X25router 2000 V1.1











             DIGITAL

 






                                    First Printing, October 1987
                                               Revised July 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:

             DDCMP           Packetnet     UNIBUS
             DEC             PDP           VAX
             DECnet          Q-bus         VAXcluster
             DECrouter       Q22-bus       VMS
             DECUS           RSTS          VT
             DECwriter       RSX
             MASSBUS         ULTRIX
             MicroVAX        ULTRIX-32     DIGITAL

             This manual was produced by the Wide Area Communications
             Environment group in Reading, England.

 















          _______________________________________________________

                                                         Contents



          How to Use This Manual


          1   Introduction

              1.1      Databases Used by the X25router 2000 . 1-2

              1.2      Use of Network Names for the X25router
                       2000.................................. 1-3

              1.3      Profile Names ........................ 1-4

              1.4      Distribution Kits .................... 1-4

              1.5      Installation Time .................... 1-5

              1.6      VMS Tailoring ........................ 1-5

              1.7      Changing an X25router 2000
                       Configuration......................... 1-5

              1.7.1      Adding Further X25router 2000s to Your
                         DECnet Network.......................1-6

              1.7.2      Adding Load Hosts................... 1-6

              1.7.3      Adding VAX P.S.I. Access Nodes...... 1-6

              1.7.4      Adding New Connections to an X25router
                         2000 System..........................1-6

                                                              iii

 






          2   Preparing to Install and Configure the X25router
              2000

              2.1      Preparing to Install ................. 2-1

              2.1.1      Privileges Required................. 2-2

              2.2      Preparing to Configure ............... 2-2

              2.2.1      Configuration Checklist............. 2-2

              2.2.2      Privileges Required................. 2-3

              2.2.3      Configuration Information........... 2-3

          3   Installing the X25router 2000 Software

              3.1      How the Installation Procedure Works . 3-1

              3.2      Printing the Release Notes ........... 3-2

              3.3      Installing the X25router 2000 Software 3-4

              3.4      Installing and Configuring on Multiple
                       Load Hosts............................ 3-9

          4   Configuring the X25router 2000

              4.1      Using X25ROUCONFIG.COM ............... 4-2

              4.1.1      Starting X25ROUCONFIG.COM........... 4-3

              4.1.2      X25ROUCONFIG.COM options............ 4-3

              4.1.2.1     List Known DECrouters ............. 4-4

              4.1.2.2     Add a DECrouter ................... 4-4

              4.1.2.3     Swap an Existing DECrouter ........ 4-6

              4.1.2.4     Delete an Existing DECrouter ...... 4-7

              4.1.2.5     Restore Existing DECrouters ....... 4-8

              4.1.2.6     Upgrade Existing DECrouters ....... 4-9

              4.1.3      Restoring the Configuration
                         Automatically........................4-9

              4.2      Using X25ROUSETUP.COM ............... 4-10

              4.2.1      Running X25ROUSETUP.COM: DEMSA..... 4-11

          iv

 






              4.2.2      Running X25ROUSETUP.COM: DEMSB..... 4-28

              4.3      Loading the Software ................ 4-45

          5   Testing the Installation

              5.1      Introduction ......................... 5-1

              5.2      Preparing to Run X25ROU_ICP .......... 5-2

              5.3      Running the ICP in Loopback to the Local
                       X25router 2000........................ 5-3

              5.4      Running the ICP to a Remote X25router
                       2000.................................. 5-5

              5.4.1      Setting Up an ICP Destination on a
                         Remote X25router 2000................5-6

              5.4.2      Running the ICP .................... 5-7

              5.4.3      Clearing the Destination on a Remote
                         X25router 2000.......................5-9

              5.5      Running the ICP to a Remote VMS Node  5-10

              5.5.1      Setting Up a Destination on a Remote VMS
                         Node................................5-10

              5.5.2      Running the ICP.................... 5-12

              5.5.3      Clearing the Destination........... 5-13

              5.6      What to Do if the ICP Completes with
                       Errors............................... 5-14

          A  Example Installation and Configuration

          B  Example of Testing an Installation, Using the ICP


                                                                v

 






          C  Lists of Files Installed

              C.1      X25router 2000 files ................. C-1

              C.2      TRACE files .......................... C-2

          D  ICP Messages


              D.1      ICP Information Messages ............. D-1

              D.2      ICP Error Messages ................... D-2

              D.3      ICP Fatal Messages ................... D-4

          Index

          Figures

              1-1    An Example Installation, with Two X25router
                     2000 Nodes.............................. 1-3


          Tables

              1-1    Media Used to Install the X25router
                     Software................................ 1-5

              2-1    Number of Free Blocks Required ......... 2-2

              2-2    Information You Require to Configure the
                     X25router 2000 Software................. 2-4









          vi

 













          _______________________________________________________

                                           How to Use This Manual






          Manual Objectives

             This manual explains how to install the X25router 2000
             software. It includes:

              _ A description of the preparations you must make be-

                fore you begin.

              _ A description of the installation.

              _ A guide to configuring the databases used by the X25router

                2000.

              _ A guide to testing the installation.

          Intended Audience

             This manual is intended for anyone responsible for man-
             aging the X25router 2000. Management tasks include:

              _ Installing and configuring the software on one or

                more VMS load hosts.

              _ Checking that the software can load and dump.

                                                              vii

 






             This manual assumes that you understand and have some
             experience of:

              _ Local area networks (LANs)

              _ Wide area networks (WANs)

              _ DECnet-VAX

              _ X.25 communications

              _ Installation of software products on VMS systems

              _ One or more of Digital's X.25 products

          Structure of the Manual

             The manual has 5 chapters and 4 appendixes.

             Chapter 1 describes what is involved in installation
             and configuration, and defines some terms you need to
             know in order to configure the product.

             Chapter 2 describes what you need to do before you in-
             stall and configure the software.

             Chapter 3 explains how to install the software on a load
             host.

             Chapter 4 explains how to configure the load host database
             and the X25router 2000 permanent database, and how to
             load the X25router 2000.

             Chapter 5 explains how to run the Installation Checkout
             Procedure (ICP).

             Appendix A is an example of installing and configur-
             ing the software on a host.

             Appendix B is an example of executing the ICP.

             Appendix C lists the X25router 2000 files installed.

          viii

 






             Appendix D lists the messages that may be displayed when
             you run the X25router 2000 Installation Checkout Procedure
             (ICP).


          Associated Manuals

             For more information about the X25router 2000, refer
             to:

              _ X25router 2000 Management Guide

              _ X25router 2000 Problem Solving Guide

             For information about routing concepts, refer to:

              _ Routing and Networking Overview

             For information about X.25 PSDNs, refer to the Public
             Network Information manual. For further information about
             X.25 and VAX P.S.I., refer to the VAX P.S.I. documen-
             tation set.

             The following provide information about the hardware
             used with the X25router 2000 software:

              _ Installing the DEC MicroServer

              _ Installing the DEC MicroServer-SP

              _ DEC MicroServer Systems Configuration Card

              _ DEC MicroServer-SP Systems Configuration Card

             You should also be familiar with the following manu-
             als:

              _ VMS Networking Manual

              _ VMS Network Control Program Manual

              _ VMS Install Utility Manual

                                                               ix

 






          Manual Conventions


             <xxx>       This 1- to 3-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.

             Italics     indicate variable information.


          Manual Terminology

             X25router 2000 and DECrouter

             The configuration procedure X25ROUCONFIG.COM calls the
             X25router 2000 a "DECrouter" in the text displayed on
             the screen. This is because the X25router 2000 belongs
             to the DECrouter family of software products.

             DEC MicroServer (DEMSA) and DEC MicroServer-SP
             (DEMSB)

             The X25router 2000 software runs on either the DEC MicroServer
             hardware unit (DEMSA) or the DEC MicroServer-SP hard-
             ware unit (DEMSB). Unless stated otherwise in this man-
             ual, the term "DEC MicroServer" refers to both the DEC
             MicroServer and the DEC MicroServer-SP.





          x

 













          ______________________________________________________1

                                                     Introduction




             In order to set up an X25router 2000, you need to fol-
             low these steps:

              1.Install the distribution software on a load host.

              2.Run the command procedure X25ROUCONFIG.COM on the
                load host to configure the load host database. X25ROUCONFIG.COM
                also automatically adds X25router 2000 entries to
                the DECnet node databases.

              3.Run the command procedure X25ROUSETUP.COM on the load
                host to configure the X25router 2000 permanent database.

              4.Down-line load the configured X25router 2000 soft-
                ware image to the DEC MicroServer hardware unit.

              5.Run the X25router 2000 Installation Checkout Procedure
                (ICP) to test that you have installed and config-
                ured the X25router 2000 software correctly.

             A load host can be any VMS Phase IV DECnet node, pro-
             vided that:

              _ It is running VMS or MicroVMS V4.7, VMS V5.0, VMS

                V5.1 or VMS V5.2.

              _ It is connected to the same Ethernet as the DEC MicroServer

                hardware unit.

          Introduction                                        1-1

 






             The load host is also used to receive up-line dumps from
             the X25router 2000.

             You are advised to install the X25router 2000 software
             on at least two load hosts. This will enable you to down-
             line load the X25router 2000 software to the X25router
             2000 and receive dumps even if one load host is unavail-
             able. See Section 3.4 for details.

          1.1 Databases Used by the X25router 2000

             The X25router 2000 uses the following databases:

              _ The VMS load host database. This contains informa-

                tion needed to down-line load the X25router 2000,
                including its node name and address and hardware ad-
                dress. The load host database is held in the file
                ROUCONFIG.DAT in the SYS$COMMON:[DECSERVER] direc-
                tory.

              _ The DECnet node databases, which contain informa-

                tion about the X25router 2000.

              _ The X25router 2000 permanent and volatile databases.

                These contain two types of information:

                 - DECnet information. This information is needed
                   for the X25router 2000 to be a node in a DECnet
                   network. It includes the executor type and in-
                   formation about DECnet lines and circuits.

                 - X.25 information. This is the X.25 information
                   needed for the X25router 2000 to connect to an
                   X.25 network. This information includes, for ex-
                   ample, the packet switching data networks (PSDNs)
                   which can be used, DTE addresses and packetsizes.

                The X25router 2000 permanent database is stored on
                the load host. A copy of the permanent database is
                down-line loaded onto the DEC MicroServer with the
                the X25router 2000 software. This copy forms the X25router
                2000 volatile database.

          1-2      X25router 2000 Installation Procedures (VMS)

 






          1.2 Use of Network Names for the X25router 2000

             You use network names to identify:

              _ The PSDN you wish to use.

              _ The route you wish to use to access the PSDN - that

                is, which X25router 2000 node, and which line this
                node uses to connect to the PSDN.

             Network names have to meet the following requirements:

              _ You must have a different network name for each PSDN

                you want to access.

              _ If you have more than one connector node available

                to access the same PSDN, you must give each connec-
                tion to the PSDN a unique network name. Examples of
                connector nodes are VAX P.S.I. Multi-host nodes and
                X25router 2000 nodes.

              _ The network name in the VAX P.S.I. Access node database

                must be the same as the network name defined in your
                X25router 2000 permanent database.

             If you have more than one line between an X25router 2000
             node and a PSDN, you may, if you wish, use different
             network names to distinguish between the lines.

             In Figure 1-1, the network PSDN1 can be accessed only
             through X25router 2000 node 1, and thus requires only
             a single network name (PSDN1).

             ____________________________________________________

             PSDN2 can be accessed through X25router 2000 node 1 and
             X25router 2000 node 2, so separate (unique) network names
             are required for VAX P.S.I. Access nodes to differen-
             tiate between the two different access routes. For ex-
             ample, you might choose network names "PSDN2A" and "PSDN2B".

          Introduction                                        1-3

 






             PSDN3 can be accessed only through the two lines con-
             nected to X25router 2000 node 2. Therefore, PSDN3 does
             not require more than one network name. However, you
             may wish to distinguish between the two lines provided
             by X25router 2000 node 2 (for example, if the two lines
             have different speeds). To do this you would give PSDN3
             two network names, for example "PSDN3A" and "PSDN3B".


          1.3 Profile Names

             The following attributes are associated with each PSDN
             connected to the X25router 2000:

              _ A profile name

              _ One or more DTE addresses

              _ One or more synchronous lines connected to the PSDN,

                one per DTE

             The profile name is unique for each PSDN, and provides
             the X25router 2000 with the network characteristics.
             The profile names for public PSDNs appear in the Public
             Network Information manual. For a list of networks cur-
             rently supported by Digital, see the X25router 2000 Software
             Product Description.

                                     NOTE

                        You must use the correct profile
                        name of a supported PSDN. Connecting
                        to an unsupported PSDN invalidates
                        Digital's VAX P.S.I. support.

          1.4 Distribution Kits

             The X25router 2000 can be installed on VMS systems from
             TK50 cassettes or magnetic tape. Table 1-1 gives de-
             tails.

          1-4      X25router 2000 Installation Procedures (VMS)

 






             Table 1-1  Media Used to Install the X25router
             ___________Software_________________________________

             Media_type__Number__________________________________

             TK50        1

             Magnetic    1
             tape________________________________________________


          1.5 Installation Time

             The installation from the distribution media of the X25router
             2000 software should take no more than 10 minutes.

          1.6 VMS Tailoring

             For VMS V5.0 or later systems, the following VMS classes
             are required:

              _ VMS Required Saveset

              _ Network Support

          1.7 Changing an X25router 2000 Configuration

             Before you make any changes to your X25router 2000 con-
             figuration, you may need to alter the DTE Access Control
             Databases and Destination Access Control Databases on
             your VAX P.S.I. Access nodes. For details of these databases,
             see the VAX P.S.I. Management Guide.









          Introduction                                        1-5

 






          1.7.1 Adding Further X25router 2000s to Your DECnet
                Network

             If you have installed an X25router 2000 or a VAX P.S.I.
             Multi-host system on your network, and wish to provide
             one or more additional routes to the same PSDN via an-
             other X25router 2000:

              1.Install and configure the X25router 2000, follow-
                ing the procedures described in Chapters 3 and 4.

              2.Update the X25-ACCESS database on each of the VAX
                P.S.I. Access systems. See the VAX P.S.I. Management
                Guide for details.

          1.7.2 Adding Load Hosts

             To add a new load host to an X25router 2000 configu-
             ration, you need to install and configure the X25router
             2000 on the new host. See Section 3.4 for details.

          1.7.3 Adding VAX P.S.I. Access Nodes

             After installing the VAX P.S.I. Access software, up-
             date the X25-SERVER database on the X25router 2000 sys-
             tem; this will enable appropriate incoming calls to be
             passed to the new VAX P.S.I. Access node. See the X25router
             2000 Management Guide for details. Make sure the X25router
             2000 is defined in the X25-ACCESS database on the new
             VAX P.S.I. Access node, to allow the VAX P.S.I. Access
             node to make outgoing calls.

          1.7.4 Adding New Connections to an X25router 2000
                System

             To add new network connections (a new DDCMP line, a new
             X.25 line DTE, or a connection to a new network) to your
             X25router 2000 system, run the command procedure X25ROUSETUP.COM
             at the load host. This is described in Section 4.2.


          1-6      X25router 2000 Installation Procedures (VMS)

 






             If you are adding a connection to a new PSDN, update
             the X25-ACCESS database on the VAX P.S.I. Access sys-
             tems. See the VAX P.S.I. Management Guide for details.






































          Introduction                                        1-7

 













          ______________________________________________________2

            Preparing to Install and Configure the X25router 2000




             This chapter describes what you need to do before you
             install and configure the X25router 2000 software.


          2.1 Preparing to Install

             Before you install the software, you should make the
             following checks:

              1.Check that the disk used for the X25router 2000 soft-
                ware is the default. Usually, this is the system disk
                (with the logical name SYS$SYSDEVICE).

              2.Make sure you have a good backup copy of the disk
                you are going to use.

              3.Check that there are enough free blocks on your disk
                to install the X25router 2000. If you try to install
                the X25router 2000 with too few free blocks, the in-
                stallation procedure will fail.

                Table 2-1 shows how many free blocks you need.





       Preparing to Install and Configure the X25router 2000  2-1

 






             Table_2-1__Number_of_Free_Blocks_Required___________

                                                       For
                                                       Upline
             Product_Type____________For_Installation__Dumps_____

             X25router 2000          2000              4500

             X25router 2000 with     2600              4500
             TRACE_______________________________________________

                To see how many free blocks there are on the disk,
                enter this command:

                  $ SHOW DEVICE SYS$SYSDEVICE

                The display will show information about the disk,
                including the number of free blocks.

          2.1.1 Privileges Required

             In order to install the X25router 2000 software, you
             need the privileges OPER and SYSPRV.

          2.2 Preparing to Configure

          2.2.1 Configuration Checklist

             Before you run X25ROUCONFIG.COM, check that:

              1.DECnet-VAX is running on your load host node.

              2.The Network Control Program (NCP) has been installed.
                Note that you only need to check this if your load
                host is running MicroVMS, rather than VMS. On VMS
                systems, NCP is installed automatically with DECnet-
                VAX.




          2-2      X25router 2000 Installation Procedures (VMS)

 






          2.2.2 Privileges Required

             In order to run the configuration procedures X25ROUCONFIG.COM
             and X25ROUSETUP.COM, you need the privileges OPER and
             SYSPRV.

          2.2.3 Configuration Information

             Before you run X25ROUCONFIG.COM and X25ROUSETUP.COM,
             you need to gather information about your X25router 2000
             system and the network that you will be using. Table
             2-2 shows the information you require; you can also use
             it to record your own information.

             Duplicate the sections of this table as many times as
             needed. For example, if you have two DTEs, you should
             duplicate the section headed Information you will re-
             quire for each DTE.

             See Chapter 3 of the X25router 2000 Management Guide
             for guidance on the meaning of the information in the
             table, and recommended values.

             Digital suggests that you use the information under Information
             you will require for each X25router to complete the con-
             figuration card. The system manager needs to assign a
             DECnet node address and node name to the X25router node.














       Preparing to Install and Configure the X25router 2000  2-3

 






             Table 2-2  Information You Require to Configure the
             ___________X25router_2000_Software__________________

             Information you will require for each X25router
             2000:_______________________________________________

                                                         Your
             Information_______Notes_____________________Value___

             DECnet node name  A unique name of up to
             of X25router      6 alphanumeric digits,
             2000              one of which must be a
                               letter.

             DECnet node       A unique number in
             address of        the range 1-1023.
             X25router 2000    Include the area num-
                               ber (if any). See
                               Section 4.1.2.2 for
                               details.

             Ethernet address  This is on a label at
             of X25router      the back of the DEC
             2000              MicroServer hardware
                               unit.

             DECnet service    This identifies load
             circuit-ID        host's Ethernet service
                               circuit connected to
                               the X25router 2000.
                               For example, QNA-1.
                               See Section 4.1.2.2 for
                               details








          2-4      X25router 2000 Installation Procedures (VMS)

 






             Table 2-2 (Cont.)  Information You Require to
                                Configure the X25router 2000
             ____________________________________________________

             Information you will require for each network you
             use:________________________________________________

                                                         Your
             Item______________Notes_____________________Value___

             Network name      Choose your own unique
                               name. It may consist
                               of up to 16 letters
                               and numbers, in any
                               combination.

             Profile name for  Recorded in Public
             network           Network Information
                               manual. Default is the
                               network name.





















       Preparing to Install and Configure the X25router 2000  2-5

 






             Table 2-2 (Cont.)  Information You Require to
                                Configure the X25router 2000
             ____________________________________________________

             Information_you_will_require_for_each_DTE___________

                                                         Your
             Item______________Notes_____________________Value___

             Local DTE ad-     DTE address for
             dress             X25router 2000. Obtain
                               this from your PTT rep-
                               resentative.

             Channels range    A range of Logical
                               Channel Numbers (LCNs)
                               to be used by the DTE.
                               Obtain this from your
                               PTT representative.

             Synchronous port  The X25router 2000 port
             number            number to be used for
                               this DTE.

             Line name         The name of the line
                               the DTE will use. For
                               example, X25-0.














          2-6      X25router 2000 Installation Procedures (VMS)

 






             Table 2-2 (Cont.)  Information You Require to
                                Configure the X25router 2000
             ____________________________________________________

             Information you will require for each VAX P.S.I.
             Access_destination:_________________________________

                                                         Your
             Information_______Notes_____________________Value___

             Destination name  Choose a unique name.

             Destination node  Name of VAX P.S.I.
             name              Access node for des-
                               tination.


























       Preparing to Install and Configure the X25router 2000  2-7

 






             Table 2-2 (Cont.)  Information You Require to
                                Configure the X25router 2000
             ___________________Software_________________________

             Information you will require for each VAX P.S.I.
             Access_destination:_________________________________

                                                         Your
             Information_______Notes_____________________Value___

             Destination       Range is 0-255. The
             priority          default is 0.

             Call mask         Value between 2 and
                               32 hexadecimal digits.
                               Example: FF00FE

             Call value        Value between 2 and
                               32 hexadecimal digits.
                               Example: FF5053

             Closed User       Name of closed user
             Group (CUG)       group which has access
                               to this destination. 1
                               to 10 characters.

             Sending           Remote DTE address(es)
             Address(es)       which have access to
                               this destination.

             Subaddress range  Accepted range of sub-
                               addresses in incoming
                               calls for this destina-
                               tion.

             Object identifi-  This must be 36.
             cation______________________________________________




          2-8      X25router 2000 Installation Procedures (VMS)

 













          ______________________________________________________3

                           Installing the X25router 2000 Software




             This chapter explains how to install the X25router 2000
             distribution software on a VMS load host.

             Please note that the screen displays reproduced in this
             chapter are the ones that appear when you run the VMS
             V5.0 version of VMSINSTAL. If you are running other ver-
             sions of VMSINSTAL, some of the displays may be slightly
             different.

          3.1 How the Installation Procedure Works

             During the installation, the installation procedure prompts
             you with questions. In many cases defaults have been
             set up. These are indicated in square brackets. To ac-
             cept the default, press <RET>.

             You can cancel the X25router 2000 installation at any
             time by pressing <CTRL/Y>. After a short delay, you will
             see the message:

               %VMSINSTAL-F-CTRLY, Installation canceled via CTRL/Y.
               %VMSINSTAL-F-UNEXPECTED, Installation terminated due to unexpected event.

                          VMSINSTAL procedure done at time



          Installing the X25router 2000 Software              3-1

 






             If you press <CTRL/Y> after you have been told that the
             files are being moved to their target directories, your
             system will have some new and (if previously installed)
             some old X25router 2000 files. To prevent problems, you
             should re-install the product from the beginning.


          3.2 Printing the Release Notes

             You should print the release notes before you install
             the X25router 2000, as they may give you useful infor-
             mation relating to the installation. This section de-
             scribes the steps you follow in order to print the re-
             lease notes and/or view them on-line.

              1.Log in to the system manager's privileged account
                (SYSTEM).

              2.Enter this command:

                  $ @SYS$UPDATE:VMSINSTAL X25ROU ddcu OPTIONS N

                where ddcu is the name of the device that the dis-
                tribution kit is mounted on.

                   dd is the device code
                   c is the controller letter
                   u is the unit number

                For example, MUA0:

                OPTIONS N specifies that you wish to print or view
                the Release Notes.

              3.The procedure now displays:

                      VAX/VMS Software Product Installation Procedure Vn

                  It is date at time.
                  Enter a question mark (?) at any time for help.

                where n is the number of the version of VMS or MicroVMS
                you are using.

          3-2      X25router 2000 Installation Procedures (VMS)

 






                If DECnet is currently running on your system, the
                procedure also displays the message:

                  %VMSINSTAL-W-DECNET, Your DECnet network is up and running.
                  * Do you want to continue anyway [NO]?

                Enter YES.

              4.The procedure now displays:

                  * Are you satisfied with the backup of your system disk [YES]?

                As you are only printing the release notes, enter
                YES.

              5.The procedure now displays:

                  The following products will be processed:

                    X25ROU V1.1

                          Beginning installation of X25ROU V1.1 at time

                  %VMSINSTAL-I-RESTORE, Restoring product saveset A...

              6.After a delay, the procedure displays the release
                notes options:

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

                Digital recommends that you select Option 2.

                Note that the release notes will be copied to SYS$HELP
                if you choose any of the options 1 to 4.

                If you are using a load host running VMS V4.7, only
                options 1, 2 and 3 will be displayed.

              7.If you selected Option 2 or 3, you are asked to queue
                the file to a printer:

                  * Queue name [SYS$PRINT]:

                Press <RET> or specify another print queue.

          Installing the X25router 2000 Software              3-3

 






                If you selected Option 1 or 3, you will first see:

                  VMI$ROOT:[SYSUPD.X25ROU011] X25ROU011.RELEASE_NOTES;1

                Then the release notes will be displayed on your ter-
                minal.

              8.Now the procedure displays:

                  * Do you want to continue the installation ?

                Enter NO. The following message is displayed:

                  %VMSINSTAL-I-RELMOVED, The product's release notes have been
                  successfully moved to SYS$HELP.

                          Installation of X25ROU V1.1 completed at hh:mm

                          VMSINSTAL procedure done at hh:mm

             You can now read the release notes. Check for any in-
             formation that is likely to affect the installation of
             the X25router 2000 software.

             The VMSINSTAL procedure creates a file for the release
             notes, called
             X25ROU011.RELEASE_NOTES in the SYS$HELP directory.

          3.3 Installing the X25router 2000 Software

             To install the X25router 2000 software, follow these
             steps:

              1.Log in to the system manager's privileged account
                (SYSTEM).

              2.Enter this command:

                  $ @SYS$UPDATE:VMSINSTAL X25ROU ddcu

                Note that this command is the same as that in Step
                2 in Section 3.2, except that you do not enter OPTIONS
                N.

          3-4      X25router 2000 Installation Procedures (VMS)

 






              3.The procedure displays:

                      VAX/VMS Software Product Installation Procedure Vn

                  It is date at hh:mm.

                  Enter a question mark (?) at any time for help.

                where n is the number of the version of VMS or MicroVMS
                you are using.

                If DECnet is currently running on your system, the
                procedure also displays the 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, enter YES.

              4.The procedure now displays:

                  * Are you satisfied with the backup of your system disk [YES]?

                If you are not satisfied, enter NO to end the pro-
                cedure. When you have backed up your system disk,
                start the installation again.

                If you are satisfied, enter YES. The procedure then
                displays:

                  The following products will be processed:

                    X25ROU V1.1

                          Beginning installation of X25ROU V1.1 at time

                  %VMSINSTAL-I-RESTORE, Restoring product saveset A...
                  %VMSINSTAL-I-RELMOVED , The product's release notes have been
                  successfully moved to SYS$HELP.

              5.The procedure then asks:

                  * Do you want to purge files replaced by this installation [YES]?

                Enter YES to purge files from previous installations
                of X25router 2000 software.

          Installing the X25router 2000 Software              3-5

 






              6.The procedure then displays:

                  The X25router 2000 kit has 2 components:

                      o   X25router 2000 software

                      o   Trace software

                  You may install either one or both of these components.

                  * Do you want to install the X25router 2000 software [YES]?
                  * Do you want to install the TRACE software [YES]?

                Refer to the X25router 2000 Problem Solving Guide
                for details of the TRACE utility. If you already have
                the TRACE utility installed, the procedure will re-
                mind you about this, and continue.

                If you ask for only the X25router 2000 to be installed,
                you can install TRACE at a later date. To do this,
                you first need to re-run VMSINSTAL. Then, answer NO
                to the question, Do you want to install the X25router
                2000 software?. Finally, answer YES to the question,
                Do you want to install the TRACE software?

              7.If you are using VMS V5, the procedure will ask:

                  * Does this product have an authorization key registered and loaded?

                The procedure is asking if you have a product li-
                cense installed (also known as the Product Authorization
                Key (PAK)).

                To install a PAK, you use the VMS License Management
                Facility (LMF), which is available with VMS 5.0. LMF
                is a management tool which enables you to register,
                manage and track software licenses on line. You do
                not need a license to install and operate the X25router
                2000 software. However, Digital recommends that you
                install a license so that you can keep your database
                of layered products up to date. See the VMS License
                Management Utility Manual in the VMS documentation
                set for more information.

                If you have registered and loaded the PAK, enter YES.
                You will go directly to step 8.

          3-6      X25router 2000 Installation Procedures (VMS)

 






                If you have not registered and loaded the (PAK), en-
                ter NO. The procedure then displays:

                      DIGITAL recommends that you install the license for
                      the X25router 2000 on completion of the installation.

                  * Do you wish to exit [YES]?

                If you wish to install the PAK, you can exit now.
                Otherwise, enter NO.

              8.If you have asked for both components to be installed,
                you will see the message:

                  %VMSINSTAL-I-RESTORE, Restoring product saveset B ...
                  %VMSINSTAL-I-RESTORE, Restoring product saveset C ...

                  The following software will now be installed:

                      o   X25router 2000 software

                      o   Trace software

                The installation procedure now copies the contents
                of the distribution volume to a subdirectory in SYS$UPDATE.

              9.The procedure now checks the definition of the sys-
                tem logical,
                MOM$LOAD. If you have not defined MOM$LOAD, the pro-
                cedure asks if you wish to define it now, and will
                automatically define it for you.

                If you have already defined MOM$LOAD, but MOM$LOAD
                does not include a directory called SYS$SYSROOT:[DECSERVER],
                the procedure asks if you wish to redefine MOM$LOAD
                now, and will automatically redefine the logical to
                include SYS$SYSROOT:[DECSERVER].

                If MOM$LOAD is already correctly defined, the ques-
                tion is not asked.

              10.Theprocedure now displays the following messages:

          Installing the X25router 2000 Software              3-7

 






                  After exiting from VMSINSTAL, do the following:

                  1. If  the  definition  for MOM$LOAD in the system start-up file
                     does not contain  SYS$SYSROOT:[DECSERVER], you must edit your
                     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  X25router 2000 image
                     to be defined each time the system is rebooted, so the system
                     will load correctly.

                If you are running VMS V5.0 or V5.0-1, the follow-
                ing text will also be displayed:

                     You are  running on VMS V 5.0  or  V 5.0-1. Logicals that are
                     required to load your X25router may not be defined for you.

                     There is a command file X25ROU_LOGICALS.COM  in the directory
                     SYS$MANAGER. This  command file must be run before you try to
                     load  your  X25router 2000.  To ensure that the  logicals are
                     defined every time you boot your system add the line:

                      $ @sys$manager:x25rou_logicals.com

                      to the file SYS$MANAGER:SYSTARTUP_V5.COM

                For all VMS versions, the following is displayed:

                  2. Configure your X25router 2000 into the  load host's database.
                     Execute the  command  procedure called X25ROUCONFIG.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  X25router 2000
                     units.  All previously defined DECrouter  units will still be
                     configured within the load host's database.  Refer to Chapter
                     4 of  the X25router 2000 Installation Procedures  for further
                     details.

                  3. Set up the X25router 2000 permanent  database before powering
                     up  the  hardware.  Execute  the  command  procedure   called
                     X25ROUSETUP.COM   which  is  in  the  SYS$SYSROOT:[DECSERVER]
                     directory.  Refer  to  Chapter  4  of  the  X25router  2000
                     Installation Procedures for further details.

                     If you  wish to modify the  X25router 2000 database for  your
                     specific  networking requirements, execute the X25ROUPERM.EXE
                     program which is in the SYS$SYSTEM directory. This program is
                     described  in the  X25router 2000 Management Guide.

                  4. REMINDER: The release notes for the  X25router  2000  are in
                     X25ROU011.RELEASE_NOTES  which is in the directory SYS$HELP.

          3-8      X25router 2000 Installation Procedures (VMS)

 






                If you requested that TRACE be installed, the pro-
                cedure also displays:

                  5. A  command  file  SYS$MANAGER:NETTRACE_INSTALL.COM  has  been
                     created  to  install  the  TRACE  utility.  Edit  your system
                     start-up  file to execute  this file each time your system is
                     booted.

                Note that the default name of the system start-up
                file is different depending on whether the load host
                is running VMS V4.7, or VMS V5.0 and higher:

                 _ If the load host is running VMS V4.7, the name

                   of the default system start-up file is SYSTARTUP.COM.

                 _ If the load host is running VMS V5.0 or higher,

                   the name of the default system start-up file is
                   SYSTARTUP_V5.COM.

              11.Theprocedure now displays:

                  %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target
                  directories...

                          Installation of X25ROU V1.1 completed at hh:mm

                          VMSINSTAL procedure done at hh:mm

             See Appendix C for a list of the files installed. See
             Chapter 4 for details of how to run X25ROUCONFIG.COM
             and X25ROUSETUP.COM.

          3.4 Installing and Configuring on Multiple Load Hosts

             You are advised to install the X25router 2000 software
             on at least two load hosts. This will enable you to down-
             line load the X25router 2000 software to the DEC MicroServer
             and receive dumps even if one load host is unavailable.

             The procedure is slightly different depending on whether
             or not the load hosts are members of the same VAXcluster.

          Installing the X25router 2000 Software              3-9

 






              _ If load hosts are not members of the same VAXcluster:

                 1.Repeat the installation procedure described in
                   this chapter at each load host.

                 2.Run X25ROUCONFIG.COM and X25ROUSETUP.COM at each
                   load host. See Section 4.1 and Section 4.2 for
                   details.

              _ If load hosts are members of the same VAXcluster:

                 1.Carry out the installation procedure on one of
                   the nodes in the VAXcluster. A copy of the in-
                   stalled software is automatically placed in the
                   SYS$COMMON area.

                 2.Redefine MOM$LOAD on each VAXcluster node to be
                   used as a load host.

                 3.Run the command procedure X25ROUCONFIG.COM on one
                   node within the VAXcluster.

                 4.Re-run X25ROUCONFIG.COM with the RESTORE option
                   on the other VAXcluster nodes that you wish to
                   use as load hosts. See Section 4.1.2.5 for de-
                   tails of the RESTORE option.

                 5.Run X25ROUSETUP.COM on the VAXcluster nodes you
                   wish to use as load hosts.












          3-10     X25router 2000 Installation Procedures (VMS)

 













          ______________________________________________________4

                                   Configuring the X25router 2000




             When you have finished installing the distribution soft-
             ware, you must:

              1.Run the command procedure X25ROUCONFIG.COM to add
                entries to the VMS load host database. This command
                procedure also automatically adds entries to the per-
                manent and volatile DECnet node databases for the
                load host.

              2.Run the command procedure X25ROUSETUP.COM to set up
                entries in the X25router 2000 permanent database.

              3.Down-line load the configured X25router 2000 soft-
                ware to the
                DEC MicroServer hardware unit.

                                     NOTE

                        You must not down-line load the X25router
                        2000 until you have run X25ROUCONFIG.COM
                        and X25ROUSETUP.COM; if you do, it
                        may disrupt the normal operation
                        of your network. If you are using
                        more than one load host, be sure
                        that you follow the steps in Section 3.4.


          Configuring the X25router 2000                      4-1

 






          4.1 Using X25ROUCONFIG.COM

             When you run X25ROUCONFIG.COM, it displays a menu. The
             menu options allow you to:

              _ List the X25router 2000s in the load host database.

              _ Add an X25router 2000 to the load host and DECnet

                node databases. This is the option you use when you
                first install an X25router 2000.

              _ Swap an existing X25router 2000 for a new one.

              _ Delete an X25router 2000 from the load host and DECnet

                databases.

              _ Restore X25router 2000 information from the load host

                database to the DECnet node database on the load host.

              _ Upgrade an X25router 2000 entry in the load host and

                DECnet node databases from the previous version of
                the X25router 2000 software to the current version.

             When you are using X25ROUCONFIG.COM, note that:

              _ While you are using an option, you can obtain HELP

                by entering a question mark (?).

              _ When you have finished answering the questions on

                a selected option, X25ROUCONFIG.COM automatically
                returns you to the menu.

              _ To exit from an option without making any changes,

                press <CTRL/Z>. You will return to the menu.

              _ To exit from X25ROUCONFIG.COM, press <CTRL/Z> at the

                menu.

             Note that the X25router 2000 is called a "DECrouter"
             in some of the text displayed on the screen.

          4-2      X25router 2000 Installation Procedures (VMS)

 






             If you select the Add, Delete or Swap options, NCP mes-
             sages may be displayed when you have completed the op-
             tion. For details of error messages, see the VAX/VMS
             System Messages and Recovery Procedures Reference Manual.



          4.1.1 Starting X25ROUCONFIG.COM

             To start running X25ROUCONFIG.COM, follow these steps:

              1.Log into the system account, or any account with OPER
                and SYSPRV privileges.

              2.Enter the following command:

                  $ @SYS$SYSROOT:[DECSERVER]X25ROUCONFIG

                The display reminds you that each X25router 2000 must
                have a unique DECnet node name and DECnet node ad-
                dress. The procedure then prompts you:

                  Press <RET> to start, or <CTRL/Z> to exit...

              3.If you press <RET>, X25ROUCONFIG.COM displays:

                           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 - Upgrade existing DECrouters
                             CTRL/Z - Exit from this procedure

                   Your choice:

          4.1.2 X25ROUCONFIG.COM options

             Options 1 to 5 are described in Sections 4.1.2.1 to 4.1.2.5
             below.

          Configuring the X25router 2000                      4-3

 






          4.1.2.1 List Known DECrouters

             This shows information about the load host database in-
             cluding the names of the load and dump files used. For
             example:

               DECnet  DECnet Router  Service
               Address Node   Type    Circuit  Ethernet Address   Load File   Dump File
               ------- ------ ------  -------  ----------------   ----------- ---------
               12.1001 KANGA  X25ROU  QNA-0    08-00-2B-02-CC-24  X25011.SYS  X25KANGA.DMP
               12.1002 KOALA  X25ROU  QNA-0    08-00-2B-02-AA-23  X25011.SYS  X25KOALA.DMP

               Total of 2 DECrouters defined.

             The naming conventions for the load and dump files are:

             X25011.SYS for load files

             X25router.DMP for dump files, where router is the node
             name of the X25router 2000.

          4.1.2.2 Add a DECrouter

             This option allows you to add an X25router 2000 to your
             system. It displays the following prompts:

              1.DECrouter type (DR200, DR2000, X25ROU):

                Specify X25ROU for an X25router 2000.

              2.DECnet node name for unit:

                Specify a DECnet node name for the X25router 2000.
                This must be up to six alphanumeric characters, at
                least one of which must be a letter.

                The name must be unique on your DECnet network.




          4-4      X25router 2000 Installation Procedures (VMS)

 






              3.DECnet node address for unit:

                Specify the DECnet node address for the X25router
                2000. This is a number from 1 to 1023.

                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 exam-
                ple, if an address is 12.1001, 12 is the area num-
                ber 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.

                The number you specify must be unique on your DECnet
                network. It must not already exist in the DECnet node
                database for your load host. If you enter a DECnet
                node address that is already in the database, the
                following will happen:

                 _ An X25ROUCONFIG.COM error will be displayed.

                 _ Nothing will be added to the database.

                 _ You will exit from the ADD option and return to

                   the menu.

              4.Ethernet address for unit (nn-nn-nn-nn-nn-nn):

                Specify the Ethernet address of the X25router 2000.
                This address is on the back of the DEC MicroServer
                hardware unit, and is on the DEC MicroServer Systems
                Configuration Card. Enter the Ethernet address as
                six pairs of hexadecimal digits, with a hyphen sep-
                arating each pair. For example:

                08-00-2B-00-11-AB

              5.DECnet Service Circuit-ID [ddd-0]:

                In the prompt, ddd is an acronym that indicates an
                Ethernet controller type. It will be one of the fol-
                lowing:

                   UNA for DEUNA or DELUA
                   QNA for DEQNA
                   BNA for DEBNA or DEBNT (VMS V4.7 only)
                   SVA for DESVA

          Configuring the X25router 2000                      4-5

 






                The DEBNT is not supported on VMS V5.0 and later.
                It is supported on VMS V4.7.

                To accept the default, simply press <RET>.

                You can specify a different service circuit-ID from
                the default. Usually, you only need to change the
                integer, as the acronym denotes a supported Ethernet
                controller type for your CPU type. However, you can
                change both the acronym and the integer if you wish.

                If you change the service circuit-ID, the new circuit-
                ID becomes the default.

             Once you have specified the service circuit-ID, X25ROUCONFIG.COM
             adds the new X25router 2000 entry to the database, and
             sets SERVICE ENABLED on the circuit supporting the Ethernet
             controller. This allows the load host to down-line load
             the X25router 2000 software to the DEC MicroServer.

             When X25ROUCONFIG.COM sets SERVICE ENABLED on the cir-
             cuit, this may cause the circuit to be turned off and
             then turned on again. This in turn may cause events to
             be logged.

             If an NCP error message is displayed while you are adding
             an X25router 2000, the entry will be added to the load
             host database, but will not be added to the DECnet node
             databases. Therefore, you should immediately use Option
             4 to delete the entry, locate and fix the condition that
             is responsible for the DECnet error, and return to Option
             2 to add the entry again.

          4.1.2.3 Swap an Existing DECrouter

             This option allows you to swap an existing X25router
             2000 for a new hardware unit but retain the original
             DECnet address. The Swap option is useful when you want
             to replace a faulty hardware unit. X25ROUCONFIG.COM asks
             you to specify the new Ethernet address.

          4-6      X25router 2000 Installation Procedures (VMS)

 






             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 X25ROUCONFIG 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 X25router 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 X25ROU to replace node-name.

             Specify the Ethernet address of the new unit. This ad-
             dress is situated on the back of the hardware unit, and
             is on the DEC MicroServer Systems Configuration Card.
             Enter the Ethernet address as six pairs of hexadeci-
             mal digits, with a hyphen separating each pair. For ex-
             ample:

             08-00-2B-00-11-AB

          4.1.2.4 Delete an Existing DECrouter

             You use this option to delete an X25router 2000 from
             the database. You might want to do this when you re-
             configure the network or change the load hosts.

             X25ROUCONFIG.COM prompts you for the name of the X25router
             2000:

               What is the DECnet node name of the unit you want to delete?
               (CTRL/Z to return to menu)


          Configuring the X25router 2000                      4-7

 






             Specify the DECnet node name of the X25router 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, X25ROUCONFIG.COM informs
             you about this, and returns you to the menu.

          4.1.2.5 Restore Existing DECrouters

             You use this option to restore information about X25router
             2000s in the load host database to the DECnet node database
             on the load host. The Restore option affects both the
             volatile and the permanent DECnet node databases.

             You might need to do this in the following circumstances.
             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. In these circumstances, Digital advises
             that you define only the DECnet address and node name
             of each X25router 2000 in the central database, as only
             the load hosts need any more information. If you do this,
             you will need to restore the X25router 2000 informa-
             tion from the load host database on a node to the DECnet
             node database on that node. You will need to do this
             each time you copy the DECnet node database from the
             central node.

             The following messages confirm that the configurations
             have been restored.

               Restoring existing DECrouters from to host DECnet database.
               Host DECnet database successfully restored.







          4-8      X25router 2000 Installation Procedures (VMS)

 






          4.1.2.6 Upgrade Existing DECrouters

             This option allows you to upgrade X25router 2000 en-
             tries in the load host and DECnet node databases from
             the previous version of X25router 2000 software to the
             current version.

             You can either specify the node name of the X25router
             2000 that you wish to upgrade, or specify all X25router
             2000s.

             The procedure displays the following message:

                   If  you  use  this option, and you have more than one load
                   host for any  DECrouters, you must modify the database for
                   each  load host. To do  this, execute X25ROUCONFIG on each
                   load host, and select the UPGRADE option.

                   Enter the node name of the DECrouter to upgrade. To upgrade
                   all defined DECrouters enter *.

               What is the DECnet node name of the DECrouter ?

             Enter the DECnet node name of the X25router 2000 that
             you want to upgrade.

             The procedure then displays:

               DECrouter node-name to be upgraded to SYS$COMMON:[DECSERVER]X25011.SYS
               Executing NCP commands to upgrade DECrouters

          4.1.3 Restoring the Configuration Automatically

             You can automate the menu option Restore Existing DECrouters
             by running X25ROUCONFIG.COM with the RESTORE parame-
             ter:

               $ @SYS$SYSROOT:[DECSERVER]X25ROUCONFIG RESTORE

             The RESTORE parameter bypasses the menu and automat-
             ically runs the restore procedure described in Section
             4.1.2.5.

          Configuring the X25router 2000                      4-9

 






             If you want this automatically done at system start-
             up, include the following statement after the line @SYS$MANAGER:STARTNET
             in the start-up command procedure:

               @SYS$SYSROOT:[DECSERVER]X25ROUCONFIG RESTORE


          4.2 Using X25ROUSETUP.COM

             You run X25ROUSETUP.COM to configure the X25router 2000
             permanent database. In most cases, this is all you need
             to do to set up this database. If you wish to tailor
             the database to your specific networking requirements,
             you should run X25ROUPERM.EXE, described in the X25router
             2000 Management Guide.

             When you run X25ROUSETUP.COM, it prompts you with a se-
             ries of questions. You can obtain HELP at any time by
             entering a ?. You can exit from the procedure by typ-
             ing <CTRL/Z>.

             Section 4.2.1 describes how to configure the X25router
             2000 for the DEC MicroServer (DEMSA); Section 4.2.2 de-
             scribes how to configure it for the DEC MicroServer-
             SP (DEMSB).

             In the next sections, the screen prompts are shown in
             a series of numbered steps. These step numbers do not
             appear on the screen. Their purpose is to guide you through
             the procedure.

             X25ROUSETUP.COM contains four stages:

              _ Enter information about the type of X25router 2000

                and about access control.

              _ Enter information about X.25 connections.

              _ Enter information about X25-SERVER destinations.

              _ Enter information about DECnet circuits.

          4-10     X25router 2000 Installation Procedures (VMS)

 






          4.2.1 Running X25ROUSETUP.COM: DEMSA

             Follow these steps:

              1.Log into the system account, or any account with OPER
                and SYSPRV privileges, and enter the following com-
                mand:

                  $ @SYS$SYSROOT:[DECSERVER]X25ROUSETUP

              2.X25ROUSETUP.COM displays:

                      This command procedure sets up the permanent database for
                      the X25router 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.

                      X25router 2000 node name     (node-id):

                Enter the DECnet node name for the X25router 2000.

                This name can consist of up to six alphanumeric char-
                acters, the first of which must be alphabetic. The
                name identifies the X25router 2000 within the net-
                work, and should therefore be unique within the net-
                work.

              3.The procedure now displays:

                      X25router 2000 type [DEMSA, DEMSB]:

                Enter DEMSA. To configure X25router 2000 for the DEMSB
                hardware unit, see Section 4.2.2.

              4.If you enter a node name which already exists, the
                procedure displays:

                      A configuration file for node already exists.

                      You may  either keep the existing configuration file and
                      modify it or create a new database.

                  Do you want to create a new database [YES]?

          Configuring the X25router 2000                     4-11

 






                If you answer YES, the procedure displays:

                      The old configuration file for node will be
                      renamed to new-name

                A new version of the configuration file will be cre-
                ated. The previous version will be renamed and stored
                in the SYS$COMMON:[DECSERVER] directory.

                If you answer NO, the procedure asks:

                  Do you want to change the EXECUTOR characteristics now [YES]?

                Answer YES to change the DECnet EXECUTOR character-
                istics of your X25router 2000 node. If you answer
                NO, the procedure goes to a later stage of the pro-
                cedure, which involves defining the PSDNs and DTEs
                for each network.

              5.The procedure now displays:

                      Your X25router 2000 can be one of three types of DECnet
                      node:

                          NONROUTING (end node)
                          ROUTING IV (level 1 router)
                          AREA       (level 2 router)

                      Specify the type you require.

                      Node type            [NONROUTING]:

                If your configuration will use any DLM or DDCMP cir-
                cuits, you must specify AREA or ROUTING IV. Specify
                NONROUTING only if your configuration will use just
                the Ethernet circuit, or just the Ethernet circuit
                and PVC circuits.

                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.

              6.If you specified NONROUTING, you now go to Step 8,
                which asks about the X25router 2000 type.

                If you specified ROUTING IV or AREA, the procedure
                displays:

                      Ethernet circuit cost         [4]:

          4-12     X25router 2000 Installation Procedures (VMS)

 






                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 small-
                est cost.

                The procedure now displays:

                      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.

              7.The procedure now displays:

                      If  you  want  to  use incoming datalink mapping (DLM)
                      circuits you need to specify a subaddress range to use
                      to pass the incoming X.25 calls to DECnet.

                      If you do  not want to use incoming DLM circuits, just
                      press <RETURN> to continue.

                      Subaddress range           [NONE]:

                A subaddress is used to identify which software a
                call is to be routed to. It must be a decimal num-
                ber of up to four digits.

                To use incoming DLM circuits, enter the subaddress
                or range of subaddresses for incoming X.25 calls to
                be passed to DLM. The range should be in the form:
                n-N, where n is the bottom of the range, and N is
                the top of the range. For example, for subaddresses
                ranging from 90 to 99, enter: 90-99.

              8.The procedure now displays:

                      The X25router 2000 supports the following combinations
                      of lines,  line speeds and ports. Specify the type you
                      require.

                      Type    Number of lines    Maximum Speed         Ports
                                                  (per second)

                        1            4               64 K            0,1,2,3
                        2            3              256 K            0,1,2
                        3            2              384 K            0,1

                      Type                          [1]:

          Configuring the X25router 2000                     4-13

 






                Specify Type 1 or 2.

              9.The procedure now displays:

                      Enter the username  and password to be used to control
                      access  to  the  X25router 2000.  If  you specify this
                      information here,  then it must be  supplied  whenever
                      lines,  DTEs  or  circuits on the  X25router 2000  are
                      being modified.

                      If this  information  is  not specified,  anyone  can
                      modify the X25router 2000. DIGITAL STRONGLY RECOMMENDS
                      that you specify access control for the NML object.

                  NML Username [NONE]:
                  NML Password:
                  Verification:

                If you supply an NML username and password, only users
                who supply this username and password will be al-
                lowed to alter the X25router 2000 volatile database.
                The username and password each consist of up to 16
                alphanumeric or punctuation characters.

                Digital strongly recommends that you specify an NML
                username and password. Otherwise, any user on the
                network can modify your X25router 2000.

                Remember what you specify for the username and pass-
                word, as you will need it to modify the X25router
                2000 volatile database.

                For example, to gain access to the X25router 2000
                volatile database which has a username "ENGLAND" and
                a password "LONDON", and is on a node called "EUROPE",
                you would use the command:

                  NCP>set executor node EUROPE user ENGLAND password LONDON

                For more details about using the username and pass-
                word, see the X25router 2000 Management Guide.

              10.Theprocedure now displays:

          4-14     X25router 2000 Installation Procedures (VMS)

 






                      Enter  the  username  and password to be used for the
                      TRACE utility. If you specify  this  information here,
                      then it must be supplied when using the TRACE utility
                      on the X25router 2000.

                      If this  information  is  not  specified,  anyone  can
                      monitor the traffic on  the  X25router 2000.

                      DIGITAL STRONGLY RECOMMENDS that you set up a username
                      and password for the TRACE utility.

                  TRACE Username [NONE]:
                  TRACE Password:
                  Verification:

                If you supply a TRACE username and password here,
                only those who supply this username and password will
                be allowed to use the TRACE utility to monitor traf-
                fic on this X25router 2000. The username and pass-
                word each consist of up to 16 alphanumeric or punc-
                tuation characters.

                Digital strongly recommends that you set up a user-
                name and password for the TRACE utility. Otherwise,
                any user within the network with OPER privileges and
                TRACE installed on their VMS node can monitor the
                traffic on your X25router 2000.

                Remember what you specify for the username and pass-
                word, as you will need it when you use the TRACE util-
                ity.

                For example, if you wished to use the TRACE util-
                ity on an X25router 2000 on a node called "AFRICA",
                with a TRACE username "MOROCCO" and password "CASABLANCA",
                you would use the command:

                  TRACE>start AFRICA"MOROCCO CASABLANCA"::X25L2

                where X25L2 is the tracepoint name.

                For more details of using the TRACE utility, see the
                X25router 2000 Problem Solving Guide.

              11.Theprocedure now displays a list of configurator
                commands it will use to update the X25router 2000
                permanent database with the information given so far.
                It also asks:

          Configuring the X25router 2000                     4-15

 






                  Do you want the permanent database defined now [YES]?

                If you are configuring a new X25router 2000, you must
                answer YES, or the procedure will not continue. If
                you wish to modify the configuration of an exist-
                ing X25router 2000, you should also answer YES.

                You should answer NO only if this X25router 2000 has
                previously been configured, and you do not want to
                change the configuration. If you answer NO, the pro-
                cedure will simply continue.

              12.Theprocedure now displays:

                      This command  procedure  allows  you to  define  one or
                      more  PSDN(s) and one or more DTEs associated with each
                      network.

                  Do you want to define the X25-PROTOCOL database now [YES]?

                Answer YES if you want to define the PSDNs and DTEs
                associated with each network. If you answer NO, you
                will go to a later stage of the procedure, to set
                up X25-SERVER destinations.

                If you answer YES, the procedure continues:

                      You can  use  this  procedure to purge the database to
                      remove all  line,   DTE  and X.25 protocol information
                      before updating the permanent database.

                      The following  configurator command will be used to
                      purge the line permanent database:

                      PURGE known lines all

                      The following configurator commands will be used to
                      purge the DTE and X.25 permanent database:

                      PURGE module x25-protocol known networks all
                      PURGE module x25-protocol known dtes known networks all

                  Do you want the information in the line permanent database
                  to be purged [NO]?

          4-16     X25router 2000 Installation Procedures (VMS)

 






                If you wish to keep previous definitions for lines
                (including DDCMP lines), press <RET>. The procedure
                then asks:

                  Do you want the information in the X.25 and DTE
                  permanent database purged [NO]?

                If you wish to keep previous definitions for DTEs,
                press <RET>. If you enter YES, to purge the databases,
                you will see this message:

                      A command procedure will now be executed to perform
                      the requested definitions.

                      Please ignore any error messages.

                Ignore any error messages that may appear.

              13.Theprocedure now displays:

                      PSDN and profile names are defined here. You can define
                      one or more PSDNs.  For each PSDN  you will be asked to
                      provide the  network name and the profile name for that
                      network.

                      Network name   (string):

                Enter the network name that connects to the PSDN.
                For details of network names, see Section 1.2.

                If you do not want to enter a network name, press
                <RET>. The procedure will ask:

                  Do you want to define any more networks [NO]?

                If you answer YES, you will be asked for a network
                name again.

                If you answer NO, the procedure will update the X25router
                2000 permanent database with any network(s) you have
                defined. You will then go to a later stage of the
                procedure, to set up X25-SERVER destinations.

                If you do enter a network name, the procedure will
                display:

                      Profile name   (string) [network-id]:

          Configuring the X25router 2000                     4-17

 






                Enter the profile name of the PSDN to which the DTE
                will connect. Refer to Section 1.3 in Chapter 1 for
                details of profile names. If the profile name is iden-
                tical with the network name, simply press <RET>.

              14.Theprocedure now displays:

                      The following configurator command will be used to
                      update the permanent database:

                      DEFINE module x25-protocol network network-id  -
                                                 profile profile-name

                  Do you want the information in the permanent database
                  updated  [YES]?

                If you answer NO, the permanent database will not
                be updated. (You may enter the required NCP commands
                later, if you wish.) You will be asked if you want
                to define any more networks; see the previous step.

                If you want the database updated, answer YES.

              15.Theprocedure now displays:

                      DTEs are  defined  here.  You  can  define  one or more
                      DTEs connected  to this network. For each DTE  you will
                      be asked to provide the following information:

                          o   DTE address
                          o   Range of channels to be used by the DTE
                          o   Synchronous port number to be used by the line
                          o   Line associated with the DTE

                      DTE address       (number):

                Enter your DTE address. For details on the format
                of this address, see the  Public Network Information
                manual.

                The procedure now displays:

                      Channels range      (list):

                Enter the channels that the DTE will use for out-
                going calls. Specify high-numbered channels before
                low-numbered channels. Each entry in the channels
                list can be either a single channel number or a chan-
                nel range (with a hyphen separating the high and low

          4-18     X25router 2000 Installation Procedures (VMS)

 






                numbers). The entries in the list must be separated
                by commas. For example:

                Channels range (list):1555,1544-1540,1536

                The PSDN authorities allocate channel ranges at sub-
                scription time. For details on the channel ranges
                your PSDN can allocate, see the Public Network Information
                manual.

                The procedure now displays:

                      Synchronous port     (0-3):

                Enter the number of the synchronous port on the X25router
                2000 that will be used for the DTE.

                      Line name (string) [X25-n]:

                Enter the name of the line that the DTE will use,
                in the form:

                        X25-string

                where string is a string of up to 12 alphanumeric
                characters. The default line name is X25-n, where
                n is the number of the synchronous port.

              16.Theprocedure now displays:

                      The following configurator commands will be used to update
                      the permanent database.

                      DEFINE line line-id
                          protocol lapb -
                          network network-id -
                          device SYN-n -
                          state on

                      DEFINE module x25-protocol dte dte-address  -
                          network network-id -
                          channels  channel-list -
                          line line-id  -
                          state on

                  Do you want to update the permanent database now  [YES]?

                If you answer NO, the permanent database will not
                be updated.

                If you want the database updated, answer YES.

          Configuring the X25router 2000                     4-19

 






                The procedure now asks:

                  Do you want to define any more DTEs connected
                  to this network [NO]?

                Answer YES if more DTEs are required for this net-
                work. The procedure then repeats the questions to
                define a DTE. When you have finished defining all
                DTEs, and this question appears again, answer NO.

              17.Theprocedure now asks:

                  Do you want to define any more networks [NO]?

                Answer YES to define more networks. The procedure
                then repeats the questions to define DTEs for the
                next network. If you have finished defining networks,
                answer NO.

                The procedure now displays:

                      A command  procedure  will  now  be  executed  to perform
                      the requested  definitions.

                  X25ROUperm V1.1, X25router 2000 configuration program
                  %X25ROUPERM-I-FILUPD, configuration file updated

              18.Theprocedure now displays:

                      X25-SERVER destinations are set up  here.  These  permit
                      incoming calls received by this node to be redirected to
                      the appropriate host.  This  procedure  asks  for a list
                      of hosts with P.S.I. Access installed.

                  Do you want to define the X25-SERVER database now [YES]?

                X25-SERVER destinations allow incoming calls to be
                directed to VAX P.S.I. Access nodes. If you intend
                using the X25router 2000 as a connector node for VAX
                P.S.I. Access systems, you should now set up X25-
                SERVER destinations for those incoming calls des-
                tined for Access hosts.

                Answer YES to define the X25-SERVER database. If you
                answer NO, the procedure goes on to defining DECnet
                circuits, Step 22.

          4-20     X25router 2000 Installation Procedures (VMS)

 






              19.Ifyou answer YES, the procedure displays:

                      Destination name  (string)                 :

                Destinations are used by the X25router 2000 system
                to identify the destinations of incoming calls so
                that they are directed to the correct Access nodes.
                The destination name is a string of up to 16 alphanu-
                meric characters.

                See the information you supplied in Section 2.2.3
                for the destination names for your system.

                The procedure now displays:

                      Destination node name  (string)                 :

                The destination node name is the name of the VAX P.S.I.
                Access node to which incoming calls should be di-
                rected.

                The procedure now displays:

                      Destination priority                       [0]  :

                Destination priority is the processing priority for
                the redirection of incoming calls to the destina-
                tion. Priority is an integer number in the range 0
                to 255.

                The rest of the parameters are optional. If you do
                not specify them, they will not be checked when an
                incoming call arrives.

                      Call mask              (2-32 hex)        [None] :

                The call mask is used in conjunction with a call value,
                and determines whether the incoming call is accepted.
                Enter a hexadecimal value of between 2 and 32 dig-
                its.

                      Call value             (2-32 hex)        [None] :

          Configuring the X25router 2000                     4-21

 






                Call value specifies the string used to test incom-
                ing call data. The user-data field in the incoming
                call is matched using the call mask. If it then matches
                the call value, the incoming call is accepted.

                      Closed user group name (1-16 characters) [None] :

                Closed user group (CUG) specifies which user group
                (CUG or bilateral CUG) has access to the destina-
                tion.

                      Sending address        (1-15 decimal)    [None] :

                This specifies which remote DTE addresses have ac-
                cess to the destination. If none is specified, all
                call requests from remote DTEs are accepted. Wildcards
                (* and %) may be used in this address.

                      Subaddress range       (decimal range)   [None] :

                The subaddress is used to determine whether an in-
                coming call is to be accepted. If the subaddress of
                the incoming call is within the subaddress range,
                the call request is accepted. If none is specified,
                call requests with any subaddress are accepted. Enter
                only one range, for example, 50-99 or 122 or 1010-
                1234. Specify a range which is different from the
                range you specified earlier for incoming DLM cir-
                cuits, to distinguish the two.

                      Object identification  (string)          [36]   :

                As VAX P.S.I. Access requires a value of 36 for this
                parameter (the default value), simply press <RET>.

              20.Theprocedure now displays:

                      The destination will be set up using the following
                      configurator commands:


          4-22     X25router 2000 Installation Procedures (VMS)

 






                      DEFINE node node-id name node-name
                      DEFINE module x25-server -
                              destination dest-name -
                              node dest-node -
                              [priority dest-priority] -
                              [call mask call-mask] -
                              [call value call-value] -
                              [group cug-name] -
                              [sending address dte-address] -
                              [subaddress sub-address-range] -
                              [user user-id] -
                              [password password] -
                              [account account-name] -
                              [object object-id]

                Only the fields you have specified will be displayed.

                The procedure also asks:

                  Do you want to define this destination now  [YES]?

                Answer YES to execute the configurator commands. If
                you answer NO, the procedure will not execute the
                configurator commands.

              21.Theprocedure now asks:

                  Do you want to define any more destinations  [NO]?

                If you have further destinations to set up, answer
                YES.

                If you enter NO to indicate that you have finished
                defining destinations, the procedure displays:

                      A command procedure will now be executed to perform the
                      requested definitions.

                  X25ROUperm V1.1, X25router 2000 Configuration Program

                  %X25ROUPERM-I-FILUPD configuration file updated

              22.Youare now asked about the circuits that you want
                to use with the X25router 2000. The procedure dis-
                plays:

                      You may  now  define  the DECnet and X.25 PVCs you will
                      use on the X25router 2000.

                  Do you want to define the circuit database now [YES]?

          Configuring the X25router 2000                     4-23

 






                Answer YES if you wish to set up any of the follow-
                ing: DLM circuits; DDCMP circuits; PVC circuits.

                Note that if you specified NONROUTING IV for this
                X25router 2000, you can only set up PVC circuits here.

              23.Theprocedure now asks:

                      You can  use  this  procedure to purge the database to
                      remove all  DECnet and X.25 circuit information before
                      updating the permanent database.

                      The following  configurator  command  will  be used to
                      purge the circuit permanent database:

                      PURGE known circuits all

                  Do you want the information in the circuit permanent database
                  purged [NO]?

                If you answer YES, the circuit database is purged
                to remove all existing DECnet and X.25 circuit in-
                formation.

              24.Theprocedure now displays:

                      You can now define the circuits and lines to be used.
                      The circuit types are DDCMP, DLM and PVC.

                      DDCMP circuits
                      --------------

                      You can define up to four DDCMP circuits for the DEMSA
                      and one circuit for the DEMSB.

                      DDCMP lines may have any name that does not begin with
                      PVC-

                      For  each  DDCMP circuit you define, a line will also be
                      configured  to  run the DDCMP  protocol. Note that for a
                      DEMSB, you can have either an X.25 line, or a DDCMP line.

                      DLM circuits
                      ------------

                      You may define up to sixty-three DLM circuits  for  the
                      DEMSA,  but only two DLM circuits for the DEMSB.

                      You may use any name for DLM circuits that does not begin
                      with  PVC-.

                      PVCs
                      ----

          4-24     X25router 2000 Installation Procedures (VMS)

 






                      You  can define up to  512 PVCs for the DEMSA, but only
                      sixteen PVCs for the DEMSB. Note that for each  DLM you
                      define, you can define one less PVC.

                      You must start  the circuit name  with the  string PVC-,
                      except for DLM PVCs.

                      Circuit name      (string):

                Enter the circuit name for the first circuit.

                To set up a PVC circuit, enter a name that begins
                PVC-.

                To set up a DLM or DDCMP circuit, enter a name that
                does not begin PVC-. Skip to Step 26.

              25.Ifyou enter a name that begins PVC-, the procedure
                displays:

                      This circuit is a PVC.

                      Please enter the required circuit information.

                      Local DTE         (number):

                When you have entered a local DTE, the procedure dis-
                plays:

                      Network           (string):

                When you have entered the network name, the proce-
                dure displays:

                      Channel           (number):

                When you have entered a channel number, the proce-
                dure displays the configurator command it will use
                to define the circuit. It then asks if you want to
                define any more circuits; see Step 29.

              26.Ifyou enter a name that does not begin with PVC,
                the procedure asks:

                  Circuit type [DDCMP, DLM]:

                Enter DLM to define a DLM circuit. Enter DDCMP to
                define a DDCMP circuit; you will then skip to Step
                28.

          Configuring the X25router 2000                     4-25

 






              27.Ifyou enter DLM, the procedure displays:

                      You must now specify the usage as INCOMING, OUTGOING or
                      PERMANENT

                      Usage                     :

                If you have specified the usage as INCOMING or OUTGOING,
                the procedure asks first for:

                      Remote DTE        (number):

                For all types of usage, the procedure asks for:

                      Local DTE         (number):
                      Network           (string):

                If you have specified PERMANENT or OUTGOING, you must
                supply the network name here. This is optional for
                INCOMING.

                If you have specified OUTGOING, you will be asked
                for:

                      Recall timer (number) [60]:
                      Maximum recalls (number) [100]:

                If you have specified PERMANENT, you will be asked
                for:

                      Channel           (number):

                For all types of usage, the procedure now asks for:

                      Circuit cost  (number) [5]:
                      State         (string) [ON]:

                The cost is a value assigned to a circuit between
                two adjacent nodes. Packets are routed on paths with
                the least cost.

                The procedure now continues at Step 29.

          4-26     X25router 2000 Installation Procedures (VMS)

 






              28.Ifyou enter DDCMP, the procedure displays:

                      This circuit is a DDCMP circuit.

                      Please enter the information about the line which will
                      be used for this circuit.

                      Line name   (string) [circuit-name]:

                The default line name is the circuit name. If you
                do not use the default, specify a string of between
                1 and 16 alphanumeric characters.

                The procedure now displays:

                      Synchronous port  (0-3) :
                      Circuit cost  (number) [5] :

                The cost is a value assigned to a circuit between
                two adjacent nodes. Packets are routed on paths with
                the least cost.

              29.Theprocedure now displays the configurator commands
                it will use to set up the circuit, and asks:

                  Do you want the information in the permanent database updated  [YES]?

                Enter YES to update the permanent database with cir-
                cuit information.

                The procedure now asks:

                  Do you want to define any more circuits [NO]?

                If you answer YES, the procedure will ask for an-
                other circuit name. If you have finished defining
                all the circuits, answer NO.

              30.Onceyou have finished defining circuits, X25ROUSETUP.COM
                ends, with the message:

                      A command procedure will now be executed to perform the
                      requested definitions.

                      X25ROUSETUP complete.

                      The databases are now set up and you may load the
                      X25router 2000.

          Configuring the X25router 2000                     4-27

 






             Now you need to load the X25router 2000. See Section
             4.3 for details.


          4.2.2 Running X25ROUSETUP.COM: DEMSB

             To run X25ROUSETUP.COM, follow these steps:

              1.Log into the system account, or any account with OPER
                and SYSPRV privileges, and enter the following com-
                mand:

                  $ @SYS$SYSROOT:[DECSERVER]X25ROUSETUP

              2.X25ROUSETUP.COM displays:

                      This command procedure sets up the permanent database for
                      the X25router 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.

                      X25router 2000 node name     (node-id):

                Enter the DECnet node name for the X25router 2000.

                This name can consist of up to six alphanumeric char-
                acters, the first of which must be alphabetic. The
                name identifies the X25router 2000 within the net-
                work, and should therefore be unique within the net-
                work.

              3.The procedure now displays:

                      X25router 2000 type [DEMSA, DEMSB]:

                Enter DEMSB. To configure a DEMSA X25router 2000,
                see Section 4.2.1.

              4.If you enter a node name which already exists, the
                procedure displays:

          4-28     X25router 2000 Installation Procedures (VMS)

 






                    A configuration file for node already exists.

                    You may either keep the existing configuration file and
                    modify it or create a new database.

                  Do you want to create a new database [YES]?

                If you answer YES, the procedure displays:

                      The old configuration file for node will
                      be renamed to new-name.

                A new version of the configuration file is created.
                The previous version is renamed and stored in the
                SYS$COMMON:[DECSERVER] directory.

                If you answer NO, the procedure asks:

                      Do you want to change the EXECUTOR characteristics now [YES]?

                Answer YES to change the DECnet EXECUTOR character-
                istics of your X25router 2000 node. If you answer
                NO, the procedure goes to a later stage of the pro-
                cedure, which involves defining the PSDNs and DTEs
                for each network.

              5.The procedure now displays:

                      Your X25router 2000 can be one of two types of DECnet
                      node:

                          NONROUTING (end node)
                          ROUTING IV (level 1 router)

                      Specify the type you require.

                      Node type            [NONROUTING]:

                If your configuration will use any DLM or DDCMP cir-
                cuits, you must specify ROUTING IV. Specify NONROUTING
                only if your configuration will use just the Ethernet
                circuit, or just the Ethernet circuit and PVC cir-
                cuits.

              6.If you specified NONROUTING, you now go to Step 8.

                If you specified ROUTING IV, the procedure displays:

                      Ethernet circuit cost [4]:

          Configuring the X25router 2000                     4-29

 






                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 small-
                est cost.

                The procedure now displays:

                      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.

              7.The procedure now displays:

                      If  you  want  to  use  incoming  datalink mapping (DLM)
                      circuits you need to specify a  subaddress  range to use
                      to pass the incoming X.25 calls to DECnet.

                      If you  do  not want to use  incoming DLM circuits, just
                      press <RETURN> to continue.

                      Subaddress range           [NONE]:

                A subaddress is an optional address, which can be
                used to decide to which software a call is to be routed.
                It must be a decimal number of up to four digits.

                To use incoming DLM circuits, enter the subaddress
                or range of subaddresses for incoming X.25 calls to
                be passed to DLM. The range of subaddresses should
                be in the form: n-N, where n is the bottom of the
                range, and N is the top of the range. For example,
                for subaddresses ranging from 90 to 99, enter: 90-
                99.

              8.The procedure now displays details about the type
                of X25router 2000:

                      The X25router 2000 is configured as follows.

                      Number of lines    Maximum Speed          Ports
                                         (per second)

                      1                  19.2 Kb                0

          4-30     X25router 2000 Installation Procedures (VMS)

 






              9.The procedure goes on to ask about access control:

                      Enter the  username and password to be used to control
                      access  to  the  X25router 2000.  If  you specify this
                      information here, then it must  be  supplied  whenever
                      lines,  DTEs  or  circuits  on the  X25router 2000 are
                      being modified.

                      If  this information  is  not specified, anyone can
                      modify the X25router 2000. DIGITAL STRONGLY RECOMMENDS
                      that you specify access control for the NML object.

                      NML Username [NONE]:
                      NML Password:
                      Verification:

                If you supply an NML username and password, only users
                who supply this username and password will be al-
                lowed to alter the X25router 2000 permanent database.
                The username and password each consist of up to 16
                alphanumeric or punctuation characters.

                If you do not wish to supply the username and pass-
                word, simply press <RET> in response to the prompts.
                However, Digital strongly recommends that you spec-
                ify access control for the NML object. Otherwise,
                any user on the network can modify your X25router
                2000.

                Remember what you specify for the username and pass-
                word, as you will need it to modify the X25router
                2000 volatile database.

                For example, to gain access to the X25router 2000
                volatile database which has a username "ENGLAND" and
                a password "LONDON", and is on a node called "EUROPE",
                you would use the command:

                  NCP>set executor node EUROPE user ENGLAND password LONDON

                For more details about using the username and pass-
                word, see the X25router 2000 Management Guide.

          Configuring the X25router 2000                     4-31

 






              10.Theprocedure now displays:

                      Enter the  username  and  password to be used for the
                      TRACE utility.  If you specify  this information here,
                      then it must be supplied when using the TRACE utility
                      on the X25router 2000.

                      If this  information  is  not  specified, anyone can
                      monitor  traffic on  the  X25router 2000.

                      DIGITAL STRONGLY RECOMMENDS that you set up a username
                      and password for the TRACE utility.

                  TRACE Username [NONE]:
                  TRACE Password:
                  Verification:

                If you supply a TRACE username and password here,
                only those who supply this username and password will
                be allowed to use the TRACE utility to monitor traf-
                fic on this X25router 2000. The username and pass-
                word each consist of up to 16 alphanumeric or punc-
                tuation characters.

                If you do not wish to supply the username and pass-
                word, simply press <RET> in response to the prompts.
                However, Digital strongly recommends that you spec-
                ify a username and password for the TRACE utility.
                If you do not, any user within the network with OPER
                privileges and TRACE installed on their VMS node can
                monitor the traffic on your X25router 2000.

                Remember what you specify for the username and pass-
                word, as you will need it when you use the TRACE util-
                ity.

                For example, if you wished to use the TRACE util-
                ity on an X25router 2000 on a node called "AFRICA",
                with a TRACE username "MOROCCO" and password "CASABLANCA",
                you would use the command:

                  TRACE>start AFRICA"MOROCCO CASABLANCA"::X25L2

                where X25L2 is the tracepoint name.

                For more details of using the TRACE utility, see the
                X25router 2000 Problem Solving Guide.

          4-32     X25router 2000 Installation Procedures (VMS)

 






              11.Theprocedure now displays a list of configurator
                commands it will use to update the X25router 2000
                permanent database with the information given so far.
                It also asks:

                  Do you want the permanent database defined now [YES]?

                If you are configuring a new X25router 2000, you must
                answer YES, or the procedure will not continue. If
                you wish to modify the configuration of an exist-
                ing X25router 2000, you should also answer YES.

                You should answer NO only if this X25router 2000 has
                previously been configured, and you do not want to
                change the configuration. In this case, if you an-
                swer NO, the procedure will simply continue.

              12.Theprocedure now displays:

                      This command  procedure  allows  you  to  define  one or
                      more PSDN(s) and one or more DTEs associated with each
                      network.

                  Do you want to define the X25-PROTOCOL database now [YES]?

                Answer YES if you want to define the PSDNs and DTEs
                associated with each network. If you answer NO, you
                will go to a later stage of the procedure, to set
                up X25-SERVER destinations.

                If you answer YES, the procedure continues:

                      You can  use this  procedure to purge the database to
                      remove  all  line,  DTE and X.25 protocol information
                      before updating the permanent database.

                      The following  configurator command will be used to
                      purge the line permanent database:

                      PURGE known lines all

                      The following configurator commands will be used to
                      purge the DTE and X.25 permanent database:

          Configuring the X25router 2000                     4-33

 






                      PURGE module x25-protocol known networks all
                      PURGE module x25-protocol known dtes known networks all

                  Do you want the information in the line permanent database
                  purged [NO]?

                If you wish to keep previous definitions for lines
                (including DDCMP lines), press <RET>. The procedure
                then asks:

                  Do you want the information in the X.25 and DTE
                  permanent database purged [NO]?

                If you wish to keep previous definitions for DTEs,
                press <RET>. If you enter YES, to purge the databases,
                you will see this message:

                      A command procedure will now be executed to perform
                      the requested definitions.

                      Please ignore any error messages.

                Igore any error messages that may appear.

              13.Theprocedure now displays:

                      PSDN and profile names are defined here. You can define
                      one or more PSDNs.  For each PSDN  you will be asked to
                      provide the  network name and the profile name for that
                      network.

                      Network name   (string):

                Enter the network name that connects to the PSDN.
                For details of network names, see Section 1.2.

                If you do not want to enter a network name, press
                <RET>. The procedure will ask:

                  Do you want to define any more networks [NO]?

                If you answer YES, you will be asked for a network
                name again.

                If you answer NO, the procedure will update the X25router
                2000 permanent database with the network(s) you have
                defined. You will then go to a later stage of the
                procedure to set up X25-SERVER destinations.

          4-34     X25router 2000 Installation Procedures (VMS)

 






                If you do enter a network name, the procedure will
                display:

                      Profile name   (string) [network-id]:

                Enter the profile name of the PSDN to which the DTE
                will connect. See Section 1.3 in Chapter 1 for de-
                tails of profile names. If the profile name is iden-
                tical with the network name, simply press <RETURN>.

              14.Theprocedure now displays:

                      The following configurator command will be used to
                      update the permanent database:

                      DEFINE module x25-protocol network network-id  -
                                                 profile profile-name

                  Do you want the information in the permanent database updated  [YES]?

                If you answer NO, the permanent database will not
                be updated. (You may enter the required NCP commands
                later, if you wish.) You will be asked if you want
                to define any more networks; see the previous step.

                If you want the database updated, answer YES.

              15.Theprocedure now displays:

                      A DTE is defined here. You can define one DTE connected
                      to  this  network.  For the  DTE  you  will be asked to
                      provide the following information:

                          o   DTE address
                          o   Range of channels to be used by the DTE
                          o   Line associated with the DTE

                      DTE address       (number):

                Enter your DTE address. For details on the format
                of this address, see the  Public Network Information
                manual.

              16.Theprocedure now displays:

                      Channels range      (list):

          Configuring the X25router 2000                     4-35

 






                Enter the channels that the DTE will use for out-
                going calls. Specify high-numbered channels before
                low-numbered channels. Each entry in the channels
                list can be either a single channel number or a chan-
                nel range (with a hyphen separating the high and low
                numbers). The entries in the list must be separated
                by commas. For example:

                Channels range (list):1555,1544-1540,1536

                The PSDN authorities allocate channel ranges at sub-
                scription time. For details on the channel range your
                PSDN can allocate, see the  Public Network Information
                manual.

                The procedure now displays:

                      Line name (string) [X25-0]:

                Enter the name of the line that the DTE will use,
                in the form:

                        X25-string

                where string is a string of up to 12 alphanumeric
                characters. The default line name is X25-0.

              17.Theprocedure now displays:

                      The following configurator commands will be used to update
                      the permanent database.

                      DEFINE line X25-0
                          protocol LAPB -
                          network network-id -
                          device SYN-0 -
                          state on

                      DEFINE module x25-protocol dte dte-address  -
                          network network-id -
                          channels  channel-list -
                          line X25-line-id  -
                          state on

                  Do you want to update the permanent database now  [YES]?

                If you answer NO, the permanent database will not
                be updated.

                If you want the database updated, answer YES.

          4-36     X25router 2000 Installation Procedures (VMS)

 






                The procedure now asks:

                  Do you want to define any more networks [NO]?

                Answer YES to define more networks. The procedure
                then repeats the questions to define the next net-
                work. If you have finished defining networks, an-
                swer NO.

                The procedure now displays:

                      A command  procedure  will  now  be  executed  to perform
                      the requested  definitions.

                  X25ROUPERM V1.1, X25router 2000 configuration program

                  %X25ROUPERM-I-FILUPD, configuration file updated

              18.Theprocedure now displays:

                      X25-SERVER destinations are set up  here.  These  permit
                      incoming calls received by this node to be redirected to
                      the appropriate host.  This  procedure  asks  for a list
                      of hosts with P.S.I. Access installed.

                  Do you want to define the X25-SERVER database now [YES]?

                X25-SERVER destinations allow incoming calls to be
                directed to VAX P.S.I. Access nodes. If you intend
                using the X25router 2000 as a connector node for VAX
                P.S.I. Access systems, you should set up X25-SERVER
                destinations here for those incoming calls destined
                for Access hosts.

                Answer YES to define the X25-SERVER database. If you
                answer NO, the procedure goes on to defining DECnet
                circuits, Step 22.

              19.Ifyou answer YES, the procedure displays:

                      Destination name       (string)                 :

                Destinations are used by the X25router 2000 system
                to identify the destinations of incoming calls so
                that they are directed to the correct Access nodes.
                The destination name is a string of up to 16 alphanu-
                meric characters.

          Configuring the X25router 2000                     4-37

 






                See the information you supplied in Section 2.2.3
                for the destination names for your system.

                The procedure now displays:

                      Destination node name  (string)                 :

                The destination node name is the name of the VAX P.S.I.
                Access node to which incoming calls should be di-
                rected.

                The procedure now displays:

                      Destination priority                       [0]  :

                Destination priority is the processing priority for
                the redirection of incoming calls to the destina-
                tion. Priority is an integer number in the range 0
                to 255.

                The rest of the parameters are optional. If you do
                not specify them, they will not be checked when an
                incoming call arrives.

                      Call mask              (2-32 hex)        [None] :

                The call mask is used in conjunction with a call value,
                and determines whether the incoming call is accepted.
                Enter a hexadecimal value of between 2 and 32 dig-
                its.

                      Call value             (2-32 hex)        [None] :

                Call value specifies the string used to test incom-
                ing call data. The user-data field in the incoming
                call is matched using the call mask. If it then matches
                the call value, the incoming call is accepted.

                      Closed user group name (1-16 characters) [None] :

                Closed user group (CUG) specifies which user group
                (CUG or bilateral CUG) has access to the destina-
                tion.

                      Sending address        (1-15 decimal)    [None] :

          4-38     X25router 2000 Installation Procedures (VMS)

 






                This specifies which remote DTE addresses have ac-
                cess to the destination. If none is specified, all
                call requests from remote DTEs are accepted. Wildcards
                (* and %) may be used in this address.

                      Subaddress range       (decimal range)   [None] :

                The subaddress is used to determine whether an in-
                coming call is to be accepted. If the subaddress of
                the incoming call is within the subaddress range,
                the call request is accepted. If none is specified,
                call requests with any subaddress are accepted. Enter
                only one range, for example, 50-99 or 122 or 1010-
                1234. Specify a range which is different from the
                range you specified earlier for incoming DLM cir-
                cuits, to distinguish the two.

                      Object identification  (string)          [36]   :

                As VAX P.S.I. Access requires a value of 36 for this
                parameter (the default value), simply press <RET>.

              20.Theprocedure now displays:

                      The destination will be set up using the following
                      configurator commands:

                      DEFINE node node-id name node-name
                      DEFINE module x25-server -
                      destination dest-name -
                      node dest-node -
                      [priority dest-prio] -
                      [call mask call-mask] -
                      [call value call-value] -
                      [group cug-name] -
                      [sending address dte-address] -
                      [subaddress sub-address-range] -
                      [user user-id] -
                      [password password] -
                      [account account-name] -
                      [object object-id]

                Only the fields you have specified will be displayed.

                The procedure also asks:

                  Do you want to define this destination now  [YES]?

          Configuring the X25router 2000                     4-39

 






                Answer YES to execute the configurator command shown
                above. If you answer NO, the procedure will not ex-
                ecute the configurator command displayed above.

              21.Theprocedure now asks:

                  Do you want to define any more destinations  [NO]?

                If you have further destinations to set up, answer
                YES.

                If you answer NO to indicate that you have finished
                defining destinations, the procedure displays:

                      A command procedure will now be executed to perform the
                      requested definitions.

                  X25ROUPERM V1.1, X25router 2000 Configuration Program

                  %X25ROUPERM-I-FILUPD configuration file updated

              22.Youare now asked about the circuits that you want
                to use with the X25router 2000. If you specified ROUTING
                IV, the procedure displays:

                      You may  now  define the DECnet and X.25 PVCs you will
                      use on the X25router 2000.

                  Do you want to define the circuit database now [YES]?

                Answer YES if you wish to set up any of the follow-
                ing: DLM circuits; DDCMP circuits; PVC circuits.

                If you specified NONROUTING, the procedure displays:

                      You  may now define the X.25 PVCs you will use on the
                      X25router 2000.

                  Do you want to define the circuit database now [YES]?

                If you specified NONROUTING, you can only set up PVC
                circuits here.

              23.Theprocedure now asks:

          4-40     X25router 2000 Installation Procedures (VMS)

 






                      You can  use  this  procedure to purge the database to
                      remove all  DECnet and X.25 circuit information before
                      updating the permanent database.

                      The following  configurator  command  will  be used to
                      purge the circuit permanent database:

                      PURGE known circuits all

                  Do you want the information in the circuit permanent database
                  purged [NO]?

                If you answer YES, the circuit database is purged
                to remove all existing DECnet and X.25 circuit in-
                formation.

              24.Ifyou specified ROUTING IV, the procedure now dis-
                plays:

                      You can now define the circuits and lines to be used.
                      The circuit types are DDCMP, DLM and PVC.

                      DDCMP circuits
                      --------------

                      You can define up to four DDCMP circuits for the DEMSA
                      and one circuit for the DEMSB.

                      DDCMP lines may have any name that does not begin PVC-.

                      For each DDCMP circuit  you define,  a line will also be
                      configured to run  the  DDCMP protocol.  Note that for a
                      DEMSB, you can have either an X.25 line, or a DDCMP line.

                      DLM circuits
                      ------------

                      You may define up to sixty-three DLM circuits for the
                      DEMSA, but only two DLM circuits for the DEMSB.

                      You may use any name for DLM circuits that does not
                      begin with  PVC-.

                      PVCs
                      ----

                      You  can  define up to 512 PVCs for the DEMSA, but only
                      sixteen PVCs for the DEMSB. Note that for each  DLM you
                      define, you can define one less PVC.

                      You must start the  circuit name with the string PVC-,
                      except for DLM PVCs.

                      Circuit name      (string):

          Configuring the X25router 2000                     4-41

 






                If you specified NONROUTING, only the text describ-
                ing PVCs is displayed. Enter the circuit name for
                the first circuit.

                To set up a PVC circuit, enter a name that begins
                PVC-.

                To set up a DDCMP or DLM circuit, enter a name that
                does not begin PVC-. Skip to Step 28.

              25.Ifyou enter a name that begins PVC-, the procedure
                displays:

                      This circuit is a PVC.

                      Please enter the required circuit information.

                      Local DTE         (number):

                When you have entered a local DTE, the procedure dis-
                plays:

                      Network           (string):

                When you have entered the network name, the proce-
                dure displays:

                      Channel           (number):

                When you have entered a channel number, the proce-
                dure displays the configurator command it will use
                to define the circuit. It then asks if you want to
                define any more circuits; see Step 29.

              26.Ifyou enter a name that does not begin with PVC,
                the procedure asks:

                  Circuit type [DDCMP, DLM]:

                Enter DLM to define a DLM circuit. Enter DDCMP to
                define a DDCMP circuit; you will then skip to Step
                28.

              27.Ifyou enter DLM, the procedure displays:

                      You must now specify the usage as INCOMING, OUTGOING or
                      PERMANENT

                      Usage                     :

          4-42     X25router 2000 Installation Procedures (VMS)

 






                If you have specified the usage as INCOMING or OUTGOING,
                the procedure asks first for:

                      Remote DTE        (number):

                For all types of usage, the procedure asks for:

                      Local DTE         (number):
                      Network           (string):

                If you have specified PERMANENT or OUTGOING, you must
                supply the network name. This is optional for INCOMING.

                If you have specified OUTGOING, you will be asked
                for:

                      Recall timer (number)  [60]:
                      Maximum recalls (number)  [100]:

                If you have specified PERMANENT, you will be asked
                for:

                      Channel           (number):

                For all types of usage, the procedure now asks for:

                      Circuit cost  (number) [5]:
                      State         (string) [ON]:

                The cost is a value assigned to a circuit between
                two adjacent nodes. Packets are routed on paths with
                the least cost.

                The procedure now continues at Step 29.

              28.Ifyou enter DDCMP, the procedure displays:

                      This circuit is a DDCMP circuit.

                      Please enter the information about the line which will
                      be used for this circuit.

                      Line name   (string) [circuit-name]:

                The default line name is the circuit name. If you
                do not use the default, specify a string of between
                1 and 16 alphanumeric characters.

          Configuring the X25router 2000                     4-43

 






                The procedure now displays:

                      Circuit cost  (number) [5] :

                The cost is a value assigned to a circuit between
                two adjacent nodes. Packets are routed on paths with
                the least cost.

              29.Theprocedure now displays the configurator commands
                it will use to set up the circuit, and asks:

                  Do you want the information in the permanent database updated  [YES]?

                Enter YES to update the permanent database with cir-
                cuit information.

                The procedure now asks:

                  Do you want to define any more circuits [NO]?

                If you answer YES, the procedure will ask for an-
                other circuit name. If you have finished defining
                all the circuits, answer NO.

              30.Onceyou have finished defining circuits, X25ROUSETUP.COM
                ends, with the message:

                      A command procedure will now be executed to perform the
                      requested definitions.

                  X25ROUPERM V1.1, X25router 2000 Configuration Program

                  X25ROUPERM-I-FILUPD configuration file updated

                      X25ROUSETUP complete.

                      The  databases   are  now  set  up  and you may load the
                      X25router 2000.

             Now you need to load the X25router 2000. See Section
             4.3 for details.

          4-44     X25router 2000 Installation Procedures (VMS)

 






          4.3 Loading the Software

              1.Enable event logging by issuing the following com-
                mands:

                  $ @SYS$SYSTEM:STARTUP OPCOM
                  $ RUN SYS$SYSTEM:NCP
                  NCP>SET LOGGING MONITOR STATE ON
                  NCP>SET LOGGING MONITOR EVENTS 0.3,7
                  NCP>EXIT
                  $ REPLY/ENABLE=NETWORK

              2.Down-line load the X25router 2000 software image to
                the DEC
                MicroServer hardware unit by plugging the unit into
                the power supply.

                The hardware unit goes through a series of diagnos-
                tic checks, and then automatically down-line loads
                the software image from the load host. Once the load
                is complete, the LED display on the hardware unit
                will show a moving pattern which indicates that the
                software is running.

             When loading the software, the X25router 2000 will try
             for 5 minutes to load the permanent database. It will
             then reboot if the database cannot be loaded.

             During the load sequence all relevant events will be
             reported on the terminal:

              _ If the event messages mention no errors, you can as-

                sume that the load has been successful, and go on
                to test the software.

              _ If errors occur, refer to the X25router 2000 Problem

                Solving Guide. First check that the hardware is work-
                ing correctly.

                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 cor-
                rect Ethernet address for the X25router 2000. Check

          Configuring the X25router 2000                     4-45

 






                that the X25router 2000 images are in the correct
                directory and that DECnet is running.

             When you have loaded the software, test the installa-
             tion, using the Installation Checkout Procedure described
             in Chapter 5.



































          4-46     X25router 2000 Installation Procedures (VMS)

 













          ______________________________________________________5

                                         Testing the Installation




          5.1 Introduction

             This chapter explains how to run the Installation Checkout
             Procedure (ICP). The ICP checks that the X25router 2000
             software is installed and configured correctly.

             The ICP consists of:

              _ An application which performs the testing. The ap-

                plication is defined as part of the X25router 2000
                initialization sequence, and declares itself as a
                DECnet object with the name X25ICP.

              _ A command file X25ROU_ICP, which you use to set up

                and run a test.

             There are three ways you can run the ICP:

              _ In loopback across a PSDN to the same X25router 2000.

                To do this, simply follow the procedure in Section
                5.3.

              _ Across a PSDN to a remote X25router 2000.

                To do this, you need first to set up an ICP desti-
                nation on the remote X25router 2000, as described
                in Section 5.4.1. Then follow the procedure in Section
                5.4.2.

          Testing the Installation                            5-1

 






              _ Across a PSDN to a DTE on a remote VMS system. This

                remote system must be running VAX P.S.I. or RSX P.S.I.,
                and also running PSIXTR (X.25 Test Receiver).

                To do this, you need first to set up an ICP desti-
                nation on the remote VMS system, as described in Section
                5.5.1. Then follow the procedures in Section 5.5.2.

             See Appendix D for a list of ICP messages.

          5.2 Preparing to Run X25ROU_ICP

             Before you run X25ROU_ICP, check that the following re-
             quirements are met:

              _ The local DTE you are using is not a member of a Closed

                User Group (CUG). You cannot run the ICP using a DTE
                that is a member of a CUG.

              _ Your DTE supports at least one Switched Virtual Circuit

                (SVC).

              _ You have NETMBX, OPER and SYSPRV privileges.

              _ The ICP has been defined, and has declared itself

                as a DECnet object. Check this by entering the fol-
                lowing NCP commands:

                  NCP> SET EXEC NODE x25router
                  NCP> SHOW KNOWN OBJECT

                where x25router is the X25router 2000 node name.

                The system will respond with output similar to the
                following:

                  Known Object Volatile Summary as of date time

                   Object   Number  File/PID              User Id       Password

                  X25ICP         0  800599D0
                  NML           19  8005B280              user-id       *Set*
                  MIRROR        25  8005B200
                  X25_GATEWAY   31  8005C250
                  NETTRACE$     54  800586D0              user-id       *Set*
                  DTR           63  8005B3D0

          5-2      X25router 2000 Installation Procedures (VMS)

 






                Check that X25ICP is included in the display. If it
                is not present, contact your software support spe-
                cialist.

              _ The X25router 2000 is installed, configured and run-

                ning, and that a DTE is up and running. To check this,
                enter the following command:

                  NCP> SET EXECUTOR NAME x25router
                  NCP>SHOW KNOWN DTE

                where x25router is the X25router 2000 node name.

                If a DTE is up and running, it will appear in the
                display produced by the command, with a state and
                substate of ON-RUNNING.

                If no DTEs are up and running, wait for two minutes,
                and enter the command again. If the display shows
                that there are still no DTEs up and running, check
                both the DTE address and the physical connection to
                the PSDN. If everything appears to be in order, con-
                firm with the network authority that the DTE is op-
                erational.

                If you need to investigate the problem further, see
                the X25router 2000 Problem Solving Guide.

                Exit from NCP by entering the command

                  NCP>EXIT

          5.3 Running the ICP in Loopback to the Local X25router
              2000

             Start the ICP at a terminal on the host system, by en-
             tering the command:

               $ @SYS$TEST:X25ROU_ICP

          Testing the Installation                            5-3

 






             The procedure displays the following:

                   This  command  file  is  used  to  run  the Installation
                   Checkout Procedure (ICP) for the X25router 2000.

                   This ICP can be run in any of the following ways:

                   -   As a loopback test to the same X25router 2000
                   -   To a remote X25router 2000
                   -   To a VMS system running native mode VAX P.S.I.

                   In all cases, the ICP assumes  that at least one DTE is
                   up and running.

                   As well as performing a test, the ICP can also  be used
                   to set up  and clear a destination. This is useful when
                   running a test from another node.

                   During the ICP, you will be asked to supply:

                   -   The X25router 2000 node name
                   -   The name of a network to which your X25router 2000
                       is connected

                   For a local (loopback) test  you will be asked to supply
                   the address of a DTE on the X25router 2000. The ICP will
                   set up  a suitable destination for  the duration  of the
                   test.

                   For a test to a  remote node you will be asked to supply
                   the  remote DTE address  and  subaddress.  Note that you
                   must have  already set up  a destination for  the remote
                   DTE.

                   If you  do not want to  run  the  Installation  Checkout
                   Procedure press <RET> in response to the first prompt.

                   X25router 2000 node name:

             Enter the X25router 2000 node name.

             The procedure continues:

                   Do you want to run the ICP to the local node [YES]?

             Press <RET>. The procedure will ask you for the net-
             work name:

                   Network name            (string):

          5-4      X25router 2000 Installation Procedures (VMS)

 






             Enter the name of a network to which your X25router 2000
             is connected. If you have defined only one network, you
             may press <RET>. Note that you will need to consult the
             relevant network authorities to make sure you can do
             this, as not all PSDNs allow you to perform loopback
             testing.

             Next, the procedure will prompt you for the destina-
             tion for the ICP.

                   Local DTE address       (string):

             Enter the local DTE address.

             The ICP takes approximately 1.5 minutes, during which
             time no messages are displayed. When the ICP completes
             successfully, the procedure displays:

               %X25ROU-I-SETDEST, ICP destination has been set

               %X25ROU-I-NORMAL, X25router 2000 test finished successfully

               %X25ROU-I-CLEAR, ICP destination has been cleared

             Then, the procedure displays some details of the test:

                   Test Statistics
                   Number of Transmits =   n
                   Number of Receives  =   m

             where n and m should be approximately equal; they may
             differ by 1 or 2.

             If the ICP completes with errors, see Section 5.6.

          5.4 Running the ICP to a Remote X25router 2000

             In order to run the ICP to a remote X25router 2000 across
             a PSDN, you need first to set up an ICP destination on
             the remote X25router 2000, as described in Section 5.4.1.
             Then run the ICP, as described in Section 5.4.2.

          Testing the Installation                            5-5

 






          5.4.1 Setting Up an ICP Destination on a Remote
                X25router 2000

             To set up an ICP destination on another X25router 2000,
             use the command:

               $ @SYS$TEST:X25ROU_ICP SET

             The procedure displays:

                   This  command  file  is  used  to  run  the Installation
                   Checkout Procedure (ICP) for the X25router 2000.

                   This ICP can be run in any of the following ways:

                   -   As a loopback test to the same X25router 2000
                   -   To a remote X25router 2000
                   -   To a VMS system running Native mode VAX P.S.I.

                   In all cases, the ICP  assumes  that at least one DTE is
                   up and running.

                   As  well  as performing a test, the ICP can also be used
                   to set up  and clear a destination.  This is useful when
                   running a test from another node.

                   During the ICP, you will be asked to supply:

                   -   The X25router 2000 node name
                   -   The name of a network to which your X25router 2000
                       is connected

                   For a local (loopback) test you will be asked to supply
                   the address of a DTE on the X25router 2000. The ICP will
                   set up  a suitable destination for  the duration  of the
                   test.

                   For a test to a remote node you will be asked to supply
                   the  remote DTE address  and  subaddress. Note that you
                   must have  already set up  a destination for the remote
                   DTE.

                   If you do not want to  run  the  Installation  Checkout
                   Procedure press <RET> in response to the first prompt.

             Then the procedure will prompt you for the node name
             and destination subaddress.

                   X25router 2000 node name:

          5-6      X25router 2000 Installation Procedures (VMS)

 






             Enter the node name of the remote X25router 2000.

                   Please enter destination subaddress:

             Enter an otherwise unused subaddress in the range 0 to
             9999.

             The procedure will respond:

               %X25ROU-I-SETDEST, ICP destination has been set

             Now follow the procedure described in Section 5.4.2.

          5.4.2 Running the ICP

             To run the ICP to a remote X25router 2000, follow this
             procedure:

             Start the ICP at a terminal on the host system, by en-
             tering the command:

               $ @SYS$TEST:X25ROU_ICP

             The procedure displays:

                   This command file is used to run the  Installation
                   Checkout Procedure (ICP) for the X25router 2000.

                   This ICP can be run in any of the following ways:

                   -   As a loopback test to the same X25router 2000
                   -   To a remote X25router 2000
                   -   To a VMS system running native mode VAX P.S.I.

                   In all cases,  the ICP assumes that at least one DTE is
                   up and running.

                   As well as performing a test, the ICP can also  be used
                   to set up  and clear a destination. This is useful when
                   running a test from another node.

                   During the ICP, you will be asked to supply:

                   -   The X25router 2000 node name
                   -   The name of a network to which your  X25router 2000
                       is connected

          Testing the Installation                            5-7

 






                   For a local (loopback) test  you will be asked to supply
                   the address of a DTE on the X25router 2000. The ICP will
                   set up a  suitable destination for  the duration  of the
                   test.

                   For a test to a  remote node you will be asked to supply
                   the  remote DTE address  and  subaddress.  Note that you
                   must have  already set up  a destination for  the remote
                   DTE.

                   If you  do not want to  run  the  Installation  Checkout
                   Procedure press <RET> in response to the first prompt.

                   X25router 2000 node name:

             Enter the X25router 2000 node name.

             The procedure continues:

                   Do you want to run the ICP to the local node [YES]?

             Enter NO. The procedure displays:

                   Network name            (string):

             Enter the name of a network to which your X25router 2000
             is connected.

             The procedure now displays:

                   Remote DTE address            (string):
                   Remote subaddress             (string):

             Specify the remote DTE address as a string of up to 15
             digits. See the Public Network Information  manual for
             details of the DTE address format for your network. Specify
             a subaddress if required.

             The ICP takes approximately 1.5 minutes, during which
             time no messages are displayed. When the ICP completes
             successfully, the procedure displays:

               %X25ROU-I-NORMAL, X25router 2000 test finished successfully

          5-8      X25router 2000 Installation Procedures (VMS)

 






             Then the procedure displays some details of the test:

                   Test Statistics
                   Number of Transmits =   n
                   Number of Receives  =   m

             where n and m should be approximately equal; they may
             differ by 2 or 3.

             If the ICP completes with errors, see Section 5.6.

          5.4.3 Clearing the Destination on a Remote X25router
                2000

             You will need to clear the destination on the remote
             X25router 2000 in order to complete the ICP. Enter the
             following commands:

               $ @SYS$TEST:X25ROU_ICP CLEAR

             The procedure displays:

                   This  command  file  is  used  to  run  the  Installation
                   Checkout Procedure (ICP) for the X25router 2000.

                   This ICP can be run in any of the following ways:

                   -   As a loopback test to the same X25router 2000
                   -   To a remote X25router 2000
                   -   To a VMS system running Native mode VAX P.S.I.

                   In all cases, the ICP assumes that at least one DTE is
                   up and running.

                   As  well as performing a test, the ICP can also  be used
                   to set up  and clear a destination.  This is useful when
                   running a test from another node.

                   During the ICP, you will be asked to supply:

                   -   The X25router 2000 node name
                   -   The name of a network to which your  X25router 2000
                       is connected

                   For a local (loopback) test you will be asked  to supply
                   the address of a DTE on the X25router 2000. The ICP will
                   set up a  suitable destination for  the duration  of the
                   test.

          Testing the Installation                            5-9

 






                   For a test to a  remote node you will be asked to supply
                   the  remote DTE address  and  subaddress.  Note that you
                   must have  already set up  a destination for  the remote
                   DTE.

                   If you  do not want to  run  the  Installation  Checkout
                   Procedure press <RET> in response to the first prompt.

                   X25router 2000 node name:

             Enter the node name of the remote X25router 2000. You
             will then see the message:

               %X25ROU-I-CLEAR, ICP destination has been cleared

          5.5 Running the ICP to a Remote VMS Node

             In order to run the ICP to a remote VMS node across a
             PSDN, you need first to set up an ICP destination on
             the remote VMS node, as described in Section 5.5.1. Then
             run the ICP, as described in Section 5.5.2.

          5.5.1 Setting Up a Destination on a Remote VMS Node

             You can run the ICP over a PSDN to a remote VMS node
             running either RSX P.S.I. or Native mode VAX P.S.I. Before
             you can do this, you need to set up a destination and
             an object on this remote node. You do this by enter-
             ing NCP or X25ROUPERM commands at the remote node. This
             section gives examples of the NCP commands you may use
             for this.

             The following example commands set up and show a des-
             tination on the remote VMS node.

               NCP> SET X25-SERVER DESTINATION PSIXTR OBJECT PSIXTR-
               SUBADDRESS 27 PRIORITY 127

               NCP> SHOW X25-SERVER DESTINATION PSIXTR


          5-10     X25router 2000 Installation Procedures (VMS)

 






             The procedure displays:

               Module X25-Server Volatile Summary as of 30-MAY-1989 13:36:24

               Destination              = PSIXTR
               Object                   = PSIXTR
               Priority                 = 127
               Subaddresses             = 27

             The following example commands set up and show an ob-
             ject on the remote VMS node.

               NCP>SET OBJECT PSIXTR FILE SYS$TEST:PSIXTR.COM USER PSIUSER-
               PASSWORD SECRET NUMBER 0

               NCP>SHOW OBJECT PSIXTR

             The procedure displays:

               Object Volatile Summary as of 30-MAY-1989 13:47:17

                  Object   Number  File/PID                   User Id      Password

                  PSIXTR        0  PSIXTR.COM                 PSIUSER

             The following example commands check that the remote
             DTE is up and running at the remote node.

               NCP> SHOW DTE 314212423567 NETWORK psdn_net1

             If the DTE is up and running, the procedure will dis-
             play:

               Module X25-Protocol Volatile Summary as of 19-MAY-1989 14:19:26

                 DTE              Network          State              Active    Active
                                                                      Channels  Switched
                 314212423567     psdn_net1        on  -running         0          0

             When you have set up a destination and object on the
             remote node, follow the procedure in Section 5.5.2.

          Testing the Installation                           5-11

 






          5.5.2 Running the ICP

             To run the ICP to a remote VMS node, follow this pro-
             cedure.

             Start the ICP at a terminal on the host system, by en-
             tering the command:

               $ @SYS$TEST:X25ROU_ICP

             The procedure displays.

                   This command file is used to run the  Installation
                   Checkout Procedure (ICP) for the X25router 2000.

                   This ICP can be run in any of the following ways:

                   -   As a loopback test to the same X25router 2000
                   -   To a remote X25router 2000
                   -   To a VMS system running Native mode VAX P.S.I.

                   In all cases, the ICP assumes that at least one DTE is
                   up and running.

                   As  well  as performing a test, the ICP can also be used
                   to set up  and clear a destination.  This is useful when
                   running a test from another node.

                   During the ICP, you will be asked to supply:

                   -   The X25router 2000 node name
                   -   The name of a network to which your  X25router 2000
                       is connected

                   For a local (loopback) test  you will be asked to supply
                   the address of a DTE on the X25router 2000. The ICP will
                   set up a  suitable destination for  the duration  of the
                   test.

                   For a test to a  remote node you will be asked to supply
                   the  remote DTE address  and  subaddress.  Note that you
                   must have  already set up  a destination for  the remote
                   DTE.

                   X25router 2000 node name:

             Enter the X25router 2000 node name.

             The procedure continues:

                   Do you want to run the ICP to the local node [YES]?

          5-12     X25router 2000 Installation Procedures (VMS)

 






             Enter NO. The procedure displays:

                   Network name            (string):

             Enter the name of a network to which your X25router 2000
             is connected.

             The procedure now displays:

                   Remote DTE address      (string):
                   Remote subaddress       (string):

             Specify the remote DTE address as a string of up to 15
             digits. See the Public Network Information  manual for
             details of the DTE address format for your network. Specify
             a subaddress if required.

             The ICP takes approximately 1.5 minutes, during which
             time no messages are displayed. When the ICP completes
             successfully, the procedure displays:

               %X25ROU-I-NORMAL, X25router 2000 test finished successfully

             Then, the procedure displays some details of the test:

                   Test Statistics
                   Number of Transmits =   n
                   Number of Receives  =   m

             where n and m should be approximately equal; they may
             differ by 1 or 2.

             If the ICP completes with errors, see Section 5.6.

          5.5.3 Clearing the Destination

             To complete the ICP, you will need to clear the des-
             tination on the remote node. Enter the following com-
             mands:

               $ RUN SYS$SYSTEM:NCP
               NCP> CLEAR X25-SERVER DESTINATION PSIXTR ALL
               NCP> CLEAR OBJECT PSIXTR ALL

          Testing the Installation                           5-13

 






          5.6 What to Do if the ICP Completes with Errors

             If the ICP completes with errors, first work through
             the following checklist, to ensure you have run the ICP
             correctly:

              1.Check the DTE address or subaddress. If they are in-
                correct, try the test again.

              2.Check the software installation. If the test fails
                again, try one of the problem solving methods de-
                scribed below.

              3.The PSDN may not be up. Try the test again later.
                If it fails, try one of the problem solving meth-
                ods described below.

              4.Check that X25router 2000 is connected to the mo-
                dem, and that the modem is working correctly. Then,
                try the test again.

             You can use the following to help diagnose problems:

              _ The TRACE utility. See the X25router 2000 Problem

                Solving Guide for details.

              _ The X25router 2000 status and error counters. To use

                these, enter the following command:

                  NCP> TELL X25router SHOW LINE line-id COUNTERS

                where X25router is the node name.
                line-id is the name of the line used on the X25router
                2000.

              _ Line-level loopback tests, to test the physical line.

                See the X25router 2000 Problem Solving Guide for de-
                tails.

             Refer to your PSDN authorities and to your software sup-
             port specialist if you need further assistance.

          5-14     X25router 2000 Installation Procedures (VMS)

 













          ______________________________________________________A

                           Example Installation and Configuration




          $ @sys$update:vmsinstal x25rou011 mua0: options n

                  VAX/VMS Software Product Installation Procedure V5.1

          It is 15-JUL-1989 at 11:02.
          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]? yes
          * Are you satisfied with the backup of your system disk [YES]?

          The following products will be processed:

            X25ROU V1.1

                  Beginning installation of X25ROU V1.1 at 11:03

          %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 [2]: 4
          * Do you want to continue the installation? no
          %VMSINSTAL-I-RELMOVED , The product's release notes have been
          successfully moved to SYS$HELP.

                  Installation of X25ROU V1.1 completed at 11:04

                  VMSINSTAL procedure done at 11:04

          Example Installation and Configuration              A-1

 






          $ @sys$update:vmsinstal x25rou011 mua0

                  VAX/VMS Software Product Installation Procedure V5.1

          It is 17-JUL-1989 at 14:22.

          Enter a question mark (?) at any time for help.

          %VMSINSTAL-W-DECNET, Your DECnet is up and running.
          * Do you want to continue anyway [NO]? YES
          * Are you satisfied with the backup of your system disk [YES]?

          The following products will be processed:

            X25ROU V1.1

                  Beginning installation of X25ROU V1.1 at 14:22

          %VMSINSTAL-I-RESTORE, Restoring product saveset A ...
          %VMSINSTAL-I-RELMOVED , The product's release notes have been
          successfully moved to SYS$HELP.

          * Do you want to purge files replaced by this installation [YES]?

          The X25router 2000 kit has 2 components.

              o    X25router 2000 software

              o    Trace software

          You may install either one or both of these components.

          * Do you want to install the X25router 2000 software [YES]?
          * Do you want to install the TRACE software [YES]?

                  Product:      X25ROUTER-2000
                  Producer:     DEC
                  Version:      1.1
                  Release Date:

          * Does this product have an authorization key registered and loaded? NO

              DIGITAL recommends that you install the license for
              the X25router 2000 on completion of the installation.

          * Do you wish to exit [YES]? NO

          %VMSINSTAL-I-RESTORE, Restoring product saveset B ...
          %VMSINSTAL-I-RESTORE, Restoring product saveset C ...

          The following software will now be installed:

                  o   X25router 2000 software

                  o   Trace software

          A-2       X25router 2000 Installation Procedures (VMS)

 






          %X25ROU-I-FILEXISTS, VMI$ROOT:[SYSLIB]NETTRACE$KEY.INIT already exists on
          system
          %X25ROU-I-FILNOTINST, VMI$ROOT:[SYSLIB]NETTRACE$KEY.INIT not installed

          The system logical MOM$LOAD is already defined as:
               MOM$SYSTEM:,MDM$MAINT

          To load the X25router, MOM$LOAD should be redefined as:

                  MOM$SYSTEM:,MDM$MAINT,SYS$SYSROOT:[DECSERVER]

          * Do you want to redefine this now [YES]?

          After exiting from VMSINSTAL, do the following:

          1. If  the  definition  for MOM$LOAD in the system start-up file
             does not contain  SYS$SYSROOT:[DECSERVER], you must edit your
             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  X25router 2000 image
             to be defined each time the system is rebooted, so the system
             will load correctly.

          2. Configure your X25router 2000 into the  load host's database.
             Execute the  command  procedure called X25ROUCONFIG.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  X25router 2000
             units.  All previously defined DECrouter  units will still be
             configured within the load host's database.  Refer to Chapter
             4 of  the X25router 2000 Installation Procedures  for further
             details.

          3. Set up the X25router 2000 permanent  database before powering
             up  the  hardware.  Execute  the  command  procedure   called
             X25ROUSETUP.COM   which  is  in  the  SYS$SYSROOT:[DECSERVER]
             directory.  Refer  to  Chapter  4  of  the  X25router  2000
             Installation Procedures for further details.

             If you  wish to modify the  X25router 2000 database for  your
             specific  networking requirements, execute the X25ROUPERM.EXE
             program which is in the SYS$SYSTEM directory. This program is
             described  in the  X25router 2000 Management Guide.

          4. REMINDER: The release notes for the  X25router  2000  are in
             X25ROU011.RELEASE_NOTES  which is in the directory SYS$HELP.

          5. A  command  file  SYS$MANAGER:NETTRACE_INSTALL.COM  has  been
             created  to  install  the  TRACE  utility.  Edit  your system
             start-up  file to execute  this file each time your system is
             booted.

          Example Installation and Configuration              A-3

 






             Please ignore any error messages while TRACE is installed.

          %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...

                  Installation of X25ROU V1.1 completed at 14:28

                  VMSINSTAL procedure done at 14:28

          $ @sys$sysroot:[decserver]x25rouconfig

              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
                                 6 - Upgrade 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
          ------- ------ ------ ------- ----------------- ------------- ----
          ---------
          43.989  ZEBRA  X25ROU QNA-0   08-22-22-22-22-22 X25010.SYS    X25ZEBRA.DMP
          63.99   HORSE  X25ROU QNA-0   80-11-22-33-44-55 X25010.SYS    X25HORSE.DMP
          63.999  CAMEL  X25ROU QNA-0   80-55-44-33-22-11 X25010.SYS    X25CAMEL.DMP

          Total of 3 DECrouters defined.
          (Press RETURN for menu)

                        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 - Upgrade existing DECrouters
                            CTRL/Z - Exit from this procedure

                  Your choice: 6
          DECrouter type ? x25rou

          A-4       X25router 2000 Installation Procedures (VMS)

 






              Enter ? if you require help, enter CTRL/Z to return to menu
              without changing the unit's entry in the database.

              If  you  use this option, and you  have  more than one load
              host for any DECrouters, you must  modify  the database for
              each load host. To do this, execute  X25ROUCONFIG  on  each
              load host, and select the UPGRADE option.

              Enter the node name of the DECrouter to upgrade. To upgrade
              all defined DECrouters enter *.

          What is the DECnet node name of the DECrouter ? CAMEL
          DECrouter CAMEL to be upgraded to SYS$COMMON:[DECSERVER]X25011.SYS
          Executing NCP commands to upgrade DECrouters

                        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 - Upgrade 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
          ------- ------ ------ ------- ----------------- ------------- ----
          ---------
          43.989  ZEBRA  X25ROU QNA-0   08-22-22-22-22-22 X25010.SYS    X25ZEBRA.DMP
          63.99   HORSE  X25ROU QNA-0   80-11-22-33-44-55 X25010.SYS    X25HORSE.DMP
          63.999  CAMEL  X25ROU QNA-0   80-55-44-33-22-11 X25011.SYS    X25CAMEL.DMP

          Total of 3 DECrouters defined.
          (Press RETURN for menu)

                        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 - Upgrade existing DECrouters
                            CTRL/Z - Exit from this procedure

                  Your choice: 6
          DECrouter type ? x25rou

              Enter ? if you require help, enter CTRL/Z to return to menu
              without changing the unit's entry in the database.

          Example Installation and Configuration              A-5

 






              If  you  use this option, and you have more than one  load
              host for any DECrouters, you must modify the database  for
              each  load host. To do this, execute X25ROUCONFIG on  each
              load host, and select the UPGRADE option.

              Enter the node name of the DECrouter to upgrade. To upgrade
              all defined DECrouters enter *.

          What is the DECnet node name of the DECrouter ? *
          DECrouter ZEBRA to be upgraded to SYS$COMMON:[DECSERVER]X25011.SYS
          DECrouter HORSE to be upgraded to SYS$COMMON:[DECSERVER]X25011.SYS
          Executing NCP commands to upgrade DECrouters

                        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 - Upgrade 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)? x25rou
          DECnet node name for unit? whale
          DECnet node address for unit? 63.787
          Ethernet address for unit (nn-nn-nn-nn-nn-nn)?08-66-66-66-66-66
          DECnet Service Circuit-ID [QNA-0]?
          %NCP-W-UNRCMP, Unrecognized component , Node
          %NCP-W-UNRCMP, Unrecognized component , Node

              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
                                 6 - Upgrade existing DECrouters
                            CTRL/Z - Exit from this procedure

                  Your choice: 3

          A-6       X25router 2000 Installation Procedures (VMS)

 






              Enter ? if you require help, enter CTRL/Z to return to menu
              without changing the unit's entry in the database.

              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 X25ROUCONFIG on each load
              host, and select the SWAP option.

          What is the DECnet node name of the DECrouter you want to swap? CAMEL
          DECrouter CAMEL at Ethernet address 80-55-44-33-22-11 is being modified.

              Enter the new Ethernet address and any other DECnet characteristics
              you want to modify.

          DECrouter type[X25ROU]?
          DECnet node name for unit[CAMEL]?
          Ethernet address for unit (nn-nn-nn-nn-nn-nn)?08-55-99-88-77-66
          DECnet Service Circuit-ID [QNA-0]?

                        DECrouter Configuration Procedure

                                         Menu of Options

                                 1 - List known DECrouters
                                 2 - Add a DECrouter
                                 3 - Swap an existing DECrouter
                                 4 - Delete an existing DECrouter
                                 5 - Restore existing DECrouters
                                 6 - Upgrade existing DECrouters
                            CTRL/Z - Exit from this procedure

                  Your choice: 5

                    Restoring existing DECrouters to host DECnet database...
                    Host DECnet database successfully restored.

                        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 - Upgrade existing DECrouters
                            CTRL/Z - Exit from this procedure

                  Your choice: 4

          Example Installation and Configuration              A-7

 






          What is the DECnet node name of the unit you want to delete?
          (CTRL/Z to return to menu) camel
          %NCP-I-SUCCESS,  Success
          Remote node =   63.999 (CAMEL)
          %NML-I-RECDELET, Database entry deleted

                        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 - Upgrade existing DECrouters
                            CTRL/Z - Exit from this procedure

                  Your choice:<CTRL/Z>

          $ @sys$sysroot:[decserver]x25rousetup

                  This command procedure sets  up  the  permanent database
                  for the X25router 2000.  Usually,  executing this script
                  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.

                  X25router 2000 node name     (node-id): nodea

                  X25router 2000 type [DEMSA, DEMSB]: demsa

                  A configuration file for NODEA already exists.

                  You may either keep the existing  configuration file and
                  modify it or create a new database.

          Do you want to create a new database [YES]?

                      The old configuration file for NODEA will be renamed.

          %RENAME-I-RENAMED, SYS$COMMON:[DECSERVER]X25NODEA.SYS;1 renamed
          to SYS$COMMON:[DECSERVER]X25NODEA.OLD;2

                  Your X25router 2000  can be one of three types of DECnet
                  node:

                      NONROUTING (end node)
                      ROUTING IV (level 1 router)
                      AREA       (level 2 router)

                  Specify the type you require.

          A-8       X25router 2000 Installation Procedures (VMS)

 






                  Node type            [NONROUTING]: routing iv
                  Ethernet circuit cost         [4]:
                  Router priority              [64]:

                  If  you  want  to  use  incoming  datalink mapping (DLM)
                  circuits you need to specify a  subaddress  range to use
                  to pass the incoming X.25 calls to DECnet.

                  If you  do  not want to use  incoming DLM circuits, just
                  press <RETURN> to continue.

                  Subaddress range           [NONE]: 1-5

                  The X25router 2000 supports  the following  combinations
                  of lines,  line speeds  and  ports. Specify the type you
                  require.

                  Type    Number of lines    Maximum Speed          Ports
                                              (per second)

                    1            4               64 Kb            0,1,2,3
                    2            3              256 Kb            0,1,2
                    3            2              384 Kb            0,1

                  Type                          [1]:

                  Enter the username  and password to be used to control
                  access  to  the  X25router 2000.  If  you specify this
                  information here,  then it must be  supplied  whenever
                  lines,  DTEs  or  circuits on the  X25router 2000  are
                  being modified.

                  If this  information  is  not specified,  anyone  can
                  modify the X25router 2000. DIGITAL STRONGLY RECOMMENDS
                  that you specify access control for the NML object.

          NML Username [NONE]: nmluser
          NML Password:
          Verification:

                  Enter  the  username  and password to be used for the
                  TRACE utility. If you specify  this  information here,
                  then it must be supplied when using the TRACE utility
                  on the X25router 2000.

                  If this  information  is  not specified,  anyone  can
                  monitor the traffic on the X25router 2000.

                  DIGITAL STRONGLY RECOMMENDS that you set up a username
                  and password for the TRACE utility.

          TRACE Username [NONE]: traceuser
          TRACE Password:
          Verification:

          Example Installation and Configuration              A-9

 






                  The  following  configurator  commands will be used to
                  define the permanent database.

                  set executor type ROUTING IV
                  set circuit ETHERNET router priority 64
                  set circuit ETHERNET cost 4
                  set executor subaddress 1-5
                  set logging monitor events 0.0-2,4-6,8,9
                  set logging monitor events 2.0-1
                  set logging monitor events 4.2-13,16,19
                  set logging monitor events 5.0-21
                  set logging monitor events 7.0-11
                  set object nml user NMLUSER password *Set*
                  set object nettrace$ user TRACEUSER password *Set*

          Do you want the permanent database defined now [YES]?

          X25ROUPERM V1.1, X25router 2000 Configuration Program
          X25ROUPERM-I-NEWRTR this is a new X25router
          X25ROUPERM-I-FILNEW new configuration file created

                  This command  procedure allows  you  to  define  one or
                  more  PSDN(s) and one or more DTEs associated with each
                  network.

          Do you want to define the X25-PROTOCOL database now [YES]?

                  You  can  use  this  procedure to purge the database to
                  remove  all  line,  DTE and  X.25  protocol information
                  before updating the permanent database.

                  The  following  configurator  command  will  be used to
                  purge the line permanent database:

                  PURGE known lines all

                  The  following  configurator  commands  will be used to
                  purge the DTE and X.25 permanent database:

                  PURGE module x25-protocol known networks all
                  PURGE module x25-protocol known dtes known networks all

          Do you want the information in the the permanent database
          to be purged [NO]?
          Do you want the information in the X.25 and DTE
          permanent database to be purged [NO]?

                  A command  procedure will now  be  executed  to perform
                  the requested  definitions.

                  Please ignore any error messages.

          X25ROUPERM V1.1, X25router 2000 Configuration Program

                  PSDN and profile names are defined here. You can define
                  one or more PSDNs.  For each PSDN  you will be asked to
                  provide the  network name and the profile name for that
                  network.

          A-10      X25router 2000 Installation Procedures (VMS)

 






                  Network name   (string): nodea_pss
                  Profile name   (string) [nodea_pss]: pss

                  The  following  configurator  command  will be  used to
                  update the permanent database:

                  DEFINE module x25-protocol network nodea_pss -
                                                  profile pss

          Do you want the information in the permanent database
          updated  [YES]?

                  DTEs are  defined  here.  You  can  define  one or more
                  DTEs  connected to this network. For each DTE  you will
                  be asked to provide the following information:

                      o   DTE address
                      o   Range of channels to be used by the DTE
                      o   Synchronous port number to be used by the line
                      o   Line associated with the DTE

                  DTE address       (number): 23421234567890
                  Channels range      (list): 515-512,10-5
                  Synchronous port     (0-3): 0
                  Line name (string) [X25-0]:

                  The following  configurator  commands  will be used to update
                  the permanent database.

                  DEFINE line X25-0 -
                      protocol LAPB -
                      network nodea_pss -
                      device SYN-0 -
                      state on

                  DEFINE module x25-protocol dte 23421234567890 -
                      network nodea_pss -
                      channels 515-512,10-5 -
                      line X25-0 -
                      state on

          Do you want to update the permanent database now  [YES]?
          Do you want to define any more DTEs connected
          to this network [NO]?

          Do you want to define any more networks [NO]?

                  A command  procedure  will  now be executed  to perform
                  the requested  definitions.

          X25ROUPERM V1.1, X25router 2000 Configuration Program
          X25ROUPERM-I-FILUPD configuration file updated

          Example Installation and Configuration             A-11

 






                  X25-SERVER destinations are set up  here.  These  permit
                  incoming calls received by this node to be redirected to
                  the appropriate host.  This  procedure  asks  for a list
                  of hosts with PSI Access installed.

          Do you want to define the X25-SERVER database now [YES]?
                  Destination node name  (string)                 : nodeb
                  Destination priority                     [0]    :
                  Call mask              (2-32 hex)        [None] :
                  Call value             (2-32 hex)        [None] :
                  Closed user group name (1-16 characters) [None] :
                  Sending address        (1-15 decimal)    [None] :
                  Subaddress range       (decimal range)   [None] : 36
                  Object identification  (string)          [36]   :

                  The  destination  will  be set  up  using the  following
                  configurator command:

                  DEFINE node 63.999 name NODEB
                  DEFINE module x25-server -
                          destination nodeb -
                          node NODEB -
                          subaddress 36 -
                          object 36

          Do you want to define this destination now  [YES]?
          Do you want to define any more destinations  [NO]?

                  A command procedure will now be executed to perform the
                  requested definitions.

          X25ROUPERM V1.1, X25router 2000 Configuration Program
          X25ROUPERM-I-FILUPD configuration file updated

                  You may  now define  the DECnet and X.25 PVCs you will
                  use on the X25router 2000.

          Do you want to define the circuit database now [YES]?

                  You can  use  this  procedure to purge the database to
                  remove all  DECnet and X.25 circuit information before
                  updating the permanent database.

                  The following  configurator  command  will  be used to
                  purge the circuit permanent database:

                  PURGE known circuits all

          Do you want the information in the circuit permanent database
          purged [NO]?

                  You  can  now  define the circuits and lines to be used.
                  The circuit types are DDCMP, DLM and PVC.

                  DDCMP circuits
                  --------------

          A-12      X25router 2000 Installation Procedures (VMS)

 






                  You  can define up to four DDCMP  circuits for the DEMSA
                  and one circuit for the DEMSB.

                  DDCMP lines may have any name that does not begin PVC-.

                  For each DDCMP circuit you define,  a  line will also be
                  configured  to  run the DDCMP  protocol. Note that for a
                  DEMSB, you can have either an X.25 line, or a DDCMP line.

                  DLM circuits
                  ------------

                  You may define up to sixty-three DLM circuits  for  the
                  DEMSA, but only two DLM circuits for the DEMSB.

                  You  may use any name for  DLM circuits  that  does not
                  begin PVC-.

                  PVCs
                  ----

                  You can  define up to  512 PVCs for the DEMSA, but only
                  sixteen PVCs for the DEMSB. Note that for each  DLM you
                  define, you can define one less PVC.

                  You must start  the circuit name  with the  string PVC-,
                  except for DLM PVCs.

                  Circuit name      (string): dlm-out

          Circuit type [DDCMP, DLM] ? dlm

                  You must now specify the usage as  INCOMING, OUTGOING or
                  PERMANENT

                  Usage                     : outgoing
                  Remote DTE        (number): 23420987654321
                  Local DTE         (number): 23421234567890
                  Network           (string): nodea_pss
                  Recall timer (number) [60]:
                  Maximum recalls (number) [100]:
                  Circuit cost  (number) [5]:
                  State        (string) [ON]:

                  The following  configurator  commands  will  be  used to
                  update the permanent database:

                  DEFINE circuit DLM-OUT cost 5 usage OUTGOING number -
          23420987654321 DTE 23421234567890 network nodea_pss -
          maximum recalls 100 recall timer 60 state ON

          Do you want the information in the permanent database updated  [YES]?

          Do you want to define any more circuits [NO]? yes

                  Circuit name      (string): ddcmp-1

          Example Installation and Configuration             A-13

 






          Circuit type [DDCMP, DLM] ? ddcmp

                  This circuit is a DDCMP circuit.

                  Please enter the  information about  the line which will
                  be used for this circuit.

                  Line name   (string) [DDCMP-1]:
                  Synchronous port  (0-3) :1
                  Circuit cost  (number) [5]:

                  The following  configurator  commands  will  be  used to
                  update the permanent database:

                  DEFINE line DDCMP-1 protocol DDCMP point device SYN-1 state on
                  DEFINE circuit DDCMP-1 cost 5 line DDCMP-1 state on

          Do you want the information in the permanent database updated  [YES]?

          Do you want to define any more circuits [NO]? yes

                  Circuit name      (string): dlm-in

          Circuit type [DDCMP, DLM] ? dlm

                  You must now specify the usage as  INCOMING, OUTGOING or
                  PERMANENT

                  Usage                     : incoming
                  Remote DTE        (number):
                  Local DTE         (number):
                  Network           (string):
                  Circuit cost  (number) [5]:
                  State        (string) [ON]:

                  The following  configurator  commands  will  be  used to
                  update the permanent database:

                  DEFINE circuit DLM-IN cost 5 usage INCOMING state ON

          Do you want the information in the permanent database updated  [YES]?

          Do you want to define any more circuits [NO]? yes

                  Circuit name      (string): pvc-1

                  This circuit is a PVC.

                  Please enter the required circuit information.

                  Local DTE         (number): 23421234567890
                  Network           (string): nodea_pss
                  Channel           (number): 65

                  The following  configurator  commands  will  be  used to
                  update the permanent database:

                  DEFINE circuit PVC-1 usage PERMANENT DTE 23421234567890 -
          network nodea_pss channel 65 state on

          A-14      X25router 2000 Installation Procedures (VMS)

 






          Do you want the information in the permanent database updated  [YES]?

          Do you want to define any more circuits [NO]?

                  A command procedure  will now be executed to perform the
                  requested  definitions.

          X25ROUPERM V1.1, X25router 2000 Configuration Program
          %X25ROUPERM-I-FILUPD configuration file updated

                  X25ROUSETUP complete.

                  The  databases   are  now  set  up  and you may load the
                  X25router 2000.



























          Example Installation and Configuration             A-15

 













          ______________________________________________________B

                Example of Testing an Installation, Using the ICP




               $ @SYS$TEST:X25ROU_ICP

                       This  command  file  is  used  to  run  the Installation
                       Checkout Procedure (ICP) for the X25router 2000.

                       This ICP can be run in any of the following ways:

                       -   As a loopback test to the same X25router 2000
                       -   To a remote X25router 2000
                       -   To a VAX running native mode VAX P.S.I.

                       In all cases, the ICP  assumes  that at least one DTE is
                       up and running.

                       As  well  as performing a test, the ICP can also be used
                       to set up  and clear a destination.  This is useful when
                       running a test from another node.

                       During the ICP, you will be asked to supply:

                       -   The X25router 2000 node name
                       -   The  name  of a network to which your X25router 2000
                           is connected.

                       For a local (loopback) test  you will be asked to supply
                       the address of a DTE on the X25router 2000. The ICP will
                       set up a  suitable destination for  the duration  of the
                       test.

                       For a test to a  remote node you will be asked to supply
                       the  remote DTE address  and  subaddress.  Note that you
                       must have  already set up  a destination for  the remote
                       DTE.

                       If you  do not want to  run  the  Installation  Checkout
                       Procedure press <RET> in response to the first prompt.

          Example of Testing an Installation, Using the ICP   B-1

 






                       X25router 2000 node name: KB1664
                       Do you want to run the ICP to the local node [YES]?

                       Network Name            (string): PSS
                       Local DTE address       (string): 23421234567890

               %X25ROU-I-SETDEST, ICP destination has been set

               %X25ROU-I-NORMAL, X25router 2000 test finished successfully

               %X25ROU-I-CLEAR, ICP destination has been cleared

                       Test Statistics
                       Number of Transmits =   50
                       Number of Receives  =   51


























          B-2       X25router 2000 Installation Procedures (VMS)

 













          ______________________________________________________C

                                         Lists of Files Installed




             This appendix lists the files installed on your VMS load
             host by the X25router 2000 installation procedure.


          C.1 X25router 2000 files

             SYS$HELP directory

              _ X25ROUPERM.HLB

              _ X25ROU011.RELEASE_NOTES

             SYS$MANAGER directory

              _ X25ROU_LOGICALS.COM

                This is installed for VMS V5.0 and VMS V5.0-1 sys-
                tems only.

             SYS$SYSROOT:[DECSERVER] directory

              _ X25011.SYS

              _ X25ROUCONFIG.COM

              _ X25ROU_DEFINE.COM

              _ X25ROU_DEFINE_HELP.COM

          Lists of Files Installed                            C-1

 






              _ X25ROU_MULTI_HOST.COM

              _ X25ROUSETUP.COM

              _ X25ROU_PROFILES.SYS

             In addition to the files listed above, which are copied
             into the directory SYS$SYSROOT:[DECSERVER], the instal-
             lation procedure also creates the following files in
             SYS$SYSROOT:[DECSERVER]:

              _ ROUCONFIG.DAT (if it does not already exist)

              _ X25node-name.SYS (for each X25router 2000 node)

                where node-name is the name of an X25router 2000 node.

             SYS$SYSTEM directory

              _ X25ROUPERM.EXE

             SYS$TEST directory

              _ X25ROU_ICP.COM

          C.2 TRACE files

             If you install the TRACE utility, the TRACE files are
             installed as follows:

             SYS$SYSTEM directory

              _ NETLTC.EXE

              _ NETTRACE.EXE

             SYS$HELP directory

              _ TRACEHLP.HLB


          C-2       X25router 2000 Installation Procedures (VMS)

 






             SYS$LIBRARY directory

              _ NETTRACE$DDCMP_ANALYZE.EXE

              _ NETTRACE$ETHERNET_ANALYZE.EXE

              _ NETTRACE$GAP_ANALYZE.EXE

              _ NETTRACE$KEY.INIT

              _ NETTRACE$L2_ANALYZE.EXE

              _ NETTRACE$L2E_ANALYZE.EXE

              _ NETTRACE$L3_ANALYZE.EXE

              _ NETTRACE$L3_DDX76_ANALYZE.EXE

              _ NETTRACE$NSP_ANALYZE.EXE

              _ NETTRACE$ROUTING_ANALYZE.EXE

              _ NETTRACE$SYNC_ANALYZE.EXE

             SYS$MANAGER directory

              _ NETTRACE_INSTALL.COM

             SYS$MESSAGE directory

              _ NETTRACE_MESSAGES.EXE










          Lists of Files Installed                            C-3

 













          ______________________________________________________D

                                                     ICP Messages




             This appendix lists the messages that may be displayed
             when you are running the X25router 2000 Installation
             Checkout Procedure (ICP).

             X25router 2000 ICP messages have the prefix "X25ROU-
             " and are displayed in 1, 2 or 3 parts:-

              _ The X25router 2000 ICP message text (one or two lines)

              _ A VMS message associated with the ICP message

              _ In some cases text indicating additional diagnos-

                tic information (an internal VAX P.S.I. error code)

             Note that the X25router 2000 ICP messages are not sub-
             ject to the normal VMS message processing rules. The
             SET MESSAGE/NOSEVERITY command has no effect on the mes-
             sage format.

          D.1 ICP Information Messages

               %X25ROU-I-NORMAL, X25router 2000 test finished successfully

                Normal successful completion of the ICP (RUN com-
                mand).

          ICP Messages                                        D-1

 








               %X25ROU-I-SETDEST, ICP destination has been set

                ICP destination has been set (RUN and SET commands).


               %X25ROU-I-SUBADR, nnn is not a valid subaddress

                The subaddress string nnn is not a valid number (RUN
                and SET commands).


               %X25ROU-I-CLEARED, circuit unexpectedly cleared
               %X25ROU-I-CAUSEDIAG, Cause = nn, Diagnostic = nn)

                The virtual circuit being used for the test has been
                cleared with an unexpected cause/diagnostic code,
                indicating that the test was terminated unexpect-
                edly (RUN command).


               %X25ROU-I-CLEAR, ICP destination has been cleared

                The destination used to run a test has been cleared
                (RUN and CLEAR commands).


          D.2 ICP Error Messages

               %X25ROU-E-UNRECCOM, Invalid or unrecognized command: text

                Invalid command argument to ICP.


               %X25ROU-E-NOCONNECT, failed to connect to node
               VMS error message)

                The ICP is unable to connect to the X25router 2000.


          D-2       X25router 2000 Installation Procedures (VMS)

 






                A VMS DCL message indicating a reason for the fail-
                ure follows the ICP message.



               %X25ROU-E-CLRFAIL, failed to clear the ICP destination
               VMS error message
               [%X25ROU-I-IOST2, IOST2 = nnn]

                The X25router 2000 ICP object (X25ICP) failed to clear
                the destination. A VMS DCL message indicating a rea-
                son for the failure follows the ICP message. The third
                line of the message (if present) provides some fur-
                ther diagnostic information (RUN and CLEAR commands).

               %X25ROU-E-SETFAILED, failed to set up the ICP destination
               VMS error message
               [%X25ROU-I-IOST2, IOST2 = nnn]

                The X25router 2000 ICP object (X25ICP) has failed
                to set up a destination. A VMS DCL message indicat-
                ing a reason for the failure follows the ICP mes-
                sage. The third line of the message (if present) pro-
                vides some further diagnostic information (RUN and
                CLEAR commands).


               %X25ROU-E-SENDFAILED, failed to send command to X25router 2000
               VMS error message

                The ICP command procedure failed to send a command
                to the X25router 2000. A VMS DCL message indicat-
                ing a reason for the failure follows the ICP mes-
                sage.







          ICP Messages                                        D-3

 








               %X25ROU-E-READFAILED, failed to read command status from X25router 2000
               VMS error message

                The ICP command procedure failed to read the sta-
                tus message from the X25router 2000. A VMS DCL mes-
                sage indicating a reason for the failure follows the
                ICP message.


          D.3 ICP Fatal Messages

               %X25ROU-F-RUNFAIL, X25router 2000 ICP has failed
               VMS error message
               [%X25ROU-I-IOST2, IOST2 = nnn])

                The ICP test has failed. A VMS DCL message indicat-
                ing a reason for the failure follows the ICP mes-
                sage. The third line of the message (if present) pro-
                vides some further diagnostic information (RUN com-
                mand).



















          D-4       X25router 2000 Installation Procedures (VMS)

 














          _______________________________________________________

                                                            Index




          A                            Authorization Key

          Access control                 see Product
            example of command using        Authorization Key

               ,  4-14, 4-31           B
            for NML object,  4-14,
               4-31                    Backup of installation
            for TRACE,  4-14, 4-32        disk,  2-1
            password,  4-14, 4-31      Backup of system disk,
            username,  4-14, 4-31         3-3, 3-5
          Account                      Bilateral CUG
            to use for installation,     See CUG
               3-2, 3-4                Blocks
            to use for                   See disk space
               X25ROUCONFIG.COM,
               4-3                     C
            to use for
               X25ROUSETUP.COM,        Calling DTE,  2-8
               4-11, 4-28              Call mask,  2-8
          ADD option of                  format,  4-21, 4-38
             X25ROUCONFIG.COM,  4-2,   Call value,  2-8
                                         format,  4-22, 4-38
             4-3, 4-4  to  4-6         Cancelling the installa-
            NCP messages,  4-3            tion,  3-1
          Area number                  Changing DECnet
            DECnet node address,          characteristics,  4-29
               4-5                     Channels range,  2-6
            default,  4-5
          AREA router,  4-12

                                                          Index-1

 






          Channels range (cont'd.)     Configuration (cont'd.)
            allocation by PSDN           information required,
               authorities,  4-19,          2-3
               4-36                      of load host database,
            format,  4-18, 4-36             4-2  to  4-10
            for outgoing calls,          of X25router 2000
               4-18, 4-36                   permanent database,
          Checking the installation         4-10  to  4-44
            See ICP                    Connections
          Circuit cost                   adding to configuration,
            DDCMP circuit,  4-27,           1-6
               4-44                    Connector node
            DLM circuit,  4-26, 4-43     X25router 2000 as,
            Ethernet,  4-13, 4-30           4-20, 4-37
          Circuit database,  4-23,     Cost
             4-40                        See circuit cost
            purging,  4-24, 4-40       Counters,  5-14
          Circuit names                CUG,  2-8, 5-2
            format,  4-25, 4-42          format,  4-22, 4-38
          Clearing
            destination on remote      D

               VMS node,  5-13         Databases,  1-2
            destination on remote        circuit,  4-23, 4-40
               X25router 2000,  5-9      DECnet node,  4-6, 4-8
               to  5-10                  load host,  1-2, 4-4
          Closed user group              network names in the VAX
            See CUG                         P.S.I. Access node
          Cluster                           database,  1-3
            see VAXcluster               X25-PROTOCOL,  4-16,
          Command file for ICP,             4-33
             5-1                         X25router 2000 permanent
          Configuration                     ,  1-2, 4-10, 4-15,
            adding load hosts,  1-6         4-33
            adding new connections,      X25router 2000 volatile,
               1-6                          1-2
            adding new networks,            access control,  4-14
               1-6                       X25-SERVER,  4-20, 4-37
            adding VAX P.S.I. Access   Datalink mapping
               nodes,  1-6               See DLM
            adding X25router 2000s,    DDCMP circuits
               1-6                       defining,  4-24, 4-26
            changing,  1-5  to  1-7         to  4-27, 4-43
            example,  A-1  to  A-15

          Index-2

 






          DDCMP circuits (cont'd.)     DECrouter (cont'd.)
            type of X25router 2000       alternative term for
               node,  4-12, 4-29            X25router 2000,  4-2
          DDCMP lines                    type,  4-4
            adding to configuration,   Defaults
               1-6                       acceptance of,  3-1
            names,  4-43                 representation of,  3-1
          DEBNA service circuit,       DELETE option of
             4-5                          X25ROUCONFIG.COM,  4-2,
          DEBNT service circuit,          4-3, 4-7  to  4-8
             4-5                         NCP messages,  4-3
          DEC MicroServer,  x          DELUA service circuit,
            down-line loading to,         4-5
               4-1, 4-45               DEMSA
            Ethernet address,  4-5,      configuring for,  4-10
               4-7                          to  4-28
            use of term,  x              use of term,  x
          DEC MicroServer-SP,  x       DEMSB
            use of term,  x              configuring for,  4-28
          DECnet,  1-3, 2-2                 to  4-44
            characteristics,  4-12,      use of term,  x
               4-29                    DEQNA service circuit,
            circuits,  4-23, 4-40         4-5
            node address,  4-5         Destination
               area number,  4-5         clearing remote,  5-9,
               format,  4-5                 5-13
            node database,  4-1,         definition,  4-21, 4-37
               4-2, 4-6                  name,  4-21, 4-37
               restoring,  4-8           node name,  2-7, 4-21,
               stored on central            4-38
                  node,  4-8             priority,  2-8, 4-21,
            node name,  4-11, 4-28          4-38
               format,  4-4              set up,  5-10
            running during                  on remote X25router
               installation,  3-3              2000,  5-6
            service circuit-ID,  4-5     show,  5-10
          DECnet node databases        Destination call mask
            upgrading X25router 2000     See call mask
               entries in,  4-9        Destination call value
          DECnet object                  see call value
            defining ICP as,  5-2      Destination on Remote
          DECrouter                       X25router 2000

                                         clearing,  5-9  to  5-10

                                                          Index-3

 






          Destination subaddress       DTE (cont'd.)
            see subaddress               address format,  4-18,
          DESVA service circuit,            4-35, 5-13
             4-5                         check set up,  5-11
          DEUNA service circuit,         defining,  4-16, 4-18,
             4-5                            4-33, 4-35
          Device identifier              local for DLM circuits,
            See device name                 4-26
          Device name,  3-2              remote for DLM circuits,
          Directories                       4-26
            SYS$COMMON: [DECSERVER],   DTE address
               4-12, 4-29                remote,  5-8
            SYS$HELP,  3-4             DTE permanent database
            SYS$SYSROOT: [DECSERVER]     purging,  4-17, 4-33
               ,  3-7                  Dump files
            SYS$UPDATE,  3-7             naming convention for,
            used for installed files        4-4
               ,  C-1  to  C-3         E
          Disk
            default for installation   Error messages
               ,  2-1                    ICP,  D-2  to  D-4
          Disk space                   Errors
            free blocks required for     completing ICP,  5-5,
               installation,  2-1           5-14
               to  2-2                   loading X25router 2000,
          Distribution media,  1-4          4-45
          DLM circuits                 Ethernet,  1-2
            defining,  4-24, 4-25      Ethernet address
               to  4-26                  format,  4-5
            INCOMING,  4-26, 4-42        replacement of hardware
            incoming calls,  4-13,          unit,  4-7
               4-30                      where to find it,  4-5
            OUTGOING,  4-26, 4-42      Ethernet circuit cost,
            PERMANENT,  4-26, 4-42        4-13, 4-30
            type of X25router 2000     Event logging,  4-6
               node,  4-12, 4-29         commands,  4-45
          Down-line loading,  1-3      Events
            necessary information,       reporting during load
               1-2                          sequence,  4-45
            X25router 2000 software,   Examples
               4-45                      ICP,  B-1  to  B-2
          DTE                            testing an installation,
                                            B-1  to  B-2

          Index-4

 






          Examples (cont'd.)           Format (cont'd.)
            VMS installation and         DTE addresses,  4-18,
               configuration,  A-1          4-35, 5-13
               to  A-15                  Ethernet address,  4-5
          EXECUTOR characteristics       line names,  4-27, 4-43
            See DECnet characteris-      network names,  2-5
               tics                      subaddress range,  4-22,
          Exiting                           4-39

            from an X25ROUCONFIG.COM   H
               option,  4-2
            from NCP,  5-3             Hard copy of release
            from X25ROUCONFIG.COM,        notes,  3-2
               4-2                     Hardware unit
          F                              LED display,  4-45
                                         replacement of,  4-6
          Files                        HELP,  4-2
            installed on load host,      X25ROUSETUP.COM,  4-11,
               C-1  to  C-3                 4-28

            installed with TRACE,      I
               C-2
            SYS$MANAGER:NETTRACE_      ICP
               INSTALL.COM,  3-9         clearing remote
            system start-up,  3-9           destinations,  5-10
            X25ROU011. RELEASE_          completion,  5-5
               NOTES,  3-4, 3-9          completion with errors,
            X25router 2000,  C-1  to        5-14
               C-2                       defining as a DECnet
          Format                            object,  5-2
            call mask,  4-21, 4-38       error messages,  D-2  to
            call value,  4-22, 4-38         D-4
            circuit names,  4-25,        example of testing,  B-1
               4-42                      incorrect DTE address,
            CUG,  4-22, 4-38                5-14
            DECnet node address,         incorrect installation,
               4-5                          5-14
            DECnet node name,  4-4       loopback test,  5-4,
            default for line names,         5-5, 5-6
               4-19, 4-36                messages,  D-1  to  D-4
            destination name,  4-21,     preparing to run,  5-2
               4-37                      privileges required,
            device name,  3-2               5-2
                                         running,  5-1  to  5-14

                                                          Index-5

 






          ICP                          Line name (cont'd.)
            running (cont'd.)            for X.25,  2-6
               to remote VMS system,   Line permanent database
                  5-2, 5-4, 5-8,         purging,  4-16, 4-33
                  5-12                 Lines,  4-13
               to remote X25router       ports,  4-13, 4-30
                  2000,  5-1             speeds,  4-13, 4-30
            using TRACE to find        LIST option of
               errors,  5-14              X25ROUCONFIG.COM,  4-2,
            X.25 Test Receiver            4-3, 4-4
               See PSIXTR              LMF
          Incoming calls                 see License Management
            DLM,  4-13, 4-30                Facility
            X.25,  4-13, 4-30          Load files
          Installation                   naming convention for,
            account to use,  3-2,           4-4
               3-4                     load host database,  4-1
            cancelling,  3-1           Load host database,  4-4
            checking disk space,         configuration,  4-2  to
               2-2                          4-10
            disk to use,  2-1            new entries,  4-4
            example,  A-1  to  A-15      upgrading X25router 2000
            on multiple load hosts,         entries in,  4-9
               3-9                     Load hosts
            starting the procedure,      adding to configuration,
               3-4                          1-6
            time required,  1-5          changing,  4-7
          Installation Checkout          installing on more than
             Procedure                      one,  3-9
            See ICP                      version of VMS/MicroVMS,
                                            1-1
          L                            Local DTE number
                                         for DLM circuits,  4-43
          LCN                          Logging events
            See channels range           commands,  4-45
          LED display on hardware      Logical channel numbers
             unit,  4-45                 See channels range
          License Management           Loopback test,  5-4, 5-5,
             Facility,  3-6               5-6

          Line name                    M
            DDCMP circuit,  4-27,
               4-43
            format,  4-19, 4-36

          Index-6

 






          Maximum recalls,  4-26,      NETTRACE_INSTALL.COM,
             4-43                         3-9, C-3
          Media                        NETTRACE_MESSAGES.EXE,
            See distribution media        C-3
          Messages                     Network Control Program
            ICP,  D-1  to  D-4           See NCP
          MOM$LOAD                     Network names
            redefining,  3-10            connections to PSDNs,
            system logical,  3-9            1-3
          Multiple load hosts            defining,  4-17
            installing on,  1-2, 3-9     for different access

          N                                 routes,  1-3
                                         for DLM circuits,  4-26,
          Naming convention                 4-43
            for dump files,  4-4         format,  2-5
            for load files,  4-4         requirements,  1-3
          NCP,  2-2                      to distinguish lines,
            exit from,  5-3                 1-3, 1-4
            messages,  4-3               use,  1-3
          NETLTC.EXE,  C-2               VAX P.S.I. Access node
          NETTRACE$DDCMP_                   database,  1-3
             ANALYZE.EXE,  C-3         Networks
          NETTRACE$ETHERNET_             adding to configuration,
             ANALYZE.EXE,  C-3              1-6
          NETTRACE$GAP_ANALYZE.EXE,    NML object
             C-3                         access control,  4-14,
          NETTRACE$KEY.INIT,  C-3           4-31
          NETTRACE$L2E_ANALYZE.EXE,    Node address
             C-3                         See DECnet node address
          NETTRACE$L2_ANALYZE.EXE,     Node name
             C-3                         See DECnet node name
          NETTRACE$L3_ANALYZE.EXE,     Node type
             C-3                         See X25router 2000 type
          NETTRACE$L3_DDX76_           NONROUTING node,  4-12,
             ANALYZE.EXE,  C-3            4-29
          NETTRACE$NSP_ANALYZE.EXE,
             C-3                       O
          NETTRACE$ROUTING_            Object
             ANALYZE.EXE,  C-3           set up and show,  5-11
          NETTRACE$SYNC_ANALYZE.EXE    Object identification,
             ,  C-3                       2-8, 4-22, 4-39
          NETTRACE.EXE,  C-2           On-line release notes

                                                          Index-7

 






          On-line release notes        Profile names (cont'd.)
             (cont'd.)                   defining,  4-17, 4-18,
            See Release notes               4-34
          ON-RUNNING                     use of correct profile
            DTE state,  5-3                 names,  1-4
          OPTIONS N,  3-2                where to find,  1-4
          P                            PSDN
                                         attributes,  1-4
          PAK                            defining,  4-16, 4-33
            see Product                  names,  4-17, 4-34
                                       PSIXTR,  5-2
               Authorization Key       Purging
          Password                       files replaced by
            access control,  4-14,          installation,  3-5
               4-31                    PVC circuits
            TRACE,  4-15, 4-32           defining,  4-24, 4-25
          Permanent database
            See X25router 2000         R

               permanent database      Recall timer,  4-26, 4-43
          Preparation                  Release notes,  3-2, 3-9
            for configuring,  2-2        displaying,  3-3
               to  2-8                   hard copy,  3-2
            for installing,  2-1  to     printing,  3-2, 3-3
               2-2                       reading,  3-2, 3-3
            information requirements   Remote DTE number
               ,  2-3                    for DLM circuits,  4-43
          Priority,  4-13, 4-30        Replacing the hardware
            destination,  4-21, 4-38      unit,  4-6
          Privileges,  4-3             RESTORE option of
            required for ICP,  5-2        X25ROUCONFIG.COM,
            required for                  3-10, 4-2, 4-8  to
               X25ROUCONFIG.COM,          4-10
               2-3, 4-3                  restoring automatically,
            required for                    4-9
               X25ROUSETUP.COM,          restoring manually,  4-8
               2-3, 4-11, 4-28         ROUCONFIG.DAT,  C-2
            required to install          display contents,  4-4
               X25router 2000          Router priority
               software,  2-2            value,  4-13, 4-30
          Product Authorization        ROUTING IV node,  4-12,
             Key,  3-6                    4-29

          Profile names
            default,  2-5

          Index-8

 






          S                            SYS$COMMON,  3-10

          Second load host             SYS$COMMON:[DECSERVER],
            See multiple load hosts       4-12, 4-29
          Sending address,  4-22,      SYS$HELP,  3-4, C-1, C-2
                                       SYS$LIBRARY,  C-3
             4-39                      SYS$MANAGER,  C-3
            use of wildcards,  4-22,   SYS$MANAGER:NETTRACE_
               4-39                       INSTALL.COM,  3-9
          Service circuit-ID           SYS$MESSAGE,  C-3
            default,  4-6              SYS$SYSDEVICE,  2-1
            for Ethernet controller    SYS$SYSROOT:[DECSERVER],
               type,  4-5                 3-7, C-1  to  C-2
          SERVICE ENABLED,  4-6        SYS$SYSTEM,  3-9, C-2
          Starting the installation    SYS$TEST,  C-2
             ,  3-4                    SYS$UPDATE,  3-7
          Status and error counters    SYSTARTUP.COM,  3-9
             ,  5-14                   SYSTARTUP_V5.COM,  3-9
          Subaddress,  2-8             System disk
            definition,  4-39            backup,  3-3, 3-5
            range for incoming calls   System logical
               ,  4-22, 4-39             MOM$LOAD,  3-9
            range for incoming DLM,    System start-up
               4-13, 4-30                restoring the load host
            remote ICP destination,         database,  4-8
               5-7                     System start-up file
          SVC                            editing,  3-8

            see Switched Virtual       T

               Circuits                Testing an installation
          SWAP option of                 example,  B-1
             X25ROUCONFIG.COM,  4-2,     using ICP,  5-1  to
             4-3, 4-6  to  4-7              5-14
            Ethernet address,  4-7     Time required to install,
            NCP messages,  4-3            1-5
            with multiple load hosts   TRACE
               ,  4-7                    access control,  4-14,
          Switched Virtual Circuit          4-32
            required for ICP,  5-2       files installed,  C-2
          Synchronous port number,       file used to install,
             2-6                            3-9
            DDCMP circuit,  4-27         opportunity to install,
            default for line name,          3-6
               4-19                      password,  4-15, 4-32
            for DTE,  4-19

                                                          Index-9

 






          TRACE (cont'd.)              X

            username,  4-15, 4-32      X.25 line DTE
            use with ICP,  5-14          adding to configuration,
          TRACEHLP.HLB,  C-2                1-6
          Types of lines,  4-13        X.25 permanent database

          U                              purging,  4-17, 4-33
                                       X25011.SYS,  C-1
          UPGRADE option of            X25ICP,  5-3
             X25ROUCONFIG.COM,  4-2    X25node-name.SYS,  C-2
          Upgrading X25router 2000     X25-PROTOCOL database
             entries,  4-9               defining,  4-16, 4-33
          Username                       purging,  4-16, 4-33
            access control,  4-14,     X25ROU011.RELEASE_NOTES,
               4-31                       3-4, 3-9, C-1
            TRACE,  4-15, 4-32         X25ROUCONFIG
                                         See X25ROUCONFIG.COM
          V                            X25ROUCONFIG.COM,  3-7,

          VAXcluster                      4-1, 4-2  to  4-10, C-1
            installing on,  3-9,         account to use,  4-3
                                         ADD option,  4-2, 4-3,
               3-10                         4-4
          VAX P.S.I. Access nodes        DELETE option,  4-2,
            adding to configuration,        4-3, 4-7
               1-6                       exiting from,  4-2
            X25router 2000 as            exiting from an option,
               connector node for,          4-2
               4-20, 4-37                LIST option,  4-2, 4-3,
          Versions of VMS required,         4-4
             1-1                         NCP messages,  4-3
          VMS                            privileges required,
            versions required,  1-1         4-3
          VMSINSTAL                      RESTORE option,  3-10,
            file for release notes,         4-2, 4-8
               3-4                       SWAP option,  4-2, 4-3,
            running,  3-2  to  3-9          4-6
          VMS installation               UPGRADE option,  4-2
            see installation             using,  4-2  to  4-10
          VMS load host database       X25ROUPERM.EXE,  3-8, C-2
            See load host database     X25ROUPERM.HLB,  C-1
          Volatile database for        X25ROUSETUP.COM,  1-6,
             X25router 2000,  1-2         3-8, C-2
            access control,  4-14        account to use,  4-11,

                                            4-28

          Index-10

 






          X25ROUSETUP.COM (cont'd.)    X25router 2000 permanent
            on-line HELP,  4-11,          database,  4-30, 4-33
               4-28                      configuration,  4-1,
            privileges required,            4-11  to  4-44
               4-11, 4-28                effect of X25ROUSETUP.COM
            running,  4-10  to  4-44        ,  4-10
          X25router 2000                 modifications,  3-8
            down-line loading            tailoring,  4-10
               software,  4-45         X25ROU_DEFINE.COM,  C-1
            type,  4-12, 4-29          X25ROU_DEFINE_HELP.COM,
          X25router 2000 configura-       C-1
             tion                      X25ROU_ICP.COM,  5-1, C-2
            See configuration          X25ROU_LOGICALS.COM,  C-1
          X25router 2000 node name     X25ROU_MULTI_HOST.COM,
            See DECnet node name          C-2
                                       X25ROU_PROFILES.SYS,  C-2
                                       X25-SERVER database,
                                          4-20  to  4-23, 4-37
                                          to  4-40






















                                                         Index-11
