View Categories

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

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

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

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

ax30 ax11 ax21 ag10 ag20 ar10 ar20 ac10 ac15 ac25

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

実行例

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

user_mode admin_mode

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
note機種が異なる場合、機種に固有の内容が表示されます。

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

ax30 ax11 ax21 ag10 ag20 ar10 ar20 ac10 ac15 ac25

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

noteファームウェア更新する前に、更新ソフトウェアウェアに付与されたSHA256ハッシュ値との照合を行い、照合の結果、不一致が確認された場合にはインストールが中止されます。(JC-STAR★適合基準番号 S1.1-08)
書式
firmware file check URL
設定項目
項目内容
URLURLには、HTTPやFTPなどの情報を指定することができます。
以下に、ファイル名を屋内タイプエッジゲートウェイ用のファームウェアファイル 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弊社公開のファームウェアを取得するためには、「接続先とファームウェア」「アカウント名」「パスワード」の情報が必要です。アカウントとパスワードについては、弊社サポートに別途ご連絡ください。
 例：屋内タイプエッジゲートウェイ
https://(アカウント名):(パスワード)@package.amnimo.com/firmware/ag10.amf
各機器のURLについては、各機種のリリースノートを参照ください。リリースノートには過去にリリースしたファームウェアのURLも記載されています。なおリリースノートへのアクセスもアカウントとパスワードが必要です。
※1を参照
※1
機種リリースノート
ax30ax11ax21ag10ag20ar10ar20amnimo X/G/R シリーズ リリースノート
ac10ac15ac25amnimo C シリーズ リリースノート
実行例
admin_mode 
ダウンロード中
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 ファームウェアを削除する #

ax30 ax11 ax21 ag10 ag20 ar10 ar20 ac10 ac15 ac25

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

note・ ダウンロード済みのファームウェアファイルは、RAMに保存されています。
・ ダウンロード済みのファイルがない場合は、コマンドの実行時に「ERROR: Firmware file does not exist.」と表示されます。
実行例
admin_mode 
amnimo# firmware file delete ⮠
Deleted!

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

ax30 ax11 ax21 ag10 ag20 ar10 ar20 ac10 ac15 ac25

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

note・ 本コマンドを実行する前に、ファームウェアファイルをダウンロードしておく必要があります。(urlオプションを利用する場合は不要)
書式
firmware area update [target <back | both>] [force <true | false>] [url URL] [factory-reset <true | false>]
設定項目
項目内容
target更新するターゲットを設定します。
※2を参照
note
デフォルト値はV1.7.0以下では「back」、V1.8.0以上では「both」になります。
force再起動時、ユーザーに確認するかどうかを設定します。
※3を参照
urlURLには、HTTPやFTPなどの情報を指定することができます。
以下に、ファイル名を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
URLの入力を省略すると、firmware checkが実行され、ファームウェアがダウンロード済みであればそれを使用し、ダウンロードされていなければエラーになります。
factory-resetファームウェア更新後、本体設定やログ等を削除する工場出荷状態への移行可否を設定します。(JC-STAR★1 適合基準番号 S1.1-15 相当）
※4を参照
note
・ バージョン 3.1.0 以降のソフトウェアに搭載されています。
・ コンパクトルーターで、工場出荷状態にする場合には、アプリケーション部のファームウェアを指定してください。
※2
設定内容
back現在起動していない冗長領域を更新します。
both両方の冗長領域を更新します。
※3
設定内容
trueユーザーに確認せず、強制的に再起動します。
false再起動する前に、ユーザーに確認します。
※4
設定内容
trueファームウェア更新後、工場出荷状態になります。
falseファームウェア更新後、設定やログ等は維持し再起動します。（デフォルト設定）
実行例1 (V1.8.0以降)

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

admin_mode

ファームウェア 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を入力
noteコマンドの実行をキャンセルするには、Enterを入力するか、「n」キーに続けてEnterを入力します。
実行例2 (V1.8.0以降)

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

admin_mode

ファームウェア 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を入力
noteコマンドの実行をキャンセルするには、Enterを入力するか、「n」キーに続けてEnterを入力します。

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

ax30 ax11 ax21 ag10 ag20 ar10 ar20 ac10 ac15 ac25

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

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

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

書式
firmware area sync [force <true | false>]
設定項目
項目内容
force再起動時、ユーザーに確認するかどうかを設定します。
※5を参照
※5
設定内容
trueユーザーに確認せず、強制的に再起動します。
false再起動する前に、ユーザーに確認します。
実行例
admin_mode 
amnimo# firmware area sync ⮠
reboot to sync? (y/N):		←「y」キーに続けてEnterを入力
noteコマンドの実行をキャンセルするには、Enterを入力するか、「n」キーに続けてEnterを入力します。

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

ax30 ax11 ax21 ag10 ag20 ar10 ar20 ac10 ac15 ac25

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

冗長領域を表示する

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

  • 0： 冗長領域が0の場合
  • 1： 冗長領域が1の場合
実行例

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

user_mode admin_mode config_mode

amnimo$ show device boot ⮠
1

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

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

本コマンドには、パラメーターとして、以下のいずれかの値を指定します。

  • 0： 起動エリアが0の場合
  • 1： 起動エリアが1の場合
実行例

admin_mode config_mode

amnimo# device boot 0 ⮠

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

ax30 ax11 ax21 ag10 ag20 ar10 ar20

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

noteコンパクトルーターでは、本機能は利用できません。
実行例
admin_mode 
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　ファームウェアのパッケージ情報を更新する』

note・ ファームウェアのパッケージを個別に指定して更新することはできません。
・ 本機能は、aptパッケージ管理システムを使用しています。
パッケージの更新時には「--force-confold」オプションが適用されます。これによって、パッケージ更新で各パッケージのアムニモ設定情報が変更された場合でも、変更前のアムニモ設定情報が使用されます。
・ パッケージ更新後は、セキュリティの観点から本機器の再起動を推奨します。
・ コンパクトルーターでは、本機能は利用できません。
実行例
admin_mode 
amnimo# firmware package upgrade ⮠
Downloading amnimo-cli…
Installing amnimo-cli …

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

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

全体更新差分更新
更新領域設定領域対象外
(アムニモ設定情報は保持されます)
rootfs全体更新
warning
領域は初期化されるため、ユーザーが独自でインストールしたパッケージも削除されます。
userfs対象外
共有領域対象外
SSD対象外
冗長エリアの更新指定可能指定不可
ダウンロード時の通信コスト大小
更新時間長い短い
warning
・ 起動領域と冗長領域の同時更新は出来ません。両面更新する場合は、別途エリア同期が必要になり、エリア同期には約10分程度の時間が必要になります。
・ 差分があるパッケージ数によっては、全体更新よりも時間がかかる場合があります。

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

ax30 ax11 ax21 ag10 ag20 ar10 ar20

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

noteコンパクトルーターでは、本機能は利用できません。
実行例
admin_mode 
amnimo# firmware package clean ⮠
noteファームウェアのパッケージを削除したあとに、再度パッケージを取得したい場合は、パッケージ情報を更新してください。
➜ 『2.4.7　ファームウェアのパッケージ情報を更新する』
What are your Feelings
上部へスクロール