NEC SOPHO IP 5000, SOPHO IP 6000 Command Reference Manual

Download

Page 1

SOPHO IP 5000/SOPHO IP6000

SOPHO IP 5000 SOPHO IP 6000

Command Reference Guide

Page 2

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 2

SOPHO IP 6000

http://www.nec-philips.com/

NEC-PHILIPS Corporation

Copyright © 2004, NEC-PHILIPS Corporation. All rights reserved. No part of this documentation may be reproduced in any form or by any means or used to make any derivative work (such as translation, transformation, or adaptation) without written permission from NEC-PHILIPS Corporation.

NEC-PHILIPS Corporation reserves the right to revise this documentation and to make changes in content from time to time without obligation on the part of NEC-PHILIPS Corporation to provide notification of such revision or change.

NEC-PHILIPS Corporation provides this documentation without warranty, term, or condition of any kind, either implied or expressed, including, but not limited to, the implied warranties, terms or conditions of merchantability, satisfactory quality, and fitness for a particular purpose. NEC-PHILIPS may make improvements or changes in the product(s) and/or the program(s) described in this documentation at any time.

If there is any software on removable media described in this documentation, it is furnished under a license agreement included with the product as a separate document, in the hard copy documentation, or on the removable media in a directory file named LICENSE.TXT or !LICENSE.TXT. If you are unable to locate a copy, please contact NEC-PHILIPS and a copy will be provided to you.

UNITED STATES GOVERNMENT LEGEND

If you are a United States government agency, then this documentation and the software described herein are provided to you subject to the following:

All technical data and computer software are commercial in nature and developed solely at private expense. Software is delivered as “Commercial Computer Software” as defined in DFARS 252.227-7014 (June 1995) or as a “commercial item” as defined in FAR

2.101(a) and as such is provided with only such rights as are provided in NEC-PHILIPS’s standard commercial license for the Software. Technical data is provided with limited rights only as provided in DFAR 252.227-7015 (Nov 1995) or FAR 52.227-14 (June 1987), whichever is applicable. You agree not to remove or deface any portion of any legend provided on any licensed program or documentation contained in, or delivered to you in conjunction with, this User Guide.

Unless otherwise indicated, NEC-PHILIPS registered trademarks are registered in the United States and may or may not be registered in other countries.

NEC-PHILIPS and the NEC-PHILIPS logo are registered trademarks of NEC-PHILIPS Corporation.

Intel and Pentium are registered trademarks of Intel Corporation. Microsoft, MS-DOS, Windows, and Windows NT are registered trademarks of Microsoft Corporation. Novell and NetWare are registered trademarks of Novell, Inc.

All other company and product names may be trademarks of the respective companies with which they are associated.

Page 3

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 3

TABLE OF CONTENTS

1. ABOUT THIS GUIDE................................................................................................................4

1.1 Conventions....................................................................................................................... 4

1.2 Related Documentation ..................................................................................................... 5

2. CONFIGURATION COMMANDS..............................................................................................6

2.1 Basic Configuration Commands ........................................................................................ 6

3. SYSTEM MAINTENANCE & MANAGEMENT COMMANDS ..................................................17

3.1 Debugging ....................................................................................................................... 17

3.2 Information Processing Commands.................................................................................24

3.3 System Operating Management Commands - AR46 Series ........................................... 38

3.4 File Management Commands ......................................................................................... 44

3.5 FTP Server Configuration Commands ............................................................................ 53

3.6 FTP client module commands ......................................................................................... 56

3.7 TFTP Configuration Commands......................................................................................64

3.8 Configuration Files Management Commands .................................................................65

3.9 User Interface Configuration Commands ........................................................................69

3.10 \SNMP Configuration Commands ...................................................................................93

3.11 Terminal Service Commands ........................................................................................ 108

3.12 SSH Configuration Commands .....................................................................................110

4. INTERFACE MANAGEMENT COMMANDS........................................................................121

4.1 Interface Management Commands .............................................................................121

4.2 Fundamental Ethernet interface configuration commands ........................................... 125

4.3 Fundamental WAN Interface Configuration Commands............................................. 128

4.4 Fundamental CE1/PRI Interface Configuration Commands ....................................... 134

4.5 Fundamental CT1/PRI Interface Configuration Commands ....................................... 139

4.6 E1-F Interface Configuration Commands .................................................................... 145

4.7 T1-F Interface Configuration Commands ....................................................................148

4.8 Fundamental CE3 Interface Configuration Commands .............................................. 152

4.9 Fundamental CT3 Interface Configuration Commands .............................................. 159

4.10 ATM E3/T3 Interface Configuration Commands.......................................................... 166

4.11 ATM 25M Interface Configuration Commands ............................................................ 169

4.12 ATM OC-3c/STM-1 Interface Configuration Commands ............................................ 170

4.13 G.SHDSL Interface Configuration Commands ............................................................ 172

4.14 ADSL Interface Configuration Commands...................................................................177

4.15 Logic-Channel Interface ...............................................................................................184

4.16 Configuration Command of Virtual Template and Virtual Access Interface................ 184

4.17 MP-group Interface Configuration Command..............................................................186

4.18 Virtual Ethernet Interface Configuration Command......................................................188

4.19 Configuration Command of Loopback Interface and Null Interface...............................189

Page 4

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide

1. ABOUT THIS GUIDE

This guide describes the NEC-PHILIPS® SOPHO IP 6000 Routers of routers and how to install hardware, configure and boot software, and maintain software and hardware. This guide also provides troubleshooting and support information for your router.

This guide is intended for the system or network administrator who is responsible for installing, configuring, using, and managing the routers. It assumes a working knowledge of wide area network (WAN) operations and familiarity with communication protocols that are used to interconnect WANs.

1.1 Conventions

Table 1 and Table 2 list conventions that are used throughout this guide.

Table 1 Notice Icons

Icon Notice Type Description

Information note

Information that describes important features or instructions.

Caution

Information that alerts you to potential loss of data or potential damage to an application, system, or device.

Warning

Information that alerts you to potential personal injury.

Page 5

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 5

Table 2 Text Conventions

Convention Description

Screen displays

This typeface represents information as it appears on the screen.

Keyboard key names

If you must press two or more keys simultaneously, the key names are linked with a plus sign (+), for example:

Press Ctrl+Alt+Del

The words “enter” and type”

When you see the word “enter” in this guide, you must type something, and then press Return or Enter. Do not press Return or Enter when an instruction simply says “type.”

Words in italics Italics are used to:

Emphasize a point.

Denote a new term at the place where it is defined in the text.

Identify menu names, menu commands, and software button names. Examples:

From the Help menu, select Contents. Click OK.

Words in bold

Boldface type is used to highlight command names in text.

For example, “Use the display user-interface command

to...”

1.2 Related Documentation

The following manuals offer additional information necessary for managing your Router 6000:

■ Command Reference Guide — Provides detailed descriptions of command line interface (CLI)

commands, that you require to manage the Router 6000.

■ Configuration Guide— Describes how to configure your Router 6000 using the supported protocols

and CLI commands.

■ Release Notes — Contains the latest information about your product. If information in this guide differs from information in the release notes, use the information in the Release Notes.

Page 6

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 6

2. CONFIGURATION COMMANDS

This chapter describes how to use the following commands:

Basic Configuration Commands

■ Clock Summer Times

■ clock datetime

■ clock timezone

■ command-privilege

■ display clipboard

■ display clock

■ display history-command

■ display version

■ headerNEC-PHILIPS

■ hotkey

■ language-mode

■ lock

■ quit

■ Reboot

■ return

■ super

■ super password

■ sysname

■ system-view

2.1 Basic Configuration Commands

Clock Summer Times

Syntax Clock summer-time zone_name {absolute / recurring} HH:MM:SS YYYY/MM/DD HH:MM:SS YYYY/MM/DD HH:MM:SS Undo clock summer-time zone. View

User view

Parameter zone_name: Name of the summer time, which is a character string of 1 to 32

characters.

absolute: Only sets the summer time of some year. recurring: Sets the summer time of every year starting from some year. HH:MM:SS: Time (hour/minute/second). YYYY/MM/DD: Date (year/month/day).

Description

Using the clock summer-time command, you can set the name, and the starting and ending time of the summer time. Using the undo clock summer- time command, you can remove the configuration of the summer time.

After the configuration takes effect you can verify it by using the display clock

command. Beside the time of the log or debug information will be the local time on which the adjustment of the time zone and summer time has been made.

Page 7

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 7

For related command, see clock timezone. Example

Add one hour to the clock for the summer time z2 that starts at 06:00:00 on 2002/06/08 and ends at 06:00:00 on 2002/09/01.

<NEC-PHILIPS> clock summer-time z2 absolute 06:00:00 2002/06/08

06:00:00 2002/09/01 01:00:00

# Add one hour to the clock each year starting from 2002 for the summer time z2 that starts at 06:00:00 on 08/06 and ends at 06:00:00 on 01/09.

<NEC-PHILIPS> clock summer-time z2 recurring 06:00:00 2002/06/08

06:00:00 2002/09/01 01:00:00

clock datetime Syntax

clock datetime HH:MM:SS YYYY/MM/DD View

User view

Parameter HH:MM:SS: Time (hour/minute/second). YYYY/MM/DD: Date (year/month/day) in the range of 1993 to 2035.

Description

Using the clock datetime command, you can set the time and date. After the configuration takes effect, you can verify it by executing the display clock command. The time applied to the log and debug information has been

adjusted.

Example

Set the current system time to 10:20:55 2003/04/05.

<NEC-PHILIPS> clock datetime 10:20:55

2003/04/05

clock timezone Syntax

zone_name { add | minus } HH:MM:SS undo clock timezone View

User view

Parameter zone_name: Timezone name, which is a string of 1 to 32 characters. add: Adds the time on the basis of Universal Time Coordinated (UTC)

timezone.

minus: Reduces the time on the basis of UTC timezone. HH:MM:SS: Time (hour/minute/second).

Description

Using the clock timezone command, you can set the information for the local timezone. Using the undo clock timezone command, you can restore the local

timezone to the default UTC timezone.

After the configuration takes effect, you can view it by executing the display clock command. The time applied to the log and debug information has been

adjusted according to the involved timezone and summer time.

For related command, see clock summer-time. Example

Page 8

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 8

Set the local timezone name to Z5 and set Z5 to be five hours faster than UTC time.

<NEC-PHILIPS> clock timezone z5 add 05:00:00

command-privilege Syntax

level level view view command-key undo command-privilege view view command-key

View

System view

Parameter level level: Command priority ranging from 0 to 3. view view: View. The command line provides the following views:

■ shell: View of current user level.

■ system: System view

■ Routing protocol view: Include ospf (OSPF view), rip (RIP view), bgp

(BGP view), isis (IS-IS view), etc.

■ Interface view: Include ethernet (FE), gigabitethernet (GE), serial (serial

interface), ce1 (cE1 interface), ce3 (E3 interface), ct1 (cT1 interface), atm (ATM interface), pos (POS interface), virtual-template (virtual interface template), virtual-ethernet (virtual Ethernet interface), loopback (Loopback interface), null (Null interface), tunnel (Tunnel interface).

■ user-interface: User view

■ l2tp-group: System view of L2TP group.

■ route-policy: Route map view

Refer to "Command Line Views" section in the Operation Manual for more details.

commandkey: Command to be set. Description

Using the command-privilege command, you can set the command level in the specified view. Using the undo command-privilege view command, you can

remove current settings.

Command priority falls into 4 levels, access, monitor, configure and manage, that are identified with 0 to 3. The administrator can grant certain rights to a user on their demand so that the user can operate in the related view. When the user logs in, the system can set the command operation rights either according to the rights corresponding to the user name, or based on the rights of the userinterface. If the two sets of rights conflict, the minimum rights will be adopted.

By default, the command level of the ping, tracert and telnet commands is access (level 0), the command level of the display and debugging commands

is monitor (level 1), that of configuration commands is configure (level 2), and the commands for user key setting, FTP, XMODEM, TFTP and file system operation fit into commands of manage-level (level 3).

Example

Set the priority of the “interface” command to 0.

[NEC-PHILIPS] command-privilege level 0 view system interface

Page 9

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 9

display clipboard Syntax

display clipboard View

Any view

Parameter None Description Using the display clipboard command, you can display the

contents of clipboard.

Example

Display the contents of clipboard.

<NEC-PHILIPS> display clipboard

-----------------clipboard ----------------ip route 10.1.0.0 255.0.0.0 eth 0

display clock Syntax

display clock View

Any view

Parameter

None

Description

Using the display clock command, you can display the clock status and the

configuration information.

Example

Display the current time.

<NEC-PHILIPS> display clock

19:22:03 UTC Sat 2054/03/07

display history command Syntax

display history-command View

Any view

Parameter

None

Description

Using the display history-command command, you can browse the history

commands.

The terminal will automatically save the history commands typed by the user, that is, completely record the user's input (via keyboard) separated by "Enter".

For the related command, see history-command size. Example

Display history commands.

<NEC-PHILIPS> display history-command

show interface show interface e 1/0/0 c in e 1/0/0

Page 10

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 10

display version Syntax

Display version View

Any view

Parameter

None

Description

Using the display version command, you can browse system version

information. Through viewing system version information, you will learn about the software version in use, rack type, and the information related to the main processing board and interface cards.

Example

Display system version information of a NEC-PHILIPS R1760 router.

<NEC-PHILIPS> display version NEC-PHILIPS Versatile Routing Platform

Software VRP(tm) software, Version 3.30 Copyright (c) 2000-2002 NECPHILIPS Corporation. NEC-PHILIPS Serial Router R1760 System has kept running 0weeks, 0days, 0hours, 15minutes CPU type Powerpc8241 166Mhz 64M bytes SDRAM 8M bytes Flash Memory Pcb Version:001 Logic Version:001 BootROM Version:0.0

Slot0: WAN (pcb)001 (software)000 (logic)001

headerNEC-PHILIPS Syntax

header [ shell | incoming | login ] text undo header [ shell | incoming | login ]

View

System view

Parameter login: Greeting information when login.

shell: Greeting information of the creation of a user session. incoming: Greeting information when login to the user view. text: Content of greeting information. Description

Using the header command, you can set the greeting information to be displayed. Using the undo header command, you can remove the preset

greeting information.

When a user is logging on to a router via a terminal line the router prompts related information through setting title attribute. After activating the terminal

connection, the router sends the login title to the terminal. If the user logs on to the router successfully, the shell greeting information will be displayed.

Text takes the first English character as the start and end characters. After the

end character is input, the system will quit the interactive process automatically.

Page 11

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 11

If you do not want to start the interactive process, make sure that the first and last characters of the text are the same English character and press <Enter> directly.

Example

Configure a session creation title.

[NEC-PHILIPS] header shell %

Enter TEXT message. End with the character '%'. SHELL : Hello! Welcome use NEC-PHILIPS R1760.% # Test the configuration.

[NEC-PHILIPS] quit <NEC-PHILIPS> quit

Press RETURN to get started SHELL : Hello! Welcome use NEC-PHILIPS R1760. <NEC-PHILIPS>

hotkey Syntax

System view

Parameter CTRL_G: Specify a command for the hotkey <CTRL+G>. CTRL_L: Specify a command for the hotkey <CTRL+L>. CTRL_O: Specify a command for the hotkey <CTRL+O>. CTRL_T: Specify a command for the hotkey <CTRL+T>. CTRL_U: Specify a command for the hotkey <CTRL+U>.

command_text: The command line correlated with the hotkey.

Description

Using the hotkey command, you can correlate a command line with a hotkey. Using the undo hotkey command, you can recover the default value of the

system.

By default, CTRL_G, CTRL_L and CTRL_O correspond to the following commands respectively: display current-configuration (display current configuration); display ip routing-table (display routing table information); undo debugging all (disable the overall debugging function, that is, disable the output of all debugging information).

You can change the definitions on your demand. The default values for the other hotkeys are null.

Example

Correlate the display tcp status command with the hotkey CTRL_T.

[NEC-PHILIPS] hotkey ctrl_t display tcp status [NEC-PHILIPS] display hotkey

----------------- HOTKEY ----------------=Defined hotkeys= Hotkeys Command CTRL_G display current-configuration CTRL_L display ip routing-table

Page 12

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 12

CTRL_O undo debug all CTRL_T display tcp status =Undefined hotkeys= Hotkeys Command CTRL_U NULL =System hotkeys= Hotkeys Function CTRL_A Move the cursor to the beginning of the current line. CTRL_B Move the cursor one character left. CTRL_C Stop current command function. CTRL_D Erase current character. CTRL_E Move the cursor to the end of the current line. CTRL_F Move the cursor one character right. CTRL_H Erase the character left of the cursor. CTRL_K Kill outgoing connection. CTRL_N Display the next command from the history buffer. CTRL_P Display the previous command from the history buffer. CTRL_R Redisplay the current line. CTRL_V Paste text from the clipboard. CTRL_W Delete the word left of the cursor. CTRL_X Delete all characters up to the cursor. CTRL_Y Delete all characters after the cursor. CTRL_Z Return to the user view. CTRL_] Kill incoming connection or redirect connection. ESC_B Move the cursor one word back. ESC_D Delete remainder of word. ESC_F Move the cursor forward one word. ESC_N Move the cursor down a line. ESC_P Move the cursor up a line. ESC_< Specify the beginning of clipboard. ESC_> Specify the end of clipboard.

