Vous pouvez utiliser le programme d'installation de l'interface de ligne de commande pour migrer automatiquement une instance de vCenter Server ou Platform Services Controller de Windows vers un dispositif.

Le fichier ISO du programme d'installation contient des exemples de modèles de fichiers JSON contenant les paramètres de configuration minimale qui sont requis pour migrer une instance de vCenter Server ou Platform Services Controller de Windows vers un dispositif. Les exemples de modèles se trouvent dans le répertoire vcsa-cli-installer/templates/migrate.

Note : Avant de migrer un déploiement de vCenter Server avec une instance externe de Platform Services Controller, vous devez d'abord converger l'instance externe de Platform Services Controller vers une instance intégrée de Platform Services Controller, puis effectuer la migration. Voir l’article KB 68137 de la base de connaissances.

Tâches de l'interface de ligne de commande pour migrer votre installation de vCenter Server de Windows vers un dispositif :

  1. Télécharger et monter le programme d'installation de vCenter Server.
  2. Télécharger et exécuter l'VMware Migration Assistant sur la machine Windows source.
  3. Préparer vos fichiers de configuration JSON pour la migration au moyen de la ligne de commande.
  4. Exécutez les contrôles préalables avant d'effectuer la migration.
  5. Effectuer une migration de vCenter Server à l'aide de l'interface de ligne de commande à partir de Windows vers un dispositif.

Vous pouvez exécuter plusieurs fois le programme d'installation de l'interface de ligne de commande avec différents fichiers JSON pour effectuer plusieurs migrations par interface de ligne de commande. Vous pouvez également exécuter simultanément plusieurs migrations par interface de ligne de commande en mode de traitement par lot.

Important : Le nom d'utilisateur que vous utilisez pour vous connecter à la machine à partir de laquelle vous souhaitez exécuter le programme d'installation de la CLI, le chemin d'accès au programme d'installation de l'instance de vCenter Server Appliance, le chemin d'accès à votre fichier de configuration JSON et les valeurs de chaîne de votre fichier de configuration JSON, y compris 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.

Préparer vos fichiers de configuration JSON pour la migration au moyen de la ligne de commande

Lorsque vous utilisez l'interface de ligne de commande pour faire migrer une installation vCenter Server source vers un système vCenter Server Appliance cible, vous devez préparer un modèle JSON reprenant les valeurs de configuration du nouveau dispositif.

Vous pouvez faire migrer les instances de vCenter Server ou de Platform Services Controller depuis Windows vers un dispositif vCenter Server Appliance en définissant les valeurs en fonction des paramètres de configuration des modèles qui sont disponibles dans le fichier ISO du programme d'installation. Les paramètres de configuration qui ne sont pas inclus dans les modèles sont définis sur leurs valeurs par défaut. Vous pouvez ajouter des paramètres de configuration aux modèles pour définir leurs valeurs en fonction de vos spécifications de migration.

Le répertoire vcsa-cli-installer/templates/migrate contient des exemples de modèles de migration des instances de vCenter Server 6.7 vers un dispositif au moyen de l'interface de ligne de commande.

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 migrate --template-help.
Important : Le nom d'utilisateur que vous utilisez pour vous connecter à la machine à partir de laquelle vous souhaitez exécuter le programme d'installation de l'interface de ligne de commande, le chemin d'accès au programme d'installation du dispositif vCenter Server Appliance, le chemin d'accès à votre fichier de configuration JSON et les valeurs de chaîne de votre fichier de configuration JSON, y compris 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 effectuer la migration par lot, placez les modèles JSON de définition de votre déploiement dans un répertoire unique. Lorsqu'il est appelé, le programme d'installation de l'interface de ligne de commande migre votre déploiement existant vers la nouvelle version de vCenter Server à l'aide de la topologie définie dans les modèles JSON.

Conditions préalables

