目  录

1 软件升级

1.1 软件升级配置命令

1.1.1 boot-loader file

1.1.2 boot-loader update

1.1.3 display boot-loader

1.1.4 display install active

1.1.5 display install committed

1.1.6 display install inactive

1.1.7 display install package

1.1.8 install activate

1.1.9 install commit

1.1.10 install deactivate

1.1.11 install remove

1 软件升级

1.1  软件升级配置命令

1.1.1  boot-loader file

boot-loader file命令用来指定设备下次启动时使用的软件包。

【命令】

boot-loader file boot boot-package system system-package slot slot-number { main | backup }

boot-loader file ipe-filename slot slot-number { main | backup }

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

boot boot-package：Boot包的名称（后缀名为.bin），为1～63个字符的字符串，不区分大小写。

system system-package：System包的名称（后缀名为.bin），为1～63个字符的字符串，不区分大小写。

ipe-filename：表示IPE（Image Package Envelope，复合软件包套件）文件名（后缀名为.ipe），为1～63个字符的字符串，不区分大小写。

slot slot-number：表示成员设备的编号。

main：指定该软件包为主用启动软件包，并将该软件包的名称添加到主用启动软件包列表。主用启动软件包用于引导设备启动。

backup：指定该软件包为备用启动软件包，并将该软件包的名称添加到备用启动软件包列表。备用启动软件包只用于主用启动软件包不可用或异常情况时，引导设备启动。

【使用指导】

·              当前启动软件包列表：设备本次启动时使用的软件包会记录在当前启动软件包列表中。

·              主用启动软件包列表和备用启动软件包列表：为了安全起见，设备支持主用启动软件包列表和备用启动软件包列表。当设备启动时，优先使用主用启动软件包列表中的软件包；如果主用启动软件包中的Boot包或System包不存在或者损坏，再使用备用启动软件包列表中的软件包。

【举例】

# 指定成员设备1下次启动时所用的备用启动软件包为flash:/all.ipe。

<Sysname> boot-loader file flash:/all.ipe slot 1 backup

Images in IPE:

  boot.bin

  system.bin

This command will set the backup startup software images. Continue? [Y/N]:Y

Add packages to target slot.

The specified file list will be used as the backup startup software images at the next reboot on slot 1.

【相关命令】

·              display boot-loader

1.1.2  boot-loader update

boot-loader update命令用来指定Slave的下次启动软件包。

【命令】

boot-loader update slot slot-number

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

slot slot-number：表示设备在IRF中的成员编号。

【使用指导】

执行该命令后，系统会进行如下处理：

(1)      系统获取Master的主用下次启动软件包，如果Master的主用启动软件包中的Boot包或者System包不存在或者不可用时，则获取Master的备用下次启动软件包。

(2)      系统自动将Master的下次启动软件包拷贝到Slave的Flash根目录下，并且系统将自动把这些软件包设置为Slave的主用下次启动软件包。

【举例】

# 指定Slave2的下次启动软件包。

<Sysname> boot-loader update slot 2

【相关命令】

·              display boot-loader

1.1.3  display boot-loader

display boot-loader命令用来显示本次启动和下次启动所采用的启动软件包。

【命令】

