H3C XE 200 2000 IP PBX Command Manual(V3.01)

DownLoad Chapters Download(202 KB)

01-Basic Configuration Command


Chapter 1  Basic Configuration Commands

1.1.1  clock datetime

Syntax

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

View

User view

Parameter

HH:MM:SS: Current time in HH:MM:SS format, HH is in the range 0 to 23, MM and SS in the range 0 to 59.

YYYY/MM/DD: Current date in YYYY/MM/DD format, where YYYY is the current year (2000 to 2099); MM is the current month (1 to 12); DD is the current day (1 to 31).

Description

Use the clock datetime command to set current date and time for a H3C XE 200/2000 IP PBX (hereinafter referred to as XE IP PBX).

You must set the current date and time when the absolute time is required.

The parameter SS is not necessary for time setting.

Related command: display clock.

Example

# Set the current date/time of an XE IP PBX to January 1st, 2004, 00:00:00.

<XE> clock datetime 0:0:0 2004/01/01

1.1.2  clock summer-time

Syntax

clock summer-time summer-time-zone-name { one-off | repeating } start-time start-date end-time end-date add-time

undo clock summer-time

View

User view

Parameter

summer-time-zone-name: Name of the time zone to be displayed when the daylight saving time is in effect, from 1 to 32 characters in length.

one-off: Only sets the time of daylight saving time for a particular year.

repeating: Sets the time of daylight saving time for every year from a particular year.

start-time start-date: The start time and date of the daylight saving time, with time in HH:MM:SS format and date in YYYY/MM/DD format.

end-time end-date: The end time and date of the daylight saving time, with time in  HH:MM:SS format and date in YYYY/MM/DD format.

add-time: The daylight saving time offset.

Description

Use the clock summer-time command to set the name of daylight saving time and the beginning and end dates.

Use the undo clock summer-time command to remove the current configuration.

After the setting takes effect, you can use the display clock command to view the information. The system uses the local time with daylight saving time and time zone adjustment to display the log and debug information.

Related command: clock timezone.

Example

# Specify that the daylight saving time “z2” starts from 06:00:00 on June 8, 2002 to 06:00:00 on September 1, 2002, and set the system clock ahead one hour.

<XE> clock summer-time z2 one-off 06:00:00 2002/06/08 06:00:00 2002/09/01 01:00:00

# Specify that the daylight saving time “z2” starts from 06:00:00 on June 8 to 06:00:00 on September 1, starting from the year 2002, and set the system clock ahead one hour.

<XE> clock summer-time z2 repeating 06:00:00 2002/06/08 06:00:00 2002/09/01 01:00:00

1.1.3  clock timezone

Syntax

clock timezone time-zone-name { add | minus } HH:MM:SS

undo clock timezone

View

User view

Parameter

time-zone-name: Name of the time zone, from 1 to 32 characters in length.

add: Positive offset to universal time coordinated (UTC, equivalent to mean solar time at the prime meridian (0° longitude)) time.

minus: Negative offset to UTC time.

HH:MM:SS: Time in hours, minutes, and seconds.

Description

Use the clock timezone command to set the local time zone.

Use the undo clock timezone command to restore the default UTC time zone.

After the setting takes effect, you can use the display clock command to view the information. Times in log and debug information are the local time with daylight saving time and time zone adjustment.

Related command: clock summer-time.

Example

# Set the name of the local time zone to Z5, 5 hours ahead of UTC time.

<XE> clock timezone z5 add 05:00:00

1.1.4  command-alias

Syntax

command-alias alias currentfirstcmdkey

undo command-alias alias

View

System view

Parameter

alias: An alias within 64 characters set by the user. It cannot be identical with the existing first keywords.

currentfirstcmdkey: The complete name of a current first keyword to be substituted by the alias.

Description

Use the command-alias command to configure an alias for the specified command.

Use the undo command-alias command to cancel the alias configuration.

Before configuring a command alias, you need to enable the command alias function by the enable command-alias command.

By default, no command alias is configured.

Related command: enable command-alias.

Example

# Configure an alias of “show” for the keyword display.

[XE] command-alias show display

The relationship between the commandkey and the alias is established!

# Cancel the alias of “show”.

[XE] undo command-alias show

The relationship between the commandkey and the alias is canceled!

1.1.5  command-privilege

Syntax

command-privilege level level view view command-key

undo command-privilege view view command-key

View

System view

Parameter

