[Top] [Prev] [Next] [Bottom]

Configuring the System

This document describes the configuration process and includes the following sections:

What is CONFIG?

Using Quick Config

Using Config-only

Configuring User Access

Using CONFIG

CONFIG Commands

What is CONFIG?

The Configuration process (CONFIG) lets you configure router parameters for

CONFIG lets you display or change the configuration stored in the router's non-volatile configuration memory. The router keeps changes you make through CONFIG in a database in non-volatile memory, retains them during power downs, and recalls them when you restart the router. Changes do not take effect until you re-initialize the router. You can re-initialize the router by

CONFIG fits into the router software structure as shown in Figure 1.

Figure 1 CONFIG in the Router Software Structure

The CONFIG process (Config> prompt) is made up of lower-level processes. Each lower-level process has its own prompt.

If you want to know where you are, press enter to display the prompt. Some commands, event, network, and protocol, allow you to access the various lower-level processes in CONFIG.

Using Quick Config

Quick Configuration (Quick Config) is part of the Command Line Interface and is a question and answer script that allows you to configure basic information without having to enter and exit the different configuration processes.

Whatever parameters or options you cannot configure with Quick Config you can configure using the Command Line Interface's configuration processes after exiting Quick Config.

You cannot delete Quick Config information from within Quick Config; but you can correct it by exiting and returning to Quick Config or by typing r for restart as a response to a Quick Config question.

Entering the Quick Config Mode

If you are configuring your router for the first time and you are using the Command Line Interface, the router enters Quick Config automatically the first time you boot it.

To run Quick Config after you have initially configured your router, follow these steps:

1. At the * prompt, enter config to display the Config> prompt. 

* config

Config>
2. Enter qc at the Config> prompt to begin Quick Config.

Exiting Quick Config

 To exit Quick Config, enter r for restart at any prompt and follow the queries until you enter no and then q for quit. Then your router returns to the Config (only)> prompt or the Config> prompt.

Using Config-only

Configuration only (Config-only) mode is provided only for getting a subset of configuration commands when a configuration problem causes the router to crash during startup or to display panic, check, fatal, or bughlt (bughalt) messages. Do not use Config-only for general router configuration. Not all commands execute exactly as they do in CONFIG mode.

Note: This mode is a feature of larger Nx Networks routers. If you enter this mode, enter restart yes at the Config only> prompt to resume normal router operation.

Configuring User Access

The router configuration allows up to 50 user names, with their passwords, and levels of permission. Each user you add needs to have a password and level of permission. There are three levels of permission, Administration, Operation, and Monitoring.

For more information, see add user.

Technical Support Access

When you add a new user for the first time, the router asks if you want to add technical support access. Technical support access has the same privileges as administrator access. It permits a customer service representative to operate at the Administration level.

The software automatically sets the password for technical support access and customer service knows the password. You can change this password using the change user command. If you do this, customer service is not able to help you remotely. For more information, see the Change command.

Using CONFIG

The following sections provide information on entering and exiting CONFIG and using the system-level configuration commands.

Entering and Exiting CONFIG

To enter CONFIG from the * prompt, enter config.

* config 
Config>
The Config> prompt appears. If the prompt does not appear, press Enter again. You can now enter CONFIG commands.

To exit CONFIG and return to the * prompt, enter the intercept character (the default is Ctrl P).

Restarting the Router

Some changes to the router's parameters made while in OPCON take effect immediately without requiring re-initializing of the router. If the changes do not take effect, restart the router by entering restart at the * prompt.

* restart
Are you sure you want to restart the router? (Yes or No): yes

CONFIG Commands

This section describes each CONFIG command. The following table summarizes the CONFIG commands. Press Space twice after you type a command to display the available parameters for each command for your router. Enter help for information about using the command line interface.

Table 1 CONFIG Commands
Command Function
Add Adds a device, an interface, a stack, or a user to the router configuration.

Authentication Enters a sub-menu process (Auth Config>) for configuring authentication parameters.

Boot Enters a sub-menu process (Boot Config>) for configuring Boot parameters.

Change Changes the current router configuration for a device, an interface, a password, a stack, or a user.

Clear Clears configuration information.

Delete Deletes a device, an interface, a stack, a user, or utilization information from the router configuration.

Disable Disables a device, an interface, or other system options.

Enable Enables a device, an interface, or other system options.

Event Enters the Event Logging System configuration process
(ELS config>).

Feature Provides access to configuration commands for independent router features outside the usual protocol and network interface configuration processes.

HTTP Enters the HTTP configuration process.

List Displays the router's system parameters, devices, interfaces, services, stacks, users, or utilization information.

Network Enters a sub-menu process (such as, ETH config>) for configuring the parameters of a particular interface.

