[index] CentreCOM x900シリーズ・SwitchBlade x908 コマンドリファレンス 5.3.3

運用・管理 / コマンドラインインターフェース（CLI） 

  - ログイン
  - コマンドモードとプロンプト
   - 実行モード
   - 設定モード
    - 設定モードで実行モードコマンドを実行
  - コマンドライン編集キー
  - コマンド入力時の注意事項
  - コマンドの否定形（no形式）
  - メッセージ
  - コマンド入力補助機能
   - 入力候補の表示
    - 次のキーワード候補を表示
    - 入力途中のキーワード候補を表示
   - キーワードの補完
  - モディファイアとリダイレクション
  - 端末画面のページ当たり行数
本製品に対する設定は、管理用端末から本製品の管理機構であるコマンドラインインターフェース（CLI）にアクセスして行います。

ここでは、CLIに関する基本的なことがらについて説明します。CLIへのアクセス方法については「運用・管理」の「システム」をご覧ください。

ログイン

 本製品の管理機構であるコマンドラインインターフェース（CLI）を利用するには、ユーザー名とパスワードを入力してログインする必要があります。ログインせずに管理作業を行うことはできません。

初期設定では、次に示す権限レベル15のユーザーアカウントが登録されています。


初回ログイン時はこのユーザー名とパスワードでログインしてください。パスワードを変更している場合や、他のユーザーを登録している場合は、それぞれ適切なユーザー名とパスワードを使用してログインしてください。

ログインするには、「login:」プロンプトに対してユーザー名を、続いて表示される「Password:」プロンプトに対してパスワードを入力します。

awplus login: manager ↓
Password: friend ↓（実際には表示されません）

AlliedWare Plus (TM) 5.2.2 09/25/08 18:57:58
awplus>


短いメッセージの後（上の例では「AlliedWare Plus ...」）、「awplus>」のようなコマンドプロンプトが表示されればログイン成功です。

ユーザー名やパスワードを間違えた場合は、「Login incorrect」というメッセージの後に「login:」プロンプトが再表示されるので、もう一度ログインを試みてください。

Note - 初期設定のパスワードを使い続けることはセキュリティー上好ましくありませんので、初回ログイン時に変更することをおすすめします。詳細は「運用・管理」の「ユーザー認証」をご覧ください。

Note - 既定回数（初期設定では5回）連続してログインに失敗すると、コンソールターミナルでは一定時間（初期設定では5分）ログインプロンプトが表示されなくなります。また、Telnet/SSH接続の場合はセッションが切断され、該当クライアントからのTelnet/SSH接続要求が同じ期間拒否されるようになります。これらの設定は、aaa local authentication attempts max-failコマンド、aaa local authentication attempts lockout-timeコマンドで変更できます。

Note - Telnet/SSH接続の場合、ログインプロンプトが表示されてから1分以内にログインしないと、Telnet/SSHセッションが切断されます。切断までの時間は、SSHの場合ssh server login-timeoutコマンドで変更できます。

コマンドモードとプロンプト

 本製品のコマンドラインインターフェース（CLI）には「コマンドモード」の概念があります。各コマンドはあらかじめ決められたモードでしか実行できないため、コマンドを実行するときは適切なモードに移動し、それからコマンドを入力することになります。

コマンドモードは次のような階層構造を持ちます。


モード間の移動方法は次のようになります。


以下、各モードについて解説します。また、コマンドモードによってコマンドプロンプトの表示が異なるため、それもあわせて示します。

実行モード

 実行モード（EXECモード）は、状態の確認や設定の保存、ファイルシステムの操作、スクリプトの実行など、その場かぎりのコマンドを実行するためのモードを総称したものです。具体的には「非特権EXECモード」と「特権EXECモード」の2つからなります。実行モードでは、機器の動作設定を変更するようなコマンドは実行できません。

