Router________________________________________ Configuration and Management from PCs Order Number: AA-Q642A-TE Revision/Update Information: This is a new manual Software Version: DECNIS[TM] V2.3 __________________________________________________________ First Printing, March 1994 While Digital believes the information included in this publication is correct as of the date of publication, it is subject to change without notice. Possession, use, or copying of the software described in this documentation is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. Digital Equipment Corporation makes no representations that the use of its products in the manner described in this publication will not infringe on existing or future patent rights, nor do the descriptions contained in this publication imply the granting of licenses to make, use, or sell equipment or software in accordance with the description. © Digital Equipment Corporation 1994. All Rights Reserved. The following are trademarks of Digital Equipment Corporation: DEC, DECbrouter, DECnet, DECNIS, DEPCA, Digital, EtherWORKS, PATHWORKS, and the DIGITAL Logo. IBM is a registered trademark of International Business Machines Corporation. Kermit is a registered trademark of Jim Henson Productions, Inc. OSI is a registered trademark of CA Management, Inc. Windows is a trademark, and MS-DOS is a registered trademark, of Microsoft Corporation. All other trademarks and registered trademarks are the property of their respective holders. This document was prepared using VAX DOCUMENT, Version 2.1. ________________________________________________________________ Contents Preface.................................................. ix 1 Introduction 1.1 Supported Routers............................ 1-1 1.2 Required Software............................ 1-1 1.3 Overview..................................... 1-1 1.3.1 Setting Up Network Facilities............ 1-2 1.3.2 Configuring the Router................... 1-2 1.3.3 Loading the Router....................... 1-3 Part I Installation and Configuration 2 Installing the Software 2.1 Installing the Software...................... 2-3 2.1.1 Installing the DECROU Software........... 2-3 2.1.2 Installing the Router Software........... 2-4 2.2 What to Do Next.............................. 2-4 2.2.1 Reporting Problems....................... 2-5 2.3 Updating a Configuration..................... 2-5 2.3.1 Updating the NAI......................... 2-6 2.3.2 Updating Your Configuration.............. 2-6 iii 3 Setting Up the Network Application Interface 3.1 What Is the NAI?............................. 3-1 3.2 Who Should Set Up the NAI?................... 3-1 3.3 Before You Start............................. 3-1 3.4 Setting Up the NAI........................... 3-2 3.5 Starting the Network......................... 3-3 3.6 Starting the NAI Automatically............... 3-4 3.7 Stopping the NAI............................. 3-4 3.8 Ethernet Drivers............................. 3-4 3.8.1 Ethernet Drivers Provided................ 3-4 3.8.2 Support for Other NDIS Drivers........... 3-5 3.8.3 Installing NDIS Drivers.................. 3-5 3.8.4 Nonstandard Settings..................... 3-6 3.9 Removing Network Systems..................... 3-6 3.9.1 Removing PATHWORKS Version 4............. 3-6 3.9.2 Removing PATHWORKS Version 5............. 3-7 4 The Router Management Menu 4.1 Calling Up the Menu ......................... 4-1 4.2 Explanation of Menu Options.................. 4-2 4.2.1 Selecting Options........................ 4-3 4.2.2 Moving Back.............................. 4-3 5 Using the Load-Host Configurator 5.1 What Is the Load-Host Configurator?.......... 5-1 5.1.1 Using BOOTP/TFTP......................... 5-1 5.1.2 Using MOP................................ 5-2 5.2 Starting the Load-Host Configurator.......... 5-2 5.3 Menu Options................................. 5-2 5.4 How to Enter Load Information................ 5-3 5.5 Load Information............................. 5-3 5.5.1 Load Client Name ........................ 5-3 5.5.2 Hardware Address......................... 5-4 5.5.3 IP Address .............................. 5-4 5.5.4 Phase IV Address......................... 5-4 5.5.5 Type of Loading.......................... 5-5 5.5.6 Specifying a Dump File................... 5-5 5.6 Getting Help................................. 5-6 5.7 Errors....................................... 5-6 5.8 The Load-Host Data File...................... 5-6 iv 5.8.1 Saving the Load-Host Data File........... 5-6 5.9 What Happens to the Load Information......... 5-6 6 Using the Router Configurator 6.1 What Is the Router Configurator?............. 6-1 6.2 Starting the Router Configurator............. 6-1 6.3 Using the Router Configurator Keys........... 6-2 7 Getting Help when Running the Configurators 7.1 How to Get Online Help....................... 7-1 7.2 Help on Fields and Menu Choices.............. 7-1 7.3 Help on the Configurators.................... 7-1 7.4 Keys to Get Help............................. 7-2 8 Setting Up and Using BOOTP/TFTP 8.1 Introduction................................. 8-1 8.1.1 What Is BOOTP/TFTP?...................... 8-1 8.2 Before You Start............................. 8-1 8.3 Starting the BOOTP/TFTP Server............... 8-2 8.3.1 Starting: Foreground Mode................ 8-2 8.3.2 Starting: Background Mode................ 8-2 8.4 Starting the BOOTP/TFTP Server Automatically................................ 8-3 8.5 The BOOTP/TFTP Server Window................. 8-3 8.6 Displaying the Foreground Mode BOOTP/TFTP Server Window................................ 8-3 8.6.1 The Foreground Mode Menu................. 8-4 8.7 Displaying the Background Mode BOOTP/TFTP Server Window................................ 8-5 8.7.1 The Background Mode Menu................. 8-5 8.8 Stopping the BOOTP/TFTP Server............... 8-6 8.8.1 Foreground Mode.......................... 8-6 8.8.2 Background Mode.......................... 8-7 v 9 Loading a Router 9.1 Introduction................................. 9-1 9.2 Before You Load.............................. 9-1 9.2.1 BOOTP/TFTP Loading....................... 9-1 9.2.2 MOP Loading.............................. 9-2 9.3 How to Load.................................. 9-2 9.4 How to Reload................................ 9-2 9.4.1 Default Type of Reloading................ 9-2 9.4.2 Reloading from a Load Host............... 9-3 9.4.3 Reloading from a Specified MOP Load Host..................................... 9-4 Part II Using Router Applications on the PC 10 Using the Load-Host Configurator Options 10.1 Delete a Router.............................. 10-1 10.1.1 Deleted Files............................ 10-1 10.2 Modify a Router ............................. 10-2 10.2.1 After Modifying.......................... 10-2 10.2.2 Modifying Type of Loading................ 10-2 10.3 Restore a Router............................. 10-3 10.4 Update a Router.............................. 10-3 11 Using the Network Control Language 11.1 What Is NCL?................................. 11-1 11.2 Using NCL.................................... 11-1 11.2.1 NCL Command Format....................... 11-1 11.2.2 Node Names in NCL Commands............... 11-2 11.2.3 Setting Up DECnet Node Names............. 11-2 11.2.4 Example.................................. 11-3 11.3 Help on NCL.................................. 11-3 11.3.1 Structure of NCL Help.................... 11-3 11.4 Editing NCL Commands......................... 11-4 11.4.1 Line Length.............................. 11-5 11.4.2 Command Length........................... 11-5 11.5 Displaying NCL Output........................ 11-5 11.5.1 Using ............................ 11-6 11.5.2 Using ............................ 11-6 11.6 Exiting from NCL............................. 11-7 11.7 Restrictions................................. 11-7 vi 11.7.1 SNAPSHOT Command......................... 11-7 11.7.2 SHOW Command for SNAPSHOT................ 11-7 11.7.3 DECdns Names in NCL Commands............. 11-8 12 Connecting to a Console 12.1 Selecting CONSOLE............................ 12-1 12.2 Before You Start............................. 12-1 12.3 Starting MS-DOS Kermit....................... 12-1 12.4 More Information............................. 12-1 Part III Appendixes A Information Required for Load-Host Configuration B Information About the DEC Network Integration Server B.1 Introduction................................. B-1 B.2 Automatic Restore............................ B-1 B.3 Automatic Update............................. B-1 B.3.1 Update: Full Nonvolatile Memory ......... B-2 B.3.2 Update: Part Nonvolatile Memory.......... B-2 B.3.3 Update: Load Host Loading................ B-2 B.4 DECNIS Online Documentation.................. B-3 B.5 Files Created on a PC........................ B-5 B.5.1 Saved Version of the DECNIS Data File.... B-7 B.6 Files Loaded from a PC to a DECNIS........... B-7 B.7 How BOOTP Finds the Load Files on the DECNIS....................................... B-8 C MOP Loading to a DECNIS from a PATHWORKS V5 Load Host C.1 Before You Begin............................. C-1 C.2 Procedure.................................... C-1 C.3 Moving Profile Files......................... C-3 C.3.1 What You Need to Do...................... C-3 C.3.2 Profile File Names....................... C-4 C.3.3 Example.................................. C-4 C.4 DECNIS Hardware Address...................... C-4 C.4.1 Finding the Port Hardware Address........ C-4 C.4.2 Procedure................................ C-5 C.5 Example...................................... C-6 vii D MOP Loading to a DECNIS from a PATHWORKS V4.1 Load Host D.1 Procedure.................................... D-1 Index Tables 2-1 Prerequisite Information................. 2-1 3-1 NETSET Information....................... 3-3 3-2 Ethernet Drivers Provided................ 3-5 6-1 Configurator Keys........................ 6-2 7-1 Keys Used to Get Help.................... 7-2 8-1 BOOTP/TFTP Server Menu: Foreground Mode..................................... 8-4 8-2 BOOTP/TFTP Server Menu: Background Mode..................................... 8-5 11-1 Keys for Editing NCL Commands............ 11-4 11-2 Keys for Displaying NCL Output........... 11-6 A-1 Load-Host Configuration Information...... A-2 B-1 Documents Installed...................... B-3 B-2 DECNIS File Names on PCs................. B-6 B-3 Files Loaded............................. B-8 C-1 Hardware Address Assignment.............. C-5 C-2 Examples of Hardware Address Assignment on a DECNIS 600.......................... C-5 viii ________________________________________________________________ Preface This manual explains how to: o Install Digital router software on an IBM[[R]]- compatible Personal Computer running MS-DOS[[R]] (PC). o Configure the PC so it can load to supported routers, and communicate with these routers on the network. o Start and use the Digital Network Control Language (NCL) on the PC. Audience This manual is intended for network managers. It assumes that you understand and have some experience of: o MS-DOS PCs o Local Area Networks (LANs) o Wide Area Networks (WANs) o The BOOTP/TFTP protocols Associated Documentation Product Documentation Using MS-DOS Kermit Router Documentation This section lists the documentation for Digital routers that can be configured, loaded and managed from a PC. o DEC Network Integration Server Configuration and Loading ix o DEC Network Integration Server Introduction and Glossary o DEC Network Integration Server Management o DEC Network Integration Server Problem Solving This is only available on line in a text file. o DEC Network Integration Server Event Messages This is only available on line in a text file. o DEC Network Integration Server Release Notes This is only available on line in a text file. o Network Information This supplies profile information about all the public Packet Switching Data Networks that Digital supports. This is only available on line in a text file. Related Documentation If you are running PATHWORKS[TM] on your PC, you may need to refer to the following: o The PATHWORKS Version 5 manual set, in particular: - PATHWORKS V5 for DOS and Windows DECnet Network Management Guide - PATHWORKS V5 for DOS and Windows Client Installation and Configuration Guide o PATHWORKS for DOS DECnet Network Management Guide from the PATHWORKS for DOS V4.1 manual set (only if you are using a PATHWORKS V4.1 system as a MOP load host) Documentation Comments If you have comments or suggestions for this manual and you have access to the Internet, please mail your comments electronically to the writing group within Digital at the following address: doc_quality@lkg.mts.dec.com Alternatively, you can complete the postpaid Reader's Comments form at the end of this document. Thank you. x Conventions The following conventions are used in this manual: Key names are shown enclosed to indicate that you press a key on the keyboard. Single letters are also denoted in this way. This symbol indicates that you press the key at the same time as you press another key. For example, , , and so on. Italics This indicates variable information. DECNIS DEC Network Integration Server PC An IBM-compatible personal computer running MS-DOS Prompts The following prompts precede commands that you enter: For MS-DOS: C:\> For NCL: NCL> For NCP: NCP> xi 1 ________________________________________________________________ Introduction This manual describes how to configure, load and manage supported routers from a PC. 1.1 Supported Routers The supported routers are the following: o DEC[TM] Network Integration Server 500 (DECNIS[TM] 500) o DEC Network Integration Server 600 (DECNIS 600) 1.2 Required Software To enable your PC to configure, load and manage your router, you need to install two sets of software: o The DECROU software, which supplies the facilities needed to configure, load and manage your router from a PC. o The router software, which contains the facilities specific to your router. 1.3 Overview There are three main tasks you need to carry out before you can configure, load and manage your router from a PC: o Set up network facilities on the PC. o Configure the router. o Load the router. Introduction 1-1 Introduction 1.3.1 SETTING UP NETWORK FACILITIES In order to load and manage a router, the PC needs to be able to communicate with it on the network. There are two ways you can set up the PC to do this: o Install PATHWORKS Version 5. Refer to the PATHWORKS Version 5 documentation set for details of installing and setting up PATHWORKS. o Set up and run the Network Application Interface (NAI), supplied as part of the DECROU software. Refer to Chapter 3. 1.3.2 CONFIGURING THE ROUTER To configure your router, you need to do the following: 1. Run the load-host configurator on the PC, and enter information needed to load your router from the PC. 2. Run the router configurator on the PC, and enter information about your router on the network; for example, addresses, protocol options, passwords. 3. Create a master NCL script file. The router configurator will do this at your request when you finish entering information. master NCL script file is a text file of NCL commands. NCL is a utility that allows you to set, change and display the configuration parameters of systems on a network. NCL commands are the mechanism used to manage and monitor your router. 4. Create a configuration load file. The router configurator will do this at your request, after it has created a master NCL script file. 1-2 Introduction Introduction configuration load file is the file actually loaded to the router. It can be either of the following: o CMIP file. This is a binary version of the NCL script file. It is loaded together with the separate software image and any profile files. o Combined image/CMIP/profile file. This is used if you requested nonvolatile memory loading in the load-host configurator (see Section 5.5.5). This file combines the software, CMIP file and profile files into one compressed file. Refer to your router configuration manual for more details. 1.3.3 LOADING THE ROUTER Once you have created a configuration load file, you can load your router. PCs running PATHWORKS Version 5 or the NAI can use BOOTP/TFTP for loading. TFTP is a set of protocols used for loading and dumping, defined in RFCs 783 and 951. PCs running PATHWORKS Version 5 can also use MOP (Maintenance Operations Protocol) for loading. a Digital-specific protocol used for loading and dumping. Note that you need to carry out extra steps to set up MOP loading; refer to Appendix C for details. Introduction 1-3 Part I ________________________________________________________________ Installation and Configuration Part I describes how to do the following: o Set up a PC so it can load the router, and communicate with it on the network. o Install and configure the router and router software on a PC. It contains the following chapters: o Chapter 2 describes how to install the router software. o Chapter 3 describes how to set up the Network Applications Interface, which enables the PC to load the router, and to communicate with it on the network. o Chapter 4 describes the Router Management Menu. o Chapter 5 describes how to use the load-host configurator. o Chapter 6 describes how to start the router configurator, and gives basic information on using it. o Chapter 7 describes how to get online help when running the load-host and router configurators. o Chapter 8 describes how to start, stop and monitor the BOOTP/TFTP server. o Chapter 9 describes how to load your router from a PC. 2 ________________________________________________________________ Installing the Software This chapter describes how to: o Install the software to configure, load and manage your router from a PC. o Update a previously configured router. Table 2-1 gives the information you need to check before you install the software. Table_2-1_Prerequisite_Information________________________ Item________________Value/Description_____________________ Prerequisite MS-DOS Version 5 (or later) software PATHWORKS Version 5 (if you are using PATHWORKS as the network operating system) Prerequisite 386 or 486 PC with 8 Mbytes of RAM, hardware and a VGA monitor Supported Ethernet adaptor (see Section 3.8) A supported router (see Section 1.1) Memory required At least 3 Mbytes of free memory Disk space At least 16 Mbytes required for installation (continued on next page) Installing the Software 2-1 Installing the Software Table_2-1_(Cont.)_Prerequisite_Information________________ Item________________Value/Description_____________________ Disk space Minimum: 12 Mbytes per router required for Maximum: 32 Mbytes per router dumping___________________________________________________ 2-2 Installing the Software Installing the Software 2.1 Installing the Software You need to install two sets of software: o The DECROU software, which supplies the facilities needed to configure, load and manage your router from a PC. o The router software, which contains the facilities specific to your router. e following: o You must install the DECROU software before you install the router software. o You must not run Windows[[R]] while you install the software, or configure, load or manage your router. Stopping the Installation To abort the installation during the installation procedure, press . 2.1.1 INSTALLING THE DECROU SOFTWARE Follow these steps: 1. Insert the first DECROU disk in the drive. 2. Enter the following: A:\install 3. The screen asks for the installation directory. Enter the directory in which you want to install the software. The default shown on the screen is: C:\DECROU 4. The screen asks for the location of the installation disks. If you are installing from floppy disks, the default is: A:\ 5. Insert each disk in turn as requested. Press after you enter each new disk. 6. A message will appear saying that the installation is complete. Click on the Continue box, or press . Installing the Software 2-3 Installing the Software 2.1.2 INSTALLING THE ROUTER SOFTWARE Follow these steps: 1. Insert the first router disk in the drive. 2. Enter the following: A:\install 3. The screen asks for the installation directory. Enter the directory in which you installed the DECROU software; see step 3 in Section 2.1.1. 4. The screen asks for the location of the installation disks. If you are installing from floppy disks, the default is: A:\ 5. Insert each disk in turn as requested. Press after you enter each new disk. 6. A message will appear saying that the installation is complete. Click on the Continue box, or press . 2.2 What to Do Next The following table shows the remaining tasks you need to carry out in order to configure and load the router software. __________________________________________________________ Step_Task________________________Refer_to_________________ 1. If required, set up the Chapter 3 Network Applications Interface (NAI). Do not do this if you will run PATHWORKS V5 2. Call up the Router Chapter 4 Management Menu 3. Run the load-host Chapter 5 configurator 2-4 Installing the Software Installing the Software __________________________________________________________ Step_Task________________________Refer_to_________________ 4. Run the router Chapter 6 and Chapter 7 configurator 5. If using BOOTP/TFTP for Chapter 8 loading, start the BOOTP /TFTP server 6. If using MOP for loading, Appendix C supply MOP information and start MOP 7.___Load_the_router_____________Chapter_9________________ Directory Used for Commands This manual instructs you to use the installation directory as the current directory when entering commands. As an alternative, you can do either of the following: o Add the installation directory to a PATH command in AUTOEXEC.BAT. This makes it more convenient to enter commands. o Use the full directory specification. ou modify AUTOEXEC.BAT or CONFIG.SYS, you must reboot the PC for your changes to take effect. 2.2.1 REPORTING PROBLEMS For instructions on reporting problems to Digital, refer to the problem solving manual for your router. Refer to Table B-1 for a list of the problem solving manual text files for the DECNIS. 2.3 Updating a Configuration If you have previously installed and configured DECROU and router software on your PC, you must update your configuration when you install a new version of the software. This section describes how to do this. Installing the Software 2-5 Installing the Software 2.3.1 UPDATING THE NAI If you are using the NAI, you must rerun the NETSET software each time you install a new version of the DECROU software. Refer to Chapter 3 for details. 2.3.2 UPDATING YOUR CONFIGURATION When you install a new version of the router software, you must update your router configurations, as described in the following procedure. You must do this even if you do not want to change your configuration. you have installed a new version of router software, follow these steps: 1. Run the automatic Update procedure. For DECNIS systems, see Section B.3. 2. Start the router configurator, as described in Chapter 6. 3. Select Modify an existing configuration from the router configurator Main Menu. 4. Select the router that you are updating from the list of load client names displayed. 5. The Sections Menu is now displayed. Select NCL Script. You will go to the Create NCL Script section. 6. Select Create an NCL Script. This creates a master NCL script file that is valid for the new version of the router software. 7. Create a new load file: either a CMIP file or a combined image/CMIP/profile file, depending on what is displayed on the menu. 8. Repeat steps 2 to 7 for each router that will use the new version of the software. 9. Reload your routers, as described in Chapter 9. 2-6 Installing the Software 3 ________________________________________________________________ Setting Up the Network Application Interface This chapter describes how to set up the Network Application Interface (NAI). 3.1 What Is the NAI? The NAI is software that provides DECnet[TM] Phase IV, TCP /IP and BOOTP/TFTP capabilities on a PC. The NAI enables the PC to load software to the router, and to communicate with the router on the network. 3.2 Who Should Set Up the NAI? If your PC is not running PATHWORKS Version 5, you must set up the NAI. 3.3 Before You Start You cannot run the NAI if your PC is running any other network software, such as PATHWORKS. If you have another network system installed, remove it from memory. Refer to Section 3.9 for more information. Setting Up the Network Application Interface 3-1 Setting Up the Network Application Interface 3.4 Setting Up the NAI To set up the NAI, follow these steps: ange directories to the installation directory. For example: C:\> cd DECROU 2. Enter the following at the command prompt: NETSET 3. The following screen is displayed. Enter information in the fields. If you ran NETSET previously, the information already entered is displayed; you can change it if you wish. DECROU NAI Setup Ctrl-Enter to accept completed form. Enter or TAB to cycle through fields. ESC to quit. Node Name: Node IP Address: Node IP Mask: Node DECnet Address: Datalink Driver Name: Is a Gateway to be used (Y/N): Gateway IP Address: You can use the up and down arrow keys to move between fields once they have been completed. Table 3-1 explains the information you enter. 3-2 Setting Up the Network Application Interface Setting Up the Network Application Interface Table_3-1_NETSET_Information______________________________ PC Information____Notes______________________________________ Node Name Node name of the PC. Maximum 6 characters. The name is used for both DECnet and TCP /IP. Node IP Internet protocol (IP) address for the PC. Address Node IP mask Subnet mask for the IP address. Node DECnet DECnet address of the PC. address Datalink The name of a subdirectory of C:\install- Driver Name directory\NET\DRIVERS. For example, DEPCA[TM]. See Section 3.8 for details. Is a Gateway Enter Y if there is an IP gateway on the to be used? LAN to which the PC is connected. Gateway IP IP Address of the IP gateway. If you Address entered N for the previous question, just _______________press_._Do_not_enter_an_address.____ You must rerun NETSET each time you install a new version of the DECROU software. 3.5 Starting the Network Once you have entered the NETSET information, start the network. Follow these steps: 1. Change directories to the installation directory. For example: C:\> cd DECROU 2. Enter the following at the command prompt: NET\STARTNET Problems when Starting the Network If you enter STARTNET, and the network fails to start, you will need to reboot your PC. Setting Up the Network Application Interface 3-3 Setting Up the Network Application Interface 3.6 Starting the NAI Automatically To set up the NAI to start automatically, follow these steps: t up the NAI, as described in Section 3.4. 2. Add the following line to your AUTOEXEC.BAT file: call C:\install-directory\NET\STARTNET.BAT where install-directory is the installation directory. 3.7 Stopping the NAI To stop the NAI and remove it from memory, enter the following at the command prompt: STOPNET You will be asked to confirm that you want to stop the NAI. If the BOOTP/TFTP server is running, you must stop it before you stop the NAI. See Section 8.8 for details. 3.8 Ethernet Drivers This section contains information about Ethernet controllers and drivers that you can use on your PC. 3.8.1 ETHERNET DRIVERS PROVIDED The DECROU product provides a number of Ethernet drivers. These drivers have been tested by Digital, and are known to work with the DECROU software. Each driver is located in a subdirectory of the following directory: C:\install-directory\NET\DRIVERS where install-directory is the installation directory. Table 3-2 shows the Ethernet drivers provided. 3-4 Setting Up the Network Application Interface Setting Up the Network Application Interface Table_3-2_Ethernet_Drivers_Provided_______________________ Driver File_______SubdirectorEthernet_Controller_________________ DEPCA.DOS DEPCA DEPCA family of Ethernet adaptors DEPEA.DOS DEPEA DEPEA Personal Ethernet adaptor EWRK3.DOS EWRK3 EtherWORKS[TM] and EtherWORKS 3 ______________________adaptors____________________________ Contents of Driver Subdirectories Each driver subdirectory contains: o The driver file o The driver's PROTOCOL.INI file 3.8.2 SUPPORT FOR OTHER NDIS DRIVERS In addition to the Ethernet controllers and drivers listed in Table 3-2, other Ethernet controllers that have their own NDIS drivers may work with the DECROU software. However, such drivers have not been tested by Digital. 3.8.3 INSTALLING NDIS DRIVERS The Ethernet drivers in Table 3-2 are automatically installed by the installation procedure. If you wish to try using another NDIS driver, you need to install it yourself. To do this, follow these steps: eate a new subdirectory of C:\install- directory\NET\DRIVERS, with the same name as the Ethernet driver. For example, if the installation directory is C:\DECROU, and the name of the driver is ELNKPL, create the directory: C:\DECROU\NET\DRIVERS\ELNKPL 2. Move the driver file and the driver's PROTOCOL.INI file to this subdirectory. Setting Up the Network Application Interface 3-5 Setting Up the Network Application Interface ame of the driver file must have the following format: driver-name.DOS For example, the name of the driver file for ELNKPL would be: C:\DECROU\NET\DRIVERS\ELNKPL\ELNKPL.DOS 3.8.4 NONSTANDARD SETTINGS If you are using a third party driver, and have followed the steps in Section 3.8.3, NETSET will incorporate the driver's PROTOCOL.INI file into a master PROTOCOL.INI file. The master PROTOCOL.INI file is held in the following directory: C:\install-directory\NET where install-directory is the installation directory. o If your Ethernet adaptor settings are nonstandard, be sure to alter the settings in the driver's PROTOCOL.INI file before you run NETSET. This ensures that they will always be correct in the master PROTOCOL.INI file. o If for some reason you change settings in the master PROTOCOL.INI file, rather than the driver PROTOCOL.INI file, note that the changed settings will be lost the next time you run NETSET. 3.9 Removing Network Systems You cannot run another network system while you are running the NAI. For example, if you choose to run the NAI, you cannot run PATHWORKS. 3.9.1 REMOVING PATHWORKS VERSION 4 To remove PATHWORKS Version 4, follow these steps: 1. Remove any PATHWORKS entries from CONFIG.SYS and AUTOEXEC.BAT. 2. Reboot the PC. 3-6 Setting Up the Network Application Interface Setting Up the Network Application Interface 3.9.2 REMOVING PATHWORKS VERSION 5 If the PC is running PATHWORKS Version 5, but you wish to use the NAI instead, enter the following at the command prompt: STOPNET Setting Up the Network Application Interface 3-7 4 ________________________________________________________________ The Router Management Menu This chapter describes the Router Management Menu. You use the Router Management Menu to select the applications you need to configure, manage and control your router. 4.1 Calling Up the Menu To call up the Router Management Menu, follow these steps: ange directories to the installation directory. For example: C:\> cd DECROU 2. Enter the following at the command prompt: DECROU Note the following: o If your PC does not have a color monitor, enter the following at the command prompt: DECROU/BW o If your PC is using MS-DOS/V for Japanese, you must change your screen mode to English. There are two ways to do this: - To switch the PC screen mode to English, enter the following at the command prompt: CHEV US - To restart MS-DOS/V with English mode, enter the following at the command prompt: SWITCH The Router Management Menu 4-1 The Router Management Menu You will see the Router Management Menu: NCL Use the Network Command Language BOOTP Run the BOOTP/TFTP server in the foreground CONFIG Run the Router configurator HOST Run the Load-host configurator CONSOLE Run console terminal emulation DOS Run an MS-DOS command shell EXIT Return to MS-DOS 4.2 Explanation of Menu Options The following table explains what each menu option does. __________________________________________________________ Option____Explanation___________Refer_to:_________________ NCL Starts the Network Chapter 11 Control Language (NCL) management tool BOOTP Starts the BOOTP Chapter 8 /TFTP server, used to load the router CONFIG Starts the router Chapter 6 configurator for the installed router-for example, the DECNIS configurator HOST Starts the load-host Chapter 5 configurator CONSOLE Starts console Chapter 12 terminal emulation on the PC DOS Runs a new copy of Your PC documentation the MS-DOS command processor 4-2 The Router Management Menu The Router Management Menu __________________________________________________________ Option____Explanation___________Refer_to:_________________ EXIT Returns you to the Your PC documentation MS-DOS operating __________system__________________________________________ 4.2.1 SELECTING OPTIONS To select a menu option, follow these steps: 1. Move the cursor to the application you want, using the arrow keys. 2. Press . 4.2.2 MOVING BACK From the Router Management Menu, you can move back to the screen displayed just before the menu. To do this, press or . For example, an application may display an error message and exit back to the Router Management Menu. If the error message was displayed too quickly for you to see it, you can press or on the Menu to see the error message. The Router Management Menu 4-3 5 ________________________________________________________________ Using the Load-Host Configurator This chapter describes how to use the load-host configurator to configure the DECNIS to load from PC load hosts. 5.1 What Is the Load-Host Configurator? The load-host configurator is a menu-based program, supplied with the router software. You use the program to: o Enter information required for a PC to load software and configuration files to a router, and receive dumps. This is described in the present chapter. o Delete, modify, list, update and restore loading information. This is described in Chapter 10. You must run the load-host configurator before you run your router configurator. host is a PC which can load the configured router software to the router hardware in response to a load request. 5.1.1 USING BOOTP/TFTP In the load-host configurator, you enter information that enables the PC to use BOOTP/TFTP to load the router. BOOTP/TFTP is a set of protocols for loading and dumping, defined in RFCs 783 and 951. In order to use BOOTP/TFTP to load your router, you must start the BOOTP/TFTP server, as described in Chapter 8. Using the Load-Host Configurator 5-1 Using the Load-Host Configurator 5.1.2 USING MOP A PC may use MOP to load the router. MOP (Maintenance Operations Protocol) is a Digital-specific protocol used for loading and dumping. If you intend to use MOP for loading, note the following: o The load-host configurator does not set up MOP loading information. o In order to use MOP for loading, the PC must be running PATHWORKS: - Refer to Appendix C for information on configuring and loading from a PATHWORKS Version 5.0 PC. - Refer to Appendix D for information on loading from a PATHWORKS Version 4.1 PC. 5.2 Starting the Load-Host Configurator To start the load-host configurator, follow these steps: ll up the Router Management Menu, as described in Section 4.1. 2. Select HOST. 5.3 Menu Options When you run the load-host configurator, it displays a menu with these options: o Add a router To set up router loading information for the first time. o Delete a router To delete loading information for a router. o Modify a router To modify loading information previously set up using the load-host configurator. o List a router To display the routers that have been set up using the load-host configurator. 5-2 Using the Load-Host Configurator Using the Load-Host Configurator o Restore a router To recreate loading and dumping information for a router. o Update a router To update loading information to the latest version of router software. 5.4 How to Enter Load Information To enter load configuration information about a router for the first time, follow these steps: 1. Select Add a router from the Main Menu. 2. The screen displays a list of routers, depending on the routers installed. For example, it might display: Select the type of router, or return to the Main Menu. Return to Main Menu DECNIS 600 DECNIS 500 Select the type of router to load. 3. Enter load information on the screens. Section 5.5 describes the information in detail. 5.5 Load Information This section describes the information you enter on the load-host configurator screens. 5.5.1 LOAD CLIENT NAME The load client name identifies the router for downline loading and upline dumping. Finding the Load Client Name You create the load client name yourself. The only restrictions are: o The name must be unique to this router. o The maximum length of the name is 6 characters. Using the Load-Host Configurator 5-3 Using the Load-Host Configurator 5.5.2 HARDWARE ADDRESS This is the hardware address of the router. The format is six pairs of hexadecimal digits, separated by hyphens. 00-2b-35-8A-70 Finding the Hardware Address on the DECNIS On the DECNIS, the address is printed on the label on the Processor Card. Enter the address just as it is on the label, including the 0 (zero) as the final digit. 5.5.3 IP ADDRESS You must supply an IP address for the router. This is required for BOOTP/TFTP loading. Format The format of the IP address is four decimal integers, separated by decimal points. 45.21.8 5.5.4 PHASE IV ADDRESS This is the DECnet[TM] Phase IV address of the router. You must enter this address if any of the following are true: o You plan to manage your router from the PC. The DECnet address is used to identify your router in management commands. See Section 11.2.2 and Section 11.2.3 for details. o The router will need to communicate with DECnet Phase IV systems. Otherwise, it is optional. Format The format of the Phase IV address is: area-number.node-number where:area-number is the number of the area where the router is located 5-4 Using the Load-Host Configurator Using the Load-Host Configurator node-number is the node number of the router 47 5.5.5 TYPE OF LOADING The load-host configurator asks how the router is to be loaded when it is rebooted: Nonvolatile memory for both CMIP and image Load host for CMIP; nonvolatile memory for image Load host for both CMIP and image rm nonvolatile memory refers to an area of router memory that is used to store its software image and (as an option) its CMIP and profile files. Nonvolatile memory is sometimes referred to as flash memory. Advantages The main advantages of nonvolatile memory loading are: o It is quicker than loading from a load host. o Once the router is loaded, you do not need a load host on the network to reload it when it is rebooted. Refer to your router configuration manual for more information about nonvolatile memory loading. 5.5.6 SPECIFYING A DUMP FILE The load-host configurator asks if you want a dump file to be created on the load host. o If you select No, the load host will not be able to receive dumps from the router. o If you select Yes, the router will dump to the file: install-directory\CLIENTS\load-client-name\DUMP It is important to check that there is enough disk space on the PC to receive dumps. Table 2-1 shows the amount of disk space required for dumps. Using the Load-Host Configurator 5-5 Using the Load-Host Configurator 5.6 Getting Help You can get online help at any time while running the load-host configurator. Refer to Chapter 7 for details. 5.7 Errors If there are any errors when you are running the load-host configurator, they will be recorded in a log file. For the name of the log file for DECNIS systems, see Appendix B. 5.8 The Load-Host Data File The load-host configurator saves all load-host configuration information in a private data file, known as the load-host data file. When you modify or delete routing information, the load-host configurator uses the load- host data file to find the information that was previously entered. For the name of the load-host data file for DECNIS systems, see Table B-2. 5.8.1 SAVING THE LOAD-HOST DATA FILE Each time you use the load-host configurator to add, modify or delete information, it creates a new load- host data file. It also saves the previous version of the load-host data file. The name of the previous version is the same as the name of the current one, except that it has the suffix .OLD instead of the suffix .DAT. 5.9 What Happens to the Load Information When you have finished entering information in the load- host configurator, it does the following: o Saves the information in the load-host data file o Writes information about the router to be loaded in the following file: C:\install-directory\BOOTP.TAB 5-6 Using the Load-Host Configurator Using the Load-Host Configurator where install-directory is the installation directory. Using the Load-Host Configurator 5-7 6 ________________________________________________________________ Using the Router Configurator This chapter describes how to start your router configurator, and how to get help. 6.1 What Is the Router Configurator? Once you have set up loading information in the load-host configurator, you need to run the router configurator supplied with your router. You use the router configurator to enter the information needed for the router to communicate with other systems. For example, you enter information about network addresses, routing options, interfaces and protocols. The information you enter depends on your router. The router configurator is a menu-based program, with screens on which you select or type in information. The screens are grouped into sections, each corresponding to a type of configuration information. When you finish a section, you can go to the next one, or go back and change information you previously entered. For detailed information on your router configurator, refer to the configuration manual for your router. 6.2 Starting the Router Configurator To start your router configurator, follow these steps: ll up the Router Management Menu, as described in Section 4.1. 2. Select CONFIG. Using the Router Configurator 6-1 Using the Router Configurator 6.3 Using the Router Configurator Keys Table 6-1 shows the keys you use to enter and change information, and to move through the configurator sections. Table_6-1_Configurator_Keys_______________________________ Key____________Function___________________________________ Up Arrow Moves the cursor to the field above Down Arrow Moves the cursor to the field below Left Arrow Moves the cursor to the left within a field Right Arrow Moves the cursor to the right within a field or Enters the option you have chosen Gives help on a field or section Takes you out of Help and back to entering data Takes you out of the configurator without saving any data Takes you to the previous data entry screen in a section Takes you to the next data entry screen in a section Shifts between inserting characters and overtyping characters Removes all text in a field Refreshes the screen <<--> Deletes the character to the left of the (Backspace) cursor Moves the cursor to the previous column (on _______________screens_with_two_columns)__________________ 6-2 Using the Router Configurator 7 ________________________________________________________________ Getting Help when Running the Configurators You can get online help when running the load-host configurator and your router configurator. This chapter describes how to get online help, how to leave online help, and the different types of online help you can get. 7.1 How to Get Online Help To get online help in either configurator, press . 7.2 Help on Fields and Menu Choices If you press when the cursor is on a field or menu, three lines of text appear near the bottom of the screen, telling you what sort of value to enter, or what the results are of making a menu choice. If you press again, another screen appears with more information. If there are several screens of information, you can page through them by pressing or . If you look in the upper righthand corner of a Help screen, it will say how many pages of Help text there are. For example, Page 1 of 2. To leave a Help information screen, press . 7.3 Help on the Configurators To get help on using the configurators themselves (for example, the keys you can use), press while you are on any other Help screen. Getting Help when Running the Configurators 7-1 Getting Help when Running the Configurators 7.4 Keys to Get Help Table 7-1 shows the keys you can use to get Help, or to leave Help. Table_7-1_Keys_Used_to_Get_Help___________________________ Pressing this key...______From_this_screen...____Gives_you_this...______ Data entry screen 3-line Help Data entry screen Full screen of help with 3-line Help displayed Full screen of help Procedures Help menu Full screen of help, Next screen of Procedures Topic information Full screen of help, Previous screen of Procedures Topic information Procedures Topic Return to Procedures Help Menu Full screen of help, Leave Help and return Procedures Help menu, to entering data ____________Procedures_Topic______________________________ 7-2 Getting Help when Running the Configurators 8 ________________________________________________________________ Setting Up and Using BOOTP/TFTP This chapter describes how to control the BOOTP/TFTP server. 8.1 Introduction You must start the BOOTP/TFTP server before you attempt to use BOOTP/TFTP to load your router. 8.1.1 WHAT IS BOOTP/TFTP? BOOTP/TFTP is a set of protocols used for loading devices such as routers. The protocols are defined in RFCs 783 and 951. OTP/TFTP server is the software that enables the PC to use the BOOTP/TFTP protocols to load to and dump from supported routers. o For loading, BOOTP determines the IP address of the device to be loaded, and the name of a file to be loaded. TFTP is the protocol actually used for loading. o For dumping, the router uses BOOTP to find a host that can receive a dump. TFTP is used to write the dump. 8.2 Before You Start Check the following: o If the PC is running PATHWORKS Version 5.0, rather than the NAI, make sure that the installation option TCP/IP and Utilities was selected during PATHWORKS installation. If the PC is not running PATHWORKS Version 5.0, be sure that you have set up the NAI, as described in Section 3.4. Setting Up and Using BOOTP/TFTP 8-1 Setting Up and Using BOOTP/TFTP o If you are loading several routers, you may wish to increase the number of UDP sockets supported, as BOOTP /TFTP can use up to 12 sockets. 8.3 Starting the BOOTP/TFTP Server There are two methods for starting the BOOTP/TFTP server, depending on whether you wish to run it in foreground mode or background mode. 8.3.1 STARTING: FOREGROUND MODE Follow these steps: 1. Call up the Router Management Menu, as described in Section 4.1. 2. Select BOOTP If you use this method, you cannot run any other application while BOOTP/TFTP is running. This is referred to as running in foreground mode. 8.3.2 STARTING: BACKGROUND MODE Follow these steps: 1. Change directories to the installation directory. For example: C:\> cd DECROU 2. Enter the following at the command prompt: RBOOT With this method, you can run other applications while BOOTP/TFTP is running. This is referred to as running in background mode. Problems with Background Mode If there are problems while running the BOOTP/TFTP server in background mode, you should switch to running it in foreground mode. For advice on possible problems, see the problem solving manual for your router. 8-2 Setting Up and Using BOOTP/TFTP Setting Up and Using BOOTP/TFTP 8.4 Starting the BOOTP/TFTP Server Automatically If you wish, you can start the BOOTP/TFTP server automatically whenever you start up your PC. With automatic starting, the BOOTP/TFTP server will run in background mode. he following command to the AUTOEXEC.BAT file: call C:\install-directory\RBOOT.BAT where install-directory is the installation directory. You must add this command after the STARTNET line in the AUTOEXEC.BAT file. See Section 3.6 for more information. 8.5 The BOOTP/TFTP Server Window The BOOTP/TFTP server provides a window to monitor the progress of a BOOTP/TFTP load (or dump). The window also allows you to do the following: o Control the BOOTP/TFTP server. o Stop the BOOTP/TFTP server. o Control the display of information about a load or dump. Section 8.6 explains how to start and use the window in foreground mode; Section 8.7 explains how to start and use the window in background mode. 8.6 Displaying the Foreground Mode BOOTP/TFTP Server Window If you selected BOOTP from the Router Management Menu, the BOOTP/TFTP server window is automatically displayed. Initially, the window only shows a command prompt: time Command (? for list) > _ where time is the time in hours, minutes and seconds. Setting Up and Using BOOTP/TFTP 8-3 Setting Up and Using BOOTP/TFTP 8.6.1 THE FOREGROUND MODE MENU If you enter , the following menu appears: d to toggle responding to dump l /PG DN to show the lower log display t to toggle display of unsatisfied requests u /PG UP to show the upper log display x /END to exit from bootp z to clear the log file The first column shows the key to press. The second column explains what happens if you press the key. Table 8-1 explains these actions more fully. Table_8-1_BOOTP/TFTP_Server_Menu:_Foreground_Mode_________ Action________Explanation_________________________________ Toggle Decides whether this PC will accept a BOOTP responding /TFTP dump request from a router to dump Show the Displays the last twelve events that have lower log been sent during a load or dump display Show the Displays the twelve events previous to the upper log last twelve sent during a load or dump display Toggle Shifts between displaying and not displaying display of requests from devices++ for a load unsatisfied requests Exit from Closes down the BOOTP/TFTP server BOOTP Clear the Deletes the contents of the log file so far log file ++Devices_other_than_routers_make_BOOTP_load_requests,_for example, printers __________________________________________________________ 8-4 Setting Up and Using BOOTP/TFTP Setting Up and Using BOOTP/TFTP 8.7 Displaying the Background Mode BOOTP/TFTP Server Window If you are running the BOOTP/TFTP server in background mode, you can display the BOOTP/TFTP server window. Do the following: e command prompt, hold down the following keys at the same time: Left The letter < b > Initially, the window looks like the foreground mode window described in Section 8.6. 8.7.1 THE BACKGROUND MODE MENU If you enter , the following menu appears: e to exit leaving the window up r to terminate and remove the TSR d to toggle responding to dump l /PG DN to show the lower log display t to toggle display of unsatisfied requests u /PG UP to show the upper log display x /END to exit leaving the TSR running Table 8-2 explains these actions more fully. Table_8-2_BOOTP/TFTP_Server_Menu:_Background_Mode_________ Exit leaving the For diagnostic purposes only window up Toggle responding to Same as Table 8-1 dump Show the lower log Same as Table 8-1 display Show the upper log Same as Table 8-1 display (continued on next page) Setting Up and Using BOOTP/TFTP 8-5 Setting Up and Using BOOTP/TFTP Table_8-2_(Cont.)_BOOTP/TFTP_Server_Menu:_Background_Mode_ Toggle display of Same as Table 8-1 unsatisfied requests Terminate and remove Closes down the BOOTP/TFTP server the TSR Exit leaving the TSR Return to command prompt. The server running_______________continues_to_run_in_background_mode_ 8.8 Stopping the BOOTP/TFTP Server You stop the BOOTP/TFTP server from the BOOTP/TFTP server window. There are two methods, depending on whether the server is running in foreground mode or background mode. 8.8.1 FOREGROUND MODE If the BOOTP/TFTP server is running in foreground mode, the window will be started. Do the following: e BOOTP/TFTP server window, press the letter < x >. 8-6 Setting Up and Using BOOTP/TFTP Setting Up and Using BOOTP/TFTP 8.8.2 BACKGROUND MODE To stop the BOOTP/TFTP server when it is running in background mode, follow these steps: art the BOOTP/TFTP server window as described in Section 8.7. 2. Press the letter < r >. Setting Up and Using BOOTP/TFTP 8-7 9 ________________________________________________________________ Loading a Router 9.1 Introduction Once you have configured your router, you can load the load file or files from the PC to the router hardware. This chapter describes how to do this. The method of loading described in this chapter is direct loading. irect loading, the PC that holds the files to be loaded is on the same Local Area Network (LAN) as the router. 9.2 Before You Load This section describes the checks you should make before you attempt to load or reload your router. 9.2.1 BOOTP/TFTP LOADING If you are using BOOTP/TFTP loading, make sure that the BOOTP/TFTP server is running on the PC load host, as follows: o If the BOOTP/TFTP server menu is displayed on the screen of your PC, the server is running in foreground mode. o If the BOOTP/TFTP server menu is not displayed, the server may be running in background mode. To check this, hold down the following keys at the same time: Left The letter < b > If the menu appears, then the server is running. Loading a Router 9-1 Loading a Router o Press the key < e > to leave the menu. If the BOOTP/TFTP server is not running, then start it as described in Section 8.3. 9.2.2 MOP LOADING The PC load host must be running PATHWORKS in order to use MOP loading. Refer to Appendix C and Appendix D for details. 9.3 How to Load To downline load a router from a load host, follow these steps: 1. Connect the router hardware unit to the LAN. 2. Plug the hardware unit in to the power supply and power up. 9.4 How to Reload If the router has been loaded previously, you can reload it by issuing Network Control Language (NCL) commands. You can also reload the router by powering it up, as described in Section 9.3. Section 9.4.1 to Section 9.4.3 describe various methods of reloading. For more information about the NCL commands described here, refer to NCL help. 9.4.1 DEFAULT TYPE OF RELOADING This section explains how to cause the router to reload using its default type of loading. The default is the type of loading set up for the router during load-host configuration: Full nonvolatile memory loading, partial nonvolatile memory loading, or load host loading. Issuing the NCL LOAD Command Follow these steps: 9-2 Loading a Router Loading a Router ll up the Router Management Menu, as described in Section 4.1. 2. Select NCL 3. Issue the following command: NCL> LOAD NODE router/username/password DEVICE UNIT device where:router is either the DECnet Phase IV address or node name of the router. username and password are the user name and password you enter when using NCL commands to manage the router. device is MP* for the DECNIS. Powering Up If you power up the router, as described in Section 9.3, this will have the same effect as issuing the NCL LOAD command. 9.4.2 RELOADING FROM A LOAD HOST This section describes how to cause the router to reload from a load host, rather than from nonvolatile memory. Issuing NCL Commands To cause the router to reload from a load host, follow these steps: ll up the Router Management Menu, as described in Section 4.1. 2. Issue the following command: NCL> SET NODE router/username/password HARDWARE - _NCL> DEBUG FLAGS 1073741952 This tells the router to load from a load host the next time it reloads. 3. Issue the following command: NCL> LOAD NODE router/username/password DEVICE UNIT device where router, username, password and device are defined as in Section 9.4.1. Loading a Router 9-3 Loading a Router This reloads the router. Note that these commands do not specify which load host on the network will be used. Powering Up If you power up the router with the dump button pressed in, this will cause the router to load from the load host. Powering up with the dump button pressed in empties the nonvolatile memory in the router hardware unit. The router always attempts to load from a load host if there is no load file in its memory. 9.4.3 RELOADING FROM A SPECIFIED MOP LOAD HOST You can cause the router to reload from a particular MOP load host, provided that the load host is reachable from the router. To reload the router from a particular MOP load host, follow these steps: ll up the Router Management Menu, as described in Section 4.1. 2. Issue the following command: NCL> LOAD NODE load-host/username/password - _NCL> MOP CLIENT client-name where:load-host is the DECnet node name of the MOP load host. username and password are the user name and password you must enter when using NCL commands to manage the router. client-name is the router's MOP client name, as set up on the MOP load host. 9-4 Loading a Router Part II ________________________________________________________________ Using Router Applications on the PC This part gives more information about the applications you can run from the Router Management Menu. It contains the following chapters: o Chapter 10 describes how to use the load-host configurator to delete, change, update and restore load information. o Chapter 11 describes how to use the Network Control Language (NCL) on a PC. o Chapter 12 describes the CONSOLE option on the Router Management Menu. 10 ________________________________________________________________ Using the Load-Host Configurator Options This chapter briefly describes the following load-host configurator Main Menu options: o Delete a router o Modify a router o Restore a router o Update a router 10.1 Delete a Router Delete a router displays a list of routers that were previously entered using the load-host configurator. You select the name of the router you wish to delete. 10.1.1 DELETED FILES If you delete a router, the load-host configurator renames the router configuration files previously created for that router. The load-host configurator renames the router configuration files, as follows: o The master NCL script file for the deleted router is renamed: NCLSCRPT.OLD o The CMIP file for the deleted router is renamed: SCRIPT.OLD o The data file for the deleted router is renamed: load-client-name.OLD where load-client-name is the load client name you gave the router in the load-host configurator. Using the Load-Host Configurator Options 10-1 Using the Load-Host Configurator Options Refer to Table B-2 for the complete file specifications of these files. Example In the load-host configurator, you set up a router with the load client name EAST. You then configure EAST using the router configurator. A master NCL script file is created with the name: EAST.NCL If you delete EAST in the load-host configurator, the master NCL script file will be renamed: EAST.OLD 10.2 Modify a Router When you select Modify a router, the screen displays a list of router systems that were previously entered using the load-host configurator. You select the name of the router you wish to modify. Information You Cannot Modify The only load information you cannot modify is the load client name. 10.2.1 AFTER MODIFYING It is strongly recommended that you rerun your router configurator after using Modify. This is because changes to loading information may affect or even invalidate information entered in the router configurator. 10.2.2 MODIFYING TYPE OF LOADING If you change the type of loading-for example, from nonvolatile memory loading to load-host loading-you must do the following for your changes to take effect: n the router configurator for your router. 2. Go to the Create NCL Script section, and create an NCL script file. 3. In the same section, create a new CMIP file or image /CMIP/profile file. 10-2 Using the Load-Host Configurator Options Using the Load-Host Configurator Options Effect of Modifying Type of Loading If you change from nonvolatile memory loading to load-host loading, the combined image/CMIP/profile file is deleted on the load host. 10.3 Restore a Router The Restore option reenters information in the file bootp.tab, which contains BOOTP loading information. The Restore option is useful if the permanent load information is lost or deleted. There are two ways of using the Restore option: o Restore a router option in the load-host configurator, to restore an individual router. o The automatic Restore procedure, to restore all routers set up by the load-host configurator. For details of the automatic Restore procedure for DECNIS systems, see Section B.2. 10.4 Update a Router When you install a new version of router software, you need to update existing routers so that they can use the new version of the software. There are two kinds of update procedure: o Update a router option in the load-host configurator, to update an individual router. o The automatic Update procedure, to update all routers in the load-host data file. For details of the automatic Update procedure for DECNIS systems, see Section B.3. Using the Load-Host Configurator Options 10-3 11 ________________________________________________________________ Using the Network Control Language This chapter describes how to run the Network Control Language (NCL) on your PC. 11.1 What Is NCL? The Network Control Language (NCL) is a utility that enables you to manage and monitor your router on the network. You can enter NCL commands on a PC to: o Set and change the configuration parameters of your routers. o Monitor your routers. 11.2 Using NCL To use NCL on your PC, follow these steps: ll up the Router Management Menu, as described in Section 4.1. 2. Select NCL. 3. The NCL prompt will appear: ncl> 4. Enter the NCL commands at the NCL prompt. 11.2.1 NCL COMMAND FORMAT NCL commands have the following format: verb NODE node-name entity-name [{argument(s) /attribute(s)}] Using the Network Control Language 11-1 Using the Network Control Language 11.2.2 NODE NAMES IN NCL COMMANDS When using NCL on the PC, each NCL command must include a node name to identify the system being managed. This node name must be one of the following: o The DECnet Phase IV address of the node being managed. For your router, this must be the address that you entered in the load-host configurator. See Section 5.5.4 for details. o The DECnet Phase IV node name of the node being managed. Section 11.2.3 describes how to create a node name. You cannot use NCL on the PC to manage the PC itself. You can only use it to manage the following: o The supported routers listed in Section 1.1. o Any system running DECnet/OSI[TM], provided that the entities you wish to manage require only the standard NCL dictionary. 11.2.3 SETTING UP DECNET NODE NAMES To create a DECnet node name for your router, follow these steps: 1. Start the Network Control Program (NCP) utility, by entering the following at the command prompt: NCP 2. Enter the following NCP command: NCP> DEFINE NODE n.nnn NAME name where:n.nnn is the DECnet Phase IV address of the router name is a 6-character DECnet node name 11-2 Using the Network Control Language Using the Network Control Language 11.2.4 EXAMPLE In the load-host configurator, you have entered 5.67 for the Phase IV address of your router. To create a node name for the router, follow these steps: 1. Change directories to the installation directory. For example: C:\> cd DECROU 2. At the command prompt, enter: NET\NCP 3. Enter the following command: NCP> DEFINE NODE 5.67 NAME PEACH You can now enter NCL commands using either the address or node name. For example, both of the following commands are valid: ncl> SHOW NODE PEACH ROUTING CIRCUIT * ALL ncl> SHOW NODE 5.67 ROUTING CIRCUIT * ALL 11.3 Help on NCL To find out more about NCL, refer to the online help within NCL. To call up the online help, enter HELP at the NCL prompt: ncl> HELP This will give you details of the commands, entities, attributes and characteristics supported. Refer to the management manual for your router for details of the NCL commands used to carry out specific tasks. 11.3.1 STRUCTURE OF NCL HELP NCL Help is a hierarchical system with a number of levels. The method for navigating through Help is as follows: 1. The first Help screen displays a list of Help topics. 2. Enter the name or letter identifying a Help topic. Using the Network Control Language 11-3 Using the Network Control Language 3. The screen displays a sublist of Help topics. Repeat step 2. This will give you information or display a further list of topics. 4. To go back to the Help topics on the level above, press . 5. To leave Help, keep pressing until you reach the ncl> prompt. 11.4 Editing NCL Commands When you are entering NCL commands, there are a number of keys you can use to help you edit. These keys are listed in Table 11-1. Table_11-1_Keys_for_Editing_NCL_Commands__________________ Use these keys...________To_do_this...______________________________ Up Arrow Recall a previous command Down Arrow After recalling a previous command, recall the next command in the series Left Arrow Move the cursor to the left Right Arrow Move the cursor to the right or Enter a command you have typed Toggle between inserting characters and typing over characters Move the cursor to the start of the command line Move the cursor to the end of the command line Delete text from the cursor position to the start of the line < - > Type a hyphen at the end of a line to _______________continue_typing_a_command_on_the_next_line_ 11-4 Using the Network Control Language Using the Network Control Language 11.4.1 LINE LENGTH The maximum length of a line in an NCL command is 1024 characters. The effect of this is as follows: o If you are typing in an NCL command, when you reach the righthand side of the screen, the cursor automatically moves to the next line. o If you have typed 1024 characters or less, you can at any point go back to previous lines (using the left arrow key) and edit the command. o Once you type more than 1024 characters, the cursor jumps to the next line. At this stage, you cannot go back and edit previous lines. You must press to enter the command. 11.4.2 COMMAND LENGTH The maximum length of an NCL command (as opposed to a line) is 2048 characters. To type in a command longer than 1024 characters, use a hyphen as a continuation character. You can enter the hyphen at any point, as long as it is before you have typed 1024 characters. 11.5 Displaying NCL Output You use NCL commands starting with the keyword SHOW to display information about your system. The output from SHOW commands can be very long, taking up several screens. The output is automatically displayed one screen at a time. Table 11-2 shows the keys you can use to control the display of NCL command output. The first part of the table shows the keys you can use when the output is not yet complete. The second part shows the keys you can use after the final screen of output is displayed. Using the Network Control Language 11-5 Using the Network Control Language Table_11-2_Keys_for_Displaying_NCL_Output_________________ Use this key..._________To_do_this...______________________________ Before_the_output_is_complete_____________________________ Space bar or At the end of a screen, go to the next any key screen of output or Scroll to the last screen of output __________________________________________________________ After_the_output_is_complete______________________________ Go to the previous screen of output Go to the next screen of output Abort command output and return to the NCL _______________prompt_____________________________________ 11.5.1 USING Note that you can only page back through the last seven pages of command output. If you use to page back through the screens, and reach the start of the output for a command, the following message is displayed: no more screens 11.5.2 USING You can only use for one NCL command at a time. If you use to page forward through the screens, and reach the end of the output for a command, the following message is displayed: current page reached 11-6 Using the Network Control Language Using the Network Control Language 11.6 Exiting from NCL To exit from NCL at the ncl> prompt, type any of the following: o o o Exit and You will return to the Router Management Menu. 11.7 Restrictions This section describes restrictions in the use of NCL on the PC that do not apply to other systems that support NCL. 11.7.1 SNAPSHOT COMMAND When entering the SNAPSHOT command, you must specify the name of a file to hold the output of this command. SNAPSHOT Command Example For example, you wish to capture information about the counters produced by the CSMA/CD stations on a router named PEACH. You wish to hold the information in the file DECROU/PEACH. Enter the following command: ncl> SNAPSHOT NODE PEACH CSMA-CD STATION * ALL COUNTERS, - _ncl> TO PEACH.TMP 11.7.2 SHOW COMMAND FOR SNAPSHOT When entering a SHOW command to look at the output of a SNAPSHOT command, you must specify the name of the file that holds the SNAPSHOT output. SHOW Command Example To show the information in PEACH.SNP, enter this command: ncl> SHOW NODE PEACH CSMA-CD STATION * ALL COUNTERS, - _ncl> FROM PEACH.TMP Using the Network Control Language 11-7 Using the Network Control Language 11.7.3 DECDNS NAMES IN NCL COMMANDS A restriction applies to NCL commands containing attributes which are DECdns names. If you enter an NCL command of this type on your PC, the DECdns name must have the following format: NSCTSDECdns-full-name where:NSCTS is the namespace creation timestamp of the namespace in which the full name is registered. DECdns-full-name is the DECdns full name of the node. You cannot use a DECdns nickname; you must use the DECdns full name. CTS is a unique identifier for a namespace. It consists of 14 hexadecimal digits. The NSCTS is automatically created when the namespace is created. Finding the NSCTS: Example You have the following information: DECdns full .:main.node.name name of node Namespace in main which the node is registered nd the NSCTS for .:main.node.name, enter the following command: ncl> SHOW NODE :.main.node.name DNS CLERK KNOWN NAMESPACE * This command displays the NSCTS, opposite the label NSCTS Example Commands This section gives example NCL commands to which this restriction applies. In the examples: o The node name to be used as an attribute is: :.main.node.name o The NSCTS is: 00-12-23-56-77-A0-A1-A2-A3-A4-A5-A6-A7-18 11-8 Using the Network Control Language Using the Network Control Language fine :.main.node.name as an event sink for a router called PEACH, enter this command: ncl> SET NODE peach EVENT DISPATCHER SINK NODE - _ncl> {00-12-23-56-77-A0-A1-A2-A3-A4-A5-A6-A7-18:.main.node.name} t up X.25 security for outgoing calls for the node :.main.node.name, enter this command: ncl> SET X25 SERVER SECURITY NODES security_out NODES - _ncl> {00-12-23-56-77-A0-A1-A2-A3-A4-A5-A6-A7-18:.main.node.name} Using the Network Control Language 11-9 12 ________________________________________________________________ Connecting to a Console This chapter describes the CONSOLE option on the Router Management Menu. 12.1 Selecting CONSOLE Selecting the CONSOLE option on the Router Management Menu starts the MS-DOS Kermit[[R]] program on your PC. One of the features provided by MS-DOS Kermit is console terminal emulation on your PC. This allows the PC to connect to routers that support a console connection; for example, the DECbrouter[TM] 90. The DECNIS 500 and DECNIS 600 bridge/routers do not support a console connection. 12.2 Before You Start Before you select CONSOLE from the Router Management Menu, make sure that there is a physical connection between your PC and the system that you wish to connect to. 12.3 Starting MS-DOS Kermit When you select CONSOLE, you will see the prompt: Console.TE> You can now enter MS-DOS Kermit commands. 12.4 More Information For complete instructions on using MS-DOS Kermit, refer to the manual, Using MS-DOS Kermit. Connecting to a Console 12-1 Part III ________________________________________________________________ Appendixes This part contains the following appendixes: o Appendix A lists the information needed when running the load-host configurator. o Appendix B describes information you may need about the DEC Network Integration Server (DECNIS) bridge/router. This appendix includes a list of files created by the configurators, and a list of files loaded to the DECNIS from the PC. o Appendix C describes how to use MOP to load to supported routers from a PC running PATHWORKS V5. o Appendix D describes how to use MOP to load to supported routers from a PC running PATHWORKS V4.1. A ________________________________________________________________ Information Required for Load-Host Configuration Table A-1 lists the information needed when running the load-host configurator. Write down your values in the last column, headed Your Value. See Chapter 5 for explanatory notes on load-host configuration. Default Values The column labelled Default in the tables shows the default value supplied by the configurators for each item of information. If the Default column shows -, this means that the configurator does not provide a default. If the value is required, you need to provide it yourself. The column labelled Required/Optional shows whether the value is required or optional. Information Required for Load-Host Configuration A-1 Information Required for Load-Host Configuration Table_A-1_Load-Host_Configuration_Information___________________ R(equired) Information / Your Required________Notes_____________________O(ptional)Default___Value Type of Select from list R - router Load client Create a name to R - name identify the router for loading. Max. 6 characters Hardware LAN address of the R - address router. For a DECNIS, the address printed on the label on the Processor Card. Example: 08-00-2B-02- AA-20 IP address IP address for the R - DECNIS DECnet Phase Area number.node number R - IV address of Example: 2.43 router Type of Select one: load host R Nonvolatile loading for CMIP, nonvolatile memory memory for image; for nonvolatile memory for both both CMIP and image; CMIP load host for both CMIP and and image image Create a dump Select Yes or No R Yes file?___________________________________________________________ A-2 Information Required for Load-Host Configuration B ________________________________________________________________ Information About the DEC Network Integration Server B.1 Introduction This appendix describes information you may need about the DEC Network Integration Server bridge/router. In this appendix, the following conventions are used in file names: o install-directory is the installation directory. o client-name is the load client name of the DECNIS. B.2 Automatic Restore You use automatic Restore to restore load information for all DECNIS systems in the load-host data file. w these steps: 1. Change directories to the installation directory. For example: C:\> cd DECROU 2. Enter the following at the command prompt: NIS\NIS_HCFG/RESTORE B.3 Automatic Update When you install a new version of DECNIS software, you need to update existing DECNIS systems so that they can use the new version of the software. You use automatic Update to update all the DECNIS systems in the load-host data file. Information About the DEC Network Integration Server B-1 Information About the DEC Network Integration Server To use automatic Update, run the automatic Update procedure. When you start this procedure, you can also specify the type of loading for the updated systems. The default type of loading is full nonvolatile memory loading. B.3.1 UPDATE: FULL NONVOLATILE MEMORY To update all DECNIS systems and specify that the combined image and configuration file be loaded from nonvolatile memory, follow these steps: ange directories to the installation directory. For example: C:\> cd DECROU 2. Enter the following at the command prompt: NIS\NIS_HCFG/UPDATE You can achieve the same result by entering: NIS\NIS_HCFG/UPDATE/FLASH_FULL B.3.2 UPDATE: PART NONVOLATILE MEMORY To update all router systems, and specify that CMIP and profile files be loaded from the load host and the software image from nonvolatile memory, follow these steps: ange directories to the installation directory. For example: C:\> cd DECROU 2. Enter the following at the command prompt: NIS\NIS_HCFG/UPDATE/FLASH_PART B.3.3 UPDATE: LOAD HOST LOADING To update all DECNIS systems, and specify that the CMIP and profile files and the software image be loaded from the load host, follow these steps: B-2 Information About the DEC Network Integration Server Information About the DEC Network Integration Server ange directories to the installation directory. For example: C:\> cd DECROU 2. Enter the following at the command prompt: NIS\NIS_HCFG/UPDATE/NETWORK B.4 DECNIS Online Documentation The DECNIS installation procedure installs online documents in the following directory: install-directory\DOCS Table B-1 lists the documents installed. Table_B-1_Documents_Installed_____________________________ File_Name_____Description_________________________________ ___________DECNIS_Problem_Solving_Manual_Files____________ PSG_C00.TXT Title, Copyright, Contents, Preface PSG_C01.TXT Chapter 1: How to begin Problem Solving PSG_C02A.TXT Chapter 2: DECNIS Unreachable (part 1) PSG_C02B.TXT Chapter 2: DECNIS Unreachable (part 2) PSG_C03.TXT Chapter 3: DECNIS Reachable PSG_C04A.TXT Chapter 4: Checking Circuits (part 1) PSG_C04B.TXT Chapter 4: Checking Circuits (part 2) PSG_C04C.TXT Chapter 4: Checking Circuits (part 3) PSG_C05.TXT Chapter 5: Proxy Loading Problems PSG_C06.TXT Chapter 6: DECnet/OSI Routing Problems PSG_C07A.TXT Chapter 7: X.25 Problems (part 1) PSG_C07B.TXT Chapter 7: X.25 Problems (part 2) PSG_C07C.TXT Chapter 7: X.25 Problems (part 3) (continued on next page) Information About the DEC Network Integration Server B-3 Information About the DEC Network Integration Server Table_B-1_(Cont.)_Documents_Installed_____________________ File_Name_____Description_________________________________ ____________DECNIS_Problem_Solving_Manual_Files___________ PSG_C08.TXT Chapter 8: Internet Protocol (IP) Problems PSG_C09.TXT Chapter 9: Bridging Problems PSG_C10.TXT Chapter 10: AppleTalk Problems PSG_C11.TXT Chapter 11: Netware IPX Problems PSG_C12.TXT Chapter 12: Loopback Testing PSG_C13.TXT Chapter 13: Event Logging PSG_C14.TXT Chapter 14: Reporting Problems to Digital PSG_IDX.TXT Index __________________________________________________________ ________________DECNIS_Event_Message_Files________________ EVMSG23A.TXT Part 1 EVMSG23B.TXT Part 2 EVMSG23C.TXT Part 3 __________________________________________________________ _______________________Release_Notes______________________ NIS023.REL DECNIS V2.3 Release Notes __________________________________________________________ _____________________OSPF_NCL_Scripts_____________________ OSPF_EX1.NCL Example NCL scripts for setting up OSPF OSPF_EX2.NCL routing OSPF_EX3.NCL __________________________________________________________ _________________X.25_Network_Information_________________ FCNS$NI.TXT Information about the X.25 PSDNs supported ______________for_use_by_Digital_products_________________ B-4 Information About the DEC Network Integration Server Information About the DEC Network Integration Server B.5 Files Created on a PC Table B-2 shows the files created by the configurators on a PC. Information About the DEC Network Integration Server B-5 Information About the DEC Network Integration Server Table_B-2_DECNIS_File_Names_on_PCs______________________________ File______________Location______________________File_Name_______ Master NCL install- NCLSCRPT.NCL script file directory\CLIENTS\client- name Master NCL install- NCLSCRPT.OLD script file directory\CLIENTS\client- for deleted name DECNIS CREATE NCL install- CREATE.NCL script file directory\CLIENTS\client- name SET NCL script install- SET.NCL file directory\CLIENTS\client- name ENABLE NCL install- ENABLE.NCL script file directory\CLIENTS\client- name CMIP file install- SCRIPT directory\CLIENTS\client- name CMIP file for install- SCRIPT.OLD deleted DECNIS directory\CLIENTS\client- name Image/CMIP install- SYSTEM /profile file directory\CLIENTS\client- name Log file for install- NCLSCRPT.LOG CMIP conversion directory\CLIENTS\client- name Log file for install-directory\NIS NIS_DNIS.LOG configurator errors DECNIS data file install- client-name.DAT directory\CLIENTS\client- name DECNIS data install- client-name.OLD file for deleted directory\CLIENTS\client- DECNIS name B-6vInformation Abinstall-DEC Network Integratioclient-r data file directory\CLIENTS\client- name.BAK[1] name Previous DECNIS install- client- data file directory\CLIENTS\client- name.Vnn[1] name Load-host data install-directory\NIS NIS_HCFG.DAT file DECNIS dump file install- DUMP directory\CLIENTS\client- name [1]See_Section_B.5.1_for_details._______________________________ Information About the DEC Network Integration Server ________________________________________________________________ B.5.1 SAVED VERSION OF THE DECNIS DATA FILE When the DECNIS configurator creates a new DECNIS data file, it saves the old one, with a different file name extension. Normally, the previous DECNIS data file is saved with the following file name: client-name.BAK However, if you install a new version of the software, and then use the DECNIS configurator to modify an existing configuration, the configurator saves the previous data file with a different file name: client-name.Vnn where nn is the version number of the previous version of DECNIS software. B.6 Files Loaded from a PC to a DECNIS Table B-3 shows the names and locations of the files that are loaded to the DECNIS. Information About the DEC Network Integration Server B-7 Information About the DEC Network Integration Server Table_B-3_Files_Loaded__________________________________________ File_Name_______________________________Description_____________ Load-Host_Loading_Selected______________________________________ install-directory\COMMON\NISV23\SYSTEM Software image install-directory\CLIENTS\client- CMIP file name\SCRIPT install-directory\COMMON\NISV23\MCNM_ Modem Connect PRF profile file (only if synchronous lines configured) install-directory\COMMON\NISV23\X25L2_ X.25 profile files (only PR if lines configured for install-directory\COMMON\NISV23\X25L3_ X.25) PR ________________________________________________________________ Nonvolatile_Memory_Loading_Selected_____________________________ install-directory\CLIENTS\client- Combined image/CMIP name\SYSTEM_____________________________/profile_file___________ B.7 How BOOTP Finds the Load Files on the DECNIS The DECNIS software uses the BOOTP.TAB file to find the IP address and client name of the DECNIS. However, it does not use the BOOTP.TAB file to find the DECNIS load files. Although the BOOTP.TAB file contains pathnames for DECNIS load files, the DECNIS software ignores them. Instead, it looks for the files specified in Table B-3. The software uses the client name listed in BOOTP.TAB to find the correct subdirectory for the SCRIPT or SYSTEM file. B-8 Information About the DEC Network Integration Server C ________________________________________________________________ MOP Loading to a DECNIS from a PATHWORKS V5 Load Host This appendix describes how to set up MOP loading to a DECNIS from a PC running PATHWORKS for DOS, Version 5 (PATHWORKS V5 PC). C.1 Before You Begin Check that MOP was installed when you ran the PATHWORKS installation utility. MOP is a component under the DECnet and Utilities entry. Refer to the manual PATHWORKS V5 for DOS and Windows DECnet Network Management Guide for information about setting up MOP on your PC. C.2 Procedure Follow these steps: 1. Install the DECROU and DECNIS software on the PATHWORKS V5 PC. 2. Run the load-host configurator. As the load-host configurator only supports BOOTP loading, you must enter an IP address for the DECNIS, even if it does not need one. 3. Run the DECNIS configurator. In the NCL Script section, create a load file: either an image/CMIP/profile file or a CMIP file, depending on the type of loading selected in the load-host configurator. 4. Exit from the DECNIS configurator. 5. Now, run NCP. For example: C:\> NCP MOP Loading to a DECNIS from a PATHWORKS V5 Load Host C-1 MOP Loading to a DECNIS from a PATHWORKS V5 Load Host 6. Define the node name of the DECNIS: NCP> DEFINE NODE decnet-address NAME client-name where decnet-address is the DECnet Phase IV address of the DECNIS 7. Enter the hardware address of the DECNIS port that will receive the load. Section C.4 describes how to find the correct hardware address. NCP> DEFINE NODE client-name HARDWARE-ADDRESS - _NCP> hardware-address 8. If you are loading a separate software image, and CMIP and profile files, go to step 9. If you are loading a combined image/CMIP/profile file, follow these steps: a. Specify the combined image/CMIP/profile file, as follows: NCP> DEFINE NODE client-name LOAD-FILE - _NCP> install-directory\CLIENTS\client-name\SYSTEM where client-name is the load client name of the DECNIS and install-directory is the installation directory. b. To define a DECNIS dump file, enter the following: NCP> DEFINE NODE client-name DUMP-FILE - _NCP> install-directory\CLIENTS\client-name\DUMP c. Enter the following: NCP> SET NODE client-name ALL NCP> EXIT 9. To load a separate software image, and CMIP and profile files, follow these steps: a. To specify the software image and the CMIP file, enter the following: NCP> DEFINE NODE client-name LOAD-FILE - _NCP> install-directory\COMMON\NISV23\SYSTEM NCP> DEFINE NODE client-name MANAGEMENT-FILE - _NCP> install-directory\CLIENTS\client-name\SCRIPT C-2 MOP Loading to a DECNIS from a PATHWORKS V5 Load Host MOP Loading to a DECNIS from a PATHWORKS V5 Load Host b. To define a DECNIS dump file, enter the following: NCP> DEFINE NODE client-name DUMP-FILE - _NCP> install-directory\CLIENTS\client-name\DUMP c. Enter the following: NCP> SET NODE client-name ALL NCP> EXIT d. If your DECNIS has any serial lines, you need to copy the profile file(s) from the directory in which they are placed by the installation procedure to the directory: C:\pathworks-directory\FCNS Section C.3 explains this in detail. 10.Now, run MOP. Enter the following: C:\PW> MOP MOP will now wait for the DECNIS to request a load. When you enter the DEFINE NODE commands, you may see the error message, User command error even if your command is correct. C.3 Moving Profile Files If the DECNIS has any serial lines, it needs to load the Modem Connect profile file. If it has any X.25 lines, it also needs to load the X.25 Level 2 and Level 3 profile files. C.3.1 WHAT YOU NEED TO DO The profile files are installed in the directory: install-directory\COMMON\NISV23 You need to copy them to the directory: C:\pathworks-directory\FCNS where pathworks-directory is the PATHWORKS directory, set by the DECnet environment variable in the STARTNET.BAT file. See Appendix A in the manual PATHWORKS V5 for DOS and Windows Client Installation and Configuration Guide for details. MOP Loading to a DECNIS from a PATHWORKS V5 Load Host C-3 MOP Loading to a DECNIS from a PATHWORKS V5 Load Host C.3.2 PROFILE FILE NAMES The names of the profiles are as follows: __________________________________________________________ File_Name_______Description_______________________________ MCNM_PRF Modem Connect profile X25L2_PR X.25 Level 2 profile X25L3_PR________X.25_Level_3_profile______________________ C.3.3 EXAMPLE You have the following information: Installation directory C:\DECROU DECnet environment C:\PW variable for PATHWORKS directory To copy the Modem Connect profile, you could enter the following command: C:\> Copy DECROU\COMMON\NISV23\MCNM_PRF C:\PW\FCNS C.4 DECNIS Hardware Address The DECNIS has 16 hardware addresses available. It assigns one hardware address to each port on its CSMA/CD and FDDI Network Interface Cards. It uses a standard scheme to do this. When installing from a PATHWORKS load host, you must specify the hardware address of the port that will receive the downline load. C.4.1 FINDING THE PORT HARDWARE ADDRESS The first 11 digits of all port hardware addresses on a DECNIS are the same. The last digit depends on the type of Network Interface Card, its slot number, and the port number on the card. Table C-1 shows how the last digit is assigned. C-4 MOP Loading to a DECNIS from a PATHWORKS V5 Load Host MOP Loading to a DECNIS from a PATHWORKS V5 Load Host Table_C-1_Hardware_Address_Assignment_____________________ Card__Last_Digit__________________________________________ L601 The number of the slot in which the card is inserted L602 Assigned as follows: ____________________________________________________ If_slot_number_is:__3__4__5__6__7__8__9_____________ The last digit for 3 4 5 6 7 8 9 Port 0 is: The last digit for A B C D E F 2 Port_1_is:__________________________________________ F621 DECNIS 600: the higher number of the two slots ______DECNIS_500:_the_lower_number_of_the_two_slots_______ C.4.2 PROCEDURE To find the correct hardware address, follow these steps: 1. Take the first 11 digits from the hardware address on the DECNIS Processor Card label. Ignore the last digit (always zero on the label). 2. Decide which port on which card will be used to receive the downline load. 3. Use Table C-1 to find the correct last digit for the port. Table C-2 Examples of Hardware Address Assignment on a DECNIS __________600___________________________________________________ Address on Processor Card Label______________Card_Slot____PortHardware_Address____________ 08-00-2B-C3-66- L601 5 0 08-00-2B-C3-66-12-55 12-50 08-00-2B-C3-66- L602 5 1 08-00-2B-C3-66-12-5C 12-50 08-00-2B-D4-76- F621 6 and 0 08-00-2B-D4-76-22-87 22-80___________________7_______________________________________ MOP Loading to a DECNIS from a PATHWORKS V5 Load Host C-5 MOP Loading to a DECNIS from a PATHWORKS V5 Load Host C.5 Example In this example, the following information is available: Installation C:\DECROU directory Load client SOUTH1 name DECnet 44.6 address Hardware 08-00-2B-0A-11-33 address Image/CMIP DECROU\CLIENTS\SOUTH1\SYSTEM /profile file Example Commands C:> NCP NCP> DEFINE NODE 44.6 NAME SOUTH1 NCP> DEFINE NODE SOUTH1 HARDWARE-ADDRESS 08-00-2B-0A-11-33 NCP> DEFINE NODE SOUTH1 LOAD-FILE DECROU\CLIENTS\SOUTH1\SYSTEM NCP> DEFINE NODE SOUTH1 DUMP-FILE DECROU\CLIENTS\SOUTH1\DUMP NCP> SET NODE SOUTH1 ALL NCP> EXIT C-6 MOP Loading to a DECNIS from a PATHWORKS V5 Load Host D ________________________________________________________________ MOP Loading to a DECNIS from a PATHWORKS V4.1 Load Host This appendix describes how to set up MOP loading to a DECNIS from a PC running PATHWORKS for DOS, Version 4.1 (PATHWORKS V4.1 PC). ugh you can load to a DECNIS from a PATHWORKS V4.1 PC, you cannot configure the DECNIS software on a PATHWORKS V4.1 PC. o You can only load a combined image/CMIP/profile file from a PATHWORKS V4.1 PC. You cannot load a separate image, CMIP file and profile files. D.1 Procedure Follow these steps: 1. Install and configure the DECNIS software on another load host. The load host can be any of the following: o A PC. Refer to Chapter 2 to Chapter 6. o A DECnet/OSI system. Refer to the manual DECNIS Installation and Configuration for OpenVMS, ULTRIX and DEC OSF/1. o A DECnet-VAX Extensions system. Refer to the manual DECNIS Installation and Configuration for OpenVMS, ULTRIX and DEC OSF/1. In the load-host configurator, you must select Nonvolatile memory for both CMIP and image for the type of loading. 2. In the DECNIS configurator, create a combined image /CMIP/profile file. 3. Copy the combined file to the PATHWORKS V4.1 PC. MOP Loading to a DECNIS from a PATHWORKS V4.1 Load Host D-1 MOP Loading to a DECNIS from a PATHWORKS V4.1 Load Host 4. On the PATHWORKS V4.1 PC, run the program MOPCONF.EXE to enter MOP loading information. 5. A menu of options is displayed. Select Option 2, Add a node. 6. MOPCONF.EXE will now ask for information about the DECNIS. Enter the information shown in the following table: _______________________________________________________ Information______Enter_the_following:__________________ Device type Enter 0, to indicate that you want to enter a device type not in the default list. Then, enter one of the following: NIS500 if loading a DECNIS 500 NIS600 if loading a DECNIS 600 DECnet node DECnet Phase IV node name of the name DECNIS. DECnet node DECnet Phase IV address of the DECNIS. address Ethernet Hardware address of the port on the address DECNIS that will receive the downline load. See Section C.4 for details. Load file name The specification of the image/CMIP /profile file that you copied to the PC. Dump file name The name of the file to receive dumps _________________from_the_DECNIS.______________________ 7. When you have entered all the information, return to the menu of options, and select 5 to exit. 8. Run MOP.EXE. This program functions as a server which waits for load (or dump) requests. When you run MOP.EXE, it displays the message: Waiting for LOAD or DUMP request D-2 MOP Loading to a DECNIS from a PATHWORKS V4.1 Load Host MOP Loading to a DECNIS from a PATHWORKS V4.1 Load Host Refer to the DECnet Network Management Guide in the PATHWORKS for DOS Version 4.1 manual set for full details of MOPCONF.EXE and MOP. MOP Loading to a DECNIS from a PATHWORKS V4.1 Load Host D-3 ________________________________________________________________ Index A Configuration load file, ___________________________ 1-2, B-6 Add a router, 5-2 Configurator AUTOEXEC.BAT, 3-4, 3-6 load-host, 5-1 to 5-7, 10-1 to 10-3 B__________________________ router, 6-16-2 Background mode, 8-2, 8-3, Console 8-5, 8-7 selecting from menu, 4-2 BOOTP using, 12-1 selecting from menu, 4-2 D BOOTP.TAB file, 5-6, B-8 ___________________________ BOOTP/TFTP, 3-1 Data file starting automatically, DECNIS, B-6 8-3 load-host, 5-2, 5-6, B-6 stopping, 8-6 DECdns names, 11-8 BOOTP/TFTP loading, 1-3, DECnet address, 3-3 5-1, 5-4, 5-7, A-2 DECnet node names, 11-2 BOOTP/TFTP server DECnet Phase IV, 3-1 stopping, 8-7 address, 5-4, 9-3, A-2, using, 8-1 to 8-7 C-2, D-2 window, 8-3 to 8-6 node name, 9-3, D-2 DECNIS C__________________________ information, B-1 to B-8 CMIP file, 1-3 Default values, A-1 loading, 5-5 Delete a router, 5-2, 10-1 location, B-6 to 10-2 Combined file. DEPCA driver, 3-5 DEPEA driver, 3-5 See image/CMIP/profile Device type, D-2 file Documentation CONFIG.SYS, 3-6 installed, B-3 to B-4 Index-1 Installation E__________________________ stopping, 2-3 Errors Installation directory, when running C-2 configurators, 5-6, Installation procedure, B-6 2-3 Ethernet address, D-2 Installing, 2-1 to 2-4 See also hardware address Introduction, 1-1 to 1-3 Ethernet drivers, 3-3, 3-4 IP address, 3-3, 5-4, A-2 to 3-6 IP mask, 3-3 EWRK3 driver, 3-5 K ___________________________ F__________________________ Keys Files to display NCL output, created, B-5 to B-7 11-5 loaded, B-7 to B-8 to edit NCL commands, Foreground mode, 8-2, 8-3, 11-4 8-4, 8-5, 8-6 used in Help, 7-2 H L__________________________ ___________________________ LAN hardware address, 5-4, Hardware address, 5-4, A-2 A-2, C-2, D-2 List a router, 5-2 assigning to port, C-4 to Load client name, 2-6, C-6 5-3, A-2 Help Load hosts in configurators, 7-1 to definition, 5-1 7-2 PATHWORKS Version 4.1, keys used, 7-2 D-1 to D-3 leaving, 7-1 PATHWORKS Version 5, C-1 load-host configurator, to C-6 5-6 PC, 1-1 I Load information, 5-3 ___________________________ Load-host configuration Image/CMIP/profile file, information required, A-1 1-3, C-1, D-1, D-2 to A-2 location, B-6 Load-host configurator, Information required 1-2, 5-1 to 5-7 installation, 2-1 options, 5-2 load-host configuration, selecting from menu, 4-2 A-1 to A-2 starting, 5-2 using, 5-3 Index-2 Load-host data file, 5-3, NCL (cont'd) 5-6, B-6 keys used, 11-4, 11-5 saving, 5-6 restrictions, 11-7 to Loading, 9-1 to 9-4 11-9 from nonvolatile memory, selecting from menu, 4-2 5-5 SNAPSHOT command, 11-7 methods, 9-1 using, 11-1 to 11-9 protocols used for, 5-1 NCL script files, 1-2 types of, 5-5 location, B-6 Log file NETSET, 3-2 to 3-3, 3-6 CMIP conversion, B-6 Network Application configurator errors, 5-6, Interface. B-6 See NAI M Node address ___________________________ DECnet, D-2 Menus Node name DECNIS configurator Main DECnet, D-2 Menu, 2-6 Node name of PC, 3-3 load-host configurator Nonvolatile memory loading, Main Menu, 5-2, 5-3 5-5 Modify a router, 5-2, advantages, 5-5 10-1, 10-2 to 10-3 definition, 5-5 MOP loading, 1-3, 5-2 modifying, 10-2 from PATHWORKS V4.1 load updating choice of, B-3 host, D-1 to D-3 NSCTS, 11-8 from PATHWORKS V5 load host, C-1 to C-6 P__________________________ MOP.EXE, D-2 PATHWORKS Version 4.1 MOPCONF.EXE, D-2 load hosts, D-1 to D-3 MS-DOS Kermit stopping, 3-6 using, 12-1 PATHWORKS Version 5, 1-2, 1-3, 3-1 N__________________________ load hosts, C-1 to C-6 NAI, 1-2, 1-3 stopping, 3-7 definition, 3-1 PC loading information, setting up, 3-1 to 3-3 5-3 starting automatically, Phase IV address, 5-4 3-4 Processor card, 5-4 stopping, 3-4 Profile files NCL moving for MOP loading, definition, 1-2 C-3 to C-4 editing commands, 11-4 exiting, 11-7 Index-3 PROTOCOL.INI file, 3-5, STARTNET, 3-3, 3-4 3-6 problems, 3-3 STOPNET R__________________________ to stop NAI, 3-4 RBOOT.BAT, 8-2 to stop PATHWORKS, 3-7 Restore a router, 5-2, Stopping 10-1, 10-3 BOOTP/TFTP server, 8-7 automatic, B-1 NAI, 3-4 Router configurator, 1-2 PATHWORKS V4.1, 3-6 selecting from menu, 4-2 PATHWORKS V5, 3-7 using, 6-1 to 6-2 T Router Management Menu, ___________________________ 4-1 to 4-3, 5-2, 6-1, TCP/IP, 3-1 8-2, 8-3, 11-1 TFTP, 5-1, 5-4 Type of loading, 5-5 S__________________________ U SNAPSHOT command, 11-7 ___________________________ Starting Update a DECNIS load-host configurator, automatic, B-1 to B-3 5-2 Update a router, 5-3, network, 3-3 10-1, 10-3 router configurator, 6-1 Index-4