Patch Modifies the router's global configuration.

Protocol Enters the command environment of the specified protocol.

Qconfig Initiates the Quick Config process.

Set Sets system-wide parameters for buffers, hostname, inactivity timer, logging disposition and level, packet size, restart count, utilization, the router's location, and a contact-person.

Time Sets up system time and displays it.

Unpatch Restores variables of the patches to default values.

Update Updates the configuration.

Voice Enters the voice configuration process.

Add

Adds a device, an interface, a stack, and user access to the router.

Syntax: add

device
interface
stack
user

device

 Adds a new device to your router.

Note: This command is not available on all router platforms. It is only available on those routers that have expansion slots, such as the GlobeTrotter Access Manager (GTAM).

Syntax: add device device type slot number device name

 Example: add device quad-serial

Device Slot # (0-4) [2]? 1
Device Name [SL1-2]?
Adding device SL1-2 as interface 7
Defaulting Data-link protocol to PPP
The router must be restarted before the new device can be used.

interface frame-relay or null or ppp

 Adds an interface (a logical packet data path) to your router and defines the data-link protocol for the new interface.

Since OpenROUTE automatically installs an interface for each physical device, the only type of interface that you can add is one that provides a dial or virtual circuit.

Enter list interfaces to see a list of interfaces on the router.

Example: add interface ppp

Adding interface 4 linked to base device WAN.

stack

 Adds a protocol stack to your router. See the Using Protocol Stacks documentation.

Syntax: add stack stack name stack service-list

Example: add stack

Stack Name? invmux
Stack Service-List? int1:ppp:(sl:wan1)&(sl:wan2)
The protocol stack can refer to interfaces (such as int1 in this example) that do not yet exist. Your router automatically creates these interfaces the next time you restart it.

user

Adds a user access to the router. To add a user, you must have administrative permission. When you add the first user, the router automatically enables console login. When you first configure user access, you must restart the router.

If you have the GTSecure Login utility, you can set up a user account so that the router requires a challenge handshake before a user can access the router operating system. The challenge handshake uses a secret based on the RSA Data Security, Inc. MD5 Message-Digest Algorithm. The secret is never sent over the LAN or WAN.

You can add up to 50 users. Assign each user one of the permission levels in the following table.

Table 2 Access Privileges
Level of Access Access Functionality
Administrator (A) Can access any router function. Displays configuration and user information, adds/modifies/deletes configuration and user information.

Operator (O) Cannot modify the permanent router configuration. Views router configuration and statistics, runs potentially disruptive tests, dynamically changes router operation, and restarts the router. All operator actions are undone with a system restart.

Monitor (M) Cannot modify or disrupt the operation of the router. Views router configuration and statistics.

Tech Support Allows a Technical Support engineer to gain access to the router if a user forgets a password. Cannot be assigned to users.

Example: add user 

Enter user name: ? irene
Enter authentication type: (N)one, (P)assword, (C)hallenge, or (Q)uit  [P]? p
Enter password:
Enter password again:
Enter permission: (A)dmin, (O)perations, (M)onitor, or (Q)uit  [A]? a
User 'irene' has been added
Do you want to add Technical Support access? (Y)es, (N)o, or (Q)uit [Y]? y
Enter authentication type: (N)one, (P)assword, (C)hallenge, or (Q)uit  [P]? n
Technical Support access has been added
Enter user name

 The name that identifies the user. Each user name is eight characters and is case-sensitive. You may enter more than eight characters but the router only retains eight.

Enter authentication type

 The type of authentication for the user:
N (None), P (Password), or C (Challenge).

Note: You can respond to the authentication type of Challenge only if you have the GTSecure Login utility. If you add only one user with an authentication type of Challenge, you cannot access the router configuration unless you have the GTSecure Login utility.

Password

 If the authentication type is Password, prompts for the user's password. The password is limited to 80 characters and is case-sensitive.

Enter password again

 If the authentication type is Password, confirms the password for the user.

Enter MD5 secret

 If the authentication type is Challenge, prompts for the MD5 secret for the user.

Enter MD5 secret again

 If the authentication type is Challenge, confirms the MD5 secret.

Enter permission

 Specifies the access permission for the user: A, O, or M. (See Table 2.)

Do you want to add Technical Support access?

 See Table 2.

Authentication

Displays the Auth Config> prompt, where you can configure authentication parameters in the Remote Authentication Dial-In User Service (RADIUS) environment.

RADIUS is a security system that uses a client-server approach to authenticate remote users. RADIUS authenticates users through a series of challenges and responses that the client relays between the server and the user.

See the GTSecure RADIUS Authentication Guide available on the Nx Networks Web Site at www.nxnetworks.com for information about RADIUS.

Syntax: authentication