Note - 次に述べる「非特権EXECモード」を略して「EXECモード」と呼ぶ場合もありますが、本マニュアルで「EXECモード」や「実行モード」と言った場合は、原則として「非特権EXECモード」と「特権EXECモード」の総称です。


設定モード

 設定モード（コンフィグモード）は、機器の動作設定を変更するコマンドを実行するためのモードを総称したものです。具体的には「グローバルコンフィグモード」や「インターフェースモード」など多数のモードからなります。ネットワーク機器としての動作設定はすべて設定モードで行います。

Note - 次に述べる「グローバルコンフィグモード」を略して「コンフィグモード」と呼ぶ場合もありますが、本マニュアルで「コンフィグモード」や「設定モード」と言った場合は、原則として「グローバルコンフィグモード」、「インターフェースモード」などの総称です。


なお、プロンプトの先頭部分はホスト名を表示するための領域です。初期状態ではホスト名が設定されておらず、その場合は「awplus」と表示されるようになっていますが、hostnameコマンドでホスト名を設定すると、「awplus」の代わりに設定したホスト名が表示されるようになります。

本製品を複数管理している場合など、各装置に異なる名前を設定しておくと、現在どの装置にログインしているのかがわかりやすくなり便利です。

awplus(config)# hostname SwitchA ↓
SwitchA(config)#


設定モードで実行モードコマンドを実行

 各種設定モードで作業をしている最中に、show xxxxなどの実行モードコマンドを使って機能の状態を確認したいことはよくあります。

通常このような場合には、endコマンドやCtrl/Zキーを使って特権EXECモードに戻り、実行モードコマンドを実行してから、元の設定モードに戻る必要がありますが、doコマンドを使用すれば設定モードのまま各種実行コマンドを実行させることができます。

awplus(config)# do show snmp-server community ↓
SNMP community information:
  Community Name ........... public
    Access ................. Read-only
    View ................... none

awplus(config)#


ここではグローバルコンフィグモードでdoコマンドを使用していますが、同コマンドはラインモード、インターフェースモードなど、任意の設定モードで使用できます。

なお、doコマンドを使う場合、後述するコマンド入力補助機能は使えません。適宜キーワードの省略形を使うなどしてください。

コマンドライン編集キー

 コマンドラインでは、以下の編集機能を使うことができます（VT100互換の端末エミュレーターが必要です）。

表 4
凡例
Ctrl/△ 「Ctrl」キーを押しながら△キーを押す。たとえば「Ctrl/E」は、「Ctrl」キーを押しながら「E」キーを押すことを意味する
Esc,△ 「Esc」キーを押して離し、次に△キーを押して離す。たとえば「Esc,B」は、「Esc」キーを押して離し、次に「B」キーを押すことを意味する
カーソル移動
Ctrl/Fまたは→ 1文字右に移動する
Alt/FまたはEsc,F 1単語右に移動する（カーソル位置にある単語の最後の文字の次に移動する）
Ctrl/Bまたは← 1文字左に移動する
Alt/BまたはEsc,B 1単語左に移動する（カーソル位置にある単語の先頭文字に移動する）
Ctrl/A 行頭に移動する
Ctrl/E 行末に移動する
削除
Ctrl/HまたはBackspace カーソルの左にある文字を削除する
Ctrl/D カーソル位置の文字を削除する。ただしコマンド行が空の状態でCtrl/Dを押した場合は、exitコマンドと同じ動作となる
Alt/DまたはEsc,D カーソル位置以降、最初の空白の直前までを削除する
Ctrl/K カーソル位置から行末までを削除する
Ctrl/U コマンド行を消去する
その他
Ctrl/T カーソル位置の文字とその直前の文字を入れ換える（カーソルが行末にあるときは、直前の文字とその前の文字を入れ換える）
Ctrl/Pまたは↑ コマンド履歴をさかのぼる
Ctrl/Nまたは↓ コマンド履歴を進める
Ctrl/C 非特権EXECモードと特権EXECモードでは、入力中のコマンド行を破棄して新しい行に移る。各種コンフィグモードでは、入力中のコマンド行を破棄して特権EXECモードに戻る。または、実行中のコマンドを中断する
Ctrl/Z 各種コンフィグモードから特権EXECモードに戻る。endコマンドと同じ動作
TabまたはCtrl/I 入力途中のキーワードを補完、または、次に入力可能なキーワードの候補一覧を表示する