Assurez-vous que votre environnement répond aux conditions requises pour la migration. Reportez-vous à Configuration système requise pour la migration de déploiements vCenter Server vers des déploiements vCenter Server Appliance.

Préparez votre environnement pour la migration. Reportez-vous à la section Préparation de la migration.

Procédure

  1. Ouvrez le sous-dossier migrate du répertoire vcsa-cli-installer/templates.
  2. Copiez le modèle de migration du sous-dossier install vers votre espace de travail. Pour vCenter Server 6.7, utilisez le dossier migrate/winvc6.7/.
  3. 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.
  4. Renseignez les valeurs des paramètres de configuration requis et, si vous le souhaitez, entrez des paramètres supplémentaires et leurs valeurs.
    Important : Pour définir une valeur contenant le caractère de barre oblique inverse (\) ou de guillemets ("), vous devez faire précéder le caractère du caractère de barre oblique inverse (\). Par exemple, "password":"my\"password" définit le mot de passe my"password, "image":"C:\\vmware\\vcsa" définit le chemin C:\vmware\vcsa.

    Les valeurs booléennes doivent contenir uniquement des caractères en minuscules. Peut être true ou false. Par exemple, "ssh_enable":false

  5. Enregistrez-le au format UTF-8 et fermez-le.

Résultats

Votre fichier est prêt pour la migration.

Que faire ensuite

Vous pouvez créer et enregistrer autant de modèles que nécessaire en fonction de votre environnement. Lorsque votre modèle est prêt, exécutez la pré-vérification avant de l'utiliser pour la migration. Reportez-vous à la section Exécuter une prévérification avant une migration au moyen de la ligne de commande vers vCenter Server Appliance.

Modèles JSON pour la migration de l'interface de ligne de commande de vCenter Server pour Windows

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

Tableau 1. Modèles JSON de migration inclus dans le programme d'installation de vCenter Server
Emplacement Modèle Description
vcsa-cli-installer\templates\migrate\vcsa\winvc6.7 embedded_win_vc_to_embedded_vCSA_on_ESXi.json Contient les paramètres de configuration minimale requis pour migrer vCenter Server 6.7 sous Windows avec une instance intégrée de Platform Services Controller vers un dispositif vCenter Server Appliance 8.0 sur un hôte ESXi.
embedded_win_vc_to_embedded_vCSA_on_VC.json Contient les paramètres de configuration minimale requis pour migrer vCenter Server 6.7 sous Windows avec une instance intégrée de Platform Services Controller vers un dispositif vCenter Server Appliance 8.0 sur une instance de vCenter Server.
win_vc_to_vCSA_on_ESXi.json Contient les paramètres de configuration minimale requis pour migrer vCenter Server 6.7 sous Windows avec une instance externe de Platform Services Controller vers un dispositif vCenter Server Appliance 8.0 sur un hôte ESXi.
win_vc_to_vCSA_on_VC.json.json Contient les paramètres de configuration minimale requis pour migrer vCenter Server 6.7 sous Windows avec une instance externe de Platform Services Controller vers un dispositif vCenter Server Appliance 8.0 sur une instance de vCenter Server.

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

Lors de la migration d'une instance de vCenter Server pour Windows 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 migration JSON.

Lors de la migration d'une instance de vCenter Server pour Windows 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 migration JSON. Ces paramètres indiquent si la migration concerne l'un des scénarios de migration 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 : Avant de migrer un déploiement de vCenter Server à l'aide d'une instance externe de Platform Services Controller, vous devez d'abord converger l'instance externe de Platform Services Controller vers une instance intégrée de Platform Services Controller, puis effectuer la migration. 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 migration d'un tel déploiement, vous devez d'abord migrer une instance vers la version 8.0, puis migrer 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 migration 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é migrée vers la version 8.0 et dont le PSC externe a été convergé dans l'instance de vCenter Server Appliance.

Lorsque vous effectuez la migration de l'interface de ligne de commande d'une seule instance de vCenter Server pour Windows qui utilise une instance externe de Platform Services Controller, le processus est le suivant :
  1. Migrez les instances de vCenter Server dans votre topologie à l'aide du modèle win_vc_to_vCSA_on_ESXi.json lors de la migration sur ESXi ou à l'aide du modèle win_vc_to_vCSA_on_VC.json lors de la migration sur un déploiement de vCenter Server.

  2. 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
    }
  3. Spécifiez les paramètres de configuration restants dans le modèle JSON et migrez vCenter Server vers la version 8.0 à l'aide de l'interface de ligne de commande. Reportez-vous à la section Effectuer une migration de vCenter Server à l'aide de l'interface de ligne de commande à partir de Windows vers un dispositif.
  4. Après la migration 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 migration 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 migrer l'instance M1 de vCenter Server vers la version  8.0, puis migrer la deuxième instance de vCenter Server pour la réplication.
  1. Migrez les instances de vCenter Server dans votre topologie à l'aide du modèle win_vc_to_vCSA_on_ESXi.json lors de la migration sur ESXi ou à l'aide du modèle win_vc_to_vCSA_on_VC.json lors de la migration sur un déploiement de vCenter Server.

  2. 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
    }
  3. 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 migrée 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_or_IP_address"
  4. Spécifiez les paramètres de configuration restants dans les modèles JSON et migrez vCenter Server vers la version 8.0 à l'aide de l'interface de ligne de commande. Reportez-vous à la section Effectuer une migration de vCenter Server à l'aide de l'interface de ligne de commande à partir de Windows vers un dispositif.
  5. Après la migration 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 migration et la convergence de toutes les instances de vCenter Server dans votre topologie.

