LISTE

DES COMMANDES UTILES POUR

ESXI

Table des matires

1-

Introduction..............................................................................................................2

2-

Oprations sur les machines virtuelles.....................................................................5

3-

Oprations sur les disques virtuels...........................................................................7

4-

Oprations sur l'hte ESXi........................................................................................8

5-

Oprations sur les Services....................................................................................10

6-

Oprations sur la configuration rseau...................................................................11

7-

Les fichiers de logs en ESXi....................................................................................14

8-

Annexes.................................................................................................................16

Annexes

Page 1

1-Introduction
Avec vSphere 5, les commandes de management en ligne de commande
ont quelque-peu chang. En effet, la commande "esxcli" existait dj en
vSphere 4 mais la syntaxe des commandes a chang et il y a plus de
commandes disponibles. Par habitude, on utilisait le plus souvent les
anciennes commandes, en vSphere 5, "esxcli" est l'outil de commande
principal.

Les commandes en "esxcfg-*" sont encore disponibles en vSphere 5 mais

la plupart sont obsoltes et disparatront dans les futures versions. De
mme, les commandes en "vicfg-*" utilisable distance avec le package
vCLI, ne sont pas encore obsolte mais le deviendront galement avec le
temps. Il faut donc dj prendre le pli de les remplacer par "esxcli".
Cependant, les commandes suivantes n'ont pas dquivalent en "esxcli":

vicfg-authconfig

vicfg-cfgbackup

vicfg-hostops

vicfg-ipsec

vicfg-ntp

vicfg-route

vicfg-snmp

vicfg-user

La commande "esxcli" est disponible dans le shell ESXi. Elle est aussi
disponible dans le package vCLI (et donc dans vMA) et en PowerCLI avec
la cmdlet "Get-EsxCli".

Page 2

"esxcli" s'appuie sur le service "hostd", quand il est indisponible, on

remplacera la commande par "localcli" pour bypasser le service "hostd".
Cependant, il ne faut utiliser "localcli" qu'en cas de problme du service
"hostd" sinon on peut avoir des problmes de consistance de la
configuration de l'hte.
La nouvelle syntaxe d'utilisation en vSphere 5 est la suivante:
esxcli [dispatcher_options] {namespace} [{namespace}] {cmd} [cmd
options]

Dans les "dispatcher_options", il est intressant de noter qu'il est possible

de formater le rsultat en sorti avec l'option "--formatter", exemple:
# esxcli--formatter=csv --format-param=fields=Name,Mac
Address,Enabled network ip interface list
Name,MACAddress,Enabled
vmk0,00:1a:64:d0:bf:00,true,
vmk1,00:50:56:71:38:bc,true,

Il existe 10 namespaces principaux pour un ensemble de 251 commandes.

Voici le premier niveau de namespaces:

Namespace
esxcli
fcoe
hardware
iscsi
network

software
storage
system
vm

Description
Commandes fonctionnant sur le systme esxcli luimme, permettant aux utilisateurs d'obtenir des
informations supplmentaires
Commandes FCoE
Proprits matrielles et commandes pour la
configuration matrielle
Commandes iSCSI
Oprations permettant la maintenance des rseaux sur
un hte ESXi. Incluant diverses commandes pour
manipuler les composants rseau virtuel (vSwitch,
portgroup, dVS, etc) ainsi que l'IP local, DNS et les
paramtres gnraux de rseau hte.
Gestion de l'image et des packages ESXi
Commandes Stockage
Les proprits systme et les commandes de
configuration des proprits du VMKernel
Oprations permettant un utilisateur de contrler les
Page 3

machines virtuelles
La commande "esxcli esxcli command list" permet d'avoir la liste
complte des commandes. Rajouter la commande "--help" pour avoir le
dtail.
Voici la liste de correspondance entre les anciennes commandes en
ESX4.x et les commandes en ESXi5.0 avec "esxcli":
Ancienne commande en Service
Console
esxcfg-advcfg
esxcfg-dumppart
esxcfg-info
esxcfg-firewall
esxcfg-swiscsi
esxcfg-hwiscsi
esxcfg-module
esxcfg-mpath
esxcfg-nas
esxcfg-nics
esxcfg-rescan
esxcfg-scsidevs
esxcfg-vmknic
esxcfg-volume
esxcfg-vswitch
esxcli
esxcli
esxcli
esxcli

corestorage
network
swiscsi
vms vm

esxupdate
vmkfstools
vmware-cmd

Equivalence en ESXi 5.0

esxcli
esxcli
esxcli
esxcli
esxcli
esxcli
esxcli

system settings advanced

system settings kernel
system coredump
hardware
network
network firewall
iscsi

esxcli system module

esxcli storage core path
esxcli storage nfs
esxcli network nic
esxcli storage core adapter rescan
esxcli storage coreesxcli storage
filesystem
esxcli network ip interface
esxcli storage filesystem
esxcli storage vmfs
esxcli network vswitch standard
esxcli network vswitch dvs
esxcli
esxcli
esxcli
esxcli

storage core
network ip
iscsi
vm process

esxcli
esxcli
esxcli
esxcli

software vib
software sources
filesystem vmfs
vm

Ce tableau ne vous donne que le dbut de syntaxe pour leur quivalence

(la liste complte des options ici).

Page 4

1-Oprations sur les machines virtuelles

Note: L'ensemble de ces commandes est pour ESXi 5.0, elles varient pour
d'autres versions.
Avoir la liste des VMs enregistres sur l'hte (on obtient ainsi le VMid):
# vim-cmd vmsvc/getallvms

Avoir la liste des VMs allumes sur l'hte (on obtient ainsi le WorldID):
# esxcli vm process list

Forcer l'arrt propre d'une VM:

# esxcli vm process kill -t soft -w <WorldID>

Forcer l'arrt brutal d'une VM (en dernier recours):

# esxcli vm process kill -t force -w <WorldID>

Avoir l'tat d'une VM:

# vim-cmd vmsvc/power.getstate <VMid>

Eteindre une VM:

# vim-cmd vmsvc/power.off <VMid>

Allumer une VM:

# vim-cmd vmsvc/power.on <VMid>

Redmarrer une VM:

# vim-cmd vmsvc/power.reboot <VMid>

Recharger la configuration d'une VM (aprs modification du fichier .vmx):

# vim-cmd vmsvc/reload <VMid>

Supprimer tous les Snapshots d'une VM:

# vim-cmd vmsvc/snapshot.removeall <VMid>

Avoir une estimation de l'espace ncessaire pour consolider un Snapshot

d'une VM:
# vim-cmd vmsvc/get.spaceNeededForConsolidation <VMid>

Enregistrer une VM sur l'hte:

# vim-cmd solo/registervm /vmfs/volumes/datastore/VM2/VM2.vmx

Ds-enregistrer une VM d'un hte:

# vim-cmd hostsvc/unregister <VMid>

Avoir le rsum d'une VM:

# vim-cmd vmsvc/get.summary <VMid>

Page 5

1-Oprations sur les disques virtuels

Crer un disque virtuel:
# vmkfstools -c 10G /vmfs/volumes/datastore1/VM3/VM3_1.vmdk

Ajouter un disque virtuel existant une VM (en SCSI0:1):

# vim-cmd vmsvc/device.addexisting <VMid>
/vmfs/volumes/datastore1/VM3/VM3_1.vmdk 0 1

