Avant d'exécuter les interfaces de ligne de commande pour reconfigurer le système vCenter Server avec une instance externe de Platform Services Controller en système vCenter Server avec une instance intégrée de Platform Services Controller, ou désaffecter une instance de Platform Services Controller, vous devez préparer un fichier JSON contenant les paramètres de configuration et les valeurs de votre choix.

Les exemples de modèles converge.json et decommission_psc.json sont situés sous vcsa-converge-cli\templates\converge et vcsa-converge-cli\templates\decommission. Enregistrez les modèles sur votre espace de travail.

Ces exemples de modèles contiennent les options les plus fréquemment utilisées.

Paramètres de configuration de la convergence

Les paramètres de configuration dans le fichier de configuration converge.json sont organisés par parties, par sections et par sous-sections.

Tableau 1. Paramètre de configuration pour le fichier converge.json
Partie Section Sous-section Description
vCenter description comments Décrit le dispositif vCenter Server Appliance et l'hôte ESXi sur lequel le dispositif est en cours d'exécution.
managing_esxi_or_vc hostname Nom de domaine complet ou adresse IP de l'hôte ESXi de l'instance de vCenter Server sur laquelle réside vCenter Server.
username ID d'utilisateur disposant des privilèges d'administrateur sur l'hôte ESXi ou sur l'instance de vCenter Server. Par exemple, root pour l'hôte ESXi et administrator@SSO_domain pour vCenter Server.
password Mot de passe de l'utilisateur disposant des privilèges d'administrateur sur l'hôte ESXi ou sur l'instance de vCenter Server. 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.
vc_appliance hostname Nom de domaine complet ou adresse IP de vCenter Server Appliance.
username administrator@SSO_domain où SSO_domain est le domaine vCenter Single Sign-On pour vCenter Server Appliance.
password Mot de passe de l'administrateur vCenter Single Sign-On. 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.
root_password Mot de passe racine de vCenter Server Appliance. 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.
ad_domain_info
Note : Si l'instance externe de Platform Services Controller n'est pas jointe à Active Directory, supprimez cette section dans le modèle JSON.
domain_name Nom de domaine complet ou adresse IP du domaine Active Directory du dispositif Platform Services Controller.
username ID d'utilisateur du domaine Active Directory disposant des privilèges pour joindre n'importe quelle machine au domaine indiqué.
password Mot de passe du domaine Active Directory disposant des privilèges pour joindre n'importe quelle machine au domaine indiqué.
dns_ip (Facultatif) Adresse IP DNS qui résout le nom de domaine Active Directory. Requis uniquement lorsque la configuration DNS existante ne peut pas résoudre le domaine Active Directory fourni.
replication description Décrit le dispositif vCenter Server Appliance qui est en réplication avec l'instance de Platform Services Controller fournie.
partner hostname Nom de domaine complet ou adresse IP du nœud Platform Services Controller cible.

Modèle de fichier de configuration pour la convergence

Exemple de modèle converge.json : 

{
    "__version": "2.11.0",
    "__comments": "Template for VCSA with external Platform Services Controller converge",
        "vcenter": {
            "description": {
               "__comments": [
                    "This section describes the vCenter appliance which you want to",
                    "converge and the ESXi host on which the appliance is running. "
                ]
            },
            "managing_esxi_or_vc": {
                "hostname": "<FQDN or IP address of the ESXi or vCenter on which the vCenter Server Appliance resides.>",
                "username": "<Username of a user with administrative privilege on the ESXi host or vCenter Server. For example 'root' for ESXi and 'administrator@<SSO domain name>' for vCenter >",
                "password": "<Password of the administrative user on the ESXi host or vCenter Server. If left blank, or omitted, you will be prompted to enter it at the command console during template verification.>"
            },
            "vc_appliance": {
                "hostname": "<FQDN or IP address of the vCenter Server Appliance>",
                "username": "administrator@<SSO domain name>",
                "password": "<vCenter Single Sign-On administrator password. If left blank, or omitted, you will be prompted to enter it at the command console during template verification.>",
                "root_password": "<Appliance root password. If left blank, or omitted, you will be prompted to enter it at the command console during template verification.>",
            },
            "ad_domain_info": {
                "__comments": [
                    "Important Note: This section is needed only when PSC (Platform Services Controller) appliance is joined to a domain.",
                    "Remove this section if PSC appliance is not joined to a domain.",
                    "Keeping this section without valid values results in JSON validation errors."
                ],
                "domain_name": "<Domain name of the Platform Services Controller appliance's AD domain>",
                "username": "<AD domain username with privileges to join any machine to the provided domain>",
                "password": "<AD domain password with privileges to join any machine to the provided domain>",
                "dns_ip": "<DNS IP which resolves AD domain name. This is an optional field and is required only when the provided AD domain cannot be resolved by the existing DNS setting of the VCSA node.>"
            }
        },
    "replication": {
            "description": {
               "__comments": [
               "Important Note: Make sure you provide the information in this section very carefully, as this changes the replication topology.",
               "Refer to the documentation for complete details. Remove this section if this is first converge operation in your setup.",
               "This section provides details of the PSC node which will be set up as a replicated node for a new PSC on the target VCSA node."
            ]
                },
            "partner": {
                "hostname": "<FQDN or IP address of the target VCSA PSC node>"
            }
        }
}

