目  录

1 设备管理

1.1 设备管理配置命令

1.1.1 clock datetime

1.1.2 clock protocol

1.1.3 clock summer-time

1.1.4 clock timezone

1.1.5 command

1.1.6 copyright-info enable

1.1.7 display clock

1.1.8 display copyright

1.1.9 display cpu-usage

1.1.10 display cpu-usage configuration

1.1.11 display cpu-usage history

1.1.12 display device

1.1.13 display diagnostic-information

1.1.14 display memory

1.1.15 display memory-threshold

1.1.16 display scheduler job

1.1.17 display scheduler logfile

1.1.18 display scheduler reboot

1.1.19 display scheduler schedule

1.1.20 display system stable state

1.1.21 display version

1.1.22 header

1.1.23 job

1.1.24 memory-threshold

1.1.25 memory-threshold usage

1.1.26 monitor cpu-usage enable

1.1.27 monitor cpu-usage interval

1.1.28 monitor cpu-usage threshold

1.1.29 password-recovery enable

1.1.30 reboot

1.1.31 reset scheduler logfile

1.1.32 reset version-update-record

1.1.33 restore factory-default

1.1.34 scheduler job

1.1.35 scheduler logfile size

1.1.36 scheduler reboot at

1.1.37 scheduler reboot delay

1.1.38 scheduler schedule

1.1.39 shutdown-interval

1.1.40 sysname

1.1.41 time at

1.1.42 time once

1.1.43 time repeating

1.1.44 user-role

 

1 设备管理

1.1  设备管理配置命令

1.1.1  clock datetime

clock datetime命令用来配置设备的系统时间。

【命令】

clock datetime time date

【缺省情况】

设备的系统时间为UTC时间2011年1月1日零点。

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

time：配置的时间，格式为HH:MM:SS（小时:分钟:秒），HH取值范围为0～23，MM和SS取值范围为0～59。如果要配置成整分，则可以不输入秒；如果要配置成整点，则可以不输入分和秒。比如将time参数配置为0表示零点。

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

【使用指导】

 

为了保证与其它设备协调工作，为了更好的监控和维护设备，请确保设备的系统时间是准确的。

请先配置clock protocol none命令，再执行本命令。clock datetime命令中指定的时间会立即生效，作为当前的系统时间。后续，设备使用内部晶体震荡器产生的时钟信号计时。

【举例】

# 配置设备的系统时间为2018年1月1日8时8分8秒。

<Sysname> clock datetime 8:8:8 1/1/2018

# 配置设备的系统时间为2018年1月1日8时10分。

<Sysname> clock datetime 8:10 2018/1/1

【相关命令】

·     clock protocol

·     clock summer-time

·     clock timezone

·     display clock

1.1.2  clock protocol

clock protocol命令用来配置系统时间的获取方式。

undo clock protocol命令用来恢复缺省情况。

【命令】

clock protocol { none | ntp }

undo clock protocol

【缺省情况】

通过NTP协议获取时间。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

none：表示通过命令行配置系统时间。

ntp：表示通过NTP（Network Time Protocol，网络时间协议）协议获取时间。关于NTP的详细介绍和配置，请参见“设备管理配置指导”中的“NTP”。

【使用指导】

为了保证与其它设备协调工作，为了更好的监控和维护设备，请确保设备的系统时间是准确的。

系统时间的获取方式有：

·     配置clock protocol none命令后，通过clock datetime命令直接配置。clock datetime命令中指定的时间即为当前的系统时间。后续，设备使用内部晶体震荡器产生的时钟信号计时。

·     配置clock protocol ntp命令后，通过NTP协议从网络中获取时间。该方式下，设备会周期性的同步服务器的UTC（Coordinated Universal Time，国际协调时间）时间，并用同步得到的UTC时间和设备上配置的本地时区、夏令时参数运算，得出当前的系统时间。该方式获取的时间比命令行配置的时间更精准，推荐使用。

多次执行本命令，最后一次执行的命令生效。

【举例】

# 配置获取UTC时间的方式为通过命令行配置。

<Sysname> system-view

[Sysname] clock protocol none

1.1.3  clock summer-time

clock summer-time命令用来配置夏令时。

undo clock summer-time命令用来恢复缺省情况。

【命令】

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

undo clock summer-time

【缺省情况】

未配置夏令时。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

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

start-time：开始时间，格式为HH:MM:SS，HH取值范围为0～23，MM和SS取值范围为0～59。如果要配置成整分，则可以不输入秒；如果要配置成整点，则可以不输入分和秒。

start-date：开始日期，有两种输入方式：

·     直接一次性输入月和日，参数格式为MM/DD，MM取值范围为1～12，DD的取值范围与月份有关。

·     分次输入月、日，各参数之间以<空格>键隔开。首先输入开始的月份，取值如下：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，HH取值范围为0～23，MM和SS取值范围为0～59。如果要配置成整分，则可以不输入秒；如果要配置成整点，则可以不输入分和秒。

end-date：结束日期，有两种输入方式：

·     直接一次性输入月日，参数格式为MM/DD，MM取值范围为1～12，DD的取值范围与月份有关。

·     分次输入月、日，各参数之间以<空格>键隔开。首先输入开始的月份，取值如下：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，HH取值范围为0～23，MM和SS取值范围为0～59。如果要配置成整分，则可以不输入秒；如果要配置成整点，则可以不输入分和秒。

【使用指导】

为了保证与其它设备协调工作，为了更好的监控和维护设备，请确保设备的系统时间是准确的。

配置该命令后，设备会自动重新计算当前的系统时间，计算后得到的系统时间可通过display clock命令查看。

请将所有网络设备的夏令时和当地夏令时保持一致。

【举例】

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

<Sysname> system-view

[Sysname] clock summer-time PDT 6 08/01 6 09/01 1

【相关命令】

·     clock datetime

·     clock timezone

·     display clock

1.1.4  clock timezone

clock timezone命令用来配置系统所在的时区。

undo clock timezone命令用来恢复缺省情况。

【命令】

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

undo clock timezone

【缺省情况】

系统所在的时区为零时区，即设备采用UTC时间。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

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

add：在UTC时间的基础上增加指定时间。

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

zone-offset：与UTC的时间差，格式为HH:MM:SS，HH取值范围为0～23，MM和SS取值范围为0～59，如果要配置成整分，则可以不输入秒；如果要配置成整点，则可以不输入分和秒。

【使用指导】

为了保证与其它设备协调工作，为了更好的监控和维护设备，请确保设备的系统时间是准确的。

配置该命令后，设备会自动重新计算当前的系统时间，计算后得到的系统时间可通过display clock命令查看。

请将所有网络设备的时区和当地地理时区保持一致。

【举例】

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

<Sysname> system-view

[Sysname] clock timezone Z5 add 5

【相关命令】

·     clock datetime

·     clock summer-time

·     display clock

1.1.5  command

command命令用来为Job分配命令。

undo command命令用来取消为Job分配的命令。

【命令】

command id command

undo command id

【缺省情况】

没有为Job分配命令。

【视图】

Job视图

【缺省用户角色】

network-admin

【参数】

id：命令编号，取值范围为0～4294967295。该编号表示命令在Job中的执行顺序，编号小的命令优先执行。

command：为Job分配的命令。

【使用指导】

多次输入command命令可以为当前Job分配多条命令，不同命令用编号来唯一区别。如果新分配命令的编号和已分配的某命令的编号相同，则新分配的命令会覆盖已分配的命令。

