目  录

1 下发目标配置

1.1 下发目标配置命令

1.1.1 commit

1.1.2 configuration commit auto-save path

1.1.3 configuration commit max-number

1.1.4 configuration replace

1.1.5 display configuration commit diff

1.1.6 display configuration commit list

1.1.7 display configuration sessions

1.1.8 display target-configuration

1.1.9 refresh target-configuration

1.1.10 reset configuration commit

1.1.11 reset target-configuration

 

1 下发目标配置

1.1  下发目标配置命令

1.1.1  commit

commit命令用来下发目标配置。

【命令】

commit [ best-effort ] [ force ] [ label labelname ] [ save-running filename ] [ confirmed [ seconds | minutes minutes ] ] [ show-error ] [ clear-error ] [ description text ]

【视图】

私有模式下的任意视图

独占模式下的任意视图

【缺省用户角色】

network-admin

network-operator

mdc-admin

mdc-operator

【参数】

best-effort：表示目标配置中包含错误命令行时，设备将忽略错误命令行下发目标配置。如果不指定该参数，目标配置中包含错误命令行时，目标配置下发操作失败，系统继续使用下发目标配置操作以前的配置运行。

force：下发目标配置时不检查内存。如果不指定该参数，设备下发目标配置前，首先查看内存状态是否处于正常状态，若内存异常则目标配置下发操作失败，系统继续使用下发目标配置操作以前的配置运行。

label labelname：指定回滚点的标签。配置回滚时可以指定该标签，将运行配置回滚到该标签对应回滚点的配置。labelname表示标签的名称，必须以字母开头，为1～20个字符的字符串，区分大小写。该标签全局唯一。

save-running filename: 执行commit命令前先将当前运行配置保存到配置文件中，filename表示配置文件名称，文件名部分必须以“.cfg”为后缀，其长度不能超过255个字符。

confirmed：指定超时回滚时间，配置该参数后，用户需要在超时时间内再次执行commit命令确认目标配置下发操作；如果在该时间内没有执行commit命令，则系统自动回滚到下发目标配置操作以前的配置。如果不指定该参数，则直接下发目标配置，不会回滚到下发目标配置操作以前的配置。

seconds：表示超时时间，单位为秒，取值范围为30～65535，缺省为600秒。

minutes minutes：表示超时时间，单位为分钟，取值范围为1～1024，缺省为10分钟。

show-error：表示如果下发目标配置失败，显示执行失败的命令行。如果不指定该参数，下发目标配置失败时，则不显示执行失败的命令行。

clear-error：表示如果下发目标配置失败，则同时清除目标配置里的错误配置。

description text：配置回滚点的描述信息。text为描述信息的内容，为1～60个字符的字符串，区分大小写。

【使用指导】

目标配置下发成功后，设备会创建配置回滚点。如果短时间内多次执行commit操作，使得设备同时创建多个配置回滚点，导致设备负载过大，有可能使目标配置下发失败，因此请不要频繁的执行commit操作。

【举例】

# 执行目标配置下发操作，目标配置中包含错误命令行时，继续下发目标配置。

<Sysname> system-view private

~[Sysname] commit best-effort

Wait for the configuration commit: Done.

~[Sysname]

1.1.2  configuration commit auto-save path

configuration commit auto-save path命令用来开启执行commit命令时自动保存当前运行配置功能，并配置相关参数。

undo configuration commit auto-save path命令用来关闭执行commit命令时自动保存当前运行配置功能。

【命令】

configuration commit auto-save path directory filename-prefix filename-prefix [ user user-name [ password { cipher | simple } string ] | vpn-instance vpn-instance-name ] *

undo configuration commit auto-save path

【缺省情况】

执行commit命令时自动保存当前运行配置功能处于关闭状态。

【视图】

系统视图

【缺省用户角色】

network-admin

mdc-admin

【参数】