language-mode Syntax

language-mode { chinese | english } View

User view

Parameter

None

Description

Using the language-mode command, you can switch between different

language modes of command line interface.

By default, the language mode is English.

The command line interface of the system also supports Chinese mode to fit

into domestic users in China.

Example

Switch from English mode to Chinese mode.

<NEC-PHILIPS> language-mode Chinese

Change language mode, confirm? [Y/N]y % Switch to Chinese mode.

Page 13

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 13

lock Syntax

lock View

User view

Parameter

None

Description

Using the lock command, you can lock the active user interface to prevent an

unauthorized user from operating the interface.

A user interface includes CON port, AUX port and VTY, etc.

After inputting the lock command, the user is prompted to enter the

screensaver's password and confirm the password. If the two passwords are the same, the interface will be successfully locked. To enter the system once again, you must press <Enter> first, and enter the preset password following the prompt.

Example

<NEC-PHILIPS> lock

Password: Again:

quit Syntax quit

View

Any view

Parameter

None

Description

Using the quit command, you can quit from the active view to a lower-level view

(if the active view is user view, you will exit the system).

Views fall into three levels; in ascending order:

■ User view (with user level as 0)

■ System view (with user level as 3)

■ and Configuration view (routing protocol view, interface view, VPDN group

view, etc).

For the related command, see return. Example

Switch from Ethernet1/0/0 interface view to system view, and then to user view.

[NEC-PHILIPS-Ethernet1/0/0] quit [NEC-PHILIPS] quit

<NEC-PHILIPS>

Page 14

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 14

Reboot Syntax reboot

View

User view

Parameter

None

Description

Using the reboot command, you can reboot the device.

This command produces the same effect as the power being turned on and then off, but provides the user with a convenient method of rebooting the device from a remote site.

The operation of this command will render the network unusable for a short period of time. So it should be used with caution. Before rebooting the Router, remember to save the configuration file if necessary,

Example

Reboot the device.

<NEC-PHILIPS> reboot

System will reboot! Continue?[Y/N]

return Syntax return

View

Any view, except user view

Parameter

None

Description

Using the return command, you can return to user view from any other views. The combination key <Ctrl+Z> performs the same function as the return

command.

For the related command, see quit. Example

Return to user view from system view.

[NEC-PHILIPS] return

<NEC-PHILIPS>

super Syntax super [ level ]

View

User view

Parameter Level: User level ranging from 0 to 3.

Description

Using the super command, you can switch from current user level to a specified

level.

Page 15

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 15

User level refers to the class of a login user. There are 4 user levels corresponding to 4 command levels. After a user of certain level logs in, it can only use the commands of the same or lower level.

There are 4 command levels access, monitor, configure and manage, as follows:

■ Access: Includes the network diagnosis tool commands (ping, tracert);

commands for accessing an external device from local device (including Telnet client, SSH client, RLOGIN), etc. Commands of this level cannot perform configuration file saving operation.

■ Monitor: Commands used for system maintenance, service fault diagnosis

and so on, including the display and debugging commands. Commands

of this level cannot perform configuration file saving operation.

■ Configure: Service configuration commands, including routing commands and commands of various network layers. Commands of this level provide direct network services for users.

■ Manage: Commands related to basic system running and system support modules. These commands provide support for various services. Commands of this level include file system, FTP, TFTP, Xmodem download and configuration file switchover commands, power control commands, standby board control commands, user management commands, level setting commands, system internal parameter setting commands (not being provided in protocols or RFC documentation), etc.

To prevent unauthorized users from intruding the system, you must pass the authentication when you are trying to switch from current user to a higher-level user. This means that you must enter the password of the higher-level user (if

the super password [ level user-level ]{ simple | cipher } line command is

configured). For the sake of security, your entered password is not directly displayed on the screen. If you enter the correct password within three times, you will be able to switch to the higher-level user, or you will stay at current level.

For the related command, see super password. Example

<NEC-PHILIPS> super 3

Password: User privilege changes to 3 level, just equal or less this level's commands can be used. Privilege note: 0-VISIT, 1-MONITOR, 2-SYSTEM, 3-MANAGE

super password Syntax

super password [ level user-level ] { simple | cipher } password undo super password [ level user-level ]

View

System view

Parameter user-level: User level ranging from 0 to 3.

simple: Configure simple text password. cipher: Configure cipher text password. password: Content of password. A simple text password is a consecutive

character string with the length no more than 16, such as 1234567. A cipher text password has 24 characters in length, and is in the format of "_(TT8F]Y\5SQ=^Q`MAF4<1!!".

Page 16

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 16

Description

Using the super password command, you can set the password need to switch from a lower-level user to a higher-level user. Using the undo super password

command, you can remove the current setting.

By default, simple text password is adopted.

Example

Execute the following command in system view:

[NEC-PHILIPS] super password level 3 simple zbr

sysname Syntax ysname sysname

View

System view

Parameter sysname: Name of the router. It is a character string containing 1 to 30

characters.

Description

Using the sysname command, you can set the name of a router.

By default, a router is named "NEC-PHILIPS".

Modification to a router's name will affect the prompt of the command line interface. For example, if the router's name is "NEC-PHILIPS", the prompt of user view will be "<NEC-PHILIPS>".

Example

Set the name of the router to R1760.

[NEC-PHILIPS] sysname R1760

[R1760]

system-view Syntax system-view

View

User view

Parameter

None

Description

Using the system-view command, you can enter system view from current user

view.

For the related command, see quit, return.

Example

<NEC-PHILIPS> system-view Enter system view , return user view with Ctrl+Z.

[NEC-PHILIPS]

Page 17

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 17

3. SYSTEM MAINTENANCE & MANAGEMENT COMMANDS

Network Test Tool Commands

3.1 Debugging

Debugging Syntax

debugging { all | module-name [ debug-option1 ] [ debug-option2 ] …} undo debugging { all | module-name [ debug-option1 ] [ debug-option2 ] …}

View

User view

Parameter all: Enables or disables all the debugging switches.

module-name: Module name. debug-option: Debugging option.

Description Using the debug command, you can enable system debugging. Using the undo debug command, you can disable system debugging.

By default, the system disables all the debugging switches.

The router system provides a variety of debugging functions mainly for the support technicians and senior maintenance engineers to perform network fault diagnosis.

Enabling debugging will generate a large amount of debugging information that can result in a decrease in system efficiency. This is especially the case when the command debugging all is executed to enable all the debugging switches. An extreme aftermath after doing so can be system paralysis. For these

reasons, you are recommended not to use the command debugging all. On

the contrary, using undo debugging all will bring you great convenience because you can disable all the debugging switches at once rather than disabling them one by one.

For related command, see display debugging. Example

Enable IP packet debugging.

display debugging Syntax

display debugging [ interface interface-type interface-number] [ modulename ]

View

Any view

Parameter

module-name: Module name. interface-type: Interface type.

Page 18

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 18

interface-number: Interface number.

Description Using the display debugging command, you can display the enabled

debugging switches.

By default, no parameters have been defined and all the enabled debugging switches are displayed.

For related command, see debugging. Example

Display all the enabled debugging switches.

<NEC-PHILIPS> display debugging IP packet debugging switch is on.

display diagnostic- Syntax information display diagnostic information

View

Any view

Parameter

None

Description Using the display diagnostic-information command, you can display the

operating information of all the active modules of the system and collect all the information at one time to isolate the problem when failure occurs to the system.

In case failures occurs to the system, lots of information needs to be collected for the convenience of isolating the problems. However, it is rather difficult for you to collect all the information at one time because there are many display

commands involved. In this case, you can use the display diagnostic- information command to collect the operating information of all the active

modules in the system.

Example

Display the technical support information.

<NEC-PHILIPS> display diagnostic-information

------------------ display version -----------------

NEC-PHILIPSNEC-PHILIPS Versatile Routing Platform Software VRP 3600E Software Version VRPV3R001M06B03D003, DEBUG SOFTWARE Copyright (c) 2000-2003 by VRP Team Beijing Institute NEC-PHILIPS Tech, Inc Compiled Mar 24 2003 20:28:31 by zhaomin

------------------ display running-config -----------------

# sysname NEC-PHILIPS #

------------------ display history commands -----------------

display diagnostic-information

------------------ display tasks -----------------

ID Name Priority Status CPU Time 1 WEIL 10 Ready 10/20 2 SYST 180 Ready 0/7 3 XMON 140 Event Sem 0/0 4 VMON 140 Event Sem 41/41 5 INFO 100 Event Sem 1/6 6 co0 100 Ready 0/3178

Page 19

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 19

7 LDP 100 Event Sem 1/299 8 LAGT 100 Queue Sem 0/1 9 Clon 100 Event Sem 0/0 10 ROUT 100 Event Sem 0/172 11 FIB 100 Event Sem 0/178 12 SOCK 100 Event Sem 0/47961 13 VTYD 100 Event Sem 0/25 14 IPSP 100 Event Sem 0/537 15 IKE 100 Event Sem 1/20 16 RSA 100 Event Sem 1/94 17 RDUS 100 Delay 1/1574 18 L2TP 100 Event Sem 0/14 19 TNLM 100 Event Sem 0/0 20 AGNT 100 Event Sem 0/4904 21 TRAP 100 Queue Sem 0/0 22 MDMT 100 Queue Sem 0/3 23 NTPT 100 Delay 0/7 24 PIMT 100 Delay 0/7 25 CFM 100 Queue Sem 363/1355 26 LSPM 100 Delay 0/414 27 L2V 100 Delay 0/6 28 VRRP 100 Event Sem 0/0

------------------ display memory ------------------

Slice Memory Usage:

Block Size 32 Free 960 Used 60134 Total 61094 Block Size 64 Free 275 Used 29356 Total 29631 Block Size 128 Free 9 Used 5882 Total 5891 Block Size 256 Free 8 Used 1664 Total 1672 Block Size 512 Free 1 Used 120 Total 121 Block Size 1024 Free 58 Used 157 Total 215 Block Size 2048 Free 5 Used 1547 Total 1552 Block Size 4096 Free 1 Used 67 Total 68

-----------------------------Summary--------------------------------

Used(Byte) 8646848 Free 1317 Used 98927 Total 100244 Total Slice Memory(Include Control Data and Free Slice): 10742144 bytes Raw Slice Memory Usage: Total Size: 10501832 bytes Num: 77 Total Raw Slice Memory(Include Control Data and Free Slice): 12606400 bytes System Total Memory(bytes): 33541536

------------------ display interfaces ------------------

Atm1/0/0 is down , line protocol is down Description : NEC-PHILIPS, NEC-PHILIPS Series, Atm1/0/0 Interface The Maximum Transmit Unit is 1500 Internet protocol processing : disabled AAL enabled: AAL5, Maximum VCs: 32 Current VCs: 0 (0 on main interface) 5 minutes input rate 0.00 bytes/sec, 0.00 packets/sec 5 minutes output rate 0.00 bytes/sec, 0.00 packets/sec 0 packets input, 0 bytes 0 packets output, 0 bytes 0 input errors, 0 CRCs, 0 giants, 0 pads, 0 aborts,0 overflows 0 output errors, 0 underflows, 0 overflows NULL0 is up , line protocol is up (spoofing) Description : NEC-PHILIPS, NEC-PHILIPS Series, NULL0 Interface The Maximum Transmit Unit is 1500 Internet protocol processing : disabled Serial0/0/0 is down , line protocol is down Description : NEC-PHILIPS, NEC-PHILIPS Series, Serial0/0/0 Interface The Maximum Transmit Unit is 1500, The keepalive is 10(sec)

Page 20

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 20

Internet protocol processing : disabled Encapsulation is PPP LCP initial FIFO queuing: (Outbound queue:Size/Length/Discards) FIFO: 0/75/0 Physical layer is synchronous, Baudrate is 64000 bps, Interface is no cable 5 minutes input rate 0.00 bytes/sec, 0.00 packets/sec 5 minutes output rate 0.00 bytes/sec, 0.00 packets/sec 0 packets input, 0 bytes, 0 no buffers 0 packets output, 0 bytes, 0 no buffers 0 input errors, 0 CRC, 0 frame errors 0 overrunners, 0 aborted sequences, 0 input no buffers DCD=DOWN DTR=DOWN DSR=DOWN RTS=DOWN CTS=DOWN

ping Syntax

ping [ -a X.X.X.X | -c count | -d | -h ttl_value | -i { interface-type interfacenumber } | ip | -n | - p pattern | -q | -r | -s packetsize | -t timeout | -v | vpninstance vpn-instance-name ] * host

View

Any view

Parameter

-a X.X.X.X: Sets the source IP address where ICMP ECHO-REQUEST packets

can be sent.

-c count: Times that ICMP ECHO-REQUEST packets are sent. It is ranging

from 1 to 4294967295.

-d: Sets socket to DEBUG mode.

-h ttl_value: Sets the value of TTL_value, which is ranging from 1 to 255.

-i: Sets the interface for sending ICMP ECHO-REQUEST packets.

interface-type: Interface type interface-number: Interface number

-n: Directly uses the host parameter as IP address without domain name

resolution.

-p pattern: The filling byte of ICMP ECHO-REQUEST packet in hexadecimal

format, with the value ranging from 0 to FFFFFFFF. For example, if the

parameter is set to -p ff, the entire packet will be filled with ff.

-q: Displays statistic figures rather than details.

-r: Records routes.

-s packetsize: The length of ECHO-REQUEST packet (excluding IP and ICMP

headers), which is in the range of 20 to 8100 bytes.

-t timeout: Timeout in milliseconds waiting for ECHO-RESPONSE upon

completion of sending ECHO-REQUEST, in the range from 0 to 65535.

-v: Displays the received ICMP packets other than ECHO-RESPONSE packets.

vpn-instance vpn-instance-name: Sets the vpn-instance name of MPLS VPN

to specify the VPN attribute configured in this ping command, that is, name of the associated vpn-instance created at the local.

host: Domain name or IP address of destination host. ip: IP protocol is used.

Description

Using the ping command, you can check the IP network connection and

whether the host is reachable.

Page 21

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 21

If the above parameters have not been specified, the following default settings will be used:

■ the ECHO-REQUEST packet is sent for 5 times at most.

■ the Socket is non-DEBUG mode.

■ the Host is first regarded as an IP address. If it is not an IP address,

domain name resolution will be performed.

■ the filling begins at 0x01 and increases gradually until 0x09 and then repeats.

■ All the information including statistics is displayed.

■ the Router is not recorded.

■ the length of ECHO-REQUEST packet is 56 bytes.

■ the timeout time waiting for an ECHO-RESPONSE packet is 2000ms.

■ the ICMP packets other than ECHO-RESPONSE packets are not

displayed.

■ the parameter vpn-instance is not defined.

Following is the process of executing the ping command:

■ A host sends an ICMP ECHO-REQUEST to a destination. If the connection to the destination network is working normally, the destination host will be able to receive the ICMP ECHO-REQUEST packet and send an ICMP ECHO-REPLY packet back to the source host.

■ The ping command can be used to test the network for connection failure

or network line quality problem. The output information includes:

■ The state of the reply that a destination has made to each ECHO- REQUEST. It will be “Request time out." if no reply has been received upon the expiration of the timeout time. Otherwise, the state information will include the bytes of the reply packet, packet sequence number, TTL, reply time etc.

■ The last statistic information includes the count of packets sent, the count of reply packets received, the percentage of the packets that have no reply, and the minimum, maximum, and average reply time settings.

■ If the network transmission is slow, you can appropriately prolong the timeout time waiting for reply.

For related command, see tracert. Example

Check the reachability of the host at 202.38.160.244.

<NEC-PHILIPS> ping 202.38.160.244

ping 202.38.160.244 : 56 data bytes , press CTRL-C to break Reply from 202.38.160.244 : bytes=56 sequence=1 ttl=255 time = 1ms Reply from 202.38.160.244 : bytes=56 sequence=2 ttl=255 time = 2ms Reply from 202.38.160.244 : bytes=56 sequence=3 ttl=255 time = 1ms Reply from 202.38.160.244 : bytes=56 sequence=4 ttl=255 time = 3ms Reply from 202.38.160.244 : bytes=56 sequence=5 ttl=255 time = 2ms --

202.38.160.244 ping statistics—

5 packets transmitted 5 packets received 0% packet loss round-trip min/avg/max = 1/2/3 ms

Page 22

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 22

reboot Syntax

reboot View

User view

Parameter

None

Description Using the reboot command, you can reboot the device.

This command produces the same effect as the power being turned off and then on, but provides the user with a convenient method of rebooting the device from a remote site.

Example

Reboot the device.

<NEC-PHILIPS> reboot

System will reboot! Continue?[Y/N]

tracert Syntax

View

Any view

Parameter

-a: Specifies source IP address of the tracert packets, which is in the format of

X.X.X.X and must be the address of a local interface.

-f: Tests the correctness of the –f switch with first_TTL specifying an initial TTL

in the range of 0 to the maximum TTL.

-m: Tests the correctness of the –m switch with max_TTL specifying a

maximum TTL which can be any TTL larger than the initial TTL.

-p: Tests the correctness of the –p switch with port being an integer specifying

the port of the destination host. There is no need to change this option in normal circumstances.

-q: Tests the correctness of the –q switch with nqueries specifying the number

of the query packets sent each time. It can be any integer larger than 0.

