目  錄

1 軟件升級

1.1 軟件升級配置命令

1.1.1 boot-loader file

1.1.2 boot-loader update

1.1.3 bootrom backup

1.1.4 bootrom read

1.1.5 bootrom restore

1.1.6 bootrom update

1.1.7 bootrom-update security-check enable

1.1.8 display boot-loader

 

1 軟件升級

 

如果將U盤內的軟件包指定為設備下次啟動時使用的軟件包，重啟設備時不要將U盤從設備上拔出，否則可能導致設備無法正常啟動。建議將Flash中的軟件包指定為設備下次啟動時使用的軟件包。

1.1  軟件升級配置命令

1.1.1  boot-loader file

boot-loader file命令用來指定設備下次啟動時使用的軟件包/IPE文件（以下簡稱下次啟動軟件包/IPE文件）。

【命令】

boot-loader file boot boot-package system system-package [ feature feature-package&<1-30> ] { all | slot slot-number } { backup | main }

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

【視圖】

用戶視圖

【缺省用戶角色】

network-admin

【參數】

boot boot-package：Boot包的名稱，以.bin作為後綴名，從flash、cf、sd、usb開始最多可輸入63個字符，不區分大小寫。

system system-package：System包的名稱，以.bin作為後綴名，從flash、cf、sd、usb開始最多可輸入63個字符，不區分大小寫。

feature feature-package：Feature包的名稱，以.bin作為後綴名，從flash、cf、sd、usb開始最多可輸入63個字符，不區分大小寫。feature-package&<1-30>表示前麵的參數最多可以輸入30次。

ipe-filename：表示IPE（Image Package Envelope，複合軟件包套件）文件的名稱，以.ipe作為後綴名，從flash、cf、sd、usb開始最多可輸入63個字符，不區分大小寫。

all：用來升級整個係統。當用戶獲取的IPE包中包含IRF係統升級需要的所有軟件包時，使用這樣的IPE包，並指定all參數，執行一次boot-loader file命令，就能指定係統中所有硬件下次啟動時使用的軟件包/IPE文件。

slot slot-number：表示待升級的成員設備的編號。

backup：指定該軟件包為備用啟動軟件包，並將該軟件包的名稱添加到備用啟動軟件包列表。備用啟動軟件包用於主用啟動軟件包不可用或異常情況時，引導設備啟動。

main：指定該軟件包為主用啟動軟件包，並將該軟件包的名稱添加到主用啟動軟件包列表。主用啟動軟件包用於引導設備啟動。

【使用指導】

請不要通過多個用戶同時執行該命令，以免配置失敗。

請先查看軟件包版本發布說明書，如果軟件包需要License才能運行，且設備當前沒有對應的有效的License時，需安裝對應的License，再執行該命令。否則，當使用軟件包配置該命令時，隻要指定的某個軟件包當前沒有有效的License，則會導致整條命令配置失敗；當使用IPE文件配置該命令時，隻有當前沒有有效的License的軟件包配置失敗，其它軟件包會配置成功。

當配置該命令時，命令中指定的軟件包/IPE文件必須放在存儲介質主分區的根目錄下，文件名中必須包含存儲介質的名稱。

係統會自動檢查指定成員設備上對應路徑下是否存在同名文件，如果不存在，則直接從指定路徑拷貝一份並設置為下次啟動軟件包；如果存在，則提示用戶是否從指定路徑拷貝一份並設置為下次啟動軟件包。

成功執行該命令後，係統會用命令中指定的軟件包替換現有的軟件包列表。如果命令行中沒有指定Feature包，則更新後的軟件包列表中不會有Feature包。

【舉例】

# 指定成員設備1下次啟動時所用的主用啟動文件為flash:/all.ipe。

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

Verifying the IPE file and the images............Done.

H3C F1010 images in IPE:

  boot.bin

  system.bin

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

Add images to slot 1.

File flash:/boot.bin already exists on slot 1.

File flash:/system.bin already exists on slot 1.

Overwrite the existing files? [Y/N]:Y

Decompressing file boot.bin to flash:/boot.bin........................Done.

Decompressing file system.bin to flash:/system.bin...............................Done.

The images that have passed all examinations will be used as the main startup software images at the next reboot on slot 1.

# 指定IRF的主用下次啟動軟件為flash:/all.ipe（slot 3為主設備，slot 4和5為備設備）。

<Sysname> boot-loader file slot4#flash:/all.ipe all main

Verifying the IPE file and the images............................................................................Done.

H3C F1010 images in IPE:

  Boot.bin

  System.bin

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

Add images to slot 3.

File flash:/Boot.bin already exists on slot 3.

File flash:/System.bin already exists on slot 3.

Overwrite the existing files? [Y/N]:y

Decompressing file Boot.bin to flash:/Boot.bin........................Done.

Decompressing file System.bin to flash:/System.bin........................Done.

The images that have passed all examinations will be used as the main startup software images at the next reboot on slot 3.

File flash:/Boot.bin already exists on slot 4.

Do you want to overwrite the file?

 Y: Overwrite the file.

 N: Not overwrite the file.

 A: From now on, overwrite or not overwrite without prompt.