Example: authentication

Auth Config>
  Commands to permanently configure authentication parameters.
  All operations are saved, but do not take effect until a
  reboot or entry of the 'revert' command in GwCon.

The choices/prefixes are (a complete list):

 add                 -- Add a RADIUS server.
 delete  (disabled)  -- Delete a RADIUS server.
 set     (disabled)  -- Set authentication parameters.
 enable  (disabled)  -- Enable router authentication features.
 disable (disabled)  -- Disable router authentication features.
 list                -- List authentication parameters.
 exit                -- Exit authentication configuration.

Boot

 Enters the Boot CONFIG (Boot Config>) command menu. For Boot CONFIG information, see What is Boot CONFIG?.

Syntax: boot

Example: boot

TFTP Boot/dump configuration
Boot config>

Change

 Changes device, interface, password, stack, or user information.

Syntax: change

device
interface
password
stack
user

device

 Changes the configuration for an existing device on your router.

Note: This command is not available on all router platforms.

Syntax: change device device type old name new slot number
new name

 Example: change device token-ring

Device Name? Servers
Device Slot # (0-4)  [2]? 3


New Device Name [Servers]? Clients
Changing device Servers to Clients

interface ppp or null

Changes the type of an interface you added previously.

Example: change interface ppp

Interface number [0]? 4
Restart the router, and then use the "network 4"
command to configure interface parameters.
Example: change interface null

Interface number [0]? 3

password

Changes your password. To change a user password, you must have administrative permission.

Example: change password

Enter current password:
Enter new password:
Enter new password again:
Enter current password

 Your current password.

Enter new password

 Your new password.

Enter new password again

 Your new password again for confirmation. If your confirmation does not match the previous new password, the old password remains in effect.

stack

Changes a protocol stack definition. See the Using Protocol Stacks document.

Syntax: change stack stack name stack service-list

Example: change stack

Stack Name? invmux
Stack Service List? [int1:ppp:(sl:wan1)&(sl:wan2)]?int1:ppp:(sl:wan3)&(sl:wan4)
This new definition for protocol stack invmux changes the devices used from wan1 and wan2 to wan3 and wan4.

You can use the change stack command to modify the configuration of a stack that you created manually or the router created automatically. OpenROUTE software first searches memory for the stack specified by you and modifies any definition found there. If OpenROUTE does not find a user-defined definition for this stack in memory, then it searches the list of stacks that the router created automatically. If it finds a match, you can modify that stack definition, and OpenROUTEs writes that modified stack definition to memory as a user-defined stack. This allows you to modify a stack that the router created and save it as if you created it originally.

user

Modifies any user information configured with add user. To change a user, you must have administrative permission.

Example: change user

Enter user name:  []? rjones
Change password? (Yes or [No]): yes
Password: 
Enter password again: 
Change permission? (Yes or [No]): yes
Enter permission: (A)dmin, (O)perations, or (M)onitor  [A]? a

Clear

 Deletes the router's configuration from the non-volatile configuration memory.

To clear a protocol from memory, enter clear and the protocol name. To clear all information, except device information, enter clear all. To clear all information including the device information, use the clear all and then clear device commands.

The clear netbios command clears the NETBIOS cache and filtering configuration that is accessible under bridging.

The clear user command clears all user information except the router console login information. This is left as enabled (if configured as such) even though the default is disabled. To clear user information, you need administrative permission.

The clear utilization command deletes all utilization information for all interfaces.

CAUTION:
Use this command only after calling your
Customer Service representative.

Syntax: clear

all protocol info
ap2 protocol info
apl protocol info
arp protocol info
bgp protocol info
boot information
bri protocol info
bridge protocol info
brly protocol info
bspf protocol info
dls protocol info
dds protocol info
device information
dn protocol info
dvmrp protocol info
els information
fr protocol info
ip protocol info
ipx protocol info
lnm protocol info
netbios cache info
osi protocol info
ospf protocol info
ppp protocol info
sdlc protocol info
slc protocol info
snmp protocol info
srb protocol info
srly protocol info
stack info
stb protocol info
tcp/ip-host protocol info
time of day info
user info
utilization info
vines protocol info
wrr info
xns protocol info
xtp protocol info
x25 protocol info
Example: clear all

You are about to clear all non Device configuration information
Are you sure you want to do this (Yes or [No]):
Example: clear stack

You are about to clear all Stack configuration information
Are you sure you want to do this (Yes or [No]):
Note: The default response is no.

Delete

 Removes a device, an interface, a stack, a user, or utilization information from the router configuration. To use this command, you must have administrative permission.

Syntax: delete

device
interface
stack
user
utilization

device

 Deletes a device. You can delete a physical device that you added to the configuration of a modular router.

