Avant d'exécuter le programme d'installation de la CLI pour déployer une instance de vCenter Server Appliance, vous devez préparer un fichier JSON avec des paramètres de configuration et leurs valeurs pour la spécification de votre déploiement.
Le programme d'installation de vCenter Server contient les modèles JSON pour toutes les options de déploiement. Pour plus d'informations sur les modèles, reportez-vous à Modèles JSON pour le déploiement du dispositif vCenter Server Appliance via une interface de ligne de commande.
Vous pouvez déployer un dispositif avec les configurations minimales en définissant les valeurs des paramètres de configuration dans le modèle JSON en fonction de votre spécification. Vous pouvez modifier les valeurs prédéfinies, supprimer et ajouter des paramètres de configuration à des fins de configurations personnalisées.
Pour obtenir une liste complète des paramètres de configuration et de leurs descriptions, accédez au sous-répertoire du programme d'installation de votre système d'exploitation et exécutez la commande vcsa-deploy install --template-help ou reportez-vous à la section Paramètres de configuration d'un déploiement.
Conditions préalables
- Vous devez maîtriser la syntaxe JSON.
- Télécharger et monter le programme d'installation de vCenter Server.
Procédure
Que faire ensuite
Vous pouvez créer et enregistrer des modèles supplémentaires au besoin, en fonction de votre spécification de déploiement.
Modèles JSON pour le déploiement du dispositif vCenter Server Appliance via une interface de ligne de commande
Le programme d'installation de vCenter Server inclut des modèles JSON avec les paramètres de configuration minimale pour toutes les options de déploiement. Les modèles se trouvent dans le répertoire vcsa-cli-installer/templates/install.
À chaque option de déploiement correspond un modèle de déploiement du dispositif sur un hôte ESXi et un autre modèle de déploiement du dispositif sur une instance de vCenter Server.
Modèle | Description |
---|---|
embedded_vCSA_on_ESXi.json | Contient les paramètres de configuration minimale requis pour le déploiement d'un dispositif vCenter Server sur un hôte ESXi. |
vCSA_with_cluster_on_ESXi.json | Contient les paramètres de configuration minimale requis pour le déploiement d'un dispositif vCenter Server avec un nœud unique vSAN et un cluster géré par vLCM sur un hôte ESXi. |
embedded_vCSA_on_VC.json | Contient les paramètres de configuration minimale requis pour le déploiement d'un dispositif vCenter Server sur une instance de vCenter Server. |
embedded_vCSA_replication_on_ESXi.json | Contient les paramètres de configuration minimale requis pour le déploiement d'un dispositif vCenter Server en tant que partenaire de réplication vers un autre dispositif vCenter Server intégré sur un hôte ESXi. |
embedded_vCSA_replication_on_VC.json | Contient les paramètres de configuration minimale requis pour le déploiement d'un partenaire de réplication d'un dispositif vCenter Server vers un autre dispositif vCenter Server sur une instance de vCenter Server. |
Paramètres de configuration d'un déploiement
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.
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
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
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. |
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-8.0.0.XXXX-YYYYYYY_OVF10.ova"
définit le chemin d'accès G:\vcsa\VMware-vCenter-Server-Appliance-8.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
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. |
enable_vsan_esa |
Booléen | Défini sur true pour créer un cluster vSAN sur lequel vSAN ESA est activé. vSAN Express Storage Architecture est une architecture de nouvelle génération conçue pour tirer le meilleur parti des périphériques de stockage hautes performances, ce qui permet d'améliorer les performances et l'efficacité. |
single_tier |
Baie | Liste des UUID ou noms canoniques des disques que vous souhaitez ajouter à un pool de stockage vSAN. Requis uniquement si vous définissez enable_vsan_esa sur true . |
vsan_hcl_database_path |
String | Chemin de la base de données HCL de vSAN locale. Si la base de données HCL de vSAN présente à cet emplacement est obsolète, le programme d'installation télécharge et remplace l'ancienne version par la dernière version. Requis uniquement si vous définissez enable_vsan_esa sur true . |
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é. |
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é. |
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é. |
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.
|
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. |
Nom | Type | Description |
---|---|---|
ip_family |
string | Version IP du réseau du dispositif. Définissez sur |
mode |
string | Attribution IP du réseau du dispositif. Définissez sur |
ip |
string | Adresse IP du dispositif. Requise uniquement si vous utilisez une attribution statique, c'est-à-dire, si vous définissez le paramètre Vous devez définir une adresse IPv4 ou IPv6 correspondant à la version IP réseau, c'est-à-dire à la valeur du paramètre 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 |
prefix |
string | Longueur du préfixe de réseau. À utiliser seulement si le paramètre 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 Pour la version IPv6, la valeur doit se situer entre |
gateway |
string | Adresse IP de la passerelle par défaut. Pour la version IPv6, la valeur peut être |
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 : 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. |
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 Ignoré si vous définissez des serveurs NTP pour la synchronisation de l'heure, c'est-à-dire si vous définissez le paramètre |
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
Nom | Type | Description |
---|---|---|
ceip_enabled |
Booléen | Définissez sur true pour participer au programme d'amélioration du produit (CEIP) du dispositif. |