level level: Command privilege level, in the range 0 to 3.

view view: View and view keyword. The following table lists the primary views and view keywords available in the XE IP PBX.

Table 1-1 Privilege keywords

Keyword

View

analogmodem

Analogmodem interface view

aux

AUX interface view

diagnose

Diagnose view

ftp-client

Ftp-client view

ethernet

Ethernet interface view

gigabitethernet

Gigabitethernet interface view

gui

GUI view

hidecmd

Hidecmd view

loopback

Loopback view

ls

LS view

Ls-clg

LS-CLG view

ls-domain

LS-DOMAIN view

ls-emgc

LS-EMGC view

ls-gw

LS-GW view

ls-gw-prf

LS-GW-PRF view

ls-gw-ssb

LS-GW-SSB view

ls-gw-ssb-adi

LS-GW-SSB-ADI view

ls-gw-ssb-alarm

LS-GW-SSB-ALARM view

ls-gw-ssb-cba

LS-GW-SSB-CBA view

ls-gw-ssb-cfb

LS-GW-SSB-CFB view

ls-gw-ssb-cfc

LS-GW-SSB-CFC view

ls-gw-ssb-cfnr

LS-GW-SSB-CFNR view

ls-gw-ssb-cfo

LS-GW-SSB-CFO view

ls-gw-ssb-cft

LS-GW-SSB-CFT view

ls-gw-ssb-cfu

LS-GW-SSB-CFU view

ls-gw-ssb-clir

LS-GW-SSB-CLIR view

ls-gw-ssb-dnd

LS-GW-SSB-DND view

ls-gw-ssb-lcg

LS-GW-SSB-LCG view

ls-gw-ssb-ltc

LS-GW-SSB-LTC view

ls-gw-ssb-myring

LS-GW-SSB-MYRING view

ls-gw-ssb-myring-cg

LS-GW-SSB-MYRING-CG view

ls-gw-ssb-ssbm

LS-GW-SSB-SSBM view

ls-ms

LS-MS view

ls-nat&fw

LS-NAT&FW view

ls-og

LS-OG view

ls-og-office

LS-OG-OFFICE view

ls-og-prf

LS-OG-PRF view

ls-only

LS-ONLY view

ls-ps

LS-PS view

ls-srv

LS-SRV view

ls-srv-3pcc

LS-SRV-3PCC view

ls-srv-ao

LS-SRV-AO view

ls-srv-cb

LS-SRV-CB view

ls-srv-gn

LS-SRV-GN view

ls-srv-gn-gc

LS-SRV-GN-GC view

ls-srv-gn-nc

LS-SRV-GN-NC view

ls-ssbr

LS-SSBR view

ls-ssbt

LS-SSBT view

ls-sst

LS-SST view

ma

MA view

ma-lang

MA-LANG view

ma-lang-fmt

MA-LANG-FMT view

ms

MS view

null

NULL view

olp

OLP view

ps

PS view

ps-gk

PS-GK view

ps-sip

PS-SIP view

shell

Shell view

system

System view

user-interface

User interface view

 

command-key: Command to be set.

Description

Use the command-privilege command to set the privilege level of a command in a specified view.

Use the undo command-privilege view command to remove the current setting.

There are four levels of command privilege: visit, monitor, system and manage, which are identified as 0, 1, 2, and 3 respectively. The administrator can assign permissions for users to access the corresponding view. A user can run the commands according to the privilege level associated with the user name. Also, the user can perform operations according to the permission granted through the user interface. If there is a conflict between these two privileges, the one with the lower level is adopted.

By default, the commands ping, tracert and telnet are of the visit level (with identifier 0); the commands display, debugging are of the monitor level (with identifier 1); the configuration commands are of the system level (with identifier 2) and commands of user key setting, FTP, XMODEM, TFTP and file system operation are of the manage level (with identifier 3).

Example

# Set the privilege level of the interface command to 0.

[XE] command-privilege level 0 view system interface

1.1.6  display clipboard

Syntax

display clipboard

View

Any view

Parameter

None

Description

Use the display clipboard command to display the contents of the clipboard.

Example

# Display the contents of the system clipboard.

<XE> display clipboard

-----------------clipboard -----------------

        ip route 10.1.0.0 255.0.0.0 eth 0

1.1.7  display clock

Syntax

display clock

View

Any view

Parameter

None

Description

Use the display clock command to display the current system date and time.