directory：表示自动保存当前运行配置的文件的文件夹的路径，为1～63个字符的字符串，不区分大小写，格式为存储介质名:/[文件夹名]/子文件夹名。directory必须是主用主控板或FTP/TFTP服务器上已存在的路径，且参数中不能包含槽位号。（独立运行模式）

directory：表示自动保存当前运行配置的文件的文件夹的路径，为1～63个字符的字符串，不区分大小写，格式为存储介质名:/[文件夹名]/子文件夹名。directory必须是全局主用主控板或FTP/TFTP服务器上已存在的路径，且参数中不能包含成员编号和槽位号。（IRF模式）

filename-prefix filename-prefix：配置文件的前缀名，即“.cfg”文件的前缀名。文件路径与文件名的总长度不能超过255个字符。

user user-name：配置文件的自动保存路径在FTP服务器上时，FTP服务器的登录用户名。

password：配置文件的自动保存路径在FTP服务器上时，FTP服务器的登录密码。

cipher：表示以密文方式设置密码。

simple：表示以明文方式设置密码，该密码将以密文形式存储。

string：密码字符串，区分大小写。明文密码为1～63个字符的字符串，密文密码为33～117个字符的字符串。

vpn-instance vpn-instance-name：指定远程服务器所属的VPN实例。vpn-instance-name表示MPLS L3VPN的VPN实例名称，为1～31个字符的字符串，区分大小写。如果未指定本参数，则表示远程服务器位于公网中。

【使用指导】

使用commit命令用来下发目标配置时，可以通过save-running filename参数在执行commit命令前先将当前运行配置保存到配置文件中。执行此命令后，执行commit命令且不指定save-running filename参数时，系统会自动先将当前运行配置保存到配置文件中。保存的路径为directory，配置文件的前缀名为filename-prefix。如果用户在执行commit命令时指定了save-running filename参数，则当前运行配置的保存以save-running filename参数为准，本命令的配置不生效。

当自动保存当前运行配置的文件的文件夹的路径为FTP或TFTP服务器时，路径的URL格式如表1-1所示：

表1-1 FTP和TFTP服务器的URL格式

协议类型	URL格式	说明
FTP	ftp://服务器地址[:端口号]/文件路径	ftp://1.1.1.1/file表示地址为1.1.1.1的TFTP服务器工作目录下的file路径
TFTP	tftp://服务器地址[:端口号]/文件路径	tftp://1.1.1.1/file表示地址为1.1.1.1的TFTP服务器工作目录下的file路径

 

服务器地址为IPv6地址时，必须用中括号“[]”将IPv6地址括起来，以便将IPv6地址和端口号区分开。例如：ftp://test:test@[2001::1]:21/test.cfg，其中，2001::1为FTP服务器的IPv6地址，21为FTP协议的端口号。命令时自动保存

如果directory是FTP服务器的路径，则user user-name参数为必选。如果未指定user user-name参数，则configuration commit auto-save path命令下发不成功；如果directory是TFTP服务器的路径，则user user-name参数无意义。如果用户指定了user user-name参数，则系统会自动忽略user user-name参数并正常下发configuration commit auto-save path命令。

【举例】

# 开启执行commit命令时自动保存当前运行配置功能，并配置自动保存路径为ftp://1.1.1.1/BackupFile/，及配置文件的前缀名为backupcfg，FTP服务器的登录用户名为admin，明文密码为123456。

<Sysname> system-view private

~[Sysname] configuration commit auto-save path ftp://1.1.1.1/BackupFile/ filename-prefix backupcfg user admin password simple 123456

# 开启执行commit命令时自动保存当前运行配置功能，并配置自动保存路径为flash:/BackupFile/，及配置文件的前缀名为save。

<Sysname> system-view private

~[Sysname] configuration commit auto-save path flash:/BackupFile/ filename-prefix save

【相关命令】

·     commit

1.1.3  configuration commit max-number

configuration commit max-number命令用来配置系统最多可创建的回滚点的数量。

undo configuration commit max-number命令用来恢复缺省情况。

【命令】

configuration commit max-number max-number

undo configuration commit max-number

【缺省情况】