通过command分配的命令行必须是设备上可成功执行的命令行，不包括telnet、ftp、ssh2和monitor process。由用户保证配置的正确性，否则，命令行不能自动被执行。

如果需要分配的命令（假设为A）是用户视图下的命令，则直接使用command命令分配即可；如果需要分配的命令（假设为A）是非用户视图下的命令，则必须先分配进入A所在视图的命令（指定较小的id值），再分配A。

定时执行任务时，设备不会与用户交互信息。当需要用户交互确认时，系统将自动输入“Y”或“Yes”；当需要用户交互输入字符信息时，系统将自动输入缺省字符串，没有缺省字符串的将自动输入空字符串。

【举例】

# 为名称为backupconfig的Job分配命令，以便将配置文件startup.cfg备份到TFTP服务器192.168.100.11。

<Sysname> system-view

[Sysname] scheduler job backupconfig

[Sysname-job-backupconfig] command 2 tftp 192.168.100.11 put flash:/startup.cfg backup.cfg

# 为Job（假设名称为shutdownGE）分配命令，以便将接口GigabitEthernet1/0关闭。

<Sysname> system-view

[Sysname] scheduler job shutdownGE

[Sysname-job-shutdownGE] command 1 system-view

[Sysname-job-shutdownGE] command 2 interface gigabitethernet 1/0

[Sysname-job-shutdownGE] command 3 shutdown

【相关命令】

·     scheduler job

1.1.6  copyright-info enable

copyright-info enable命令用来开启版权信息显示功能。

undo copyright-info enable命令用来关闭版权信息显示功能。

【命令】

copyright-info enable

undo copyright-info enable

【缺省情况】

版权信息显示功能处于开启状态。

【视图】

系统视图

【缺省用户角色】

network-admin

【举例】

# 开启版权信息显示功能。

<Sysname> system-view

[Sysname] copyright-info enable

重新登录设备后，会显示如下信息：

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

* Copyright (c) 2004-2019 New H3C Technologies Co., Ltd. All rights reserved.*

* Without the owner's prior written consent,                                 *

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

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

1.1.7  display clock

display clock命令用来显示系统当前的时间、日期、本地时区以及夏令时配置。

【命令】

display clock

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【使用指导】

显示信息中，时间的格式采用“时:分:秒.毫秒”的格式。

【举例】

# 未配置本地时区时，显示系统当前日期和时间。

<Sysname> display clock

10:09:00 UTC Fri 03/16/2018

# 配置了本地时区Z5后，显示系统当前日期和时间。

<Sysname> display clock

15:10:00 Z5 Fri 03/16/2018

Time Zone : Z5 add 05:00:00

# 配置了本地时区Z5和夏令时PDT后，显示系统当前日期和时间。

<Sysname> display clock

15:11:00 Z5 Fri 03/16/2018

Time Zone : Z5 add 05:00:00

Summer Time : PDT 06:00:00 08/01 06:00:00 09/01 01:00:00

【相关命令】

·     clock datetime

·     clock timezone

·     clock summer-time

1.1.8  display copyright

display copyright命令用来显示设备的版权信息。

【命令】

display copyright

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【举例】

# 显示设备的版权信息。

<Sysname> display copyright

显示信息略……。

1.1.9  display cpu-usage

display cpu-usage命令用来显示CPU利用率的统计信息。

【命令】