vpn-instance vpn-instance-name: Sets the vpn-instance name of MPLS VPN

to specify the VPN attribute configured in this tracert command, that is, name of the associated vpn-instance created at the local.

-w timeout: Tests the correctness of the –w switch with timeout specifying the

timeout time of IP packets. It is in seconds and can be any integer larger than 0.

host: IP address of the destination host.

Description

Using the tracert command, you can test the gateways that a packet sent by

the host will pass by in order to reach the destination for the purpose of testing

Page 23

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 23

the reachability of a network connection and locating the position where faults occur on the network.

Given no parameters have been specified, by default,

The parameters –a and vpn-instance are omitted;

first_TTL is 1;

max_TTL is 30;

port is 33434;

nqueries is 3;

timeout is 5s.

The tracert command is executed following this procedure: The system first

sends a packet with TTL as 1 and the first hop returns an ICMP error message indicating that the packet cannot be transmitted due to TTL timeout. and then the system transmits the packet again with TTL being set to 2 and the second hop returns TTL timeout message similarly. This process continues until the packet reaches its destination. The purpose of such a process is to record the source addresses where these ICMP TTL timeout messages are sent so as to outline the path along which the IP packet can reach the destination.

When a network fault is detected by using the ping command, tracert can be

used to locate the failure on the network.

The output information of the command tracert includes IP addresses of all the GWs along the path to the destination. If some GW times out, “***” will be output.

Example <NEC-PHILIPS> tracert 18.26.0.115

tracert to allspice.lcs.mit.edu (18.26.0.115), 30 hops max

1 helios.ee.lbl.gov (128.3.112.1) 0 ms 0 ms 0 ms

2 lilac-dmc.Berkeley.EDU (128.32.216.1) 19 ms 19 ms 19 ms

3 lilac-dmc.Berkeley.EDU (128.32.216.1) 39 ms 19 ms 19 ms

4 ccngw-ner-cc.Berkeley.EDU (128.32.136.23) 19 ms 39 ms 39 ms

5 ccn-nerif22.Berkeley.EDU (128.32.168.22) 20 ms 39 ms 39 ms

6 128.32.197.4 (128.32.197.4) 59 ms 119 ms 39 ms

7 131.119.2.5 (131.119.2.5) 59 ms 59 ms 39 ms

8 129.140.70.13 (129.140.70.13) 80 ms 79 ms 99 ms

9 129.140.71.6 (129.140.71.6) 139 ms 139 ms 159 ms

10 129.140.81.7 (129.140.81.7) 199 ms 180 ms 300 ms

11 129.140.72.17 (129.140.72.17) 300 ms 239 ms 239 ms

12 * * *

13 128.121.54.72 (128.121.54.72) 259 ms 499 ms 279 ms

14 * * *

15 * * *

16 * * *

17 * * *

18 ALLSPICE.LCS.MIT.EDU (18.26.0.115) 339 ms 279 ms 279 ms

Page 24

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 24

3.2 Information Processing Commands

display channel Syntax

display channel [ channel-number | channel-name ] View

Any view.

Parameter channel-number: Channel number, ranging 0 to 9. That is, the system has 10

channels.

channel-name: Channel name.

Table 1 Channel names and their associated channel numbers

Channel name Information channel number

channel6 6 channel7 7 channel8 8 channel9 9 console 0 logbuffer 4 loghost 2 monitor 1 snmpagent 5 trapbuffer 3

Description Using the display channel command, you can display the contents of an

information channel.

This command displays the setting states of all channels when executed without any parameter.

Example

Display the contents of information channel 0.

<NEC-PHILIPS> display channel 0

channel number:0, channel name:console MODU_ID NAME ENABLE LOG LEVEL ENABLE TRAP LEVEL ENABLE DEBUG LEVEL ffff0000 all Y warning Y debugging Y debugging

display info-center Syntax

display info-center View

Any view

Parameter

None

Description Using the display info-center command, you can display all the

information recorded in the info-center.

Page 25

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 25

For related commands, see info-center enable, info-center loghost, infocenter logbuffer, info-center trapbuffer, info-center console channel, and info-center monitor channel.

Example

Display the information recorded in the info-center.

<NEC-PHILIPS> display info-center

Information Center: enabled Log host: Console:

channel number : 0, channel name : console

Monitor: channel number : 1, channel name : monitor

SNMP Agent: channel number : 5, channel name : snmpagent

Log buffer: enabled,max buffer size 1024, current buffer size 256,

current messages 89, channel number : 4, channel name : logbuffer dropped messages 0, overwrote messages 0

Trap buffer: enabled,max buffer size 1024, current buffer size 256, current messages 0, channel number:3, channel name:trapbuffer dropped messages 0, overwrote messages 0 Information timestamp setting: log - date, trap - date, debug - boot

Sent messages = 89, Received messages = 89

display logbuffer Syntax

display logbuffer [ size size-value | summary ] [ level level-number ] [ | [ begin | include | exclude ] string ]

View

Any view

Parameter size: Displays the number of information entries in the logbuffer.

size-value: The number of displayed information entries.

summary: A summary of the logbuffer. level: Displays only the count of information entries at a specified level.

level-number: The specified level in the ranging 1 to 8.

|: Uses regular expression to filter the information for display. begin: Displays the information beginning with the specified characters (string). include: Displays the information including the specified characters (string). exclude: Displays the information excluding the specified characters (string). string: Characters of the regular expression.

Page 26

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 26

Description

Using the display logbuffer command, you can display the information

recorded in the logbuffer.

By default, executing display logbuffer without any parameter displays all the information in the logbuffer.

If the number of information entries in the current logging buffer is smaller than the specified size-value, logging information of the actual entries will be displayed.

For related commands, see info-center enable, info-center logbuffer,

and display info-center. Example

Display the information in the logging buffer.

<NEC-PHILIPS> display logbuffer

Logging Buffer Confiuration and contents:enabled allowed max buffer size : 1024 actual buffer size : 256 channel number : 4 , channel name : logbuf dropped messages : 0 overwritten messages : 0 current messages : 96 %8/28/2101 5:34:48-IC-7SYS_RESTART: System restarted – NEC-PHILIPS Versatile Routing Platform Software Copyright (c) 2000-2002 by VRP Team Beijing Institute NEC-PHILIPS Tech, Inc %9/9/2002 15:50:36-SHELL-5-CMD:task:CFM ip:** user:** command:interface Ethernet %11/6/2002 22:18:52-SHELL-5-CMD:task:CFM ip:** user:** command:interface Aux0 %3/15/2003 15:50:36-SHELL-5-CMD:task:CFM ip:** user:** command:controller E1 3/0 %4/1/2003 21:29:47-PHY-2-PHY: Console0: change status to up

display trapbuffer Syntax

display trapbuffer [ size sizeval ] View

Any view

Parameter size: Specifies the number of information entries in the logbuffer.

sizeval: The number of displayed information entries. Description

Using the display trapbuffer command, you can display the information

recorded in the trapbuffer.

By default, executing the command without any parameter displays all the information in the trapbuffer.

If the number of information entries in the current trapbuffer is smaller than the specified sizeval, the actual number of traps will be displayed.

For related commands, see info-center enable, info-center trapbuffer, and

display info-center.

Page 27

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 27

Example

Display trapbuffer information.

<NEC-PHILIPS> display trapbuffer

Trapping Buffer Confiuration and contents: enabled allowed max buffer size : 1024 actual buffer size : 256 channel number : 3 , channel name : trapbuf dropped messages : 0 overwrote messages : 0 current messages : 0 # Display 23 entries of information in the trapbuffer.

<NEC-PHILIPS> display trapbuffer size 23

info-center channel Syntax

info-center channel channel-number name channel-name undo info-center channel channel-number

View

System view

Parameter channel-number: The channel number, with the value ranging from 0 to 9. That

is, the system has 10 channels.

channel-name is a channel name, with maximum length of 30 characters,

excluding ”-“, ”/” and ”\”..

Description Using the rename channel command, you can rename the information channel numbered channel-number as channel-name.

When naming the information channels, please note that no duplicated channel name is allowed.

Example

Name Channel 0 as "execconsole".

[NEC-PHILIPS] info-center channel 0 name execconsole

info-center console Syntax channel { channel-number | channel-name } undo info-center console channel

View

System view

Parameter channel-number: Channel number, ranging 0 to 9, that is, the system has

10 channels.

channel-name: Channel name.

Page 28

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 28

Description

Using the info-center console channel command, you can enable outputting

information to the console and set the information output channel. Using the

undo info-center console channel command, you can disable the current

settings. By default, no logging information is output to the console.

This command will not become valid unless the syslog function has been enabled.

For related commands, see info-center enable and display info-center. Example

Enable outputting information to the console and set the output channel.

[NEC-PHILIPS] info-center console channel console

info-center enable Syntax

info-center enable undo info-center enable

View

System view

Parameter

None

Description Using the info-center enable command, you can enable the info-center. Using the undo info-center enable command, you can disable the info-center.

By default, the info-center has been enabled.

Only when the info-center has been enabled will the system output information go to the loghost and the console.

For related commands, see info-center loghost, info-center logbuffer, info-

center trapbuffer, info-center console channel, info-center monitor channel, display info-center.

Example

Enable the info-center.

[NEC-PHILIPS] info-center enable % information center is enabled

info-center logbuffer Syntax info-center logbuffer [ channel { channel-number | channel-name } | size

buffersize ]

* undo info-center logbuffer [ channel | size ]

View

System view

Parameter channel: Sets the channel for information output to the logbuffer.

channel-number: Channel number ranging 0 to 9. That is, the system has 10

channels.

channel-name: Channel name.

Page 29

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 29

size: Sets logbuffer size. buffersize: Size of the logbuffer (the accommodated message entries). Description

Using the info-center logbuffer command, you can enable the logbuffer and

set the channel number for logging information output as well as the size of the

logging buffer. Using the undo info-center logbuffer command, you can

cancel the current settings.

By default, the information outputted to the logbuffer is allowed, and the logbuffer size is 256.

Only when the info-center has been enabled will this command become effective. By setting channel number after enabling logbuffer, you can specify information’s outbound direction.

For related commands, see info-center enable, display info-center, and

display info-center logbuffer. Example

Enable the router to send information to the logbuffer and set the logbuffer size to 50.

[NEC-PHILIPS] info-center logbuffer size 50

info-center loghost Syntax

info-center loghost X.X.X.X [ channel { channel-number | channel-name } | facility local-number | language { chinese | english } ] *

undo info-center loghost X.X.X.X View

System view

Parameter X.X.X.X: IP address of the loghost.

channel: Information channel for the loghost. channel-number: Channel number ranging 0 to 9. That is, the system has 10

channels.

channel-name: Channel name. facility: Sets the recording tool of the loghost. local-number: Recording tool of the loghost, which is ranging local0 to local7. language: Sets the logging language. chinese and english: Logging language which can be Chinese or English.

Description

Using the info-center loghost command, you can enable the router to output information to the loghost. Using the undo info-center loghost command, you

can cancel the current configuration.

By default, no information is output to the loghost.

Page 30

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 30

If not specified, the information channel for the loghost defaults to channel2 that

is named loghost, the loghost recording tool local-number to local7, and the

language to english.

Only when the information center has been enabled will this command become effective.

By setting the IP address of loghost, you can specify the information outbound direction. You can set up to 4 loghosts.

For related command, see info-center enable, and display info-center.

Example

Enable the router to send information to the UNIX workstation at 202.38.160.1.

[NEC-PHILIPS] info-center loghost 202.38.160.1

info-center loghost Syntax

source info-center loghost source interface-type interface-number [ subinterface-

type ] undo info-center loghost source

View

System view

Parameter

interface-type: Interface types. interface-number: Number of the interface. subinterface-name: Subinterface types.

Description The info-center loghost source command is used to specify the source address for sending packets to the logging host while the undo info-center loghost source command is used to cancel the current configuration. Undo

info-center loghost source is for the canceling of the current configuration.

When a logging message is sent out from a router, the default source address is the IP address of the interface which has sent the logging message. If the user wants to change the source address, he can use this command to achieve it. You can judge which router has sent out the message by setting different source addresses for different routers, accordingly you can also search among the received messages.

Example

Set the IP address of Loopback0 as the source address of the logging message packets.

[NEC-PHILIPS] interface loopback 0 [NEC-PHILIPS-LoopBack0] ip address 1.1.1.1 255.255.255.0 [NEC-PHILIPS-LoopBack0] quit [NEC-PHILIPS] info-center loghost source loopback 0

Page 31

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 31

info-center monitor Syntax channel { channel-number | channel-name }

undo info-center monitor channel View

System view

Parameter channel-number: Channel number ranging 0 to 9. That is, the system has 10

channels.

channel-name: Channel name. Description

Using the info-center monitor channel command, you can enable the router to

output information to the user terminal and set the output channel. Using the

undo info-center monitor channel command, you can cancel the current

configuration.

By default, no information is output to the user terminal.

Only when the info-center has been enabled will this command become effective.

For related commands, see info-center enable, and display info-center. Example

Enable the router to output information to the user terminal and set the output channel.

[NEC-PHILIPS] info-center monitor channel monitor

info-center snmp Syntax channel info-center snmp channel { channel-number | channel-name }

undo info-center snmp channel View

System view

Parameter channel-number: Channel number ranging 0 to 9. That is, the system has 10

channels.

channel-name: Channel name.

Description

Using the info-center snmp channel command, you can set the information channel for snmp. Using the undo info-center snmp channel command, you

can cancel the current configuration.

By default, channel 5 is used.

For the related command, see display snmp-agent statistics.

Example

Set snmp information channel to channel 6.

[NEC-PHILIPS] info-center snmp channel 6

Page 32

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 32

info-center source Syntax

