Choose “Save as PDF” as the destination to download this doc.

Back to the doc
amnimo Manual Library

2.4 ファームウェアを操作する

第2章 本製品の基本操作  ·  https://manual.amnimo.com/docs/basic-operations-cli/2-4-cli/

2.4 ファームウェアを操作する

対象機種: AX30 / AX11 / AX21 / AG10 / AG20 / AR10 / AR20 / AC10 / AC15 / AC25(2.4.7~2.4.9 はコンパクトルーターは非対応)

ファームウェアの更新や設定などの操作をします。

機種ごとの更新手順(ファームウェアの URL の例など)は、各機種のユーザーズマニュアル「ファームウェアを更新する」にも記載されています。AG ユーザーズマニュアル『ファームウェアを更新する』、AR ユーザーズマニュアル『ファームウェアを更新する』、AX ユーザーズマニュアル『AIエッジゲートウェイのファームウェアを更新する』『センサー接続ゲートウェイのファームウェアを更新する』、AC ユーザーズマニュアル『ファームウェアを更新する』を参照してください。

関連する設定ガイド: G2.8 ファームウェアを更新する

コマンド内容実行モード
show firmwareファームウェアのバージョンを表示する一般ユーザー/管理者
firmware file checkファームウェアのファイルを確認(ダウンロード)する管理者
firmware file deleteダウンロード済みのファームウェアファイルを削除する管理者
firmware area updateファームウェアを更新する(全体更新)管理者
firmware area sync冗長エリアを同期する管理者
show device boot現在起動している冗長領域を表示する一般ユーザー/管理者/設定
device boot次回起動する冗長領域を設定する管理者/設定
firmware package updateパッケージ情報を更新する管理者
firmware package upgradeパッケージを更新する(差分更新)管理者
firmware package cleanパッケージ情報ファイルを削除する管理者

2.4.1 ファームウェアのバージョンを表示する

ファームウェアのバージョン情報を表示するには、show firmwareコマンドを実行します。

