Page 1

LISTE DES COMMANDES UTILES POUR ESXI

Table des matières1 - Introduction..............................................................................................................2

2 - Opérations sur les machines virtuelles.....................................................................5

3 - Opérations sur les disques virtuels...........................................................................7

4 - Opérations sur l'hôte ESXi........................................................................................8

5 - Opérations sur les Services....................................................................................10

6 - Opérations sur la configuration réseau...................................................................11

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

8 - Annexes.................................................................................................................16

Annexes

Page 2

1-Introduction

Avec vSphere 5, les commandes de management en ligne de commande ont quelque-peu changé. En effet, la commande "esxcli" existait déjà 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 obsolètes et disparaîtront dans les futures versions. De même, les commandes en "vicfg-*" utilisable à distance avec le package vCLI, ne sont pas encore obsolète mais le deviendront également avec le temps. Il faut donc déjà prendre le pli de les remplacer par "esxcli". Cependant, les commandes suivantes n'ont pas d’équivalent 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 3

"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 problème du service "hostd" sinon on peut avoir des problèmes de consistance de la configuration de l'hôte.

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 intéressant de noter qu'il est possible de formater le résultat en sorti avec l'option "--formatter", exemple:

# esxcli--formatter=csv --format-param=fields=”Name,Mac Address,Enabled” network ip interface listName,MACAddress,Enabledvmk0,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 Descriptionesxcli Commandes fonctionnant sur le système esxcli lui-

même, permettant aux utilisateurs d'obtenir des informations supplémentaires

fcoe Commandes FCoEhardware Propriétés matérielles et commandes pour la

configuration matérielleiscsi Commandes iSCSInetwork Opérations permettant la maintenance des réseaux sur

un hôte ESXi. Incluant diverses commandes pour manipuler les composants réseau virtuel (vSwitch, portgroup, dVS, etc) ainsi que l'IP local, DNS et les paramètres généraux de réseau hôte.

software Gestion de l'image et des packages ESXistorage Commandes Stockagesystem Les propriétés système et les commandes de

configuration des propriétés du VMKernelvm Opérations permettant à un utilisateur de contrôler les

Page 4

machines virtuelles

La commande "esxcli esxcli command list" permet d'avoir la liste complète des commandes. Rajouter la commande "--help" pour avoir le détail.

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

Equivalence en ESXi 5.0

esxcfg-advcfg esxcli system settings advancedesxcli system settings kernel

esxcfg-dumppart esxcli system coredumpesxcfg-info esxcli hardware

esxcli networkesxcfg-firewall esxcli network firewallesxcfg-swiscsiesxcfg-hwiscsi

esxcli iscsi

esxcfg-module esxcli system moduleesxcfg-mpath esxcli storage core pathesxcfg-nas esxcli storage nfsesxcfg-nics esxcli network nicesxcfg-rescan esxcli storage core adapter rescanesxcfg-scsidevs esxcli storage coreesxcli storage

filesystemesxcfg-vmknic esxcli network ip interfaceesxcfg-volume esxcli storage filesystem

esxcli storage vmfsesxcfg-vswitch esxcli network vswitch standard

esxcli network vswitch dvs

esxcli corestorage esxcli storage coreesxcli network esxcli network ipesxcli swiscsi esxcli iscsiesxcli vms vm esxcli vm process

esxupdate esxcli software vibesxcli software sources

vmkfstools esxcli filesystem vmfsvmware-cmd esxcli vm

Ce tableau ne vous donne que le début de syntaxe pour leur équivalence (la liste complète des options ici).

Page 5

1-Opérations 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 enregistrées sur l'hôte (on obtient ainsi le VMid):# vim-cmd vmsvc/getallvms

Avoir la liste des VMs allumées sur l'hôte (on obtient ainsi le WorldID):# esxcli vm process list

Forcer l'arrêt propre d'une VM:# esxcli vm process kill -t soft -w <WorldID>

Forcer l'arrêt 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>

Redémarrer une VM:# vim-cmd vmsvc/power.reboot <VMid>

Recharger la configuration d'une VM (après 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 nécessaire pour consolider un Snapshot d'une VM:

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

Enregistrer une VM sur l'hôte:# vim-cmd solo/registervm /vmfs/volumes/datastore/VM2/VM2.vmx

Dés-enregistrer une VM d'un hôte:# vim-cmd hostsvc/unregister <VMid>

Avoir le résumé d'une VM:# vim-cmd vmsvc/get.summary <VMid>

Page 6

1-Opérations sur les disques virtuels

Créer 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 précédentes 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 7

1-Opérations sur l'hôte ESXi

