Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 30 additions & 0 deletions aci-preupgrade-validation-script.py
Original file line number Diff line number Diff line change
Expand Up @@ -6592,6 +6592,34 @@ def n9k_c93180yc_fx3_switch_memory_check(fabric_nodes, **kwargs):
return Result(result=result, msg=msg, headers=headers, data=data, recommended_action=recommended_action, doc_url=doc_url)


@check_wrapper(check_title="Stale dbgacEpgSummaryTask Objects")
def stale_dbgacEpgSummaryTask_check(tversion, **kwargs):
result = PASS
headers = ["DN", "Start Time"]
data = []
recommended_action = "Contact Cisco TAC for next steps. For more details, refer to the workaround in [CSCwt69100](https://bst.cloudapps.cisco.com/bugsearch/bug/CSCwt69100)."
doc_url = "https://datacenter.github.io/ACI-Pre-Upgrade-Validation-Script/validations/#stale-dbgacepgsummarytask-objects"

if tversion and ((tversion.major1 == "6" and tversion.major2 == "1" and tversion.newer_than("6.1(5e)")) or tversion.newer_than("6.2(1g)")):
return Result(result=NA, msg=VER_NOT_AFFECTED, doc_url=doc_url)

threshold = datetime.utcnow() - timedelta(hours=24)
for obj in icurl("class", 'dbgacEpgSummaryTask.json?query-target-filter=eq(dbgacEpgSummaryTask.operSt,"processing")'):
attr = obj["dbgacEpgSummaryTask"]["attributes"]
dn = attr.get("dn", "")
start_ts = attr.get("startTs", "")
try:
task_dt = datetime.strptime(start_ts[:19], "%Y-%m-%dT%H:%M:%S")
except ValueError:
continue
if task_dt < threshold:
data.append([dn, start_ts])

if data:
result = FAIL_UF
return Result(result=result, headers=headers, data=data, recommended_action=recommended_action, doc_url=doc_url)


# ---- Script Execution ----


Expand Down Expand Up @@ -6766,6 +6794,8 @@ class CheckManager:
bgpProto_timer_policy_already_existing_check,
wred_affected_model_check,
n9k_c93180yc_fx3_switch_memory_check,
stale_dbgacEpgSummaryTask_check,

]
ssh_checks = [
# General
Expand Down
15 changes: 13 additions & 2 deletions docs/docs/validations.md
Original file line number Diff line number Diff line change
Expand Up @@ -140,7 +140,6 @@ Items | Faults | This Script
[AVE End-of-life][c23] | :white_check_mark: | :no_entry_sign:
[Shared Service with vzAny Consumer][c24] | :white_check_mark: | :no_entry_sign:


[c1]: #vpc-paired-leaf-switches
[c2]: #overlapping-vlan-pool
[c3]: #vnid-mismatch
Expand Down Expand Up @@ -206,6 +205,7 @@ Items | Defect | This Script
[BgpProto timer policy already existing][d34] | CSCwt78235 | :white_check_mark: | :no_entry_sign:
[WRED with Affected FM Models][d35] | CSCwt50713 | :white_check_mark: | :no_entry_sign:
[N9K-C93180YC-FX3 Switch Memory Less Than 32GB][d36] | CSCwm42741 | :white_check_mark: | :no_entry_sign:
[Stale dbgacEpgSummaryTask Objects][d37] | CSCwt69100 | :white_check_mark: | :no_entry_sign:

[d1]: #ep-announce-compatibility
[d2]: #eventmgr-db-size-defect-susceptibility
Expand Down Expand Up @@ -243,6 +243,7 @@ Items | Defect | This Script
[d34]: #bgpProto-timer-policy-already-existing
[d35]: #wred-with-affected-fm-models
[d36]: #n9k-c93180yc-fx3-switch-memory-less-than-32gb
[d37]: #stale-dbgacepgsummarytask-objects

## General Check Details

Expand Down Expand Up @@ -2830,6 +2831,15 @@ This check applies to N9K-C93180YC-FX3 switches only. It checks whether the swit
If any N9K-C93180YC-FX3 switch is flagged by this check, upgrade the switch memory to at least 32GB before proceeding with the upgrade.


### Stale dbgacEpgSummaryTask Objects

Due to [CSCwt69100][75], a stale `dbgacEpgSummaryTask` object stuck in `processing` state with empty content can cause the policymgr process to crash on all APICs during an upgrade or process restart.

Affected versions: 6.1(5e) and below, or 6.2(1g).

Contact Cisco TAC for next steps. For more details, refer to the workaround in [CSCwt69100][75].


[0]: https://github.com/datacenter/ACI-Pre-Upgrade-Validation-Script
[1]: https://www.cisco.com/c/dam/en/us/td/docs/Website/datacenter/apicmatrix/index.html
[2]: https://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-release-notes-list.html
Expand Down Expand Up @@ -2904,4 +2914,5 @@ If any N9K-C93180YC-FX3 switch is flagged by this check, upgrade the switch memo
[71]: https://bst.cloudapps.cisco.com/bugsearch/bug/CSCwt78235
[72]: https://bst.cloudapps.cisco.com/bugsearch/bug/CSCwt50713
[73]: https://bst.cloudapps.cisco.com/bugsearch/bug/CSCwo74485
[74]: https://bst.cloudapps.cisco.com/bugsearch/bug/CSCwm42741
[74]: https://bst.cloudapps.cisco.com/bugsearch/bug/CSCwm42741
[75]: https://bst.cloudapps.cisco.com/bugsearch/bug/CSCwt69100
Loading