09-系统分册

02-系统基本配置命令

1 系统基本配置命令

1.1 系统基本配置命令

1.1.1 clock datetime

【命令】

clock datetime time date

【视图】

用户视图

【缺省级别】

3：管理级

【参数】

time：设置的时间，格式为HH:MM:SS（小时:分钟:秒），HH取值范围为0～23，MM和SS取值范围为0～59，除表示零点外，格式中的其它0可以省略不写。

date：设置的日期，格式为MM/DD/YYYY（月/日/年）或者YYYY/MM/DD（年/月/日），MM的取值范围为1～12，DD的取值范围与月份有关，YYYY的取值范围为2000～2035。

【描述】

clock datetime命令用来设置时间和日期。

在需要严格获取绝对时间的应用环境中，必须设定设备当前日期和时钟。在输入时间参数时，可以不输入秒。

相关配置可参考命令clock summer-time one-off、clock summer-time repeating、clock timezone和display clock。

【举例】

# 设置设备的系统时间为2005年8月1日14时10分20秒。

<Sysname> clock datetime 14:10:20 8/1/2005

# 设置设备的系统时间为2007年1月1日零点6分。

<Sysname> clock datetime 0:6 2007/1/1

1.1.2 clock summer-time one-off

【命令】

clock summer-time zone-name one-off start-time start-date end-time end-date add-time

undo clock summer-time

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

zone-name：夏令时名称，为1～32个字符的字符串，区分大小写。

start-time：起始时间，格式为HH:MM:SS，除表示零点外，格式中的其它0可以省略不写。

start-date：起始日期，格式为YYYY/MM/DD或MM/DD/YYYY。

end-time：结束时间，格式为HH:MM:SS，除表示零点外，格式中的其它0可以省略不写。

end-date：结束日期，格式为YYYY/MM/DD或MM/DD/YYYY。

add-time：相对于标准时间增加的时间，格式为HH:MM:SS，除表示零点外，格式中的其它0可以省略不写。

【描述】

clock summer-time one-off命令用来设置从“起始日期”的“起始时间”到“结束日期”的“结束时间”这个时间段内采用夏令时制，夏令时间要比设备的当前时间增加“add-time”。undo clock summer-time命令用来取消夏令时设置。

设置完成后，可以使用display clock命令进行查看。日志、debug等信息时间将采用经过时区和夏令时调整过的本地时间。

需要注意的是：

l 从“起始日期”的“起始时间”到“结束日期”的“结束时间”这个时间段长度必须大于1天小于1年，否则视为无效参数，配置失败。

l 如果当前系统时间在该命令指定的时间段内，则执行该命令后，系统时间将自动增加“add-time”。

相关配置可参考命令clock datetime、clock summer-time repeating、clock timezone和display clock。

【举例】

# 设置夏令时abc1，从2006年8月1日的06:00:00开始，到2006年9月1日的06:00:00结束，比当前设备标准时间增加1小时。

<Sysname> system-view

[Sysname] clock summer-time abc1 one-off 6 08/01/2006 6 09/01/2006 1

1.1.3 clock summer-time repeating

【命令】

clock summer-time zone-name repeating start-time start-date end-time end-date add-time

undo clock summer-time

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

zone-name：夏令时名称，为1～32个字符的字符串。

start-time：起始时间，格式为HH:MM:SS，除表示零点外，格式中的其它0可以省略不写。

start-date：起始日期，有两种设置方式：

l 直接一次性输入年月日，参数格式为YYYY/MM/DD或MM/DD/YYYY。

l 分次输入年、月、日，各参数之间以<空格>键隔开。首先输入开始的年份，取值范围2000～2035；其次输入开始的月份，取值如下：January、February、March、April、May、June、July、August、September、October、November、December；然后输入开始的星期（用当月的第几个星期表示），取值如下：first、second、third、fourth、fifth、last；最后输入起始日，取值为Sunday、Monday、Tuesday、Wednesday、Thursday、Friday、Saturday。

end-time：结束时间，格式为HH:MM:SS，除表示零点外，格式中的其它0可以省略不写。

end-date：结束日期，有两种设置方式：

l 直接一次性输入年月日，参数格式为YYYY/MM/DD或MM/DD/YYYY。

l 分次输入年、月、日，各参数之间以<空格>键隔开。首先输入结束的年份，取值范围2000～2035；其次输入结束的月份，取值如下：January、February、March、April、May、June、July、August、September、October、November、December；然后输入结束的星期（用当月的第几个星期表示），取值如下：first、second、third、fourth、fifth、last；最后输入结束日，取值为：Sunday、Monday、Tuesday、Wednesday、Thursday、Friday、Saturday。