Please make a choice. [Y/N/A]:a

What type of overwrite operation do you want to perform?

 Y: Overwrite without prompt.

 N: Not overwrite or display prompt.

 Q: Return to the previous step.

Please make a choice. [Y/N/Q]:y

An existing file will be overwritten without prompt if it has the same name as any upgrade file.

Loading......................Done.

Loading......................Done.

Loading......................Done.

Loading......................Done.

Loading......................Done.

Loading......................Done.

The images that have passed all examinations will be used as the main startup software images at the next reboot on slot 4.

The images that have passed all examinations will be used as the main startup software images at the next reboot on slot 5.

Decompression completed.

Do you want to delete flash:/all.ipe now? [Y/N]:n

【相關命令】

·     display boot-loader

1.1.2  boot-loader update

boot-loader update命令用來將從設備的軟件版本與主設備的當前軟件版本進行同步。

【命令】

boot-loader update { all | slot slot-number }

【視圖】

用戶視圖

【缺省用戶角色】

network-admin

【參數】

all：表示同步升級所有備設備。

slot slot-number：表示待升級的成員設備的編號。

【使用指導】

本命令用於備用主控板和主用主控板軟件版本不一致時，刷新備用主控板的軟件版本，使其和主用主控板的軟件版本相同。

請先查看軟件包版本發布說明書，如果軟件包需要License才能運行，且設備當前沒有對應的有效的License時，需安裝對應的License，再執行該命令。否則，會導致命令執行失敗。

通過該命令指定從設備的下次啟動軟件包時，係統會進行如下處理：

·     如果主設備當前是使用主用啟動軟件包列表啟動的，則將其主用下次啟動軟件包列表中的軟件包拷貝到從設備的對應目錄下，並設置為從設備的主用下次啟動軟件包。如果這些軟件包中有任一軟件包不存在或者不可用，則命令執行失敗。

·     如果主設備當前是使用備用啟動軟件包列表啟動的，則將其備用下次啟動軟件包列表中的軟件包拷貝到從設備的對應目錄下，並設置為從設備的主用下次啟動軟件包。如果這些軟件包中有任一軟件包不存在或者不可用，則命令執行失敗。

如果主設備剛安裝了補丁或者進行了ISSU升級，在執行boot-loader update命令前，請執行install commit命令刷新主設備的下次啟動軟件包列表。否則，可能導致從設備升級後與主設備的版本不一致。

【舉例】

# 將成員設備2上的軟件版本與主設備的軟件版本同步。

<Sysname> boot-loader update slot 2

This command will update the specified standby MPU. Continue? [Y/N]:y

Updating. Please wait...

Copying main startup software images to slot 2. Please wait...

Done.

Setting copied images as main startup software images for slot 2...

Done.

Successfully updated the startup software images of slot 2.

【相關命令】

·     display boot-loader

·     install commit（基礎配置命令參考/ISSU）

1.1.3  bootrom backup

bootrom backup命令用來將Boot ROM程序從Boot ROM的Normal區備份到Backup區。

【命令】

bootrom backup slot slot-number-list [ all | part ]

【視圖】

用戶視圖

【缺省用戶角色】

network-admin

【參數】

slot slot-number-list：成員編號列表，表示同時備份多個成員設備的Boot ROM程序。表示方式為slot-number-list = { slot-number [ to slot-number ] }&<1-7>。其中，slot-number表示需要備份的設備在IRF中的成員編號。

all：操作Boot ROM程序的全部內容。不指定all和part參數時，默認使用all。

part：隻操作Boot ROM程序的擴展段（Boot ROM程序分為兩部分：基本段和擴展段，基本段提供Boot ROM菜單的基本操作項，擴展段提供更多的Boot ROM菜單操作項）。不指定all和part參數時，默認使用all。

【使用指導】

Boot ROM分為Normal區和Backup區：

·     Normal區用於存放Boot ROM程序。設備啟動時，會自動讀取Normal區的Boot ROM程序。如果Normal區的Boot ROM程序不可用，再自動讀取Backup區的Boot ROM程序。

·     Backup區用於存放Boot ROM程序的副本。如果在設備運行過程中，Normal區的Boot ROM程序被損壞或者需要版本回退，可以使用bootrom restore命令將Boot ROM程序從Backup區恢複到Normal區。

【舉例】

# 將成員設備1上的Boot ROM程序從Boot ROM的Normal區備份到Backup區。

<Sysname> bootrom backup slot 1

Now backing up the Boot ROM, please wait...

......Done.

【相關命令】

·     bootrom restore

1.1.4  bootrom read

bootrom read命令用來將Boot ROM程序從Boot ROM的Normal區讀取到文件係統中。

【命令】

bootrom read slot slot-number-list [ all | part ]

【視圖】

用戶視圖

【缺省用戶角色】

network-admin

【參數】

slot slot-number-list：成員編號列表，表示同時讀取多個成員設備的Boot ROM程序。表示方式為slot-number-list = { slot-number [ to slot-number ] }&<1-7>。其中，slot-number表示需要讀取的設備在IRF中的成員編號。

all：操作Boot ROM程序的全部內容。不指定all和part參數時，默認使用all。

