導入背景:なぜESXi管理にesxcliが必要なのか
日常的な運用管理にはWeb UIやvCenterが非常に便利です。しかし、いざ重大な障害が発生すると、GUIはほぼ役に立たなくなります。NICのリンクダウンによるWeb UIの無応答、.vmxファイルのロックによるVMの停止不可、あるいはvCenterとESXiホスト間の通信断などが発生した際、ホストへのSSH直接接続が唯一の頼みの綱となります。
筆者は自宅環境では迅速な検証用に12台のVMを動かすProxmox VEホームラボを構築していますが、職場の本番インフラではDell PowerEdgeの8ノードクラスタ上でVMware ESXi 7.0が稼働し、250台以上の業務VMを運用しています。深夜2時の緊急障害対応時、esxcliコマンドによってチーム全体が深刻なダウンタイム危機から何度も救われてきました。
VMwareのesxcliは、個別のLinuxコマンド群とは異なり、esxcli <namespace> <object> <action>という厳格な名前空間(namespace)構造で設計されています。この構文さえ押さえておけば、vCenterに依存することなく、ハードウェア、ストレージ、仮想ネットワークへ直接アプローチできます。
環境準備:esxcli実行環境の有効化
セキュリティ上の理由から、ESXiではデフォルトでSSHが無効化されています。ターミナルを利用するには、DCUI(Direct Console User Interface)またはWeb ClientからSSHを有効化する必要があります。
DCUI画面から直接SSHを有効化する手順
Web Clientへアクセスできなくなった場合は、物理サーバーに直接キーボードとディスプレイを接続するか、iLO(HP)/ iDRAC(Dell)のリモートコンソールを開きます。
- F2キーを押し、ESXiのrootパスワードを入力します。
- Troubleshooting Optionsへ移動します。
- Enable SSHを選択してEnterキーを押します。
アクセス方法とesxcliの基本構文
root権限でSSHログインに成功したら、まずは以下のコマンドを実行してみましょう。
esxcli --help
実務で最も頻繁に利用する4つの名前空間(namespace)は以下のとおりです:
hardware: CPU、RAM、マザーボード情報、PCIバスの状態確認。network: vSwitch、ポートグループ、VMkernel IP、物理NICの設定変更。storage: VMFSボリューム、iSCSI/FC LUN、ローカルディスクの確認。vm: 応答不能になった仮想マシンプロセスの追跡と強制停止。
詳細設定:VMkernelネットワーク、ハードウェア、VMのレスキュー
1. ハードウェアおよび物理NIC(vmnic)の管理
10GbEカードが1Gbpsでリンクアップしてしまったり、スイッチとのデュプレックス不整合によってネットワークが不安定になったりすることがあります。network nicコマンドグループを使用すれば迅速に切り分けが可能です。
# すべての物理ネットワークカード(vmnic)と現在のリンク速度を一覧表示
esxcli network nic list
# vmnic0のモデル、ドライバ、ファームウェアの詳細情報を確認
esxcli network nic get -n vmnic0
# スイッチとのネゴシエーション失敗時に10Gbps Full Duplexへ強制固定
esxcli network nic set -n vmnic0 --speed 10000 --duplex full --auto false
メーカー保守サポートへサービスタグを伝える必要がある場合や、PSU(電源ユニット)ファンの状態を確認する場合:
# 物理サーバーのシリアル番号/サービスタグおよびモデル名を取得
esxcli hardware platform get
# IPMI経由で温度センサーや電源ステータスを取得
esxcli hardware ipmi sensor list
2. VMkernelポート(vmk)の作成と設定
VMkernelポートは、管理通信、vMotion、iSCSI/NFS接続など、すべての重要トラフィックを担っています。誤操作で管理IPを削除してしまったり、既存セグメントが孤立した場合は、vSwitch0上に緊急用のレスキューポートグループを作成できます。
# vSwitch0上にRescue-Mgmtという新しいポートグループを作成
esxcli network vswitch standard portgroup add --portgroup-name="Rescue-Mgmt" --vswitch-name="vSwitch0"
# 作成したポートグループにVLAN 10を割り当て
esxcli network vswitch standard portgroup set --portgroup-name="Rescue-Mgmt" --vlan-id=10
# このポートグループに紐づくVMkernelインターフェースvmk1を作成
esxcli network ip interface add --interface-name=vmk1 --portgroup-name="Rescue-Mgmt"
# 再アクセス用にvmk1へ静的IP 192.168.10.50/24を設定
esxcli network ip interface ipv4 set --interface-name=vmk1 --ipv4=192.168.10.50 --netmask=255.255.255.0 --type=static
3. フリーズした仮想マシンの強制終了(Kill Unresponsive VM)
最も典型的なトラブルは、2TB規模のデータベースVMがストレージI/Oエラーに見舞われ、ゲストOSが完全にハングアップするケースです。vCenterからシャットダウンを試みても、15分後にタイムアウトエラーが返ってくるだけです。物理ホスト全体を再起動して他の多くのVMを巻き添えにするのではなく、対象VMのプロセスのみを強制終了します。
# ステップ1:稼働中のVM一覧を取得しWorld IDを確認
esxcli vm process list
# ステップ2:問題のVMを特定し、World ID(例: 1245678)を控える
# OSがまだ応答可能であれば正常にファイルをクローズできるよう、まずはソフトキルを試行
esxcli vm process kill --type=soft --world-id=1245678
# ステップ3:20〜30秒経過しても停止しない場合、ハードキルを実行
esxcli vm process kill --type=hard --world-id=1245678
# ステップ4:プロセスがカーネル層でスタックしている場合の最終手段(強制停止)
esxcli vm process kill --type=force --world-id=1245678
forceオプションを使用すると、.vmxファイルおよび-flat.vmdkファイルのロックが即座に解放されます。これにより、物理ホストをリブートすることなく、その場で仮想マシンを再起動できます。
コマンドラインからのシステム検証とモニタリング
復旧作業が完了しても、すぐにターミナルを閉じず、ネットワーク経路と通信状態を必ず再確認しましょう。
ルーティングテーブルとVMkernel通信の検証
通常のpingコマンドはデフォルトのルーティングテーブルに従います。vMotionやNFSストレージ用の特定VMkernelインターフェースの疎通を正確に検証するには、vmkpingコマンドで-Iオプションを指定します。
# vmk1インターフェース経由でゲートウェイにping送信
vmkping -I vmk1 192.168.10.1
# SANストレージに向けて断片化禁止(-d)でジャンボフレーム(MTU 9000)をテスト(ペイロード8972バイト+ヘッダー28バイト)
vmkping -I vmk1 -d -s 8972 192.168.10.100
# ESXiホストの現在のIPv4ルーティングテーブルを表示
esxcli network ip route ipv4 list
リアルタイムなI/Oおよびパフォーマンス監視
特定のVMがストレージI/Oを圧迫していたり、CPU使用率を異常に占有している疑いがある場合、esxtopが最も直感的な監視ツールとなります。
# リアルタイムパフォーマンス監視ダッシュボードを起動
esxtop
esxtop画面でdを押すとディスクレイテンシ、nでネットワークトラフィック、mでメモリ使用状況のビューに切り替わります。特に注目すべきはDAVG/cmd(デバイス層のレイテンシ)とKAVG/cmd(ESXiカーネル層のレイテンシ)の2つの指標です。いずれかの数値が継続して20msを超えている場合、ストレージシステムにボトルネックが発生していると判断できます。
これらの基本的なesxcliコマンドをマスターしておけば、vCenterが完全にダウンした状況でもESXiホストを確実にコントロールできます。深夜に苦渋の決断でクラスタ全体を再起動する代わりに、SSH経由で数分間コマンドを実行するだけでシステムを迅速に蘇らせることが可能になります。

