Préparer votre fichier de configuration JSON à la mise à niveau via l'interface de ligne de commande

Avant d'exécuter la commande de l'interface de ligne de commande pour mettre à niveau 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 mise à niveau.

Le programme d'installation vCenter Server contient les modèles JSON pour tous les types de mise à jour. Pour plus d'informations sur les modèles, reportez-vous à Modèles JSON pour la mise à niveau de l'instance de vCenter Server Appliance via une interface de ligne de commande.

Vous pouvez mettre à niveau 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 upgrade --template-help ou reportez-vous à la section Paramètres de configuration de la mise à niveau pour la mise à niveau via l'interface de ligne de commande de vCenter Server Appliance.

Conditions préalables

Vous devez maîtriser la syntaxe JSON.
Télécharger et monter le programme d'installation de vCenter Server.

Procédure

Dans le programme d'installation vCenter Server Appliance, accédez au répertoire vcsa-cli-installer et ouvrez le sous-dossier templates.
Copiez les modèles de mise à niveau du sous-dossier upgrade vers votre espace de travail.

Important : Le chemin d'accès aux fichiers de configuration JSON doit contenir uniquement des caractères ASCII. Les caractères ASCII étendus et non-ASCII ne sont pas pris en charge.
Ouvrez le fichier de modèle pour votre cas d'utilisation dans un éditeur de texte.
Pour vous assurer que la syntaxe de votre fichier de configuration JSON est correcte, utilisez un éditeur JSON.
Renseignez les valeurs des paramètres de configuration requis et, si vous le souhaitez, entrez des paramètres supplémentaires et leurs valeurs.
Par exemple, si vous souhaitez utiliser une attribution de DHCP IPv4 pour le réseau temporaire du nouveau dispositif, dans la sous-section temporary_network du modèle, remplacez la valeur du paramètre mode par dhcp et supprimez les paramètres de configuration par défaut correspondant à une attribution statique.
```
        "temporary_network": {
            "ip_family": "ipv4",
            "mode": "dhcp"
        },
```
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, "image":"G:\\vcsa\\VMware-vCenter-Server-Appliance-6.7.0.XXXX-YYYYYYY_OVF10.ova" définit le chemin d'accès G:\vcsa\VMware-vCenter-Server-Appliance-6.7.0.XXXX-YYYYYYY_OVF10.ova.

Les valeurs booléennes doivent contenir uniquement des caractères en minuscules, c'est-à-dire, qu'une valeur peut être true ou false. Par exemple, "ssh_enable":false.
(Facultatif) Utilisez un éditeur JSON de votre choix pour valider le fichier JSON.
Enregistrez-le au format UTF-8 et fermez-le.

Que faire ensuite

Vous pouvez créer et enregistrer des modèles supplémentaires au besoin, en fonction de votre spécification de mise à niveau.

Modèles JSON pour la mise à niveau de l'instance de vCenter Server Appliance via une interface de ligne de commande

Le programme d'installation du dispositif vCenter Server Appliance contient des modèles JSON situés dans le répertoire vcsa-cli-installer/templates. Dans le sous-dossier upgrade, vous trouverez le modèle JSON contenant les paramètres de configuration minimale de tous les types de mise à niveau.

À chaque type de mise à niveau correspond un modèle de déploiement du nouveau dispositif sur un hôte ESXi et un autre modèle de déploiement du nouveau dispositif sur une instance de vCenter Server.