If the system time is not correct, you can use the clock datetime command to make adjustments.

Related command: clock datetime.

Example

# Display the current system date and time.

<XE> display clock

15:50:45 UTC Mon 2003/02/12

1.1.8  display command-alias

Syntax

display command-alias

View

Any view

Parameter

None

Description

Use the display command-alias command to view the current command alias settings. Note to enable command alias before using this command.

Related command: enable command-alias.

Example

# Display the current command alias settings.

[XE] enable command-alias

Command alias switch is on!

[XE] display command-alias

index        alias       commandkey

0            show        display

1.1.9  display cpu-usage-for-user

Syntax

display cpu-usage-for-user [ configuration | number [ offset ] [ verbose ] [ from-device ] ]

View

Any view

Parameter

configuration: Displays the configuration information about the CPU usage statistics, including the enable/disable state, the statistical cycle, and the alarm threshold of the CPU usage statistics.

number: Number of the statistic entities to be displayed.

offset: Offset from the first entity to the last entity to be displayed.

verbose: Displays detail information.

from-device: Displays the information saved in a peripheral storage device (flash, hard disk, and so on). This option is not supported at present.

Description

Use the display cpu-usage command to display the statistics about the CPU usage.

The display cpu-usage-for-user command without any option is equivalent to display cpu-usage-for-user 1 0 verbose. It displays the last statistic entry of CPU usage in detail.

Example

# Display detailed CPU usage statistics.

[XE] display cpu-usage-for-user

===== Current CPU usage info =====

CPU Usage Stat. Cycle: 37 (Second)

CPU Usage            : 4%

CPU Usage Stat. Time : 2005-04-11  13:39:45

CPU Usage Stat. Tick : 0x0(CPU Tick High) 0xf4bbad99(CPU Tick Low)

Actual Stat. Cycle   : 0x0(CPU Tick High) 0x37bab97d(CPU Tick Low)

1.1.10  display current-configuration

Syntax

display current-configuration [ interface interface-type  [ interface-number ] | configuration [ ls | system | user-interface ] ]

View

Any view

Parameter

interface: Displays the configuration of the interface.

interface-type: Type of interface.

interface-number: Number of the interface.

configuration: Displays the specified configuration.

Is: Displays the location server configuration.

system: Displays the system configuration.

user-interface: Displays the configuration of the user interface.

Description

Use the display current-configuration command to view the current configuration of the XE IP PBX.

The currently configured parameters that are the same with the corresponding default parameters are not displayed.

You can use the display current-configuration command to see if the configurations take effect. Some configured parameters will not appear if the functions to which these parameters apply do not take effect.

Related command: display saved-configuration.

Example

# Display currently valid parameters of the XE IP PBX.

<XE> display current-configuration

1.1.11  display diagnostic-information

Syntax

display diagnostic-information

View

Any view

Parameter

None

Description

Use the display diagnostic-information command to display the operating information of all the active modules of the system and collect all the information at a time so as to isolate the problem when failure occurs to the system. However, it is rather difficult for you to collect all the information at a time as 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 diagnostic information.

<XE> display diagnostic-information

1.1.12  display history-command

Syntax

display history-command

View

Any view

Parameter

None

Description

Use the display history-command command to display history command(s).

The terminal automatically saves recently-executed commands, that is, any input that ends with a carriage return. You can use the display history-command command to display the saved history commands.

Example

# Display the history command(s).

<XE> display history-command

display interface

display interface e 1/0

1.1.13  display saved-configuration

Syntax

display saved-configuration

View

Any view

Parameter

None

Description

Use the display saved-configuration command to display the saved configuration of the XE IP PBX, which is valid after the next boot.

Related command: display current-configuration.

Example

# Display configure file of XE IP PBX in storage device.

<XE> display saved-configuration

#

 sysname XE

#

interface Aux0

 link-protocol ppp

#

interface Ethernet0/0

#

interface Ethernet0/1

#

#interface NULL0

#

user-interface con 0

user-interface aux 0

user-interface vty 0 4

#

return

1.1.14  display this

Syntax

display this

View

Any view

Parameter

None

Description

Use the display this command to display the current configuration of the active view.

Example

# Display the current configuration of the active view.

[XE] display this

#

 sysname XE

#

 tcp window 8

#

1.1.15  display version

Syntax

display version

View

Any view

Parameter

None

Description

Use the display version command to display the system version.

