Skip to content

VMware: wait for NSX DV port group readiness - #13753

Open
Dogface2k wants to merge 1 commit into
apache:4.22from
Dogface2k:agent/wait-for-nsx-dvportgroup
Open

VMware: wait for NSX DV port group readiness#13753
Dogface2k wants to merge 1 commit into
apache:4.22from
Dogface2k:agent/wait-for-nsx-dvportgroup

Conversation

@Dogface2k

Copy link
Copy Markdown

Description

This PR prevents VMware NSX-backed guest network implementation from failing when vCenter has not yet exposed the backing distributed virtual port group immediately after NSX segment creation.

The NSX branch in HypervisorHostHelper.prepareNetwork now uses the existing bounded waitForDvPortGroupReady path. The change does not retry the CloudStack mutation or create a second network; it only waits for vCenter inventory visibility before returning the already-created port group.

A regression test simulates an empty first vCenter lookup followed by the port group becoming available. The existing immediate-availability behavior remains covered.

Fixes: #13752

Types of changes

  • Breaking change (fix or feature that would cause existing functionality to change)
  • New feature (non-breaking change which adds functionality)
  • Bug fix (non-breaking change which fixes an issue)
  • Enhancement (improves an existing feature and functionality)
  • Cleanup (Code refactoring and cleanup, that may add test cases)
  • Build/CI
  • Test (unit or integration test code)

Feature/Enhancement Scale or Bug Severity

Feature/Enhancement Scale

  • Major
  • Minor

Bug Severity

  • BLOCKER
  • Critical
  • Major
  • Minor
  • Trivial

Screenshots (if appropriate):

Not applicable.

How Has This Been Tested?

Targeted regression and baseline tests were run on the 4.22 branch with Java 17:

HypervisorHostHelperTest#testPrepareNetwork
HypervisorHostHelperTest#testPrepareNetworkWaitsForNsxDvPortGroup

Tests run: 2, Failures: 0, Errors: 0, Skipped: 0

The Maven reactor built all 18 required modules successfully, including cloud-vmware-base, with zero Checkstyle violations.

How did you try to break this feature and the system with this change?

The regression test makes the first vCenter DV port group query return no result and the second return the expected port group. The pre-existing immediate-availability test also runs to verify the normal fast path remains unchanged. The production path remains bounded by the existing readiness timeout and returns failure if the port group never appears.

@boring-cyborg

boring-cyborg Bot commented Jul 30, 2026

Copy link
Copy Markdown

Congratulations on your first Pull Request and welcome to the Apache CloudStack community! If you have any issues or are unsure about any anything please check our Contribution Guide (https://github.com/apache/cloudstack/blob/main/CONTRIBUTING.md)
Here are some useful points:

@Dogface2k
Dogface2k marked this pull request as ready for review July 30, 2026 15:30
@DaanHoogland DaanHoogland added this to the 4.22.2 milestone Jul 31, 2026

@DaanHoogland DaanHoogland left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

clgtm

} else if (BroadcastDomainType.NSX == broadcastDomainType && Objects.nonNull(netName)){
networkName = netName;
bWaitPortGroupReady = false;
// NSX creates the segment outside vCenter, where its backing DV port group may not be immediately visible.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don’t think we need this comment, but soit.

Suggested change
// NSX creates the segment outside vCenter, where its backing DV port group may not be immediately visible.

@codecov

codecov Bot commented Jul 31, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 3.69%. Comparing base (0339f31) to head (e8eeed2).

❗ There is a different number of reports uploaded between BASE (0339f31) and HEAD (e8eeed2). Click for more details.

HEAD has 1 upload less than BASE
Flag BASE (0339f31) HEAD (e8eeed2)
unittests 1 0
Additional details and impacted files
@@              Coverage Diff              @@
##               4.22   #13753       +/-   ##
=============================================
- Coverage     17.69%    3.69%   -14.01%     
=============================================
  Files          5925      449     -5476     
  Lines        533534    38176   -495358     
  Branches      65273     7072    -58201     
=============================================
- Hits          94421     1409    -93012     
+ Misses       428434    36580   -391854     
+ Partials      10679      187    -10492     
Flag Coverage Δ
uitests 3.69% <ø> (ø)
unittests ?

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

VMware NSX network implementation can fail before backing DV port group is visible

2 participants