統合管理モジュール ユーザ ガイド
偏向のない言語
この製品のマニュアルセットは、偏向のない言語を使用するように配慮されています。このマニュアルセットでの偏向のない言語とは、年齢、障害、性別、人種的アイデンティティ、民族的アイデンティティ、性的指向、社会経済的地位、およびインターセクショナリティに基づく差別を意味しない言語として定義されています。製品ソフトウェアのユーザーインターフェイスにハードコードされている言語、RFP のドキュメントに基づいて使用されている言語、または参照されているサードパーティ製品で使用されている言語によりドキュメントに例外が存在する場合があります。シスコのインクルーシブランゲージに対する取り組みの詳細は、こちらをご覧ください。
翻訳について
このドキュメントは、米国シスコ発行ドキュメントの参考和訳です。リンク情報につきましては、日本語版掲載時点で、英語版にアップデートがあり、リンク先のページが移動/変更されている場合がありますことをご了承ください。あくまでも参考和訳となりますので、正式な内容については米国サイトのドキュメントを参照ください。
- Updated:
- 2017年6月13日
章のタイトル： コマンドライン インターフェイス
コマンドライン インターフェイス
Web インターフェイスを使用せずに IMM にアクセスするには、IMM コマンドライン インターフェイス（CLI）を使用します。Web インターフェイスで提供される管理機能の一部を使用できます。
CLI には、Telnet または SSH セッションを使用してアクセスできます。CLI コマンドを実行するには、事前に IMM によって認証されている必要があります。
IPMI を使用した IMM の管理
出荷時の IMM には、ユーザ ID 2 に対して USERID というユーザ名と PASSW0RD（文字 O ではなくゼロを使用）というパスワードが初期設定されています。このユーザには、スーパーバイザ アクセス権が与えられています。
重要：セキュリティを強化するために、初期設定時にこのデフォルトのパスワードを変更してください。
IMM は、次の IPMI リモート サーバ管理機能も提供します。
コマンドライン インターフェイス
コマンドライン インターフェイスでは、IPMI 2.0 プロトコルを使用してサーバ管理機能に直接アクセスできます。IPMItool を使用してコマンドを実行することにより、サーバの電源を制御したり、サーバ情報を表示したり、サーバを識別したりすることができます。
コマンド ラインへのアクセス
コマンド ラインにアクセスするには、IMM の IP アドレスに対して Telnet または SSH セッションを開始します。
コマンドライン セッションへのログイン
ステップ 2
ユーザ名のプロンプトで、ユーザ ID を入力します。
ステップ 3 パスワードのプロンプトで、IMM へのログインに使用するパスワードを入力します。
コマンド ラインにログインしました。コマンドライン プロンプトは、system> になります。コマンドライン セッションは、コマンド ラインで exit を入力するまで持続します。入力すると、ログオフし、セッションが終了します。
コマンド構文
コマンドを使用する前に、次のガイドラインを確認してください。
• すべての引数をコマンドのすぐ後に指定する必要があります。オプションは、引数のすぐ後に指定します。
• 各オプションの先頭には常にハイフン（-）が付きます。オプションには、短いオプション（1 文字）または長いオプション（複数文字）を使用できます。
• オプションに引数がある場合、その引数は必須になります。たとえば、次のようになります。
ここで、ifconfig はコマンド、eth0 は引数です。-i、-g、および -s はオプションです。この例では、3 つすべてのオプションに引数があります。
• 角カッコは、その中の引数またはオプションが省略可能であることを示します。角カッコは、コマンドの入力時には含めません。
機能および制限事項
• さまざまなアクセス方式（Telnet または SSH）で同時に複数の CLI セッションを使用できます。最大で 2 つの Telnet コマンドライン セッションをいつでもアクティブにできます。
（注） Telnet セッションの数は設定可能です。有効な値は、0、1、および 2 です。値を 0 にすると、Telnet インターフェイスはディセーブルになります。
• 行ごとに 1 つのコマンドを入力できます（160 文字まで、スペースも含む）。
• 長いコマンド用の継続文字はありません。編集機能は、直前の入力した文字を消去する Back Space キーのみです。
• ↑キーと↓キーを使用して、直前の 8 つのコマンドを参照できます。history コマンドを使用すると、直前の 8 つのコマンドのリストが表示されます。次の例のように、これらをショートカットとして使用し、コマンドを実行できます。
• コマンドライン インターフェイスでは、出力バッファが 2 KB に制限されます。バッファリングは行われません。コマンドごとに 2048 文字までしか出力できません。この制限は、シリアル リダイレクト モードでは適用されません（シリアル リダイレクト中はデータがバッファリングされます）。
• コマンドの出力は、コマンドの実行が完了した後に画面に表示されます。そのため、コマンドは、リアルタイムで実行ステータスを報告することができません。たとえば、flashing コマンドの詳細モードの場合、フラッシングの進捗状況がリアルタイムで表示されません。コマンドの実行が完了した後に表示されます。
• 次の例のように、単純なテキスト メッセージを使用して、コマンドの実行ステータスが示されます。
• オプションとその引数の間には、1 つ以上のスペースが必要です。たとえば、 ifconfig eth0 -i192.168.70.133 は、間違った構文です。正しい構文は、 ifconfig eth0 -i 192.168.70.133 になります。
• すべてのコマンドには、 -h、-help 、および ? オプションがあります。これらは構文ヘルプを表示します。次の例は、すべて同じ結果になります。
• 以降の項で説明されているコマンドのいくつかは、使用できないことがあります。サポートされているコマンドのリストを表示するには、次の例のように、help または ? オプションを使用します。
ユーティリティ コマンド
exit コマンド
説明
help コマンド
説明
すべてのコマンドのリストとそれぞれの簡単な説明を表示するには、help コマンドを使用します。コマンド プロンプトで ? を入力することもできます。
history コマンド
説明
最後に実行した 8 つのコマンドをインデックス付きの履歴リストで表示するには、history コマンドを使用します。インデックスは、この履歴リストからコマンドを再実行するためのショートカットとして使用できます（先頭に ! を付けます）。
例
モニタ コマンド
clearlog コマンド
説明
IMM のイベント ログまたは IMM をクリアするには、clearlog コマンドを使用します。このコマンドを使用するには、イベント ログをクリアする権限が必要です。
fans コマンド
説明
例
readlog コマンド
構文
説明
IMM イベント ログ エントリを一度に 5 つずつ表示するには、readlog コマンドを使用します。エントリは、新しいものから順に表示されます。
• readlog は、初めて実行されたとき、イベント ログ内の新しいエントリから順に最初の 5 つを表示します。それ以降は、呼び出されるたびに次の 5 つのエントリが表示されます。
• readlog -f を実行すると、カウンタがリセットされ、イベント ログ内の新しいエントリから順に最初の 5 つが表示されます。
例
syshealth コマンド
説明
サーバのヘルスの要約を表示するには、syshealth コマンドを使用します。電源の状態、システムの状態、再起動の回数、および IMM ソフトウェアのステータスが表示されます。
例
temps コマンド
説明
温度および温度しきい値をすべて表示するには、temps コマンドを使用します。Web インターフェイスの場合と同じ温度セットが表示されます。
例
volts コマンド
説明
電圧および電圧しきい値をすべて表示するには、volts コマンドを使用します。Web インターフェイスの場合と同じ電圧セットが表示されます。
例
vpd コマンド
構文
説明
システム（sys）、IMM、サーバ ファームウェア（bios）、および Dynamic System Analysis Preboot（dsa）の重要な製品データを表示するには、 vpd コマンドを使用します。Web インターフェイスの場合と同じ情報が表示されます。
例
サーバの電源および再起動の制御コマンド
power コマンド
構文
説明
サーバの電源を制御するには、power コマンドを使用します。power コマンドを実行するには、電源と再起動のアクセス権限が必要です。
• power off は、サーバの電源をオフにします。-s オプションを指定すると、オペレーティング システムをシャットダウンしてからサーバの電源がオフになります。
• power state は、サーバの電源の状態（オンまたはオフ）とサーバの現在の状態を表示します。
• power cycle は、サーバの電源をオフにしてから、電源を再びオンにします。-s オプションを指定すると、オペレーティング システムをシャットダウンしてからサーバの電源がオフになります。
reset コマンド
構文
説明
サーバを再起動するには、reset コマンドを使用します。このコマンドを使用するには、電源と再起動のアクセス権限が必要です。-s オプションを指定すると、オペレーティング システムをシャットダウンしてからサーバが再起動されます。
コンフィギュレーション コマンド
dhcpinfo コマンド
構文
説明
インターフェイスが DHCP サーバによって自動的に設定される場合、DHCP サーバが eth0 に割り当てた IP 設定を表示するには、dhcpinfo コマンドを使用します。DHCP は、ifconfig コマンドを使用してイネーブルまたはディセーブルにできます。
例
|
|
|
|---|---|
ifconfig コマンド
構文
説明
イーサネット インターフェイスを設定するには、ifconfig コマンドを使用します。現在のイーサネット インターフェイス設定を表示するには、 ifconfig eth0 と入力します。イーサネット インターフェイス設定を変更するには、オプションを入力し、その後に値を指定します。インターフェイス設定を変更するには、最低でもアダプタのネットワーキングとセキュリティの設定権限が必要です。
|
|
|
|
|---|---|---|
dhcp、static、dthens（dthens は、Web インターフェイスでの [try dhcp server, if it fails use static config] オプションに対応します） |
||
例
（注） ifconfig の -b オプションの表示は、Burned-In MAC Address に関するものです。Burned-In MAC Address は読み取り専用であり、設定することはできません。
ldap コマンド
構文
説明
LDAP プロトコル設定パラメータを表示および設定するには、ldap コマンドを使用します。
ntp コマンド
構文
説明
ネットワーク タイム プロトコル（NTP）を表示および設定するには、ntp コマンドを使用します。
|
|
|
|
|---|---|---|
例
passwordcfg コマンド
構文
説明
パスワード パラメータを表示および設定するには、passwordcfg コマンドを使用します。
|
|
|
|---|---|
例
portcfg コマンド
構文
説明
シリアル ポートを設定するには、portcfg コマンドを使用します。シリアル ポート設定を変更するには、オプションを入力し、その後に値を指定します。シリアル ポート設定を変更するには、最低でもアダプタのネットワーキングとセキュリティの設定権限が必要です。
次のパラメータは、ハードウェアで設定されているため、変更することはできません。
|
|
|
|
|---|---|---|
| • |
例
srcfg コマンド
構文
説明
シリアル リダイレクションを設定するには、srcfg コマンドを使用します。現在の設定を表示するには、 srcfg と入力します。シリアル リダイレクト設定を変更するには、オプションを入力し、その後に値を指定します。シリアル リダイレクト設定を変更するには、最低でもアダプタのネットワーキングとセキュリティの設定権限が必要です。
次の表に、 -exitcliseq オプションの引数を示します。
|
|
|
|
|---|---|---|
CLI を終了するためのユーザ定義のキーストローク シーケンス。詳細については、この表内の -entercliseq オプションの値を参照してください。 |
例
ssl コマンド
構文
説明
（注） SSL クライアントをイネーブルにするには、事前にクライアント証明書をインストールしておく必要があります。
Secure Sockets Layer（SSL）パラメータを表示および設定するには、ssl コマンドを使用します。
|
|
|
|---|---|
パラメータ
次のパラメータは、ssl コマンドのオプション ステータス表示で示され、コマンドライン インターフェイスからのみ出力されます。
サーバ セキュア トランスポート イネーブル
サーバ Web/CMD キー ステータス
このステータス表示は、読み取り専用であり、直接設定することはできません。コマンド ラインから出力される可能性のある値は次のとおりです。
SSL サーバ CSR キー ステータス
このステータス表示は、読み取り専用であり、直接設定することはできません。コマンド ラインから出力される可能性のある値は次のとおりです。
SSL クライアント LDAP キー ステータス
このステータス表示は、読み取り専用であり、直接設定することはできません。コマンド ラインから出力される可能性のある値は次のとおりです。
SSL クライアント CSR キー ステータス
このステータス表示は、読み取り専用であり、直接設定することはできません。コマンド ラインから出力される可能性のある値は次のとおりです。
timeouts コマンド
構文
説明
タイムアウト値を表示または変更するには、timeouts コマンドを使用します。タイムアウトを表示するには、timeouts と入力します。タイムアウト値を変更するには、オプションを入力し、その後に値を指定します。タイムアウト値を変更するには、最低でもアダプタ設定の権限が必要です。
次の表に、タイムアウト値の引数を示します。これらの値は、Web インターフェイスでのサーバ タイムアウト用の段階的なスケールのプルダウン オプションと一致します。
|
|
|
|
|
|---|---|---|---|
disabled、0.5、1、1.5、2、2.5、3、3.5、4、4.5、5、7.5、10、15、20、30、60、120 |
例
usbeth コマンド
構文
説明
インバンドの LAN over USB インターフェイスをイネーブルまたはディセーブルにするには、usbeth コマンドを使用します。このインターフェイスをイネーブルまたはディセーブルにする方法の詳細については、「USB インバンド インターフェイスのディセーブル化」を参照してください。
例
users コマンド
構文
説明
すべてのユーザ アカウントとそれらの権限レベルにアクセスしたり、新規のユーザ アカウントを作成したり、既存のアカウントを変更したりするには、users コマンドを使用します。
users コマンドに関する次のガイドラインを確認してください。
• ユーザ番号は 1 ～ 12 の範囲内にする必要があります。
• ユーザ名は、長さを 16 文字未満にする必要があり、数字、英字、ピリオド、およびアンダースコアのみを含めることができます。
• パスワードは、6 ～ 15 文字の長さにし、少なくとも英字と英字以外の文字を 1 つずつ含める必要があります。
例
IMM 制御コマンド
clearcfg コマンド
説明
IMM 設定を出荷時の初期状態に設定するには、clearcfg コマンドを使用します。このコマンドを実行するには、最低でも詳細なアダプタ設定の権限が必要です。IMM の設定がクリアされた後、IMM は再起動されます。
clock コマンド
構文
説明
IMM クロックと GMT オフセットに従って現在の日時を表示するには、clock コマンドを使用します。日付、時刻、GMT オフセット、および夏時間を設定できます。
• +2 または +10 の GMT オフセットの場合、専用の夏時間設定が必要です。
• +2 の場合、夏時間オプションは次のとおりです。off、ee（東ヨーロッパ）、gtb（英国）、egt（エジプト）、fle（フィンランド）。
• +10 の場合、夏時間設定は次のとおりです。off、ea（東部オーストラリア）、tas（タスマニア）、vlad（ウラジオストク）。
• 年は 2000 ～ 2089 の範囲内にする必要があります。
• 月、日、時、分、および秒は、1 桁の値にすることもできます（たとえば、09:50:25 の代わりに 9:50:25）。
• GMT オフセットは、正のオフセットの場合は +2:00、+2、または 2、負のオフセットの場合は -5:00 または -5 の形式で指定できます。
例
identify コマンド
構文
説明
シャーシ識別 LED を点灯または消灯したり、点滅させたりするには、identify コマンドを使用します。-d オプションを -s on と組み合わせて使用することで、-d パラメータで指定した秒数だけ LED を点灯させることができます。指定された秒数が経過すると、LED は消灯します。
例
resetsp コマンド
説明
IMM を再起動するには、resetsp コマンドを使用します。このコマンドを実行するには、最低でも詳細なアダプタ設定の権限が必要です。
フィードバック