This command displays the information about the software version, main control board, interface board and so on.

Example

# Display the system version of XE 2000 IP PBX.

<XE> display version

H3C Comware Platform Software

 Comware software, Version 3.30,ESS 0122P01

 Copyright (c) 2004-2007 Hangzhou H3C Technology Co., Ltd. All rights reserved.

 H3C XE 200 uptime is 0 week, 1 day, 0 hour, 14 minutes

 CPU type: PowerPC 8241 200MHz

 256M bytes SDRAM Memory

 32M bytes Flash Memory

 Pcb      Version:3.0

 Logic    Version:1.0

 BootROM  Version:9.16

  [SLOT 0] AUX      (Hardware)3.0, (Driver)1.0, (Cpld)1.0

  [SLOT 0] 1FE      (Hardware)3.0, (Driver)2.0, (Cpld)0.0

  [SLOT 0] 1FE      (Hardware)3.0, (Driver)2.0, (Cpld)0.0

1.1.16  enable command-alias

Syntax

enable command-alias

undo enable command-alias

View

System view

Parameter

None

Description

Use the enable command-alias command to enable the command alias function.

Use the undo enable command-alias command to disable the command alias function.

By default, the command alias function is disabled.

Example

# Enable the command alias function.

[XE] enable command-alias

Command alias switch is on!

# Disable the command alias function.

[XE] undo enable command-alias

Command alias switch is off!

1.1.17  header

Syntax

header [ shell | incoming | login ] text

undo header [ shell | incoming | login ]

View

System view

Parameter

login: The banner to be displayed before the login prompt.

shell: The banner of the user session establishment.

incoming: The banner of the login interface.

text: Contents of the banner.

Description

Use the header command to set the banner to be displayed.

Use the undo header command to disable the function.

If the banner properties are set, the related information appears when the user logs into the XE IP PBX from the terminal. Once the terminal connection is activated, the login banner appears on the terminal. If the login succeeds, the banner shell appears.

The beginning and ending characters of the text are the first character of text. The system will exit the interactive process after the ending character is entered.

If you do not want to enter the interactive process, just enter the same character twice and press <Enter>.

Example

# Set the banner of the session establishment.

[XE] header shell %

SHELL : Hello! Welcome use XE 2000.%

# Test the previous setting.

[XE] quit

<XE> quit

Press RETURN to get started

 

SHELL : Hello! Welcome use XE 2000.

<XE>

1.1.18  hotkey

Syntax

hotkey [ CTRL_G | CTRL_L | CTRL_O | CTRL_T | CTRL_U ] command_text

undo hotkey [ CTRL_G | CTRL_L | CTRL_O | CTRL_T | CTRL_U ]

View

System view

Parameter

CTRL_G: Assigns hot key <CTRL+G> to a command.

CTRL_L: Assigns hot key <CTRL+L> to a command.

CTRL_O: Assigns hot key <CTRL+O> to a command.

CTRL_T: Assigns hot key <CTRL+T> to a command.

CTRL_U: Assigns hot key <CTRL+U> to a command.

command_text: The command line associated with the hot key.

Description

Use the hotkey command to assign a hot key to a specific command line.

Use the undo hotkey command to restore the default setting.

By default, the hot key CTRL_G, CTRL_L, and CTRL_O are assigned to default commands as follows:

CTRL_G corresponds to the display current-configuration command (to display the current configuration);

CTRL_L corresponds to the display ip routing-table command (to display information on routing table);

CTRL_O corresponds to the undo debugging all command (to disable the display of all debugging information).

You can customize the hot key combination as needed.

Example

# Associate the display tcp status command with the hot key CTRL_T.

[XE] hotkey ctrl_t display tcp status

[XE] display hotkey

----------------- HOTKEY -----------------

 

            =Defined hotkeys=

Hotkeys Command

CTRL_G  display current-configuration

CTRL_L  display ip routing-table

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.

1.1.19  language-mode

Syntax

language-mode { chinese | english }

View

User view

Parameter

None

Description

Use the language-mode command to toggle the language modes of command line interface (CLI).

The default language mode is English.

Example

# Switch from English mode to Chinese mode.

<XE> language-mode chinese

Change language mode, confirm? [Y/N]y

1.1.20  lock

Syntax

lock

View

User view

Parameter

None

Description

Use the lock command to lock the current user interface to prevent unauthorized access.

User interfaces include CON port, AUX port and VTY virtual terminal interface.

