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'un dispositif vCenter Server Appliance ou Platform Services Controller.
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.
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
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 |
|
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
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 de vCenter Server Appliance source 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 le dispositif vCenter Server Appliance récemment mis à niveau. Reportez-vous à la section Paramètres de configuration dans la section
Note : Le dispositif
Migration Assistant utilise le port 9123 par défaut. Si le port 9123 est utilisé par un autre service sur votre 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 Requis uniquement si vous mettez à niveau un dispositif vCenter Server Appliance avec une instance intégrée de Platform Services Controller ou un dispositif 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. |
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. Peut être true
ou false
. Par exemple, "ssh_enable":false
.
Paramètres de configuration dans la section new_vcsa
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 vCenter Server Appliance cible (et identifié par le paramètre de configuration
Note : Le réseau doit être accessible à partir de l'hôte
ESXi source ou de l'instance
vCenter Server Appliance source (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êtera 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": "empreinte de certificat SHA-1" Définissez la valeur "verification_mode": "NONE" Si vous vous connectez à un serveur avec un certificat auto-signé, mais que vous ne parvenez pas à spécifier l'empreinte de certificat SHA-1 ou à définir le mode de vérification sur Vous pouvez également spécifier que l'interface de ligne de commande ignore le certificat auto-signé utilisant le paramètre |
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 |
chaîne ou groupe | Le centre de données vCenter Server doit contenir 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, la valeur doit être 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. Par exemple,
["parent_folder", "child_folder", "datacenter_name"]ou "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 |
chaîne ou groupe | 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
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-dessous.
Si le cluster, l'hôte
ESXi ou le pool de ressources cible est situé dans un dossier ou une structure de dossiers, la valeur doit être 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. Par exemple,
["parent_folder", "child_folder", "esxi-host.domain.com"]ou "parent_folder, child_folder, esxi-host.domain.com"
Si l'hôte
ESXi cible fait partie d'un cluster, 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,
["cluster_name", "esxi-host.domain.com"]ou "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 dans lequel ajouter le nouveau dispositif. |
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.
|
image |
string | Facultatif. Chemin d'accès au fichier local ou URL vers le package 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. |
Nom | Type | Description |
---|---|---|
ip_family |
string | Version IP du réseau temporaire du nouveau dispositif. Définissez sur |
mode |
string | Attribution IP du réseau temporaire du nouveau dispositif. Définissez sur |
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 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 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 |
prefix |
string | Longueur du préfixe réseau du réseau temporaire du nouveau dispositif. À 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 du réseau temporaire du nouveau dispositif. Pour la version IPv6, la valeur peut être |
Nom | Type | Description |
---|---|---|
vcdb_migrateSet |
string | Sélectionnez les types de données à migrer de l'ancien dispositif vers le nouveau. Les données seront copiées à partir de l'instance source de vCenter Server vers le serveur cible. La source d'origine des données reste inchangée.
Note : Pour réduire la durée de la mise à niveau et la quantité de stockage nécessaire pour le nouveau dispositif 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 système vCenter Server vers le nouveau vCenter Server mis à niveau, reportez-vous à la section Transfert des données à partir d'un dispositif vCenter Server Appliance existant. |
Paramètres de configuration dans la section source_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é. |
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
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
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. |