add-time：相对于设备当前标准时间增加的时间，格式为HH:MM:SS，除表示零点外，格式中的其它0可以省略不写。

【描述】

clock summer-time repeating命令用来设置设备重复采用夏令时制。undo clock summer-time命令用来取消夏令时设置。

比如，当指定“start-date”和“start-time”为“2007/6/6”和“00:00:00”，指定“end-date”和“end-time”为“2007/10/1”和“00:00:00”，指定“add-time”为“01:00:00”，则表示从2007年开始（包括2007年）以后每年的6月6号的零点整到10月1号的零点整，都采用夏令时制，夏令时间要比设备的当前标准时间增加1小时。

设置完成后，可以使用display clock命令进行查看。日志、debug等信息时间将采用经过时区和夏令时调整过的本地时间。

需要注意的是：

l 从“起始日期”的“起始时间”到“结束日期”的“结束时间”这个时间段长度必须大于1天小于1年，否则视为无效参数，配置失败。

l 如果当前系统时间在该命令作用的时间段内，则执行该命令后，系统时间将自动增加“add-time”。

相关配置可参考命令clock datetime、clock summer-time one-off、clock timezone和display clock。

【举例】

# 设置夏令时abc2，从2007年开始（包括2007年）以后每年的8月1日的06:00:00到9月1日的06:00:00，比当前系统时间增加1小时。

<Sysname> system-view

[Sysname] clock summer-time abc2 repeating 06:00:00 08/01/2007 06:00:00 09/01/2007 01:00:00

1.1.4 clock timezone

【命令】

clock timezone zone-name { add | minus } zone-offset

undo clock timezone

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

zone-name：时区名称，为1～32个字符的字符串，区分大小写。

add：在UTC（Universal Time Coordinated，通用协调时间）标准时间的基础上增加指定时间。

minus：在UTC标准时间的基础上减少指定时间。

zone-offset：与UTC的时间差，格式为HH:MM:SS，HH取值范围为0～23，MM和SS取值范围为0～59，除表示零点外，格式中的其它0可以省略不写。

【描述】

clock timezone命令用来对本地时区信息进行设置。undo clock timezone命令用来恢复缺省情况。

缺省情况下，本地时区采用UTC（Universal Time Coordinated，世界调整时间）时区。

设置生效后，可以用display clock命令进行查看。日志、debug等信息时间将采用经过时区和夏令时调整过的本地时间。

相关配置可参考命令clock datetime、clock summer-time one-off、clock summer-time repeating和display clock。

【举例】

# 设置本地时区名称为Z5，比UTC标准时间增加5小时。

<Sysname> system-view

[Sysname] clock timezone Z5 add 5

1.1.5 command-alias enable

【命令】

command-alias enable

undo command-alias enable

【视图】

系统视图

【缺省级别】

2：系统级

【参数】

无

【描述】

command-alias enable命令用来使能命令行别名功能。undo command-alias enable命令用来关闭命令行别名的功能。

缺省情况下，命令行别名功能处于关闭状态，即用户不能给命令行指定别名。

【举例】

# 使能命令行别名功能。

<Sysname> system-view

[Sysname] command-alias enable

# 关闭命令行别名功能。

<Sysname> system-view

[Sysname] undo command-alias enable

1.1.6 command-alias mapping

【命令】

command-alias mapping cmdkey alias

undo command-alias mapping cmdkey

【视图】

系统视图

【缺省级别】

2：系统级

【参数】

cmdkey：表示将被别名替代的现有的某个命令的第一关键字，必须是完整的关键字名。

alias：表示命令的别名，该别名不能与设备上已有命令的第一个关键字相同。

【描述】

command-alias mapping命令用来给指定的命令行配置别名，undo command-alias mapping命令用来取消命令行别名的配置。

缺省情况下，命令行没有配置别名。

【举例】

# 配置关键字display的别名为show。

<Sysname> system-view

[Sysname] command-alias mapping display show

通过以上配置后，设备支持的原来命令中的display关键字就可以用show关键字来代替。比如：原命令为display clock，通过以上配置后，就可以输入show clock来查看系统时间了。

# 取消display的别名配置。

<Sysname> system-view

[Sysname] undo command-alias mapping display

1.1.7 command-privilege level

【命令】

command-privilege level level view view command

undo command-privilege view view command

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

level level：命令的级别，取值范围为0～3。

view view：命令行视图的名称，view的取值中shell表示用户视图。该参数必须是command所在的视图，具体命令所在视图请参见该命令解释的“【视图】”小节的描述。