Note: This command is not available on all router platforms.

Syntax: delete device device name

 Example: delete device

Device Name? clients

interface interface#

 Deletes an interface. To display the interface's number, enter list interfaces.

Example: delete interface 1

Are you sure you want to delete this interface?(Y / N)

stack

 Deletes a protocol stack from the router's memory.

Syntax: delete stack stack name

Example: delete stack

Stack Name? invmux
This command has no effect on protocol stacks of this name that are already present in the running router. The deletion does not take effect until you restart the router.

user user_name

Removes the specified user.

Example: delete user 

Enter user name:  []? mary
Delete 'mary'? (Yes or [No]): y
User 'mary' has been deleted

utilization

 Deletes the configuration parameters created by the set utilization command for the specified interface.

Example: delete utilization

Interface Number [0]?

Disable

 Prevents login prompts when you log in remotely and disables command-completion, a device, the serial interface dialer, an interface, LAN emulation, local console, modem control, or PPP over a Frame Relay Virtual Circuit (FRVC).

Syntax: disable

command-completion
console-login
device
dial
interface
lan-emulation
local console
modem-control
ppp-over-frvc

command-completion

 Turns the command-completion feature of the Command Line Interface off. When you type a unique part of the command and press Space, the software no longer automatically finishes the command.

Example: disable command-completion

console-login

Prevents prompts for user name and password. The default is disable. By disabling the console login, you prevent a lock out situation.

Example: disable console-login

device

Disables a selected physical device. A disabled physical device does not pass packets for any of its client interfaces. For example, if interfaces 1 and 2 share device 1, when device 1 is disabled, interfaces 1 and 2 are both inactive.

Note: Unlike WAN interfaces, there is a fixed one-to-one mapping between LAN devices and interfaces such as the Ethernet. Disable interface and disable device are synonymous on LAN devices.

Example: disable device

Device Name? TKR1-0

dial

 Disables the Serial Interface Dialer (DIAL) on the selected device.

Example: disable dial

Device name? wan2-0

interface interface#

 Disables an interface. Packets are not forwarded to disabled interfaces.

Example: disable interface

Interface number [1]? 1

lan-emulation

 Disables LAN emulation on the selected Frame Relay interface.

Example: disable lan-emulation

Interface Number [0]? 4

local-console

 For security reasons, you may not want to allow local access to a router's console port. There are new commands that let you enable and disable this local access.

If you disable local access, you can still configure and monitor the router remotely by running Telnet or QuickWeb to one of the router's interfaces.

Syntax: disable local-console

Example: disable local-console

This will disable local access via the console on a restart.
Access to the router will only be via telnet.
Do you really want to do this? (Yes, No): yes

modem-control

Disables monitoring of modem-control lines on the terminal. The default is disable.

Example: disable modem-control

ppp-over-frvc

Disables the feature that lets you send PPP data over a Frame Relay Virtual Circuit (FRVC).

Note: If you disable PPP over FRVC on this router, make sure it is also disabled on the router at the other end of the FRVC.

Example: disable ppp-over-frvc

Interface Number [0]? 2

Enable

 Permits login from a remote terminal and enables command-completion, a device, the Serial Interface Dialer, an interface, LAN emulation, local console, modem control, or PPP over FRVC (Frame Relay Virtual Circuit).

Syntax: enable

command-completion
console-login
device
dial
interface
lan-emulation
local-console
modem-control
ppp-over-frvc

command-completion

 Turns on the command-completion feature of the Command Line Interface. When you type a unique part of the command and press Space, the software automatically finishes the command.

Example: enable command-completion

console-login

Enables prompts for login of user name and password. This is useful for security situations. There must be at least one administrative user defined on the system for this command to work.

Example: enable console-login

device

Enables a device.

Note: After a restart, each interface that shares the device can forward packets unless the interface itself is disabled.

Syntax: enable device device name

 Example: enable device

Device Name? TKR1-0

dial

 Enables the Serial Interface Dialer (DIAL) on a selected device.

Syntax: enable dial device name

Example: enable dial

Device name? wan2-0

interface interface#

 Enables the interface after restart. If an interface is enabled, it is visible to the forwarders (such as IP).

Example: enable interface

Interface number [0]? 2
The dial circuit interface number 2 is now enabled.

lan-emulation

Enables Frame Relay LAN emulation on the selected device.

Syntax: enable lan-emulation interface #

Example: enable lan-emulation

Interface Number [0]? 4

enable local-console

 If local console is enabled, you can configure and monitor the router locally through its console port. By default, the local console is enabled.

Syntax: enable local-console

modem-control

 Sets up the router for login through a modem. Enter list config to see the status of modem control. Before using this command, do the following:

Example: enable modem-control