Once the lock command is entered, the system will prompt you to enter the password of screen saver and confirm the password, if one password is consistent with another, the system will be locked. If you want to enter the system afterwards, you must press <Enter> and enter the password to unlock system and enter it.

Example

# Lock the current user interface (where the user logs in through console port).

<XE> lock

Password:

Again:

1.1.21  quit

Syntax

quit

View

Any view

Parameter

None

Description

Use the quit command to exit from the current view to the previous view. If you are in user view, you can use this command to exit the system.

There are three view levels, which are listed as follows (from low to high):

l           User view (with user level 0)

l           System view (with user level 3)

l           Configuration view such as interface view.

Related command: return.

Example

# Return to system view and then to user view from Ethernet1/0/0 port view.

[XE-Ethernet0/0] quit

[XE] quit

<XE>

1.1.22  return

Syntax

return

View

Any view except for user view

Parameter

None

Description

Use the return command to return to user view.

Alternatively, you can press <Ctrl+Z> to return to user view.

Related command: quit.

Example

# Return from system view to user view.

[XE] return

<XE>

1.1.23  super

Syntax

super [ level ]

View

User view

Parameter

level: User level, in the range 0 to 3.

Description

Use the super command to switch from the current user level to a specified level.

User levels refer to the categories of login users, which fall into four levels. Corresponding to the level of command, users of different levels can only run the commands with the same or lower level after login.

The four levels of command are visit, monitor, system, and manage, which are described as follows:

l           Visit level: The commands of network diagnostic tool, such as ping and tracert, and the commands sent out to access other devices, such as telnet, rlogin. Commands of this level do not allow you to save configuration files.

l           Monitor level: The commands used for system maintenance and service troubleshooting, including display and debugging. Commands of this level do not allow you to save configuration files.

l           System level: The commands of service configuration, including commands of routing and of each network layer. The commands provide users with direct network services.

l           Manage level: The commands related to basic operation and system supporting module, including commands of file system, FTP, TFTP, downloading via XMODEM, and switching configuration file, power control, backplane controlling, user management, level setting, internal parameter setting (non-protocol specification or RFC specification), and so on.

To prevent unauthorized access, the system requires a password of a higher level to be entered to authenticate the user when switching from a lower level to a higher level. (in case super password [ level user-level ] { simple | cipher } line is set.) The password entered is not displayed for security. The system will switch to a higher level if the user has entered the correct password within 3 attempts; otherwise the user level remains unchanged.

Related command: super password.

Example

<XE> 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

1.1.24  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, in the range 0 to 3.

simple: Specifies that  the password be displayed in simple text by corresponding display commands.

cipher: Specifies that the password be displayed in cipher text by corresponding display commands.

