- 产品与解决方案
- 行业解决方案
- 服务
- 支持
- 合作伙伴
- 关于我们
12-目标配置管理命令
本章节下载： 12-目标配置管理命令 (243.29 KB)
目 录
1.1.3 configuration commit auto-save path
1.1.4 display target-configuration
1.1.5 refresh target-configuration
1.1.6 reset target-configuration
仅S5130S-HI-G交换机支持下发目标配置命令
commit命令用来下发目标配置。
【命令】
commit [ best-effort ] [ force ] [ label labelname ] [ save-running filename ] [ confirmed [ seconds | minutes minutes ] ] [ show-error ] [ clear-error ] [ description text ]
【视图】
私有模式下的任意视图
独占模式下的任意视图
【缺省用户角色】
network-admin
network-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操作。
如果在IRF端口视图下，下发commit命令，目标配置下发成功后将会回到系统视图。
目标配置无法自动保存。配置时如果在执行commit命令前中途与设备断开连接，则需要重新进行配置。
将所有目标配置一起下发时，如果其中有命令由于资源不足导致无法下发，设备将忽略此命令继续下发目标配置，直至下发完其他目标配置。
【举例】
# 执行目标配置下发操作，目标配置中包含错误命令行时，继续下发目标配置。
<Sysname> system-view private
~[Sysname] sysname aaa
*[Sysname] commit
Wait for the configuration commit: Done.
~[aaa]
commit enable命令用来开启目标配置管理功能。
undo commit enable命令用来关闭目标配置管理功能。
【命令】
commit enable
undo commit enable
【缺省情况】
目标配置管理功能处于开启状态。
【视图】
系统视图
【缺省用户角色】
network-admin
【使用指导】
为了节省内存，如果设备不需要使用目标管理配置功能，可以通过执行undo commit enable命令来关闭该功能，减少不必要的资源占用，提高系统效率。
关闭目标配置管理功能后，将无法通过system-view命令进入私有模式/独占模式。
如果当前有用户已经进入了私有模式视图，执行undo commit enable命令后，这些用户将被强制退出私有模式。
【举例】
# 关闭目标配置管理功能。
<Sysname> system-view
[sysname] undo commit enable
【相关命令】
· system-view
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
【参数】
directory：表示自动保存当前运行配置的文件的文件夹的路径，为1～63个字符的字符串，不区分大小写，格式为存储介质名:/[文件夹名]/子文件夹名。directory必须是主设备或FTP/TFTP服务器上已存在的路径，且参数中不能包含成员编号。
filename-prefix filename-prefix：配置文件的前缀名，即“.cfg”文件的前缀名。文件路径与文件名的总长度不能超过255个字符。
user user-name：配置文件的自动保存路径在FTP服务器上时，FTP服务器的登录用户名。
password：配置文件的自动保存路径在FTP服务器上时，FTP服务器的登录密码。
cipher：表示以密文方式设置密码。
simple：表示以明文方式设置密码，该密码将以密文形式存储。
string：密码字符串，区分大小写。明文密码为1～32个字符的字符串，密文密码为1～73个字符的字符串。
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
display target-configuration命令用来显示目标配置。
【命令】
display target-configuration [ diff | failure [ brief ] | merge | success ]
【视图】
私有模式下的任意视图
独占模式下的任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
diff：显示目标配置和设备正在运行配置之间的差异。
failure：显示下发失败的目标配置和失败的原因。
brief：只显示下发失败的目标配置，不显示失败的原因。
merge：显示目标配置和运行配置合并后的配置。
success：显示下发成功的目标配置及提示信息。该参数仅显示执行命令后打印提示信息的命令行。
【使用指导】
如果不指定任何参数，本命令将按配置顺序显示执行commit命令前的目标配置。例如，执行commit命令前，依次下发了sysname DeviceA和sysname DeviceB两条配置，那么执行display target-configuration命令，设备会按照配置顺序，依次显示这两条配置。
Comware V7中，在执行有些功能命令后将打印提示信息，说明对应命令行的执行结果。在独立/私有模式视图下使用commit命令下发目标配置时，则无法打印这些命令行的提示信息。用户可以在下发目标配置完成后，执行display target-configuration success显示下发成功的命令行、以及对应的提示信息。
私有/独占模式下指定diff或merge参数时，对缺省配置的显示情况与实时生效模式下display current-configuration命令对缺省配置的显示情况一致。
【举例】
# 显示配置设备名称后的目标配置信息。
<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-2 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只存在于目标配置中，这是它们之间的差异 |
refresh target-configuration命令用来更新未提交的目标配置。
【命令】
refresh target-configuration
【视图】
私有模式下的任意视图
独占模式下的任意视图
【缺省用户角色】
network-admin
network-operator
【使用指导】
用户提交目标配置时，可能由于当前运行配置变化，导致当前运行配置与目标配置冲突。此时，可以执行本命令来更新未提交的目标配置，将有冲突的目标配置过滤掉。
【举例】
# 更新未提交的目标配置。
<Sysname> system-view private
~[Sysname] refresh target-configuration
Trying to refresh the target configuration. Please wait …
No conflicts detected.
reset target-configuration命令用来清除目标配置。
【命令】
reset target-configuration [ command [ text ] ]
【视图】
私有模式下的任意视图
独占模式下的任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
command：表示清除当前视图下指定的目标配置。如果不指定该参数，则表示清除所有目标配置。
text：表示清除指定的目标配置。目标配置与本命令行字符数量之和不超过512字符，是否区分大小写与清除的目标配置是否区分大小写一致。如果不指定该参数，用户需要使用交互式方式输入清除目标配置。指定该参数，则直接清除指定的目标配置。
【使用指导】
删除的目标配置无法恢复，需要用户再次手动配置，请谨慎使用。
【举例】
# 清除系统视图下的目标配置。
<Sysname> system-view private
~[Sysname] reset target-configuration
# 清除目标配置中的设备名称配置。
<Sysname> system-view private
~[Sysname] reset target-configuration command sysname S1
不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!
支持