Paramètres de configuration d'une migration

Lorsque vous utilisez le programme d'installation de l'interface de ligne de commande pour migrer votre installation vCenter Server vers un dispositif, vous devez fournir les paramètres comprenant les valeurs pour la spécification de votre migration.

Le tableau répertorie les paramètres de configuration que vous utilisez pour fournir les données d'entrées pour l'instance de vCenter Server source.

Important : Le chemin d'accès au programme d'installation de vCenter Server Appliance, le chemin d'accès à votre fichier de configuration JSON et les valeurs de chaîne de votre fichier de configuration JSON, y compris 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 le caractère de barre oblique inverse (\) ou de guillemets ("), vous devez faire précéder le caractère du caractère de barre oblique inverse (\). Par exemple, "password":"my\"password" définit le mot de passe my"password, "image":"C:\\vmware\\vcsa" définit le chemin C:\vmware\vcsa.

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.

Sections et sous-sections des paramètres de configuration dans les modèles de migration JSON

Les paramètres de configuration dans les modèles de migration JSON sont répartis par sections et par sous-sections.

Tableau 2. Sections et sous-sections des paramètres de configuration dans les modèles de migration JSON
Section Sous-section Description
new_vcsa - décrit le nouveau dispositif cible que vous souhaitez migrer 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.
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.

Note : Vous devez renseigner la sous-section vc ou esxi.
appliance Contient les paramètres de configuration qui décrivent le dispositif.
os Contient les paramètres de configuration qui décrivent les paramètres du système d'exploitation du dispositif.
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 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 les paramètres de configuration qui décrivent le réseau temporaire pour migrer les données du dispositif source vers le nouveau dispositif cible.
user-options À utiliser uniquement si la source est une instance de vCenter Server. Contient les paramètres de configuration qui vous permettent de contrôler les aspects du processus de migration pour des composants spécifiques.
source_vc - décrit l'instance source de vCenter Server, vCenter Single Sign-On ou Platform Services Controller vc_win Contient les paramètres de configuration qui décrivent l'installation Windows source de vCenter Server ou de Platform Services Controller
run_migration_assistant À utiliser uniquement si l'installation Windows source s'exécute en tant que machine virtuelle et que vous souhaitez automatiser l'invocation de l'assistant de migration. Pour une installation Windows source s'exécutant sur une machine physique, ou si vous exécutez l'assistant de Migration manuellement sur la machine Windows source, copiez et collez la valeur de l'empreinte de la sortie de la console de l'assistant de migration sur la machine source dans la clé migration_ssl_thumbprint de la sous-section vc_win et supprimez la section run_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).

