Infrastructure Engineer's Cheatsheet
VMware / NSX コマンドチートシート
vSphere 7.x/8.x・NSX-T 3.x・NSX 4.x に対応。ESXiホスト操作からNSX Manager CLI・ トラブルシューティングまで、現場で即使えるコマンドをカテゴリ別に網羅しています。
ESXi vCenter NSX-T NSX 4.x Edge Node トラブルシューティング
目次
01
ESXi ホスト操作(SSH / DCUI)
ネットワーク確認
# NICの一覧と状態確認
esxcfg-nics -l
# 仮想スイッチ(vSwitch)の一覧
esxcfg-vswitch -l
# VMkernel NICの確認(管理・vMotion・vSAN等)
esxcfg-vmknic -l
# ルーティングテーブル確認
esxcfg-route -l
# ESXiホストのIPアドレス確認
esxcli network ip interface ipv4 get
# DNS設定確認
esxcli network ip dns server list
esxcli network ip dns search list 仮想マシン操作
# 稼働中のVMを一覧表示(World IDと名前)
esxcli vm process list
# VMの強制停止(最終手段)
esxcli vm process kill --type=hard --world-id=<WorldID>
# 登録済みVM一覧(VMID付き)
vim-cmd vmsvc/getallvms
# VMの電源状態確認
vim-cmd vmsvc/power.getstate <VMID>
# VMの電源ON / OFF / リセット
vim-cmd vmsvc/power.on <VMID>
vim-cmd vmsvc/power.off <VMID>
vim-cmd vmsvc/power.reset <VMID> ストレージ確認
# データストアの空き容量確認
df -h
# ストレージアダプタ一覧(HBA等)
esxcli storage adapter list
# 接続中のストレージデバイス一覧
esxcli storage core device list
# NFSマウント一覧
esxcli storage nfs list システム・サービス
# ESXiバージョン確認
esxcli system version get
# メンテナンスモード確認
esxcli system maintenanceMode get
# メンテナンスモード 有効化 / 無効化
esxcli system maintenanceMode set --enable true
esxcli system maintenanceMode set --enable false
# ESXiホスト再起動(メンテナンスモード後)
reboot 02
vCenter Server
Appliance Shell(SSH)
# サービス状態確認
service-control --status
# 特定サービスの再起動
service-control --restart <service-name>
# vCenterバージョン確認
vpxd -v
# DBステータス確認(PostgreSQL)
/usr/lib/vmware-vpostgres/current/bin/psql -U postgres -c "SELECT version();" Web UIでよく使う操作
| 操作 | パス |
|---|---|
| ホスト追加 | データセンター右クリック → ホストの追加 |
| クラスタ作成 | データセンター右クリック → クラスタの新規作成 |
| vMotion実行 | VM右クリック → 移行 |
| スナップショット作成 | VM右クリック → スナップショット → スナップショットの作成 |
| イベントログ確認 | vCenter右クリック → イベント |
| ライセンス確認 | 管理 → ライセンス |
03
NSX Manager CLI(SSH接続後)
基本確認(最初に実行)
# クラスタの健全性確認
get cluster status
# コントロールプレーンの状態確認
get controllers
# NSX Managerのバージョン確認
get version
# サービスの動作確認
get service
# Transport Nodeの一覧
get transport-nodes
# NSX ManagerのIP確認
get managers 論理スイッチ(Logical Switching)
# 論理スイッチの一覧
get logical-switches
# 特定の論理スイッチの詳細
get logical-switch <switch-id>
# Logical Portの一覧
get logical-ports 論理ルーター(Tier-0 / Tier-1 Gateway)
# Tier-0/Tier-1 ゲートウェイの一覧
get logical-routers
# BGPピアのステータス確認
get bgp neighbor summary
# NATルールの確認
get nat rules Transport Node 確認
# Transport Nodeの接続状態確認
get transport-nodes status
# TEP(トンネルエンドポイント)のトンネル状態
get tunnel
# BFDセッション状態確認
get bfd-sessions 04
NSX Edge Node(SSH接続後)
# ルーティングテーブル確認
get route
# インタフェース確認
get interfaces
# Tier-0 BGP ステータス
get bgp neighbor
# Tier-0 BGP サマリ
get bgp neighbor summary
# ARPテーブル確認
get arp
# NATルールの確認
get nat rules 05
NSX API(curl)
# NSX Managerへの認証付きAPIコール(基本形)
curl -k -u "admin:Password123!" \
-H "Content-Type: application/json" \
https://<NSX_MANAGER_IP>/api/v1/logical-switches
# Transport Node一覧をAPI経由で取得
curl -k -u "admin:Password123!" \
https://<NSX_MANAGER_IP>/api/v1/transport-nodes
# アラーム一覧の取得
curl -k -u "admin:Password123!" \
https://<NSX_MANAGER_IP>/api/v1/alarms
# Tier-0 Gateway一覧(NSX 4.x Policy API)
curl -k -u "admin:Password123!" \
https://<NSX_MANAGER_IP>/policy/api/v1/infra/tier-0s 06
トラブルシューティング
VMが起動しない・応答しない
# ESXiホストでVMのロックファイル確認
ls -la /vmfs/volumes/<DATASTORE>/<VM_NAME>/
# VMの電源状態確認(強制停止前に必ず確認)
vim-cmd vmsvc/power.getstate <VMID>
# .lckファイルが残存していた場合(VMが完全停止確認後)
# → ファイルを削除して再登録 vMotion が失敗する
| 確認ポイント | コマンド / 操作 |
|---|---|
| vMotionネットワーク疎通 | vmkping -I vmk1 <対向ESXiのvMotion IP> |
| vMotion VMkernel有効化 | ネットワーク → VMkernel NIC → vMotionにチェック |
| DRS / HA設定 | クラスタ設定 → 可用性を確認 |
| ライセンス | 管理 → ライセンス → vMotion有効化を確認 |
NSX 通信トラブル
# TEP(トンネルエンドポイント)のpingテスト(ESXiから)
vmkping -I vmk10 <対向ESXiのTEP IP> -d -s 1400
# ポートグループの状態確認(ESXiから)
esxcli network vswitch dvs vmware list
# ESXiからの外部疎通確認
vmkping -I vmk0 8.8.8.8
# MTUチェック(ジャンボフレーム確認)
vmkping -I vmk10 <IP> -d -s 8972
# NSX ManagerでのTraceflow確認
# → Troubleshooting → Traceflow → 送信元/送信先を指定して実行 07
略語・用語メモ
| 略語 | 正式名称 | 概要 |
|---|---|---|
| VDS | vSphere Distributed Switch | 複数ESXiをまたぐ仮想スイッチ |
| VMkernel | VMkernel NIC | ESXiのシステム用仮想NIC(管理・vMotion・vSAN等) |
| TEP | Tunnel Endpoint | NSXオーバーレイネットワークのトンネル終端点 |
| T0 | Tier-0 Gateway | NSXの北向きルーター(外部BGP接続担当) |
| T1 | Tier-1 Gateway | NSXの南向きルーター(ワークロード接続担当) |
| LS | Logical Switch | NSXの論理スイッチ(L2セグメント) |
| BFD | Bidirectional Forwarding Detection | リンク障害の高速検出プロトコル |
| DRS | Distributed Resource Scheduler | VMの自動負荷分散機能 |
| HA | High Availability | ESXiホスト障害時のVM自動再起動機能 |
| vSAN | VMware Storage Area Network | ESXiのローカルディスクを束ねた仮想ストレージ |
08
学習ロードマップ(VMware / NSX)
Phase 1 基礎固め
- ✓ESXiインストール・基本設定
- ✓vCenter デプロイ
- ✓仮想マシンの作成・操作
- ✓vMotion・HA・DRSの設定
Phase 2 NSX入門
- →NSX Manager デプロイ
- →Transport Node(ESXi)設定
- →Tier-0 / Tier-1 Gateway構築
- →論理スイッチ・論理ポート作成
Phase 3 応用・自動化
- ◦BGPピアリング設定
- ◦分散ファイアウォール(DFW)
- ◦NSX ALB(AVI)連携
- ◦Terraform / Ansible自動化