Vous êtes sur la page 1sur 14

LISTE

DES COMMANDES UTILES POUR

ESXI

Table des matires


12345678Introduction..............................................................................................................2 Oprations sur les machines virtuelles.....................................................................5 Oprations sur les disques virtuels...........................................................................7 Oprations sur l'hte ESXi........................................................................................8 Oprations sur les Services....................................................................................10 Oprations sur la configuration rseau...................................................................11 Les fichiers de logs en ESXi....................................................................................14 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 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 esxcli esxcli esxcli esxcli storage core network ip iscsi vm process software vib software sources filesystem vmfs vm

esxupdate vmkfstools vmware-cmd

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

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 10.40.1.1 -N

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 /var/log/vmkernel.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/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