Bevor Sie die CLIs zur Neukonfiguration eines vCenter Server mit einem externen Platform Services Controller zu einem vCenter Server mit einem eingebetteten Platform Services Controller ausführen oder einen Platform Services Controller außer Betrieb nehmen, müssen Sie eine JSON-Datei mit Konfigurationsparametern und den entsprechenden Werten für Ihre Spezifikation vorbereiten.

Die Beispielvorlagen converge.json und decommission_psc.json befinden sich unter vcsa-converge-cli\templates\converge und vcsa-converge-cli\templates\decommission. Speichern Sie die Vorlagen in Ihrer Arbeitsumgebung.

Diese Beispielvorlagen enthalten die am häufigsten verwendeten Optionen.

Konvergieren von Konfigurationsparametern

Die Konfigurationsparameter in der Konfigurationsdatei converge.json sind in Teile, Abschnitte und Unterabschnitte unterteilt.

Tabelle 1. Konfigurationsparameter für die Datei converge.json
Teil Abschnitt Unterabschnitt Beschreibung
vCenter description comments Beschreibt die vCenter Server Appliance und den ESXi-Host, auf dem die Appliance ausgeführt wird.
managing_esxi_or_vc hostname FQDN oder IP-Adresse des ESXi-Hosts vom vCenter Server, auf dem sich der vCenter Server befindet.
username Benutzer-ID mit Administratorrechten auf dem ESXi-Host oder vCenter Server. Beispiel: root für den ESXi-Host und administrator@SSO_domain für vCenter Server.
password Kennwort des Benutzers mit Administratorrechten auf dem ESXi-Host oder dem vCenter Server. Wenn Sie dies auslassen, werden Sie während der Vorlagenüberprüfung zur Eingabe des Kennworts bei der Befehlskonsole aufgefordert.
vc_appliance hostname FQDN oder IP-Adresse der vCenter Server Appliance.
username administrator@ SSO_domain, wobei SSO_domain die vCenter Single Sign-On-Domäne für die vCenter Server Appliance ist.
password Administratorkennwort für vCenter Single Sign On Wenn Sie dies auslassen, werden Sie während der Vorlagenüberprüfung zur Eingabe des Kennworts bei der Befehlskonsole aufgefordert.
root_password vCenter Server Appliance-Root-Kennwort Wenn Sie dies auslassen, werden Sie während der Vorlagenüberprüfung zur Eingabe des Kennworts bei der Befehlskonsole aufgefordert.
ad_domain_info
Hinweis: Wenn der externe Platform Services Controller nicht mit Active Directory verknüpft ist, entfernen Sie diesen Abschnitt aus der JSON-Vorlage.
domain_name FQDN oder die IP-Adresse der Active Directory-Domäne der Platform Services Controller-Appliance.
username Active Directory-Domänenbenutzer-ID mit Rechten zum Hinzufügen jeder beliebigen Maschine zur angegebenen Domäne.
password Active Directory-Domänenkennwort mit Rechten zum Hinzufügen jeder beliebigen Maschine zur angegebenen Domäne.
dns_ip (Optional) DNS-IP-Adresse, mit der der Active Directory-Domänenname aufgelöst wird. Nur erforderlich, wenn die vorhandene DNS-Einstellung die angegebene Active Directory-Domäne nicht auflösen kann.
replication description Beschreibt die vCenter Server Appliance, die sich in Replizierung mit dem bereitgestellten Platform Services Controller befindet.
partner hostname FQDN oder IP-Adresse des Zielknotens der Platform Services Controller.

Konvergieren einer Datei-Konfigurationsvorlage

Beispielvorlage für 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>"
            }
        }
}

Außerbetriebnahme der Konfigurationsparameter

Die Konfigurationsparameter in der Konfigurationsdatei decommision_psc.json sind in Teile, Abschnitte und Unterabschnitte unterteilt.

Tabelle 2. Konfigurationsparameter für die Datei decommisision_psc.json
Teil Abschnitt Unterabschnitt Beschreibung
psc description comments Beschreibt die Platform Services Controller-Appliance, die Sie außer Betrieb nehmen möchten, und den Platform Services Controller-Host, auf dem die Appliance ausgeführt wird.
managing_esxi_or_vc hostname FQDN oder IP-Adresse des ESXi-Hosts oder vCenter Server, auf dem sich der Platform Services Controller befindet.
username Benutzer-ID mit Administratorrechten auf dem ESXi-Host oder vCenter Server. Beispiel: root für den ESXi-Host und administrator@SSO_domain für vCenter Server.
password Kennwort des Benutzers mit Administratorrechten auf dem ESXi-Host oder dem vCenter Server. Wenn Sie dies auslassen, werden Sie während der Vorlagenüberprüfung zur Eingabe des Kennworts bei der Befehlskonsole aufgefordert.
port (Optional) Port für den Host. Der Standardport ist 443.
psc_appliance hostname FQDN oder IP-Adresse der externen Platform Services Controller-Appliance, die Sie außer Betrieb nehmen möchten.
Hinweis: Stellen Sie sicher, dass gerade keine anderen Lösungen diesen externen Platform Services Controller verwenden, bevor Sie ihn außer Betrieb nehmen.
username administrator@ SSO_domain, wobei SSO_domain die vCenter Single Sign-On-Domäne für die vCenter Server Appliance ist.
password Administratorkennwort für vCenter Single Sign On Wenn Sie dies auslassen, werden Sie während der Vorlagenüberprüfung zur Eingabe des Kennworts bei der Befehlskonsole aufgefordert.
root_password vCenter Server Appliance-Root-Kennwort Wenn Sie dies auslassen, werden Sie während der Vorlagenüberprüfung zur Eingabe des Kennworts bei der Befehlskonsole aufgefordert.
vcenter description comments Beschreibt die eingebettete vCenter Server Appliance, die sich in Replizierung mit dem bereitgestellten Platform Services Controller befindet.
managing_esxi_or_vc hostname FQDN oder IP-Adresse des ESXi-Hosts oder vCenter Server, auf dem sich die vCenter Server Appliance befindet.
username Benutzer-ID mit Administratorrechten auf dem ESXi-Host oder vCenter Server. Beispiel: root für den ESXi-Host und administrator@SSO_domain für vCenter Server.
password Kennwort des Benutzers mit Administratorrechten auf dem ESXi-Host oder dem vCenter Server. Wenn Sie dies auslassen, werden Sie während der Vorlagenüberprüfung zur Eingabe des Kennworts bei der Befehlskonsole aufgefordert.
port (Optional) Port für den Host. Der Standardport ist 443.
vc_appliance hostname FQDN oder IP-Adresse der vCenter Server Appliance.
username administrator@ SSO_domain, wobei SSO_domain die vCenter Single Sign-On-Domäne für die vCenter Server Appliance ist.
password Administratorkennwort für vCenter Single Sign On Wenn Sie dies auslassen, werden Sie während der Vorlagenüberprüfung zur Eingabe des Kennworts bei der Befehlskonsole aufgefordert.
root_password vCenter Server Appliance-Root-Kennwort Wenn Sie dies auslassen, werden Sie während der Vorlagenüberprüfung zur Eingabe des Kennworts bei der Befehlskonsole aufgefordert.

Außerbetriebnahme einer Dateikonfigurationsvorlage

Beispielvorlage für 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.>"
            }
        }
}