display cpu-usage [ data-plane ]  [ summary ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

data-plane：显示数据平面CPU利用率的统计信息。不指定control-plane和data-plane参数时，显示整个CPU利用率的统计信息。

summary：以列表形式显示CPU利用率的统计信息。不指定该参数时，以区段形式显示CPU利用率的统计信息。

【使用指导】

当最近5秒、最近1分钟、最近5分钟的CPU利用率取值均显示为“--”时，可能原因为命令行从设备内部数据库获取数据失败，请稍候重试。

【举例】

# 以段的形式显示当前CPU利用率统计信息。

<Sysname> display cpu-usage

CPU usage:

       1% in last 5 seconds

       1% in last 1 minute

       1% in last 5 minutes

# 以表的形式显示当前CPU利用率统计信息。

<Sysname> display cpu-usage summary

CPU        Last 5 sec        Last 1 min        Last 5 min

0          2%                2%                10%

表1-1 display cpu-usage命令显示信息描述表

字段	描述
1% in last 5 seconds	设备启动后，会以5秒为周期计算并记录一次该5秒内的CPU的平均利用率。该字段显示的是最近一个5秒统计周期内CPU的平均利用率
Last 5 sec	设备启动后，会以5秒为周期计算并记录一次该5秒内的CPU的平均利用率。该字段显示的是最近一个5秒统计周期内CPU的平均利用率
1% in last 1 minute	设备启动后，会以1分钟为周期计算并记录一次该1分钟内的CPU的平均利用率。该字段显示的是最近一个1分钟统计周期内CPU的平均利用率
Last 1 min	设备启动后，会以1分钟为周期计算并记录一次该1分钟内的CPU的平均利用率。该字段显示的是最近一个1分钟统计周期内CPU的平均利用率
1% in last 5 minutes	设备启动后，会以5分钟为周期计算并记录一次该5分钟内的CPU的平均利用率。该字段显示的是最近一个5分钟统计周期内CPU的平均利用率
Last 5 min	设备启动后，会以5分钟为周期计算并记录一次该5分钟内的CPU的平均利用率。该字段显示的是最近一个5分钟统计周期内CPU的平均利用率

 

1.1.10  display cpu-usage configuration

display cpu-usage configuration命令用来显示CPU利用率历史信息记录功能的相关配置。

【命令】

display cpu-usage configuration

【视图】

任意视图

【缺省用户角色】

network-admin

【举例】

# 显示CPU利用率历史信息记录功能的相关配置。

<Sysname> display cpu-usage configuration

CPU usage monitor is enabled.

Current monitor interval is 60 seconds.

Current monitor threshold is 90%.

表1-2 display cpu-usage configuration命令显示信息描述表

字段	描述
CPU usage monitor is enabled.	CPU利用率历史记录功能处于开启状态
Current monitor interval is 60 seconds.	CPU利用率历史记录的采样周期为60秒
Current monitor threshold is 90%.	CPU利用率阈值为90%

‌

【相关命令】

·     monitor cpu-usage enable

·     monitor cpu-usage interval

·     monitor cpu-usage threshold

1.1.11  display cpu-usage history

display cpu-usage history命令用来以图表方式显示CPU利用率的历史信息。

【命令】

display cpu-usage history [ job job-id ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

job job-id：显示指定进程的CPU利用率的历史信息。job-id表示进程的编号，取值范围为1～2147483647。不指定该参数时，显示的是整个系统的相应信息（整个系统的CPU利用率等于所有进程CPU利用率之和）。可以使用display process命令可以查看当前运行的进程的编号和名称，display process命令的详细介绍请参见“网络管理与监控”中的“系统维护与调试”。

【使用指导】

开启CPU利用率历史记录功能后，系统每隔一定时间（可通过monitor cpu-usage interval命令配置）会对CPU的利用率进行采样，并把采样结果保存到历史记录区。通过display cpu-usage history命令可以查看到最近60个采样点的值。结果以坐标的形式进行显示，显示信息中：

·     纵坐标表示利用率，采用就近显示的原则。比如，利用率的间隔为5％，则实际统计值53％将被显示成55％，实际统计值52％将被显示成50％。

·     横坐标表示时间，时间越靠左表示距离当前时间越近。

·     用连续的#号表示该时刻的利用率，某个时间点上最高处的#号对应的纵坐标值即为该时刻CPU的利用率。

【举例】

# 以图表方式显示CPU利用率的历史记录。

<Sysname> display cpu-usage history

100%|

 95%|

 90%|

 85%|

 80%|

 75%|

 70%|

 65%|

 60%|

 55%|

 50%|

 45%|

 40%|

 35%|

 30%|

 25%|

 20%|

 15%|             #

 10%|            ###  #

  5%|           ########

     ------------------------------------------------------------

              10        20        30        40        50        60  (minutes)

                      cpu-usage last 60 minutes (SYSTEM)

以上显示信息表明系统（用“SYSTEM”表示）在最近60分钟内CPU的利用率情况：12分钟前大约为5％，13分钟前大约为10％，14分钟前大约为15％，15分钟前大约为10％，16、17分钟前大约为5％，18分钟前大约为10％，19分钟前大约为5％，其它时间均小于或等于2％。

【相关命令】

·     monitor cpu-usage enable

·     monitor cpu-usage interval

1.1.12  display device

display device命令用来显示设备信息。

【命令】

display device [ verbose ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

verbose：显示设备的详细信息。不指定该参数时，显示设备的简要信息，且此时不会显示防火墙插卡的信息。

【举例】

# 显示设备信息。

<Sysname> display device

Slot No.  Board Type                Status    Max Ports                       

 -------------------------------------------------------                       

 0         MPU                       Normal       0                            

 1         VNIC-E1000                Normal       1                            

 2         VNIC-E1000                Normal       1                            

 3         VNIC-VMXNET3              Normal       1                            

表1-3 display device命令显示信息描述表

字段	描述
Board Type	设备的硬件类型
Status	设备的状态： ·     Illegal表示该设备不能正常工作 ·     Normal表示该设备处于正常工作状态
Max Ports	设备的物理端口数

‌

 

1.1.13  display diagnostic-information

display diagnostic-information命令用来收集诊断信息。

【命令】

display diagnostic-information [ hardware | infrastructure | l2 | l3 | service ] [ key-info ] [ filename ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

hardware：收集硬件相关的诊断信息。

infrastructure：收集基础模块的诊断信息。

l2：收集二层特性相关诊断信息。

l3：收集三层特性相关诊断信息。

service：收集上层业务模块相关诊断信息。

key-info：收集关键诊断信息。当设备异常或者运行时间较长时，可能会产生较多诊断信息，此时，使用该关键字，即可以收集到关键的诊断信息，又可以缩短诊断信息的收集时间。不指定该参数时，收集当前全部诊断信息。

filename：表示将收集到的诊断信息保存到指定文件。filename表示文件的名称，后缀必须为“.tar.gz”。不指定该参数时，用户可根据提示信息选择将诊断信息保存到指定文件或者是直接显示诊断信息。

【使用指导】

在日常维护或系统出现故障时，为了便于问题定位，用户需要查看各个模块的诊断信息。因为各个功能模块都有其对应的运行信息，所以一般情况下，用户需要逐条运行相应的display命令。为便于一次性收集更多信息，用户可以在任意视图下执行display diagnostic-information命令，收集多个模块的诊断信息。

使用该命令，用户可以直接显示指定的诊断信息或者将诊断信息直接保存到指定文件，因为诊断信息较多，系统会自动将该文件压缩后保存，文件名后缀为“.tar.gz”。如果要在设备上查看该文件的内容，请执行以下操作：

(1)     使用tar extract命令将文件XXXX.tar.gz解包成文件XXXX.gz。

(2)     使用gunzip命令将文件XXXX.gz解包成文件XXXX。

(3)     使用more命令查看文件XXXX的内容。

如果收集诊断文件过程半途中止，可能导致gunzip命令无法正常解压，但诊断文件中仍包括已经生成的诊断信息，可以将诊断文件传输到PC上使用Linux系统下的gunzip -c命令解压查看。

不指定filename参数执行display diagnostic-information命令时，系统会要求用户选择显示诊断信息还是将诊断信息保存到文件中。如果用户选择保存诊断信息，且当系统提示用户输入文件名时直接回车，设备会自动将当前诊断信息保存到一个新文件，并使用设备名称和当前系统时间为该文件命名，以免和现有文件重名，导致现有文件被覆盖。如果设备名称中包含“/”、“\”、“:”、“*”、“?”、“<”、“>”、“|”、“"”等特殊字符，在给诊断文件命名时，这些特殊字符会被转换为下划线“_”。比如设备的名称为A/B，设备会使用形如flash:/diag_A_B_20180101-000438.tar.gz的字符串为新生成的诊断文件命名。

未指定hardware、infrastructure、l2、l3和service参数时，将收集设备产生的所有诊断信息。

该命令不支持“|”、“>”和“>>”参数。

执行本命令收集诊断信息时，请不要配置设备，以免影响收集结果。

【举例】

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

<Sysname> display diagnostic-information

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

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

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

14:03:55 UTC Thu 01/05/2018

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

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

显示信息略……。

# 将收集到的诊断信息保存到缺省诊断文件。

<Sysname> display diagnostic-information

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

Please input the file name(*.tar.gz)[flash:/diag_Sysname_20180101-024601.tar.gz]:

Diagnostic information is outputting to flash:/diag_Sysname_20180101-024601.tar.gz.

Please wait...

Save successfully.

请在“Please input the file name”提示信息处，直接回车。

# 将收集到的诊断信息保存到文件test.tar.gz。

<Sysname> display diagnostic-information test.tar.gz

Diagnostic information is outputting to flash:/test.tar.gz.

Please wait...

Save successfully.

【相关命令】

·     gunzip（基础配置命令参考/文件系统管理）

·     more（基础配置命令参考/文件系统管理）

·     tar extract（基础配置命令参考/文件系统管理）

1.1.14  display memory

display memory命令用来显示内存使用情况。

【命令】

display memory [ summary ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

summary：显示内存使用情况的简要信息。不指定该参数时，显示内存使用情况的详细信息。

【使用指导】

当显示信息中某一行所有参数的取值均显示为“--”时，可能原因为命令行从设备内部数据库获取数据失败，请稍候重试。

【举例】

# 显示设备的内存使用情况的详细信息。

<Sysname> display memory

Memory statistics are measured in KB:

Slot 0:

             Total      Used      Free    Shared   Buffers    Cached   FreeRatio

Mem:       7969068    882800   7086268         0      6640    356572       91.4%

-/+ Buffers/Cache:    519588   7449480

Swap:

# 显示设备的内存使用情况的简要信息。

<Sysname> display memory summary

Memory statistics are measured in KB:

CPU   Total      Used      Free      Buffers  Caches    FreeRatio

0     16296192   798744    15497448  1964     177776    95.1%

表1-4 display memory命令显示信息描述表

字段	描述
Memory statistics are measured in KB:	系统内存使用情况，以下统计信息均以KB为单位
Mem	内存使用信息
Total	系统可分配的物理内存的大小 设备总物理内存分为不可分配物理内存和可分配物理内存。其中，不可分配物理内存用于内核代码段存储、内核管理开销等；可分配物理内存用于支撑业务模块的运行、文件存储等操作。不可分配内存的大小由设备根据系统运行需要自动计算划分，可分配物理内存的大小等于设备总物理内存减去不可分配内存的大小
Used	整个系统已用的物理内存大小
Free	整个系统可用的物理内存大小
Shared	多个进程共享的物理内存总额。取值为“--”时，表示不支持统计该参数的值
Buffers	已使用的文件缓冲区的大小。取值为“--”时，表示不支持统计该参数的值
Cached	高速缓冲寄存器已使用的内存大小。取值为“--”时，表示不支持统计该参数的值
Caches	高速缓冲寄存器已使用的内存大小
FreeRatio	整个系统物理内存的空闲率
-/+ Buffers/Cache	-/+ Buffers/Cache:used = Mem:Used – Mem:Buffers – Mem:Cached，表示应用程序已用的物理内存大小 -/+ Buffers/Cache:free = Mem:Free + Mem:Buffers + Mem:Cached，表示应用程序可用的物理内存大小
Swap	交换分区的使用信息

 

1.1.15  display memory-threshold

display memory-threshold命令用来显示内存告警门限相关信息。

【命令】

display memory-threshold

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【使用指导】

当设备已经使用的物理内存大小超过内存某个告警门限阈值时，系统会认为发生了一次该类型内存异常，并记录第一次、最近一次发生异常的时间，以及这段时间内发生的该类异常的次数。如果想了解该类异常的详细情况，请查看日志信息，可按日志摘要关键字“MEM_EXCEED_THRESHOLD”或“MEM_BELOW_THRESHOLD”进行搜索。

【举例】

# 显示内存告警门限相关信息。

<Sysname> display memory-threshold

Memory usage threshold: 100%                                                    

Free memory threshold:                                                         

    Minor: 96M                                                                 

    Severe: 64M                                                                

    Critical: 48M                                                              

    Normal: 128M                                                               

Current memory state: Normal                                                   

Event statistics:                                                               

 [Back to normal state]                                                        

    First notification: 0.0                                                    

    Latest notification: 0.0                                                    

    Total number of notifications sent: 0                                      

 [Enter minor low-memory state]                                                

    First notification at: 0.0                                                  

    Latest notification at: 0.0                                                

    Total number of notifications sent: 0                                      

 [Back to minor low-memory state]                                              

    First notification at: 0.0                                                 

    Latest notification at: 0.0                                                

    Total number of notifications sent: 0                                      

 [Enter severe low-memory state]                                               

    First notification at: 0.0                                                 

    Latest notification at: 0.0                                                

    Total number of notifications sent: 0                                      

 [Back to severe low-memory state]                                             

    First notification at: 0.0                                                  

    Latest notification at: 0.0                                                

    Total number of notifications sent: 0                                      

 [Enter critical low-memory state]                                              

    First notification at: 0.0                                                 

    Latest notification at: 0.0                                                

    Total number of notifications sent: 0                                       

表1-5 display memory-threshold命令显示信息描述表

字段	描述
Memory usage threshold	内存利用率阈值
Free memory threshold     Minor     Severe     Critical     Normal	剩余内存门限阈值： ·     Minor：一级告警门限，单位为MB ·     Severe：二级告警门限，单位为MB ·     Critical：三级告警门限，单位为MB ·     Normal：恢复到正常状态的阈值，单位为MB
Current memory state	系统当前内存使用状态： ·     Normal：正常状态 ·     Minor：一级告警门限状态 ·     Severe：二级告警门限状态 ·     Critical：三级告警门限状态
Event statistics	门限事件统计信息，事件分为： ·     Back to normal state：内存恢复到正常状态 ·     Enter minor low-memory state：进入一级告警门限状态 ·     Back to minor low-memory state：恢复到一级告警前的状态 ·     Enter severe low-memory state：进入二级告警门限状态 ·     Back to severe low-memory state：恢复到二级告警前的状态 ·     Enter critical low-memory state：进入三级告警门限状态
First notification at	事件第一次发生的时间，格式yyyy-mm-dd hh:mm:ss.msec
Latest notification at	事件最近一次发生的时间，格式yyyy-mm-dd hh:mm:ss.msec
Total number of notifications send	事件发生的总次数

 

1.1.16  display scheduler job

display scheduler job命令用来显示Job的配置信息。

【命令】

display scheduler job [ job-name ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

job-name：Job的名称，为1～47个字符的字符串，区分大小写。不指定该参数时，则显示所有Job的配置信息。

【举例】

# 查看所有Job的配置信息。

<Sysname> display scheduler job

Job name: saveconfig

 copy startup.cfg backup.cfg

 

Job name: backupconfig

 

Job name: creat-VLAN100

 system-view

 vlan 100

以上显示信息表明，设备当前配置了3个Job，分别显示了Job的名称，以及为Job分配的命令（如果没有为Job分配命令，则只显示Job的名称），不同Job间用空行分隔。

1.1.17  display scheduler logfile

display scheduler logfile命令用来显示Job的执行日志信息。

【命令】

display scheduler logfile

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【举例】

# 显示Schedule日志文件的相关信息。

<Sysname> display scheduler logfile

Logfile Size: 1902 Bytes.

 

Job name        : shutdown

Schedule name   : shutdown

Execution time  : Tue May 23 10:44:42 2018

Completion time : Tue May 23 10:44:47 2018

--------------------------------- Job output -----------------------------------

<Sysname> system-view

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

[Sysname] interface gigabitethernet 1/0

[Sysname-GigabitEthernet1/0] shutdown

表1-6 display scheduler logfile命令显示信息描述表

字段	描述
Logfile Size	Schedule日志文件的大小，单位为字节
Job name	Job的名称
Schedule name	Schedule的名称
Execution time	开始执行Job的时间
Completion time	Job执行结束的时间（没有调度的或者没有分配命令的Job，均不会显示该信息）
Job output	Job中的命令执行时的输出信息

 

【相关命令】

·     reset scheduler logfile

1.1.18  display scheduler reboot

display scheduler reboot命令用来显示定时重启功能的相关配置。

【命令】

display scheduler reboot

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【举例】

# 显示定时重启功能的相关配置。

<Sysname> display scheduler reboot

System will reboot at 16:32:00 05/23/2018 (in 1 hours and 39 minutes).

【相关命令】

·     scheduler reboot at

·     scheduler reboot delay

1.1.19  display scheduler schedule

display scheduler schedule命令用来显示Schedule的相关信息。

【命令】

display scheduler schedule [ schedule-name ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

schedule-name：Schedule的名称，为1～47个字符的字符串，区分大小写。如果不指定该参数，则显示所有Schedule的信息。

【举例】

# 显示所有Schedule的信息。

<Sysname> display scheduler schedule

Schedule name        : shutdown

Schedule type        : Run once after 0 hours 2 minutes

Start time           : Tue May 23 10:44:42 2018

Last execution time  : Tue May 23 10:44:42 2018

Last completion time : Tue May 23 10:44:47 2018

Execution counts     : 1

-----------------------------------------------------------------------

Job name                                          Last execution status

shutdown                                          Successful

表1-7 display scheduler schedule命令显示信息描述表

字段	描述
Schedule name	Schedule的名称
Schedule type	Schedule的执行时间配置。如果没有为Schedule配置执行时间，则不会显示该信息
Start time	Schedule第一次开始执行的时间。如果没有为Schedule配置执行时间，则不会显示该信息
Last execution time	Schedule上一开始执行的时间 ·     如果没有为Schedule配置执行时间，则不会显示该信息 ·     如果还没有执行，则显示Yet to be executed
Last completion time	Schedule上一次执行完成的时间。如果没有为Schedule配置执行时间，则不会显示该信息
Execution counts	Schedule已经执行的次数。如果Schedule还没有执行，则不会显示该信息
Job name	Schedule下关联的Job的名称
Last execution status	Job上一次被执行的状态（Job下分配的命令是否执行以及执行结果，请通过display scheduler logfile命令查看） ·     Successful：表示执行成功 ·     Failed：表示执行失败 ·     Waiting：表示正在等待被执行 ·     In process：表示正在执行 ·     -NA-：表示还没有到执行时间

 

1.1.20  display system stable state

display system stable state命令用来显示系统的稳定状态。

【命令】

display system stable state

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【使用指导】

设备启动需要一定的时间，才能达到Stable状态。可以通过该命令查看设备是否进入Stable状态，根据其具体状态，采取进一步措施。

系统处于不稳定状态时，需要结合相关命令查看设备的具体情况。例如：

·     通过display device命令查看设备是否处于故障状态。

·     通过Probe视图下的display system internal process state命令查看服务启动状态。

操作时，建议多次执行命令，以确认稳定状态的连续性。

【举例】

# 显示系统的稳定状态。

<Sysname> display system stable state

System state    : Stable

  Role      State

  Active    Stable

表1-8 display system stable state命令显示信息描述表

字段	描述
System state	系统状态，取值为Stable表示稳定运行
Role	设备的角色，取值为Active
State	设备状态： ·     Stable：设备处于稳定运行
*	表示当前对象处于未稳定状态

 

【相关命令】

·     display device

1.1.21  display version

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

【命令】

display version

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【举例】

# 查看系统版本信息。

<Sysname> display version

H3C Comware Software, Version 7.1.064, Customer 5420

Copyright (c) 2004-2019 New H3C Technologies Co., Ltd. All rights reserved.

H3C VAC1000 uptime is 0 weeks, 1 day, 0 hours, 9 minutes

Last reboot reason : User reboot

Boot image: flash:/boot.bin

Boot image version: 7.1.064, Customer 5420

  Compiled Mar 06 2019 16:00:00

System image: flash:/system.bin

System image version: 7.1.064, Customer 5420

  Compiled Mar 06 2019 16:00:00

 

显示信息略……。

表1-9 display version命令显示信息描述表

字段	描述
H3C Comware Software, Version 7.1.064, Customer 5420	表示设备使用的软件版本
Copyright (c) 2004-2019 New H3C Technologies Co., Ltd. All rights reserved.	表示设备的版权申明
H3C VAC1000 uptime is 0 weeks, 1 day, 0 hours, 9 minutes	表示设备的型号以及本次启动后的持续运行时间
Last reboot reason	表示设备上次重启的原因，主要取值有： ·     User reboot：表示用户通过命令行、SNMP等方式重启设备 ·     Power on：表示断电导致的重启 ·     Exception reboot：表示内核异常导致的重启 ·     Heart-beat timeout：表示设备管理握手失败导致的重启 ·     Auto reboot after updating：表示版本升级导致的自动重启
Boot image: flash:/boot.bin Boot image version: 7.1.064, Customer 5420   Compiled Mar 06 2019 16:00:00	表示设备当前运行过程中使用的Boot包以及该软件包的版本、编译时间

‌

1.1.22  header

header命令用来配置欢迎信息。

undo header命令用来取消配置的欢迎信息。

【命令】

header { legal | login | motd | shell } text

undo header { legal | login | motd | shell }

【缺省情况】

未配置欢迎信息。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

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

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

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

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

text：欢迎信息的内容。内容的输入支持单行和多行两种方式，具体输入规则请参见“设备管理配置指导”中的“设备管理”。

【举例】

# 配置legal欢迎信息。

<Sysname> system-view

[Sysname] header legal

Please input banner content, and quit with the character '%'.

Welcome to use the legal banner%

1.1.23  job

job命令用来为Schedule分配Job。

undo job命令用来将Job从Schedule中删除。

【命令】

job job-name

undo job job-name

【缺省情况】

未为Schedule分配Job。

【视图】

Schedule视图

【缺省用户角色】

network-admin

【参数】

job-name：Job的名称，为1～47个字符的字符串，区分大小写。

【使用指导】

多次执行该命令，可以为Schedule分配多个Job。多个Job在Schedule指定的时间同时执行，没有先后顺序。

分配的Job必须是设备上已经创建的Job，否则不能分配。Job可以通过scheduler job命令来创建。

【举例】

# 为Schedule分配一个名称为save-job的Job。

<Sysname> system-view

[Sysname] scheduler schedule saveconfig

[Sysname-schedule-saveconfig] job save-job

【相关命令】

·     scheduler job

·     scheduler schedule

1.1.24  memory-threshold

memory-threshold命令用来配置空闲内存告警的门限值。

undo memory-threshold命令用来恢复缺省情况。

【命令】

memory-threshold minor minor-value severe severe-value critical critical-value normal normal-value

undo memory-threshold

【缺省情况】

不同设备的空闲内存告警门限值可能不同，请先使用undo memory-threshold命令恢复缺省情况后，再通过display memory-threshold命令查看设备的缺省空闲内存告警门限值。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

minor minor-value：一级告警门限。输入该参数的值时可通过输入?，来获取该参数的取值范围。取值为0时，表示关闭该级门限告警功能。

severe severe-value：二级告警门限。输入该参数的值时可通过输入?，来获取该参数的取值范围。取值为0时，表示关闭该级门限告警功能。

critical critical-value：三级告警门限。输入该参数的值时可通过输入?，来获取该参数的取值范围。取值为0时，表示关闭该级门限告警功能。

normal normal-value：系统内存恢复正常状态时的内存大小。输入该参数的值时可通过输入?，来获取该参数的取值范围。

【使用指导】

系统实时监控系统剩余空闲内存大小，当条件达到一级、二级、三级告警门限或者恢复正常状态门限时，就产生相应的告警/告警解除通知，通知关联的业务模块/进程采取相应的措施，以便最大限度的利用内存，又能保证设备的正常运行。

关于告警门限的详细介绍请参见“设备管理配置指导”中的“设备管理”。

【举例】

# 配置一级、二级、三级告警门限分别为64MB、48MB、32MB，当系统剩余空闲内存大于96MB时，恢复到正常状态。

<Sysname> system-view

[Sysname] memory-threshold minor 64 severe 48 critical 32 normal 96

【相关命令】

·     display memory-threshold

1.1.25  memory-threshold usage

memory-threshold usage命令用来配置内存利用率阈值。

undo memory-threshold usage命令用来恢复缺省情况。

【命令】

memory-threshold usage memory-threshold

undo memory-threshold usage

【缺省情况】

内存利用率阈值为100%。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

memory-threshold：内存利用率阈值百分比，取值范围为0～100。

【使用指导】

系统每隔1分钟会对内存利用率进行采样，并将采样值和用户配置的内存利用率阈值比较。当采样值大时，则认为内存利用率过高，设备会发送Trap报文。

【举例】

# 配置内存利用率阈值为80%。

<Sysname> system-view

[Sysname] memory-threshold usage 80

【相关命令】

·     display memory-threshold

1.1.26  monitor cpu-usage enable

monitor cpu-usage enable命令用来开启CPU利用率历史记录功能。

undo monitor cpu-usage enable命令用来关闭CPU利用率历史记录功能。

【命令】

monitor cpu-usage enable

undo monitor cpu-usage enable

【缺省情况】

CPU利用率历史记录功能处于开启状态。

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

开启CPU利用率历史记录功能后，系统会每隔一定时间（可通过monitor cpu-usage interval命令配置）对CPU的利用率进行采样，并把采样结果保存到历史记录区。这些记录可通过display cpu-usage history命令查看，以便用户监控设备近期的运行情况。

【举例】

# 打开CPU利用率历史记录功能。

<Sysname> system-view

[Sysname] monitor cpu-usage enable

【相关命令】

·     display cpu-usage configuration

·     display cpu-usage history

·     monitor cpu-usage interval

1.1.27  monitor cpu-usage interval

monitor cpu-usage interval命令用来配置CPU利用率历史记录的采样周期。

【命令】

monitor cpu-usage interval interval

【缺省情况】

CPU利用率历史记录采样周期为1分钟。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

interval：CPU利用率历史记录采用周期，取值为5Sec、1Min或者5Min，不区分大小写。输入该参数时，请完整输入，否则，系统会提示参数错误。

【使用指导】

开启CPU利用率历史记录功能后，系统会每隔一定时间（可通过monitor cpu-usage interval命令配置）对CPU的利用率进行采样，并把采样结果保存到历史记录区。这些记录可通过display cpu-usage history命令查看，以便用户监控设备近期的运行情况。

【举例】

# 配置CPU利用率历史记录的采样周期为5秒。

<Sysname> system-view

[Sysname] monitor cpu-usage interval 5Sec

【相关命令】

·     display cpu-usage configuration

·     display cpu-usage history

·     monitor cpu-usage enable

1.1.28  monitor cpu-usage threshold

monitor cpu-usage threshold命令用来配置CPU利用率告警门限。

undo monitor cpu-usage threshold命令用来恢复缺省情况。

【命令】

monitor cpu-usage threshold severe-threshold

undo monitor cpu-usage threshold

【缺省情况】

CPU利用率告警门限是99%。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

severe-threshold：CPU利用率高级别告警门限，取值范围为1～100，单位为百分比。

【使用指导】

 

系统每隔1分钟会对CPU的利用率进行采样，并将采样值和用户配置的告警门限比较。当采样值大时，则认为利用率过高，设备会进行相应的处理。

【举例】

# 配置CPU利用率告警门限为90%。

<Sysname> system-view

[Sysname] monitor cpu-usage threshold 90

【相关命令】

·     display cpu-usage configuration

1.1.29  password-recovery enable

password-recovery enable命令用来开启密码恢复功能。

undo password-recovery enable命令用来关闭密码恢复功能。

【命令】

password-recovery enable

undo password-recovery enable

【缺省情况】

密码恢复功能处于开启状态。

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

配置密码恢复功能后，当用户忘记Console口认证密码或者登录认证失败，导致无法使用命令行操作设备时，可通过BootWare菜单清除该认证密码，再继续使用设备；关闭密码恢复功能后，设备将处于一个安全性更高的状态，即当出现上述情况时，若想继续使用Console口对设备进行命令行操作，只能通过BootWare菜单选择将设备恢复为出厂配置之后方可继续操作，这样可以有效地防止非法用户获取启动配置文件。

BootWare菜单中支持配置的选项与密码恢复功能的配置有关，详见设备的版本说明书。

【举例】

# 关闭密码恢复功能。

<Sysname> system-view

[Sysname] undo password-recovery enable

1.1.30  reboot

reboot命令用来重启设备。

【命令】

reboot [ force ]

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

force：强制重启：

·     不指定该参数时，重启设备，系统会做一些保护性检查（如启动文件是否存在，是否正在写磁盘等），若检查不通过则退出处理，不会重启设备；

·     指定该参数时，系统将不进行任何检查，直接执行重启操作。

【使用指导】

 

如果主用启动文件损坏或者不存在，则不能通过reboot命令重启设备。此时，可以通过指定新的主用启动文件再重启。

如果设备在准备重启时，用户正在进行文件操作，为了安全起见，系统将不会执行此次重启操作。

【举例】

# 重启设备，并保存配置文件。

<Sysname> reboot

Start to check configuration with next startup configuration file, please wait.........DONE!

Current configuration may be lost after the reboot, save current configuration? [Y/N]:y

Please input the file name(*.cfg)[flash:/startup.cfg]

(To leave the existing filename unchanged, press the enter key):

flash:/startup.cfg exists, overwrite? [Y/N]:y

Validating file. Please wait...

Configuration is saved to device successfully.

This command will reboot the device. Continue? [Y/N]:y

Now rebooting, please wait...

# 强制重启设备。

<Sysname> reboot force

A forced reboot might cause the storage medium to be corrupted. Continue? [Y/N]:y

Now rebooting, please wait...

【相关命令】

·     display system stable state

1.1.31  reset scheduler logfile

reset scheduler logfile命令用来清除Schedule日志文件的相关信息。

【命令】

reset scheduler logfile

【视图】

用户视图

【缺省用户角色】

network-admin

【举例】

# 清除Schedule日志文件的相关信息。

<Sysname> reset scheduler logfile

【相关命令】

·     display scheduler logfile

1.1.32  reset version-update-record

reset version-update-record命令用来清除启动软件包版本更新操作的记录。

【命令】

reset version-update-record

【视图】

系统视图

【缺省用户角色】

network-admin

【举例】

# 清除设备启动软件包版本更新操作的记录。

<Sysname> system-view

[Sysname] reset version-update-record

This command will delete all records of version update. Continue? [Y/N]:y

【相关命令】

·     display version-update-record

1.1.33  restore factory-default

restore factory-default命令用来将设备恢复到出厂状态。

【命令】

restore factory-default

【视图】

用户视图

【缺省用户角色】

network-admin

【使用指导】

 

请谨慎使用该命令。

当设备使用场景更改，或者设备出现故障时，可以使用本命令来将设备恢复到出厂状态。

【举例】

# 将设备恢复到出厂状态。

<Sysname> restore factory-default

This command will restore the system to the factory default configuration and clear the operation data, and forcibly reboot the system. Continue [Y/N]:y

Restoring the factory default configuration. This process might take a few minutes. Please wait..........................................................................................................Done.

Please reboot the system to place the factory default configuration into effect.

【相关命令】

·     reboot

1.1.34  scheduler job

scheduler job命令用来创建Job，并进入Job视图。如果指定的Job已存在，则直接进入Job视图。

undo scheduler job命令用来删除已创建的Job。

【命令】

scheduler job job-name

undo scheduler job job-name

【缺省情况】

不存在Job。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

job-name：Job的名称，为1～47个字符的字符串，区分大小写。

【使用指导】

一个Job可以被多个Schedule引用。Job视图下用户可以通过command命令为Job分配命令。

【举例】

# 创建名称为backupconfig的Job并进入Job视图。

<Sysname> system-view

[Sysname] scheduler job backupconfig

[Sysname-job-backupconfig]

【相关命令】

·     command

·     scheduler schedule

1.1.35  scheduler logfile size

scheduler logfile size命令用来配置Schedule日志文件的大小。

【命令】

scheduler logfile size value

【缺省情况】

Schedule日志文件的大小为16KB。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

value：Schedule日志文件的大小，取值范围为16～1024，单位是KB。

【使用指导】

Schedule日志文件用来记录Job下命令行的执行结果。如果该文件的大小超过了用户配置值，则系统会把老的记录删除，用来记录新的记录。如果要记录的日志信息超长，超过了日志文件的大小，则该日志超出的部分不会记录。

【举例】

# 配置Schedule日志文件的大小为32KB。

<Sysname> system-view

[Sysname] scheduler logfile size 32

【相关命令】

·     display scheduler logfile

1.1.36  scheduler reboot at

scheduler reboot at命令用来配置设备重启的具体时间和日期。

undo scheduler reboot命令用来取消定时重启配置。

【命令】

scheduler reboot at time [ date ]

undo scheduler reboot

【缺省情况】

未配置设备重启的具体时间和日期。

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

time：设备重启的时间，格式为HH:MM。HH代表小时，取值范围为0～23，MM代表分钟，取值范围为0～59。

date：设备重启的日期，格式为MM/DD/YYYY（月/日/年）或者YYYY/MM/DD（年/月/日）。

·     YYYY的取值范围为2000～2035；

·     MM的取值范围为1～12；

·     DD的取值范围与具体月份有关。

【使用指导】

 

如果没有指定date参数，并且：

·     配置的时间点在当前时间之后，则设备将在当天的该时间点重启；

·     配置的时间点在当前时间之前，则设备将在第二天的该时间点重启。

多次配置scheduler reboot at、scheduler reboot delay命令，最后一次执行的命令生效。

如果设备在准备重启时，用户正在进行文件操作，为了安全起见，系统将不会执行此次重启操作。

【举例】

# 假设系统的当前时间为2018年6月6日11:43，配置设备在当天中午12:00重启。

<Sysname> scheduler reboot at 12:00

Reboot system at 12:00:00 06/06/2018 (in 0 hours and 16 minutes). Confirm? [Y/N]:

【相关命令】

·     scheduler reboot delay

1.1.37  scheduler reboot delay

scheduler reboot delay命令用来配置重启设备的延迟时间。

undo scheduler reboot命令用来取消定时重启配置。

【命令】

scheduler reboot delay time

undo scheduler reboot

【缺省情况】

未配置重启设备的延迟时间。

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

time：设备重启的等待时延，格式为HH:MM（小时:分钟）或MM（分钟）。

·     使用HH:MM格式时，MM的取值范围为0～59，HH:MM的最大长度为6个字符。

·     使用MM格式时，最大长度为6个字符。

【使用指导】

 

多次配置scheduler reboot at、scheduler reboot delay命令，最后一次执行的命令生效。

如果设备在准备重启时，用户正在进行文件操作，为了安全起见，系统将不会执行此次重启操作。

【举例】

# 假设系统的当前时间为2018年6月6日11:48，配置设备在88分钟后重启。

<Sysname> scheduler reboot delay 88

Reboot system at 13:16 06/06/2018(in 1 hour and 28 minutes). Confirm? [Y/N]:

1.1.38  scheduler schedule

scheduler schedule命令用来创建Schedule，并进入相应的Schedule视图。如果指定的Schedule已存在，则直接进入Schedule视图。

undo scheduler schedule命令用来删除指定Schedule。

【命令】

scheduler schedule schedule-name

undo scheduler schedule schedule-name

【缺省情况】

不存在Schedule。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

schedule-name：Schedule的名称，为1～47个字符的字符串，区分大小写。

【使用指导】

使用scheduler schedule命令可以配置定时执行任务，让设备在指定时间执行指定命令。

配置步骤如下：

(1)     使用scheduler job命令创建Job。

(2)     在Job视图下，使用command命令配置需要执行的命令。

(3)     使用scheduler schedule命令创建Schedule。

(4)     在Schedule视图下，使用job命令为Schedule分配Job。一个Schedule下可以分配多个Job，但必须是已创建的Job，否则分配失败。

(5)     在Schedule视图下，使用user-role命令为Schedule配置用户角色。一个Schedule下最多可以分配64个角色。

(6)     在Schedule视图下，使用time at、time once或者time repeating命令来配置任务执行的时间。一个Schedule下只能配置一个执行时间。

【举例】

# 创建名为saveconfig的Schedule。

<Sysname> system-view

[Sysname] scheduler schedule saveconfig

【相关命令】

·     job

·     time at

·     time once

1.1.39  shutdown-interval

shutdown-interval命令用来配置端口状态检测定时器的时长。

undo shutdown-interval命令用来恢复缺省情况。

【命令】

shutdown-interval interval

undo shutdown-interval

【缺省情况】

端口状态检测定时器的时长为30秒。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

interval：端口状态检测定时器的时长，取值范围为0～300，单位为秒。取值为0时，表示不进行定时检测。

【使用指导】

某些协议模块在特定情况下会自动关闭某个端口。同时，系统会启动一个检测定时器，如果直到定时器超时（即经过time秒之后），该端口仍处于关闭状态，协议模块则自动激活该端口，令其恢复到真实的物理状态。

如果用户在端口定时检测过程中将检测时间间隔修改为T1，修改时刻距协议关闭端口时间间隔为T。

·     若T<T1，则被关闭的端口会再经过T1-T时间后被恢复。

·     若T>=T1，则被关闭的端口会立即恢复。

例如当前time配置为30，当端口被协议模块关闭2秒（T=2）后，修改time为10（T1=10），则该接口会再经过8秒后被恢复；如果当前time为30，端口被协议模块关闭10秒后，修改time为2，则该端口会立即恢复。

【举例】

# 配置端口状态检测定时器的时长为100秒。

<Sysname> system-view

[Sysname] shutdown-interval 100

1.1.40  sysname

sysname命令用来配置设备的名称。

undo sysname用来恢复缺省情况。

【命令】

sysname sysname

undo sysname

【缺省情况】

设备的名称为H3C。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

sysname：设备名称，为1～64个字符的字符串。

【使用指导】

设备的名称对应于命令行接口的提示符，如设备的名称为Sysname，则用户视图的提示符为<Sysname>。

【举例】

# 配置设备的名称为R2000。

<Sysname> system-view

[Sysname] sysname R2000

[R2000]

1.1.41  time at

time at命令用来配置在指定时刻执行Schedule。

undo time命令用来为Schedule取消执行时间配置。

【命令】

time at time date

undo time

【缺省情况】

未为Schedule配置执行时间。

【视图】

Schedule视图

【缺省用户角色】

network-admin

【参数】

time：Schedule的执行时间，格式为HH:MM（小时:分钟）。HH取值范围为0～23，MM取值范围为0～59。

date：Schedule执行的日期，格式为MM/DD/YYYY（月/日/年）或者YYYY/MM/DD（年/月/日）。

·     YYYY的取值范围为2000～2035；

·     MM的取值范围为1～12；

·     DD的取值范围与具体月份有关。

【使用指导】

配置的时间点必须晚于系统当前时间点，否则配置失败。

一个Schedule只能配置一个执行时间。因此，同一Schedule视图下，多次执行time at、time once或time repeating命令时，最后一次执行的命令生效。

【举例】

# 配置2018年5月11日1点1分执行名称为saveconfig的Schedule。

<Sysname> system-view

[Sysname] scheduler schedule saveconfig

[Sysname-schedule-saveconfig] time at 1:1 2018/05/11

【相关命令】

·     scheduler schedule

1.1.42  time once

time once命令用来为Schedule配置执行时间。

undo time命令用来为Schedule取消执行时间配置。

【命令】

time once at time [ month-date month-day | week-day week-day&<1-7> ]

time once delay time

undo time

【缺省情况】

未为Schedule配置执行时间。

【视图】

Schedule视图

【缺省用户角色】

network-admin

【参数】

at time：Schedule的执行时间，格式为HH:MM（小时:分钟）。HH取值范围为0～23，MM取值范围为0～59。

month-date month-day：Schedule在一个月中的哪天被执行。month-day表示日期，取值范围为1～31。如果指定了一个本月不存在的日期，则实际生效的时间为下一个月的该日期，比如，二月没有30号，则实际生效的时间为三月的30号。

week-day week-day&<1-7>：Schedule在一周中的哪（些）天被执行。week-day&<1-7>表示一周中任一天或几天的组合，week-day取值为：Mon、Tue、Wed、Thu、Fri、Sat、Sun，&<1-7>表示前面的参数最多可以输入7次。配置多天时，字符串之间用空格分开。

delay time：指定Schedule延迟执行的时间。格式为HH:MM（小时:分钟）或MM（分钟）。

·     使用HH:MM格式时，MM的取值范围为0～59，HH:MM最大长度为6个字符。

·     使用MM格式时，最大长度为6个字符。

【使用指导】

配置该命令后，Schedule在该设定时间点到达时执行，若当天/本月/本周该时间点已过去，则顺延到第二天/下月/下周。执行后下次再到达该时间点时Schedule不再执行。

一个Schedule只能配置一个执行时间。因此，同一Schedule视图下，多次执行time at、time once或time repeating命令时，最后一次执行的命令生效。

【举例】

# 当天的15点执行名称为saveconfig的Schedule。

<Sysname> system-view

[Sysname] scheduler schedule saveconfig

[Sysname-schedule-saveconfig] time once at 15:00

# 最近到达的15号的15点执行名称为saveconfig的Schedule。

<Sysname> system-view

[Sysname] scheduler schedule saveconfig

[Sysname-schedule-saveconfig] time once at 15:00 month-date 15

# 最近一个周一和周五的12点整执行名称为saveconfig的Schedule。

<Sysname> system-view

[Sysname] scheduler schedule saveconfig

[Sysname-schedule-saveconfig] time once at 12:00 week-day mon fri

# 延迟10分钟执行名称为saveconfig的Schedule。

<Sysname> system-view

[Sysname] scheduler schedule saveconfig

[Sysname-schedule-saveconfig] time once delay 10

【相关命令】

·     scheduler schedule

1.1.43  time repeating

time repeating命令用来配置重复执行Schedule的时间。

undo time命令用来为Schedule取消执行时间配置。

【命令】

time repeating [ at time [ date ] ] interval interval

time repeating at time [ month-date [ month-day | last ] | week-day week-day&<1-7> ]

undo time

【缺省情况】

未配置重复执行Schedule的时间。

【视图】

Schedule视图

【缺省用户角色】

network-admin

【参数】

at time：表示重复执行的时间，格式为HH:MM（小时:分钟）。HH取值范围为0～23，MM取值范围为0～59。不指定该参数时，表示从现在开始。

date：指定Schedule重复执行的开始日期，格式为MM/DD/YYYY（月/日/年）或者YYYY/MM/DD（年/月/日）。不指定该参数时，表示将来第一次到达time的时间点的日期。

·     YYYY的取值范围为2000～2035；

·     MM的取值范围为1～12；

·     DD的取值范围与具体月份有关。

interval interval：指定重复执行的时间间隔。格式为HH:MM（小时:分钟）或MM（分钟）。

·     使用HH:MM格式时，MM的取值范围为0～59，最大长度为6个字符。

·     使用MM格式时，取值的最小值为1，最大长度为6个字符。

month-date [ month-day | last ]：表示每月中的某一天。其中，month-day表示日期，取值范围为1～31。如果指定了一个本月不存在的日期，则实际生效的时间为下一个月的该日期，比如，二月没有30号，则实际生效的时间为三月的30号。last表示每月的最后一天。

week-day week-day&<1-7>：表示每周中的某（些）天。week-day&<1-7>表示一周中任一天或几天的组合，week-day取值为：Mon、Tue、Wed、Thu、Fri、Sat、Sun，&<1-7>表示前面的参数最多可以输入7次。配置多天时，字符串之间用空格分开。

【使用指导】

time repeating [ at time [ date ] ] interval interval表示从指定时间开始，周期性执行Schedule。

time repeating at time [ month-date [ month-day | last ] | week-day week-day&<1-7> ]表示每月/每周的某（些）天重复执行Schedule。

一个Schedule只能配置一个执行时间。因此，同一Schedule视图下，多次执行time at、time once或time repeating命令时，最后一次执行的命令生效。

【举例】

# 配置从早上八点开始，每隔1小时执行一次名称为saveconfig的Schedule。

<Sysname> system-view

[Sysname] scheduler schedule saveconfig

[Sysname-schedule-saveconfig] time repeating at 8:00 interval 60

# 配置从现在开始每天的12:00执行名称为saveconfig的Schedule。

<Sysname> system-view

[Sysname] scheduler schedule saveconfig

[Sysname-schedule-saveconfig] time repeating at 12:00

# 配置从现在开始每个月5号的上午8点执行名称为saveconfig的Schedule。

<Sysname> system-view

[Sysname] scheduler schedule saveconfig

[Sysname-schedule-saveconfig] time repeating at 8:00 month-date 5

# 配置从现在开始每个月的最后一天8点执行名称为saveconfig的Schedule。

<Sysname> system-view

[Sysname] scheduler schedule saveconfig

[Sysname-schedule-saveconfig] time repeating at 8:00 month-date last

# 配置从现在开始每个周五和周六的上午8点执行名称为saveconfig的Schedule。

<Sysname> system-view

[Sysname] scheduler schedule saveconfig

[Sysname-schedule-saveconfig] time repeating at 8:00 week-day fri sat

【相关命令】

·     scheduler schedule

1.1.44  user-role

user-role命令用来配置执行Schedule时使用的用户角色。

undo user-role命令用来将已经配置的用户角色从Schedule中删除。

【命令】

user-role role-name

undo user-role role-name

【缺省情况】

执行Schedule时使用的用户角色，为创建该Schedule的用户的用户角色。

【视图】

Schedule视图

【缺省用户角色】

network-admin

【参数】

role-name：用户角色的名称，为1～63个字符的字符串，区分大小写。可以是系统预定义的角色名称，包括network-admin、network-operator、level-0～level-15，也可以是自定义的用户角色名称。

【使用指导】

设备支持的每条命令执行时都需要相应的用户角色。只有本命令中配置的用户角色具有权限，Schedule中的command命令中指定的命令行才能执行。关于用户角色的详细描述请参见“基础配置指导”中的“RBAC”。

同一Schedule最多可配置64个用户角色，超过该上限后，新配置会执行失败。

【举例】

# 配置执行定时任务test时使用的用户角色为rolename。

<sysname> system-view

[Sysname] scheduler schedule test

[Sysname-schedule-test] user-role rolename

【相关命令】

·     command

·     scheduler schedule