Uniquement requis si vous déployez une instance de vCenter Server.

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.

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 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 tous les fichiers de configuration de machine virtuelle et les disques virtuels du dispositif.
Note : La banque de données doit être accessible à partir de l'hôte ESXi.

La banque de données doit disposer de suffisamment d'espace libre.

port entier Numéro de port de l'hôte ESXi. Le port par défaut est 443.
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": "empreinte de certificat SHA-1"

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 migration 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 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 chaîne ou groupe 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, 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 de machine virtuelle 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 Numéro de port de l'instance de vCenter Server. Le port par défaut est 443.
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 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 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 (VM) dans lequel ajouter le 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 dispositif avec des disques virtuels dynamiques.
deployment_option string Taille du dispositif.
  • Définissez sur tiny si vous souhaitez déployer une instance de 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 une instance de 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 une instance de 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 une instance de 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 une instance de 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 une instance de 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 une instance de 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 une instance de 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 une instance de 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 une instance de 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 vCenter Server Appliance pour un maximum de 1 000 hôtes et 10 000 machines virtuelles avec la taille de grand 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 une instance de 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 une instance de 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 une instance de 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 une instance de 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.

image string Facultatif. Chemin d'accès au fichier local ou URL vers le module d'installation de l'instance de 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 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.

ssh_enable Booléen Définissez sur true pour autoriser l'administrateur SSH à se connecter au dispositif.
Tableau 7. Paramètres de configuration dans la section new_vcsa, sous-section temporary_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"

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

prefix string Longueur du préfixe de réseau.

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

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.

Tableau 8. 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. Cela permet la migration des données la plus rapide, tout en limitant au minimum l'interruption 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 pour Windows.
  • 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 les temps de migration et la quantité de stockage nécessaire pour le nouveau 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 9. 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 migration 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 migration de vCenter Server pour Windows 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

Configuration requise pour l'invocation automatique de l'assistant de migration

Vous utilisez la sous-section run_migration_assistant pour automatiser l'invocation de l'assistant de migration. L'invocation automatique fonctionne uniquement si l'installation Windows source s'exécute en tant que machine virtuelle.

Le compte d'utilisateur que vous spécifiez dans les paramètres os_username ou vum_os_username nécessite une élévation des privilèges vers les privilèges d'administrateur. Par exemple :
  • Le compte d'administrateur Windows intégré.
  • Un compte d'utilisateur avec un nom d'utilisateur autre que Administrateur, qui est un membre du groupe d'administrateurs Windows local.
  • Le compte d'administrateur de domaine avec le nom d'utilisateur Administrateur, qui est un membre du groupe d'administrateurs Windows local.
  • L'ID du nom d'utilisateur doit être au format your_domain_name\\user_ID ou user_ID@your_domain_name.
Restriction : L'invocation automatique de l'assistant de migration ne fonctionne pas avec un compte Windows qui nécessite une élévation des privilèges vers les privilèges d'administrateur. Exécutez plutôt l'assistant de migration manuellement sur la machine Windows source. Copiez et collez la valeur de l'empreinte numérique de la sortie de la console de l'assistant de migration sur la machine source dans la clé migration_ssl_thumbprint de la sous-section vc_win et supprimez la section run_migration_assistant.

Paramètres de configuration dans la section source_vc