The router automatically hangs up the modem when you log out. Also, if your modem becomes disconnected from the router while you are using it, the router logs you out.

ppp-over-frvc

Allows you to run PPP over a Frame Relay Virtual Circuit (FRVC). By also turning on PPP data compression, you can compress data that the router sends over Frame Relay.

Note: If you enable PPP over FRVC on this router, make sure it is also enabled on the router at the other end of the FRVC.

Example: enable ppp-over-frvc

Interface Number [0]? 2

Event

 Puts you in the Event Logging System (ELS) where you can define what messages are to appear on the screen. See Using the Event Logging System. To return to the Config> prompt, enter exit.

Syntax: event

Example: event

Event Logging System user configuration
ELS config>

Feature

 Takes you to a prompt that lets you configure router features. Press Space twice after entering feature to get a list of the features available for your software release. Table 3 lists the numbers and names for features. 

Config>feature
The choices/prefixes are (a complete list):
 WRR
 MCF

Table 3 Features
Feature
Number 		Feature
Name 		Accesses
the Feature
0

 WRR

 Using WAN Reroute

2

 MCF

 Using MAC Filtering

Syntax: feature feature# or feature-name

Example: feature wrr

WAN Reroute user configuration
WRR Config>
Once you access the prompt for a feature, you can enter commands to configure that feature.

To return to the Config> prompt, enter exit at the feature's prompt.

HTTP

Takes you to the HTTP configuration prompt.

Syntax: http

Example: http

Http Config>
To return to the Config> prompt, enter exit at the Http Config> prompt.

List

Displays configuration information for all network interfaces or for the router.

Syntax: list

configuration
devices
interfaces
patches
services
stacks
users
utilization

configuration

 Displays configuration information about the router.

Example: list configuration

Hostname: westbranch
Hostname as part of prompt: enabled
Maximum packet size: [autoconfigured]
Maximum number of global buffers: [autoconfigured]
Number of Restarts before a Reload/Dump: 64
Logging disposition: detached
Console baudrate:  9600
Console inactivity timer (minutes): 0
Physical console login: disabled
Command completion: enabled
Modem Control: Disabled
Remote and Local Console Allowed
Contact person for this node: [none]
Location of this node:

Configurable Protocols:
Num Name  Protocol
0   IP    DOD-IP
3   ARP   Address Resolution
9   DVM   Distance Vector Multicast Routing Protocol
10  BGP   Border Gateway ProtocolV
11  SNMP  Simple Network Management Protocol
12  OSPF  Open SPF-Based Routing Protocol
27  XTP   X.25 Transport ProtocolV

Configurable Features:
Num Name  Feature
0   WRR   WAN ReRouteV

35260 bytes of configuration memory free

devices

 Displays the list of devices configured in the router.

Example: list devices

ETH0-0       slot 0  port 0     Ethernet/802.3
TKR1-0       slot 1  port 0     ProNET-4
TKR1-1       slot 1  port 1     ProNET-4
WAN2-0       slot 2  port 0     Quad Serial Line
WAN2-1       slot 2  port 1     Quad Serial Line
WAN2-2       slot 2  port 2     Quad Serial Line
WAN2-3       slot 2  port 3     Quad Serial Line

interfaces

 Displays a list of the interfaces configured in the router.

Example: list interfaces

Ifc   0, Ethernet/IEEE 802.3 (via device ETH0-0)
Ifc   1, Token-Ring/802.5 (via device TKR1-0)
Ifc   2, Token-Ring/802.5 (via device TKR1-1)
Ifc   3, Point to Point (via device WAN2-0, with Dialer)
Ifc   4, Frame Relay (via device WAN2-1)
Ifc   5, Point to Point (via device WAN2-3)
This display shows an Ethernet interface, two Token Ring interfaces, a dial circuit interface, a Frame Relay interface, and a PPP interface. By default, each interface uses the device of the same number.

patches

Displays the patches and their variables added with the patch command.

Example: list patches

Patched variable							Value

ping-size							60
ping-ttl							59
ip-default-ttl							60
ethernet-security							3
rip-static-suppress							3

services

 Displays all of the services available on your router.

Example: list services

Service         Description
-------         -----------
DIAL            Dial Serial Interface
FRLANE          Frame Relay LAN Emulation
FRMGR           Frame Relay Manager
FRVC            Frame Relay Virtual Circuit
HSSI            High-Speed Serial Interface
INT3            Interface 3
INT4            Interface 4
INT5            Interface 5
INT6            Interface 6
PPP             Point-to-Point Protocol
SL              Serial Line

stacks

 Displays all of the protocol stacks in the router, whether created manually or automatically.

Example: list stacks

