Issues resolved in 2110d.

Security vulnerabilities resolved in 2110d.

The GNSS (Global Navigation Satellite System) can be in an unexpected state, or be in a temporary state for too long. Therefore, when such issues are detected, an SNMP GNSS failure trap is sent, with a reason for the failure. When the failure event ends, an SNMP GNSS recovery trap is sent. They are also resent periodically when in a failure condition.

The GnssFailure trap is sent for any of the GNSS failure conditions. The failure reason message indicates the cause for the failure. While in a failure condition the trap is sent every 60 minutes. When leaving the failure condition, the GnssRecovery trap is sent.

The following table describes the possible reasons for GNSS failures. These are in the order that is reported if more than one issue occurs.

This patch adds the following configuration commands:

set service gnss instance [number] tracking-time-limit [seconds]

number is the instance number of the GNSS receiver in the system. Most systems have at most one GNSS receiver with an instance number of 0.

seconds is how long to wait, in seconds, until a GNSS failure trap indicates that it has taken too long to enter the tracking state. This value must be as follows:

• Has a minimum value of 10
• Is a multiple of 10
• Less than the holdover-time-limit configuration variable
• Defaults to a value of 900 (15 minutes)

If the tracking state has not transitioned to tracking by the time specified in this configuration value, then a trap is sent with the reason Too long in entering tracking state.

set service gnss instance [number] holdover-time-limit [seconds]

number is the instance number of the GNSS receiver in the system. Most systems have at most one GNSS receiver with an instance number of 0.

seconds is how long to wait, in seconds, until a GNSS failure trap indicates that the holdover time has been exceeded. This value must be as follows:

• Has a minimum value of 20
• Is a multiple of 10
• More than the tracking-time-limit configuration variable
• Defaults to a value of 7200 (2 hours)

If the tracking state has not transitioned to tracking by the time given in this configuration value, then a trap is sent with the reason Holdover exceeded configured duration.

• A new MIB attVrouterRebootReasonMIB has been added to this patch.

--*********************************************************************
-- ATT-VROUTER-REBOOT-REASON-MIB
--
-- Copyright (c) 2021 by AT&T Intellectual Property.
-- All rights reserved.
--
-- Redistribution and use in source and binary forms, with or without
-- modification, are permitted provided that the following conditions
-- are met:
--
-- 1. Redistributions of source code must retain the above copyright
-- notice, this list of conditions and the following disclaimer.
-- 2. Redistributions in binary form must reproduce the above
-- copyright notice, this list of conditions and the following
-- disclaimer in the documentation and/or other materials provided
-- with the distribution.
-- 3. Neither the name of the copyright holder nor the names of its
-- contributors may be used to endorse or promote products derived
-- from this software without specific prior written permission.
--
-- THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
-- 'AS IS' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
-- LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
-- FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
-- COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
-- INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
-- BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
-- LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
-- CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
-- LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
-- ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
-- POSSIBILITY OF SUCH DAMAGE.
--
-- SPDX-License-Identifier: BSD-3-Clause
--
--*********************************************************************
ATT-VROUTER-REBOOT-REASON-MIB DEFINITIONS ::= BEGIN
IMPORTS
 MODULE-IDENTITY, OBJECT-TYPE,
 enterprises, NOTIFICATION-TYPE
 FROM SNMPv2-SMI
 TEXTUAL-CONVENTION
 FROM SNMPv2-TC
 SnmpAdminString
 FROM SNMP-FRAMEWORK-MIB;
attVrouterRebootReasonMIB MODULE-IDENTITY
 LAST-UPDATED "202105040000Z" -- May 04, 2021
 ORGANIZATION "AT&T Inc."
 CONTACT-INFO
 "Postal: 208 S. Akard Street
 Dallas, TX 75202
 Web: www.att.com
 "
 DESCRIPTION
 "This MIB describes notification objects
 that describe the cause of system reboot
 for the Vyatta Vrouter.
 Copyright (C) 2021 AT&T Intellectual Property.
 "
 REVISION "202105040000Z" -- May 05, 2021
 DESCRIPTION
 "Initial version"
 ::= { attVrouter 7 }
attEnterprise OBJECT IDENTIFIER ::= { enterprises 74 }
attProducts OBJECT IDENTIFIER ::= { attEnterprise 1 }
attVrouter OBJECT IDENTIFIER ::= { attProducts 32 }
attVrouterRebootReasonNotifications OBJECT IDENTIFIER
 ::= { attVrouterRebootReasonMIB 0 }
attVrouterRebootReasonObjects OBJECT IDENTIFIER
 ::= { attVrouterRebootReasonMIB 1 }
RebootReasonType ::= TEXTUAL-CONVENTION
 STATUS current
 DESCRIPTION
 "An enumerated value which provides the
 reason for reboot."
 SYNTAX INTEGER {
 powerOff(1),
 warmReboot(2),
 coldReboot(3),
 systemImageChange(4),
 systemCrash(5),
 other(6)
 }
attVrouterRebootReasonType OBJECT-TYPE
 SYNTAX RebootReasonType
 MAX-ACCESS read-only
 STATUS current
 DESCRIPTION
 "A value that indicates the reason for
 system reboot."
 ::= { attVrouterRebootReasonObjects 1 }
attVrouterRebootReasonDescr OBJECT-TYPE
 SYNTAX SnmpAdminString
 MAX-ACCESS read-only
 STATUS current
 DESCRIPTION
 "A textual description of the reason for
 system reboot."
 ::= { attVrouterRebootReasonObjects 2 }
attVrouterRebootReason NOTIFICATION-TYPE
 OBJECTS {
 attVrouterRebootReasonType,
 attVrouterRebootReasonDescr
 }
 STATUS current
 DESCRIPTION
 "This notification specifies the cause
 of system reboot for the Vyatta Vrouter."
 ::= { attVrouterRebootReasonNotifications 1 }
END