対象機種: 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 | パッケージ情報ファイルを削除する | 管理者 |
ファームウェアのバージョン情報を表示するには、show firmwareコマンドを実行します。
実行モード: 一般ユーザーモード(amnimo$)/管理者モード(amnimo#)
show firmware
補足: 機種が異なる場合、機種に固有の内容が表示されます。
一般ユーザーモードと管理者モードで、コマンドの入力と出力は同じです。以下に、エッジゲートウェイでの管理者モードの実行例を示します。
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
ファームウェアが存在することを確認します。外部サーバーにあるファームウェアについてはダウンロードを実施します。
実行モード: 管理者モード(amnimo#)
firmware file check [ URL ]
| パラメーター | 説明 | 範囲・形式 | 初期値 |
|---|---|---|---|
| URL | ファームウェアファイルの場所を指定します。HTTPやFTPなどの情報を指定することができます。 | file://、tftp://、ftp://、http://、https:// で始まるURL。※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 |
補足: ファームウェアを更新する前に、更新ソフトウェアに付与されたSHA256ハッシュ値との照合を行い、照合の結果、不一致が確認された場合にはインストールが中止されます。(JC-STAR★1 適合基準番号 S1.1-08)
補足: 弊社公開のファームウェアを取得するためには、「接続先とファームウェア」「アカウント名」「パスワード」の情報が必要です。アカウントとパスワードについては、弊社サポートに別途ご連絡ください。
例:屋内タイプエッジゲートウェイ
https://(アカウント名):(パスワード)@package.amnimo.com/firmware/ag10.amf
各機器のURLについては、各機種のリリースノートを参照ください。リリースノートには過去にリリースしたファームウェアのURLも記載されています。なおリリースノートへのアクセスもアカウントとパスワードが必要です。
- AX30 / AX11 / AX21 / AG10 / AG20 / AR10 / AR20:amnimo X/G/R シリーズ リリースノート
- AC10 / AC15 / AC25:amnimo C シリーズ リリースノート
ダウンロード中
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
ダウンロード済みファームウェアファイルは、firmware file deleteコマンドで削除することができます。
実行モード: 管理者モード(amnimo#)
firmware file delete
補足:
- ダウンロード済みのファームウェアファイルは、RAMに保存されています。
- ダウンロード済みのファイルがない場合は、コマンドの実行時に「ERROR: Firmware file does not exist.」と表示されます。
amnimo# firmware file delete
Deleted!
本製品のファームウェアの更新対象には、起動領域と冗長領域の2つがあります。それぞれの領域を更新するには、firmware area updateコマンドを実行します。本コマンドを実行すると、再起動するかどうかをたずねられます。再起動を許可すると、ファームウェアが更新されます。(以下、本機能による更新方法を「全体更新」と呼びます。)
実行モード: 管理者モード(amnimo#)
firmware area update [ target { back | both } ] [ force { true | false } ] [ url URL ] [ factory-reset { true | false } ]
| パラメーター | 説明 | 範囲・形式 | 初期値 |
|---|---|---|---|
| target | 更新するターゲットを設定します。 ・ back:現在起動していない冗長領域を更新します。 ・ both:両方の冗長領域を更新します。 | back / both | both(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 / false | false |
補足:
- 本コマンドを実行する前に、ファームウェアファイルをダウンロードしておく必要があります。(urlオプションを利用する場合は不要)
- urlの入力を省略すると、firmware file checkが実行され、ファームウェアがダウンロード済みであればそれを使用し、ダウンロードされていなければエラーになります。
- コンパクトルーターで、factory-resetにより工場出荷状態にする場合には、アプリケーション部のファームウェアを指定してください。
- メジャーバージョンへのアップデートの際は、targetに「both」を指定してください。
➜ 『本製品に関するご注意』
実行例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を入力します。
現在起動している冗長領域をもう一方の冗長領域にコピーする場合、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を入力します。
現在起動している冗長領域の表示と設定を行います。
現在の冗長領域を表示します。
実行モード: 一般ユーザーモード(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
対象機種: 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
(省略)
--------------------------------------------------------------------------------
対象機種: AX30 / AX11 / AX21 / AG10 / AG20 / AR10 / AR20(コンパクトルーターは非対応)
ファームウェアのパッケージを更新するには、firmware package upgradeコマンドを実行します。
更新されるパッケージは、ファームウェアのパッケージ情報を更新したときに表示されるパッケージです。(以下、本機能による更新方法を「差分更新」と呼びます。)
➜ 『2.4.7 ファームウェアのパッケージ情報を更新する』
実行モード: 管理者モード(amnimo#)
firmware package upgrade
補足:
- ファームウェアのパッケージを個別に指定して更新することはできません。
- 本機能は、aptパッケージ管理システムを使用しています。パッケージの更新時には「--force-confold」オプションが適用されます。これによって、パッケージ更新で各パッケージのアムニモ設定情報が変更された場合でも、変更前のアムニモ設定情報が使用されます。
- パッケージ更新後は、セキュリティの観点から本機器の再起動を推奨します。
amnimo# firmware package upgrade
Downloading amnimo-cli…
Installing amnimo-cli …
以下に全体更新と差分更新の違いについて記載します。それぞれの特徴に従い、利用状況に応じて使い分けることが可能です。
| 全体更新 | 差分更新 | |
|---|---|---|
| 更新領域 | 設定領域 | 対象外 (アムニモ設定情報は保持されます) |
| rootfs | 全体更新(注意1) | |
| userfs | 対象外 | |
| 共有領域 | 対象外 | |
| SSD | 対象外 | |
| 冗長エリアの更新 | 指定可能 | 指定不可 |
| ダウンロード時の通信コスト | 大 | 小 |
| 更新時間 | 長い | 短い(注意2) |
注意:
- 注意1:領域は初期化されるため、ユーザーが独自でインストールしたパッケージも削除されます。
- 注意2:起動領域と冗長領域の同時更新は出来ません。両面更新する場合は、別途エリア同期が必要になり、エリア同期には約10分程度の時間が必要になります。また、差分があるパッケージ数によっては、全体更新よりも時間がかかる場合があります。
対象機種: AX30 / AX11 / AX21 / AG10 / AG20 / AR10 / AR20(コンパクトルーターは非対応)
ファームウェアのパッケージ情報ファイルを削除するには、firmware package cleanコマンドを実行します。
実行モード: 管理者モード(amnimo#)
firmware package clean
補足: ファームウェアのパッケージを削除したあとに、再度パッケージを取得したい場合は、パッケージ情報を更新してください。
➜ 『2.4.7 ファームウェアのパッケージ情報を更新する』
amnimo# firmware package clean