Upload
fcportofcp
View
130
Download
1
Embed Size (px)
Citation preview
LISTE
DES COMMANDES UTILES POUR
ESXI
Table des matires12345678Introduction..............................................................................................................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-IntroductionAvec 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 virtuellesNote: 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
Forcer l'arrt brutal d'une VM (en dernier recours):# esxcli vm process kill -t force -w
Avoir l'tat d'une VM:# vim-cmd vmsvc/power.getstate
Eteindre une VM:# vim-cmd vmsvc/power.off
Allumer une VM:# vim-cmd vmsvc/power.on
Redmarrer une VM:# vim-cmd vmsvc/power.reboot
Recharger la configuration d'une VM (aprs modification du fichier .vmx):# vim-cmd vmsvc/reload
Supprimer tous les Snapshots d'une VM:# vim-cmd vmsvc/snapshot.removeall
Avoir une estimation de l'espace ncessaire pour consolider un Snapshot d'une VM:# vim-cmd vmsvc/get.spaceNeededForConsolidation
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
Avoir le rsum d'une VM:# vim-cmd vmsvc/get.summary
Page 5
1-Oprations sur les disques virtuelsCrer 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 /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 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 ESXiRinitialiser 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 ServicesVrifier 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 rseauAvoir 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 -s
Afficher un histogramme de latences des performances collectes:# vscsiStats -w -p latency
Arrter la collecte des stats d'une VM:# vscsiStats -x -s
Page 11
1-Les fichiers de logs en ESXiIl 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-AnnexesVoici 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