APS-MIB: View SNMP OID List / Download MIB

This management information module supports the configuration and management of SONET linear APS groups. The definitions and descriptions used in this MIB have been derived from Synchronous Optical Network (SONET) Transport Systems: Common Generic Criteria, GR-253-CORE Issue 3, September 2000, section 5.3. The MIB is also consistent with the Multiplex Section Protection (MSP) protocol as specified in ITU-T Recommendation G.783, Characteristics of synchronous digital hierarchy (SDH) equipment function blocks, Annex A and B. Copyright (C) The Internet Society (2003). This version of this MIB module is part of RFC 3498; see the RFC itself for full legal notices.

The count of APS groups. This count includes all rows in apsConfigTable, regardless of the value of apsConfigRowStatus.

This table lists the APS groups that have been configured on the system.

A conceptual row in the apsConfigTable.

A textual name for the APS group.

The status of this APS group entry. An entry may not exist in the active state unless all objects in the entry have an appropriate value. Also, all associated apsChanConfigEntry rows must represent a set of consecutive channel numbers beginning with 0 or 1, depending on the selected architecture. When set to notInService changes may be made to apsConfigMode, apsConfigRevert, apsConfigDirection, apsConfigExtraTraffic, apsConfigSdBerThreshold, apsConfigSfBerThreshold, and apsConfigWaitToRestore. Also, associated apsChanConfigTable objects may be added, deleted and modified.

The architecture of the APS group. onePlusOne The 1+1 architecture permanently bridges the working line to the protection line. oneToN The 1:n architecture allows one protection channel to protect up to n working channels. When a fault is detected on one of the n working channels that channel is bridged over the protection channel. onePlusOneCompatible This refers to 1 + 1 bidirectional switching compatible with 1:n bidirectional switching as specified in ITU-T Recommendation G.783 (04/97) section A.3.4.1. Since this mode necessitates bidirectional switching, apsConfigDirection must be set to bidirectional whenever onePlusOneCompatible is set. onePlusOneOptimized This refers to 1 + 1 bidirectional switching optimized for a network using predominantly 1 + 1 bidirectional switching as specified in ITU-T Recommendation G.783 (04/97) section B.1. Since this mode necessitates bidirectional switching, apsConfigDirection must be set to bidirectional whenever onePlusOneOptimized is set. This object may not be modified if the associated apsConfigRowStatus object is equal to active(1). Enumeration: 'onePlusOneOptimized': 4, 'onePlusOne': 1, 'oneToN': 2, 'onePlusOneCompatible': 3.

The revertive mode of the APS group. nonrevertive Traffic remains on the protection line until another switch request is received. revertive When the condition that caused a switch to the protection line has been cleared the signal is switched back to the working line. Since switching is revertive with the 1:n architecture, apsConfigRevert must be set to revertive if apsConfigMode is set to oneToN. Switching may optionally be revertive with the 1+1 architecture. This object may not be modified if the associated apsConfigRowStatus object is equal to active(1). Enumeration: 'revertive': 2, 'nonrevertive': 1.

The directional mode of the APS group. unidirectional The unidirectional mode provides protection in one direction. bidirectional The bidirectional mode provides protection in both directions. This object may not be modified if the associated apsConfigRowStatus object is equal to active(1). Enumeration: 'bidirectional': 2, 'unidirectional': 1.

This object enables or disables the transfer of extra traffic on the protection channel in a 1:n architecture. This object must be set to disabled if the architecture is 1+1. It may be necessary to disable this in order to interwork with other SONET network elements that don't support extra traffic. This object may not be modified if the associated apsConfigRowStatus object is equal to active(1). Enumeration: 'disabled': 2, 'enabled': 1.

The Signal Degrade Bit Error Rate. The negated value of this number is used as the exponent of 10 for computing the threshold value for the Bit Error Rate (BER). For example, a value of 5 indicates a BER threshold of 10^-5. This object may be modified if the associated apsConfigRowStatus object is equal to active(1).

The Signal Failure Bit Error Rate. The negated value of this number is used as the exponent of 10 for computing the threshold value for the Bit Error Rate (BER). For example, a value of 5 indicates a BER threshold of 10^-5. This object may be modified if the associated apsConfigRowStatus object is equal to active(1).

The Wait To Restore period in seconds. After clearing of a condition that necessitated an automatic switch, the wait to restore period must elapse before reverting. This is intended to avoid rapid switch oscillations. GR-253-CORE specifies a Wait To Restore range of 5 to 12 minutes. G.783 defines a 5 to 12 minute Wait To Restore range in section 5.4.1.1.3, but also allows for a shorter WTR period in Table 2-1, WaitToRestore value (MI_WTRtime: 0..(5)..12 minutes). This object may not be modified if the associated apsConfigRowStatus object is equal to active(1).