command：需要设置的命令。

【描述】

command-privilege命令用来设置指定视图下的命令的级别。undo command-privilege命令用来恢复缺省情况。

缺省情况，各个视图下的每条命令都有指定的级别，详细介绍请参见“系统基本配置操作”中的“级别介绍”小节。

命令级别共分为访问、监控、系统、管理4个级别，分别对应标识0、1、2、3。管理员可以根据用户需要改变命令的级别，实现低级别用户可以使用部分高级别命令的功能。用户操作设备时，可以使用等于或者低于用户本身级别的所有命令。例如：某用户的级别是3级，则该用户可以使用3级及3级以下的命令。

需要注意的是：

l 通常情况下，建议用户不要修改缺省的命令级别或者在专业人员的指导下进行修改，以免造成操作和维护上的不便甚至给设备带来安全隐患。

l 配置command-privilege命令时，command参数必须是需要设置的命令的完整形式，即必须输入命令的所有关键字以及参数，参数只要在取值范围之内即可，对具体值没有限制。比如tftp server-address { get | put | sget } source-filename [ destination-filename ] [ source { interface interface-type interface-number | ip source-ip-address } ]命令的缺省级别为3，现配置命令command-privilege level 0 view shell tftp 1.1.1.1 put a.cfg，则当级别为0的用户登录设备时，可以执行tftp server-address put source-filename命令（比如tftp 192.168.1.26 put syslog.txt），但不能携带destination-filename和source参数，也不能执行get和sget操作。

l 配置undo command-privilege命令时，command参数可以使用省略形式，即只输入命令最前面的部分参数。比如执行undo command-privilege view system ftp，会将系统视图下所有以ftp关键字开头的命令（如ftp server acl、ftp server enable、ftp timeout等）的级别恢复到缺省级别。如果当前已经修改了ftp server enable和ftp timeout命令的级别，但只想将ftp server enable命令的级别恢复到缺省级别，则需要使用命令undo command-privilege view system ftp server。

l 如果将某视图下的某条命令的级别修改为低于缺省级别的级别，请注意相应的修改quit以及进入该视图命令的级别。比如interface和system-view命令的缺省级别均为2（系统级），如果要将interface命令开放给级别为1的用户使用，则需要配置command-privilege level 1 view shell system-view、command-privilege level 1 view system interface gigabitethernet 2/0/1、command-privilege level 1 view system quit，以便级别为1的用户登录设备后，能够进入系统视图、执行interface gigabitethernet命令、退回用户视图。

【举例】

# 将用户视图下的命令system-view的级别修改为3级。（缺省情况级别是2或3的用户登录设备后可以使用system-view命令，通过以下配置只有级别是3的用户才可以使用该命令进入系统视图，对设备进行配置，从而增强了设备的安全性）

<Sysname> system-view

[Sysname] command-privilege level 3 view shell system-view

1.1.8 copyright-info enable

【命令】

copyright-info enable

undo copyright-info enable

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

无

【描述】

copyright-info enable命令用来使能显示版权信息。undo copyright-info enable命令用来禁止显示版权信息。

缺省情况下，显示版权信息处于使能状态。

【举例】

# 配置使能显示版权信息。

<Sysname> system-view

[Sysname] copyright-info enable

l 使用Telnet方式登录设备，会显示如下信息：

****************************************************************************

* Without the owner's prior written consent, *

* no decompiling or reverse-engineering shall be allowed. *

****************************************************************************

l 如果当前已经使用Console口登录设备了，再退出用户视图，会显示如下信息：

****************************************************************************

* Without the owner's prior written consent, *

* no decompiling or reverse-engineering shall be allowed. *

****************************************************************************

User interface aux0 is available.

Please press ENTER.

1.1.9 display clipboard

【命令】

display clipboard

【视图】

任意视图

【缺省级别】

1：监控级

【参数】

无

【描述】

display clipboard命令用来显示剪贴板的内容。

将指定的内容复制到系统剪贴板的操作过程如下：

l 将光标移到需要剪贴部分的起始位置，按下<Esc+Shift+,>键（其中“,”是指英文格式的逗号）；

l 将光标移到需要剪贴部分的结束位置，按下<Esc+Shift+.>键（其中“.”是指英文格式的句号），则指定的内容便复制到系统剪贴板中了。

【举例】

# 查看系统剪贴板的内容。

<Sysname> display clipboard

---------------- CLIPBOARD-----------------

telnet server enable

1.1.10 display clock

【命令】

display clock

【视图】

任意视图

【缺省级别】

