SwitchBlade x908 GEN2 コマンドリファレンス 5.5.6
このたびは、SwitchBlade x908 GEN2をお買い上げいただき、誠にありがとうございます。本マニュアルでは、SwitchBlade x908 GEN2のファームウェアであるAlliedWare Plusの機能とコマンドについて詳細に解説しています。各機能の使用方法やコマンドの解説に加え、複数の機能を組み合わせた具体的な設定例も数多く掲載しています。SwitchBlade x908 GEN2を活用するための参考資料としてご利用ください。
なお、設定を行う前に必要なこと、たとえば機器の設置や配線、設定に使用するコンソールターミナルの準備などについては原則として説明しておりません。これらに関しては、製品付属の冊子「取扱説明書」などをご覧ください。
はじめに
対象機種とバージョン
本マニュアルは、以下の機種用のAlliedWare Plusバージョン「5.5.6-0.1」を対象に記述されています。ただし、執筆時には開発中のバージョンを用いたため、画面表示などが実際の製品とは異なる場合があります。また、旧バージョンから機能的な変更がない場合は、画面表示などに旧バージョンのものを使っている場合があります。あらかじめご了承ください。- SwitchBlade x908 GEN2シリーズ
製品のご使用に当たっては、必ず弊社ホームページに掲載のリリースノートや添付書類をお読みになり、最新の情報をご確認ください。リリースノートや添付書類には、機種やバージョンごとの注意事項や最新情報が記載されています。
本マニュアルはファームウェアのコマンドリファレンスであるため、機種ごとのハードウェア構成の違い(ポート数など)には依存しないよう作成してありますが、設定例などでは特定の機種を想定して記述している場合があります。このような箇所については、適宜ポート番号等を読み替えてくださいますようお願いいたします。
サポート機能と制限事項
ファームウェアのバージョンやハードウェアのリビジョンにより、サポート対象となる機能の範囲が異なる場合があります。原則として、本マニュアルに記載されていない機能、コマンドはサポート対象外です。また、本マニュアルに記載されている機能やコマンドでも、サポート対象外となることがあります。各バージョンにおけるサポート機能や制限事項については、弊社ホームページに掲載のリリースノートや添付書類でご確認ください。また、機能によってはライセンスを必要とするものもありますので、そちらもあわせてご確認ください。マニュアルの提供形態
本マニュアルはHTML(Hyper Text Markup Language)形式のオンラインマニュアルです。弊社Webサイトにて最新バージョンを見ることができます。印刷物としては提供しておりませんので、必要な場合はHTMLファイルをプリンターで出力してご使用ください。マニュアルの構成
本マニュアルの構成について説明します。章構成
まず、本マニュアルは大きな機能ごとに章が分けられています。画面上部のフレームに表示されている項目([運用・管理]など)が各章へのリンクになっています。章名をクリックすると、画面左側のフレームに該当する章の機能別索引が表示されます。索引上のリンクをクリックすることにより、画面右側のフレームにコマンドや機能の解説が表示されます。
章内の構成
各章は、大きく分けて「機能解説編」と「コマンドリファレンス編」の2つの部分から構成されています。機能解説編(以下、解説編)は、それぞれの機能において使用するコマンドや設定手順、注意点、具体的な設定例などを解説したものです。通常、1つの機能を使用するには複数のコマンドを組み合わせて使う必要があります。コマンドリファレンス編では個々のコマンドについて詳細に解説していますが、これをどう組み合わせて使用するかについては最小限しか述べられていません。最初に実現したいことが決まっている場合は、解説編で概要をつかんでから各コマンドの詳細解説に目を通すのがよいでしょう。解説編では、必要に応じて具体的な設定例ものせています。左側フレームのコマンド索引にある機能別見出しが該当機能の解説編へのリンクになっています。
コマンドリファレンス編は、コマンドごとに構文、機能、パラメーター、実行例、注意事項などをまとめたものです。各コマンドが1つのHTMLファイル(Webページ)になっています。解説編と同様に、左側フレームのコマンド名をクリックすると、右側フレームに該当するコマンドのページが表示されます。
表記について
本マニュアルにおける各種表記について説明します。コマンド名
本マニュアルでは、識別のため各コマンドに名前を付けています。コマンド名は、コマンド構文のうち入力が必須の部分から付けたものが大部分ですが、中にはそれでは識別できないものもあります。そのような場合は、補助的な情報をカッコ付きで付加することにより区別しています。
また、構文はほぼ同じで名前も同じにならざるを得ないコマンドであっても、実行できるモードが異なり、またモードによって異なる動作をするようなコマンド群もあります。次に例を挙げます。
このため、本マニュアルにおけるコマンド名の完全な表記は、名前とモードの2つを併記した次の形式とします。
- xxxxx yyyyyコマンド
ただし、文脈上モード名を省略しても差し支えないと思われる場合はモード名を省略して表記する場合があります。特に解説編では、特定の機能について述べていることが明白なため、原則としてモード名を省略しています。一方、コマンドリファレンス編では、原則としてモード名を並記しています。
いずれの場合も、文中のコマンド名はコマンドリファレンス編へのリンクになっています。
コマンド構文
コマンドリファレンス編では、以下の基準にしたがってコマンドの構文を表記しています。keyword |
黒小文字の部分はキーワード(予約語)を示します。基本的にそのまま入力してください。ただし、キーワードは大文字小文字の区別がないので、大文字で入力してもかまいません | |
VARIABLE |
青大文字の部分は一般的な変数値(一般的な文字列、数値など)を示します。コマンド入力時には、環境に適した文字列や数字を入力してください。ホスト名など一部のものを除き、大文字小文字を区別します | |
A.B.C.D |
青色のA.B.C.Dは変数値(IPアドレスまたは同形式のID)を示します。A、B、C、Dにはそれぞれ0~255の範囲の10進数を指定します。コマンド入力時には、環境に適したアドレス/IDを入力してください | |
A.B.C.D/M |
青色のA.B.C.D/Mは変数値(マスク/プレフィックス長付きのIPアドレスまたは同形式のID)を示します。A、B、C、Dにはそれぞれ0~255の範囲の10進数を、Mには0~32の範囲の10進数を指定します。コマンド入力時には、環境に適したアドレス/IDとマスク/プレフィックス長を入力してください | |
X:X::X:X |
青色のX:X::X:Xは変数値(IPv6アドレス)を示します。IPv6アドレスは各種の省略表記が可能なため、同じアドレスを表す文字列が複数存在するケースもありえます。コマンド入力時には、環境に適したアドレスを入力してください | |
X:X::X:X/M |
青色のX:X::X:X/Mは変数値(プレフィックス長付きのIPv6アドレス)を示します。IPv6アドレスは各種の省略表記が可能なため、同じアドレスを表す文字列が複数存在するケースもありえます。コマンド入力時には、環境に適したアドレスとプレフィックス長を入力してください | |
W.X.Y.Z |
青色のW.X.Y.Zは変数値(IPアドレスまたは同形式のIDに対するマスク)を示します。マスクには、サブネットマスクのように有意なビットを立てるANDマスクと、ワイルドカードマスクのように無視するビットを立てるORマスクがあります。W、X、Y、Zにはそれぞれ0~255の範囲の10進数を指定します。コマンド入力時には、環境に適したマスク値を入力してください | |
HHHH.HHHH.HHHH |
青色のHHHH.HHHH.HHHHは変数値(MACアドレス)を示します。HHHHにはMACアドレスの2オクテット分を16進数4桁(0000~ffff)で指定します。コマンド入力時には、環境に適したアドレスを入力してください | |
XXXX.XXXX.XXXX |
青色のXXXX.XXXX.XXXXは変数値(MACアドレスに対するマスク)を示します。XXXXにはMACアドレス用ワイルドカードマスク(ORマスク)の2オクテット分を16進数4桁(0000~ffff)で指定します。コマンド入力時には、環境に適したマスク値を入力してください | |
<1-32> |
青色の<1-32>は変数値(数値)の一種で指定可能な数値の範囲を表します。たとえば、<1-32>は1~32の範囲の数値を指定するという意味です。指定できる数値の範囲はコマンドにより異なります | |
{aaa | bbb | CCC} |
ブレース(中カッコ)で囲まれた部分は、選択肢を表します。選択肢の各要素が縦棒1つ(|)で区切られている場合は、選択肢から1つだけを選択して指定できます。見やすさのため、縦棒の前後に適宜スペースを入れて表記しています | |
{aaa & bbb & CCC} |
ブレース(中カッコ)で囲まれた部分は、選択肢を表します。選択肢の各要素がアンパサンド(&)で区切られている場合は、選択肢から1つ以上複数の項目を選択して指定できます。見やすさのため、アンパサンドの前後にスペースを入れて表記しています。複数の要素を指定する場合は「aaa CCC」のように項目をスペースで区切って指定してください | |
[optional VALUE] |
スクエアブラケット(角カッコ)で囲まれた部分は省略可能であることを示します | |
[aaa | bbb | CCC] |
選択肢全体が省略可能なときは、本来 [{aaa | bbb | CCC}] のように書くべきですが、冗長なのでブレースを省略することがあります。これは択一選択肢、複数選択肢とも同じです | |
mandatory VALUE |
太字の部分は、必ず入力しなくてはならない部分を表しています。具体的にはスクエアブラケットで囲まれていない部分がこれに相当します | |
STRUCT |
青緑の部分は上記の複数の要素が組み合わさっている部分(複合要素)、あるいは、上記のいずれかの要素の別名であることを示します。コマンド構文を見やすくするため、複雑な選択肢などをこの形式で表したり、同じ形式の変数(たとえばIPアドレス)が複数回登場するような場合に、それぞれの意味合いを込めてこの形式で表したりすることがあります。具体的な内容はパラメーター解説のセクションで示します(次項を参照) | |
STRUCT := {a | b V [c]} |
パラメーター解説のセクションにおいて、複合要素や別名の具体的内容をこの形式で表します。「:=」の左側が構文中の複合要素名/別名、「:=」の右側が実際の内容です |
なお、本マニュアルにおける変数名の表記は、コマンド入力補助機能(「運用・管理」の「コマンドラインインターフェース(CLI)」をご参照ください)で表示される変数名とは必ずしも一致しません。本マニュアルでは、構文全体として見たときの理解しやすさを優先して、人間の手で編集を加えているためです。あらかじめご了承ください。
コマンドライン例
本マニュアルにはコマンドラインの入力例や出力例が数多く登場します。awplus(config)# no spanning-tree rstp enable
コマンドライン例に関しては、以下の点にご注意ください。
プロンプト
コマンドライン先頭のawplus(config)#のような箇所はコマンドプロンプトを表しています。コマンドプロンプトは自動的に表示されるもので、入力する必要はありません。コマンドプロンプトの先頭はホスト名を表しますが、ほとんどの例ではデフォルトの「awplus」を使っています。ただし、一部の構成例では、複数の機器を見分けやすくするため、ホスト名を「RouterA」、「RouterB」のように変更している場合もあります。
入力すべき箇所
入力すべき箇所は太字で表しています。前記の例では「no spanning-tree rstp enable」が入力すべき文字列です。なお、必要な文字列を入力したら最後に「Enter」キーを押してください。これにより、コマンドが実行されます。なお、「Enter」キーを押すとき、必ずしもカーソルが行末になくてもかまいません。
折り返し
HTMLの仕様上、折り返し位置の制御が困難なため、本書ではコマンドラインの末尾(改行位置)を次の例のように赤の下向き矢印で示しています。↓までを一行と考えてください。デフォルト
本マニュアルでは、いわゆる「デフォルト」について、次のように書き分けています。初期設定
製品出荷時における設定の状態やパラメーターの値を「初期設定」または「初期値」と呼びます。スパニングツリープロトコルの動作モードを設定するspanning-tree modeコマンドを例に挙げると、動作モードの初期設定はrstpとなります。これはすなわち、何も設定を行っていない状態では、spanning-tree mode rstpという設定が行われているのと等しいという意味です。省略時設定
コマンドによっては、省略可能なパラメーターを持つものがあります。こうしたコマンドで特定のパラメーターを省略した場合、該当パラメーターの値として何が保持されることになるかを「省略時設定」または「省略時値」と呼びます。たとえば、VLANを定義するvlanコマンドには省略可能なnameパラメーターがありますが、これを省略した場合、同パラメーターの値は「VLANXXXX」(XXXXは4桁のVLAN ID)となります。なお、省略時値は特定の設定要素に対して初めてコマンドを入力したときだけで適用され、すでに設定済みの要素に対して変更を加えるときは明示的に値を指定しないかぎり該当パラメーターの値は変更されないのが普通ですが、そうでないものもあります。設定作業時には、こまめにshow running-configコマンドを実行し、設定内容が意図したとおり反映されているか確認しながら進めることをおすすめします。
本製品
本マニュアルでは、前記対象バージョンのファームウェアを搭載した前記対象製品を「本製品」と総称します。例
本マニュアルには、数多くの「例」が登場します。IPアドレス、ドメイン名、ログイン名、パスワードなどに具体的な文字列や値を使用していますが、これらは例として挙げただけの架空の存在です。実際に運用を行う場合は、お客様の環境におけるものをご使用ください。また、本書の設定例はあくまでも説明のためのサンプルです。お客様の環境に適した設定を行う際の参考としてください。ある機能について説明するため、現実のネットワークではあり得ないような構成例を使っているところがあるかもしれません。実際にネットワークを構築する場合は、お客様の環境に適した構成をとるようにしてください。
最新情報
製品の出荷後は、弊社Webサイトでマニュアル等の正誤情報や改版されたマニュアル、アップデートされたファームウェアなどの最新の情報を公開しています。https://www.allied-telesis.co.jp/
ご注意
- 本書に関する著作権等の知的財産権は、アライドテレシス株式会社(弊社)の親会社であるアライドテレシスホールディングス株式会社が所有しています。
- アライドテレシスホールディングス株式会社の同意を得ることなく、本書の全体または一部をコピーまたは転載しないでください。
- 弊社は、予告なく本書の全体または一部を修正・改訂することがあります。
- また、弊社は改良のため製品の仕様を予告なく変更することがあります。
(C) 2017 - 2026 アライドテレシスホールディングス株式会社
商標について
- CentreCOM、CentreNET、SwitchBladeは、アライドテレシスホールディングス株式会社の登録商標です。
- Windows、MS-DOS、Windows NTは、米国Microsoft Corporationの米国およびその他の国における登録商標です。
- その他、この文書に記載されているソフトウェアおよび周辺機器の名称は各メーカーの商標または登録商標です。
マニュアルバージョン
- 2017年9月20日 Rev.A(Ver.5.4.7B-1.1)
- 2017年12月14日 Rev.B(Ver.5.4.7-2.3)
- 2018年1月10日 Rev.C(Ver.5.4.7-2.3)
- 2018年3月5日 Rev.D(Ver.5.4.7-2.5)
- 2018年4月20日 Rev.E(Ver.5.4.8-0.2)
- 2018年8月8日 Rev.F(Ver.5.4.8-1.1)
- 2018年11月28日 Rev.G(Ver.5.4.8-2.1)
- 2019年1月18日 Rev.H(Ver.5.4.8-2.3)
- 2019年4月16日 Rev.J(Ver.5.4.9-0.1)
- 2019年6月20日 Rev.K(Ver.5.4.9-0.1)
- 2019年9月19日 Rev.L(Ver.5.4.9-1.3)
- 2019年12月6日 Rev.M(Ver.5.4.9-2.1)
- 2020年1月17日 Rev.N(Ver.5.4.9-2.3)
- 2020年4月15日 Rev.P(Ver.5.5.0-0.1)
- 2020年5月14日 Rev.Q(Ver.5.5.0-0.1)
- 2020年6月23日 Rev.R(Ver.5.5.0-0.3)
- 2020年8月7日 Rev.S(Ver.5.5.0-1.1)
- 2020年9月25日 Rev.T(Ver.5.5.0-1.3)
- 2020年11月27日 Rev.U(Ver.5.5.0-2.1)
- 2021年1月13日 Rev.V(Ver.5.5.0-2.3)
- 2021年4月22日 Rev.W(Ver.5.5.1-0.1)
- 2021年5月21日 Rev.Y(Ver.5.5.1-0.1)
- 2021年8月30日 Rev.Z(Ver.5.5.1-1.1)
- 2021年12月21日 Rev.AA(Ver.5.5.1-2.1)
- 2022年2月2日 Rev.AA_1(Ver.5.5.1-2.1)
- 2022年4月21日 Rev.AB(Ver.5.5.2-0.1)
- 2022年8月24日 Rev.AC(Ver.5.5.2-1.1)
- 2023年1月27日 Rev.AD(Ver.5.5.2-2.3)
- 2023年5月2日 Rev.AE(Ver.5.5.3-0.1)
- 2023年10月6日 Rev.AF(Ver.5.5.3-1.3)
- 2023年12月20日 Rev.AG(Ver.5.5.3-2.1)
- 2024年3月19日 Rev.AH(Ver.5.5.4-0.1)
- 2024年9月18日 Rev.AJ(Ver.5.5.4-1.2)
- 2025年1月24日 Rev.AK(Ver.5.5.4-2.3)
- 2025年4月22日 Rev.AL(Ver.5.5.5-0.1)
- 2025年5月9日 Rev.AL_1(Ver.5.5.5-0.1)
- 2025年5月30日 Rev.AM(Ver.5.5.5-0.2)
- 2025年8月14日 Rev.AN(Ver.5.5.5-1.1)
- 2025年12月17日 Rev.AP(Ver.5.5.5-2.1)
- 2026年4月21日 Rev.AQ(Ver.5.5.6-0.1)