ソフトウェア更新

コマンド一覧

コマンド

コマンドの機能

software-update

ルータソフトウェアのアップデート

software-select

起動ソフトウェア面の切り替え

show software

起動ソフトウェアの表示

注釈

本コマンドは IX-R シリーズでのみ利用できます。

ルータソフトウェアのアップデート

[入力形式]

software-update URL [ account ACCOUNT ] [ password PASSWORD ]
[ auto-reload ] [ auto-erase ] [ ipv6 ] [ ssl-protocol SSL-PROTOCOL ]
[ source SOURCE-ADDRESS | interface INTERFACE ] [ with-pbl | only-pbl ]

[パラメータ]

URL...プロトコルとドメイン、更新ソフトウェアの指定

<protocol>://<domain-name>[:<port>]/<path>/<filename>

  • protocol...http,https,scp,tftp

  • domain-name...IPアドレス、FQDN

  • port...ポート番号(TFTPでは指定不可)

  • path...パス

  • filename...更新ソフトウェアファイル名

  • TFTPでのダウンロードは他のプロトコルに比べ非常に遅くなります。

usbmemX[.Y]:<path>/<filename>

  • usbmemX[.Y]...USBメモリデバイス名

  • X...USBポート番号 (範囲0)

  • Y...論理ユニット番号 (範囲0-3、0の場合は省略可能)

  • path...ディレクトリ名

  • filename...更新ソフトウェアファイル名

file:<filename>

  • filename...装置に保存した更新ソフトウェアファイル名

ACCOUNT...ユーザー名

  • 127文字以内の文字列

PASSWORD...パスワード

  • 127文字以内の文字列

auto-reload...自動再起動指定

  • アップデート成功時、自動的に再起動します。

auto-erase...内部ストレージ容量不足時のファイル自動削除指定

  • 内部ストレージの容量不足でファイルをダウンロードできない場合に、内部ストレージ上のファイルを自動的に削除します。

ipv6...IPv6 指定

SSL-PROTOCOL...SSLプロトコル

  • tls1.3-and-later : TLS1.3 以降を使用

  • デフォルト値:TLS1.2 以降を使用

SOURCE-ADDRESS...送信元 IP アドレス

  • IPv4 アドレス

  • IPv6 アドレス

INTERFACE...送信インタフェース名

with-pbl...Pre Boot Loader (PBL) を同時に更新

only-pbl...Pre Boot Loader (PBL) のみを更新

[説明]
指定されたプロトコルで指定URLからソフトウェアを取得し、ソフトウェアの書き換えを行います。
取得した新しいソフトウェアを利用する際には再起動が必要です。
再起動後、新しいソフトウェアでの起動に失敗した場合、前回起動したファイルを利用して起動を試みます。
サーバーが認証を要求する場合にはオプションで指定します。
[デフォルト値]

なし

[実行モード]

グローバルコンフィグモード

[ユーザー権限]

Administrator

[入力例]
software-update scp://domain/~user1/newfile.bin
software-update scp://domain//home/user1/newfile.bin
software-update https://domain/path/newfile.bin account user1 password himitsu
software-update https://domain/path/newfile.bin ipv6 ssl-protocol tls1.3-and-later
software-update http://domain/path/newfile.bin auto-reload
software-update usbmem0:newfile.bin
software-update file:newfile.bin
[ノート]
本コマンドは IX-R シリーズでのみ利用できます。

HTTP/HTTPS/SCP/TFTPの場合はURL全体で511文字までです。

ACCOUNT にハイフンから始まるユーザー名を指定することはできません。

USBメモリのファイル入力形式は以下となります。
  • ':'の後から末尾までの文字列長は最大256文字('/'を含む)

  • ディレクトリ名やファイル名の文字列長は最大64文字

  • 日本語ファイル名、スペース入りファイル名は使用不可

  • ディレクトリ名やファイル名に使用可能な文字種は、半角英数字と下記の記号のみ

    _ # + , . @ ~ ^ -
  • ディレクトリの区切り文字は'/'

  • '../'を含むディレクトリパスは使用不可

  • 先頭文字は数字も可能

  • 'usbmemX[.Y]:'直後の'/'は複数でも可

内部ストレージのファイル入力形式は以下となります。
  • ファイル名の文字列長は最大64文字

  • 日本語ファイル名、スペース入りファイル名は使用不可

  • ファイル名に使用可能な文字種は、半角英数字と下記の記号のみ

    _ # + , . @ ~ ^ -
  • 先頭文字は数字も可能

  • ディレクトリパスは使用不可

  • 'file:'直後の'/'は複数でも可

domain-nameにFQDNを指定した場合、DNSサーバーからAレコードの応答を受信できなければファイルをダウンロードすることができません。ファイルのダウンロード元のIPアドレスが不明な場合は、nslookupコマンド等でIPアドレスを確認し、domain-nameにIPアドレスを指定してください。
[リスタート]

必要

[IX2000/IX3000シリーズ差分]
  • bootmode-update オプション廃止

  • no-interactive オプション未サポート

  • ssl-protocol ssl3.0 オプション未サポート

  • scp 対応

起動ソフトウェア面の切り替え

[入力形式]

software-select FILENAME

[パラメータ]

FILENAME...次回起動ファイル名

[説明]

装置に存在するファイルを指定し、次回起動ソフトウェアを切り替えます。

[デフォルト値]

なし

[実行モード]

グローバルコンフィグモード

[ユーザー権限]

Administrator

[入力例]

software-select newfile.bin

[ノート]
起動ソフトウェアファイル名は show software コマンドで確認できます。
本コマンドは IX-R シリーズでのみ利用できます。

起動ソフトウェアの表示

[入力形式]

show software

[パラメータ]

なし

[説明]

ソフトウェア状態およびバージョン、ファイル名を表示します。

[デフォルト値]

なし

[実行モード]

グローバルコンフィグモード

[ユーザー権限]

Administrator/Operator/Monitor

[入力例]

show software

[ノート]
本コマンドは IX-R シリーズでのみ利用できます。

コマンド変更情報

Ver1.1 コマンド変更情報