1：监控级

【参数】

无

【描述】

display clock命令用来显示系统当前的时间和日期。

该时间由clock datetime、clock summer-time one-off（或者clock summer-time repeating）和clock timezone命令联合决定，规则请参见配置手册中的“配置系统时间”一节。

相关配置可参考命令clock datetime、clock summer-time one-off、clock summer-time repeating和clock timezone。

【举例】

# 查看系统当前日期和时间。

<Sysname> display clock

09:41:23 UTC Thu 12/15/2005

1.1.11 display command-alias

【命令】

display command-alias

【视图】

任意视图

【缺省级别】

1：监控级

【参数】

无

【描述】

display command-alias命令用来显示当前用户设置的命令行及其别名。

【举例】

# 显示当前用户设置的命令行及其别名。

<Sysname> display command-alias

Command alias is enabled

index alias command key

1 show display

1.1.12 display current-configuration

【命令】

display current-configuration [ [ configuration [ configuration ] | interface [ interface-type ] [ interface-number ] ] [ by-linenum ] [ | { begin | exclude | include } regular-expression ] ]

【视图】

任意视图

【缺省级别】

2：系统级

【参数】

configuration [ configuration ]：显示非接口配置。如果不带参数，则显示所有的非接口配置；如果带参数，具体参数与设备型号和用户当前的配置有关，例如：

l isp：显示网络服务提供商的配置。

l post-system：显示后置配置。

l system：显示前置配置。

l user-interface：显示用户接口的配置。

interface [ interface-type ] [ interface-number ]：显示接口的配置。interface-type表示接口类型，interface-number表示接口编号。

by-linenum：显示每一行信息的行号。

|：使用正则表达式对显示进行过滤。有关正则表达式的详细介绍，请参见“系统分册/系统基本配置操作”中的“命令行显示”一节。

l begin：显示特定行及其以后的所有行，该特定行必须包含指定正则表达式。

l exclude：显示不包含指定正则表达式的所有行。

l include：只显示包含指定正则表达式的所有行。

regular-expression：表示正则表达式，为1～256个字符的字符串，可以包含空格，区分大小写。

【描述】

display current-configuration命令用来显示设备当前生效的配置。

当用户完成一组配置之后，需要验证是否配置正确，则可以执行display current-configuration命令来查看当前生效的参数。对于某些当前配置的参数，如果与缺省参数相同，则不显示。对于某些参数，虽然用户已经配置，但如果实际生效的参数发生了改变，则显示实际生效的参数，如：在某Loopback接口下配置的“ip address 11.11.11.11 24”，这时，执行display current-configuration后看到的配置为“ip address 11.11.11.11 255.255.255.255”，实际生效的掩码为32位。

相关配置可参考命令save、reset saved-configuration和display saved-configuration。

【举例】

# 查看当前生效的配置中，从包含“user-interface”字符串的行开始到最后一行的配置信息（该显示信息与设备型号以及用户的当前配置有关）。

<Sysname> display current-configuration | begin user-interface

user-interface aux 0

user-interface vty 0 4

authentication-mode none

user privilege level 3

return

# 查看当前设备上生效的SNMP配置（该显示信息与设备型号以及用户的当前配置有关）。

<Sysname> display current-configuration | include snmp

snmp-agent

snmp-agent local-engineid 800063A203000FE240A1A6

snmp-agent community read public

snmp-agent community write private

snmp-agent sys-info version all

undo snmp-agent trap enable ospf 100

1.1.13 display diagnostic-information

【命令】

display diagnostic-information

【视图】

任意视图

【缺省级别】

1：监控级

【参数】

无

【描述】

display diagnostic-information命令用来显示或保存系统当前多个功能模块运行的统计信息。

在日常维护或系统出现故障时，为了便于问题定位，用户需要查看各个功能模块的运行信息。因为各个功能模块都有其对应的运行信息，所以一般情况下，用户需要逐条运行相应的display命令。为便于一次性收集更多信息，用户可以在任意视图下执行display diagnostic-information命令，显示或保存系统当前多个功能模块运行的统计信息。display diagnostic-information命令一次性收集的信息等效于依次执行display clock、display version、display device、display current-configuration等命令后终端显示的信息。

【举例】

# 保存系统当前各个功能模块运行的统计信息。

<Sysname> display diagnostic-information

Save or display diagnostic information (Y=save, N=display)? [Y/N]:y

Please input the file name(*.diag)[flash:/default.diag]:aa.diag

Diagnostic information is outputting to flash:/aa.diag.

Please wait...

Save succeeded.