Réinitialiser la configuration en mode usine (comme à la fin de l'installation):

# /sbin/firmwareConfig.sh --reset

Attribuer une licence à l'hôte:# vim-cmd vimsvc/license --set XXXXX-XXXXX-XXXXX-XXXXX-XXXXX

Mettre l'hôte en Mode Maintenance:# vim-cmd hostsvc/maintenance_mode_enter

Sortir l'hôte du Mode Maintenance:# vim-cmd hostsvc/maintenance_mode_exit

Avoir la liste des patchs installés sur un hôte:# esxcli software vib list

Installer un patch manuellement (être en mode maintenance):# esxcli software vib update --depot=/vmfs/volumes/datastore1/ESXi500-

201109001.zip

Autoriser un service sur le firewall de l'hôte:# esxcli network firewall ruleset set -r snmp -e true

Désactiver le firewall de l'hôte:# esxcli network firewall set -e false

Afficher la liste des codes erreur VMkernel:# vmkerrcode -l

Afficher la version de l'hôte:

# esxcli system version get

Avoir la configuration des paramètres avancés:# esxcli system settings advanced list

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

# dcui

Page 8

Page 9

1-Opérations sur les Services

Vérifier l'état du service "hostd":# /etc/init.d/hostd status

Redémarrer le service "hostd":# /etc/init.d/hostd restart

Redémarrer l'agent vCenter ("vpxa"):# /etc/init.d/vpxa restart

Redémarrer tous les services:# services.sh restart

Activer le SSH temporairement (jusqu'au prochain redémarrage):# /etc/init.d/SSH start

Activer et démarrer le SSH de façon permanente:# vim-cmd hostsvc/enable_ssh# vim-cmd hostsvc/start_ssh

Avoir la configuration du démarrage automatique de tous les services# chkconfig -l

Page 10

1-Opérations sur la configuration réseau

Avoir la liste des interfaces réseau physique:# esxcli network nic list

Créer 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 (définir les interfaces actives):

# esxcli network vswitch standard portgroup policy failover set -a vmnic0,vmnic1 -p LAN

Définir 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

Définir l'IP d'une interface VMkernel:# esxcli network ip interface ipv4 set -i vmk1 -I 10.40.1.1 -N

255.255.255.0 -t static

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

Opérations 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 11

# vim-cmd hostsvc/storage/vmfs_refresh

Afficher la liste des volumes non-montés (car détectés 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 redécouverte iSCSI# esxcli iscsi adapter discovery rediscover -A vmhba33

Afficher la liste des volumes NFS montés:# 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 allumés avec leur WorldGroupID et leur disques:# vscsiStats -l

Démarrer la collecte des stats pour une VM (s'arrête automatiquement au bout de 30 min):

# vscsiStats -w <WorldGroupID> -s

Afficher un histogramme de latences des performances collectées:# vscsiStats -w <WorldGroupID> -p latency

Arrêter la collecte des stats d'une VM:# vscsiStats -x <WorldGroupID> -s

Page 12

1-Les fichiers de logs en ESXi

Il peut aussi être utile de connaître l'emplacement des différents fichiers de logs et leur rôle. Voici donc un tableau, récapitulant les fichiers de logs en ESXi 5.0:

Fichier logs Contenu/var/log/auth.log logs les succès et les échecs d'authentification au

shell ESXi/var/log/dhclient.log logs du service client DHCP client service, y

compris la découverte, les demandes de bail d'adresse et les renouvellements

/var/log/esxupdate.log logs d'installation des patchs et des mise à jour ESXi

/var/log/hostd.log logs du service "Host management", incluant les taches et les événements sur l'hôte et ses VMs, les communications avec le client vSphere en direct et avec l'agent vCenter (vpxa), et les connections SDK

/var/log/shell.log logs de l'utilisation en shell ESXi, incluant les activations/désactivations et toutes les commandes entrées

/var/log/sysboot.log logs du démarrage VMkernel et du chargement des modules

/var/log/syslog.log logs de l'initialisation du service de Management, la surveillance par les watchdogs, les taches planifiées et l'utilisation de la DCUI

/var/log/usb.log les événement d'arbitrage des périphériques USB, comme la découverte et la transmission vers les VMs

/var/log/vob.log observateur d'événements VMkernel, semblable à vob.component.event

/var/log/vmkernel.log logs du "Core VMkernel", incluant la découverte de périphérique, les événements liés aux périphériques et aux drivers de stockage et réseaux, et le démarrage des VMs

/var/log/vmkwarning.log le résumé des alertes et des messages d'erreurs extrait des logs VMkernel

/var/log/vmksummary.log le résumé de la séquence d'arrêt/démarrage de l'hôte, l'heartbeat horraire avec l'uptime, le nombre VMs démarrées, et la consommation des ressources par les services

/var/log/vpxa.log logs de l'agent vCenter (vpxa), incluant les communications entre le serveur vCenter Server et l'agent "Host Management" (hostd)

/var/log/fdm.log logs du module High Availability, produit par le service "fdm"

Page 13

Si la "Partition" est configurée, elle contiendra les fichiers de logs. Ils seront tout de même disponible dans "/var/log" en tant que liens symboliques.

Page 14

2-Annexes

Voici une liste de documents complémentaires:

• KB1032479: Unders tan ding and trou ble shoo ting the esx cli tool in vSphere 5.0

• Technical note : Command-line Mana ge ment in vSphere 5.0 for Ser vice Console Users

• VMware ESXi 5.0 Refe rence with vCLI

• Major Enhan ce ments in esx cli for vSphere 5 sur VirtuallyGhetto

• vSphere 5 Command Line Documentation: ESXCLI Com mand Hierarchies

• vSphere Command-Line Inter face Reference

• ESXi 4.1 - vim-cmd - examples

• Using vsc si Stats for Sto rage Per for mance Analysis

• KB2004201: Loca tion of ESXi 5.0 log files

• Direc tory of Linux Commands

Source :

http://www.vmnerds.fr