Tableau 10. Paramètres de configuration dans la section source_vc, sous-section vc_win
Nom Type Description
hostname string Nom d'hôte ou adresse IP de l'installation Windows source de vCenter Server ou de Platform Services Controller que vous souhaitez migrer.
username string Nom d'un utilisateur vCenter Single Sign-On avec des privilèges administratifs pour l'instance de vCenter Server, de vCenter Single Sign-On ou de Platform Services Controller que vous souhaitez migrer.
password string Mot de passe de l'instance de vCenter Server ou de Platform Services Controller que vous souhaitez migrer.
migration_port string Numéro de port de l'assistant de migration affichée sur la console de l'assistant de migration. Le port par défaut est 9123.
active_directory_domain string Nom du domaine Active Directory auquel l'instance source de vCenter Server est jointe.
active_directory_username string Nom d'utilisateur de l'administrateur du domaine Active Directory auquel l'instance source de vCenter Server est jointe.
active_directory_password string Mot de passe de l'administrateur du domaine Active Directory auquel l'instance source de vCenter Server est jointe.
Note : Le programme d'installation vérifie les informations d'identification saisies, mais ne contrôle pas les privilèges requis pour ajouter la machine cible au domaine Active Directory. Vérifiez que les informations d'identification utilisateur contiennent toutes les autorisations requises pour ajouter une machine au domaine Active Directory.
migration_ssl_thumbprint string Empreinte SSL de l'assistant de migration.
Tableau 11. Paramètres de configuration dans la section source_vc, sous-section run_migration_assistant
Nom Type Description
esxi_hostname string Nom de domaine complet ou adresse IP de l'instance de ESXi sur lequel l'instance source de vCenter Server, de vCenter Single Sign-On ou de Platform Services Controller réside.
esxi_username string Nom d'utilisateur d'un utilisateur disposant des privilèges administratifs sur l'hôte ESXi.
esxi_password string Mot de passe de l'utilisateur de l'hôte ESXi. Si vous avez omis le mot de passe, vous êtes invité à l'entrer sur la console de commande lors de la vérification du modèle.
esxi_port string Numéro de port de l'hôte ESXi. Le port par défaut est 443.
os_username string Nom d'utilisateur de l'administrateur pour la machine Windows source.
os_password string Mot de passe d'utilisateur de l'administrateur pour la machine Windows source. Si vous avez omis le mot de passe, vous êtes invité à l'entrer sur la console de commande lors de la vérification du modèle.
migration_ip string Adresse IP de l'adaptateur réseau à migrer.
migration_port string Numéro de port de l'assistant de migration affichée sur la console de l'assistant de migration. Le port par défaut est 9123.
export_dir string Répertoire d'exportation des données et de la configuration sources.
sa_password string Adresse IP du mot de passe d'utilisateur du compte de service vCenter Server de réseau. Cette option est requise uniquement si le service vCenter Server s'exécute sous un compte autre que LocalSystem. Si vous avez omis le mot de passe, vous êtes invité à l'entrer sur la console de commande lors de la vérification du modèle.
Tableau 12. Paramètres de configuration dans la section source_vum, sous-section run_migration_assistant
Nom Type Description
esxi_hostname string Nom de domaine complet ou adresse IP de l'instance de ESXi sur lequel l'instance source de vCenter Server, de vCenter Single Sign-On ou de Platform Services Controller réside.
esxi_username string Nom d'utilisateur d'un utilisateur disposant des privilèges administratifs sur l'hôte ESXi.
esxi_password string Mot de passe de l'utilisateur de l'hôte ESXi. Si vous avez omis le mot de passe, vous êtes invité à l'entrer sur la console de commande lors de la vérification du modèle.
esxi_port string Numéro de port de l'hôte ESXi. Le port par défaut est 443.
vum_hostname string Nom de domaine complet ou adresse IP de l'instance de ESXi sur lequel l'instance source de Update Manager réside.
vum_os_username string Nom d'utilisateur de l'administrateur pour la machine Windows source.
vum_os_password string Mot de passe d'utilisateur de l'administrateur pour la machine Windows Update Manager source. Si vous avez omis le mot de passe, vous êtes invité à l'entrer sur la console de commande lors de la vérification du modèle.
migration_port string Numéro de port de l'assistant de migration affichée sur la console de l'assistant de migration. Le port par défaut est 9123.
export_dir string Répertoire d'exportation des données et de la configuration sources.