再在用户视图下执行“more aa.diag”命令，配合使用<Page Up>/<Page Down>键，可以查看aa.diag文件的记录的内容。

# 显示系统当前各个功能模块运行的统计信息（因为显示信息多，而且跟设备型号有关，请以设备的实际情况为准，此处略）。

<Sysname> display diagnostic-information

Save or display diagnostic information (Y=save, N=display)? [Y/N]:n

=================================================

===============display clock===============

=================================================

08:54:16 UTC Fri 11/15/2008

===================================================

===============display version===============

===================================================

……略……

1.1.14 display history-command

【命令】

display history-command

【视图】

任意视图

【缺省级别】

1：监控级

【参数】

无

【描述】

display history-command命令用来显示历史命令缓存区内保存的当前用户界面下的命令。

系统会把用户最近执行的有效命令保存到历史命令缓存区，但是该命令缓存区有大小限制，缺省保存10条命令，用户也可以通过history-command max-size命令来修改大小，相关配置可参考“系统分册”中的“登录交换机命令”。

【举例】

# 显示历史命令缓存区内保存的命令（显示信息与用户当前的配置有关）。

<Sysname> display history-command

display history-command

system-view

vlan 2

quit

1.1.15 display hotkey

【命令】

display hotkey

【视图】

任意视图

【缺省级别】

1：监控级

【参数】

无

【描述】

display hotkey命令用来显示系统中快捷键的分配信息。

【举例】

# 显示系统中快捷键的分配信息。

<Sysname> display hotkey

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

=Defined hotkeys=

Hotkeys Command

CTRL_G display current-configuration

CTRL_L display ip routing-table

CTRL_O undo debug all

=Undefined hotkeys=

Hotkeys Command

CTRL_T NULL

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.16 display this

【命令】

display this [ by-linenum ]

【视图】

任意视图

【缺省级别】

1：监控级

【参数】

by-linenum：显示每一行信息的行号。

【描述】

display this命令用来显示当前视图下生效的配置。

当用户在某一视图下完成一组配置之后，需要验证是否配置成功，则可以执行display this命令来查看当前生效的参数。

需要注意以下几点：

l 对于已经生效的配置参数如果与缺省工作参数相同，则不显示；

l 对于某些参数，虽然用户已经配置，但如果这些参数所在的功能没有生效，则不显示；

l 在任意一个用户界面视图下执行此命令，将会显示所有用户界面下生效的配置。

l 在任意一个VLAN视图下执行此命令，将会显示所有创建VLAN的配置。

【举例】

# 显示接口GigabitEthernet2/0/1下生效的配置（该显示信息与设备当前的配置有关）。

<Sysname> system-view

[Sysname] interface gigabitethernet 2/0/1

[Sysname-GigabitEthernet2/0/1] display this

interfaceGigabitEthernet2/0/1

port link-type hybrid

undo port hybrid vlan 1

port hybrid vlan 2 to 4 untagged

port hybrid pvid vlan 2

Return

# 显示所有用户界面下生效的配置（该显示信息与设备当前的配置有关）。

<Sysname> system-view

[Sysname] user-interface vty 0

[Sysname-ui-vty0] display this

user-interface aux 0

user-interface vty 0

history-command max-size 256

user-interface vty 1 4

return

1.1.17 display version

【命令】

display version

【视图】

任意视图

【缺省级别】

1：监控级

【参数】

无

【描述】

display version命令用来显示系统版本信息。

通过查看版本信息，可以获知系统当前使用的软件版本、机架类型、主控板及接口板的相关信息。

【举例】

# 查看系统版本信息（不同设备的版本信息不同，请以设备的实际情况为准，此处略）。

<Sysname> display version

1.1.18 header

【命令】

header { incoming | legal | login | motd | shell } text

undo header { incoming | legal | login | motd | shell }

【视图】

系统视图

【缺省级别】

2：系统级

【参数】

incoming：设置Modem登录用户登录进入用户视图时的欢迎信息。如果要求认证，则欢迎信息在通过认证后输出。

legal：设置登录终端界面前的授权信息，在输入认证用户名和密码前输出。

login：设置登录验证时的欢迎信息。

motd：设置登录终端界面前的欢迎信息。

shell：设置非Modem登录用户登录进入用户视图时的欢迎信息。

text：输入欢迎信息的内容。内容的输入支持单行和多行两种方式，具体规则请参见“系统基本配置操作”。

【描述】

header命令用来设置欢迎信息。undo header命令用来关闭欢迎信息。

【举例】

# 配置进入用户视图的欢迎信息。

<Sysname> system-view

[Sysname] header incoming %