Lorsque vous préparez vos fichiers de configuration JSON pour un déploiement par interface de ligne de commande, vous devez définir les paramètres et les valeurs permettant de fournir des données d'entrée pour le déploiement d'un dispositif vCenter Server.

Sections et sous-sections des paramètres de configuration dans les fichiers de déploiement JSON

Les paramètres de configuration dans les fichiers de configuration JSON pour la mise à niveau via l'interface de ligne de commande sont répartis par sections et par sous-sections.

Tableau 1. Sections et sous-sections des paramètres de configuration dans les fichiers de déploiement JSON
Section Sous-section Description
new_vcsa : décrit le dispositif que vous souhaitez déployer. esxi

À utiliser uniquement si vous souhaitez déployer le dispositif directement sur un hôte ESXi.

Contient les paramètres de configuration qui décrivent l'hôte ESXi cible.

Selon que vous souhaitez configurer un cluster géré vSAN ou vLCM pendant le déploiement, consultez la section appropriée pour obtenir des informations détaillées sur les paramètres de configuration.
Note : Vous devez renseigner la sous-section esxi ou vc.
vc

À utiliser uniquement si vous souhaitez déployer le dispositif sur l'inventaire d'une instance de vCenter Server.

Contient les paramètres de configuration qui décrivent l'hôte ESXi ou le cluster DRS cible dans l'inventaire de vCenter Server. Reportez-vous à la section Paramètres de configuration dans la section new_vcsa, sous-section vc.

Note : Vous devez renseigner la sous-section vc ou esxi.
appliance Contient les paramètres de configuration qui décrivent le dispositif. Reportez-vous à la section Paramètres de configuration dans la section new_vcsa, sous-section appliance.
network Contient les paramètres de configuration qui décrivent les paramètres réseau du dispositif. Reportez-vous à la section Paramètres de configuration dans la section new_vcsa, sous-section network.
os Contient les paramètres de configuration qui décrivent les paramètres du système d'exploitation du dispositif. Reportez-vous à la section Paramètres de configuration dans la section new_vcsa, sous-section os.
sso Contient les paramètres de configuration qui décrivent les paramètres vCenter Single Sign-On du dispositif. Reportez-vous à la section Paramètres de configuration dans la section new_vcsa, sous-section sso.
ovftool_arguments Sous-section facultative pour ajouter des arguments arbitraires et leurs valeurs à la commande OVF Tool que le programme d'installation génère.
Important : Le programme d'installation vCenter Server ne valide pas les paramètres de configuration de la sous-section ovftool_arguments. Si vous définissez des arguments que l'OVF Tool ne reconnaît pas, le déploiement peut échouer.
ceip : décrit la participation au programme d'amélioration du produit VMware (CEIP). settings

Contient uniquement le paramètre de configuration ceip_enabled permettant de participer ou non au programme d'amélioration du produit VMware (CEIP). Reportez-vous à la section Paramètres de configuration dans la section ceip, sous-section settings.

Note : Si la valeur est définie sur true, vous devez exécuter la commande de déploiement de l'interface de ligne de commande avec l'argument --acknowledge-ceip.

Pour plus d'informations sur le CEIP, reportez-vous à la section Configuration du programme d'amélioration du produit dans Gestion de vCenter Server et des hôtes.

Important :

Les valeurs de chaîne, notamment les mots de passe, doivent contenir uniquement des caractères ASCII. Les caractères ASCII étendus et non-ASCII ne sont pas pris en charge.