コマンド入力時の注意事項

 コマンド入力時には以下のことがらに注意してください。

■ すでに述べたとおり、コマンドモードによって実行できるコマンドが異なります。現行モードでどのコマンドを実行できるかは、後述する「コマンド入力補助機能」やコマンドリファレンスで確認してください。

■ 「show」、「enable」などのキーワード（予約語）は大文字小文字を区別しないので、どちらで入力してもかまいません。一方、パラメーターとして与える値は、原則として大文字小文字を区別します。詳細はコマンドリファレンス等でご確認の上入力してください。

■ キーワードは一意に識別できる範囲で省略可能です。たとえば、特権EXECモードにおいて、show running-configコマンドは次のように省略して入力することができます。

awplus# sho run ↓


また、configure terminalコマンドは次のようにして入力することができます。

awplus# con t ↓


Note - キーワードをどこまで省略できるかは、ファームウェアのバージョンや使用機種によって異なる可能性があります。また、コマンドモードによっても異なる場合がありますのでご注意ください。

■ コマンド行に必要な文字列を入力したら最後に「Enter」キーを押してください。これにより、コマンドが実行されます。なお、「Enter」キーを押すとき、必ずしもカーソルが行末になくてもかまいません。

■ コマンドの効果は、エラーがなければ通常入力直後にあらわれます。再起動などを行う必要はありません。ただし、設定内容は再起動すると消えてしまうので、再起動後にも同じ設定を使いたいときはcopyコマンドやwrite fileコマンド、write memoryコマンドでファイルに保存してください。詳細は「運用・管理」の「コンフィグレーション」をご覧ください。なお、一部のコマンドでは実行後に再起動が必要です。詳細はコマンドリファレンスで確認してください。

■ 現在の設定内容（ランニングコンフィグ）は、show running-configコマンドで確認できます。設定作業時には、こまめにshow running-configコマンドを実行し、設定内容が意図したとおり反映されているか確認しながら進めることをおすすめします。

コマンドの否定形（no形式）

 設定モードで実行するコマンドには「否定形」を持つものが多くあります。否定形は、コマンドの先頭に「no」というキーワードを付加した形式で、通常該当コマンドの効果を取り消すために使います。

たとえば、VLANを定義するvlanコマンドには、「肯定形」として、

(config-vlan)# vlan VLANID_LIST [name VLANNAME] [state {enabled|disabled}]


があり、「否定形」としては、

(config-vlan)# no vlan VLANID_LIST


があります。

同コマンドにおいて、否定形の構文は作成済みのVLANを削除するときに使います。

本マニュアルにおいては、肯定形を「通常形式」、否定形を「no形式」と呼びます。コマンドリファレンス編では、通常形式とno形式の両方を持つコマンドの場合、両方の構文を併記し、コマンドの説明部分では最初に通常形式の説明を行い、次にno形式の動作を説明します。

no形式には、おもに次のパターンがあります。


メッセージ

 コマンド入力後、実行結果や構文エラーを知らせるメッセージが表示されることがあります。次にいくつか例を示します。


なお、コマンドの実行に成功した場合は、通常何も表示されません。エラーメッセージが表示されなかった場合は、コマンドの実行に成功したと考えてください。

Note - 「コマンドの実行に成功」=「正しい設定」とはかぎりませんのでご注意ください。

コマンド入力補助機能

 コマンドラインインターフェース（CLI）には、コマンドの入力を補助する機能がいくつか備わっています。コマンド入力補助機能には次の種類があります。


これらの補助機能を利用するには、コマンドの入力途中で「?」か「TAB」キーを入力します。次にコマンド入力補助機能の使い方をまとめます。