系统最多可创建的回滚点的数量为100。

【视图】

系统视图

【缺省用户角色】

network-admin

mdc-admin

【参数】

max-number：配置系统最多可创建的回滚点的数量，取值范围为1～65535。

【使用指导】

当系统创建的回滚点数量超过当前配置的回滚点数量时，系统先删除最早的回滚点再保存最新生成的回滚点。

【举例】

# 配置系统最多可创建10个回滚点。

<Sysname> system-view

[Sysname] configuration commit max-number 10

1.1.4  configuration replace

configuration replace命令用来执行配置回滚操作。

【命令】

configuration replace { last number | commit-id commit-id | label labelname }

【视图】

系统视图

【缺省用户角色】

network-admin

mdc-admin

【参数】

last number：将配置回滚到以最新的创建的回滚点开始，倒数第number个回滚点时的配置，number用来指定回滚点的数量。

commit-id commit-id：将配置回滚到指定回滚点对应的配置。配置回滚或执行commit下发目标配置时，系统自动生成全局唯一的回滚点编号，用来标识该回滚点。commit-id表示回滚点编号，取值范围取决于已创建的回滚点的数量。

label labelname：将运行配置回滚到该标签对应回滚点的配置。labelname表示标签的名称，必须以字母开头，为1～20个字符的字符串，区分大小写。该标签全局唯一。

【使用指导】

 

【举例】

# 将配置回滚到编号为2的回滚点时的配置。

<Sysname> system-view

[Sysname] configuration replace commit-id 2

Current configuration will be lost, Save running configuration? [Y(yes)/N(no)/C(cancel)]:n

Now rolling back the running configuration. Please wait...

Running configuration successfully rolled back.

1.1.5  display configuration commit diff

display configuration commit diff命令用来显示回滚点对应配置与当前运行配置或其他回滚点之间的差异。

【命令】