Stack           Creator  State    ID  Service List
-----           -------  -----    --  ------------
BASE-3          Router   Open      3  SL:SL2-0
FRAME-3         Router   Closed    3  FRMGR:BASE-3
invmux          User     Closed  128  int1:ppp:(sl:wan1)&(sl:wan2)
NET-3           Router   Closed    3  INT3:FRVC:FRAME-3
NET-4           Router   Open      4  INT4:PPP:BASE-3

users

Displays the users and their permissions.

Example: list users

USER       PERMISSION

joe        operations
mary       administrative
peter      monitor

utilization

 Displays utilization information for all interfaces on which it is set.

Example: list utilization

                     Transmit       Receive
Interface  Interval  Utilization %  Utilization %  Traps
---------  --------  -------------  -------------  -----
        0        60            100            100      1

Network

 Puts you at the prompt for the specified network interface configuration.

To get the interface number, at the Config> prompt, enter list interfaces.

Syntax: network network #

Example: network

What is the network number [0]?
Ethernet interface configuration

ETH config>
Note: Not all network interfaces are user-configurable. For interfaces that you cannot configure, you receive the message That network is not configurable.

Patch

Changes the router's global configuration. Takes effect immediately; you do not have to wait for the next restart of the router. Use this command only for handling uncommon configurations. Use the specific configuration commands for anything that you commonly configure. You must specify the complete name of the patch that you want to change. You cannot use an abbreviated syntax for the patch name.

The patches documented and supported for your current release.

Syntax: patch

ethernet-security
rip-static-suppress
ping-size
ping-ttl
ip-default-ttl
more-lines
bgp-subnets
rip-extensions
Example: patch

Variable to patch []? ping-size
New value [0]?
Variable to patch

 Specify the complete name of the patch that you want to change. You cannot use an abbreviated syntax for the patch name.

New value

 The new value for the variable that you are patching.

ethernet-security new value

When set to a nonzero value, zeros the padding that is applied to Ethernet packets whose data portion is less than the physical minimum of 60 bytes. This may be required for security reasons. Default: 0.

Example: patch ethernet-security

New value [0]? 30

rip-static-suppress new value

 When set to a nonzero value, RIP does not advertise static routes out of a given interface unless you give the IP config> enable send static command for the interface. This changes the semantics of the enable send static command. When rip-static-suppress is equal to 0 (the default), the list of the routes that RIP advertises is the union of those that the interface's RIP flags specify.

Example: patch rip-static-suppress

New value [0]?

ping-size new value

 The size of the data portion (excluding IP and ICMP headers) of the ICMP ping packet sent via the IP>ping command. Default is 56 bytes.

Example: patch ping-size 

New value [0]?

ping-ttl new value

 The TTL (time-to-live) sent in pings by the IP>ping command. Default is 60.

Example: patch ping-ttl

New value [0]?

ip-default-ttl new value

 The TTL used in packets that are originated by the router itself. Default is 60.

Example: patch ip-default-ttl

New value [0]?

more-lines new value

 The number of lines to display on the screen when listing the IP routing table that uses a more pipe. The default is 24. Setting the value to 0 disables more-lines.

Example: patch more-lines

New value [0]?

bgp-subnets new value

If you want the BGP speaker to advertise subnet routes to its neighbors, set the bgp-subnets to 1. The default is 0.

Example: patch bgp-subnets

New value [0]?

rip-extensions new value

Allows RIP to send subnet route updates over unnumbered IP interfaces.

Example: patch rip-extensions

New value [0]?

Protocol

 Puts you in the configuration environment for the protocol software installed in your router. The protocol command followed by the desired protocol number or name lets you enter a protocol's command environment. Table 4 lists the protocol numbers and names. After you enter this command, the prompt of the specified protocol appears.

From the prompt, you can enter commands for the specified protocol.

Table 4 Protocol Names and Numbers

Protocol
Number 		Protocol
Name 		Accesses the Following Protocol Prompt
0

 IP

 IP Config> for IP (Internet Protocol) configuration

3

 ARP

 ARP Config> for ARP (Address Resolution Protocol) configuration

7

 IPX

 IPX Config> IPX (Novell NetWare Internetwork Packet Exchange) configuration

9

 DVMRP

 DVMRP Config> for DVMRP (Distance Vector Multicast Routing Protocol) configuration

10

 BGP

 BGP Config> for BGP (Border Gateway Protocol) configuration

11

 SNMP

 SNMP Config> for SNMP (Simple Network Management Protocol) configuration

12

 OSPF

 OSPF Config> for OSPF (Open Shortest Path First) configuration

22

 AP2

 AP2 config> for AppleTalk Phase 2 configuration

23

 BRIDGE

 Bridge Config> for Transparent Bridge configuration

24

 HST

 TCP/IP Host config> for TCP/IP Host Services configuration