password: Password with up to 16 characters. If you set to display the password in simple text, corresponding display commands display it as a string of up to 16 characters with no space, such as 1234567. If you set to display the password in cipher text, corresponding display commands display it as 24 characters, such as _(TT8F)Y\5SQ=^Q`MAF4<1!!.

Description

Use the super password command to set the password which is used when switching to a higher user level.

Use the undo super password command to remove the current setting.

Example

# Set the password to zbr when switching from a lower level to level 3.

[XE] super password level 3 simple zbr

1.1.25  sysname

Syntax

sysname sysname

View

System view

Parameter

sysname: Name of the XE IP PBX, a string from 1 to 30 characters in length.

Description

Use the sysname command to set the name of the XE IP PBX.

The name of the XE IP PBX is H3C by default.

The modification to the name of an IP PBX can affect the prompt of the CLI. For the XE IP PBX named XE, the prompt of user view is <XE>.

Example

# Set the domain name of the XE IP PBX to XE.

[H3C] sysname XE

[XE]

1.1.26  system-view

Syntax

system-view

View

User view

Parameter

None

Description

Use the system-view command to switch from user view to system view.

Related command: quit, return.

Example

# Switch from user view to system view.

<XE> system-view

System View: return to User View with Ctrl+Z.

[XE]

 


Chapter 2  Ethernet Interface Configuration Commands

2.1.1  display interface ethernet

Syntax

display interface { ethernet | gigabitethernet | Aux | NULL } interface-number

View

Any view

Parameter

ethernet: Displays state information of FE interfaces. This parameter is available on XE 200 IP PBX.

gigabitethernet: Displays state information of GE interfaces. This parameter is available on XE 2000 IP PBX.

Aux: Displays the status information of the backup interface.

NULL: Displays the status information of the null interface.

interface-number: Specifies an interface. If it is not specified, the configuration and state information of all interfaces is displayed.

Description

Use the display interface command to view information on one or all Ethernet interfaces, such as the configuration parameters and current running status.

Example

# Display state information of Ethernet interface 0/0.

[XE] display interface Ethernet 0/0

Ethernet0/0 current state :UP

Line protocol current state :UP

Description :  Ethernet0/0 Interface

The Maximum Transmit Unit is 1500, Hold timer is 10(sec)

Internet Address is 192.168.80.40/24

IP Sending Frames' Format is PKTFMT_ETHNT_2, Hardware address is 00e0-fc46-cbca

Media type is twisted pair, loopback not set, promiscuous mode not set

10Mb/s, Half-duplex, link type is autonegotiation

Output flow-control is disabled, input flow-control is disabled

Output queue : (Urgent queue : Size/Length/Discards)  0/50/0

Output queue : (Protocol queue : Size/Length/Discards) 0/500/0

Output queue : (FIFO queuing : Size/Length/Discards)  0/75/0

    Last 300 seconds input rate 0.00 bytes/sec, 0.00 packets/sec

    Last 300 seconds output rate 0.00 bytes/sec, 0.00 packets/sec

    Input: 0 packets, 0 bytes, 0 buffers

           0 broadcasts, 0 multicasts, 0 pauses

           0 errors, 0 runts, 0 giants

           0 crc, 0 align errors, 0 overruns

           0 dribbles, 0 drops, 0 no buffers

    Output:0 packets, 0 bytes, 0 buffers

           0 broadcasts, 0 multicasts, 0 pauses

           0 errors, 0 underruns, 0 collisions

           0 deferred, 0 lost carriers

2.1.2  duplex

Syntax

duplex { full | half | negotiation }

undo duplex

View

Ethernet interface view

Parameter

full: Sets the operating mode of the Ethernet interface to full duplex.

half: Sets the operating mode of the Ethernet interface to half duplex.

negotiation: Sets the operating mode of the Ethernet interface to auto-negotiation.

Description

Use the duplex command to set the operating mode of the Ethernet interface.

Use the undo duplex command to restore the default operating mode, that is, auto-negotiation.

When connected to a hub, the Ethernet interface must operate in half duplex mode; but when connected to a network device that operates in full duplex, an Ethernet switch for example, it must operate in full duplex too.

Before setting the Ethernet interface to auto-negotiation mode, you must ensure the remote interface also operates in this mode. If this is uncertain, you are recommended to manually set the same operating mode on the two sides.

Related command: speed, display interface.

Example

# Set the FE interface to operate in full-duplex mode.

[XE-Ethernet0/0] duplex full

2.1.3  interface

Syntax

interface type number

undo interface type number

View

System view

Parameter

type: Interface type.

number: Interface number. The XE IP PBX numbers interfaces by type. The interfaces of each type are numbered beginning with 0 or 1.

Description

Use the interface command to enter the desired interface view or create a logical interface or sub-interface.

Use the undo interface command to delete the specified logical interface or sub-interface.

Table 2-1 Comware-supported interface types

Interface type

Description

Interface attributes

AUX

Backup interface

Physical interface

GigabitEthernet

Gigabit Ethernet interface (provided only by XE 2000 IP PBX)

Physical interface

Ethernet

Fast Ethernet interface (provided only by XE 200 IP PBX)

Physical interface

Loopback

Loopback interface

Logical interface

NULL

Null interface

Logical interface

 

On the XE IP PBX, an interface is represented by interface type + interface number, for example, Ethernet 0/0.

For your convenience, you can abbreviate interface type to the minimum number of letters that define a unique abbreviation, for example, Ethernet 0/0 to e0/0.

Executing the interface command enables you to enter actual physical interface view, and to create a logical interface as needed.

Note that you can use the undo interface command to delete the logical interfaces that you have created.

Example

# Enter Ethernet interface view from system view.

[XE] interface ethernet 0/0

[XE-Ethernet0/0]

2.1.4  ip address

Syntax

ip address ip-address net-mask

undo ip address ip-address net-mask

View

Interface view

Parameter

ip-address: IP address of an interface, in dotted decimal notation.

net-mask: Subnet mask, in dotted decimal notation.

Description

Use the ip address command to set the IP address of an interface.

Use the undo ip address command to remove the IP address of an interface.

By default, an interface has no IP address.

The IP addresses fall into five categories, and you can choose an appropriate IP subnet according to you actual circumstance. In addition, all "0s" in the host portion of the address represent the network address and all "1s" in the host portion of the address represents a broadcast address, neither of which can be used as a general IP address.

The subnet mask is used to identify the network number of an IP address. For example, the IP address of a router Ethernet interface is 129.9.30.42, and the mask is 255.255.0.0. After performing the "and" operation with the IP address and the mask, you can get the number (129.9.0.0) of the network where the router Ethernet interface is located.

In addition, any two IP addresses of the interfaces on the XE IP PBX can be located in the same subnet.

Related command: ip route-static, display interface.

Example

# Set the primary IP address of the interface GigabitEthernet0/0 to 129.102.0.1, with the subnet mask of 255.255.255.0.

[XE2000-GigabitEthernet0/0] ip address 129.102.0.1 255.255.255.0

2.1.5  loopback (Ethernet/Gigabitethernet Interface)

Syntax

loopback

undo loopback

View

Ethernet interface view

Parameter

None

Description

Use the loopback command to enable local loopback on the Ethernet interface.

Use the undo loopback command to disable local loopback on the interface.

By default, local loopback is disabled on the Ethernet interface. Local loopback is only intended for test purpose.

 

&  Note:

An Ethernet interface with loopback enabled is operating in full-duplex mode. After loopback is disabled, the original operating mode is resumed.

For a GE electrical interface that operates at 1000 Mbps or in auto-negotiation mode, its rate is forcibly switched to 100 Mbps after local loopback is enabled, and resumed after local loopback is disabled.

 

Example

# Enable local loopback on the FE interface 0/0.

[XE-Ethernet0/0] loopback

2.1.6  mtu (Ethernet/Gigabitethernet Interface)

Syntax

mtu size

undo mtu

View

Ethernet interface view

Parameter

size: MTU size of the Ethernet interface in bytes. The value is in the range of 46 to 1500 for Ethernet_II frames and 46 to 16384 for Gigabit Ethernet frames.

Description

Use the mtu command to set the MTU for an Ethernet interface.

Use the undo mtu command to restore the default, or 1500 bytes.

The setting of MTU affects fragmentation and reassembly of IP packets on the Ethernet interface. After you change MTU of the interface using the mtu command, you need to execute the commands shutdown and undo shutdown on the interface to have the new MTU take effect.

Related command: display interface.

Example

# Set the MTU of FE interface 1/0 to 1492.

[XE-Ethernet0/0] mtu 1492

2.1.7  promiscuous

Syntax

promiscuous

undo promiscuous

View

Ethernet interface view

Parameter

None

Description

Use the promiscuous command to enable the Ethernet interface to operate in the promiscuous mode.

Use the undo promiscuous command to disable the Ethernet interface from operating in the promiscuous mode.

By default, the Ethernet interface operates in the non-promiscuous mode.

When the Ethernet interface operates in the promiscuous mode, it receives all correct Ethernet packets without checking their MAC addresses. This mode is applied to traffic monitoring on the network.

Example

# Enable the interface Ethernet 0/0 to operate in the promiscuous mode.

[XE-Ethernet0/0] promiscuous

2.1.8  speed

Syntax

speed { 10 | 100 | 1000 | negotiation }

undo speed

View

Ethernet interface view

Parameter

10: Forces the Ethernet interface to operate at 10 Mbps.

100: Forces the Ethernet interface to operate at 100 Mbps.

1000: Forces the Ethernet interface to operate at 1000 Mbps (only for GE interfaces).

negotiation: Sets the Ethernet interface to operate in auto-negotiation mode.

Description

Use the speed command to set the operating speed of the Ethernet interface.

Use the undo speed command to restore the default mode, or auto-negotiation.

Before setting the Ethernet interface to auto-negotiation mode, you must ensure the remote interface also operates in this mode. If this is uncertain, you are recommended to manually set the same operating mode on the two sides.

For an FE electrical interface, you can set its speed to 10 Mbps, 100 Mbps or auto-negotiation, and for a GE electrical interface, 1000 Mbps in addition. However, the speeds of FE fiber-optic interfaces and GE fiber-optic interfaces are fixed to 100 Mbps and 1000 Mbps respectively, allowing no modification.

 

&  Note:

You cannot configure a GE electrical interface to operate at 1000 Mbps and in half-duplex mode at the same time.

 

Related command: duplex, display interface.

Example

# Set the operating speed of FE interface 1/0 to 10Base-T.

[XE-Ethernet0/0] speed 10

 


Chapter 3  Static Route Configuration Commands

3.1.1  delete static-routes all

Syntax

delete static-routes all

View

System view

Parameter

None

Description

Use the delete static-routes all command to delete all the static routes.

The system will prompt you to confirm the operation.

Related command: ip route-static, display ip routing-table.

Example

# Delete all the static routes.

[XE] delete static-routes all

Are you sure to delete all the static routes?[Y/N]y

3.1.2  display ip routing-table

Syntax

display ip routing-table

View

Any view

Parameter

None

Description

Use the display ip routing-table command to display the summary of the routing table.

Each line of the routing table represents a route in summary, which includes destination address/mask length, protocol, privilege, cost, next hop and outgoing interface.

Use the display ip routing-table command to view the currently used routing, that is, the best route.

Example

# Display the summary of the current routing table.

<XE> display ip routing-table

Routing Table: public net

Destination/Mask   Protocol Pre  Cost        Nexthop         Interface

127.0.0.0/8        DIRECT   0    0           127.0.0.1       InLoopBack0

127.0.0.1/32       DIRECT   0    0           127.0.0.1       InLoopBack0

192.168.80.0/24    DIRECT   0    0           192.168.80.40   Ethernet0/0

192.168.80.40/32   DIRECT   0    0           127.0.0.1       InLoopBack0

3.1.3  ip route-static

Syntax

ip route-static ip-address { mask | mask-length } { interface-name | nexthop-address } [ preference preference-value ] [ reject | blackhole ]

undo ip route-static ip-address { mask | mask-length } [ interface-name | nexthop-address ] [ preference preference-value | reject | blackhole ]

View

System view

Parameter

ip-address: Destination IP address in dotted decimal notation.

mask: Mask.

mask-length: Mask length. The 1s in the 32-bit mask must be consecutive; therefore, the mask in dotted decimal notation can be replaced by mask-length, which is the number of the consecutive 1s in the mask.

interface-name: Specifies the outgoing interface name of the static route. You may specify the public network interface as the outgoing interface.

nexthop-address: Specifies the next hop IP address (in dotted decimal notation) of the static route.

preference-value: Preference level of the static route ranging from 1 to 255.

reject: Indicates an unreachable route.

blackhole: Indicates a blackhole route.

Description

Use the ip route-static command to configure static routes.

Use the undo ip route-static to delete the static routes.

Two static routes to the same destination and with the same next hop but with different preferences are totally different. The route with the smaller preference value (higher preference level) will be chosen as the current route.

Use the undo ip route-static command to delete all the static routes to the same destination and with the same next hop.

Use the undo ip route-static preference command to delete the static routes with specified preference.

By default, the system obtains the sub-net route direct to the voice server. If no preference is specified when configuring static routes, its default value is 60. If reject or blackhole is not specified, it defaults to reachable routes.

Notes:

l           If the destination IP address and the mask are both 0.0.0.0, it is the default route. If it fails to find a route from the routing table, the packet will be forwarded via the default route.

l           You may flexibly apply the routing management policy for preference privilege setting. For instance, when configuring a number of routes to the same destination address, if the routes are of the same privilege, load sharing can be performed; if not, route backup can be performed.

l           To configure static route, you can specify either outgoing interface or next hop. Which one is adopted in practice depends on actual condition. For the interfaces which can translate network address to link layer address or point-to-point interface, transmission interface or next hop address can be specified. But for NBMA interfaces, that support point-to-multi-point, you should configure, besides IP route, secondary routes, i.e. the mapping from IP address to link layer address. In such condition, not the transmission interface but the next hop IP address should be configured when configuring static route.

l           When configuring two static routes with equal cost, you must do it in the same way, that is, configuring both to next hop, or both to outgoing interface. You cannot configure equal cost routes with different configurations.

Related command: display ip routing-table.

Example

# Set the next hop of the default route to 129.102.0.2.

[XE] ip route-static 0.0.0.0 0.0.0.0 129.102.0.2

 

H3C reserves the right to modify its collaterals without any prior notice. For the latest information of the collaterals, please consult H3C sales or call 400 hotline.