目  录

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 diagnostic-information

1.1.10 display scheduler job

1.1.11 display scheduler logfile

1.1.12 display scheduler reboot

1.1.13 display scheduler schedule

1.1.14 display system stable state

1.1.15 header

1.1.16 job

1.1.17 reboot

1.1.18 reset scheduler logfile

1.1.19 restore factory-default

1.1.20 scheduler job

1.1.21 scheduler logfile size

1.1.22 scheduler reboot at

1.1.23 scheduler reboot delay

1.1.24 scheduler schedule

1.1.25 sysname

1.1.26 time at

1.1.27 time once

1.1.28 time repeating

1.1.29 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命令中指定的时间会立即生效，作为当前的系统时间。后续，设备使用内部晶体震荡器产生的时钟信号计时。

设备断电重启后，该命令会恢复到缺省情况，需要重新配置。

【举例】

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

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

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

<Sysname> clock datetime 8:10 2019/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/1关闭。

<Sysname> system-view

[Sysname] scheduler job shutdownGE

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

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

[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-2020 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/2019

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

<Sysname> display clock

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

Time Zone : Z5 add 05:00:00

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

<Sysname> display clock

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

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 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_20160101-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/2015

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

  ===============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_20160101-024601.tar.gz]:

Diagnostic information is outputting to flash:/diag_Sysname_20160101-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.10  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.11  display scheduler logfile

display scheduler logfile命令用来显示Schedule日志文件的相关信息。

【命令】

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 Dec 27 10:44:42 2019

Completion time : Tue Dec 27 10:44:47 2019

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

<Sysname>system-view

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

[Sysname]interface rang gigabitethernet 1/0/1 to gigabitethernet 1/0/3

[Sysname-if-range]shutdown

表1-1 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.12  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/2019 (in 1 hours and 39 minutes).

【相关命令】

·     scheduler reboot at

·     scheduler reboot delay

1.1.13  display scheduler schedule

display scheduler schedule命令用来显示定时执行任务的相关信息。

【命令】

display scheduler schedule [ schedule-name ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

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

【举例】

# 显示所有定时执行任务的信息。

<Sysname> display scheduler schedule

Schedule name        : shutdown

Schedule type        : Run once after 0 hours 2 minutes

Start time           : Tue Dec 27 10:44:42 2019

Last execution time  : Tue Dec 27 10:44:42 2019

Last completion time : Tue Dec 27 10:44:47 2019

Execution counts     : 1

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

Job name                                          Last execution status

shutdown                                          Successful

表1-2 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.14  display system stable state

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

【命令】

display system stable state

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

【使用指导】

在进行ISSU升级或主备倒换前，请先执行该命令，检查设备是否处于稳定状态。如果System State未处于Stable状态，不能进行ISSU升级；如果Redundancy Stable未处于Stable状态，不能进行主备倒换。

设备/单板/MDC/Context启动需要一定的时间，才能达到Stable状态。如果设备/单板/MDC/Context长时间未能进入Stable状态，可通过该命令的显示信息找出未稳定的设备/单板/MDC/Context，根据其具体状态，采取进一步措施。

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

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

·     通过display ha service-group命令查看HA服务组的状态，以找出未批备完成的模块。

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

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

【举例】

# 显示系统的稳定状态。

<Sysname> display system stable state

System state    : Stable

  Role      State

  Active    Stable

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

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

 

【相关命令】

·     display device（设备管理命令参考/硬件资源管理）

·     display ha service-group（可靠性命令参考/进程分布优化）

1.1.15  header

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

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

【命令】

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

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

【缺省情况】

未配置欢迎信息。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

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

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

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

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

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

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.16  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.17  reboot

reboot命令用来重启设备。

【命令】

reboot [ force ]

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

force：强制重启：

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

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

【使用指导】

 

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

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

【举例】

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

<Sysname> reboot

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

Current configuration will 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.18  reset scheduler logfile

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

【命令】

reset scheduler logfile

【视图】

用户视图

【缺省用户角色】

network-admin

【举例】

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

<Sysname> reset scheduler logfile

【相关命令】

·     display scheduler logfile

1.1.19  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 cl

ear the operation data, and forcibly reboot the system. Continue [Y/N]:y       

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

Please wait....Done.

The system is rebooting...

【相关命令】

·     reboot

1.1.20  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.21  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.22  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命令，最后一次执行的命令生效。

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

【举例】

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

<Sysname> scheduler reboot at 12:00

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

【相关命令】

·     scheduler reboot delay

1.1.23  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命令，最后一次执行的命令生效。

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

【举例】

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

<Sysname> scheduler reboot delay 88

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

【相关命令】

·     scheduler reboot at

1.1.24  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.25  sysname

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

undo sysname用来恢复缺省情况。

【命令】

sysname sysname

undo sysname

【缺省情况】

设备的名称为H3C。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

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

【使用指导】

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

【举例】

# 配置设备的名称为MyDevice。

<Sysname> system-view

[Sysname] sysname MyDevice

[MyDevice]

1.1.26  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命令时，最后一次执行的命令生效。

【举例】

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

<Sysname> system-view

[Sysname] scheduler schedule saveconfig

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

【相关命令】

·     scheduler schedule

·     time once

·     time repeating

1.1.27  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

·     time at

·     time repeating

1.1.28  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

·     time at

·     time once

1.1.29  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