info-center source { module-name | default } { channel { channel-number | channel-name} } [ log { state { on | off } | level severity }* | trap { state { on | off } | level severity } * | debug { state { on | off } | level severity }* ]* undo info-center source { module-name | default } { channel { channelnumber | channel-name }

View

System view

Parameter module-name: Module name.

default: Sets the default information record.

channel-number: Information channel number to be set. channel-name: Information channel name to be set.

log: Log information. trap: Alarm information. debug: Debugging information. on: Enables outputting information. off: Disables outputting information. level: Sets information level to disable the output of the information at a level

higher than the specified severity.

severity: Information level. As shown in the following table, the info-center

divides information into eight levels by severity or emergency, with a lower level indicating a more emergent event. emergencies indicates level 0 and debugging indicates level 7.

Table 2 Definition of information level

Severity level Description

emergencies Extremely emergent errors alerts Errors requiring immediate correction critical Critical errors

errors

Errors that is not critical but require your concern

warnings Warning indicating that there may be

some errors

notifications Information needs your concern informational Common prompt information debugging Debugging information

*: Indicate multiple choices can be selected. At least one choice must be selected and all the choices can be selected at most.

Description

Using the info-center source command, you can add records to an information channel. Using the undo info-center source command, you can remove the

records from the information channel.

For a specified module, by default,

Page 33

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 33

The state of logging information output is on and the allowed information level is informational.

The state of trapping information output is on and the allowed information level is informational.

The state of debugging information ouput is off.

So far, the system allocates one information channel for each output direction. They are:

The Output directionInformation channel number and the Default information channel name Console 0 console

Monitor terminal1 monitor

Loghost 2 loghost

Trapbuffer 3 trapbuffer

Logbuffer 4 logbuffer snmp 5snmpagent

In addition, each information channel has a default record for which the module name and number are default and 0xffff0000. But for different channels, the record may have different default settings for logging information, trapping information, and debugging information. If a module has no explicit configuration record in the channel, the default configuration record will be used.

Example

Enable the output of log information of the IP module in the snmp channel and the allowed highest level of the output information is emergence.

[NEC-PHILIPS] info-center source ip channel snmpagent log level

emergence

# Remove the setting of the cmd module in the snmp channel.

[NEC-PHILIPS] undo info-center source cmd channel snmp

info-center timestamp Syntax

info-center timestamp { trap | debugging | log } { boot | date | none } undo info-center timestamp { trap | debugging | log }

View

System view

Parameter trap: Trap information debugging: Debugging information. log: log information. boot: Post booting time that the system experiences. It is in the format of

Page 34

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 34

xxxxxx.yyyyyy, with xxxxxx being the 32 high bits and yyyyyy the 32 low bits of the passed milliseconds.

date: Current system date and time, in the form of “yyyy/mm/dd-hh:mm:ss” in

Chinese and “mm/dd/yyyy-hh:mm:ss” in English.

none: No time stamp. info-center trapbuffer Description

Using the info-center timestamp command, you can set the time stamp format for the output debugging/trapping/logging information. Using the undo info- center timestamp command, you can cancel the current configuration.

By default, the date time stamp is used in information of all types.

Example

Set the time stamp format for traps to boot.

[NEC-PHILIPS] info-center timestamp trap boot

info-center trapbuffer Syntax

info-center trapbuffer [ channel { channel-number | channel-name } | size buffersize ] * undo info-center trapbuffer [ channel | size ]

View

System view

Parameter channel: Sets the channel for outputting information to the trapbuffer.

channel-number: Channel number ranging 0 to 9. That is, system has 10

channels.

channel-name: Channel name.

size: Sets trapbuffer size. buffersize: Size of the trapbuffer (the information entries that can be

accommodated).

Description Using the info-center trapbuffer command, you can enable the trapbuffer and set the output channel number and trapbuffer size. Using the undo info-center trapbuffer command, you can cancel the current configuration.

By default, information output to trapbuffer is allowed and the trapbuffer size is

256.

Only when the info-center has been enabled will this command become effective.

By setting a trapbuffer size, you can make the router output information to the trapbuffer.

For related commands, see info-center enable, display info-center, and display info-center trapbuffer.

Page 35

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 35

reset trapbuffer Example

Enable the router to send information to the trapbuffer, given the trapbuffer size is 30.

[NEC-PHILIPS] info-center trapbuffer size 30

reset logbuffer Syntax

reset logbuffer View

User view

Parameter

None

Description Using the reset logbuffer command, you can clear information in the logbuffer.

Example <NEC-PHILIPS> reset logbuffer

reset trapbuffer Syntax

reset trapbuffer View

System view

Parameter

None

Description

Using the reset trapbuffer command, you can clear information in the trapbuffer.

Example <NEC-PHILIPS> reset trapbuffer

service modem-callback Syntax service modem-callback

undo service modem-callback View

System view

Parameter

None

Description Using the service modem-callback command, you can enable user callback. Using the undo service modem-callback command, you can disable user

callback.

By default, the callback function is disabled.

Example

Enable the callback function.

Page 36

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 36

[NEC-PHILIPS] service modem-callback

terminal debugging Syntax

terminal debugging undo terminal debugging

View

User view

Parameter

None

Description

Using the terminal debugging command you can enable the terminal debugging display function. Using the undo terminal debugging command

you can disable the function.

By default, terminal display is disabled.

For related command, see debugging.

Example

Enable terminals to display the debugging information.

<NEC-PHILIPS> terminal debugging

terminal logging Syntax

terminal logging undo terminal logging

View

User view

Parameter

None

Description Using the terminal logging command, you can enable the log display function of terminals. Using the undo terminal logging command, you can disable log

display function of terminals.

By default, the log display function of terminals is enabled.

Example

Disable the log display function of terminals.

<NEC-PHILIPS> undo terminal logging

terminal monitor Syntax

terminal monitor undo terminal monitor

View

User view

Parameter

None

Description

Page 37

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 37

Using the terminal monitor command, you can enable terminals to display the debugging /logging/trapping information sent by the info-center. Using the undo terminal monitor command, you can disable terminals to display the

debugging/logging/trapping information.

By default, the display function of console users is enabled but the display function of terminal users is disabled.

The command only affects the current terminal that inputs it. The undo terminal

monitor command is equivalent to the execution of undo terminal debugging, undo terminal logging, and undo terminal trapping commands, that is, all

the debugging/logging/trapping information will not be displayed at the current

terminal. In the event that terminal monitor has been enabled, the terminal

debugging/undo terminal debugging, terminal logging/undo terminal logging, and terminal trapping/undo terminal trapping commands can be

used to enable/disable the debugging/logging/trapping information.

Example

Disable terminal monitor.

<NEC-PHILIPS> undo terminal monitor

terminal trapping Syntax

terminal trapping undo terminal trapping

View

User view

Parameter

None

Description Using the terminal trapping command, you can enable the function of trap information display at terminals. Using the undo terminal trapping command,

you can disable the function of trap information display at terminals.

By default, the system configuration is to enable the display function.

Example

Disable the trapping information display function.

<NEC-PHILIPS> terminal trapping

Page 38

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 38

3.3 System Operating Management Commands - AR46 Series

boot bootldr Syntax

boot bootldr filename View

System view

Parameter filename: File name of the booting software package.

Description Using the boot bootldr command, you can specify the system booting file.

Example

Specify the file ibox.bin stored in the flash as the default system booting file.

[NEC-PHILIPS] boot bootldr flash:/ibox.bin

display alarm urgent Syntax

display alarm urgent [ time | slot | id ] View

Any view

Parameter time: Displays the alarms in a latest time range. id: Displays the alarms of an ID. slot: Displays the alarms involved a slot. Description

Using the display alarm urgent command, you can display the stored alarms

in a specified way.

Executing the command defined without any parameter will display all the alarms.

Example

Display the stored alarms.

<NEC-PHILIPS> display alarm urgent

Alarm ID Slot Date Time Para1 Para2 2 11 00/04/01 23:55:18 2 24 2 10 00/04/01 23:55:18 1 24 0 12 00/04/04 10:00:14 0 1

Page 39

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 39

display bootvar Syntax

display bootvar View

Any view

Parameter

None

Description Using the display bootvar command, you can display file name of the boot

software package stored in the flash on RPU.

Example

Display the program configuration information of RPU.

<NEC-PHILIPS> display bootvar

Boot file on flash is flash:/ibox.bin.

display environment Syntax

display environment View

Any view

Parameter

None

Description Using the display environment command, you can display the current values

and the threshold values of the hardware system environment.

Example

Display the system environment.

<NEC-PHILIPS> display environment

GET 3 TEMPERATUREPOINT VALUE SUCCESSFULLY environment information: Temperature information: local CurrentTemperature LowLimit HighLimit

(deg c ) (deg c) (deg c ) RPU 34 0 80 VENT 31 0 80

display device Syntax

display device slot-number View

Any view

Parameter slot-number: Slot number.

Description Using the display device command, you can display the system hardware

configuration information, including the in-position states of MPU, NPU, interface card, power module, and fan module, the operating state of interface

Page 40

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 40

card, power module, and fan module, as well as the offline information of MPU and NPU.

Executing the command defined without parameters will display the essential information of all the devices in position. Executing the command defined with

the parameter slot-number will display only the details on the defined slot,

including reset times and history records of the reset causes.

Example

Display the essential information of the router.

<NEC-PHILIPS> display device

Slot # Type Online Status 0 RPU Present Normal 6 PWR Present Normal 7 FAN Present Normal

display schedule reboot Syntax

display schedule reboot View

Any view

Parameter

None

Description Using the display schedule reboot command, you can check the configuration

of related parameters of the router schedule reboot terminal service. For the

related command, see reboot, schedule reboot at, schedule reboot

delay, undo schedule reboot. Example

Display the configuration of the schedule reboot terminal service parameters of the current router.

<NEC-PHILIPS> display schedule reboot

Reboot system at 16:00:00 2002/11/1 (in 2 hours and 5 minutes).

remove slot Syntax

remove slot slotnum undo remove slot slotnum

View

User view

Parameter slotnum: Slot number for the interface card

Description Using the remove slot command, you can run pre-processing before removing an interface card. You can also cancel a misoperation with the undo remove

slot command if you change your mind to remove the card after executing the remove slot command.

The undo remove slot command is unnecessary when you remove a card, but

insert it immediately.

For the related command, see reboot, schedule reboot at, schedule reboot

Page 41

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 41

delay, undo schedule reboot. Example

Remove the interface card at slot 3.

<NEC-PHILIPS>remove slot 3

reset alarm urgent Syntax

reset alarm urgent

View

User view

Parameter

None

Description Using the reset alarm urgent command, you can clear all the stored alarms.

Example

Clear the all the stored alarms.

<NEC-PHILIPS> reset alarm urgent

reset slot Syntax

reset slot slot-number View

User view

Parameter slot-number: The number of the slot to be reset.

Description Using the reset slot command, you can reset the device in a specified slot.

Example

Reset the device in slot 3.

<NEC-PHILIPS> reset slot 3

schedule reboot at Syntax

schedule reboot at hh:mm [ yyyy/mm/dd ] View

User view

Parameter hh:mm: Reboot time of the router, in the format of "hour: minute" The hh ranges

from 0 to 23, and the mm ranges from 0 to 59.

yyyy/mm/dd: Reboot date of the router, in the format of "year/month/day. The

yyyy ranges from 2000 to 2099, the mm ranges from 1 to 12, and the value of dd is related to the specific month.

Page 42

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 42

Description

Using the schedule reboot at command, you can enable the timing reboot

function of the router and set the specific reboot time and date.

By default, the timing reboot router function is disabled.

If the schedule reboot at command sets specified date parameters, which

represents a data in the future, the router will be restarted in specified time, with error not more than 1 minute.

If no specified date parameters are configured, two cases are involved; if the configured time is after the current time, then the router will be restarted at the time point of that day, or if the configured time is before the current time, the router will be restarted at the time point of the next day.

It should be noted that the configured date should not exceed the current date more than 30 days. In addition, after the command is configured, the system will prompt you to input confirmation information. Only after the "Y" or the "y" is entered can the configuration be valid. If there is related configuration before, it will be covered directly.

Moreover, after the schedule reboot at command is configured and the system time is adjusted by the clock command, the former configured schedule reboot

at parameter will go invalid.

For the related command, see reboot, schedule reboot delay, undo

schedule reboot, display schedule reboot. Example

Set the router to be restarted at 22:00 that night (the current time is 15:50).

<NEC-PHILIPS> schedule reboot at 22:00

Reboot scheduled for 22:00:00 UTC 2002/11/18 (in 6 hours and 10 minutes) Proceed with reboot? [Y/N]:y

schedule reboot delay Syntax

schedule reboot delay { hhh:mm | mmm } View

User view

Parameter hhh:mm: Waiting time for rebooting a router, in the format of "hour: minute" The

hhh ranges from 0 to 720, and the mm ranges from 0 to 59.

mmm: Waiting delay for rebooting a router, in the format of "absolute minutes" .

Ranging from 0 to 43200,

Description Using the schedule reboot delay command, you can enable the timing reboot

router function and set the waiting time.

By default, the timing reboot router function is disabled.

Two formats can be used to set the waiting delay of timing reboot router, the format of "hour: minute" and the format of "absolute minutes". But the total minutes should be no more than 30×24×60 minutes, or 30 days.

After this command is configured, the system will prompt you to input confirmation information. Only after the "Y" or the "y" is entered can the

Page 43

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 43

configuration be valid. If there is related configuration before, it will be covered directly.

Moreover, after the schedule reboot at command is configured, and the system time is adjusted by the clock command, the original schedule reboot at

parameter will become invalid.

For the related command, see reboot, schedule reboot at, undo schedule

reboot, display schedule reboot. Example

Configure the router to be restarted after 88 minutes (the current time is 21:32).

<NEC-PHILIPS> schedule reboot delay 88

Reboot scheduled for 23:00:00 UTC 2002/11/1 (in 1 hours and 28 minutes) Proceed with reboot? [Y/N]:y

upgrade Syntax

upgrade [ bootrom | pico-code] filename View

System view

Parameter bootrom: Upgrades the BootROM on line .

pico-code: Upgrades the pico-code on line.

filename: The file name of the upgrade software package to be used. Description

Using the upgrade command, you can upgrade the BootRom program, picocode or the logic.

Example

Upgrade the pico-code on line, given the file name of the upgrade software

package is filename.

[NEC-PHILIPS] upgrade pico-code filename

undo schedule reboot Syntax

undo schedule reboot View

User view

Parameter

None

Description Using the undo schedule reboot command, you can cancel the parameter

configuration of the schedule reboot terminal service.

For the related command, see reboot, schedule reboot at, schedule reboot

delay, display schedule reboot. Example

Cancel the timing reboot router function.

<NEC-PHILIPS> undo schedule reboot

Page 44

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 44

3.4 File Management Commands

File System Commands Syntax

cd directory View

User view

Parameter directory: Name of destination directory.

Description

Using the cd command, you can modify the current operating path of the router

to the specified directory.

By default, the flash memory is the operating path set when the router starts.

Example

Modify the current operating path of the router to test.

<NEC-PHILIPS> cd test <NEC-PHILIPS> pwd flash:/test

clear Syntax

clear filename View

User view

Parameter filename: Name of file to be deleted.

Description

Using the clear command, you can delete all files from the recycle bin. The wildcard “*” is available here. Using the delete command, you can only

move the target files into the recycle bin. If you want to remove them from the

recycle bin, you must use the clear command.

Example

Clear the recycle bin.

<NEC-PHILIPS> clear flash:/p1h_logic.out

clear flash:/plh_logic.out?[Y/N]

copy Syntax

copy filename_source filename_dest View

User view

Parameter

filename_source: Name of the source file. filename_dest: Name of the destination file or directory.

Description Using the copy command, you can copy a file.

Page 45

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 45

If the name of the destination file is the same with an existing directory name, the target file will be copied to the directory. If the name of the destination file is the same with an existing file name, the user will be prompted whether the existing file should be overwritten.

Example <NEC-PHILIPS>pwd

Slave#flash: <NEC-PHILIPS> dir Directory of flash:/

-rwxrwxrwx 1 noone nogroup 4316742 Oct 10 2002 10:10:10 system drwxrwxrwx 1 noone nogroup - Jan 01 2001 10:47:14 buckup

-rwxrwxrwx 1 noone nogroup 16 Jan 02 2001 08:53:52 private-data.t rwxrwxrwx 1 noone nogroup 625 Jan 02 2001 08:54:01 vrpcfg.txt

-rwxrwxrwx 1 noone nogroup 375 Jan 02 2001 08:53:13 config

-rwxrwxrwx 1 noone nogroup 524288 Jan 02 2001 11:47:39 bootromfull 7672832 bytes total (2295808 bytes free)

Copy the file from Flash to buckup..

<NEC-PHILIPS> copy vrpcfg.txt buckup

Copy flash:/vrpcfg.txt to flash:/backup/vrpcfg.txt ?[Y/N]:y % Copied file flash:/vrpcfg.txt to flash:/backup/vrpcfg.txt

<NEC-PHILIPS> dir

Directory of flash:/backup/

-rwxrwxrwx 1 noone nogroup 625 Jan 02 2001 13:28:32 vrpcfg.txt 7672832 bytes total (2295808 bytes free)

delete Syntax

delete /unreserved filename View

User view

Parameter unreserved: Deletes the specified file unreservedly, and the deleted file can

never be restored.

filename: Name of the file to be deleted. Description

Using the delete command, you can move the specified file, which can be restored with the undelete command, to the recycle bin. If you want to delete it from the recycle bin, you can use the reset recycle-bin filename command.

If you delete two files are in different directories but with the same filename, only the last one will be stored in the recycle bin.

If the unreserved parameter is seleted using the delete command, the target file

cannot be restored.

The dir command does not display the information of deleted files. However, by using the dir /all command, the information of all files under the directory,

including deleted files, will be displayed.

Example

Delete the file flash:/test/test.txt.

<NEC-PHILIPS> delete flash:/test/test.txt

Delete flash:/test/test.txt?[Y/N]

Page 46

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 46

<NEC-PHILIPS>

dir Syntax

dir [ /all | /h ] [ filename ] View

User view

Parameter

/all: Displays all files (including the deleted files). /h: Displays the information about the private files. This parameter is

unavailable if there is no storage device on the router.

filename: Name of the file or directory displayed. Description

Using the dir command, you can display the information about the specified file

or directory in the router storage device.

By default, this command displays the file information under the current directory.

This command supports "*" wildcard. The dir /all command can be used to display the information about all the files,

including the deleted files. The names of the deleted files are denoted with "[]",

for instance, [temp.cfg]. Such deleted files can be restored via the undelete command. The reset recycle-bin command can be used to delete the file from

the recycle bin permanently.

The dir /h command can be used to display the information about the private

file under the current path. The attribute of the private file is represented by “--h”.

Example

Display the information about the file flash:/test/test.txt.

<NEC-PHILIPS> dir flash:

Directory of flash:

-rwxrwxrwx 1 noone nogroup 4316742 Oct 10 2002 10:10:10 system

-rwxrwxrwx 1 noone nogroup 16 Jan 01 1970 00:00:57 private-data.txt

-rwxrwxrwx 1 noone nogroup 351 Jan 01 1970 00:01:03 vrpcfg.txt

7672832 bytes total (3351552 bytes free)

execute Syntax

execute filename View

System view

Parameter filename: Name of the batch file, ranging from 1 to 256, with a suffix of “.bat”.

Page 47

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 47

Description

Using the execute command, you can execute the specified batch file. The batch command executes the command lines in the batch file one by one.

There should be no invisible character in the batch file. If invisible characters

are found, the batch command will quit the current execution without back off operation. The batch command does not guarantee the execution of each

command, nor does it perform hot backup itself. The forms and contents of the commands are not restricted in the batch file.

Example

Execute the batch file “test.bat” in the directory of “flash:/”.

NEC-PHILIPS] execute test.bat

file prompt Syntax

file prompt {alert | quiet } View

System view

Parameter alert: Enables interactive acknowledgement on the condition that data loss or

destruction may happen due to user operation (e.g., deleting a file.).

quiet: No prompt on the condition that data loss or destruction may happen due

to user operation (e.g., deleting a file.).

Description Using the file prompt command, you can modify the prompt mode of file

operation of the router.

By default, the prompt mode is alert.

When the prompting mode of file operation is set to quiet, for the possible data loss due to user operation (e.g., deleting a file), the system will have no prompt.

Example

Set the prompt mode of file operation to quiet.

[NEC-PHILIPS] file prompt quiet

# Set the prompt mode of file operation to alert.

[NEC-PHILIPS] file prompt alert

format Syntax

format device-name View

User view

Parameter device-name: Device name.

Description

Using the format command, you can format the storage device.

Formatting will result in loss of all files on a specified storage device and these files cannot be restored.

Page 48

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 48

Example

Format flash.

<NEC-PHILIPS> format flash:

All sectors will be erased, proceed? [Y/N]y Format flash: completed

mkdir Syntax

mkdir directory View

User view

Parameter directory: Name of directory.

Description

Using the mkdir command, you can create a directory under the specified

directory in the specified storage device.

The name of the directory to be created cannot be the same with the names of other directories or files under the specified directory.

Example

Create a directory dd.

<NEC-PHILIPS> mkdir dd

Created dir flash:/dd.

more Syntax

more filename View

User view

Parameter filename: File name.

Description

Using the more command, you can display content of a specified file.

By default, the file system displays the file in the form of text, that is, the contents of the file.

Example

Display the content of the file test.txt.

<NEC-PHILIPS> more test.txt AppWizard has created this test application for

you. This file contains a summary of what you will find in each of the files that make up your test application. Test.dsp This file (the project file) contains information at the project level and is used to build a single project or subproject. Other users can share the project (.dsp) file, but they should export the makefiles locally.

Page 49

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 49

move Syntax

move filename_source filename_dest View

User view

Parameter

filename_source: Name of the source file. filename_dest: Name of the destination file.

Description Using the move command, you can move a file.

If the name of the target file has the same name as an existing directory, the target file will be moved into the directory, with the same file name. If the name of the destination file is the same with an existing file name, the user will be prompted whether the existing file should be overwritten.

Example <NEC-PHILIPS> dir

Directory of * 0 -rw-2145123 Jul 12 2001 12:28:08 ne80.bin 1 -rw- 595 Jul 12 2001 10:47:50 vrpcfg.txt 2 drw- 0 Jul 12 2001 19:41:20 test

6477 KBytes total (2144 KBytes free)

<NEC-PHILIPS> dir flash:/test/

Directory of flash:/test/ 0 drw - Jul 12 2001 20:23:37 subdir 1 -rw- 595 Jul 12 2001 20:13:19 vrpcfg.txt 2 -rw- 50 Jul 12 2001 20:08:32 sample.txt

6477 KBytes total (2144 KBytes free)

# Move the file flash:/test/sample.txt to flash:/sample.txt. <NEC-PHILIPS> move flash:/test/sample.txt flash:/sample.txt Move flash:/test/sample.txt to

flash:/sample.txt ?[Y/N]:y % Moveded file flash:/test/sample.txt flash:/sample.txt

<NEC-PHILIPS> dir

Directory of * 0 -rw-2145123 Jul 12 2001 12:28:08 ne80.bin 1 -rw- 595 Jul 12 2001 10:47:50 vrpcfg.txt 2 drw- 0 Jul 12 2001 19:41:20 test 3 -rw- 50 Jul 12 2001 20:26:48 sample.txt

6477 KBytes total (2144 KBytes free)

<NEC-PHILIPS> dir flash:/test/

Directory of flash:/test/

0 drw-- Jul 12 2001 20:23:37 subdir 1 -rw- 595 Jul 12 2001 20:13:19 vrpcfg.txt 6477 KBytes total (2144 KBytes free)

Page 50

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 50

pwd Sy ntax

pwd View

User view

Parameter

None

Description Using the pwd command, you can display the current path.

If the current path has not been set, the operation will fail.

Example

Display the current path.

<NEC-PHILIPS> pwd

flash:/test

rename Syntax

rename filename_source filename_dest View

User view

Parameter

filename_source: Name of the source file. filename_dest: Name of the destination file.

Description Using the rename command, you can rename a file.

If the name of the destination file is the same with the name of an existing directory, the execution will fail. If the name of the destination file is the same with an existing file, the operation will fail.

Example <NEC-PHILIPS> dir

Directory of * 0 -rw-2145123 Jul 12 2001 12:28:08 ne.bin 1 -rw-595 Jul 12 2001 10:47:50 vrpcfg.txt 2 drw--Jul 12 2001 19:41:20 test 3 -rw- 50 Jul 12 2001 20:26:48 sample.txt 6477 KBytes total (2144 KBytes free)

Rename the file sample.txt to sample.bak.

<NEC-PHILIPS> rename sample.txt sample.bak

Rename flash:/sample.txt to flash:/sample.bak ?[Y/N]:y % Renamed file flash:/sample.txt flash:/sample.bak

NEC-PHILIPS> dir

Directory of * 0 -rw-2145123 Jul 12 2001 12:28:08 ne.bin 1 -rw-595 Jul 12 2001 10:47:50 vrpcfg.txt 2 drw--Jul 12 2001 19:41:20 test 3 -rw- 50 Jul 12 2001 20:29:55 sample.bak

6477 KBytes total (2144 KBytes free)

Page 51

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 51

reset recycle-bin Syntax

reset recycle-bin filename View

User view

Parameter filename: Name of the file to be deleted.

Description

Using the reset recycle-bin command, you can delete a file from the recycle

bin permanently.

This command supports "*" wildcard. The delete command only deletes a file to the recycle bin directory. To delete a file permanently, use the reset recycle-

bin command. Example

Delete a file from the recycle bin.

<NEC-PHILIPS> reset recycle-bin flash:/p1h_logic.out reset

flash:/plh_logic.out?[Y/N]

rmdir Syntax

rmdir directory View

User view

Parameter directory: Name of the directory.

Description

Using the rmdir command, you can delete a directory.

The directory to be deleted must be an empty one.

Example <NEC-PHILIPS>dir

Directory of * 0 drw-- Jul 12 2001 20:23:37 subdir 1 -rw- 595 Jul 12 2001 20:13:19 vrpcfg.txt 6477 KBytes total (2144 KBytes free)

# Display how to delete the directory subdir.

<NEC-PHILIPS> rmdir subdir

Rmdir subdir?[Y/N]:y % Removed directory subdir

<NEC-PHILIPS> dir

Directory of * 0 -rw-595 Jul 12 2001 20:13:19 vrpcfg.txt 6477 KBytes total (5944 KBytes free)

Page 52

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 52

undelete Syntax

undelete filename View

User view

Parameter filename: Name of the file to be restored.

Description

Using the undelete command, you can restore a deleted file.

If the name of the file to be restored is the same as the name of an existing directory, the execution will fail. If the name of this file is the same as that of an existing file, the user will be prompted whether the existing file should be overwritten.

Example <NEC-PHILIPS> dir /all

Directory of * 0 -rw-595 Jul 12 2001 20:13:19 vrpcfg.txt 1 -rw- 50 Jul 12 2001 20:09:23 [sample.bak]

6477 KBytes total (2144 KBytes free)

# Restore the deleted file sample.bak.

<NEC-PHILIPS> undelete sample.bak

Undelete flash:/test/sample.bak ?[Y/N]:y % Undeleted file flash:/test/sample.bak

<NEC-PHILIPS> dir /all

Directory of * 0 -rw- 50 Jul 12 2001 20:34:19 sample.bak 1 -rw-595 Jul 12 2001 20:13:19 vrpcfg.txt 6477 KBytes total (2144 KBytes free)

Page 53

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 53

3.5 FTP Server Configuration Commands

display ftp-server Syntax

display ftp-server View

Any view

Parameter

None

Description Using the display ftp-server command, you can display the parameters of the

current FTP server.

After the FTP parameters are configured, this command can be used to display the configuration results.

Example

Display the FTP parameters configured.

<NEC-PHILIPS> display ftp-server

Ftp server is running Max user number5 User count2 Timeout(minute)30 The information shown above indicates that the FTP server has started and can support up to 5 log-on users simultaneously and now there are two log-on users and the timeout of an FTP user is 30 minutes.

display ftp-user Syntax

display ftp-user View

Any view

Parameter

None

Description Using the display ftp-user command, you can display the parameters of

the current FTP user.

Example

Display the FTP user parameter configuration.

<NEC-PHILIPS> display ftp-user

usernamehost porttopdiridle NEC-PHILIPS 10.110.3.51074c:/NEC-PHILIPS2

The information shown above indicates that a connection between an FTP user named NEC-PHILIPS and the FTP server has been established. the IP address of the remote host is 10.110.3.5 and the remote port number is 1074. the authorization directory is flash:/NEC-PHILIPS and so far the user has not sent any service request to the FTP server for 2 minutes.

Page 54

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 54

ftp server enable Syntax

ftp server enable undo ftp server

View

System view

Parameter

None

Description Using the ftp server enable command, you can enable the FTP server and allow the login of FTP users. Using the undo ftp server command, you can

disable the FTP server and the login of FTP users.

By default, the FTP server is off.

Example

Disable the FTP server.

[NEC-PHILIPS] undo ftp server

ftp timeout Syntax

ftp timeout minute undo ftp timeout

View

System view

Parameter minute: Connection timeout in minutes, in the range of 1 to 35791. By default,

the connection timeout is 30 minutes.

Description Using the ftp timeout command, you can set the connection timeout. Using the undo ftp timeout command, you can restore the default connection timeout.

Once the user logs on the FTP server, he establishes a connection with the FTP server. If an abnormal disconnection occurs or the user abnormally disrupts the connection, FTP server is not notified and thus the connection is still on. To avoid such a problem, the connection timeout should be set. If no command interaction is conducted during this period, FTP will regard the connection failed and disrupt the connection.

Example

Set the connection timeout to 36 minutes.

[NEC-PHILIPS] ftp timeout 36

ftp update Syntax

ftp update { fast | normal } undo ftp update{ fast | normal } View

System view

Parameter fast: Fast upgrading mode.

normal: Normal upgrading mode.

Page 55

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 55

Description Using the ftp update command, you can set the upgrading mode. Using the undo ftp update command, you can restore the default upgrading mode.

By default, the FTP update is in fast mode.

The FTP server updates the data of files in its flash memory in two modes, normal and fast. When receiving files transfered by the user using the FTP command PUT. Each of the two modes is demonstrated respectively as follows:

Fast mode: The FTP server writes the data to the flash memory after the completion of the file transfer. This can safeguard that the files in the flash memory of the Router will not be damaged even on abnormal occasions such as power failure. Normal mode: The FTP server writes the data to the flash memory during the file transfer. This means that the occurence of some abnormal conditions such as power failure might cause the damage of the files in the flash memory of the Router. But the normal updating mode consumes fewer memory.

Example

Set the FTP update mode to normal.

[Router] ftp update normal

Page 56

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 56

3.6 FTP client module commands

ascii Syntax

ascii View

FTP client view

Parameter

None

Description Using the ascii command, you can set the transmission data type to ASCII.

By default, the data type is set to ASCII.

Example

Set the transmission data type to ASCII.

[ftp] ascii 200 Type set to A.

binary Syntax

binary View

FTP client view

Parameter

None

Description Using the binary command, you can set file type to support binary files

transmission.

Example

Set file type to support binary files transmission

[ftp] binary 200 Type set to B.

bye Syntax

bye View

FTP client view

Parameter

None

Description Using the bye command, you can disconnect with remote FTP server and exit

to user view.

Example

Terminate the connection with remote FTP server and exit to user view.

[ftp] bye

Page 57

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 57

<NEC-PHILIPS>

cd Syntax

cd pathname View

FTP client view

Parameter pathname: Path name.

Description

Using the cd command, you can change the operating path on remote FTP

server.

This command can be used to access another directory on FTP server.

Example

Change the operating path to d:/temp. [ftp] cd d:/temp

cdup Syntax cdup View

FTP client view

Parameter

None

Description Using the cdup command, you can change the operating path to the upper

directory.

This command is used to exit current directory and return to an upper directory.

Example

Change the operating path to an upper directory. [ftp] cdup

close Sy ntax

close View

FTP client view

Parameter

None

Description Using the close command, you can terminate the connection with remote FTP

server, but remain in FTP client view.

This command will terminate both control connection and data connection with the remote FTP server simultaneously.

Example

Terminate the connection with the remote FTP server and still keep in FTP client view. [ftp] close [ftp]

Page 58

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 58

debugging Syntax

debugging undo debugging

View

FTP client view

Parameter

None

Description Using the debugging command, you can enable the debugging. Using the undo debugging command, you can disable the debugging.

By default, the debugging of FTP client commands is disabled.

Example

Enable the debugging.

[ftp] debugging

delete Syntax

delete remotefile View

FTP client view

Parameter remotefile: File name.

Description Using the delete command, you can delete a specified file.

Example

Delete temp.c.

[ftp] delete temp.c

dir Syntax

dir [ filename ] [ localfile ] View

FTP client view

Parameter filename: File name queried.

localfile: Local file name saved. Description

Using the dir command, you can query a specified file.

This command displays all the files under the directory or the file queried.

Example

Query temp.c and save the query result in temp1. [ftp]

dir temp.c temp1

Page 59

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 59

disconnect Syntax disconnect

View

FTP client view

Parameter

None

Description Using the disconnect command, you can terminate the connection with

the remote FTP server and still keep in FTP client view.

This command will terminate both control connection and data connection with the remote FTP server.

Example

Terminate the connection with the remote FTP server and still keep in FTP client view.

[ftp] disconnect [ftp]

ftp Syntax

ftp [host [ port ] ] View

User view

Parameter host: IP address or hostname of the remote FTP server.

port: Port number of the remote FTP server. Description

Using the ftp command, you can establish control connection with the remote

FTP server and enter FTP client view.

Example

Connect to the remote FTP server with the IP address of 1.1.1.1.

<NEC-PHILIPS>

ftp 1.1.1.1

get Syntax

get remotefile [ localfile ] View

FTP client view

Parameter localfile: Local file name.

remotefile: File name on the remote FTP server. Description

Using the get command, you can download remote files and save them locally.

By default, if the local file name is not specified, this command will consider that it is the same with that of the file on the remote FTP server.

Page 60

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 60

Example

Download temp1.c and save it as temp.c.

[ftp] get temp1.c temp.c

lcd Syntax

lcd View

FTP client view

Parameter

None

Description Using the lcd command, you can get the local operating path of FTP client.

Example

Display local operating path.

[ftp] lcd % Local directory now flash:

ls Syntax

ls [ remotefile ] [ localfile ] View

FTP client view

Parameter remotefile: Remote file queried. localfile: Local file name saved.

Description

Using the ls command, you can query a specified file.

By default, all the files will be displayed when there is no parameter.

Example

Query temp.c. [ftp] ls temp.c

mkdir Syntax

mkdir pathname View

FTP client view

Parameter pathname: Directory name.

Description

Using the mkdir command, you can establish a directory at the remote FTP

server.

Page 61

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 61

Example

Establish test directory at the remote FTP server. [ftp] mkdir test

open Syntax

open ipaddr [ port ] View

FTP client view

Parameter ipaddr: IP address of the remote FTP server.

port: Port number of the remote FTP server. Description

Using the open command, you can establish control connection with the remote

FTP server.

Example

Establish FTP connection with the FTP server of the host 10.110.3.1.

[ftp] open 10.110.3.1

passive Syntax

passive undo passive

View

FTP client view

Parameter

None

Description Using the passive command, you can set data transmission mode to passive mode. Using the undo passive command, you can set data transmission mode

to active mode.

By default, the transmission mode is passive.

Example

Set data transmission mode to passive mode. [ftp] passive

put Syntax

put localfile [ remotefile ] View

FTP client view

Parameter localfile: Local file name.

remotefile: File name on the remote FTP server. Description

Using the put command, you can upload a local file to the remote FTP server.

Page 62

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 62

If no file name on the remote server is specified, this command will consider that it is the same with that of the local file.

Example

Upload local file temp.c to the remote FTP server and save it as temp1.c.

[ftp] put temp.c temp1.c

pwd Syntax

pwd View

FTP client view

Parameter

None

Description Using the pwd command, you can display the working directory on the remote

FTP server.

Example

Display the working directory on the remote FTP server.

[ftp] pwd

"d:/temp" is current directory.

quit Syntax

quit View

FTP client view

Parameter

None

Description Using the quit command, you can terminate the connection with the remote

FTP server and exit to user view.

Example

Terminate the connection with the remote FTP server and exit to user view.

[ftp] quit

<NEC-PHILIPS>

remotehelp Syntax

remotehelp [ protocol-command ] View

FTP client view

Parameter protocol-command: FTP command.

Page 63

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 63

Description Using the remotehelp command, you can display the help of FTP command.

Example

Display the syntax of the command user.

[ftp] remotehelp user

214 Syntax: USER <sp> <username>

rmdir Syntax

rmdir pathname View

FTP client view

Parameter pathname: Directory name on the remote FTP server.

Description Using the rmdir command, you can delete a specified directory on FTP server.

Example

Delete d:/temp1 directory on FTP server.

[ftp] rmdir d:/temp1

user Syntax

user username [ password ] View

FTP client view

Parameter

username: Logon user name. password: Logon password.

Description Using the user command, you can register FTP user.

Example

Log on FTP server with the user name tom and the password bjhw.

[ftp] user tom bjhw

verbose Syntax

verbose undo verbose

View

FTP client view

Parameter

None

Description Using the verbose command, you can enable the verbose function to view

Page 64

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 64

information from FTP server. Using the undo verbose command, you can

disable the verbose function.

By default, it is disabled.

Example

Enable the verbose function.

[ftp] verbose

3.7 TFTP Configuration Commands

tftp Syntax

tftp ip_address { get | put } source-filename [ destination-filename ] View

User view

Parameter

p_address: IP address of TFTP server. source-filename: Source file name. destination-filename: Destination file name.

get: Downloads files. put: Uploads files.

Description