The value of sysUpTime at the time the row was created

The storage type for this conceptual row. Conceptual rows having the value 'permanent' need not allow write-access to any columnar objects in the row.

This table provides status information about APS groups that have been configured on the system.

A conceptual row in the apsStatusTable.

The current value of the K1 and K2 bytes received on the protection channel.

The current value of the K1 and K2 bytes transmitted on the protection channel.

The current status of the APS group. modeMismatch Modes other than 1+1 unidirectional monitor protection line K2 bit 5, which indicates the architecture and K2 bits 6-8, which indicate if the mode is unidirectional or bidirectional. A conflict between the current local mode and the received K2 mode information constitutes a mode mismatch. channelMismatch This bit indicates a mismatch between the transmitted K1 channel and the received K2 channel has been detected. psbf This bit indicates a Protection Switch Byte Failure (PSBF) is in effect. This condition occurs when either an inconsistent APS byte or an invalid code is detected. An inconsistent APS byte occurs when no three consecutive K1 bytes of the last 12 successive frames are identical, starting with the last frame containing a previously consistent byte. An invalid code occurs when the incoming K1 byte contains an unused code or a code irrelevant for the specific switching operation (e.g., Reverse Request while no switching request is outstanding) in three consecutive frames. An invalid code also occurs when the incoming K1 byte contains an invalid channel number in three consecutive frames. feplf Modes other than 1+1 unidirectional monitor the K1 byte for Far-End Protection-Line failures. A Far-End Protection-Line defect is declared based on receiving SF on the protection line. extraTraffic This bit indicates whether extra traffic is currently being accepted on the protection line. Bits: 'modeMismatch': 0, 'channelMismatch': 1, 'psbf': 2, 'feplf': 3, 'extraTraffic': 4.

A count of Mode Mismatch conditions. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of apsStatusDiscontinuityTime.

A count of Channel Mismatch conditions. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of apsStatusDiscontinuityTime.

A count of Protection Switch Byte Failure conditions. This condition occurs when either an inconsistent APS byte or an invalid code is detected. An inconsistent APS byte occurs when no three consecutive K1 bytes of the last 12 successive frames are identical, starting with the last frame containing a previously consistent byte. An invalid code occurs when the incoming K1 byte contains an unused code or a code irrelevant for the specific switching operation (e.g., Reverse Request while no switching request is outstanding) in three consecutive frames. An invalid code also occurs when the incoming K1 byte contains an invalid channel number in three consecutive frames. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of apsStatusDiscontinuityTime.

A count of Far-End Protection-Line Failure conditions. This condition is declared based on receiving SF on the protection line in the K1 byte. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of apsStatusDiscontinuityTime.

This field is set to the number of the channel that is currently switched to protection. The value 0 indicates no channel is switched to protection. The values 1-14 indicate that working channel is switched to protection.

The value of sysUpTime on the most recent occasion at which any one or more of this APS group's counters suffered a discontinuity. The relevant counters are the specific instances associated with this APS group of any Counter32 object contained in apsStatusTable. If no such discontinuities have occurred since the last re-initialization of the local management subsystem, then this object contains a zero value.

The count of SONET LTE interfaces on the system. Each interface that is included has an ifType value of sonet(39).

This table lists the SONET LTE interfaces on the system. Each interface that is listed has an ifType value of sonet(39).

A conceptual row in the apsMapTable.

A textual name for the APS group which this channel is included in. If the channel is not part of an APS group this value is set to a string of size 0. When an instance of apsChanConfigIfIndex is set equal to an instance of ifIndex that has an ifType value of sonet(39), apsMapGroupName is set equal to the corresponding value of apsChanConfigGroupName. If an instance of ifIndex that has an ifType value of sonet(39) ceases to be equal to an instance of apsChanConfigIfIndex, either because of a change in the value of apsChanConfigIfIndex, or because of row deletion in the ApsChanConfigTable, apsMapGroupName is set to a string of size 0.

This field is set to a unique channel number within an APS group. The value 0 indicates the null channel. The values 1-14 define a working channel. If the SONET LTE is not part of an APS group this value is set to -1. When an instance of apsChanConfigIfIndex is set equal to an instance of ifIndex that has an ifType value of sonet(39), apsMapChanNumber is set equal to the corresponding value of apsChanConfigNumber. If an instance of ifIndex that has an ifType value of sonet(39) ceases to be equal to an instance of apsChanConfigIfIndex, either because of a change in the value of apsChanConfigIfIndex, or because of row deletion in the ApsChanConfigTable, apsMapChanNumber is set to -1.