Tableau 1. Modèles JSON de mise à niveau inclus dans le programme d'installation de vCenter Server Appliance
Emplacement	Modèle	Description
vcsa-cli-installer\templates\upgrade\vcsa\6.7	embedded_vCSA_on_ESXi.json	Contient les paramètres de configuration minimale requis pour la mise à niveau d'une instance de vCenter Server Appliance 6.7 avec une instance intégrée de Platform Services Controller vers une instance de vCenter Server Appliance 8.0 sur un hôte ESXi.
	embedded_vCSA_on_VC.json	Contient les paramètres de configuration minimale requis pour la mise à niveau d'une instance de vCenter Server Appliance 6.7 avec une instance intégrée de Platform Services Controller vers une instance de vCenter Server Appliance 8.0 sur une instance de vCenter Server.
	vCSA_on_ESXi.json	Contient les paramètres de configuration minimale requis pour la mise à niveau d'une instance de vCenter Server Appliance 6.7 avec une instance externe de Platform Services Controller vers une instance de vCenter Server Appliance 8.0 sur un hôte ESXi.
	vCSA_on_VC.json	Contient les paramètres de configuration minimale requis pour la mise à niveau d'une instance de vCenter Server Appliance 6.7 avec une instance externe de Platform Services Controller vers une instance de vCenter Server Appliance 8.0 sur une instance de vCenter Server.
vcsa-cli-installer\templates\upgrade\vcsa\7.0	embedded_vCSA_on_ESXi.json	Contient les paramètres de configuration minimale requis pour la mise à niveau d'une instance de vCenter Server Appliance 7.0 avec une instance intégrée de Platform Services Controller vers une instance de vCenter Server Appliance 8.0 sur un hôte ESXi.
vcsa-cli-installer\templates\upgrade\vcsa\7.0	embedded_vCSA_on_VC.json	Contient les paramètres de configuration minimale requis pour la mise à niveau d'une instance de vCenter Server Appliance 7.0 avec une instance intégrée de Platform Services Controller vers une instance de vCenter Server Appliance 8.0 sur une instance de vCenter Server.

À propos de la mise à niveau de vCenter Server avec une instance externe de Platform Services Controller à l'aide de l'interface de ligne de commande

Lorsque mettez à niveau une instance de vCenter Server Appliance qui utilise une instance externe de Platform Services Controller, celle-ci est convertie en une instance de vCenter Server avec les services intégrés au dispositif. Pour cette raison, vous devez spécifier les paramètres du partenaire de réplication dans les modèles de mise à niveau JSON.

Lors de la mise à niveau d'une instance de vCenter Server Appliance qui utilise une instance externe de Platform Services Controller, vous devez spécifier les paramètres du partenaire de réplication dans le modèle de mise à niveau JSON. Ces paramètres indiquent si la mise à niveau concerne l'un des scénarios de mise à niveau vCenter Server et Platform Services Controller suivants.

Une instance unique de vCenter Server et de Platform Services Controller dans un domaine SSO.
La première instance de vCenter Server et de Platform Services Controller dans un domaine SSO contenant plusieurs vCenter Server.
La réplication des instances de vCenter Server et de Platform Services Controller dans un domaine SSO, que vous devez pointer vers une instance de vCenter Server 7.0 existante en tant que partenaire de réplication.

Important : Il n'est pas possible de mettre à niveau une instance externe de Platform Services Controller. Le processus de mise à niveau converge les services de Platform Services Controller dans l'instance de vCenter Server Appliance. Pour plus d'informations, consultez Suppression de Platform Services Controller.

Les déploiements utilisant une instance externe de Platform Services Controller sont souvent appelés déploiement MxN, où M représente l'instance de vCenter Server et N représente l'instance externe de Platform Services Controller. Lors de la représentation de plusieurs instances de vCenter Server et de Platform Services Controller dans un domaine, cette valeur est exprimée sous la forme MnxNn, où n correspond au nombre d'instances. Par exemple, M2xN2 indique deux instances de vCenter Server et deux instances de Platform Services Controller dans le même domaine. Lors de la mise à niveau d'un tel déploiement, vous devez d'abord mettre à niveau une instance vers la version 8.0, puis mettre à niveau la deuxième instance vers la version 8.0, en spécifiant la première des deux instances en tant que partenaire de réplication.

Les paramètres de réplication dans le modèle de mise à niveau JSON se trouvent dans la section sso du modèle et sont first_instance et replication_partner_hostname.

