LACP validation fails when importing a Brownfield environment using VCF Import Tool 5.2.2
search cancel

LACP validation fails when importing a Brownfield environment using VCF Import Tool 5.2.2

book

Article ID: 426515

calendar_today

Updated On:

Products

VMware Cloud Foundation

Issue/Introduction

  • When using the VCF Import Tool 5.2.2 to import a Brownfield (existing) vSphere environment, the import precheck fails with below error message suggesting LACP is unsupported or violates Guardrail checks:

    LACP is not supported in VCF. Please remove LACP configurations from cluster DVS.

  • The hosts in the target environment are configured with Link Aggregation Control Protocol (LACP).
  • As stated in below document, LACP is supported starting from VCF Import Tool 5.2.1.2 with SDDC Manager 5.2.1.1: Considerations Before Converting or Importing Existing vSphere Environments into VMware Cloud Foundation

Environment

VMware Cloud Foundation 5.2.2 (Import Tool)

Cause

This issue is a known software defect in the VCF Import Tool 5.2.2.

Resolution

To resolve this issue, you must apply a patch to update the Guardrails definitions on the SDDC Manager.

Prerequisites

  • It is strongly recommended to take a snapshot of the SDDC Manager virtual machine before proceeding with these steps to ensure a safe rollback point.
  • Ensure you have SSH access to the SDDC Manager.
  • Obtain the patch file vcf5220_BI_guardrails_update.zip from Broadcom Support.

Procedure

  1. Upload the vcf5220_BI_guardrails_update.zip file to the /home/vcf directory on the SDDC Manager using a tool like WinSCP or SCP.

  2. SSH into the SDDC Manager as the vcf user and switch to the root user:

    su -


  3. Navigate to the directory where the file was uploaded and unzip the archive:

    cd /home/vcf
    unzip vcf5220_BI_guardrails_update.zip

    Expected Output:

    Archive: vcf5220_BI_guardrails_update.zip
      creating: vcf5220_BI_guardrails_update/
     inflating: vcf5220_BI_guardrails_update/remove-host-day-n.json
     inflating: vcf5220_BI_guardrails_update/remove-host-cluster-base.json
     inflating: vcf5220_BI_guardrails_update/updateGuardrails.sh
     inflating: vcf5220_BI_guardrails_update/add-host-cluster-base.json
     inflating: vcf5220_BI_guardrails_update/add-host-day-n.json


  4. Navigate into the extracted directory and run the updateGuardrails.sh script:

    cd vcf5220_BI_guardrails_update/
    chmod +x updateGuardrails.sh
    ./updateGuardrails.sh


  5. Ensure the script output confirms that the LACP guardrails have been removed and added correctly. You should see output similar to the following:

    Success removed lacp guardrail for /opt/vmware/vcf/operationsmanager/scripts/assessment/guardrails/common/resourcestates/add-host-cluster-base.json
    Success removed lacp guardrail for /opt/vmware/vcf/operationsmanager/scripts/assessment/guardrails/common/resourcestates/remove-host-cluster-base.json
    Added lacp guardrail to /opt/vmware/vcf/operationsmanager/scripts/assessment/guardrails/operations/addHost/add-host-day-n.json
    Added lacp guardrail to /opt/vmware/vcf/operationsmanager/scripts/assessment/guardrails/operations/removeHost/remove-host-day-n.json


  6. Once the script has successfully executed, return to the VCF Import Tool interface and retry the Brownfield import or validation process.

Attachments

vcf5220_BI_guardrails_update.zip get_app