27

 XTP

 XTP config> for X.25 Transport Protocol configuration

To go to a protocol configuration prompt,

1. Enter protocol ? to see a list of the protocols configured on your router. 

IP
ARP
SNMP
Protocol name or number [IP]?
2. Enter the desired protocol name or number. The prompt of the specified protocol appears. From the prompt, you can enter the protocol specific commands. 

Protocol name or number [IP]? ip
Internet protocol user configuration
IP config>
To return to the Config> prompt, enter exit 

IP Config>exit
Config>
Syntax: protocol protocol# or protocol name

 Example: protocol snmp 

SNMP user configuration
SNMP config>

Qconfig

 Starts Quick Config, which lets you configure parameters for certain interfaces, bridging protocols, routing protocols, and boot records without entering separate configuration environments.

Syntax: qconfig

Example: qconfig

Set

Configures various system-wide parameters.

Syntax: set

baudrate
contact-person
data-link
down-notify
global-buffers
hostname
inactivity-timer
input-low-water
location
logging disposition
logging level
packet-size
receive-buffers
restart-count
utilization

baudrate

Sets the router's speed for the console.

Example: set baudrate

Console baudrate (0 = Autobaud)  [0]?

contact-person sysContact

 Sets the name or identification of the contact person for this managed SNMP node. There is a limit of 80 characters for the sysContact name length. This is for information only and does not affect or change router operation. It is useful for SNMP management identification of the system.

Example: set contact-person 

Contact person for this node [Jane Marshall]? Paul Jones

data-link type interface#

 Selects the data-link type for a serial interface. Interface# is the number of the interface you are configuring. To get the interface number enter list interfaces.

Example: set data-link ppp

Interface Number [0]? 2

down-notify interface# # of seconds

Allows you to specify the number of seconds the router waits before declaring that an interface is down. The default maintenance packet interval is 3 seconds and it takes 4 maintenance failures to declare that the interface is down.

Note: If you use set down-notify on one end of a serial link, use it at the other end of the link too, or the link may not come up and stay up.

The list interfaces command shows any changed value for the down notification time, if it has been changed from the default.

Example: set down-notify 

Interface number [0]? 4
Down notification time (1 to 300, 0 to restore default ) [0]? 3
Interface#

The number of the interface you are configuring.

# of seconds

 The maximum time to elapse before a down interface is noted. Large values cause the router to ignore transient connection problems. Smaller values cause the router to react more quickly. The range of values is 1 to 300 seconds and the default is 0, which sets a 3-second period. Setting the down notification time to 0 restores the default time for that interface.

global-buffers max#

Sets the maximum number of global packet buffers, which are the packet buffers used for packets originating locally. The default is to autoconfigure for the maximum number of buffers (up to 1000). To restore the default, set the value to 0.

Example: set global-buffers

What is the maximum number of global packet buffers [0]? 30
To display the setting for global-buffers, enter list configuration.

hostname

Sets the local router's name. The local router uses this name when it is authenticated by a remote router. It also uses the name to find the local ISDN telephone number that the telephone company assigns.

You have the option of setting up your router to display the router's hostname as part of the CLI prompts. To do so, enter the set hostname command and answer yes when prompted on whether you want the hostname as part of the prompt. The name you assigned appears in front of all router prompts.

Example: set hostname

What is the new host name [ ]? Westbranch
Do you want hostname as part of the prompt?(Yes or [No]):[no]? yes
Westbranch Config>

inactivity-timer # of min

 Changes the setting of the inactivity timer. The inactivity timer logs out a user if the remote or physical console is inactive for the period of time specified in this command. This command affects only terminals that require login. The default setting of 0 turns off the inactivity timer.

Example: set inactivity-timer 

Console inactivity timer in minutes [0]? 3

input-low-water interface# low # of receive buffers

Allows you to set the value of the low number of receive buffers or packets on a per-interface basis.

The memory allocation strategy changes to conserve buffers when the number of free buffers is equal to or less than the low or low-water-mark value. When a packet is received, and the current value of the interface is less than the low water value, then that packet is eligible for flow control (dropping).

The range of values and the default is both platform- and device-specific. Setting the value to 0 restores the auto-configured default

Lowering the value makes it less likely that packets from this interface are dropped when sent on congested networks. It can affect performance negatively, if it drops packets to the extent that the receive queue is frequently empty. Raising the value has the opposite effect.

To show the low setting, enter queue or buffer at the Monitor> prompt.

Example: set input-low-water

Interface Number [0]?
Receive low water (1-50, 0 to restore default) [0]?
.
Interface Number

The number of the interface you are configuring.

Receive low water

 The low water value.

location sysLocation

