Skip to main content
NetApp virtualization solutions

Convert vSphere cluster to VCF management domain using the VCF Import Tool

Contributors netapp-lhalbert netapp-jsnyder
PDFs

Convert an existing vSphere 8 cluster to a VCF 5.2 management domain using the VCF Import Tool. You'll validate the vCenter appliance, deploy the SDDC manager, create NSX deployment specifications, and perform the conversion.

Use the VCF Import Tool from VMware by Broadcom on both the vCenter appliance and SDDC manager to validate configurations and provide conversion and import services for vSphere and VCF environments.

Where appropriate, VMware documentation is referenced for additional instructions.

Step 1: Copy the VCF Import Tool and run a precheck

Use the VCF Import Tool on the vCenter appliance to validate that the vSphere cluster is in a healthy state for the VCF conversion or import process.

Steps

  1. Copy the VCF Import Tool to the target vCenter appliance by following the instructions in the VMware documentation: Copy the VCF Import Tool to the Target vCenter Appliance.

  2. Extract the bundle using the following command:

    tar -xvf vcf-brownfield-import-<buildnumber>.tar.gz

  3. Run the validation precheck by following the instructions in the VMware documentation: Run a Precheck on the Target vCenter Before Conversion.

  4. The following output shows that the vCenter appliance has passed the precheck.

    vcf import tool precheck

Step 2: Deploy the SDDC Manager and create the NSX deploy specification

Deploy the SDDC Manager appliance on the same vSphere cluster that you plan to convert to a VCF management domain, and then create an NSX deployment specification for the conversion process.

Steps

  1. Deploy the SDDC Manager appliance by following the instructions in the VMware documentation: Deploy the SDDC Manager Appliance on the Target vCenter.

  2. Add hosts to the SDDC Manager inventory by following the instructions in the VMware documentation: Commission Hosts.

    The following is an example of a JSON file for NSX deployment:

    {
  "license_key": "xxxxx-xxxxx-xxxxx-xxxxx-xxxxx",
  "form_factor": "medium",
  "admin_password": "************************",
  "install_bundle_path": "/tmp/vcfimport/bundle-133764.zip",
  "cluster_ip": "172.21.166.72",
  "cluster_fqdn": "vcf-m02-nsx01.sddc.netapp.com",
  "manager_specs": [{
    "fqdn": "vcf-m02-nsx01a.sddc.netapp.com",
    "name": "vcf-m02-nsx01a",
    "ip_address": "172.21.166.73",
    "gateway": "172.21.166.1",
    "subnet_mask": "255.255.255.0"
  },
  {
    "fqdn": "vcf-m02-nsx01b.sddc.netapp.com",
    "name": "vcf-m02-nsx01b",
    "ip_address": "172.21.166.74",
    "gateway": "172.21.166.1",
    "subnet_mask": "255.255.255.0"
  },
  {
    "fqdn": "vcf-m02-nsx01c.sddc.netapp.com",
    "name": "vcf-m02-nsx01c",
    "ip_address": "172.21.166.75",
    "gateway": "172.21.166.1",
    "subnet_mask": "255.255.255.0"
  }]
}

  3. Copy the JSON file to a directory on the SDDC Manager.

Note When deploying an NSX Manager cluster in a convert or import operation, NSX-VLAN networking is used. For information about NSX-VLAN networking limitations, refer to the VMware documentation: Considerations Before Converting or Importing Existing vSphere Environments into VMware Cloud Foundation.

Step 3: Upload software to the SDDC Manager

Upload the VCF Import Tool bundle and the NSX deployment bundle to the SDDC Manager by following the instructions in the VMware documentation: Upload the Required Software to the SDDC Manager Appliance.

Make sure you copy the VCF Import Tool and the NSX deployment bundle to the following directory on the SDDC Manager: /home/vcf/vcfimport .

Step 4: Convert the vSphere cluster to the VCF management domain

Convert the vSphere cluster to the VCF management domain by following the instructions in the VMware documentation: Convert or Import the vSphere Environment into the SDDC Manager Inventory.

Use the following command to convert the vSphere cluster to a VCF management domain and deploy the NSX cluster:

python3 vcf_brownfield.py convert --vcenter '<vcenter-fqdn>' --sso-user '<sso-user>' --domain-name '<wld-domain-name>' --nsx-deployment-spec-path '<nsx-deployment-json-spec-path>'

Where:

  • <vcenter-fqdn> is the fully qualified domain name of your vCenter server

  • <sso-user> is the Single Sign-On user account

  • <wld-domain-name> is the desired name for your workload domain

  • <nsx-deployment-json-spec-path> is the path to the NSX deployment JSON file created in Step 2

Tip You can review all available VCF import tool functions by running python3 vcf_brownfield.py --help from the /home/vcf/vcf-import-package/vcf-brownfield-import-<version>/vcf-brownfield-toolset directory.

Step 5: Add licensing to VCF

After completing the conversion, add licensing to the VCF environment.

Steps

  1. Log in to the SDDC Manager UI.

  2. Navigate to Administration > Licensing in the navigation pane.

  3. Click + License Key.

  4. Choose a product from the drop-down menu.

  5. Enter the license key.

  6. Provide a description for the license.

  7. Click Add.

  8. Repeat these steps for each license.

Additional information