Paramètres de configuration de la désaffectation

Les paramètres de configuration dans le fichier de configuration decommision_psc.json sont organisés par parties, par sections et par sous-sections.

Tableau 2. Paramètre de configuration pour le fichier decommision_psc.json
Partie Section Sous-section Description
psc description comments Décrit le dispositif Platform Services Controller que vous souhaitez désaffecter et l'hôte Platform Services Controller sur lequel le dispositif est en cours d'exécution.
managing_esxi_or_vc hostname Nom de domaine complet ou adresse IP de l'hôte ESXi ou de l'instance de vCenter Server sur laquelle Platform Services Controller réside.
username ID d'utilisateur disposant des privilèges d'administrateur sur l'hôte ESXi ou sur l'instance de vCenter Server. Par exemple, root pour l'hôte ESXi et administrator@SSO_domain pour vCenter Server.
password Mot de passe de l'utilisateur disposant des privilèges d'administrateur sur l'hôte ESXi ou sur l'instance de vCenter Server. 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.
port (Facultatif) Port de l'hôte. Le port par défaut est 443.
psc_appliance hostname Nom de domaine complet ou adresse IP du dispositif Platform Services Controller externe que vous souhaitez désaffecter.
Note : Assurez-vous qu'aucune autre solution n'utilise actuellement ce dispositif Platform Services Controller externe avant de le désaffecter.
username administrator@SSO_domain où SSO_domain est le domaine vCenter Single Sign-On pour vCenter Server Appliance.
password Mot de passe de l'administrateur vCenter Single Sign-On. 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.
root_password Mot de passe racine de vCenter Server Appliance. 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.
vcenter description comments Décrit le dispositif vCenter Server Appliance intégré qui est en réplication avec l'instance de Platform Services Controller fournie.
managing_esxi_or_vc hostname Nom de domaine complet ou adresse IP de l'hôte ESXi ou de l'instance de vCenter Server sur laquelle vCenter Server Appliance réside.
username ID d'utilisateur disposant des privilèges d'administrateur sur l'hôte ESXi ou sur l'instance de vCenter Server. Par exemple, root pour l'hôte ESXi et administrator@SSO_domain pour vCenter Server.
password Mot de passe de l'utilisateur disposant des privilèges d'administrateur sur l'hôte ESXi ou sur l'instance de vCenter Server. 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.
port (Facultatif) Port de l'hôte. Le port par défaut est 443.
vc_appliance hostname Nom de domaine complet ou adresse IP de vCenter Server Appliance.
username administrator@SSO_domain où SSO_domain est le domaine vCenter Single Sign-On pour vCenter Server Appliance.
password Mot de passe de l'administrateur vCenter Single Sign-On. 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.
root_password Mot de passe racine de vCenter Server Appliance. 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.

Modèle de fichier de configuration pour la désaffectation

Exemple de modèle decommission.json : 

{    
"__comments": "Template for decommissioning PSC node with converge CLI tool.",
    "__version": "2.11.0",
        "psc": {
            "description": {
               "__comments": [
                   "This section describes the PSC appliance which you want to",
                    "decommission and the ESXi host on which the appliance is running. "
                ]
            },
            "managing_esxi_or_vc": {
                "hostname": "<FQDN or IP address of the ESXi or vCenter on which the Platform Services Controller appliance resides.>",
                "username": "<Username of a user with administrative privilege on the ESXi host or vCenter Server. For example 'root' for ESXi and 'administrator@<SSO domain name>' for vCenter >",
                "password": "<Password of the administrative user on the ESXi host or vCenter Server. If left blank, or omitted, you will be prompted to enter it at the command console during template verification.>",
                "port": "This section may be removed, if default port is 443. If not, custom port have to be specified"
            },
            "psc_appliance": {
                "hostname": "<FQDN or IP address of the Platform Services Controller appliance>",
                "username": "administrator@<SSO domain name>",
                "password": "<vCenter Single Sign-On administrator password. If left blank, or omitted, you will be prompted to enter it at the command console during template verification.>",
                "root_password": "<Appliance root password. If left blank, or omitted, you will be prompted to enter it at the command console during template verification.>",
            }
        }
        "vcenter": {
            "description": {
               "__comments": [
                    "This section describes the embedded vCenter appliance which is in ",
                    "replication with the provided PSC"
                ]
            },
            "managing_esxi_or_vc": {
                "hostname": "<FQDN or IP address of the ESXi or vCenter on which the vCenter Server Appliance resides.>",
                "username": "<Username of a user with administrative privilege on the ESXi host or vCenter Server. For example 'root' for ESXi and 'administrator@<SSO domain name>' for vCenter >",
                "password": "<Password of the administrative user on the ESXi host or vCenter Server. If left blank, or omitted, you will be prompted to enter it at the command console during template verification.>",
                "port": "This section may be removed, if default port is 443. If not, custom port have to be specified"
            },
            "vc_appliance": {
                "hostname": "<FQDN or IP address of the vCenter Server Appliance>",
                "username": "administrator@<SSO domain name>",
                "password": "<vCenter Single Sign-On administrator password. If left blank, or omitted, you will be prompted to enter it at the command console during template verification.>",
                "root_password": "<Appliance root password. If left blank, or omitted, you will be prompted to enter it at the command console during template verification.>"
            }
        }
}