表 5：コマンド入力補助機能の使い方
書式
使用方法
機能
入力候補の表示（次のキーワード）
? または <TAB> コマンドラインの先頭で「?」か「TAB」キーを入力 コマンドラインの先頭で入力可能なキーワードの一覧を表示する
keywords ? または keywords <TAB> 1つ以上のキーワード（keywords）を入力した後、スペースを入れ、その後で「?」か「TAB」キーを入力 カーソル位置に入力可能なキーワードの一覧を表示する
入力候補の表示（入力途中のキーワード）
partial-keyword? 何らかの文字列（partial-keyword）を入力した後、スペースを入れずに「?」を入力 カーソル位置に入力可能なキーワードのうち、partial-keywordで始まるものの一覧を表示する
キーワードの補完
partial-keyword<TAB> 何らかの文字列（partial-keyword）を入力した後、スペースを入れずに「TAB」キーを入力 カーソル位置に入力可能なキーワードのうち、partial-keywordで始まるものが1つだけであれば、partial-keywordを補完して完全なキーワードにする。partial-keywordで始まるキーワードが複数存在する場合は、候補の一覧を表示する
パラメーター値の説明
keyword=? または keyword=<TAB> 何らかの文字列（keyword）を入力した後、等号（=）を入れ、その後で「?」か「TAB」キーを入力 keywordをパラメーター名と見なし、同パラメーターに指定可能な値の説明を表示する


以下、それぞれの機能について、実例を挙げながら解説します。

入力候補の表示

 入力候補の表示機能は、現在のカーソル位置に入力可能なキーワード（コマンド名やパラメーター名、オプション名）の一覧を表示する機能です。コマンドの入力途中で「?」や「TAB」キーを入力することによって使用します。

Note - 「?」や「TAB」キーで表示されるキーワードの中には、サポート対象外のものも含まれます。原則として、本コマンドリファレンスに記載されていないコマンドやキーワード、機能はサポート対象外となります。詳細はリリースノートなどでご確認ください。

入力候補のキーワードは1行に1つずつ表示されます。また、コマンドラインの先頭キーワード（ADD、ENABLEなど）やモジュール名キーワード（SYSTEM、IPなど）の場合は、簡単な説明（英文）も表示されます。

次のキーワード候補を表示

 コマンドラインの先頭で「?」キーを押す、あるいは、いくつかのキーワードを入力した後にスペースを入れ、その後「?」か「TAB」キーを押すと、次に入力可能なキーワードの一覧が表示されます。

■ たとえば、グローバルコンフィグモードのコマンドラインの先頭で「?」キーを押すと次のように表示されます。

awplus(config)# ? （実際には表示されません）
Configure commands:
  aaa                Authentication, Authorization and Accounting
  access-list        Add an access list entry
  arp                Address Resolution Protocol (ARP)
  auth-web-server    web authentication server configuration commands
  banner             Define a login banner

 ...

  show               Show running system information
  snmp-server        Manage snmp server
  spanning-tree      Spanning tree commands
  ssh                Secure Shell
  stack              Manage VCS feature
  system             System properties
  telnet             Configure telnet
  trigger            Select a trigger to configure
  undebug            Disable debugging functions (see also 'debug')

awplus(config)#


画面の左側に列挙されているのが、コマンドラインの先頭キーワードとして有効な単語の一覧です。

画面の右側は、キーワードの簡単な説明（英文）です。

Note - 表示項目は対象製品やファームウェアのバージョンによって異なる可能性があります。また、現在どのコマンドモードにいるかによっても異なります。さらに、同じコマンドモードであっても、設定対象が何であるかによって表示項目すなわち使用できるコマンドが異なる場合があります。たとえば、同じインターフェースモードでも、vlan10を対象とした場合とport1.0.1を対象にした場合では使用できるコマンドが異なります。

