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.
Tâches de l'interface de ligne de commande pour migrer votre installation de vCenter Server de Windows vers un dispositif :
- Télécharger et monter le programme d'installation de vCenter Server.
- Télécharger et exécuter l'VMware Migration Assistant sur la machine Windows source.
- Préparer vos fichiers de configuration JSON pour la migration au moyen de la ligne de commande.
- Exécutez les contrôles préalables avant d'effectuer la migration.
- 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.
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 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
Préparez votre environnement pour la migration. Reportez-vous à la section Préparation de la migration.
Procédure
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.
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.
- 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.
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 |
replication_partner_hostname * |
Si vous définissez |
-
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èlewin_vc_to_vCSA_on_VC.json
lors de la migration 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ètrefirst_instance
soit défini surtrue
et supprimez le paramètrereplication_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 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.
- 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.
-
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èlewin_vc_to_vCSA_on_VC.json
lors de la migration 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ètrefirst_instance
est défini surtrue
et supprimez le paramètrereplication_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ètrefirst_instance
est défini surfalse
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"
- 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.
- 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.
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.
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
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": "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 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 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
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. |
Nom | Type | Description |
---|---|---|
thin_disk_mode |
Booléen | Définissez sur true pour déployer le dispositif avec des disques virtuels dynamiques. |
deployment_option |
string | Taille du dispositif.
|
image |
string | Facultatif. Chemin d'accès au fichier local ou URL vers le module d'installation 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. |
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. |
Nom | Type | Description |
---|---|---|
ip_family |
string | Version IP du réseau du dispositif. Définissez sur |
mode |
string | Attribution IP du réseau du dispositif. Définissez sur |
ip |
string | Adresse IP du dispositif. Requise uniquement si vous utilisez une attribution statique, c'est-à-dire, si vous définissez le paramètre Vous devez définir une adresse IPv4 ou IPv6 correspondant à la version IP réseau, c'est-à-dire à la valeur du paramètre Une adresse IPv4 doit être conforme aux directives RFC 790. Une adresse IPv6 doit être conforme aux directives RFC 2373. |
dns_servers |
chaîne ou groupe | Adresses IP d'un ou plusieurs serveurs DNS.
Pour définir plusieurs serveurs DNS, utilisez une liste de chaînes séparées par des virgules ou une liste séparée par des virgules sous forme de chaîne unique pour fournir le chemin d'accès. Par exemple,
["x.y.z.a", "x.y.z.b"]ou "x.y.z.a, x.y.z.b" Requise uniquement si vous utilisez une attribution statique, c'est-à-dire, si vous définissez le paramètre |
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 Pour la version IPv4, la valeur doit se situer entre Pour la version IPv6, la valeur doit se situer entre |
gateway |
string | Adresse IP de la passerelle par défaut. Pour la version IPv6, la valeur peut être |
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.
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. |
Nom | Type | Description |
---|---|---|
first_instance |
string | Définissez Si vous souhaitez définir le partenaire de réplication pour ce nœud, définissez Pour plus d'informations sur la spécification des paramètres |
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.
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.
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
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. |
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. |
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
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
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
Vous pouvez migrer vCenter Server vers un dispositif depuis une machine située dans votre réseau vSphere.
Conditions préalables
- Reportez-vous à Conditions préalables à la migration de vCenter Server
- Créez un snapshot du déploiement à migrer par précaution en cas d'échec pendant le processus de migration.
- Téléchargez le fichier ISO du programme d'installation à partir du site Web de VMware vers une machine résidant dans votre réseau vSphere. Le nom du fichier ISO du programme d'installation est VMware-VCSA-all-8.0.0-yyyyyy.iso, où yyyyyy correspond au numéro de build. Reportez-vous à la section Télécharger et monter le programme d'installation de vCenter Server.
- Préparer vos fichiers de configuration JSON pour la migration au moyen de la ligne de commande.
- Exécuter une prévérification avant une migration au moyen de la ligne de commande vers vCenter Server Appliance pour identifier les problèmes et affiner votre plan de migration.
- Passez en revue les arguments facultatifs de l'exécution de la migration. Reportez-vous à la section Syntaxe de la commande de migration via l'interface de ligne de commande.
Procédure
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.
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.
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 |
--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 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
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 |