Pour définir une valeur contenant un caractère de barre oblique inverse (\) ou de guillemets ("), vous devez faire précéder le caractère d'un caractère de barre oblique inverse (\). Par exemple, "password":"my\"password" définit le mot de passe my"password. De même, "image":"G:\\vcsa\\VMware-vCenter-Server-Appliance-7.0.0.XXXX-YYYYYYY_OVF10.ova" définit le chemin d'accès G:\vcsa\VMware-vCenter-Server-Appliance-7.0.0.XXXX-YYYYYYY_OVF10.ova.

Les valeurs booléennes ne doivent contenir que des caractères en minuscules. Il doit s'agir de true ou de false. Par exemple, "ssh_enable":false.

Paramètres de configuration dans la section new_vcsa

Tableau 2. Paramètres de configuration de la section new_vcsa, sous-section esxi pour les déploiements avec un cluster géré vSAN et vLCM
Nom Type Description
hostname string Adresse IP ou nom de domaine complet de l'hôte ESXi cible sur lequel vous souhaitez déployer le dispositif.
username string Nom d'utilisateur disposant de privilèges administratifs sur l'hôte ESXi cible, par exemple, « root ».
password string Mot de passe de l'utilisateur disposant de privilèges administratifs sur l'hôte ESXi cible.
deployment_network string

Nom du réseau auquel connecter le dispositif.

Note : Le réseau doit être accessible depuis l'hôte ESXi cible.

Ignoré si l'hôte ESXi cible dispose d'un seul réseau.

datacenter string Un centre de données spécifique que vous souhaitez créer.
cluster string Nom du cluster géré vSAN ou vLCM.
compression_only Booléen Définissez la valeur sur true pour activer la compression sur le cluster vSAN. Si ce paramètre est défini sur true, le paramètre deduplication_and_compression doit être défini sur false.
deduplication_and_compression Booléen Définissez la valeur sur true pour activer la compression et la déduplication sur le cluster vSAN. Si ce paramètre est défini sur true, le paramètre compression_only doit être défini sur false.
cache_disk Liste des UUID ou noms canoniques des disques que vous souhaitez utiliser pour le cache. Ne spécifiez que les SSD.
capacity_disk Liste des UUID ou noms canoniques des disques que vous souhaitez utiliser pour le stockage. Spécifiez des disques SSD ou HDD.
enable_vlcm Booléen Définissez cette valeur sur true pour créer un cluster géré vLCM.
datastore string

Nom de la banque de données dans laquelle vous souhaitez stocker les fichiers de configuration et les disques virtuels du dispositif.

Note :

La banque de données doit être accessible à partir de l'hôte ESXi.

Si vous utilisez le mode disque dynamique, la banque de données doit disposer d'un espace minimum de 25 Go.

port entier

Port proxy inversé HTTPS de l'hôte ESXi cible.

Le port par défaut est 443. À utiliser uniquement si l'hôte ESXi cible utilise un port proxy inversé HTTPS personnalisé.

Tableau 3. Paramètres de configuration de la section new_vcsa, sous-section esxi pour les déploiements sans cluster géré vSAN et vLCM
Nom Type Description
hostname string Adresse IP ou nom de domaine complet de l'hôte ESXi cible sur lequel vous souhaitez déployer le dispositif.
username string Nom d'utilisateur disposant de privilèges administratifs sur l'hôte ESXi cible, par exemple, « root ».
password string Mot de passe de l'utilisateur disposant de privilèges administratifs sur l'hôte ESXi cible.
deployment_network string

Nom du réseau auquel connecter le dispositif.

Note : Le réseau doit être accessible depuis l'hôte ESXi cible.

Ignoré si l'hôte ESXi cible dispose d'un seul réseau.

datastore string

Nom de la banque de données dans laquelle vous souhaitez stocker les fichiers de configuration et les disques virtuels du dispositif.

Note :

La banque de données doit être accessible à partir de l'hôte ESXi.

Si vous utilisez le mode disque dynamique, la banque de données doit disposer d'un espace minimum de 25 Go.

port entier

Port proxy inversé HTTPS de l'hôte ESXi cible.

Le port par défaut est 443. À utiliser uniquement si l'hôte ESXi cible utilise un port proxy inversé HTTPS personnalisé.

Tableau 4. Paramètres de configuration dans la section new_vcsa, sous-section vc
Nom Type Description
hostname string Adresse IP ou nom de domaine complet de l'instance de vCenter Server cible sur laquelle vous souhaitez déployer le dispositif.
username string nom d'utilisateur de l'administrateur de vCenter Single Sign-On sur l'instance de vCenter Server cible, par exemple, [email protected].
password string Mot de passe de l'utilisateur administrateur de vCenter Single Sign-On sur l'instance de vCenter Server cible.
deployment_network string

Nom du réseau auquel connecter le dispositif.

Note : Le réseau doit être accessible à partir de l'hôte ESXi ou du cluster DRS cible sur lequel vous souhaitez déployer le dispositif.

Ignoré si l'hôte ESXi ou le cluster DRS cible dispose d'un seul réseau.

datacenter baie

Centre de données vCenter Server qui contient l'hôte ESXi ou le cluster DRS cible sur lequel vous souhaitez déployer le dispositif.

Si le centre de données est situé dans un dossier ou une structure de dossiers, spécifiez la valeur sous la forme d'une liste de chaînes séparées par une virgule. Par exemple,
["parent_folder", "child_folder", "datacenter_name"]
Note : La valeur est sensible à la casse.
datastore string

Nom de la banque de données dans laquelle vous souhaitez stocker les fichiers de configuration et les disques virtuels du dispositif.

Note :

La banque de données doit être accessible depuis l'hôte ESXi ou le cluster DRS cible.

La banque de données doit disposer d'au moins 25 Go d'espace libre.

port entier

Port proxy inversé HTTPS de l'instance de vCenter Server cible.

Le port par défaut est 443. À utiliser uniquement si l'instance de vCenter Server cible utilise un port proxy inversé HTTPS personnalisé.

target baie

Hôte ESXi ou cluster DRS cible sur lequel vous souhaitez déployer le dispositif.

Important : Vous devez fournir le nom qui s'affiche dans l'inventaire de vCenter Server. Par exemple, si le nom de l'hôte ESXi cible est une adresse IP dans l'inventaire de vCenter Server, vous ne pouvez pas fournir un nom de domaine complet.
Si le cluster hôte ou DRS ESXi cible est situé dans un dossier ou une structure de dossiers, spécifiez la valeur sous la forme d'une liste de chaînes séparées par une virgule. Par exemple,
["parent_folder", "child_folder", "esxi-host.domain.com"]
Si l'hôte ESXi cible fait partie d'un cluster, spécifiez le chemin d'accès sous la mesure d'une liste de chaînes séparées par une virgule. Par exemple,
["cluster_name", "esxi-host.domain.com"] 
				  
Note : La valeur est sensible à la casse.
vm_folder string Facultatif. Nom du dossier de machine virtuelle dans lequel le dispositif est déployé.
Tableau 5. Paramètres de configuration dans la section new_vcsa, sous-section appliance
Nom Type Description
thin_disk_mode Booléen Définissez sur true pour déployer le dispositif avec des disques virtuels dynamiques.
deployment_option string Taille du dispositif.
  • Définissez sur tiny si vous souhaitez déployer un dispositif vCenter Server Appliance pour un maximum de 10 hôtes et 100 machines virtuelles disposant de la taille de stockage par défaut.

    Déploie un dispositif comportant 2 CPU, 12 Go de mémoire et 315 Go de stockage.

  • Définissez sur tiny-lstorage si vous souhaitez déployer un dispositif vCenter Server Appliance pour un maximum de 10 hôtes et 100 machines virtuelles disposant de la grande taille de stockage.

    Déploie un dispositif comportant 2 CPU, 12 Go de mémoire et 1 390 Go de stockage.

  • Définissez sur tiny-xlstorage si vous souhaitez déployer un dispositif vCenter Server Appliance pour un maximum de 10 hôtes et 100 machines virtuelles disposant de la très grande taille de stockage.

    Déploie un dispositif comportant 2 CPU, 12 Go de mémoire et 3 145 Go de stockage.

  • Définissez sur small si vous souhaitez déployer un dispositif vCenter Server Appliance pour un maximum de 100 hôtes et 1 000 machines virtuelles disposant de la taille de stockage par défaut.

    Déploie un dispositif comportant 4 CPU, 19 Go de mémoire et 380 Go de stockage.

  • Définissez sur small-lstorage si vous souhaitez déployer un dispositif vCenter Server Appliance pour un maximum de 100 hôtes et 1 000 machines virtuelles disposant de la grande taille de stockage.

    Déploie un dispositif comportant 4 CPU, 19 Go de mémoire et 1 435 Go de stockage.

  • Définissez sur small-xlstorage si vous souhaitez déployer un dispositif vCenter Server Appliance pour un maximum de 100 hôtes et 1 000 machines virtuelles disposant de la très grande taille de stockage.

    Déploie un dispositif comportant 4 CPU, 19 Go de mémoire et 3 195 Go de stockage.

  • Définissez sur medium si vous souhaitez déployer un dispositif vCenter Server Appliance pour un maximum de 400 hôtes et 4 000 machines virtuelles disposant de la taille de stockage par défaut.

    Déploie un dispositif comportant 8 CPU, 28 Go de mémoire et 600 Go de stockage.

  • Définissez sur medium-lstorage si vous souhaitez déployer un dispositif vCenter Server Appliance pour un maximum de 400 hôtes et 4 000 machines virtuelles disposant de la grande taille de stockage.

    Déploie un dispositif comportant 8 CPU, 28 Go de mémoire et 1 600 Go de stockage.

  • Définissez sur medium-xlstorage si vous souhaitez déployer un dispositif vCenter Server Appliance pour un maximum de 400 hôtes et 4 000 machines virtuelles disposant de la très grande taille de stockage.

    Déploie un dispositif comportant 8 CPU, 28 Go de mémoire et 3 360 Go de stockage.

  • Définissez sur large si vous souhaitez déployer un dispositif vCenter Server Appliance pour un maximum de 1 000 hôtes et 10 000 machines virtuelles disposant de la taille de stockage par défaut.

    Déploie un dispositif comportant 16 CPU, 37 Go de mémoire et 965 Go de stockage.

  • Définissez sur large-lstorage si vous souhaitez déployer un dispositif vCenter Server Appliance pour jusqu'à 1 000 hôtes et 10 000 machines virtuelles disposant de la grande taille de stockage.

    Déploie un dispositif comportant 16 CPU, 37 Go de mémoire et 1 665 Go de stockage.

  • Définissez sur large-xlstorage si vous souhaitez déployer un dispositif vCenter Server Appliance pour un maximum de 1 000 hôtes et 10 000 machines virtuelles disposant de la très grande taille de stockage.

    Déploie un dispositif comportant 16 CPU, 37 Go de mémoire et 3 425 Go de stockage.

  • Définissez sur xlarge si vous souhaitez déployer un dispositif vCenter Server Appliance pour un maximum de 2 000 hôtes et 35 000 machines virtuelles disposant de la taille de stockage par défaut.

    Déploie un dispositif comportant 24 CPU, 56 Go de mémoire et 1 705 Go de stockage.

  • Définissez sur xlarge-lstorage si vous souhaitez déployer un dispositif vCenter Server Appliance pour un maximum de 2 000 hôtes et 35 000 machines virtuelles disposant de la grande taille de stockage.

    Déploie un dispositif comportant 24 CPU, 56 Go de mémoire et 1 805 Go de stockage.

  • Définissez sur xlarge-xlstorage si vous souhaitez déployer un dispositif vCenter Server Appliance pour un maximum de 2 000 hôtes et 35 000 machines virtuelles disposant de la très grande taille de stockage.

    Déploie un dispositif comportant 24 CPU, 56 Go de mémoire et 3 565 Go de stockage.

image string

Facultatif. Chemin d'accès au fichier local ou URL vers le module d'installation du dispositif vCenter Server Appliance.

Par défaut, le programme d'installation utilise le package d'installation qui est inclus dans le fichier ISO, dans le dossier vcsa.

name string

Nom de machine virtuelle du dispositif.

Doit contenir uniquement des caractères ASCII, sauf le symbole de pourcentage (%), la barre oblique inverse (\) ou la barre oblique (/) et ne doit pas comporter plus de 80 caractères.

ovftool_path string

Facultatif. Chemin d'au fichier local vers le fichier exécutable d'OVF Tool.

Par défaut, le programme d'installation utilise l'instance d'OVF Tools qui est incluse dans le fichier ISO, dans le dossier vcsa/ovftool.

Tableau 6. Paramètres de configuration dans la section new_vcsa, sous-section network
Nom Type Description
ip_family string

Version IP du réseau du dispositif.

Définissez sur ipv4 ou ipv6.

mode string Attribution IP du réseau du dispositif.

Définissez sur static ou dhcp.

ip string

Adresse IP du dispositif.

Requise uniquement si vous utilisez une attribution statique, c'est-à-dire, si vous définissez le paramètre mode sur static.

Vous devez définir une adresse IPv4 ou IPv6 correspondant à la version IP réseau, c'est-à-dire à la valeur du paramètre ip.family.

Une adresse IPv4 doit être conforme aux directives RFC 790.

Une adresse IPv6 doit être conforme aux directives RFC 2373.

dns_servers chaîne ou groupe

Adresses IP d'un ou plusieurs serveurs DNS.

Pour définir plusieurs serveurs DNS, utilisez une liste de chaînes séparées par des virgules ou une liste séparée par des virgules sous forme de chaîne unique pour fournir le chemin d'accès. Par exemple,
["x.y.z.a", "x.y.z.b"]
ou
"x.y.z.a, x.y.z.b"

Facultatif si le paramètre mode est défini sur static. Non pris en charge lorsque le mode est défini sur DHCP.

prefix string

Longueur du préfixe de réseau.

À utiliser seulement si le paramètre mode est défini sur static. À supprimer si le paramètre mode est défini sur dhcp.

La longueur du préfixe de réseau correspond au nombre de bits défini dans le masque de sous-réseau. Par exemple, si le masque de sous-réseau est 255.255.255.0, il y a 24 bits dans la version binaire de la longueur du préfixe et la longueur du préfixe du réseau est donc 24.

Pour la version IPv4, la valeur doit se situer entre 0 et 32.

Pour la version IPv6, la valeur doit se situer entre 0 et 128.

gateway string

Adresse IP de la passerelle par défaut.

Pour la version IPv6, la valeur peut être default.

ports string

Facultatif. Numéros de port que vCenter Server Appliance utilise pour les connexions HTTP directes. Par défaut, le port 80 redirige les demandes vers le port HTTPS 443. Vous pouvez personnaliser les ports HTTP et HTTPS de vCenter Server. Si vous spécifiez un numéro de port HTTP et HTTPS personnalisé, veillez à ne pas utiliser un port déjà utilisé par vCenter Server, ou les ports par défaut HTTP et HTTPS 80 et 443.

Les options pour spécifier un port personnalisé sont : "rhttpproxy.ext.port1":"numéro_port" pour le port HTTP et "rhttpproxy.ext.port2:"numéro_port" pour le port HTTPS.

L'exemple suivant spécifie les ports 81 et 444 pour les ports HTTP et HTTPS :

ports: {"rhttpproxy.ext.port1":"81", "rhttpproxy.ext.port2":"444"}

Pour plus d'informations sur les ports utilisés par vCenter Server, reportez-vous à la section Ports requis pour vCenter Server.

system_name string

Identité du réseau principal.

Peut être une adresse IP ou un nom de domaine complet, de préférence un nom de domaine complet.

Vous ne pouvez pas modifier la valeur de ce paramètre après le déploiement.

Le nom de domaine complet et les numéros décimaux à séparation par point doivent se conformer aux directives RFC 1123.

Tableau 7. Paramètres de configuration dans la section new_vcsa, sous-section os
Nom Type Description
password string

Mot de passe de l'utilisateur racine du système d'exploitation du dispositif.

Le mot de passe doit se composer de 8 à 20 caractères, dont au moins une lettre majuscule, au moins une lettre minuscule, au moins un chiffre et au moins au caractère spécial comme le signe du dollar ($), un signe dièse (#), une arobase (@), un point (.) ou un point d'exclamation (!). Tous les caractères doivent être des caractères ASCII minuscules sans espace.

ntp_servers chaîne ou groupe

Facultatif. Noms d'hôtes ou adresses IP d'un ou plusieurs serveur(s) NTP pour la synchronisation de l'heure.

Pour définir plusieurs serveurs NTP, utilisez une liste de chaînes séparées par des virgules ou une liste séparée par des virgules sous forme de chaîne unique pour fournir le chemin d'accès. Par exemple,
["x.y.z.a", "x.y.z.b"]
ou
"x.y.z.a, x.y.z.b"
ssh_enable Booléen Définissez sur true pour autoriser l'administrateur SSH à se connecter au dispositif.
Note : La haute disponibilité de vCenter Server Appliance nécessite l'accès SSH distant au dispositif.
time_tools_sync Booléen

Facultatif. Définissez sur true pour déployer le dispositif avec la synchronisation de l'heure par VMware Tools. VMware Tools synchronise l'heure du dispositif avec celle de l'hôte ESxi.

Ignoré si vous définissez des serveurs NTP pour la synchronisation de l'heure, c'est-à-dire si vous définissez le paramètre ntp.servers.

Tableau 8. Paramètres de configuration dans la section new_vcsa, sous-section sso
Nom Type Description
password string

Mot de passe de l'utilisateur administrateur de vCenter Single Sign-On, administrator@votre_nom_domaine.

Si vous déployez un dispositif vCenter Server Appliance en tant que première instance d'un nouveau domaine vCenter Single Sign-On, vous devez définir le mot de passe pour l'utilisateur administrateur de vCenter Single Sign-On.

Le mot de passe doit se composer de 8 à 20 caractères, dont au moins une lettre majuscule, au moins une lettre minuscule, au moins un chiffre et au moins au caractère spécial comme le signe du dollar ($), un signe dièse (#), une arobase (@), un point (.) ou un point d'exclamation (!). Tous les caractères doivent être des caractères ASCII.

domain_name string

Nom de domaine vCenter Single Sign-On, par exemple, vsphere.local.

Si vous déployez un dispositif vCenter Server Appliance en tant que première instance d'un nouveau domaine vCenter Single Sign-On, vous devez définir le nom du nouveau domaine vCenter Single Sign-On.

replication_partner_hostname string

Nom du système de l'instance partenaire de vCenter Server.

Requis uniquement si vous déployez un partenaire de réplication dans un domaine vCenter Single Sign-On existant.

sso_port entier

Port proxy inversé HTTPS de l'instance partenaire de vCenter Server.

Le port par défaut est 443. À utiliser uniquement si le partenaire utilise un port proxy inversé HTTPS personnalisé.

Paramètres de configuration dans la section ceip

Tableau 9. Paramètres de configuration dans la section ceip, sous-section settings
Nom Type Description
ceip_enabled Booléen Définissez sur true pour participer au programme d'amélioration du produit (CEIP) du dispositif.