Nom du paramètre	Description
`first_instance`	Le paramètre `first_instance` identifie vCenter Server en tant que première instance de votre domaine SSO vCenter Server ou en tant que partenaire de réplication. S'il s'agit de la première instance de vCenter Server, définissez `first_instance` sur `true`. Pour des instances supplémentaires de vCenter Server dans le même domaine SSO, définissez `first_instance` sur `false`.
`replication_partner_hostname` *	Si vous définissez `first_instance` sur `false`, vous devez spécifier le nom de domaine complet ou l'adresse IP d'une instance de vCenter Server qui a déjà été mise à niveau vers la version 8.0 et dont le PSC externe a été convergé dans l'instance de vCenter Server Appliance.

Lorsque vous effectuez la mise à niveau de l'interface de ligne de commande d'une seule instance de vCenter Server Appliance qui utilise une instance externe de Platform Services Controller, le processus est le suivant :

Mettez à niveau l'instance de vCenter Server dans votre topologie à l'aide du modèle vCSA_on_ESXi.json lors de la mise à niveau sur ESXi ou à l'aide du modèle vCSA_on_VC.json lors de la mise à niveau sur un déploiement de vCenter Server.
Pour une topologie de déploiement composée d'une instance unique de vCenter Server et d'une instance de Platform Services Controller (un déploiement M1xN1), modifiez la section sso du modèle de telle sorte que le paramètre first_instance soit défini sur true et supprimez le paramètre replication_partner_hostname.
```
"sso": {
"__comments": [ This is the first instance (M1) vCenter Server management node, with "first_instance" set to "true" and "replication_partner_hostname" removed.
],
"first_instance": true
}
```
Spécifiez les paramètres de configuration de la mise à niveau restants dans le modèle JSON et mettez à niveau vCenter Server vers la version 8.0 à l'aide de l'interface de ligne de commande. Reportez-vous à la section Mettre à niveau un dispositif vCenter Server Appliance à l'aide de l'interface de ligne de commande.
Après la mise à niveau réussie de vCenter Server, désaffectez l'instance de Platform Services Controller. Reportez-vous à la section Désaffectez Platform Services Controller..
Important : Désaffectez les instances de Platform Services Controller uniquement après la mise à niveau et la convergence de toutes les instances de vCenter Server dans votre topologie.

Pour un déploiement composé d'au moins deux instances de vCenter Server et de Platform Services Controller (un déploiement M2xN2), vous devez d'abord mettre à niveau l'instance de vCenter Server ( M1) vers la version 8.0, puis mettre à niveau la deuxième instance de vCenter Server pour la réplication.

Mettez à niveau les instances de vCenter Server dans votre déploiement à l'aide du modèle vCSA_on_ESXi.json lors de la mise à niveau sur ESXi ou à l'aide du modèle vCSA_on_VC.json lors de la mise à niveau sur un déploiement de vCenter Server.
Pour la première instance de vCenter Server ( M1), modifiez la section sso du modèle de telle sorte que le paramètre first_instance est défini sur true et supprimez le paramètre replication_partner_hostname.
```
"sso": {
"__comments": [ This is the first instance (M1) vCenter Server management node, with "first_instance" set to "true" and "replication_partner_hostname" removed.
],
"first_instance": true
}
```
Pour l'instance restante de vCenter Server ( M2), modifiez la section sso du modèle de telle sorte que le paramètre first_instance est défini sur false et fournissez le nom de domaine complet ou l'adresse IP de l'instance de vCenter Server vers laquelle vous souhaitez répliquer le deuxième nœud. Le partenaire de réplication est la première instance de vCenter Server ( M1) que vous avez mise à niveau vers la version 8.0, qui a été convergée avec son instance de Platform Services Controller.
```
"sso": {
"__comments": [ This is the second instance (M2) vCenter Server management node, with "first_instance" set to "false" and "replication_partner_hostname" set to the hostname of the replication partner.],
"first_instance": false,
"replication_partner_hostname": "FQDN_ou_adresse_IP"
```
Spécifiez les paramètres de configuration de la mise à niveau restants dans les modèles JSON et terminez la mise à niveau à l'aide de l'interface de ligne de commande. Reportez-vous à la section Mettre à niveau un dispositif vCenter Server Appliance à l'aide de l'interface de ligne de commande.
Après la mise à niveau réussie de toutes les instances de vCenter Server dans la topologie, désaffectez les instances de Platform Services Controller. Reportez-vous à la section Désaffectez Platform Services Controller..
Important : Désaffectez les instances de Platform Services Controller uniquement après la mise à niveau et la convergence de toutes les instances de vCenter Server dans votre topologie.