This table lists the APS channels that have been configured in APS groups.

A conceptual row in the apsChanConfigTable.

A textual name for the APS group which this channel is included in.

This field is set to a unique channel number within an APS group. The value 0 indicates the null channel. The values 1-14 define a working channel. This field must be assigned a unique number within the group.

The status of this APS channel entry. An entry may not exist in the active state unless all objects in the entry have an appropriate value. A row in the apsChanConfigTable may not be created, deleted, set to notInService or otherwise modified if the apsChanConfigGroupName value is equal to an apsConfigName value and the associated apsConfigRowStatus object is equal to active. However, if the apsConfigRowStatus object is equal to notInService, a row may be created, deleted or modified. In other words, a channel may not be added, deleted or modified if the group is active. A row may be created with an apsChanConfigGroupName value that is not equal to any existing instance of apsConfigName. This action is the initial step in adding a SONET LTE to a new APS group. If this object is set to destroy, the associated instance of apsMapGroupName will be set to a string of size 0 and the apsMapChanNumber will be set to -1. The channel status entry will also be deleted by this action. apsChanConfigNumber must be set to a unique channel number within the APS group. The value 0 indicates the null channel. The values 1-14 define a working channel. When an attempt is made to set the corresponding apsConfigRowStatus field to active the apsChanConfigNumber values of all entries with equal apsChanConfigGroupName fields must represent a set of consecutive integer values beginning with 0 or 1, depending on the architecture of the group, and ending with n, where n is greater than or equal to 1 and less than or equal to 14. Otherwise, the error inconsistentValue is returned to the apsConfigRowStatus set attempt.

The Interface Index assigned to a SONET LTE. This is an interface with ifType sonet(39). The value of this object must be unique among all instances of apsChanConfigIfIndex. In other words, a particular SONET LTE can only be configured in one APS group. This object cannot be set if the apsChanConfigGroupName instance associated with this row is equal to an instance of apsConfigName and the corresponding apsConfigRowStatus object is set to active. In other words this value cannot be changed if the APS group is active. However, this value may be changed if the apsConfigRowStatus value is equal to notInService.

The priority of the channel. This field determines whether high or low priority SD and SF codes are used in K1 requests. This field is only applicable if the channel is to be included in a group using the 1:n architecture. It is not applicable if the channel is to be included in a group using the 1+1 architecture, and is ignored in that case. This object cannot be set if the apsChanConfigGroupName instance associated with this row is equal to an instance of apsConfigName and the corresponding apsConfigRowStatus object is set to active. In other words this value cannot be changed if the APS group is active. However, this value may be changed if the apsConfigRowStatus value is equal to notInService. Enumeration: 'high': 2, 'low': 1.

The storage type for this conceptual row. Conceptual rows having the value 'permanent' need not allow write-access to any columnar objects in the row.

This table allows commands to be sent to configured APS groups.

A conceptual row in the apsCommandTable. This row exists only if the associated apsConfigEntry is active.

Allows the initiation of an APS switch command on the APS group and channel specified by the index values. When read this object returns the last command written or noCmd if no command has been written to this channel since initialization. The return of the last command written does not imply that this command is currently in effect. This request may have been preempted by a higher priority local or remote request. In order to determine the current state of the APS group it is necessary to read the objects apsStatusK1K2Rcv and apsStatusK1K2Trans. The value lockoutOfProtection should only be applied to the protection line channel since that switch command prevents any of the working channels from switching to the protection line. Following the same logic, forcedSwitchProtectToWork and manualSwitchProtectToWork should only be applied to the protection line channel. forcedSwitchWorkToProtect and manualSwitchWorkToProtect should only be applied to a working channel.

Allows the initiation of an APS control command on the APS group and channel specified by the index values. When read this object returns the last command written or noCmd if no command has been written to this channel since initialization. This object does not apply to the protection line.

This table contains status information for all SONET LTE interfaces that are included in APS groups.

A conceptual row in the apsChanStatusTable.

Indicates the current state of the port. lockedOut This bit, when applied to a working channel, indicates that the channel is prevented from switching to the protection line. When applied to the null channel, this bit indicates that no working channel may switch to the protection line. sd A signal degrade condition is in effect. sf A signal failure condition is in effect. switched The switched bit is applied to a working channel if that channel is currently switched to the protection line. wtr A Wait-to-Restore state is in effect. Bits: 'switched': 3, 'wtr': 4, 'sd': 1, 'sf': 2, 'lockedOut': 0.