Paramètres de configuration dans la section ceip

Tableau 13. 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.

Exécuter une prévérification avant une migration au moyen de la ligne de commande vers vCenter Server Appliance

Vous pouvez exécuter une prévérification pour vous assurer que toutes les conditions sont réunies et résoudre les problèmes éventuels avant la migration de votre déploiement vCenter Server.

Avant de faire migrer votre déploiement de vCenter Server sur un dispositif, vous pouvez procéder à une prévérification pour évaluer l'espace disque nécessaire, estimer le temps de migration et identifier les extensions enregistrées dans le dispositif vCenter Server Appliance. L'exécution de la vérification préalable à la mise à niveau est une étape facultative, mais fortement recommandée lors de la planification de votre mise à niveau.

Conditions préalables

Préparer vos fichiers de configuration JSON pour la migration au moyen de la ligne de commande en utilisant les modèles d'exemples et les paramètres de configuration.

Procédure

  1. Vérifiez votre modèle sans déployer le dispositif en entrant la commande suivante : vcsa-deploy migrate --verify-template-only path_to_json_file.
  2. Exécutez la commande CLI Migrate en utilisant l'option --precheck-only.
    Vous pouvez ajuster votre procédure de migration en fonction de l'espace disque requis et du temps de migration estimé. En cas d'erreur, identifiez et résolvez le problème avant de procéder à la migration.
  3. Une fois les erreurs résolues, exécutez à nouveau la commande CLI Migrate avec l'option --verify-template-only jusqu'à ce que l'ensemble des erreurs soient résolues.

Résultats

Vous pouvez désormais procéder à une migration sans erreur au moyen de la ligne de commande.

Que faire ensuite

Effectuer une migration de vCenter Server à l'aide de l'interface de ligne de commande à partir de Windows vers un dispositif.

Effectuer une migration de vCenter Server à l'aide de l'interface de ligne de commande à partir de Windows vers un dispositif

Vous pouvez migrer vCenter Server vers un dispositif depuis une machine située dans votre réseau vSphere.

Conditions préalables

Procédure

  1. Accédez au répertoire du programme d'installation de l'interface de ligne de commande logicielle pour votre système d'exploitation.
    • Si vous déployez le dispositif depuis une machine avec un système d'exploitation Windows, accédez au répertoire vcsa-cli-installer\win32.
    • Si vous déployez le dispositif depuis une machine avec un système d'exploitation Linux, accédez au répertoire vcsa-cli-installer/lin64.
    • Si vous déployez le dispositif depuis une machine avec un système d'exploitation Mac, accédez au répertoire vcsa-cli-installer/mac.
  2. Sélectionnez le programme d'installation de l'interface de ligne de commande : vcsa-deploy.exe.
  3. Exécutez la commande de migration.
    vcsa-deploy migrate --accept-eula optional_arguments path_to_the_json_file
    La variable optional_arguments est une liste séparée par des espaces d'arguments facultatifs permettant de définir d'autres configurations.
    Par exemple, vous pouvez définir l'emplacement du journal et d'autres fichiers de sortie générés par le programme d'installation.
    vcsa-deploy migrate --accept-eula --log-dir=path_to_the_location path_to_the_json_file

Résultats

Le modèle de migration est déployé. Vous pouvez Vérifier la réussite de la mise à niveau ou de la migration de vCenter Server.

Syntaxe de la commande de migration via l'interface de ligne de commande

Vous pouvez utiliser un ou plusieurs arguments de commande pour définir les paramètres d'exécution de la commande de migration.

Vous pouvez ajouter une liste d'arguments séparés par des espaces dans la commande de mise à niveau via l'interface de ligne de commande.
vcsa-deploy migrate list_of_arguments path_to_the_json_file