実行モード: 一般ユーザーモード(amnimo$)/管理者モード(amnimo#)

書式
show firmware
注意・補足

note 補足: 機種が異なる場合、機種に固有の内容が表示されます。

実行例

一般ユーザーモードと管理者モードで、コマンドの入力と出力は同じです。以下に、エッジゲートウェイでの管理者モードの実行例を示します。

amnimo# show firmware
amnimo G series AG10 version 1.4.0 build 13992
 Kernel: 4.19.195-03776-g3ad1b025c60 #1 SMP PREEMPT Wed Aug 4 05:18:02 UTC 2021
 Bootloader: g88baf9249d (Jul 30 2021 - 05:24:48 +0000)
 BootArea: 1
 Partitions: 5
関連コマンド

2.4.2 ファームウェアのファイルを確認する

ファームウェアが存在することを確認します。外部サーバーにあるファームウェアについてはダウンロードを実施します。

実行モード: 管理者モード(amnimo#)

書式
firmware file check [ URL ]
パラメーター
パラメーター説明範囲・形式初期値
URLファームウェアファイルの場所を指定します。HTTPやFTPなどの情報を指定することができます。file://、tftp://、ftp://、http://、https:// で始まるURL。※1を参照―
※1

以下に、ファイル名を屋内タイプエッジゲートウェイ用のファームウェアファイル ag10-v1.0.0-b1.amf とした場合の設定例を示します。

場所指定例
ストレージに存在するファイルを使用する場合file:///media/usb/ag10-v1.0.0-b1.amf
TFTPサーバーに存在するファイルを使用する場合tftp://example.com/ag10-v1.0.0-b1.amf
パスワード認証対応のFTPサーバーに存在するファイルを使用する場合ftp://username:password@example.com/ag10-v1.0.0-b1.amf
ベーシック認証対応のHTTPサーバーに存在するファイルを使用する場合http://username:password@example.com/ag10-v1.0.0-b1.amf
ベーシック認証対応のHTTPSサーバーに存在するファイルを使用する場合https://username:password@example.com/ag10-v1.0.0-b1.amf
注意・補足

note 補足: ファームウェアを更新する前に、更新ソフトウェアに付与されたSHA256ハッシュ値との照合を行い、照合の結果、不一致が確認された場合にはインストールが中止されます。(JC-STAR★1 適合基準番号 S1.1-08)

note 補足: 弊社公開のファームウェアを取得するためには、「接続先とファームウェア」「アカウント名」「パスワード」の情報が必要です。アカウントとパスワードについては、弊社サポートに別途ご連絡ください。
例:屋内タイプエッジゲートウェイ
https://(アカウント名):(パスワード)@package.amnimo.com/firmware/ag10.amf
各機器のURLについては、各機種のリリースノートを参照ください。リリースノートには過去にリリースしたファームウェアのURLも記載されています。なおリリースノートへのアクセスもアカウントとパスワードが必要です。

実行例

ダウンロード中

amnimo# firmware file check ftp://amnimo:xxxxx@amnimo-host/firmware/staging/ag10-1.0.0-b12345.amf
Downloading...
##########################                                                36.3%

ダウンロード完了後

amnimo# firmware file check ftp://amnimo:xxxxx@amnimo-host/firmware/staging/ag10-1.0.0-b12345.amf
Downloading...
######################################################################## 100.0%
version:  amnimo G series AG10 version 1.0.0 build 12345
contents: rootfs bootloader
関連コマンド

2.4.3 ファームウェアを削除する

ダウンロード済みファームウェアファイルは、firmware file deleteコマンドで削除することができます。

実行モード: 管理者モード(amnimo#)

書式
firmware file delete
注意・補足

note 補足:

実行例
amnimo# firmware file delete
Deleted!
関連コマンド

2.4.4 ファームウェアを更新する

本製品のファームウェアの更新対象には、起動領域と冗長領域の2つがあります。それぞれの領域を更新するには、firmware area updateコマンドを実行します。本コマンドを実行すると、再起動するかどうかをたずねられます。再起動を許可すると、ファームウェアが更新されます。(以下、本機能による更新方法を「全体更新」と呼びます。)

実行モード: 管理者モード(amnimo#)

書式
firmware area update [ target { back | both } ] [ force { true | false } ] [ url URL ] [ factory-reset { true | false } ]
パラメーター
パラメーター説明範囲・形式初期値
target更新するターゲットを設定します。
・ back:現在起動していない冗長領域を更新します。
・ both:両方の冗長領域を更新します。
back / bothboth(V1.8.0 以降)
back(V1.7.0 以前)
force再起動時、ユーザーに確認するかどうかを設定します。
・ true:ユーザーに確認せず、強制的に再起動します。
・ false:再起動する前に、ユーザーに確認します。
true / false―
urlファームウェアファイルのURLを指定します。指定すると、ファームウェアをダウンロードしてから更新します。2.4.2 のURLと同じ―
factory-reset(V3.1.0 以降)ファームウェア更新後、本体設定やログ等を削除する工場出荷状態への移行可否を設定します。(JC-STAR★1 適合基準番号 S1.1-15 相当)
・ true:ファームウェア更新後、工場出荷状態になります。
・ false:ファームウェア更新後、設定やログ等は維持し再起動します。
true / falsefalse
注意・補足

note 補足:

実行例

実行例1(V1.8.0 以降)

管理者モードでファームダウンロード済みの状態でアップデートを行う実行例を示します。

ファームウェア 3.7.0以前での表示

amnimo# firmware area update
Do you want to update (full update) the area with the following contents?
After updating, restart the gateway.
Update area: Both sides
reboot for area update? (y/N): 		←「y」キーに続けてEnterを入力

ファームウェア 3.8.0以降での表示

amnimo# firmware area update
Do you want to update (full update) the area with the following contents?
After updating, restart the gateway.
Update area: Both sides
************************************************************************
*                          IMPORTANT NOTICE                            *
*                                                                      *
* If you are installing an older firmware version, be aware that doing *
* so may introduce security vulnerabilities, compatibility issues, or  *
* the recurrence of known defects.                                     *
*                                                                      *
* Please review the details carefully before proceeding.               *
* For more information:                                                *
* https://support.amnimo.com/hc/ja/articles/60152000360601             *
************************************************************************
reboot for area update? (y/N): 		←「y」キーに続けてEnterを入力

コマンドの実行をキャンセルするには、Enterを入力するか、「n」キーに続けてEnterを入力します。

実行例2(V1.8.0 以降)

管理者モードでファームウェアのURL(https://username:password@example.com/ag10-v1.0.0-b1.amf)を指定し、ファームウェアのダウンロードと現在起動していない冗長領域のアップデートを行う実行例を示します。

ファームウェア 3.7.0以前での表示

amnimo# firmware area update target back url https://username:password@example.com/ag10-v1.0.0-b1.amf
Do you want to update (full update) the area with the following contents?
After updating, restart the gateway.
Update area: One side
reboot for area update? (y/N): 		←「y」キーに続けてEnterを入力

ファームウェア 3.8.0以降での表示

amnimo# firmware area update target back url https://username:password@example.com/ag10-v1.0.0-b1.amf
Do you want to update (full update) the area with the following contents?
After updating, restart the gateway.
Update area: One side
************************************************************************
*                          IMPORTANT NOTICE                            *
*                                                                      *
* If you are installing an older firmware version, be aware that doing *
* so may introduce security vulnerabilities, compatibility issues, or  *
* the recurrence of known defects.                                     *
*                                                                      *
* Please review the details carefully before proceeding.               *
* For more information:                                                *
* https://support.amnimo.com/hc/ja/articles/60152000360601             *
************************************************************************
reboot for area update? (y/N): 		←「y」キーに続けてEnterを入力

コマンドの実行をキャンセルするには、Enterを入力するか、「n」キーに続けてEnterを入力します。

関連コマンド

2.4.5 ファームウェアの冗長エリアを同期する

現在起動している冗長領域をもう一方の冗長領域にコピーする場合、firmware area syncコマンドを実行します。

コピーの対象は、rootfs領域とuserfs領域です。コピー先の冗長領域の内容は削除されます。

本コマンドを実行すると、再起動するかどうかをたずねられます。再起動を許可すると、ファームウェアが更新されます。

実行モード: 管理者モード(amnimo#)

書式
firmware area sync [ force { true | false } ]
パラメーター
パラメーター説明範囲・形式初期値
force再起動時、ユーザーに確認するかどうかを設定します。
・ true:ユーザーに確認せず、強制的に再起動します。
・ false:再起動する前に、ユーザーに確認します。
true / false―
実行例
amnimo# firmware area sync
reboot to sync? (y/N):		←「y」キーに続けてEnterを入力

コマンドの実行をキャンセルするには、Enterを入力するか、「n」キーに続けてEnterを入力します。

関連コマンド

2.4.6 起動する冗長領域を設定する

現在起動している冗長領域の表示と設定を行います。

冗長領域を表示する

現在の冗長領域を表示します。

実行モード: 一般ユーザーモード(amnimo$)/管理者モード(amnimo#)/設定モード(amnimo(cfg)#)

書式
show device boot
実行例

コマンドの入力と出力は、すべてのモードで同じです。以下に、一般ユーザーモードの実行例を示します。

amnimo$ show device boot
1

次回起動する冗長領域を設定する

次回起動する冗長領域を設定する場合、device bootコマンドを実行します。

実行モード: 管理者モード(amnimo#)/設定モード(amnimo(cfg)#)

書式
device boot { 0 | 1 }
パラメーター
パラメーター説明範囲・形式初期値
0 / 1次回起動する冗長領域を指定します。
・ 0:起動エリアが0の場合
・ 1:起動エリアが1の場合
0 / 1―
実行例
amnimo# device boot 0
関連コマンド

2.4.7 ファームウェアのパッケージ情報を更新する

対象機種: AX30 / AX11 / AX21 / AG10 / AG20 / AR10 / AR20(コンパクトルーターは非対応)

パッケージの更新情報を取得し、更新があるパッケージのリストを表示するには、firmware package updateコマンドを実行します。

実行モード: 管理者モード(amnimo#)

書式
firmware package update
実行例
amnimo# firmware package update
package name            new version                old version 
--------------------------------------------------------------------------------
amnimo-cli              1.2.0                      1.1.0
libag-baes              1.1.0                      1.0.0
libarchive              3.2.2-3.1ubuntu0.6         3.1.2-7ubuntu2
isc-dhcp-client         4.3.5-3ubuntu7.1           4.2.4-7ubuntu12
(省略)
--------------------------------------------------------------------------------
関連コマンド

2.4.8 ファームウェアのパッケージを更新する

対象機種: AX30 / AX11 / AX21 / AG10 / AG20 / AR10 / AR20(コンパクトルーターは非対応)

ファームウェアのパッケージを更新するには、firmware package upgradeコマンドを実行します。

更新されるパッケージは、ファームウェアのパッケージ情報を更新したときに表示されるパッケージです。(以下、本機能による更新方法を「差分更新」と呼びます。)

➜ 『2.4.7 ファームウェアのパッケージ情報を更新する』

実行モード: 管理者モード(amnimo#)

書式
firmware package upgrade
注意・補足

note 補足:

実行例
amnimo# firmware package upgrade
Downloading amnimo-cli…
Installing amnimo-cli …
関連コマンド

全体更新・差分更新について

以下に全体更新と差分更新の違いについて記載します。それぞれの特徴に従い、利用状況に応じて使い分けることが可能です。

全体更新差分更新
更新領域設定領域対象外
(アムニモ設定情報は保持されます)
rootfs全体更新(注意1)
userfs対象外
共有領域対象外
SSD対象外
冗長エリアの更新指定可能指定不可
ダウンロード時の通信コスト大小
更新時間長い短い(注意2)

warning 注意:

2.4.9 ファームウェアのパッケージ情報ファイルを削除する

対象機種: AX30 / AX11 / AX21 / AG10 / AG20 / AR10 / AR20(コンパクトルーターは非対応)

ファームウェアのパッケージ情報ファイルを削除するには、firmware package cleanコマンドを実行します。

実行モード: 管理者モード(amnimo#)

書式
firmware package clean
注意・補足

note 補足: ファームウェアのパッケージを削除したあとに、再度パッケージを取得したい場合は、パッケージ情報を更新してください。
➜ 『2.4.7 ファームウェアのパッケージ情報を更新する』

実行例
amnimo# firmware package clean
関連コマンド