A count of Signal Degrade conditions. This condition occurs when the line Bit Error Rate exceeds the currently configured value of the relevant instance of apsConfigSdBerThreshold. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of apsChanStatusDiscontinuityTime.

A count of Signal Failure conditions that have been detected on the incoming signal. This condition occurs when a loss of signal, loss of frame, AIS-L or a Line bit error rate exceeding the currently configured value of the relevant instance of apsConfigSfBerThreshold. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of apsChanStatusDiscontinuityTime.

When queried with index value apsChanConfigNumber other than 0, this object will return the number of times this channel has switched to the protection line. When queried with index value apsChanConfigNumber set to 0, which is the protection line, this object will return the number of times that any working channel has been switched back to the working line from this protection line. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of apsChanStatusDiscontinuityTime.

When queried with index value apsChanConfigNumber other than 0, this object will return the value of sysUpTime when this channel last completed a switch to the protection line. If this channel has never switched to the protection line, the value 0 will be returned. When queried with index value apsChanConfigNumber set to 0, which is the protection line, this object will return the value of sysUpTime the last time that a working channel was switched back to the working line from this protection line. If no working channel has ever switched back to the working line from this protection line, the value 0 will be returned.

The cumulative Protection Switching Duration (PSD) time in seconds. For a working channel, this is the cumulative number of seconds that service was carried on the protection line. For the protection line, this is the cumulative number of seconds that the protection line has been used to carry any working channel traffic. This information is only valid if revertive switching is enabled. The value 0 will be returned otherwise. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of apsChanStatusDiscontinuityTime. For example, if the value of an instance of apsChanStatusSwitchoverSeconds changes from a non-zero value to zero due to revertive switching being disabled, it is expected that the corresponding value of apsChanStatusDiscontinuityTime will be updated to reflect the time of the configuration change.

The value of sysUpTime on the most recent occasion at which any one or more of this channel's counters suffered a discontinuity. The relevant counters are the specific instances associated with this channel of any Counter32 object contained in apsChanStatusTable. If no such discontinuities have occurred since the last re-initialization of the local management subsystem, then this object contains a zero value.

Provides the ability to enable and disable notifications defined in this MIB. switchover Indicates apsEventSwitchover notifications should be generated. modeMismatch Indicates apsEventModeMismatch notifications should be generated. channelMismatch Indicates apsEventChannelMismatch notifications should be generated. psbf Indicates apsEventPSBF notifications should be generated. feplf Indicates apsEventFEPLF notifications should be generated. Bits: 'switchover': 0, 'modeMismatch': 1, 'channelMismatch': 2, 'psbf': 3, 'feplf': 4.

An apsEventSwitchover notification is sent when the value of an instance of apsChanStatusSwitchovers increments.

An apsEventModeMismatch notification is sent when the value of an instance of apsStatusModeMismatches increments.

An apsEventChannelMismatch notification is sent when the value of an instance of apsStatusChannelMismatches increments.

An apsEventPSBF notification is sent when the value of an instance of apsStatusPSBFs increments.

An apsEventFEPLFs notification is sent when the value of an instance of apsStatusFEPLFs increments.

A collection of apsConfigTable objects providing configuration information applicable to all linear APS groups.

The apsConfigTable object that provides information which is applicable to groups supporting a configurable WTR period.

The apsCommandTable object which is applicable to groups implementing the linear APS 1+1 architecture. Also, set operations must be supported.

A collection of apsCommandTable objects which are applicable to groups implementing the linear APS 1:n architecture. Also, set operations must be supported.

A collection of apsStatusTable objects providing status information applicable to all linear APS groups.

A collection of channel objects providing information applicable to all linear APS channels.

The apsChanConfigTable object that provides information which is only applicable to groups implementing the linear APS 1:n architecture.

A collection of objects providing optional counts of configured APS groups and SONET LTE interfaces.

A collection of apsMapTable objects providing a mapping from sonet(39) InterfaceIndex to group name and channel number for assigned APS channels and a list of unassigned sonet(39) interfaces.

A collection of SONET linear APS notifications.

When this MIB is implemented with support for read-create, then such an implementation can claim read/write compliance. Linear APS groups can then be both monitored and configured with this MIB. Note that An agent is not required to process SNMP Set Requests that affect multiple control objects within this MIB. This is intended to simplify the processing of Set Requests for the various control tables by eliminating the possibility that a single Set PDU will contain multiple varbinds which are in conflict.

When this MIB is implemented without support for read-create (i.e. in read-only mode), then that implementation can claim read-only compliance. In that case, linear APS groups can be monitored but cannot be configured with this MIB.