Catégories
ESXi

Management en ligne de commande avec ESXCLI

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.

ESXi_CLI

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 é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« .

« 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 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:

NamespaceDescription
esxcliCommandes fonctionnant sur le système esxcli lui-même, permettant aux utilisateurs d’obtenir des informations supplémentaires
fcoeCommandes FCoE
hardwarePropriétés matérielles et commandes pour la configuration matérielle
iscsiCommandes iSCSI
networkOpé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 ESXi
storageCommandes Stockage
systemLes propriétés système et les commandes de configuration des propriétés du VMKernel
vmOpérations permettant à un utilisateur de contrôler les 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 ConsoleEquivalence en ESXi 5.0
esxcfg-advcfgesxcli system settings advanced
esxcli system settings kernel
esxcfg-dumppartesxcli system coredump
esxcfg-infoesxcli hardware
esxcli network
esxcfg-firewallesxcli network firewall
esxcfg-swiscsi
esxcfg-hwiscsi
esxcli iscsi
esxcfg-moduleesxcli system module
esxcfg-mpathesxcli storage core path
esxcfg-nasesxcli storage nfs
esxcfg-nicsesxcli network nic
esxcfg-rescanesxcli storage core adapter rescan
esxcfg-scsidevsesxcli storage coreesxcli storage filesystem
esxcfg-vmknicesxcli network ip interface
esxcfg-volumeesxcli storage filesystem
esxcli storage vmfs
esxcfg-vswitchesxcli network vswitch standard
esxcli network vswitch dvs
esxcli corestorageesxcli storage core
esxcli networkesxcli network ip
esxcli swiscsiesxcli iscsi
esxcli vms vmesxcli vm process
esxupdateesxcli software vib
esxcli software sources
vmkfstoolsesxcli filesystem vmfs
vmware-cmdesxcli vm

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

J’espère pouvoir vous faire prochainement une liste des commandes essentielles en cas d’urgence…> c’est ici.

Voici une liste de documents complémentaires:

3 réponses sur « Management en ligne de commande avec ESXCLI »

Les commentaires sont fermés.