value of an instance of apsStatusPSBFs increments."
::= { apsNotificationsPrefix 4 }
apsEventFEPLF NOTIFICATION-TYPE
OBJECTS { apsStatusFEPLFs, apsStatusCurrent }
STATUS current
DESCRIPTION
"An apsEventFEPLFs notification is sent when the
value of an instance of apsStatusFEPLFs increments."
::= { apsNotificationsPrefix 5 }
-- conformance information
apsGroups OBJECT IDENTIFIER ::= { apsMIBConformance 1 }
apsCompliances OBJECT IDENTIFIER ::= { apsMIBConformance 2 }
apsFullCompliance MODULE-COMPLIANCE
STATUS current
DESCRIPTION
"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. "
MODULE
MANDATORY-GROUPS { apsConfigGeneral, apsStatusGeneral,
apsChanGeneral }
OBJECT apsConfigRowStatus
SYNTAX INTEGER { active(1) }
WRITE-SYNTAX INTEGER { createAndGo(4), destroy(6) }
DESCRIPTION
"Support for createAndWait and notInService is not
required."
OBJECT apsChanConfigRowStatus
SYNTAX INTEGER { active(1) }
WRITE-SYNTAX INTEGER { createAndGo(4), destroy(6) }
DESCRIPTION
"Support for createAndWait and notInService is not
required."
GROUP apsConfigWtr
DESCRIPTION
"Implementation of this group is optional for all
linear APS implementations. The information is
applicable to groups supporting a configurable
WTR period."
GROUP apsCommandOnePlusOne
DESCRIPTION
"Implementation of this group is optional for all
linear APS implementations. The information is
applicable to groups implementing the linear
APS 1+1 architecture and supporting set operations."
GROUP apsCommandOneToN
DESCRIPTION
"Implementation of this group is optional for all
linear APS implementations. The information is
applicable to groups implementing the linear
APS 1:n architecture and supporting set operations."
GROUP apsChanOneToN
DESCRIPTION
"Implementation of this group is optional for all
linear APS implementations. The information is
applicable to groups implementing the linear
APS 1:n architecture."
GROUP apsTotalsGroup
DESCRIPTION
"Implementation of this group is optional for all
linear APS implementations."
GROUP apsMapGroup
DESCRIPTION
"Implementation of this group is optional for all
linear APS implementations."
GROUP apsEventGroup
DESCRIPTION
"Implementation of this group is optional for all
linear APS implementations."
::= { apsCompliances 1 }
--
-- Read-Only Compliance
--
apsReadOnlyCompliance MODULE-COMPLIANCE
STATUS current
DESCRIPTION
"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."
MODULE
MANDATORY-GROUPS { apsConfigGeneral, apsStatusGeneral,
apsChanGeneral }
OBJECT apsConfigMode
MIN-ACCESS read-only
DESCRIPTION
"Write access is not required."
OBJECT apsConfigRevert
MIN-ACCESS read-only
DESCRIPTION
"Write access is not required."
OBJECT apsConfigDirection
MIN-ACCESS read-only
DESCRIPTION
"Write access is not required."
OBJECT apsConfigExtraTraffic
MIN-ACCESS read-only
DESCRIPTION
"Write access is not required."
OBJECT apsConfigSdBerThreshold
MIN-ACCESS read-only
DESCRIPTION
"Write access is not required."
OBJECT apsConfigSfBerThreshold
MIN-ACCESS read-only
DESCRIPTION
"Write access is not required."
OBJECT apsConfigWaitToRestore
MIN-ACCESS read-only
DESCRIPTION
"Write access is not required."
OBJECT apsConfigRowStatus
SYNTAX INTEGER { active(1) }
MIN-ACCESS read-only
DESCRIPTION
"Write access is not required, and active is the only status
that needs to be supported."
OBJECT apsConfigStorageType
MIN-ACCESS read-only
DESCRIPTION
"Write access is not required."
OBJECT apsChanConfigIfIndex
MIN-ACCESS read-only
DESCRIPTION
"Write access is not required."
OBJECT apsChanConfigPriority
MIN-ACCESS read-only
DESCRIPTION
"Write access is not required."
OBJECT apsChanConfigRowStatus
SYNTAX INTEGER { active(1) }
MIN-ACCESS read-only
DESCRIPTION
"Write access is not required, and active is the only status
that needs to be supported."
OBJECT apsChanConfigStorageType
MIN-ACCESS read-only
DESCRIPTION
"Write access is not required."
OBJECT apsNotificationEnable
MIN-ACCESS read-only
DESCRIPTION
"Write access is not required."
GROUP apsConfigWtr
DESCRIPTION
"Implementation of this group is optional for all
linear APS implementations. The information is
applicable to groups supporting a configurable
WTR period."
GROUP apsCommandOnePlusOne
DESCRIPTION
"Implementation of this group is optional for all
linear APS implementations. The information is
applicable to groups implementing the linear
APS 1+1 architecture and supporting set operations."
GROUP apsCommandOneToN
DESCRIPTION
"Implementation of this group is optional for all
linear APS implementations. The information is
applicable to groups implementing the linear
APS 1:n architecture and supporting set operations."
GROUP apsChanOneToN
DESCRIPTION
"Implementation of this group is optional for all
linear APS implementations. The information is
applicable to groups implementing the linear
APS 1:n architecture."
GROUP apsTotalsGroup
DESCRIPTION
"Implementation of this group is optional for all
linear APS implementations."
GROUP apsMapGroup
DESCRIPTION
"Implementation of this group is optional for all
linear APS implementations."
GROUP apsEventGroup
DESCRIPTION
"Implementation of this group is optional for all
linear APS implementations."
::= { apsCompliances 2 }
-- units of conformance
apsConfigGeneral OBJECT-GROUP
OBJECTS
{
apsConfigMode,
apsConfigRevert,
apsConfigDirection,
apsConfigExtraTraffic,
apsConfigSdBerThreshold,
apsConfigSfBerThreshold,
apsConfigCreationTime,
apsConfigRowStatus,
apsConfigStorageType,
apsNotificationEnable
}
STATUS current
DESCRIPTION
"A collection of apsConfigTable objects providing configuration
information applicable to all linear APS groups."
::= { apsGroups 1 }
apsConfigWtr OBJECT-GROUP
OBJECTS
{
apsConfigWaitToRestore
}
STATUS current
DESCRIPTION
"The apsConfigTable object that provides information which is
applicable to groups supporting a configurable WTR period."
::= { apsGroups 2 }
-- If set operations are not supported neither of the following two
-- groups are implemented. If sets are supported only one of these
-- groups is implemented for a linear APS group instance.
apsCommandOnePlusOne OBJECT-GROUP
OBJECTS
{
apsCommandSwitch
}
STATUS current
DESCRIPTION
"The apsCommandTable object which is applicable to groups
implementing the linear APS 1+1 architecture. Also, set
operations must be supported."
::= { apsGroups 3 }
apsCommandOneToN OBJECT-GROUP
OBJECTS
{
apsCommandSwitch,
apsCommandControl
}
STATUS current
DESCRIPTION
"A collection of apsCommandTable objects which are applicable to
groups implementing the linear APS 1:n architecture. Also, set
operations must be supported."
::= { apsGroups 4 }
apsStatusGeneral OBJECT-GROUP
OBJECTS
{
apsStatusK1K2Rcv,
apsStatusK1K2Trans,
apsStatusCurrent,
apsStatusModeMismatches,
apsStatusChannelMismatches,
apsStatusPSBFs,
apsStatusFEPLFs,
apsStatusSwitchedChannel,
apsStatusDiscontinuityTime
}
STATUS current
DESCRIPTION
"A collection of apsStatusTable objects providing status
information applicable to all linear APS groups."
::= { apsGroups 5 }
apsChanGeneral OBJECT-GROUP
OBJECTS
{
apsChanConfigIfIndex,
apsChanConfigRowStatus,
apsChanConfigStorageType,
apsChanStatusCurrent,
apsChanStatusSignalDegrades,
apsChanStatusSignalFailures,
apsChanStatusSwitchovers,
apsChanStatusLastSwitchover,
apsChanStatusSwitchoverSeconds,
apsChanStatusDiscontinuityTime
}
STATUS current
DESCRIPTION
"A collection of channel objects providing information
applicable to all linear APS channels."
::= { apsGroups 6 }
apsChanOneToN OBJECT-GROUP
OBJECTS
{
apsChanConfigPriority
}
STATUS current
DESCRIPTION
"The apsChanConfigTable object that provides information which
is only applicable to groups implementing the linear APS 1:n
architecture."
::= { apsGroups 7 }
apsTotalsGroup OBJECT-GROUP
OBJECTS
{
apsConfigGroups,
apsChanLTEs
}
STATUS current
DESCRIPTION
"A collection of objects providing optional counts of configured
APS groups and SONET LTE interfaces."
::= { apsGroups 8 }
apsMapGroup OBJECT-GROUP
OBJECTS
{
apsMapGroupName,
apsMapChanNumber
}
STATUS current
DESCRIPTION
"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."
::= { apsGroups 9 }
apsEventGroup NOTIFICATION-GROUP
NOTIFICATIONS {apsEventSwitchover, apsEventModeMismatch,
apsEventChannelMismatch, apsEventPSBF,
apsEventFEPLF }
STATUS current
DESCRIPTION
"A collection of SONET linear APS notifications."
::= { apsGroups 10 }
END
5. Intellectual Property
The IETF takes no position regarding the validity or scope of any
intellectual property or other rights that might be claimed to
pertain to the implementation or use of the technology described in
this document or the extent to which any license under such rights
might or might not be available; neither does it represent that it
has made any effort to identify any such rights. Information on the
IETF's procedures with respect to rights in standards-track and
standards-related documentation can be found in [BCP11]. Copies of
claims of rights made available for publication and any assurances of
licenses to be made available, or the result of an attempt made to
obtain a general license or permission for the use of such
proprietary rights by implementors or users of this specification can
be obtained from the IETF Secretariat.
The IETF invites any interested party to bring to its attention any
copyrights, patents or patent applications, or other proprietary
rights which may cover technology that may be required to practice
this standard. Please address the information to the IETF Executive
Director.
6. Acknowledgments
This document is a product of the AToMMIB Working Group. A number of
constructs from a separate draft submission by Ken Chapman have been
included here. Suggestions by Orly Nicklass, Faye Ly, Ron Carmona,
Kaj Tesink, C. M. Heard, Muly Ilan, and Mickey Spiegel have been
incorporated. A quality review was provided by Lauren Heintz and an
IESG review by John Flick and Bert Wijnen.
7. Normative References
[RFC2578] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J.,
Rose, M. and S. Waldbusser, "Structure of Management
Information Version 2 (SMIv2)", STD 58, RFC2578, April
1999.
[RFC2579] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J.,
Rose, M. and S. Waldbusser, "Textual Conventions for
SMIv2", STD 58, RFC2579, April 1999.
[RFC2580] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J.,
Rose, M. and S. Waldbusser, "Conformance Statements for
SMIv2", STD 58, RFC2580, April 1999.
[RFC2863] McCloghrie, K. and F. Kastenholz, "The Interfaces Group
MIB", RFC2863, June 2000.
[GR253CO] GR-253-CORE Issue 3, September 2000
[G.783] ITU-T Recommendation G.783 (04/97)
8. Informative References
[RFC3410] Case, J., Mundy, R., Partain, D. and B. Stewart,
"Introduction and Applicability Statements for Internet-
Standard Management Framework", RFC3410, December 2002.
[BCP11] Hovey, R, "The Organizations Involved in the IETF Standards
Process", BCP 11, RFC2028, October 1996.
9. Security Considerations
There are a number of management objects defined in this MIB that
have a MAX-ACCESS clause of read-write and/or read-create. Such
objects may be considered sensitive or vulnerable in some network
environments. The support for SET operations in a non-secure
environment without proper protection can have a negative effect on
network operations. In particular, the APS command objects
apsCommandSwitch and apsCommandControl and the APS configuration
objects apsConfigRowStatus, apsConfigMode, apsConfigRevert,
apsConfigDirection, apsConfigExtraTraffic, apsConfigSdBerThreshold,
apsConfigSfBerThreshold, apsConfigWaitToRestore,
apsConfigStorageType, apsChanConfigRowStatus, apsChanConfigIfIndex,
apsChanConfigPriority, apsChanConfigStorageType and
apsNotificationEnable have the potential of disrupting APS operations
if set operations are performed with malicious intent.
SNMP versions prior to SNMPv3 did not include adequate security.
Even if the network itself is secure (for example by using IPSec),
there is no control as to who on the secure network is allowed to
access and GET/SET (read/change/create/delete) the objects in this
MIB module.
It is recommended that implementers consider the security features as
provided by the SNMPv3 framework (see [RFC3410], section 8),
including full support for the SNMPv3 cryptographic mechanisms (for
authentication and privacy).
Further, deployment of SNMP versions prior to SNMPv3 is not
recommended. Instead, it is recommended to deploy SNMPv3 and to
enable cryptographic security. It is then a customer/operator
responsibility to ensure that access to an instance of this MIB
module is properly configured for only those principals (users) that
have legitimate rights to GET or SET object instances.
10. Editors' Addresses
Jim Kuhfeld
RedBack Networks. Inc.
300 Holger Way
San Jose, CA 95134-1362
Phone: +1 408 750 5465
EMail: jkuhfeld@redback.com
Jeff Johnson
RedBack Networks. Inc.
300 Holger Way
San Jose, CA 95134-1362
Phone: +1 408 750 5460
EMail: jeff@redback.com
Michael Thatcher
RedBack Networks. Inc.
300 Holger Way
San Jose, CA 95134-1362
Phone: +1 408 750 5449
EMail: thatcher@redback.com
11. Full Copyright Statement
Copyright (C) The Internet Society (2003). All Rights Reserved.
This document and translations of it may be copied and furnished to
others, and derivative works that comment on or otherwise explain it
or assist in its implementation may be prepared, copied, published
and distributed, in whole or in part, without restriction of any
kind, provided that the above copyright notice and this paragraph are
included on all such copies and derivative works. However, this
document itself may not be modified in any way, such as by removing
the copyright notice or references to the Internet Society or other
Internet organizations, except as needed for the purpose of
developing Internet standards in which case the procedures for
copyrights defined in the Internet Standards process must be
followed, or as required to translate it into languages other than
English.
The limited permissions granted above are perpetual and will not be
revoked by the Internet Society or its successors or assigns.
This document and the information contained herein is provided on an
"AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING
TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING
BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION
HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
Acknowledgement
Funding for the RFCEditor function is currently provided by the
Internet Society.