Ajouter un disque une VM (l'quivalent des 2 prcdentes commandes):

# vim-cmd vmsvc/device.diskadd <VMid> 10G 0 1 datastore1

Convertir un disque virtuel de Thin en Thick:

# vmkfstools -j /vmfs/volumes/datastore1/VM1/VM1.vmdk

Convertir un disque virtuel de Thick en Thin:

# vmkfstools -K /vmfs/volumes/datastore1/VM1/VM1.vmdk

Agrandir la taille d'un disque virtuel:

# vmkfstools -X 15G /vmfs/volumes/datastore1/VM1/VM1.vmdk

Page 6

1-Oprations sur l'hte ESXi

Rinitialiser la configuration en mode usine (comme la fin de
l'installation):
# /sbin/firmwareConfig.sh --reset

Attribuer une licence l'hte:

# vim-cmd vimsvc/license --set XXXXX-XXXXX-XXXXX-XXXXX-XXXXX

Mettre l'hte en Mode Maintenance:

# vim-cmd hostsvc/maintenance_mode_enter

Sortir l'hte du Mode Maintenance:

# vim-cmd hostsvc/maintenance_mode_exit

Avoir la liste des patchs installs sur un hte:

# esxcli software vib list

Installer un patch manuellement (tre en mode maintenance):

# esxcli software vib update --depot=/vmfs/volumes/datastore1/ESXi500201109001.zip

Autoriser un service sur le firewall de l'hte:

# esxcli network firewall ruleset set -r snmp -e true

Dsactiver le firewall de l'hte:

# esxcli network firewall set -e false

Afficher la liste des codes erreur VMkernel:

# vmkerrcode -l

Afficher la version de l'hte:

#

esxcli system version get

Avoir la configuration des paramtres avancs:

# esxcli system settings advanced list

Lancer l'interface DCUI (peut-tre utile en SSH), faire un Ctrl + C pour

quitter :
# dcui

Page 7

Page 8

1-Oprations sur les Services

Vrifier l'tat du service "hostd":
# /etc/init.d/hostd status

Redmarrer le service "hostd":

# /etc/init.d/hostd restart

Redmarrer l'agent vCenter ("vpxa"):

# /etc/init.d/vpxa restart

Redmarrer tous les services:

# services.sh restart

Activer le SSH temporairement (jusqu'au prochain redmarrage):

# /etc/init.d/SSH start

Activer et dmarrer le SSH de faon permanente:

# vim-cmd hostsvc/enable_ssh
# vim-cmd hostsvc/start_ssh

Avoir la configuration du dmarrage automatique de tous les services

# chkconfig -l

Page 9

1-Oprations sur la configuration rseau

Avoir la liste des interfaces rseau physique:
# esxcli network nic list

Crer un vSwitch:
# esxcli network vswitch standard add -v vSwitch1

Ajouter une interface physique un vSwitch:

# esxcli network vswitch standard uplink add -u vmnic1 -v vSwitch1

Ajouter un PortGroup un vSwitch:

# esxcli network vswitch standard portgroup add -p LAN -v vSwitch1

Ajouter une interface physique un PortGroup (dfinir les interfaces

actives):
# esxcli network vswitch
vmnic0,vmnic1 -p LAN

standard

portgroup

policy

failover

set

-a

10.40.1.1

-N

Dfinir le VLAN d'un PortGroup:

# esxcli network vswitch standard portgroup set -v 40 -p LAN

Associer une interface VMkernel un PortGroup:

# esxcli network ip interface add -i vmk1 -p NFS

Dfinir l'IP d'une interface VMkernel:

# esxcli network ip interface
255.255.255.0 -t static

ipv4

set

-i

vmk1

-I

Activer le CDP sur un vSwitch:

# esxcli network vswitch standard set --cdp-status both -v vSwitch1

Modifier le MTU d'une interface VMkernel:

# esxcli network ip interface set -m 9000 -i vmk1

Modifier le MTU d'un vSwitch:

# esxcli network vswitch set -m 9000 -v vSwitch1

Oprations sur le Stockage

Afficher la liste des LUNs:
# esxcli storage nmp device list

Afficher la liste des chemins:

# esxcli storage nmp path list

Afficher la correspondance entre les LUNs et les VMFS:

# esxcli storage filesystem list

Faire un Rescan du SAN sur toutes les HBAs:

# esxcli storage core adapter rescan --all

Ou aussi, faire un Rescan du SAN:

# vim-cmd hostsvc/storage/vmfs_rescan

Rafraichir les LUNs:

Page 10

# vim-cmd hostsvc/storage/vmfs_refresh

Afficher la liste des volumes non-monts (car dtects comme Snapshot):

# esxcli storage vmfs snapshot list

Forcer le montage d'un VMFS:

# esxcli storage vmfs snapshot mount VMFS1

Resigner un VMFS:
# esxcli storage vmfs snapshot resignature VMFS2

Afficher la compatibilit VAAI des volumes:

# esxcli storage core device vaai status get

Activer initiateur iSCSI software:

# esxcli iscsi software set -e true

Faire une redcouverte iSCSI

# esxcli iscsi adapter discovery rediscover -A vmhba33

Afficher la liste des volumes NFS monts:

# esxcli storage nfs list

Ajouter un volume NFS:

# esxcli storage nfs add -H 10.40.1.100 -s /vol/share -v Vol_NFS

Avoir la liste des VMs allums avec leur WorldGroupID et leur disques:
# vscsiStats -l

Dmarrer la collecte des stats pour une VM (s'arrte automatiquement au

bout de 30 min):
# vscsiStats -w <WorldGroupID> -s

Afficher un histogramme de latences des performances collectes:

# vscsiStats -w <WorldGroupID> -p latency

Arrter la collecte des stats d'une VM:

# vscsiStats -x <WorldGroupID> -s

Page 11

1-Les fichiers de logs en ESXi

Il peut aussi tre utile de connatre l'emplacement des diffrents fichiers
de logs et leur rle. Voici donc un tableau, rcapitulant les fichiers de logs
en ESXi 5.0:
Fichier logs
/var/log/auth.log
/var/log/dhclient.log

/var/log/esxupdate.log
/var/log/hostd.log

/var/log/shell.log

/var/log/sysboot.log
/var/log/syslog.log

/var/log/usb.log

/var/log/vob.log

Contenu
logs les succs et les checs d'authentification au
shell ESXi
logs du service client DHCP client service, y
compris la dcouverte, les demandes de bail
d'adresse et les renouvellements
logs d'installation des patchs et des mise
jour ESXi
logs du service "Host management", incluant les
taches et les vnements sur l'hte et ses VMs,
les communications avec le client vSphere en
direct et avec l'agent vCenter (vpxa), et les
connections SDK
logs de l'utilisation en shell ESXi, incluant les
activations/dsactivations
et
toutes
les
commandes entres
logs du dmarrage VMkernel et du chargement
des modules
logs de l'initialisation du service de Management,
la surveillance par les watchdogs, les taches
planifies et l'utilisation de la DCUI
les vnement d'arbitrage des priphriques USB,
comme la dcouverte et la transmission vers
les VMs
observateur d'vnements VMkernel, semblable
vob.component.event

/var/log/vmkernel.log

/var/log/vmkwarning.log
/var/log/vmksummary.log

/var/log/vpxa.log

/var/log/fdm.log

logs du "Core VMkernel", incluant la dcouverte

de priphrique, les vnements lis aux
priphriques et aux drivers de stockage et
rseaux, et le dmarrage des VMs
le rsum des alertes et des messages d'erreurs
extrait des logs VMkernel
le rsum de la squence d'arrt/dmarrage de
l'hte, l'heartbeat horraire avec l'uptime, le
nombre VMs dmarres, et la consommation des
ressources par les services
logs de l'agent vCenter (vpxa), incluant les
communications entre le serveur vCenter Server
et l'agent "Host Management" (hostd)
logs du module High Availability, produit par le
service "fdm"
Page 12

Si la "Partition" est configure, elle contiendra les fichiers de logs. Ils

seront tout de mme disponible dans "/var/log" en tant que liens
symboliques.

Page 13

2-Annexes
Voici une liste de documents complmentaires:

KB1032479: Understanding and troubleshooting the esxcli tool in

vSphere 5.0

Technical note : Command-line Management in vSphere 5.0 for

Service Console Users

VMware ESXi 5.0 Reference with vCLI

Major Enhancements in esxcli for vSphere 5 sur VirtuallyGhetto

vSphere 5 Command Line Documentation: ESXCLI Command

Hierarchies

vSphere Command-Line Interface Reference

ESXi 4.1 - vim-cmd - examples

Using vscsiStats for Storage Performance Analysis

KB2004201: Location of ESXi 5.0 log files

Directory of Linux Commands

Source :

http://www.vmnerds.fr

Page 14