display configuration commit diff [ at commit-id | last number | since commit-id ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

mdc-admin

mdc-operator

【参数】

at commit-id：显示指定回滚点与下一个回滚点之间的差异。commit-id表示回滚点编号，取值范围取决于已创建的回滚点的数量。如果指定回滚点为最新创建的回滚点，则显示指定回滚点与当前运行配置之间的差异。

last number：显示以最新的创建的回滚点开始，倒数第number个回滚点时的配置与当前运行配置之间的差异。

since commit-id：显示指定回滚点与当前运行配置之间的差异。commit-id表示回滚点编号，取值范围取决于已创建的回滚点的数量。

【使用指导】

不指定任何参数表示显示每一个回滚点与当前运行配置之间的差异。

【举例】

# 显示编号为2的回滚点对应配置与下一个回滚点对应配置之间的差异。

<Sysname> display configuration commit diff at 2

--- Current configuration

+++ Next configuration

@@ -3,4 +3,4 @@

  #

Vlan1

-  description test

+  description world

  #

表1-2 display configuration commit diff命令显示信息描述表

字段	描述
--- A +++ B	表示本命令比较A和B中的配置。A和B可能为当前指定的回滚点对应配置、下一个回滚点对应配置、或者当然运行配置
@@ -linenumber1,number1  +linenumber2,number2  @@	·     -linenumber1,number1：表示从A中、行号为linenumber1的配置开始显示，共显示number1条 ·     +linenumber2,number2：表示从B中、行号为linenumber2的配置开始显示，共显示number2条
cmd1 - cmd2 + cmd3 cmd4	·     cmd1、cmd4表示A和B中都存在的配置，为差异配置的上下文，用于定位差异配置 ·     - cmd2表示该配置为下一个回滚点对应配置、当前运行配置、或以最新的创建的回滚点开始，倒数第number个回滚点时的配置 ·     + cmd3表示该配置为命令行指定的回滚点对应配置

 

1.1.6  display configuration commit list

display configuration commit list命令用来显示回滚点的信息。

【命令】

display configuration commit list [ number | label ] [ verbose ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

mdc-admin

mdc-operator

【参数】

number：显示最新创建的指定数量的回滚点的信息。

label：显示带有标签名称的回滚点的信息。

verbose：显示回滚点的详细信息。不指定该参数表示显示简要信息。

【使用指导】

不指定任何参数表示显示所有回滚点的简要信息。

【举例】

# 显示最新创建的3个的回滚点的信息。

<Sysname> display configuration commit list 3

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

Commit ID      Label           User            Time stamp

3              conf3           -               2016-07-11 14:34:06

2              conf2           -               2016-07-11 14:33:06

1              -               -               2016-07-11 14:32:19 

表1-3 display configuration commit list命令显示信息描述表

字段	描述
Commit ID	回滚点的编号
Label	回滚点的标签名称，未配置标签名称时显示为“-”
User	创建回滚点的用户名 ·     使用NETCONF配置设备时，通过NETCONF over SSH、NETCONF over Telnet和NETCONF over Console并使用Scheme认证与设备建立的NETCONF会话，该字段显示为用户名称，通过其他方式建立的NETCONF会话，该字段显示为“-” ·     使用SNMP和CWMP配置设备时不支持该字段，显示为“-”
Time stamp	回滚点的创建时间

 

1.1.7  display configuration sessions

display configuration sessions命令用来显示CLI、NETCONF、CWMP和SNMP用户的配置会话信息。

【命令】

display configuration sessions

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

mdc-admin

mdc-operator

【举例】

# 显示用户的配置会话信息。

<Sysname> display configuration sessions

  Type       Line     User             Time               Lock

+ CLI        VTY 0    admin            May 04 09:13:33    -

  CLI        VTY 1    ad               May 04 08:55:21    *

  NETCONF    VTY 1    user1            May 04 08:55:34    -

  SNMP       -        -                May 04 08:55:20    -

  CWMP       -        -                May 04 08:55:25    -

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

字段	描述
Type	用户会话的类型，+表示当前用户会话 通过Web和RESTful建立的会话，该字段显示为NETCONF
Line	会话占用的用户线类型，数字表示用户线的相对编号，关于用户线类型，具体请参见“基础配置指导”中的“登录设备” 对于NETCONF类型，通过NETCONF over SSH、NETCONF over Telnet和NETCONF over Console等方式建立的NETCONF会话，该字段显示为用户线，通过其他方式建立的会话，该字段显示为“-” SNMP和CWMP类型会话不支持该字段，显示为“-”
User	用户名称 对于NETCONF类型，通过NETCONF over SSH、NETCONF over Telnet和NETCONF over Console并使用Scheme认证与设备建立的NETCONF会话，该字段显示为用户名称，通过其他方式建立的NETCONF会话，该字段显示为“-” SNMP和CWMP类型会话不支持该字段，显示为“-”
Time	用户与设备建立会话的时间
Lock	*表示用户持有全局锁 -表示用户未持有全局锁

 

1.1.8  display target-configuration

display target-configuration命令用来显示目标配置。

【命令】

display target-configuration [ diff | failure [ brief ] | merge | success ]

【视图】

私有模式下的任意视图

独占模式下的任意视图

【缺省用户角色】

network-admin

network-operator

mdc-admin

mdc-operator

【参数】

diff：显示目标配置和设备正在运行配置之间的差异。

failure：显示下发失败的目标配置和失败的原因。

brief：只显示下发失败的目标配置，不显示失败的原因。

merge：显示目标配置和运行配置合并后的配置。

success：显示下发成功的目标配置及提示信息。该参数仅显示执行命令后打印提示信息的命令行。

【使用指导】

如果不指定任何参数，本命令将按配置顺序显示执行commit命令前的目标配置。例如，执行commit命令前，依次下发了sysname DeviceA和sysname DeviceB两条命令，那么执行display target-configuration命令，设备会按照配置顺序，依次显示这两条命令。

Comware V7中，在执行有些功能命令后将打印提示信息，说明对应命令行的执行结果。在独立/私有模式视图下使用commit命令下发目标配置时，则无法打印这些命令行的提示信息。用户可以在下发目标配置完成后，执行display target-configuration success显示下发成功的命令行、以及对应的提示信息。

【举例】

# 显示配置设备名称后的目标配置信息。

<Sysname> system-view private

~[Sysname] sysname Device

~[Sysname] display target-configuration

sysname Device

# 进入私有模式系统视图后，下发一条目标配置，然后查看目标配置和正在运行配置之间的差异。

<Sysname> system-view private

~[Sysname] sysname Device

~[Sysname] display target-configuration diff

--- Running configuration

+++ Target configuration

@@ -5,7 +5,7 @@

 #

  alias dh display hotkey

 #

- sysname Sysname

+ sysname Device

 #

  local-user userA class manage

表1-5 display target-configuration diff命令显示信息描述表

字段	说明
- - - Running configuration +++ Target configuration	·     Running configuration表示当前运行配置 ·     Target configuration表示目标配置
@@ -linenumber1,number1  +linenumber2,number2  @@	·     -linenumber1,number1：表示从当前运行配置中、行号为linenumber1的配置开始显示，共显示number1条 ·     +linenumber2,number2：表示从目标配置中、行号为linenumber2的配置开始显示，共显示number2条
cmd1 - cmd2 + cmd3 cmd4	·     cmd1、cmd4表示当前运行配置和目标配置中都存在的配置，差异配置的上下文，用于定位差异配置 ·     - cmd2表示该配置是当前运行配置中的配置，目标配置中没有 ·     + cmd3表示该配置是目标配置中的配置，当前运行配置中没有 在这个例子中，从显示信息中可以看出，sysname Sysname只存在于当前运行配置文件中，sysname Device只存在于目标配置中，这是它们之间的差异

 

1.1.9  refresh target-configuration

refresh target-configuration命令用来更新未提交的目标配置。

【命令】

refresh target-configuration

【视图】

私有模式下的任意视图

独占模式下的任意视图

【缺省用户角色】

network-admin

network-operator

mdc-admin

mdc-operator

【使用指导】

用户提交目标配置时，可能由于当前运行配置变化，导致当前运行配置与目标配置冲突。此时，可以执行本命令来更新未提交的目标配置，将有冲突的目标配置过滤掉。

【举例】

# 更新未提交的目标配置。

<Sysname> system-view private

~[Sysname] refresh target-configuration

Trying to refresh the target configuration. Please wait …

No conflicts detected.

1.1.10  reset configuration commit

reset configuration commit命令用来清除已创建的回滚点。

【命令】

reset configuration commit number

【视图】

用户视图

【缺省用户角色】

network-admin

mdc-admin

【参数】

number：清除最早创建的指定数量的回滚点，number表示回滚点的数量，该值不能大于当前系统中已存在的回滚点数量，否则命令行执行失败。

【使用指导】

 

清除不再使用的回滚点可以释放内存，提高设备性能。

【举例】

# 清除系统中最早创建的9个回滚点。

<Sysname> reset configuration commit 9

1.1.11  reset target-configuration

reset target-configuration命令用来清除目标配置。

【命令】

reset target-configuration [ command [ text ] ]

【视图】

私有模式下的任意视图

独占模式下的任意视图

【缺省用户角色】

network-admin

network-operator

mdc-admin

mdc-operator

【参数】

command：表示清除当前视图下指定的目标配置。如果不指定该参数，则表示清除所有目标配置。

text：表示清除指定的目标配置。目标配置与本命令行字符数量之和不超过512字符，是否区分大小写与清除的目标配置是否区分大小写一致。如果不指定该参数，用户需要使用交互式方式输入清除目标配置。指定该参数，则直接清除指定的目标配置。

【使用指导】

 

【举例】

# 清除系统视图下的目标配置。

<Sysname> system-view private

~[Sysname] reset target-configuration

# 清除目标配置中的设备名称配置。

<Sysname> system-view private

~[Sysname] reset target-configuration command sysname S1