Paramètres de configuration de la mise à niveau pour la mise à niveau via l'interface de ligne de commande de vCenter Server Appliance

Lorsque vous préparez vos fichiers de configuration JSON pour la mise à niveau via l'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 la mise à niveau d'une instance de vCenter Server Appliance.

Sections et sous-sections des paramètres de configuration dans les fichiers de mise à niveau 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 2. Sections et sous-sections des paramètres de configuration dans les fichiers de mise à niveau JSON
Section	Sous-section	Description
`new_vcsa` : décrit le nouveau dispositif que vous souhaitez déployer.	`esxi`	À utiliser uniquement si vous souhaitez déployer le nouveau dispositif directement sur un hôte ESXi. Contient les paramètres de configuration qui décrivent l'hôte ESXi cible. Reportez-vous à la section Paramètres de configuration dans la section `new_vcsa`, sous-section `esxi`. Note : Vous devez renseigner cette sous-section ou la sous-section `vc`.
	`vc`	À utiliser uniquement si vous souhaitez déployer le nouveau 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 cette sous-section ou la sous-section `esxi`. L'instance de vCenter Server cible ne peut pas être le dispositif vCenter Server Appliance à mettre à niveau. En pareils cas, utilisez la sous-section `esxi`.
	`appliance`	Contient les paramètres de configuration qui décrivent le nouveau dispositif. Reportez-vous à la section Paramètres de configuration dans la section `new_vcsa`, sous-section `appliance`.
	`os`	Contient uniquement le paramètre de configuration `ssh_enable` permettant de définir la connexion de l'administrateur SSH au nouveau dispositif.
	`ovftool_arguments`	Facultatif. Utilisez cette sous-section pour ajouter des arguments arbitraires et leurs valeurs à la commande d'OVF Tool que le programme d'installation génère. Important : Le programme d'installation de vCenter Server Appliance 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.
	`temporary_network`	Contient le paramètre de configuration qui décrit les paramètres réseau temporaires du nouveau dispositif. Reportez-vous à la section Paramètres de configuration dans la section `new_vcsa`, sous-section `temporary_network`.
	`user_options`	Contient uniquement le paramètre de configuration `vcdb_migrateSet` permettant de définir les types de données que vous souhaitez transférer entre l'ancien dispositif et le nouveau. Reportez-vous à la section Paramètres de configuration dans la section `new_vcsa`, sous-section `user_options`.
`source_vc` : décrit le dispositif existant que vous souhaitez mettre à niveau.	`managing_esxi_or_vc`	Contient le paramètre de configuration qui décrit l'hôte ESXi source ou l'instance source de vCenter Server Appliance sur laquelle réside le dispositif à mettre à niveau. Reportez-vous à la section Paramètres de configuration dans la section `source_vc`, sous-section `managing_esxi_or_vc`.
	`vc_vcsa`	Contient les paramètres de configuration qui décrivent le dispositif source à mettre à niveau. Reportez-vous à la section Paramètres de configuration dans la section `source_vc`, sous-section `vc_vcsa`.