Note - 「?」や「TAB」キーで表示されるキーワードの中には、サポート対象外のものも含まれます。原則として、本コマンドリファレンスに記載されていないコマンドやキーワード、機能はサポート対象外となります。詳細はリリースノートなどでご確認ください。

■ 次に、コマンドラインでさきほどの候補一覧から「show」を入力し、さらに半角スペースを一文字入力した上で再度「?」キーを押すと、次のように表示されます。

awplus(config)# show ? （実際には表示されません）
  banner          Display banner message
  crypto          Security Specific Commands
  log             Display logging information
  running-config  Current operating configuration
  ssh             Secure Shell

awplus(config)# show


■ さらに「log」を入力し、半角スペースを一文字入力した上で再度「?」か「TAB」キーを押すと、次のように表示されます。

awplus(config)# show log ? （実際には表示されません）
  config     Display the current logging configuration
  permanent  Display to contents of the permanent log
  tail       Display only the latest log entries
  |          Output modifiers
  >          Output redirection
  <cr>

awplus(config)# show log


なお、<cr>は、これ以上キーワードを入力せずに「Enter」キーを押してコマンドラインを完成させることもできる、という意味です。この例では、「show log」だけでも、コマンドラインとして完結していることを示しています。

また、コマンドラインで使用できる特殊記号の「|」と「>」については、「モディファイアとリダイレクション」の節で後述します。

入力途中のキーワード候補を表示

 コマンドラインに何らかの文字列を入力した後、スペースを入れずに「?」を入力すると、カーソル位置に入力可能なキーワードのうち、入力した文字列で始まるものの一覧が表示されます。

■ たとえば、グローバルコンフィグモードでコマンドラインに「route」と入力した後、スペースを入れずに「?」を入力すると、次のように表示されます。

awplus(config)# route? （実際には表示されません）
  route-map  Create route-map or enter route-map command mode
  router     Enable a routing process
  router-id  Router identifier for this system

awplus(config)# route


■ また、「router os」と入力した後で「?」を入力すると、次のように表示されます。

awplus(config)# router os? （実際には表示されません）
  ospf  Open Shortest Path First (OSPF)
  <cr>

awplus(config)# router os


■ 指定した文字列で始まるキーワード候補がないときは、次のようなメッセージ（Unrecognized command）が表示されます。この例は、「router」の後に「s」で始まるキーワードは指定できないことを示しています。

awplus(config)# router s? （実際には表示されません）
% Unrecognized command
awplus(config)# router s


キーワードの補完

 一つ前で説明した「入力途中のキーワード候補を表示」とよく似ていますが、コマンドラインに何らかの文字列を入力した後、スペースを入れずに「TAB」キーを入力すると、カーソル位置に入力可能なキーワードのうち、指定した文字列で始まるものが1つだけの場合、入力途中のキーワードを補完して完全なキーワードにしてくれます。指定した文字列で始まるキーワードが複数存在する場合は、「?」キーと同じく候補の一覧が表示されます。

■ たとえば、port1.0.1を対象とするインターフェースモードでコマンドラインに「swi」と入力した後、スペースを入れずに「TAB」キーを入力すると、次のように表示されます（実際にはタブ文字は表示されません）。

awplus(config)# interface port1.0.1
awplus(config-if)# swi<TAB> （実際には表示されません）


↓ 次のように補完される

awplus(config-if)# switchport


■ また、vlan10を対象とするインターフェースモードで「ip i」と入力した後で「TAB」キーを入力すると、「ip」の後に「i」で始まる候補は2つあるため、次のように表示されます。

awplus(config)# interface vlan10
awplus(config-if)# ip i<TAB> （実際には表示されません）
igmp  irdp
awplus(config-if)# ip i


■ ここで、もう一文字「g」を入力してから「TAB」キーを押すと、候補が1つになるため、次のように補完されます。

awplus(config-if)# ip ig<TAB> （実際には表示されません）


↓ 次のように補完される

awplus(config-if)# ip igmp