L'argument template requis fournit le chemin d'accès à un fichier JSON décrivant la procédure de déploiement du dispositif vCenter Server Appliance. Vous pouvez placer plusieurs fichiers JASON dans un répertoire. L'interface de ligne de commande migrera alors tous les déploiements en mode de traitement par lot. Pour plus d'informations sur l'exécution de migrations simultanées, reportez-vous à la section Préparer vos fichiers de configuration JSON pour la migration au moyen de la ligne de commande.

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 le caractère de barre oblique inverse (\) ou de guillemets ("), vous devez faire précéder le caractère du caractère de barre oblique inverse (\). Par exemple, "password":"my\"password" définit le mot de passe my"password, "image":"C:\\vmware\\vcsa" définit le chemin C:\vmware\vcsa.

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.

Argument facultatif Description
--accept-eula Permet d'accepter le contrat de licence d'utilisateur.

Requis pour exécuter la commande de déploiement.

-h, --help Permet d'afficher le message d'aide pour la commande.
--template-help Permet d'afficher le message d'aide pour les paramètres de configuration dans le fichier de déploiement JSON. Vous pouvez utiliser vcsa-deploy [subcommand] --help pour obtenir une liste des arguments spécifique de la sous-commande.
-v, --verbose Permet d'ajouter des informations de débogage à la sortie de la console.
-t, --terse Permet de masquer la sortie de la console. Affiche uniquement les messages d'avertissement et d'erreur.
--log-dir, LOG_DIR Spécifie l'emplacement du journal et d'autres fichiers de sortie générés par le programme d'installation.
--skip-ovftool-verification

Permet d'effectuer la vérification de base des paramètres de configuration et de déployer vCenter Server Appliance, mais ne valide pas les paramètres d'OVF Tool dans la sous-section ovftool_arguments du modèle JSON. Si vous définissez des arguments que l'OVF Tool ne reconnaît pas, le déploiement peut échouer.

--no-ssl-certificate-verification

Interdit la vérification SSL des connexions ESXi.

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 lui demandez d'ignorer le certificat auto-signé à l'aide du paramètre de commande --no-ssl-certificate-validation.

Si vous vous connectez à un serveur avec un certificat auto-signé, mais que vous ne parvenez pas à le faire accepter par l'interface de ligne de commande, l'interface de ligne de commande affiche l'empreinte du certificat auto-signé du serveur et vous demande de l'accepter ou de la refuser.

Vous pouvez également demander à l'interface de ligne de commande d'ignorer les certificats auto-signés en utilisant le paramètre de configuration ssl_certificate_verification dans le modèle JSON. 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.

Important : Évitez d'utiliser cette option, car elle peut entraîner des problèmes pendant ou après la mise à niveau en raison d'une identité non validée de l'hôte cible.
--operation-id Vous permet de fournir un identificateur pour suivre simultanément l'installation, la migration ou la mise à niveau de plusieurs instances de vCenter Server. Si vous ne fournissez pas un ID d'opération, l'interface de ligne de commande génère un identificateur unique universel (UUID) que vous pouvez utiliser pour identifier les différentes instances de vCenter Server et l'état de leur installation ou de leur mise à niveau.
--verify-template-only Permet d'exécuter une vérification de modèle de base sans installer Upgrade Runner, d'effectuer des vérifications préalables et de mettre à niveau ou de migrer le dispositif vCenter Server Appliance.
--precheck-only Permet d'installer l'assistant de migration sur la machine virtuelle vCenter Server source et d'exécuter un jeu complet de vérifications préalables sans effectuer la migration.
--acknowledge-ceip Permet de confirmer l'accord à participer au programme d'amélioration du produit VMware (CEIP). Cet argument est obligatoire si ceip.enabled est défini sur vrai dans le modèle de mise à niveau.
Code de sortie Description
0 La commande s'est exécutée avec succès
1 Erreur d'exécution
2 Erreur de validation
3 Erreur de modèle