`source_vum` : décrit l'instance source de VMware Update Manager. Utilisez cette sous-section si vous souhaitez exécuter automatiquement l'assistant de migration sur l'instance de VMware Update Manager.	`run_migration_assistant`	Facultatif si l'instance source de vCenter Server Appliance à mettre à niveau est connectée à une instance de VMware Update Manager exécutée sur une machine virtuelle Windows. Utilisez cette sous-section si vous souhaitez exécuter automatiquement l'assistant de migration sur l'instance de VMware Update Manager source. Contient les paramètres de configuration qui décrivent l'instance de VMware Update Manager source qui sera migrée vers l'instance de vCenter Server Appliance récemment mis à niveau. Reportez-vous à la section Paramètres de configuration dans la section `source_vum`, sous-section `run_migration_assistant`. Note : Le dispositif Migration Assistant utilise le port 9123 par défaut. Si le port 9123 est utilisé par un autre service sur la machine Update Manager, Migration Assistant recherche automatiquement un autre port libre. Vous ne pouvez pas définir un port personnalisé pour Migration Assistant.
`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`. Requis uniquement si vous mettez à niveau une instance de vCenter Server Appliance avec une instance intégrée de Platform Services Controller ou un dispositif de Platform Services Controller. Note : Si le paramètre de configuration `ceip_enabled` est défini 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, "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 doivent contenir uniquement des caractères en minuscules. Peut être true ou false. Par exemple, "ssh_enable":false.

Paramètres de configuration dans la section `new_vcsa`

