Skip to content

Add SPAN destination port EPG conflict check (CSCvz62374) - #504

Open
joelebla wants to merge 1 commit into
datacenter:v4.3.1-devfrom
joelebla:issue-503-span-destination-epg-conflict
Open

joelebla wants to merge 1 commit into
datacenter:v4.3.1-devfrom
joelebla:issue-503-span-destination-epg-conflict

Conversation

@joelebla

Copy link
Copy Markdown
Contributor

Closes #503

Summary

  • Add span_destination_epg_conflict_check as an API check for single-port destinations referenced by enabled access SPAN sessions whose l1PhysIf.usage contains epg.
  • Report FAIL_O for conflicts, including destinations configured but not currently deployed; MANUAL CHECK REQUIRED without a target version; N/A below target 6.1(3) (switch 16.1(3)).
  • Exclude port-channel, vPC, FEX, CPU and fabric SPAN destinations.
  • Document the condition and remediation in docs/docs/validations.md.

Notes for review

  • The script evaluates all configured destination nodes; it has no selection of switches being upgraded. Run it before the corresponding switch upgrade. The check does not depend on the current version or on spanMode.
  • The check relies on reported interface usage. It cannot detect configured EPGs that have not deployed, including EPG deployment blocked by SPAN or awaiting on-demand deployment. Missing interface objects are unchecked; a pass means no conflict was found among available objects. Query errors produce ERROR through the existing check wrapper.

Validation

  • Unit tests: 41 new cases; full suite passes on Python 2.7 and 3.8.
  • Mutations of the key predicates are caught by the new tests.
  • Lab runs on APIC 5.2, 6.0 and 6.2, including positive reproductions on two fabrics; results are in the comment below.

@joelebla

Copy link
Copy Markdown
Contributor Author

Lab results (-d span_destination_epg_conflict_check, API-only)

APIC release Python Scenario Target Result
5.2(3g) 2.7 Condition absent 6.1(3f) / 6.1(2g) PASS / N/A
6.0(9d) 3.8 Condition absent 6.1(3f) / 6.1(2g) PASS / N/A
6.0(9e) 3.8 Condition absent 6.1(3f) / 6.1(2g) PASS / N/A
6.2(3g) 3.12 Condition absent 6.1(3f) / 6.1(2g) PASS / N/A
6.0(9d) 3.8 Temporary SPAN destination on an oper-down EPG port 6.1(3f) FAIL - OUTAGE WARNING!! (1 row)
6.0(9d) 3.8 Same configured condition, below gate 6.1(2g) N/A
6.0(9e) 3.8 Temporary SPAN destination on an oper-down EPG port 6.1(3f) FAIL - OUTAGE WARNING!! (1 row)
6.0(9e) 3.8 After removing the temporary configuration 6.1(3f) PASS

Both reproductions used ports verified oper-down immediately before applying the configuration. The temporary configuration was removed afterwards and both fabrics were verified back at baseline.

These runs validate detection and cleanup; no upgrade or reload was performed.

This branch has not been deployed

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant