Skip to content

Field Notices

ANTA catalog for Field Notices tests

Test functions to flag field notices

VerifyFieldNotice44Resolution

Bases: AntaTest

Verifies the device is using an Aboot version that fix the bug discussed in the field notice 44 (Aboot manages system settings prior to EOS initialization).

https://www.arista.com/en/support/advisories-notices/field-notice/8756-field-notice-44

Source code in anta/tests/field_notices.py
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
class VerifyFieldNotice44Resolution(AntaTest):
    """
    Verifies the device is using an Aboot version that fix the bug discussed
    in the field notice 44 (Aboot manages system settings prior to EOS initialization).

    https://www.arista.com/en/support/advisories-notices/field-notice/8756-field-notice-44
    """

    name = "VerifyFieldNotice44Resolution"
    description = (
        "Verifies the device is using an Aboot version that fix the bug discussed in the field notice 44 (Aboot manages system settings prior to EOS initialization)"
    )
    categories = ["field notices", "software"]
    commands = [AntaCommand(command="show version detail")]

    # TODO maybe implement ONLY ON PLATFORMS instead
    @skip_on_platforms(["cEOSLab", "vEOS-lab"])
    @AntaTest.anta_test
    def test(self) -> None:  # type: ignore[override]
        """Run VerifyFieldNotice44Resolution validation"""

        command_output = self.instance_commands[0].json_output

        devices = [
            "DCS-7010T-48",
            "DCS-7010T-48-DC",
            "DCS-7050TX-48",
            "DCS-7050TX-64",
            "DCS-7050TX-72",
            "DCS-7050TX-72Q",
            "DCS-7050TX-96",
            "DCS-7050TX2-128",
            "DCS-7050SX-64",
            "DCS-7050SX-72",
            "DCS-7050SX-72Q",
            "DCS-7050SX2-72Q",
            "DCS-7050SX-96",
            "DCS-7050SX2-128",
            "DCS-7050QX-32S",
            "DCS-7050QX2-32S",
            "DCS-7050SX3-48YC12",
            "DCS-7050CX3-32S",
            "DCS-7060CX-32S",
            "DCS-7060CX2-32S",
            "DCS-7060SX2-48YC6",
            "DCS-7160-48YC6",
            "DCS-7160-48TC6",
            "DCS-7160-32CQ",
            "DCS-7280SE-64",
            "DCS-7280SE-68",
            "DCS-7280SE-72",
            "DCS-7150SC-24-CLD",
            "DCS-7150SC-64-CLD",
            "DCS-7020TR-48",
            "DCS-7020TRA-48",
            "DCS-7020SR-24C2",
            "DCS-7020SRG-24C2",
            "DCS-7280TR-48C6",
            "DCS-7280TRA-48C6",
            "DCS-7280SR-48C6",
            "DCS-7280SRA-48C6",
            "DCS-7280SRAM-48C6",
            "DCS-7280SR2K-48C6-M",
            "DCS-7280SR2-48YC6",
            "DCS-7280SR2A-48YC6",
            "DCS-7280SRM-40CX2",
            "DCS-7280QR-C36",
            "DCS-7280QRA-C36S",
        ]
        variants = ["-SSD-F", "-SSD-R", "-M-F", "-M-R", "-F", "-R"]

        model = command_output["modelName"]
        # TODO this list could be a regex
        for variant in variants:
            model = model.replace(variant, "")
        if model not in devices:
            self.result.is_skipped("device is not impacted by FN044")
            return

        for component in command_output["details"]["components"]:
            if component["name"] == "Aboot":
                aboot_version = component["version"].split("-")[2]
        self.result.is_success()
        if aboot_version.startswith("4.0.") and int(aboot_version.split(".")[2]) < 7:
            self.result.is_failure(f"device is running incorrect version of aboot ({aboot_version})")
        elif aboot_version.startswith("4.1.") and int(aboot_version.split(".")[2]) < 1:
            self.result.is_failure(f"device is running incorrect version of aboot ({aboot_version})")
        elif aboot_version.startswith("6.0.") and int(aboot_version.split(".")[2]) < 9:
            self.result.is_failure(f"device is running incorrect version of aboot ({aboot_version})")
        elif aboot_version.startswith("6.1.") and int(aboot_version.split(".")[2]) < 7:
            self.result.is_failure(f"device is running incorrect version of aboot ({aboot_version})")

test

test() -> None

Run VerifyFieldNotice44Resolution validation

Source code in anta/tests/field_notices.py
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
@skip_on_platforms(["cEOSLab", "vEOS-lab"])
@AntaTest.anta_test
def test(self) -> None:  # type: ignore[override]
    """Run VerifyFieldNotice44Resolution validation"""

    command_output = self.instance_commands[0].json_output

    devices = [
        "DCS-7010T-48",
        "DCS-7010T-48-DC",
        "DCS-7050TX-48",
        "DCS-7050TX-64",
        "DCS-7050TX-72",
        "DCS-7050TX-72Q",
        "DCS-7050TX-96",
        "DCS-7050TX2-128",
        "DCS-7050SX-64",
        "DCS-7050SX-72",
        "DCS-7050SX-72Q",
        "DCS-7050SX2-72Q",
        "DCS-7050SX-96",
        "DCS-7050SX2-128",
        "DCS-7050QX-32S",
        "DCS-7050QX2-32S",
        "DCS-7050SX3-48YC12",
        "DCS-7050CX3-32S",
        "DCS-7060CX-32S",
        "DCS-7060CX2-32S",
        "DCS-7060SX2-48YC6",
        "DCS-7160-48YC6",
        "DCS-7160-48TC6",
        "DCS-7160-32CQ",
        "DCS-7280SE-64",
        "DCS-7280SE-68",
        "DCS-7280SE-72",
        "DCS-7150SC-24-CLD",
        "DCS-7150SC-64-CLD",
        "DCS-7020TR-48",
        "DCS-7020TRA-48",
        "DCS-7020SR-24C2",
        "DCS-7020SRG-24C2",
        "DCS-7280TR-48C6",
        "DCS-7280TRA-48C6",
        "DCS-7280SR-48C6",
        "DCS-7280SRA-48C6",
        "DCS-7280SRAM-48C6",
        "DCS-7280SR2K-48C6-M",
        "DCS-7280SR2-48YC6",
        "DCS-7280SR2A-48YC6",
        "DCS-7280SRM-40CX2",
        "DCS-7280QR-C36",
        "DCS-7280QRA-C36S",
    ]
    variants = ["-SSD-F", "-SSD-R", "-M-F", "-M-R", "-F", "-R"]

    model = command_output["modelName"]
    # TODO this list could be a regex
    for variant in variants:
        model = model.replace(variant, "")
    if model not in devices:
        self.result.is_skipped("device is not impacted by FN044")
        return

    for component in command_output["details"]["components"]:
        if component["name"] == "Aboot":
            aboot_version = component["version"].split("-")[2]
    self.result.is_success()
    if aboot_version.startswith("4.0.") and int(aboot_version.split(".")[2]) < 7:
        self.result.is_failure(f"device is running incorrect version of aboot ({aboot_version})")
    elif aboot_version.startswith("4.1.") and int(aboot_version.split(".")[2]) < 1:
        self.result.is_failure(f"device is running incorrect version of aboot ({aboot_version})")
    elif aboot_version.startswith("6.0.") and int(aboot_version.split(".")[2]) < 9:
        self.result.is_failure(f"device is running incorrect version of aboot ({aboot_version})")
    elif aboot_version.startswith("6.1.") and int(aboot_version.split(".")[2]) < 7:
        self.result.is_failure(f"device is running incorrect version of aboot ({aboot_version})")

VerifyFieldNotice72Resolution

Bases: AntaTest

Checks if the device is potentially exposed to Field Notice 72, and if the issue has been mitigated.

https://www.arista.com/en/support/advisories-notices/field-notice/17410-field-notice-0072

Source code in anta/tests/field_notices.py
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
class VerifyFieldNotice72Resolution(AntaTest):
    """
    Checks if the device is potentially exposed to Field Notice 72, and if the issue has been mitigated.

    https://www.arista.com/en/support/advisories-notices/field-notice/17410-field-notice-0072
    """

    name = "VerifyFieldNotice72Resolution"
    description = "Verifies if the device has exposeure to FN72, and if the issue has been mitigated"
    categories = ["field notices", "software"]
    commands = [AntaCommand(command="show version detail")]

    # TODO maybe implement ONLY ON PLATFORMS instead
    @skip_on_platforms(["cEOSLab", "vEOS-lab"])
    @AntaTest.anta_test
    def test(self) -> None:  # type: ignore[override]
        """Run VerifyFieldNotice72Resolution validation"""

        command_output = self.instance_commands[0].json_output

        devices = ["DCS-7280SR3-48YC8", "DCS-7280SR3K-48YC8"]
        variants = ["-SSD-F", "-SSD-R", "-M-F", "-M-R", "-F", "-R"]
        model = command_output["modelName"]

        for variant in variants:
            model = model.replace(variant, "")
        if model not in devices:
            self.result.is_skipped("Platform is not impacted by FN072")
            return

        serial = command_output["serialNumber"]
        number = int(serial[3:7])

        if "JPE" not in serial and "JAS" not in serial:
            self.result.is_skipped("Device not exposed")
            return

        if model == "DCS-7280SR3-48YC8" and "JPE" in serial and number >= 2131:
            self.result.is_skipped("Device not exposed")
            return

        if model == "DCS-7280SR3-48YC8" and "JAS" in serial and number >= 2041:
            self.result.is_skipped("Device not exposed")
            return

        if model == "DCS-7280SR3K-48YC8" and "JPE" in serial and number >= 2134:
            self.result.is_skipped("Device not exposed")
            return

        if model == "DCS-7280SR3K-48YC8" and "JAS" in serial and number >= 2041:
            self.result.is_skipped("Device not exposed")
            return

        # Because each of the if checks above will return if taken, we only run the long
        # check if we get this far
        for entry in command_output["details"]["components"]:
            if entry["name"] == "FixedSystemvrm1":
                if int(entry["version"]) < 7:
                    self.result.is_failure("Device is exposed to FN72")
                else:
                    self.result.is_success("FN72 is mitigated")
                return
        # We should never hit this point
        self.result.is_error("Error in running test - FixedSystemvrm1 not found")
        return

test

test() -> None

Run VerifyFieldNotice72Resolution validation

Source code in anta/tests/field_notices.py
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
@skip_on_platforms(["cEOSLab", "vEOS-lab"])
@AntaTest.anta_test
def test(self) -> None:  # type: ignore[override]
    """Run VerifyFieldNotice72Resolution validation"""

    command_output = self.instance_commands[0].json_output

    devices = ["DCS-7280SR3-48YC8", "DCS-7280SR3K-48YC8"]
    variants = ["-SSD-F", "-SSD-R", "-M-F", "-M-R", "-F", "-R"]
    model = command_output["modelName"]

    for variant in variants:
        model = model.replace(variant, "")
    if model not in devices:
        self.result.is_skipped("Platform is not impacted by FN072")
        return

    serial = command_output["serialNumber"]
    number = int(serial[3:7])

    if "JPE" not in serial and "JAS" not in serial:
        self.result.is_skipped("Device not exposed")
        return

    if model == "DCS-7280SR3-48YC8" and "JPE" in serial and number >= 2131:
        self.result.is_skipped("Device not exposed")
        return

    if model == "DCS-7280SR3-48YC8" and "JAS" in serial and number >= 2041:
        self.result.is_skipped("Device not exposed")
        return

    if model == "DCS-7280SR3K-48YC8" and "JPE" in serial and number >= 2134:
        self.result.is_skipped("Device not exposed")
        return

    if model == "DCS-7280SR3K-48YC8" and "JAS" in serial and number >= 2041:
        self.result.is_skipped("Device not exposed")
        return

    # Because each of the if checks above will return if taken, we only run the long
    # check if we get this far
    for entry in command_output["details"]["components"]:
        if entry["name"] == "FixedSystemvrm1":
            if int(entry["version"]) < 7:
                self.result.is_failure("Device is exposed to FN72")
            else:
                self.result.is_success("FN72 is mitigated")
            return
    # We should never hit this point
    self.result.is_error("Error in running test - FixedSystemvrm1 not found")
    return

Last update: July 19, 2023