Tableau 3. Paramètres de configuration dans la section `new_vcsa`, sous-section `esxi`
Nom	Type	Description
`hostname`	string	L'adresse IP ou le nom de domaine complet de l'hôte ESXi cible sur lequel vous souhaitez déployer le nouveau 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 récemment mis à niveau. Le réseau doit faire partie de la configuration réseau de l'hôte ESXi cible ou de l'instance cible de vCenter Server Appliance (et identifié par le paramètre de configuration `managing_esxi_or_vc`). Note : Le réseau doit être accessible à partir de l'hôte ESXi source ou de l'instance source de vCenter Server Appliance (et identifié par le paramètre de configuration `managing_esxi_or_vc`) sur lequel réside le dispositif à mettre à niveau. Le réseau doit être également accessible depuis la machine client à partir de laquelle vous effectuez la mise à niveau. Ignoré si l'hôte ESXi cible dispose d'un seul réseau.
`datastore`	string	Le nom de la banque de données dans laquelle stocker les fichiers de configuration des machines virtuelles et les disques virtuels du nouveau dispositif. La banque de données doit être disponible à l'hôte ESXi cible. Note : La banque de données doit disposer d'au moins 25 Go d'espace libre.
`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é.
`ssl_certificate_verification`	string	L'interface de ligne de commande vérifie que le certificat de sécurité d'un serveur est signé par une autorité de certification (CA) et établit une connexion sécurisée. Si le certificat est auto-signé, l'interface de ligne de commande arrête la mise à niveau, sauf si vous spécifiez l'une des options de configuration du certificat SSL suivantes : Spécifiez l'empreinte du certificat Secure Hash Algorithm 1 (SHA-1). Une empreinte de certificat est une chaîne hexadécimale qui identifie un certificat de façon unique. L'empreinte numérique est calculée à partir du contenu du certificat à l'aide d'un algorithme d'empreinte. "thumbprint": "`certificate SHA-1 thumbprint`" Définissez la valeur `verification_mode` sur `NONE`. "verification_mode": "NONE" Si vous vous connectez à un serveur avec un certificat auto-signé, mais que vous ne parvenez pas à spécifier l'empreinte numérique de certificat SHA-1 ou à définir le mode de vérification sur `NONE`, l'interface de ligne de commande affiche l'empreinte numérique du certificat auto-signé du serveur et vous invite à accepter ou à refuser l'empreinte numérique de certificat. Vous pouvez également spécifier que l'interface de ligne de commande ignore le certificat auto-signé utilisant le paramètre `--no-ssl-certificate-validation`de la commande vcsa-deploy upgrade. Reportez-vous à la section Syntaxe de la commande de mise à niveau via l'interface de ligne de commande.

Tableau 4. Paramètres de configuration dans la section `new_vcsa`, sous-section `vc`
Nom	Type	Description
`hostname`	string	Adresse IP ou le nom de domaine complet de l'instance de vCenter Server cible sur lequel vous souhaitez déployer le nouveau 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 récemment mis à niveau. Le réseau doit faire partie de la configuration réseau de l'hôte ESXi ou du cluster DRS cible. Note : Le réseau doit être accessible à partir de l'hôte ESXi source sur lequel réside le dispositif à mettre à niveau. Le réseau doit être également accessible depuis la machine client à partir de laquelle vous effectuez la mise à niveau. 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 nouveau dispositif. Si le centre de données est situé dans un dossier ou une structure de dossiers, spécifiez la valeur sous forme d'une liste de chaînes séparées par des virgules. Par exemple, ["parent_folder", "child_folder", "datacenter_name"] S'il n'existe aucun chemin d'accès au dossier sur le centre de données, utilisez le nom du centre de données uniquement. Par exemple, ["datacenter_name"] ou "datacenter_name" Note : La valeur est sensible à la casse.
`datastore`	string	Nom de la banque de données dans laquelle vous souhaitez stocker tous les fichiers de configuration des machines virtuelles et les disques virtuels du nouveau dispositif. Note : La banque de données doit être disponible à 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	Le cluster, l'hôte ESXi ou le pool de ressources cible sur lequel vous souhaitez déployer le nouveau dispositif. Il s'agit de la cible spécifiée avec le paramètre `datacenter`. Ce chemin d'accès doit se terminer par un nom de cluster, un nom d'hôte ESXi ou un nom de pool de ressources. 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. Note : Toutes les valeurs sont sensibles à la casse. Si vous voulez que le dispositif déployé soit répertorié dans un emplacement différent au sein de la hiérarchie du centre de données, utilisez le paramètre vm_folder décrit ci-après dans cette section. Si le cluster, l'hôte ESXi ou le pool de ressources cible se trouve dans un dossier ou une structure de dossiers, spécifiez la valeur sous forme de liste de chaînes séparées par des virgules. 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"] Si vous déployez vers un pool de ressources, ajoutez l'étiquette Resources avant le nom du pool de ressources. Par exemple : ["cluster_name", "Resources", "resource_pool_name"] Note : Les prévérifications ne concernent que la mémoire du pool de ressources.
`vm_folder`	string	Facultatif. Nom du dossier de machine virtuelle (VM) dans lequel ajouter le nouveau dispositif.

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 nouveau dispositif avec des disques virtuels dynamiques.
`deployment_option`	string	Taille du nouveau dispositif. Note : Vous devez considérer la taille de base de données du dispositif à mettre à niveau. Pour une base de données externe, reportez-vous à Déterminer la taille de la base de données Oracle et celle du stockage pour le nouveau 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, 10 Go de mémoire et 300 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, 10 Go de mémoire et 825 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, 10 Go de mémoire et 1 700 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, 16 Go de mémoire et 340 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, 16 Go de mémoire et 870 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, 16 Go de mémoire et 1 750 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, 24 Go de mémoire et 525 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, 24 Go de mémoire et 1 025 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, 24 Go de mémoire et 1 905 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, 32 Go de mémoire et 740 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, 32 Go de mémoire et 1 090 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, 32 Go de mémoire et 1 970 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, 48 Go de mémoire et 1 180 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, 48 Go de mémoire et 1 230 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, 48 Go de mémoire et 2 110 Go de stockage. Définissez sur `management-tiny` si vous souhaitez déployer une instance de vCenter Server Appliance avec une instance externe de Platform Services Controller pour jusqu'à 10 hôtes et 100 machines virtuelles avec la taille de stockage par défaut. Déploie un dispositif comportant 2 CPU, 10 Go de mémoire et 300 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 nouveau 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.
`license`	string	Facultatif. Clé de licence à appliquer au dispositif . Si la clé de licence n'est pas fournie . La licence d'évaluation sera utilisée .

Tableau 6. Paramètres de configuration dans la section `new_vcsa`, sous-section `temporary_network`
Nom	Type	Description
`ip_family`	string	Version IP du réseau temporaire du nouveau dispositif. Définissez sur `ipv4` ou `ipv6`.
`mode`	string	Attribution IP du réseau temporaire du nouveau dispositif. Définissez sur `static` ou `dhcp`.
`ip`	string	Adresse IP temporaire du nouveau 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 qui correspond à la version IP réseau temporaire, 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 de plusieurs serveurs DNS du réseau temporaire du nouveau dispositif. 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" Requis uniquement si vous utilisez le mode de réseau statique pour l'allocation de l'adresse IP temporaire, c'est-à-dire, si vous définissez le paramètre `mode` sur `static`.
`prefix`	string	Longueur du préfixe réseau du réseau temporaire du nouveau dispositif. À 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 du réseau temporaire du nouveau dispositif. Pour la version IPv6, la valeur peut être `default`.

Tableau 7. Paramètres de configuration dans la section `new_vcsa`, sous-section `user_options`
Nom	Type	Description
`vcdb_migrateSet`	string	Sélectionnez les types de données à migrer de l'ancien dispositif vers le nouveau. Les données sont copiées à partir de l'instance source de vCenter Server vers le serveur cible. La source d'origine des données reste inchangée. Définissez sur `core` si vous souhaitez transférer uniquement les données de configuration. Cette option permet la migration des données la plus rapide, tout en limitant au minimum les arrêts du système. Définissez sur `core_events_tasks` si vous souhaitez transférer immédiatement les données de configuration et d'historique (événements et tâches). vCenter Server ne démarre pas tant que toutes les données ne sont pas migrées depuis l'instance source de vCenter Server Appliance. Définissez sur `all` si vous souhaitez transférer immédiatement les données de configuration, d'historique et de mesures des performances. vCenter Server ne démarre pas tant que toutes les données ne sont pas migrées depuis l'instance source de vCenter Server pour Windows. Cette option transfère la plus grande quantité de données et nécessite un temps d'interruption plus long que les autres options de migration des données. Définissez sur `transfer_events_tasks_after_upgrade` si vous souhaitez transférer les données d'historique (événements et tâches) en arrière-plan une fois la mise à niveau terminée. Pendant cette opération, les performances de vCenter Server peuvent ne pas être optimales. Définissez sur `transfer_stats_events_tasks_after_upgrade` si vous souhaitez transférer les données d'historique et les données de mesures de performances en arrière-plan une fois la mise à niveau terminée. Pendant cette opération, les performances de vCenter Server peuvent ne pas être optimales. Note : Pour réduire la durée de la mise à niveau et la quantité de stockage nécessaire pour la nouvelle instance de vCenter Server Appliance, utilisez la valeur `core`. Pour plus d'informations sur les types de données que vous pouvez transférer à partir de votre instance de vCenter Server vers la nouvelle instance de vCenter Server mise à niveau, reportez-vous à la section Transfert des données à partir d'une instance de vCenter Server Appliance existante.

Tableau 8. Paramètres de configuration dans la section `new_vcsa`, sous-section `sso`
Nom	Type	Description
`first_instance`	string	Définissez `first_instance` sur `true` s'il s'agit de la première opération de mise à niveau convergente dans votre domaine SSO vCenter Server ou si vous ne souhaitez pas définir le partenaire de réplication pour ce nœud. Si vous souhaitez définir le partenaire de réplication pour ce nœud, définissez `first_instance` sur `false` et fournissez la valeur de `replication_partner_hostname` comme nom de domaine complet d'un nœud précédemment convergé qui est actuellement dans une topologie vCenter Server intégrée. Pour plus d'informations sur la spécification des paramètres `first_instance` et `replication_partner_hostname`, reportez-vous à la section À propos de la mise à niveau de vCenter Server avec une instance externe de Platform Services Controller à l'aide de l'interface de ligne de commande.
`replication_partner_hostname`	string	Nom d'hôte du partenaire de réplication. Supprimer s'il s'agit de `first_instance`.

Paramètres de configuration dans la section `source_vc`

Tableau 9. Paramètres de configuration dans la section `source_vc`, sous-section `managing_esxi_or_vc`
Nom	Type	Description
`hostname`	string	Adresse IP ou nom de domaine complet de l'hôte ESXi ou vCenter Server source sur lequel réside le dispositif à mettre à niveau.
`username`	string	Nom d'utilisateur disposant de privilèges administratifs sur l'hôte ESXi source, par exemple, « root ».
`password`	string	Mot de passe de l'utilisateur disposant de privilèges administratifs sur l'hôte ESXi source.
`port`	entier	Port proxy inversé HTTPS de l'hôte ESXi source. Le port par défaut est 443. À utiliser uniquement si l'hôte ESXi source utilise un port proxy inversé HTTPS personnalisé.

Tableau 10. Paramètres de configuration dans la section `source_vc`, sous-section `vc_vcsa`
Nom	Type	Description
`hostname`	string	Entrez l'adresse IP ou le nom de domaine complet du dispositif source à mettre à niveau.
`username`	string	Utilisateur administrateur de vCenter Single Sign-On sur le dispositif source, par exemple, [email protected]. Important : L'utilisateur doit être administrator@ `your_domain_name`.
`password`	string	Mot de passe de l'utilisateur administrateur de vCenter Single Sign-On sur le dispositif source.
`root_password`	string	Mot de passe de l'utilisateur racine du système d'exploitation du dispositif source.
`export_dir`	string	Répertoire d'exportation des données et de la configuration sources.

Paramètres de configuration dans la section `source.vum`

Tableau 11. Paramètres de configuration dans la section `source_vum`, sous-section `run_migration_assistant`
Nom	Type	Description
`esxi_hostname`	string	Adresse IP ou nom de domaine complet de l'hôte ESXi sur lequel réside l'instance de VMware Update Manager source. Si un nom de domaine complet est fourni, il doit pouvoir être résolu sur la machine client depuis laquelle vous exécutez la mise à niveau.
`esxi_username`	string	Nom d'utilisateur disposant de privilèges administratifs sur l'hôte ESXi, par exemple, « root ».
`esxi_password`	string	Mot de passe de l'utilisateur disposant de privilèges administratifs sur l'hôte ESXi.
`esxi_port`	string	Port proxy inversé HTTPS de l'hôte ESXi. Le port par défaut est 443. À utiliser uniquement si l'hôte ESXi utilise un port proxy inversé HTTPS personnalisé.
`vum_hostname`	string	Adresse IP ou nom de domaine complet de la machine virtuelle Windows sur laquelle l'instance source de VMware Update Manager est exécutée. Si un nom de domaine complet est fourni, il doit pouvoir être résolu sur la machine client depuis laquelle vous exécutez la mise à niveau.
`vum_os_username`	string	Nom d'utilisateur administrateur de la machine virtuelle Windows sur laquelle l'instance source de VMware Update Manager est exécutée.
`vum_os_password`	string	Mot de passe administrateur de la machine virtuelle Windows sur laquelle l'instance source de VMware Update Manager est exécutée. S'il n'est pas indiqué, vous êtes invité à entrer le mot de passe sur la console de commande lors de la vérification du modèle.
`export_dir`	string	Répertoire d'exportation des données et de la configuration sources.

Paramètres de configuration dans la section `ceip`

Tableau 12. 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) pour le dispositif récemment mis à niveau.