display boot-loader [ slot slot-number ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

slot slot-number：表示成员设备的编号。不指定该参数时，表示显示IRF系统中所有成员设备本次启动和下次启动所采用的软件包。

【举例】

# 显示本次启动和下次启动所采用的启动软件包的名称。

<Sysname> display boot-loader

Software images on slot 1:

Current software images:

  flash:/boot.bin

  flash:/system.bin

Main startup software images:

  flash:/boot.bin

  flash:/system.bin

Backup startup software images:

  flash:/boot_back.bin

  flash:/system_back.bin

【相关命令】

·              boot-loader file

1.1.4  display install active

display install active命令用来显示当前系统中处于激活状态的软件包的相关信息。

【命令】

display install active [ slot slot-number ] [ verbose ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

slot slot-number：表示设备在IRF中的成员编号。不指定该参数时，表示显示IRF系统的所有成员设备中处于激活状态的软件包的相关信息。

verbose：显示处于激活状态的软件包的详细信息，包括软件包的名称、基本信息和软件版本等。不指定该参数时，仅显示处于激活状态的软件包的名称。

【举例】

# 显示设备上处于激活状态的软件包的相关信息。

<Sysname> display install active

Active packages on slot 1:

  flash:/boot.bin

  flash:/system.bin

  flash:/system-patch.bin

# 显示所有成员设备上处于激活状态的软件包的详细信息。

<Sysname>display install active verbose

Active packages on slot 1:

  flash:/boot.bin

  [Package Info]

  Vendor: H3C

  Product: S5820V2_5830V2

  Service name: boot

  Platform version: 1.1.0

  Product version: Test 2105

  Supported board: mpu

  [Component Info]

  Component: boot

  Description: boot package

  flash:/system.bin

  [Package Info]

  Vendor: H3C

  Product: S5820V2_5830V2

  Service name: system

  Platform version: 7.1.023

  Product version: Test 2105

  Supported board: mpu

  [Component Info]

  Component: system

  Description: system package

  flash:/system-patch.bin

  [Package Info]

  Vendor: H3C

  Product: S5820V2_5830V2

  Service name: system-patch

  Platform version: sp01

  Product version: Test 2105

  Supported board: mpu

  [Component Info]

  Component: system-patch

  Description: system-patch package

表1-1 display install active命令显示信息描述表

【相关命令】

·              install active

1.1.5  display install committed

display install committed命令用来显示设备已确认更改的软件包。

【命令】

display install committed [ slot slot-number ] [ verbose ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

slot slot-number：表示设备在IRF系统中的成员编号。不指定该参数时，表示显示IRF系统的所有成员设备中已确认更改的软件包。

verbose：显示已确认更改的补丁包的详细信息，包括软件包的名称、基本信息和软件版本等。不指定该参数时，仅显示已确认更改的软件包的名称。

【使用指导】

·              激活补丁包以后，补丁文件仅对设备本次启动生效，设备重启后这些补丁包不再有效。用户只有确认补丁包更改后，才能使此次激活的补丁包在设备重启后仍然有效。

·              执行卸载补丁包操作后，如果不进行确认补丁包更改，补丁包仅从当前启动软件包列表中删除，设备重启后该补丁包依旧运行。用户只有确认了补丁包更改后，才能使此次卸载的补丁包在设备重启后不再运行。

【举例】

# 显示设备已确认更改的软件包。

<Sysname> display install committed

Committed packages on slot 1:

 flash:/boot.bin

 flash:/system.bin

 flash:/system-patch.bin

# 显示IRF系统的所有成员设备中已确认更改的软件包的详细信息。

<Sysname> display install committed verbose

Committed packages on slot 3:

  flash:/boot.bin

  [Package Info]

  Vendor: H3C

  Product: S5820V2_5830V2

  Service name: boot

  Platform version: 1.1.0

  Product version: Test 2105

  Supported board: mpu

  [Component Info]

  Component: boot

  Description: boot package

  flash:/system.bin

  [Package Info]

  Vendor: H3C

  Product: S5820V2_5830V2

  Service name: system

  Platform version: 7.1.023

  Product version: Test 2105

  Supported board: mpu

  [Component Info]

  Component: system

  Description: system package

  flash:/system-patch.bin

  [Package Info]

  Vendor: H3C

  Product: S5820V2_5830V2

  Service name: system-patch

  Platform version: sp01

  Product version: Test 2105

  Supported board: mpu

  [Component Info]

  Component: system-patch

  Description: system-patch package

本命令显示信息的描述请参见表1-1。

【相关命令】

·              install commit

1.1.6  display install inactive

display install inactive命令用来显示当前系统中处于未激活状态的软件包的相关信息。

【命令】

display install inactive [ slot slot-number ] [ verbose ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

slot slot-number：表示设备在IRF中的成员编号。不指定该参数时，表示显示IRF系统的所有成员设备中处于未激活状态的软件包的相关信息。

verbose：显示处于未激活状态的软件包的详细信息，包括软件包的名称、基本信息和软件版本等。不指定该参数时，仅显示处于未激活状态的软件包的名称。

【举例】

# 显示系统中处于未激活状态的软件包的相关信息。

<Sysname> display install inactive

Inactive packages on slot 1:

 flash:/system-patch.bin

# 显示所有成员设备中处于未激活状态的软件包的详细信息。

<Sysname> display install inactive verbose

  flash:/system-patch.bin

  [Package Info]

  Vendor: H3C

  Product: S5820V2_5830V2

  Service name: system-patch

  Platform version: sp01

  Product version: Test 2105

  Supported board: mpu

  [Component Info]

  Component: system-patch

  Description: system-patch package

本命令显示信息的描述请参见表1-1。

【相关命令】

·              install deactivate

1.1.7  display install package

display install package命令用来显示软件包的相关信息。

【命令】

display install package { filename | all } [ verbose ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

filename：表示软件包的名称（后缀名为.bin），为1～63个字符的字符串，不区分大小写。该文件必须保存在Master和Slave的Flash根目录下，且文件名中必须包含“flash”（例如flash:/system-patch.bin）。

all：选择此参数时将显示Master的Flash根目录下所有软件包的信息。

verbose：显示软件包的详细信息，包括软件包的名称、基本信息和软件版本等。不指定该参数时，仅显示软件包的名称。

【举例】

# 显示补丁包system-patch.bin的相关信息。

<Sysname> display install package flash:/system-patch.bin

  flash:/system-patch.bin

  Vendor: H3C

  Product: S5820V2_5830V2

  Service name: system-patch

  Platform version: sp01

  Product version: Test 2105

  Supported board: mpu

本命令显示信息的描述请参见表1-1。

1.1.8  install activate

install activate命令用来激活补丁包。

【命令】

install activate patch filename slot slot-number

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

patch：表示补丁包，用于快速修复系统缺陷。

filename：表示补丁包的文件名（后缀名为.bin），为1～63个字符的字符串。该文件必须保存在Master的Falsh根目录下，且文件名中必须包含“flash”（例如flash:/system-patch.bin）。

slot slot-number：表示设备在IRF中的成员编号。

【使用指导】

·              补丁包只有激活后才能生效。

·              激活补丁包以后，补丁文件仅对设备本次启动生效，设备重启后这些补丁文件不再有效。用户只有确认补丁包更改后，才能使此次激活的补丁文件在系统重启后仍然有效。

【举例】

# 激活成员设备1上的补丁包system-patch.bin。

<Sysname> install activate patch flash:/system-patch.bin slot 1

【相关命令】

·              install commit

·              install deactivate

·              display install active

1.1.9  install commit

install commit命令用来确认补丁包更改。

【命令】

install commit

【视图】

用户视图

【缺省用户角色】

network-admin

【使用指导】

·              激活补丁包以后，补丁文件仅对设备本次启动生效，设备重启后这些补丁包不再有效。用户只有确认补丁包更改后，才能使此次激活的补丁包在设备重启后仍然有效。

·              执行卸载补丁包操作后，如果不进行确认补丁包更改，补丁包仅从当前启动软件包列表中删除，设备重启后该补丁包依旧运行。用户只有确认了补丁包更改后，才能使此次卸载的补丁包在设备重启后不再运行。

【举例】

# 确认补丁包更改。

<Sysname> install commit

【相关命令】

·              install activate

·              install deactivate

1.1.10  install deactivate

install deactivate命令用来卸载补丁包。

【命令】

install deactivate patch filename slot slot-number

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

filename：表示补丁包的名称（后缀名为.bin），为1～63个字符的字符串。该文件必须保存在Master的Falsh根目录下，且文件名中必须包含“flash”（例如flash:/system-patch.bin）。

slot slot-number：表示设备在IRF中的成员编号。

【使用指导】

·              该命令只能对已经激活的补丁包进行卸载操作。

·              执行卸载补丁包操作后，不确认补丁包更改，补丁包从当前启动软件包列表中删除，设备重启后该补丁包依旧运行。

·              执行卸载补丁包操作后，确认了补丁包更改，补丁包从当前启动软件包列表中删除，设备重启后该补丁包不再运行。

【举例】

# 卸载成员设备1上的补丁包system-patch.bin。

<Sysname> install deactivate patch flash:/system-patch.bin slot 1

【相关命令】

·              display install active

·              display install inactive

1.1.11  install remove

install remove命令用来从Flash中删除指定的补丁包。

【命令】

install remove [ slot slot-number ] { filename | inactive }

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

slot slot-number：表示设备在IRF中的成员编号。不指定该参数时，表示删除IRF系统中的所有成员设备上指定的补丁包。

filename：表示补丁包的名称（后缀名为.bin），为1～63个字符的字符串。该文件必须保存在Master的Falsh根目录下，且文件名中必须包含“flash”（例如flash:/system-patch.bin）。

inactive：表示将删除所有未激活并且没有被确认的补丁包。

【使用指导】

该命令不能删除已经被激活的的补丁包。

【举例】

# 删除补丁包system-patch.bin。

<Sysname> install remove flash:/system-patch.bin