■ 指定した文字列で始まるキーワード候補がないときは、何も表示されず、コマンドラインも変更されません。この例は、「ip」の後に「g」で始まるキーワードは指定できないことを示しています。

awplus(config-if)# ip g<TAB> （実際には表示されません）
awplus(config-if)# ip g


モディファイアとリダイレクション

 通常、コマンドを実行すると、コマンドラインインターフェース（CLI）から何らかの文字列が返ってきます。特に情報を確認するためのコマンド（いわゆるshowコマンド）では、大量の情報が出力される場合があります。

このような場合に便利なのが、コマンドラインで使用できる2つの特殊記号、「|」（モディファイア）と「>」（リダイレクション）です。

■ モディファイアは、コマンドが出力した情報をいったん「フィルター」に通して、内容を加工した上で端末画面に表示させる機能を持ちます。フィルターには次の4種類があります。

Note - モディファイアを複数連結して使うことはできません。


■ リダイレクションは、コマンドの出力を端末画面には出力せず、指定したファイルに書き出す機能を持ちます。前述した「モディファイア」のredirectフィルターと同じ機能です。

Note - リダイレクションは非特権EXECモードでは使用できません（非特権EXECモードではファイルへの書き込み権限がないため）。

たとえば、リダイレクション（>）を使用して、show system environmentコマンドの出力をflash:/tmp/show_system_environment.txtというファイルに書き出すには、次のようにします。

awplus# show system environment > flash:/tmp/show_system_environment.txt ↓
awplus# dir recursive flash:/ ↓
flash:/
        0 drwx Nov 26 2007 01:41:30  tmp/
      312 -rw- Nov 26 2007 01:02:19  default.cfg
 12547591 -rw- Nov 26 2007 00:31:25  r1-5.2.1-0.2.rel

flash:/tmp
     1599 -rw- Nov 26 2007 01:41:30  show_system_environment.txt
     1060 -rw- Nov 26 2007 01:40:40  show_system.txt


端末画面のページ当たり行数

 初期設定では、端末画面の1ページ当たり行数は24に設定されています。コマンドの出力結果が24行よりも長い場合は、ページャー機能によって23行ごとに表示が一時停止し、最下行に次のようなメッセージが表示され、キー入力待ち状態になります。

--More--


ここでは次のキー操作が可能です。

表 6
Space 次の1ページを表示します。
Enter 次の1行を表示します。
q 表示を中止し、プロンプトに戻ります。


■ 現在の端末セッションにおけるページ当たり行数はEXECモード（非特権および特権）のterminal lengthコマンドで変更できます。

awplus> terminal length 60 ↓


■ 現在の端末セッションにおいて、ページ単位の一時停止を無効にするには、terminal lengthコマンドに0を指定します。

awplus> terminal length 0 ↓


■ 前記のterminal lengthコマンドは実行コマンドなので、現在の端末セッションにしか影響を与えず、設定を保存しておくこともできません。ページ当たり行数の設定を永続的に変更したい場合は、ラインモードのlengthコマンドを使います。たとえば、コンソールターミナルからのログイン時、ページ当たり行数がつねに60行になるようにするには、次のようにします。

awplus(config)# line console 0 ↓
awplus(config-line)# length 60 ↓


■ 仮想端末からのログインセッション（Telnet/SSHセッション）のページ当たり行数は次のようにして変更します。

awplus(config)# line vty 0 32 ↓
awplus(config-line)# length 60 ↓


■ コンソールターミナル、仮想端末といった端末種別に関係なく、すべてのログインセッションに対してページ当たり行数を設定することもできます。これには、グローバルコンフィグモードのservice terminal-lengthコマンドを使います。この設定は、ラインモードのlengthコマンドよりも優先されます。

awplus(config)# service terminal-length 30 ↓


■ 端末に関する設定の詳細については、「運用・管理」の「端末設定」をご覧ください。

(C) 2007 - 2009 アライドテレシスホールディングス株式会社

PN: 613-000751 Rev.J