part：隻操作Boot ROM程序的擴展段。不指定all和part參數時，默認使用all。

【使用指導】

成功執行bootrom read命令後，係統會自動生成basicbtm.bin和extendbtm.bin文件並保存到缺省文件係統中。其中，basicbtm.bin存儲了Boot ROM程序的基本段，extendbtm.bin存儲了Boot ROM程序的擴展段。

【舉例】

# 讀取成員設備1上的Boot ROM程序。

<Sysname> bootrom read slot 1

  Now reading the Boot ROM, please wait...

.........Done.

【相關命令】

·     bootrom update

1.1.5  bootrom restore

bootrom restore命令用來將Boot ROM程序從Boot ROM的Backup區恢複到Normal區。

【命令】

bootrom restore slot slot-number-list [ all | part ]

【視圖】

用戶視圖

【缺省用戶角色】

network-admin

【參數】

slot slot-number-list：成員編號列表，表示同時恢複多個成員設備的Boot ROM程序。表示方式為slot-number-list = { slot-number [ to slot-number ] }&<1-7>。其中，slot-number表示需要恢複的設備在IRF中的成員編號。

all：操作Boot ROM程序的全部內容。不指定all和part參數時，默認使用all。

part：隻操作Boot ROM程序的擴展段。不指定all和part參數時，默認使用all。

【舉例】

# 恢複成員設備1上的Boot ROM程序。

<Sysname> bootrom restore slot 1

  This command will restore the Boot ROM file on the specified board(s), Continue? [Y/N]:y

  Now restoring the Boot ROM, please wait...

......Done.

【相關命令】

·     bootrom backup

1.1.6  bootrom update

bootrom update命令用來加載Boot ROM程序。

【命令】

bootrom update file file-url slot slot-number-list [ all | part ]

【視圖】

用戶視圖

【缺省用戶角色】

network-admin

【參數】

file file-url：Flash中包含Boot ROM程序的文件，file-url表示用於Boot ROM程序升級的文件的名稱，為1～63個字符的字符串。

slot slot-number-list：成員編號列表，表示同時升級多個成員設備的Boot ROM程序。表示方式為slot-number-list = { slot-number [ to slot-number ] }&<1-7>。其中，slot-number表示需要升級的設備在IRF中的成員編號。

all：操作Boot ROM程序的全部內容。不指定all和part參數時，默認使用all。

part：隻操作Boot ROM程序的擴展段。不指定all和part參數時，默認使用all。

【使用指導】

Boot ROM程序通過Boot包（*.bin）發布，產品會將需要升級的單板的Boot ROM程序集成到Boot包中。此時，可以使用bootrom update命令，將升級文件指定為Boot包，係統會根據單板的型號自動將相應的Boot ROM程序加載到Boot ROM中；也可以在升級Boot包的同時完成Boot ROM程序的加載。

執行該命令後，設備會將缺省存儲介質中的Boot ROM程序加載到Boot ROM的Normal區。設備啟動時，會直接使用Normal區的Boot ROM程序。因此，如果缺省存儲介質空間不足，Boot ROM程序加載完成之後，Boot ROM文件可以刪除。

加載後，要使新的Boot ROM程序生效，需要重啟設備。

【舉例】

# 使用Flash根目錄下的boot.bin文件升級成員設備1上的Boot ROM程序。

<Sysname> bootrom update file flash:/boot.bin slot 1

   This command will update the Boot ROM file on the specified board(s), Continue? [Y/N]:y

   Now updating the Boot ROM, please wait...

.............Done.

【相關命令】

·     boot-loader file

1.1.7  bootrom-update security-check enable

bootrom-update security-check enable命令用來開啟Boot ROM程序合法性檢查功能。

undo bootrom-update security-check enable命令用來關閉Boot ROM程序合法性檢查功能。

【命令】

bootrom-update security-check enable

undo bootrom-update security-check enable

【缺省情況】

Boot ROM程序合法性檢查功能處於開啟狀態。

【視圖】

係統視圖

【缺省用戶角色】

network-admin

【使用指導】

如果開啟了本功能，則在升級Boot ROM程序時，設備會先檢查Boot ROM文件的合法性：包括Boot ROM文件是否有效以及是否和硬件匹配等。檢查通過後，才會升級。

【舉例】

# 啟動Boot ROM升級時的合法性檢查功能。

<Sysname> system-view

[Sysname] bootrom-update security-check enable

1.1.8  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:/f1010fw-cmw710-boot-F9514P01.bin

  flash:/f1010fw-cmw710-system-F9514P01.bin

Main startup software images:

  flash:/f1010fw-cmw710-boot-F9514P01.bin

  flash:/f1010fw-cmw710-system-F9514P01.bin

Backup startup software images:

  None

表1-1 display boot-loader命令顯示信息描述表

字段	描述
Software images on slot n	成員編號為n的某成員設備的啟動軟件包的相關信息
Current software images	最近一次啟動使用的啟動軟件包列表
Main startup software images	主用下次啟動軟件包列表
Backup startup software images	備用下次啟動軟件包列表

 

【相關命令】

·     boot-loader file