The physical location of an SNMP node. There is a limit of 80 characters for the sysLocation name length. Location is for information only and does not affect or change router operation. It is useful for SNMP management identification of the system.

Example: set location 

Location of this node [Test Lab]? atlantis

logging disposition setting

 Changes default settings for logging disposition in the MONITR process.

The logging disposition settings do the following:

console

Writes to the console (equivalent to the OPCON divert 2 0 command).

detached

 Holds the data and does not print it (equivalent to the OPCON halt 2 command).

flush

 Discards the data (equivalent to the OPCON flush 2 command).

If you have a printing terminal attached to the router's console port, you can get a hard copy of the startup messages by setting the logging disposition to console and restarting the router.

Example: set logging disposition console

logging level #

Controls the output of messages not yet converted to the ELS. Takes effect when you restart the router. The default logging level is 76. Set logging level to 0 for no logging level.

Example: set logging level 76

packet-size max packet size in bytes

The maximum size of a packet.

CAUTION:
Use this command only under direct instructions from your Customer Service representative. Use it only to increase packet size.

Example: set packet-size

What is the maximum packet size (in bytes) [0]?

receive-buffers interface# max#

Adjusts the number of private receive buffers for most interfaces. The range is 5 to 255. On some devices, the maximum value is restricted further. To restore the default, set the value to 0.

Use set receive-buffers to increase the receive performance of an interface and to reduce flow control drops when the router is forwarding many packets from a fast interface to a slow interface. To see the maximum numbers, enter list buffer at the Monitor> prompt.

*monitor
Monitor>list buffer
CAUTION:
Use this command only under direct instructions from your Customer Service representative.

Example: set receive-buffers

Interface number [0]?  
Receive buffers (5-255, 0 to restore default) [0]? 20

restart-count

 The number of times a router restarts on a serious error before dumping (if enabled) and reloading. In general, the restart-count should remain unchanged. The default is 64.

Example: set restart-count

How many times should the gateway restart before reloading [64]?

utilization

 Sets utilization for a selected interface. Generates ELS messages and SNMP traps when utilization reaches or exceeds a configurable level for a configurable period of time. Dynamically calculates the speed of all serial line interfaces (except HSSI and ISDN).

Example: set utilization

Interface Number [0]?
Measurement interval [60]?
Percentage of transmit utilization [100]?
Percentage of receive utilization [100]?
Number of traps [1]?
Measurement interval

 Range is 1-65535 seconds.

Percentage of utilization

 Range is 0-100. 0 means that an ELS message and SNMP trap is generated at the end of each interval.

Number of traps

 Range is 0-10. If the number of SNMP traps is greater than 0, each trap has the same sequence number to mark it as a duplicate.

Time

Sets the router system clock and date and displays them. You can use the clock and date to timestamp ELS messages.

Syntax: time

host
list
offset
set
sync

host IP_address

 The IP address of the RFC 868-compliant host to use as the time source. This host then responds to an empty datagram on UDP port 37 with a datagram containing the current time.

Example: time host 131.210.4.1

list

Displays the current time (if set) and the source of the time "operator" or IP address which last sent the time.

Example: time list 

05:20:27  Wednesday April 7, 1997

Set by: operator

Time Host:  131.210.4.1        Sync Interval: 10 seconds
GMT Offset:  -300 minutes

offset minutes

 Defines the time zone, in minutes, as an offset from Greenwich Mean Time (GMT). Values west of GMT are negative. For example, EST is 5 hours earlier than GMT, so the command would be time offset -300.

Example: time offset 

minutes from GMT (-720 to 720) [0]? -300

set year month date hour minute second

 Sets the current time.

Example: time set 

year [1995]? 1996
month [12]? 
date [6]? 7
hour [11]? 12
minute [3]? 
second [2]?

sync seconds

 Sets the period, in seconds, at which the router polls the time host for the current time.

Example: time sync 

seconds between time syncs [0]? 300

Unpatch

 Restores the variables of patches, implemented with patch, to their defaults. See Patch.

Note: You must specify the complete name of the patch that you want to change. You cannot use an abbreviated syntax for the patch name.

Syntax: unpatch variable name

 Example: unpatch ethernet-security

Update

Updates the configuration memory when you receive a new software load. Follow the instructions on the release notice sent with the software. Update is the last command that you type when loading new software. The screen displays a message indicating configuration memory is being updated.

Syntax: update version-of-SRAM

Example: update version-of-SRAM

to Netrix Corp. GTX-SECA 5.2.0

Voice

 Takes you to the Voice configuration prompt.

Syntax: voice

Example: voice

VOICE Config>
To return to the Config> prompt, enter exit at the VOICE Config> prompt.


[Top] [Prev] [Next] [Bottom]

Copyright © 2001, Nx Networks, Inc. All rights reserved.