Using the tftp command, you can upload files to a TFTP server or downloads

files to the local.

For related command, see tftp-server acl.

Example

Download the file vrpcfg.txt in the root directory of the TFTP server at 1.1.254.2 to the local hardware and save it as vrpcfg.bak.

<NEC-PHILIPS> tftp 1.1.254.2 get vrpcfg.txt flash:/vrpcfg.bak

Upload the file vrpcfg.txt stored in the root directory of the flash onto the default directory on the TFTP server at 1.1.254.2 and save the file on the server as vrpcfg.bak.

<NEC-PHILIPS> tftp 1.1.254.2 put flash:/vrpcfg.txt vrpcfg.bak

tftp-server acl Syntax

tftp-server acl acl-number View

System view

Parameter acl-number: IP ACL number in the range of 1 to 99.

Page 65

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 65

Description

Using the tftp-server acl command, you can set the number of ACL permitting

the access to a TFTP server.

For related command, see tftp.

Example

Set the number of ACL permitting the access to the TFTP Server to 1.

[NEC-PHILIPS] tftp-server acl 1

3.8 Configuration Files Management Commands

display current- Syntax configuration display current-configuration [ controller | interface interface-type [

View

Any view

Parameter controller: Displays the configuration of controller.

interface: Displays the configuration of the interface.

interface-type: Interface type. interface-number: Interface number

configuration: Displays the specified configurations. rip: Displays the RIP configuration. ospf: Displays the OSPF configuration. bgp: Displays the BGP configuration. post-system: Displays the greeting message configuration. system: Displays the system configuration.

user-interface: Displays the user interface configuration.

|: Uses regular expression to filter the router configurations. begin: Displays the configurations beginning with the specified characters

(string).

include: Displays the configurations including the specified characters (string). exclude: Displays the configurations excluding the specified characters (string). string: Characters of the regular expression.

Page 66

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 66

Description

Using the display current-configuration command, you can display the

current configurations of router.

The current configuration parameters that take the default values will not be displayed.

After finishing a set of configurations, the user can execute the display current- configuration command to view the currently effective parameters for the

purpose of verifying the correctness of the configurations. Some parameters that the user has configured will not be displayed if their functions have not become valid yet. For example, the user can configure PPP parameters on an interface encapsulated with X.25 at the link layer, but he will not be able to see

the PPP configuration information on the interface after executing the display current-configuration command.

For related commands, see save, reset saved-configuration, and display

saved-configuration. Example

Display the currently effective configuration parameters of the router.

<NEC-PHILIPS> display current-configuration

sysname R1760 super password level 3 simple 123456 tcp window 8 # undo multicast igmp-all-enable # interface Aux0 link-protocol ppp # interface Ethernet0/0/0 # interface Serial0/0/0 link-protocol ppp # interface NULL0 # bgp 15535 undo synchronization # # ospf 2 router-id 1.1.1.1 # rip # user-interface con 0 set authentication password simple 123456 history-command max-size 30 user-interface aux 0 user-interface vty 0 4 # return

display Syntax

saved-configuration display saved-configuration

Page 67

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 67

View

Any view

Parameter

None

Description Using the display saved-configuration command, you can display the saved

router configurations, that is, the configurations that the router will apply the next time it is booted.

For related commands, see save, reset saved-configuration, and display

current-configuration. Example

Display the router configuration file in the storage device.

<NEC-PHILIPS> display saved-configuration

# sysname NEC-PHILIPS # tcp window 8 # undo multicast igmp-all-enable # controller E1 3/0/0 # interface Aux0

link-protocol ppp # interface Ethernet0/0/0 # interface Serial0/0 link-protocol ppp # interface NULL0 # user-interface con 0 user-interface aux 0 user-interface vty 0 4 # return

display this Syntax

display this View

Any view

Parameter

None

Description Using the display this command, you can display the current configurations

under this view.

Example

Display the current configuration of the view in question.

<NEC-PHILIPS> display this

Page 68

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 68

# sysname NEC-PHILIPS # tcp window 8 #

reset saved-configuration Syntax

reset saved-configuration View

User view

Parameter

None

Description

Using the reset saved-configuration command, you can erase the saved

router configuration.

You are recommended to use this command only when necessary and under the guidance of the support technician.

This command is likely to be used when: A used router is applied to a new application environment and the existing configuration file cannot meet the requirements of the new environment. In this case, you need to erase the existing configuration file and reconfigure the router.

For related commands, see save, display current-configuration, display

saved-configuration. Example

Erase the saved router configuration.

<NEC-PHILIPS> reset saved-configuration

This will erase the configuration in the device. The Router configurations will be erased to reconfigure! Are you sure?[Y/N]y

save Syntax

save[file-name ] View

User view

Parameter file-name: Filename, whose extension must be cfg

Description Using the save command, you can save the current configuration information

into the storage device.

After you finish a set of configurations and make their functions valid, you should save the current configuration file into the storage device.

For related commands, see reset saved-configuration, display current-

configuration, and display saved-configuration. Example

Save the current configuration information in the default storage device. <NEC-

Page 69

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 69

PHILIPS> save

upgrade Syntax

upgrade bootrom [ full ] View

User view

Parameter bootrom: Upgrades the BootRom program.

full: Upgrades the entire BootRom. Description

Using the upgrade command, you can upgrade the bootrom program.

NEC-PHILIPS Routers support online BootROM upgrade. You can upgrade the BootROM online by extracting the BootROM program from the upgrade software package and writing it into the BootROM.

When executing this command, you should make sure that the upgrade software package (named bootromfull) has existed in the root directory of the flash.

Example

Upgrade the BootROM program of R1760 Router, given that the upgrade software package has been stored in the root directory of the flash and the file name is “bootromfull”.

<NEC-PHILIPS> upgrade bootrom full

3.9 User Interface Configuration Commands

acl Syntax

acl acl-number { inbound | outbound } undo acl { inbound | outbound }

View

User interface view

Parameter acl-number: Address access control list number.

inbound: Restricts incoming calls of a user interface. outbound: Restricts outgoing calls of a user interface. Description

Using the acl command, you can reference an ACL to restrict the rights of VTY

(Telnet or SSH) and other types of user interfaces in placing incoming and

outgoing calls. Using the undo acl command, you can remove the current

settings.

By default, there is no incoming or outgoing call barring.

acl-number can only be the basic ACL.

Page 70

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 70

Example

Remove the restriction on Telnet outgoing calls.

[NEC-PHILIPS-ui-vty0] undo acl outbound

authentication-mode Syntax

authentication-mode { local | password | scheme { list | default } } authentication-mode none

View

User interface view

Parameter local: Performs local database authentication.

password: Performs local password authentication. scheme: Performs AAA authorization authentication. default: Uses the default authentication parameter. list: Uses the authentication list. none: Performs no authentication. Description

Using the authentication-mode command, you can set the mode that a user interface uses to authenticate the login users. Using the authentication-mode none command, you can set the authentication mode to none, that is, the login

users need not undergo authentication before they access the user interface.

By default, the authentication mode is set to password for the VTY user interface and none for other user interfaces.

For related command, see set authentication password.

Example

Enable local password authentication.

[NEC-PHILIPS-ui0] authentication-mode password

auto-execute command Syntax

auto-execute command command undo auto-execute command

View

User interface view

Parameter command:

Command to be automatically executed.

Description

Using the auto-execute command command, you can set a command to be automatically executed. Using the undo auto-execute command command,

you can disable the automatic execution of the command.

By default, command auto-execution is disabled.

You should be aware of the following constraints before using the auto-execute

Page 71

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 71

command command:

■ CON does not support auto-execute command.

■ If there is only AUX but no CON on a router (AUX and CON shares the

same port), the AUX will not support auto-execute command as well.

These constraints do not apply to other types of user interfaces.

When a user logs on, some command configured using auto-execute

command on the terminal will automatically be executed. The user connection will be disconnected automatically once the execution of the command is finished.

A common approach is to configure the Telnet command using the auto- execute command command on the terminal so that the user may

automatically connect to the specified host.

You should use this command with caution because it will probably make you unable to make the regular system configurations via this user interface.

CAUTION: Before configuring the auto-execute command command and saving the configuration (by executing the save command), you should make sure that you can access the system t o remove the configuration by other means.

Example

Execute the telnet 10.110.100.1 command automatically after the user logs on from the AUX interface.

[NEC-PHILIPS-ui-aux0] auto-execute command telnet 10.110.100.1

databits Syntax databits { 5 | 6 | 7 | 8 }

undo databits View

User interface view

Parameter 5: Five data bits.

6: Six data bits. 7: Seven data bits. 8: Eight data bits. Description

Using the databits command, you can set user interface data bit. Using the undo databits command, you can restore the default data bit setting.

By default, data bit is set to 8.

The configuration can take effect only when the serial interface works in the asynchronous flow mode.

Example

Set data bit to 5.

[NEC-PHILIPS-ui-aux0] databits 5

Page 72

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 72

debugging vty Syntax

debugging vty { fsm | negotiate } undo debugging vty { fsm | negotiate }

View

User view

Parameter fsm: Debugging of the Telnet state machine.

negotiate: Debugging of the VTY negotiation. Description

Using the debugging vty command, you can enable the debugging of the VTY. Using the undo debugging vty command you can disable the debugging of the

VTY protocol.

Example

Enable the debugging of the VTY negotiation.

<NEC-PHILIPS> debugging vty negotiate

display user-interface Syntax

display user-interface [ type-name ] [ number ] View

Any view

Parameter type-name: Name of user interface type.

number: Number of user interface. Description

Using the display user-interface command, you can display the details of user

interface.

Example

Display information of user interface 0.

<NEC-PHILIPS> display user-interface 0

Idx Type Tx/Rx Modem Privi Auth * 0 CON 0 9600 3 N * : Current user-interface is active. I : Current user-interface is active and work in async mode. Idx : Absolute index of user-interface. Type : Type and relative index of user-interface. Privi: The privilege of user-interface. Auth : The authentication mode of user-interface. A: Authenticate use AAA. L: Authenticate use local database. N: Current user-interface need not authentication. P: Authenticate use current UI's password.

display users Syntax

display users [ all ]

Page 73

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 73

View

Any view

Parameter all: Displays the information of all the user interface users.

Description

Using the display users command, you can display the login information of the

users on each user interface.

Example

Execute display users on the console.

<NEC-PHILIPS> display users

UI Delay IPaddressUsername * 0 CON 000:00:00 * 1 VTY 000:00:0910.110.101.39dd

Where, *: Terminal line in use.

UI: The first number and the second number are respectively the absolute

number and relative number of user interface.

Username: Display the name of the user using this user-interface, namely the

username that the user uses for accessing. As AAA authentication is unavailable yet, this item is null so far.

Delay: In minutes, it is the interval since the last input made by the user. IP address: Displays the starting connection location, namely, IP address of the

call-in host.

flow-control Syntax

flow-control { hardware | software | none } undo flow-control

View

User interface view

Parameter none: No flow control.

software: Software flow control. hardware: Hardware flow control , only be effective to AUX port. Description

Using the flow-control command, you can configure flow control mode. Using the undo flow-control command, you can restore the default flow control mode.

By default, none mode is used, that is, there is no flow control.

The configuration can become effective only when the involved serial interface works in the asynchronous flow mode.

When system is outputting, pressing <Ctrl+s> will stop the screen output, and <Ctrl+q> will resume the screen output.

Page 74

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 74

Example

Configure software flow control in user interface view.

[NEC-PHILIPS-ui-console0] flow-control software

free user-interface Syntax free user-interface [type-name] number

View

User view

Parameter type-name: User interface type.

number: Absolute/Relative user interface number. Description

Using the free user-interface number command, you can clear the user interface with the number defined by the parameter number. Using the free user-interface type-name number command, you can clear the user interface

with the number defined by number in the user interfaces of the type defined by type-name.

Example

Clear user-interface 0.

<NEC-PHILIPS> free user-interface 0

history-command Syntax max-size history-command max-size size-value

undo history-command max-size View

User interface view

Parameter size-value: History buffer size, which is in the range of 0 to 256 and defaults to

10, that is, up to ten history commands can be stored.

Description Using the history-command max-size command, you can set the history command buffer size. Using the undo history-command max-size command,

you can restore the default history command buffer size.

Example

Set size of the history command buffer to 20.

[NEC-PHILIPS-ui-console0] history-command max-size 20

idle-timeout Syntax

idle-timeout minutes [ seconds ] undo idle-timeout

View

User interface view

Parameter minutes: Number of minutes, in the range of 0 to 35791. seconds: Number of

seconds, in the range of 0 to 59.

Page 75

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 75

Description

Using the idle-timeout command, you can set time interval for timed disconnection. Using the undo idle-timeout command, you can restore the

default time value of timed disconnection.

The time interval for timed disconnection defaults to ten minutes.

Setting the time value to 0 will disable the timed disconnection, in which case a connection will not be cut off upon the expiration of preset time interval.

Example

Set the time interval for timed disconnection to one minute and 30 seconds.

[NEC-PHILIPS-ui-console0] idle-timeout 1 30

modem Syntax

modem [ call-in | both ] undo modem [ call-in | both ]

View

User interface view

Parameter call-in: Allows incoming calls.

both: Allows both incoming and outgoing calls. Description

Using the modem command, you can set the incoming/outgoing call attributes with Modem. Using the undo modem command, you can disable incoming and

outgoing calls.

By default, both incoming and outgoing calls are allowed.

When executed without any parameters, the modem command enables both

incoming and outgoing calls.

When executed without any parameters, the undo modem command disables

both incoming and outgoing calls.

This command is only available for the AUX interface and other asynchronous interface, but not for Console port.

Example

Set Modem dialup at asynchronous serial ports.

[NEC-PHILIPS-ui-tty] modem

modem auto-answer Syntax

modem auto-answer undo modem auto-answer

View

User interface view

Parameter

None

Description

Page 76

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 76

Using the modem auto-answer command, you can set the answering mode to auto-answer. Using the undo modem auto-answer command, you can set the

answering mode to manual answer.

By default, the answering mode is manual answer.

This command is valid for the AUX interface and other asynchronous interfaces but not for the console interface.

When taking the modem dial-up connection approach, the user should first set the modem parameters on the involved user interface.

Example

Set the answering mode to auto-answer.

[NEC-PHILIPS-ui-aux0] modem auto-answer

modem timer answer Syntax

modem timer answer seconds undo modem timer answer

View

User interface view

Parameter seconds: Timeout time in the range of 1 to 60 seconds.

Description Using the modem timer answer command, you can set the timeout time

waiting for the carrier signal after the off-hook action for setting up an inbound

connection. Using the undo modem timer answer command, you can restore

the default waiting timeout time.

The waiting timeout time defaults to 30 seconds.

This command is valid for the AUX interface and other asynchronous interfaces but not for the console interface.

Example

None

parity Syntax

parity { none | even | odd | mark | space } undo parity

View

User interface view

Parameter none: Implements no check. even: Implements even parity check. odd: Implements odd parity check. mark: Implements mark check. space: Implements space check.

Page 77

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 77

Description

Using the parity command, you can set the check bit of a user interface. Using the undo parity command, you can restore the check mode of user interface to

none.

By default, no check is performed.

The configuration can become effective only when the involved serial interface works in the asynchronous flow mode.

Example

Set the transmission check bit on AUX interface to odd parity.

[NEC-PHILIPS-ui-aux0] parity odd

redirect Syntax

redirect undo redirect

View

User interface view

Parameter

None

Description Using the redirect command, you can set the redirection function, which is only

valid for the AUX and TTY user interfaces, on an asynchronous port. Using the

undo redirect command, you can disable the rediction function on the involved

port.

By default, the system does not support redirection.

This command is only valid for the AUX and the TTY user interfaces. For

example, executing the redirect command on a TTY user interface will enable

the redirection function of the user interface.

For related commands, see telnet and display tcp status. Example

Enable the redirection function of user interface TTY7.

[NEC-PHILIPS-ui-tty7] redirect

screen-length Syntax

screen-length screen-length undo screen-length

View

User interface view

Parameter screen-length: Number of rows displayed in a screen in the event of split screen

display, which is in the range of 0 to 512.

Description

Using the screen-length command, you can set the number of rows displayed in one screen at the terminal. Using the undo screen-length command, you

can restore the number of rows in a terminal screen to 24.

Page 78

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 78

By default, the number of rows in one screen is 24.

screen-length 0 indicates to disable the split screen function.

Example

Set the number of rows in one screen of the terminal to 30. [

NEC-PHILIPS-ui-console0] screen-length 30

send Syntax

send [ number | all | type-name number ] View

User view

Parameter all: Sends messages to all user interfaces.

type-name: Name of user interface type. number: Absolute/Relative user interface number.

Description Using the send command, you can transfer messages between user interfaces.

Using the send all command, you can send messages to all user-interfaces. Using the send number command, you can send messages to the user

interface defined by specifying its number.

Using the send type-name number command, you can send messages to the

user interface of type-name with specified number.

Example

Send messages to the console user-interface.

<NEC-PHILIPS> send con 0

Enter message, end with CTRL+Z or Enter; abort with CTRL+C: Hello,good morning! Send message? [Y/N]

set authentication Syntax password set authentication password { simple | cipher } password

undo set authentication password View

User interface view

Parameter simple: Plain text password. cipher: Encrypted password. password: If password form is set to simple, the parameter password must be

in plain text. If the password form is set to cipher, the password can be either in encrypted text or in plain text depending on what has been input. A plain-text password can be a string of no more than 16 consecutive characters, 1234567

Page 79

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 79

for example. An encrypted password, however, must be of 24 characters in length and must be in ciphertext, _(TT8F]Y\5SQ=^Q`MAF4<1!! for example.

Description Using the set authentication password command, you can set a local authentication password. Using the undo set authentication password

command, you can remove the local authentication password.

Regardless of whether the password format is set to plain text or ciphertext, a user must input plain text password during the authentication.

When configuring a password, you must specify its format to simple or cipher. If the former has been specified, the password saved in the configuration file will be in plain text. If the latter is specified, however, the password will be displayed in ciphertext regardless of whether the password you enter is a simple password of 1 to 16 bytes or an encrypted password of 24 bytes.

By default, Telnet users are required to undergo login password authentication

(which can be set by using the authentication-mode password command). If

no password has been configured, the following information will be displayed:

■ password required, but none set

For related command, see authentication-mode.

Example

Set the local authentication password for the user interfaces vtys 0 to 4 to "NEC-PHILIPS".

[NEC-PHILIPS-ui-vty0-4] authentication-mode pass word [NEC-PHILIPS-ui-vty0-4] set authentication password simple NEC-PHILIPS

shell Syntax

shell undo shell

View

User interface view

Parameter

None

Description Using the shell command, you can enable terminal services on a user interface. Using the undo shell command, you can remove the current setting.

By default, the terminal services are enabled on all the user interfaces.

Some constraints are put on the undo shell command. First, CON does not

support this command. Second, if there is only AUX but no CON on a router (AUX and CON shares the same port), the AUX will not support this command as well. These constraints do not apply to other types of user interfaces.

Example

Disable terminal services on the virtual terminals (VTYs) 0 to 4.

[NEC-PHILIPS] user-interface vty 0 4 [NEC-PHILIPS-ui-vty0-4] undo shell

The following information will be displayed for a login Telnet terminal:

Page 80

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 80

% connection refused by remote host!

speed Syntax

speed speed-value undo speed

View

User interface view

Parameter speed-value: Transmission rate in bps.

Description Using the speed command, you can set the transmission rate of a user interface. Using the undo speed command, you can restore the default

transmission rate of the user interface.

By default, the transmission rate is 9600bps.

Only when the serial interface works in asynchronous flow mode will the configuration be effective.

The transmission rates supported by asynchronous serial interfaces include:

■ 300bps

■ 600bps

■ 1200bps

■ 4800bps

■ 9600bps

■ 19200bps

■ 38400bps

■ 57600bps

■ 115200bps

Example

Set the transmission rate of the user interface to 19200bps.

[NEC-PHILIPS-ui-vty0] speed 19200

stopbits Syntax

stopbits { 1.5 | 1 | 2 } undo stopbits

View

User interface view

Parameter

1.5: Sets the stop bit to 1.5.

1: Sets the stop bit to 1. 2: Sets the stop bit to 2.

Description

Using the stopbits command, you can set the stop bit of a user interface. Using the undo stopbits command, you can restore the default stop bit of the user

interface.

By default, the stop bit is set to 1.

Page 81

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 81

Only when the serial interface works in asynchronous flow mode will the configuration be effective.

Example

Set the stop bit to 1.5.

[NEC-PHILIPS-ui-vty0] stopbits 1.5

user privilege Syntax

user privilege level level undo user privilege level

View

User interface view

Parameter level: Command level in the range of 0 to 3.

Description

Using the user privilege command, you can configure the command accessing

level commensurate with the users accessing the system from the current user

interface. Using the undo user privilege command, you can disable the current

setting.

By default, the default command accessing levels of CON user interface and

other user interfaces have been set to 3 and 0.

If the command accessing level assigned to a user interface conflicts with the precedence level assigned to the used username in the granted rights, the rights commensurate with the username will be preferred. For example, the precedence of the user 007 allows 007 to access level-3 commands and the privilege level assigned to the user interface VTY 0 only allows the login users to access level-2 commands. If 007 accesses the system from VTY0 in this case, it will be able to access the commands of level-3 and lower levels.

Example

Assign the users accessing the system from the user interface with the privilege allowing them to access level-2 commands.

[NEC-PHILIPS-ui-vty0] user privilege level 2

After the user accesses the router from vty 0 via Telnet, the terminal will display: <NEC-PHILIPS>

user-interface Syntax

user-interface [ type-keyword ] user-interfac e-number [ ending-userinterface-number ]

View

System view

Parameter

type-keyword: Type name of user-interface. user-interface-number: The first user-interface to be configured. ending- user-interface-number: The last user-interface to be configured.

Description Using the user-interface command, you can enter the single-user interface

Page 82

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 82

view or multi-user interface view.

Example

Enter the user-interface console 0 view to configure console 0.

[NEC-PHILIPS] user-interface console 0

[NEC-PHILIPS-ui-console0]

Enter the user-interface vty 0 view to configure vty 0.

[NEC-PHILIPS] user-interface vty 0

[NEC-PHILIPS-ui-vty0]

Enter the user-interface vty view to configure user-interfaces vtys 0 through 3.

[NEC-PHILIPS] user-interface vty 0 3

[NEC-PHILIPS-ui-vty0-3]

enter the user-interface view to configure user-interfaces 0 through 4, including of console port type, of AUX interface type and of VTY interface type. The user interface types will be configured depending on the configuration interface available on the router.

The following example configures one console user interface and three VTY user interfaces, which may be right for the case where the router does not provide the AUX interface.

[NEC-PHILIPS] user-interface 0 3

[NEC-PHILIPS-ui0-3]

debugging ntp-service Syntax

debugging ntp-service { access | adjustment | authentication | event | filter | packet | parameter | refclock | selection | synchronization | validity | all }

undo debugging ntp-service { access | adjustment | authentication | event | filter | packet | parameter | refclock | selection | synchronization | validity | all }

View

User view

Parameter access: NTP access control debugging. adjustment: NTP clock adjustment debugging. all: All the NTP information debugging. authentication: NTP identification authentication debugging. event: NTP event debugging. filter: NTP filter information debugging. packet: NTP packet debugging. parameter: NTP clock parameter debugging. refclock: NTP reference clock debugging.

Page 83

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 83

selection: NTP clock selection information debugging. synchronization: NTP clock synchronous information debugging. validity: Validity debugging of NTP remote host. Description

Using the debugging ntp-service command, you can enable debugging of all types of NTP service information. Using the undo debugging ntp-service

command, you can disable NTP service debugging.

By default, all the information debugging is disabled.

Example

Enable the ntp access control debugging.

<NEC-PHILIPS> debugging ntp-service access

display ntp-service Syntax sessions display ntp-service sessions [ verbose ]

View

Any view

Parameter verbose: Displays the detailed information of sessions.

Description

Using the display ntp-service sessions command, you can display the status

of all the sessions maintained by the local device ntp.

By default, the status of all the sessions maintained by the local device NTP is displayed.

The command without parameter verbose will display the brief information of all the sessions maintained by the local device NTP.

The command with parameter verbose will display the detailed information of all the sessions maintained by the local device NTP.

Example

Display the brief information of all the sessions maintained by the local device NTP

<NEC-PHILIPS> display ntp-service sessions

sourcerefidstnowpollreachdelayoffsetdis ****************************************************************** [12345]1.0.1.11LOCAL(0)316437726.1199.539.7 note: 1 source(master),2 source(peer),3 selected,4 candidate,5 configured

display ntp-service status Syntax

display ntp-service status View

Any view

Page 84

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 84

Parameter

None

Description

Using the display ntp-service status command, you can display the

state information of the NTP service.

Example <NEC-PHILIPS> display ntp-service status

clock status: unsynchronized clock stratum: 16 reference clock ID: none nominal frequency: 100.0000 Hz actual frequency: 100.0000 Hz clock precision: 2^18 clock offset: 0.0000 ms root delay: 0.00 ms root dispersion: 0.00 ms peer dispersion: 0.00 ms reference time: 00:00:00.000 UTC Jan 1 1900(00000000.00000000)

Description of the display information is shown in the following table.

Table 3 Stating information of the NTP service

Display information

Description

synchronized Indicate that the local system is synchronized to a

remote NTP server or a clock source

unsynchronized Indicate that the local system is not synchronized to any

remote NTP server stratum The NTP stratum of the local system reference If the local system has been synchronized to a remote

NTP server or a clock source, it indicates the address

of the remote server or clock source ID

nominal freq Nominal frequency of the hardware clock of the local

system actual freq Actual frequency of the hardware clock of the local

system precision Precision of the local system clock

reftime Reference timestamp offset Offset of the NTP server relative to the local clock root delay Overall delay from the local to the master reference

clock root disper Dispersion of the local master reference clock

peer disper Dispersion of the remote NTP server

display ntp-service trace Syntax

display ntp-service trace [ X.X.X.X ] View

Any view

Parameter X.X.X.X: The IP address of the NTP server functioning as the reference clock

source.

Description Using the display ntp-service trace command, you can display the summary

Page 85

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 85

information of each NTP time server from the local device tracing to the reference clock source.

This command is used to trace to the reference clock source from the local device along the time synchronous NTP server chain and display the summary information of each NTP server.

Example <NEC-PHILIPS> display ntp-service trace

server4: stratum 4, offset 0.0019529, synch distance 0.144135 server3: stratum 3, offset 0.0124263, synch distance 0.115784 server2: stratum 2, offset 0.0019298, synch distance 0.011993 server1: stratum 1, offset 0.0019298, synch distance 0.011993 refid 'GPS Reciever'

The above information displays the synchronous chain of server4. It indicates that server 4 can be synchronized to server 3, server 3 to server 2 and server 2 to server 1. Server 1 is synchronized from the reference clock source GPS Receiver.

ntp-service access Syntax

ntp-service access { query | synchronization | server | peer } acl-number undo ntp-service access { query | synchronization | server | peer }

View

System view

Parameter query: Query authority is limited. synchronization: Only the server is permitted to access. server: Allows the server to perform access and query. peer: Absolute access.

acl-number: IP address access list number in the range of 1 to 99.

Description Using the ntp-service access command, you can set the access control authority of the local device services. Using the undo ntp-service access

command, you can remove the access control authority that has been set.

By default, there is no access authority.

This command is used to set the access authority of the NTP service of the local device. A security approach of minimum authority is provided in this manual. The more secure approach is to perform ID authentication. When there is an access request, this command can be used to make the matches in sequence from minimum access authority to the maximum authority. All matches are based on the first match. The match order is peer, server, synchronization, query.

Example

Enable the peer in No.76 access list to perform time request, query control and time synchronization on the local device.

[NEC-PHILIPS] ntp-service access peer 76

Page 86

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 86

Enable the peer in No.28 access list to perform time request, query control on the local device.

[NEC-PHILIPS] ntp-service access server 28

ntp-service Syntax authentication enable ntp-service authentication enable

undo ntp-service authentication enable View

System view

Parameter

None

Description Using the ntp-service authentication enable command, you can set NTPservice ID authentication. Using the undo ntp-service authentication enable

command, you can remove NTP-service ID authentication.

By default, no ID authentication is set.

Example

Enable NTP ID authentication.

[NEC-PHILIPS] ntp-service authentication enable

ntp-service - Syntax authentication keyid ntp-service authentication-keyid number authentication-mode md5 v alue

undo ntp-service authentication-keyid number View

System view

Parameter number: Key number in the range of 1 to 4294967295. value: Key itself that is represented with 1 to 32 ASCII characters. Description

Using the ntp-service authentication-keyid command, you can set NTP authentication key. Using the undo ntp-service authentication-keyid

command, you can remove NTP authentication key.

By default, no authentication key is set.

This command is used to set NTP authentication key, which only supports MD5 authentication.

Example

Set MD5 ID authentication key. The key ID number is 10 and the key is BetterKey.

[NEC-PHILIPS] ntp-service authentication-keyid 10 authentica tion-mode md5 BetterKey

Page 87

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 87

ntp-service broadcast- Syntax client ntp-service broadcast-client

undo ntp-service broadcast-client View

Interface view

Parameter

None

Description Using the ntp-service broadcast-client command, you can configure the NTP broadcast client mode. Using the undo ntp-service broadcast-client

command, you can remove the NTP broadcast client mode.

By default, no NTP broadcast client service is configured.

This command is used to specify the local interface on the local device to receive the NTP broadcast packets. The local device is run in client mode. It first listens discreetly to the broadcast packets from the server. When the first broadcast packet is received, the local device enables a short client/server mode to exchange messages with the remote server in order to estimate network delay. Then it enters the client mode to listen discreetly to the broadcast packets and synchronize the local clock according to the coming broadcast packets.

Example

Enable the interface Ethernet 1/0/1 to receive NTP broadcast message.

[NEC-PHILIPS] interface ethernet 1/0/1 [NEC-PHILIPS-Ethernet1/0/1] ntp-service broadcast-client

ntp-service Syntax broadcast-server ntp-service broadcast-server [ authentication-keyid keyid | version

number ] * undo ntp-service broadcast-server

View

Interface view

Parameter authentication-keyid: Defines the ID authentication key.

keyid: Key ID number used to transmit message to broadcast clients, which is

in the range of 1 to 4294967295.

version: Defines the NTP version number. number: NTP version number in the range of 1 to 3. Description

Using the ntp-service broadcast-server command, you can configure NTP broadcast server mode. Using the undo ntp-service broadcast-server

command, you can remove the NTP broadcast server mode.

By default, no broadcast service is configured and the version number is 3. This command is used to specify an interface on the local device to transmit NTP broadcast packets. The local device is run in broadcast-server mode, which acts as the broadcast server to transmit broadcast messages periodically to the broadcast clients.

Page 88

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 88

Example

Enable Ethernet 1/0/0 to transmit NTP broadcast packets. No.4 key is used for encryption and NTP version number is set to 3.

[NEC-PHILIPS] interface ethernet 1/0/0 [NEC-PHILIPS-Ethernet1/0/0] ntp-service broadcast-server authentication-

key 4 version 3

ntp-service max- Syntax dynamic-sessions ntp-service max-dynamic-sessions number

undo ntp-service max-dynamic-sessions View

System view

Parameter number: Number of sessions allowed to be established locally. It is in the range

of 0 to (232-1).

Description Using the ntp-service max-dynamic-sessions command, you can set the number of sessions allowed to be established locally. Using the undo ntp- service max-dynamic-sessions command, you can restore the default

number of the sessions.

By default, 100 sessions are allowed to be established.

Example

Set the number of sessions the local allows to establish to 50.

[NEC-PHILIPS] ntp-service max-dynamic-sessions 50

ntp-service Syntax multicast-client ntp-service multicast-client [ X.X.X.X ]

undo ntp-service multicast-client [ X.X.X.X ] View

Interface view

Parameter X.X.X.X: Multicast IP address, which is a Class D address.

Description Using the ntp-service multicast-client command, you can configure the NTP multicast client mode. Using the undo ntp-service multicast-client command,

you can remove the NTP multicast client mode.

By default, no multicast client service is configured and the X.X.X.X is

224.0.1.1.

This command is used to specify an interface on the local device to receive the NTP multicast packets. The local device is run in client mode. It first listens discreetly to the multicast packets from the server. When the first multicast packet is received, the local device enables a short client/server mode to exchange messages with the remote server in order to estimate network delay. Then it enters the client (multicast-client) mode to listen discreetly to the multicast packets and synchronize the local clock according to the coming multicast packets.

Page 89

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 89

Example

Configure Ethernet 1/0/0 to receive NTP multicast packets. The multicast address corresponding to the multicast packets is 244.0.1.1.

[NEC-PHILIPS] interface ethernet 1/0/0 [NEC-PHILIPS-Ethernet1/0/0] ntp-service multicast-client 224.0.1.1

ntp-service Syntax multicast-server ntp-service multicast-server [ X.X.X.X ] [ authentication-keyid keyid | ttl ttl-

number | version number ] * undo ntp-service multicast-server [ X.X.X.X ]

View

Interface view

Parameter X.X.X.X: Multicast IP address, which is a Class D address. The default address

is 224.0.1.1.

authentication-keyid: Defines the ID authentication key. keyid: ID number used when transmitting messages to the multicast clients in

the range of 1 to 4294967295.

ttl: Defines the life span of the multicast packet. ttl-number: Life span of the multicast packet in the range of 1 to 255.

version: Defines the NTP version number. number: NTP version number in the range of 1 to 3. Description

Using the ntp-service multicast-server command, you can configure the NTP multicast server mode. Using the undo ntp-service multicast-server

command, you can remove the NTP multicast server mode.

By default, no multicast service is configured, the IP address is 224.0.1.1 and the version number is 3.

This command is used to specify an interface on the local device to transmit NTP multicast packets. The local device is run in server (multicast-server) mode, which acts as the multicast server to transmit multicast messages periodically to the multicast clients.

Example

Configure Ethernet 1/0/0 to transmit NTP multicast messages. The multicast address is 244.0.1.1, encrypted by No.4 key. The NTP version number is set to

[NEC-PHILIPS] interface ethernet 1/0/0 [NEC-PHILIPS-Ethernet1/0/0] ntp-service multicast-server 224.0.1.1

authentication-keyid 4 version 3

ntp-service Syntax refclock-master ntp-service refclock-master [ X.X.X.X ] [ layers-number ]

undo ntp-service refclock-master [ X.X.X.X ]

Page 90

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 90

View

System view

Parameter X.X.X.X: IP address of the reference clock 127.127.t.u.

ntp-service refclock-master ntp-service reliable authentication-keyid layers-number: Specifies the stratum of the local clock, which is in the range of

1 to 15.

Description Using the ntp-service refclock-master command, you can set the external reference clock or the local clock to be the NTP master clock. Using the undo ntp-service refclock-master command, you can remove the setting of the NTP

master clock.

By default, the X.X.X.X is not specified and the stratum is 1.

Setting the external reference clock or the local clock to be the NTP master clock provides other devices with synchronous time. The X.X.X.X is the IP address 127.127.t.u of the reference clock. When no IP address is specified, the local clock is the NTP master clock by default. This command can be used to specify the stratum of the NTP master clock.

Example

Set the local device to be the NTP master clock to provide synchronous time for other peers. The stratum is set to 3.

[NEC-PHILIPS] ntp-service refclock-master 3

ntp-service reliable Syntax authentication-keyid ntp-service reliable authentication-keyid number undo ntp-service reliable authentication-keyid number

View

System view

Parameter number: Key number in the range of 1 to 4294967295.

Description

Using the ntp-service reliable authentication-keyid command, you can specify the key to be reliable. Using the undo ntp-service reliable authentication-keyid command, you can remove the specified reliable key.

By default, no reliable authentication key is set.

If ID authentication is enabled, this command is used to specify that one or more keys are reliable. That is, the client can only synchronize the server that provides the reliable key. The client cannot synchronize the server that provides keys not being reliable.

Example

Enable NTP ID authentication in MD5 encryption method. The key ID number is 37 and the key is BetterKey. The key is specified to be reliable.

[NEC-PHILIPS] ntp-service authentication enable [NEC-PHILIPS] ntp-service authentication-keyid 37 authentica tion-mode

md5 BetterKey

Page 91

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 91

[NEC-PHILIPS] ntp-service reliable authentication-keyid 37

ntp-service Syntax source-interface ntp-service source-interface {interface-type interface-number } undo ntp-service source-interface

View

System view

Parameter interface-type: Interface type, which determines an interface along with the

interface-number.

interface-number: Interface number, which determines an interface along with

the interface-type.

Description Using the ntp-service source-interface command, you can specify the interface for the local end to transmit NTP messages. Using the undo ntp- service source-interface command, you can delete the interface for the local

end to transmit NTP messages.

The source IP address is determined by the output interface.

The source IP address is the specified one when specifying the local to transmit all the NTP messages. The IP address is obtained from the specified interface. If the user does not want the IP addresses on other interfaces to become the destination address responding to the messages, this command can be used to specify one interface to send all the NTP packets.

Example

Specify the source IP address of all the NTP output packets to use the IP address on the interface Ethernet 1/0/0.

[NEC-PHILIPS] ntp-service source-interface ethernet 1/0/0

ntp-service unicast-peer Syntax ntp-service unicast-peer X.X.X.X [ version number | authentication-key

keyid | source-interface {interface-type interface-number } | priority ] *

undo ntp-service unicast-peer X.X.X.X

View

System view

Parameter X.X.X.X: IP address of the remote server.

version: Defines the NTP version number. number: NTP version number in the range of 1 to 3.

authentication-keyid: Defines ID authentication key.

keyid: Key ID number in the range of 1 to 4294967295, which is used when

transmitting messages to the remote server.

source-interface: Specifies the interface name. interface-type: Interface type, which determines an interface along with the

Page 92

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 92

interface-number.

interface-number: Interface number, which determines an interface along with

the interface-type. The source IP address for the NTP packets sent from the local end to the peer is got from this interface.

priority: Specifies the server as the preferred one. Description

Using the ntp-service unicast-peer command, you can configure the NTP peer mode. Using the undo ntp-service unicast-peer command, you can remove

the NTP peer mode.

By default, the version number is 3, ID authentication is not supported and the server is not the preferred one.

This command is used to set the remote server specified by the X.X.X.X as the peer of the local device. The local device is run in symmetric active mode. The X.X.X.X is a host address and cannot be the address of the broadcast, multicast, or reference clock. In this configuration, the local device can be synchronized to the remote server and the remote server can also be synchronized to the local server.

Example

Display the configuration that the peer 128.108.22.44 provides the synchronous time for the local and the local peer can provide synchronous time for the peer. The version number is 3. The IP address of the NTP packets is obtained from Ethernet 1/0/0.

[NEC-PHILIPS] ntp-service unicast-peer 128.108.22.44 version 3 source-

interface ethernet 1/0/0

ntp-service Syntax unicast-server ntp-service unicast-server X.X.X.X [ version number | authentication-keyid

keyid | source-interface {interface-type interface-number } | priority ] *

undo ntp-service unicast-server X.X.X.X

View

System view

Parameter X.X.X.X: IP address of the remote server.

version: Defines the NTP version number. number: NTP version number in the range of 1 to 3.

authentication-keyid: Defines ID authentication key.

keyid: Key ID number in the range of 1 to 4294967295, which is used when

transmitting messages to the remote server.

source-interface: Specifies the interface name. interface-type: Interface type, which determines an interface along with the

interface-number.

interface-number: Interface number, which determines an interface along with

Page 93

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 93

the interface-type. The source IP address for the NTP packets sent from the local end to the server is got from this interface.

priority: Specifies the server as the preferred one. Description

Using the ntp-service unicast-server command, you can configure the NTP server mode. Using the undo ntp-service unicast-server command, you can

remove the NTP server mode.

By default, the version number is 3, ID authentication is enabled and the server is not the preferred one.

This command is used to set the remote server specified by the X.X.X.X as the local time server. The X.X.X.X is a host address and cannot be the IP address of the broadcast, multicast or reference clock. In this configuration, the local client device can be synchronized to the remote server and the remote server cannot be synchronized to the local client device.

Example

Configure the local device to be provided with the synchronous time by the server 128.108.22.44. The version number is 3.

[NEC-PHILIPS] ntp-service unicast-server 128.108.22.44 v ersion 3

3.10 \SNMP Configuration Commands

debugging snmp-agent Syntax debugging snmp-agent { header | packet | process | trap }

undo debugging snmp-agent { header | packet | process | trap } View

User view

Parameter header: Enables the debugging of packet information header.

packet: Enables the packet debugging. process: Enables the process debugging of SNMP packets. trap: Enables the debugging of Trap packets. Description

Using the debugging snmp-agent command, you can enable the SNMP Agent

debugging and specify the debugging information of SNMP module. Using the

undo debugging snmp-agent command, you can remove the current settings.

By default, the SNMP Agent debugging is disabled.

Example

Enable the debugging of SNMP Agent packet information header.

<NEC-PHILIPS> debugging snmp-agent header

display snmp-agent Sy ntax

display snmp-agent { local-engineid | remote-engineid }

Page 94

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 94

View

Any view

Parameter

None

Description Using the display snmp-agent command, you can display the SNMP engine ID

of local or remote device.

The SNMP engine is the only identification of the SNMP management, and it uniquely identifies a SNMP entity in one management domain. The SNMP engine is an important component of the SNMP entity, completing the functions of SNMP messages such as message dispatching, message processing, security authentication and access control.

Example

Display the engine ID of the local device.

<NEC-PHILIPS> display snmp-agent local-engineid SNMP local EngineID:

000007DB7F0000013859

in the above information:

SNMP local EngineID indicates the ID of the local SNMP engine.

display snmp- Syntax agent community display snmp-agent community [ read | write ]

View

Any view

Parameter read: Displays the community name information with the read-only authority.

write: Displays the community name information with the authority of read and

write.

Description Using the display snmp-agent community command, you can display the

currently configured community name of SNMPv1 or SNMPv2.

Example

Display the currently configured community name.

<NEC-PHILIPS> display snmp-agent community

Community name:8040zlz Group name:8040zlz Storage-type: nonVolatile Community name:8040core Group name:8040core Storage-type: nonVolatile

display snmp- Syntax agent group display snmp-agent group [ group-name ]

View

Any view

Parameter group-name: Specifies the group name of the SNMP information to be

Page 95

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 95

displayed, ranging 1 to 32 bytes.

Description Using the display snmp-agent group command, you can display the group

information based on USM. Without parameters, the command displays the group information corresponding to all the specified group names, including group name, security mode, storage types on the router etc.

Example

Display the SNMP group name and security mode.

<NEC-PHILIPS> display snmp-agent group

Group name: v3r2

Security model: v3 noAuthnoPriv Readview: ViewDefault Writeview: <no specified> Notifyview :<no specified> Storage-type: nonVolatile

The corresponding fields displayed above are described in the following table:

Table 4 Description of display snmp-agent group fields

Content Description

Groupname Name of SNMP group corresponding to

the user

Readview Name of read-only MIB view

corresponding to the group

Writeview

Name of writable MIB view corresponding to the group

Notifyview Name of notifying MIB view corresponding

to the group

Storage-type the type of storage type

display snmp-agent Sy ntax mib-view display snmp-agent mib-view [ exclude | include | viewname view-name ]

View

Any view

Parameter exclude: Specifies to exclude the SNMP MIB view attributes displayed and set.

include: Specifies to include the SNMP MIB view attributes displayed and set. viewname: Specifies the view name to be displayed.

Description

Using the display snmp-agent mib-view command, you can display the

currently configured MIB view.

Example

Display the currently configured MIB view.

<NEC-PHILIPS> display snmp-agent mib-view

View name:ViewDefault MIB Subtree:internet Subtree mask: Storage-type: nonvolatile

Page 96

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 96

View Type:included View status:active View name:ViewDefault MIB Subtree:snmpUsmMIB Subtree mask: Storage-type: nonvolatile View Type:excluded View status:active View name:ViewDefault MIB Subtree:snmpVacmMIB Subtree mask: Storage-type: nonvolatile View Type:excluded View status:active View name:ViewDefault MIB Subtree:snmpModules.18 Subtree mask: Storage-type: nonvolatile View Type:excluded View status:active

The following table describes the parameters displayed above.

Table 5 Description of display snmp-agent mib-view fields

Content Description

View name View name MIB Subtree MIB subtree Storage-type Storage type ViewType: Included/excluded Indicate whether to enable or disable the

access to a MIB object

Active Indicate the state of lines in the list

CAUTION: When the SNMP Agent is disabled, "Snmp Agent disabled" will be displayed for all the above display commands.

display Syntax snmp-agent statistics display snmp-agent statistics

View

Any view

Parameter

None

Description

Using the diplay snmp-agent statistics command, you can display the state

and statistics of SNMP.

Example

Check the statistics of SNMP communication.

<NEC-PHILIPS> display snmp-agent statistics 41 Messages delivered to the SNMP entity 0 Messages which were for an unsupported version 7 Messages which used an unknown community name 0 Messages which represented an illegal operation for the community supplied 0 ASN.1 or BER errors in the process of decoding 18 MIB objects retrieved successfully

Page 97

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 97

0 MIB objects altered successfully 0 Get-request PDUs accepted and processed 0 Get-next PDUs accepted and processed 0 Set-request PDUs accepted and processed 57 Messages passed from the SNMP entity 0 SNMP PDUs which had a tooBig error (Maximum packet size 1500) 0 SNMP PDUs which had a noSuchName error 0 SNMP PDUs which had a badValue error 0 SNMP PDUs which had a general error 25 Response PDUs accepted and processed 11 Trap PDUs accepted and processed

The following table describes the fields displayed above:

Table 6 Description of diplay snmp-agent statistics fields

Content Description

Messages delivered to the SNMP entity

Total number of input SNMP packets

Messages which were for an unsupported version

Number of packets with version errors

Messages which used an unknown community name

Number of packets with community name errors

Messages which represented an illegal operation for the community supplied

Number of packets with authority errors corresponding to community name

ASN.1 or BER errors in the process of decoding

Number of SNMP packets with encoding errors

MIB objects retrieved successfully Number of variables requested by

NMS

MIB objects altered successfully Number of variables set by NMS Get-request PDUs accepted and

processed

Number of get-request packets accepted and processed (PDU: Protocol Data Unit)

Get-next PDUs accepted and processed

Number of received packets that get next requests

Set-request PDUs accepted and processed

Number of received packets that set

requests Messages passed from the SNMP entity

Total number of output SNMP packets

SNMP PDUs which had a tooBig error

Number of SNMP packets with

Too_big errors (Maximum packet size 1500) Maximum SNMP packet size is 1500.

SNMP PDUs which had a noSuchName error

Number of packets with requests of

non-existing MIB object SNMP PDUs which had a badValue

error

Number of SNMP packets with

Bad_values errors

SNMP PDUs which had a general error

Number of SNMP packets with

General_errors Response PDUs accepted and processed

Number of response packets accepted

and processed

Trap PDUs accepted and processed

Number of Trap packets accepted and

processed

Page 98

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 98

display Syntax snmp-agent sys-info display snmp-agent sys-info [ contact | location | version ]*

View

Any view

Parameter contact: Displays the contact information of the local device.

location: Displays the physical location information of the local device. version: Displays the SNMP version running in the local agent. Description

Using the display snmp-agent sys-info command, you can display the system

information of the local SNMP device.

Example

Display the system information.

<NEC-PHILIPS> display snmp-agent sys-info

display Syntax snmp-agent usm-user display snmp-agent usm-user [ engineid engineid | username user-name |

group group-name ] * View

Any view

Parameter engineid: Displays the SNMPv3 user information of the specified engine ID.

engineid-string: Character string of the engine ID.

username: Displays the information of the specified SNMPv3 user.

user-name: User name, in the range of 1 to 32 bytes.

group: Displays the user information belonging to the related SNMP group.

group-name: Group name, in the range of 1 to 32 bytes.

Description Using the display snmp-agent usm-user command, you can display the

information about SNMP users.

An SNMP user is the remote user who executes SNMP management operation.

The snmp-agent usm-user command is used to specify the SNMP user. Example

Display the information about all the current users.

<NEC-PHILIPS> display snmp-agent usm-user

User name: authuser Engine ID: 8000007DB20000000C025808 active

The following table describes the corresponding fields displayed above.

Page 99

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 99

Table 7 Description of display snmp-agent usm-user fields

Content Description

authuser Modify display information User name Character string used to identify the

SNMP user

Engine ID Character string used to identify the

SNMP device

Active Indicate the state of SNMP USER

snmp-agent Syntax

snmp-agent undo snmp-agent

View

System view

Parameter

None

Description Using the snmp-agent command, you can enable the SNMP Agent and specify the SNMP configuration information. Using the undo snmp-agent command,

you can disable SNMP Agent.

By default, the SNMP Agent is disabled.

The snmp-agent command can be used to enable SNMP Agent, and any

configuration command of snmp-agent can also enable SNMP Agent. However, the undo form of the corresponding command does not have the functions. It will be invalid configuring the undo form of the command when the SNMP Agent is not enabled.

The undo snmp-agent command is used to disable the SNMP Agent on the

condition that SNMP Agent has been enabled.

Example

Disable the operating SNMP version.

[NEC-PHILIPS] undo snmp-agent

SNMP Agent disabled

snmp-agent community Syntax snmp-agent community { read | write } community-name [ [ mib-view view-

name ] | [ acl acl-number ] ]* undo snmp-agent community community-name

View

System view

Parameter read: Indicates that the community name has the read-only authority in the

specified view.

write: Indicates that the community name has the read and write authority in the

specified view.

community-name: Character string of community name.

Page 100

SOPHO IP 5000/SOPHO IP6000

Command Reference Guide 100

mib-view: MIB view available for the specified community name view-name: Name of MIB view.

acl: Sets the ACL corresponding to the community name.

acl-number: Number of the ACL, range 1 to 99.

Description Using the snmp-agent community command, you can set the community

access name of SNMPV1 and SNMPV2C and MIB views and ACLs available

for the community name. Using the undo snmp-agent community command,

you can remove the setting.

For the related command, see snmp-agent group, snmp-agent usm-user. Example

Set the community name to comaccess and allow read-only access with this community name.

[NEC-PHILIPS] snmp-agent community read comaccess

Set the community name to mgr and enable reading and writing access.

[NEC-PHILIPS] snmp-agent community write mgr

Delete the community name comaccess.

[NEC-PHILIPS] undo snmp-agent community comaccess

snmp-agent group Syntax snmp-agent group { v1 | v2c } group-name { [ read read-view ] | [ write

write-view ] | [ notify notify-view ] } [ acl acl-number ] undo snmp-agent group { v1 | v2c } group-name snmp-agent group v3 group-name [ authentication | privacy ] { [ read read -

view ] | [ write write-view ] | [ notify notify-view ] } [ acl acl-number ]

undo snmp-agent group v3 group-name [ authentication | privacy ]

View

System view

Parameter v1: V1 security mode the user uses.

v2c: V2C security mode the user uses. v3: V3 security mode the user uses.

group-name: Group name, in the range of 1 to 32 bytes.

authentication: Performs authentication of the packet without encryption. privacy: Performs authentication and encryption of the packet. read: Enables the setting of read-only view.

read-view: Name of the read-only view, in the range of 1 to 32 bytes.

NEC SOPHO IP 5000, SOPHO IP 6000 Command Reference Manual

Specifications and Main Features

Frequently Asked Questions

User Manual