589 lines
17 KiB
Plaintext
589 lines
17 KiB
Plaintext
-- This file is corresponding to Release 9.1.10.101 from 2014/08/11 00:00:00
|
|
|
|
|
|
-- (C)opyright 2004-2014 bintec elmeg GmbH, All Rights Reserved
|
|
-- $RCSfile: mibapdisc,v $
|
|
-- $Revision: 1.14 $
|
|
|
|
APDISC-MIB DEFINITIONS ::= BEGIN
|
|
|
|
|
|
IMPORTS
|
|
NetworkAddress, IpAddress, TimeTicks, enterprises
|
|
FROM RFC1155-SMI
|
|
|
|
DisplayString
|
|
FROM RFC1158-MIB
|
|
|
|
Date
|
|
FROM BINTEC-MIB
|
|
OBJECT-TYPE
|
|
FROM RFC-1212
|
|
MacAddress
|
|
FROM SNMPv2-TC;
|
|
|
|
bintec OBJECT IDENTIFIER ::= { enterprises 272 }
|
|
bibo OBJECT IDENTIFIER ::= { bintec 4 }
|
|
admin OBJECT IDENTIFIER ::= { bibo 1 }
|
|
apdisc OBJECT IDENTIFIER
|
|
::= { bibo 49 }
|
|
|
|
-- Apdisc Group
|
|
|
|
-- ApDiscProto ::= INTEGER { artem(1) }
|
|
-- The protocol for access point discovery
|
|
|
|
|
|
apDiscCtrlTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF ApDiscCtrlEntry
|
|
ACCESS not-accessible
|
|
STATUS mandatory
|
|
DESCRIPTION
|
|
"This table holds the interfaces configured for access point disovery.
|
|
An entry in this table is identified by the interface index and the
|
|
protocol to be used for the discovery.
|
|
|
|
A successfull discovery creates related entries in apDiscTable and
|
|
apDiscSetTable for each discovered access point. Deleting an entry in
|
|
this table removes also the related entries in apDiscTable and
|
|
apDiscSetTable.
|
|
|
|
All variables in this table are volatile and not stored permanently."
|
|
|
|
::= { apdisc 1 }
|
|
|
|
apDiscCtrlEntry OBJECT-TYPE
|
|
SYNTAX ApDiscCtrlEntry
|
|
ACCESS not-accessible
|
|
STATUS mandatory
|
|
DESCRIPTION
|
|
"The access point discovery control information."
|
|
INDEX { apDiscCtrlIfIndex, apDiscCtrlProto }
|
|
::= { apDiscCtrlTable 1 }
|
|
|
|
ApDiscCtrlEntry ::=
|
|
SEQUENCE {
|
|
apDiscCtrlIfIndex
|
|
INTEGER,
|
|
apDiscCtrlProto
|
|
INTEGER,
|
|
apDiscCtrlOperation
|
|
INTEGER,
|
|
apDiscCtrlResult
|
|
INTEGER,
|
|
apDiscCtrlLastRun
|
|
Date,
|
|
apDiscCtrlLimit
|
|
INTEGER
|
|
}
|
|
|
|
|
|
apDiscCtrlIfIndex OBJECT-TYPE
|
|
SYNTAX INTEGER
|
|
ACCESS read-write
|
|
STATUS mandatory
|
|
DESCRIPTION
|
|
"This variable identifies on which interface the access point
|
|
discovery is to be performed. The interface is identified by its
|
|
index in the ifTable."
|
|
|
|
::= { apDiscCtrlEntry 1 }
|
|
|
|
|
|
apDiscCtrlProto OBJECT-TYPE
|
|
SYNTAX INTEGER { artem(1) }
|
|
ACCESS read-write
|
|
STATUS mandatory
|
|
DESCRIPTION
|
|
"This indicates which access point discovery is to be performed.
|
|
Currently only ARtem access points can be discovered. This is a
|
|
proprietary discovery protocol, which uses IP multicast protocol
|
|
with group address 239.239.239.239 and UPD port 1111."
|
|
DEFVAL { artem }
|
|
|
|
::= { apDiscCtrlEntry 2 }
|
|
|
|
apDiscCtrlOperation OBJECT-TYPE
|
|
SYNTAX INTEGER {
|
|
none(1),
|
|
discovery(2),
|
|
delete(3)
|
|
}
|
|
ACCESS read-write
|
|
STATUS mandatory
|
|
DESCRIPTION
|
|
"Setting this variable to 'discovery' initiates the discovery. After the
|
|
discovery it is autonomously changed to 'none'. Setting this variable
|
|
to 'delete' deletes the entry and all related entries in apDiscTable
|
|
and apDiscSetTable."
|
|
DEFVAL { none }
|
|
|
|
::= { apDiscCtrlEntry 3 }
|
|
|
|
apDiscCtrlResult OBJECT-TYPE
|
|
SYNTAX INTEGER {
|
|
noError(1),
|
|
destUnreachable(2),
|
|
internalError(3)
|
|
}
|
|
ACCESS read-only
|
|
STATUS mandatory
|
|
DESCRIPTION
|
|
"This variable indicates the result of the discovery operation after
|
|
the operation has finished.
|
|
|
|
'noError': no discovery has been initiated or discovery was a success.
|
|
|
|
'destUnreachable': the interface is currently not usable.
|
|
Interface is not operational, has no IP address assigned or
|
|
has no associated direct route. The request could not be sent.
|
|
|
|
'internalError': an internal error was detected, discovery not
|
|
initiated. Enabling logging and debugging might reveal more
|
|
information in this case."
|
|
|
|
DEFVAL { noError }
|
|
|
|
::= { apDiscCtrlEntry 4 }
|
|
|
|
|
|
apDiscCtrlLastRun OBJECT-TYPE
|
|
SYNTAX Date
|
|
ACCESS read-only
|
|
STATUS mandatory
|
|
DESCRIPTION
|
|
"The time (GMT) of the last successful access point discovery
|
|
given in seconds since 01/01/1970 00:00:00. A value of 0 indicates
|
|
that no successful discovery had been run yet."
|
|
|
|
::= { apDiscCtrlEntry 5 }
|
|
|
|
|
|
apDiscCtrlLimit OBJECT-TYPE
|
|
SYNTAX INTEGER
|
|
ACCESS read-write
|
|
STATUS mandatory
|
|
DESCRIPTION
|
|
"This variable limits how many replies from APs are to be stored.
|
|
The replies exceeding this value are discarded. This avoids a
|
|
DOS vulnerability where one may flood us with wrong answers. If
|
|
this limit is reached a syslog message is generated."
|
|
DEFVAL { 100 }
|
|
|
|
::= { apDiscCtrlEntry 6 }
|
|
|
|
|
|
apDiscTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF ApDiscEntry
|
|
ACCESS not-accessible
|
|
STATUS mandatory
|
|
DESCRIPTION
|
|
"In this table the discovered access points are listed with the
|
|
retrieved information like node name, IP address, netmask and
|
|
gateway address. An entry in this table is identified by the
|
|
interface on which the access point was found, by the utilized
|
|
discovery protocol and the MAC address of the access point.
|
|
|
|
Entries in this table are created autonomously by the system for
|
|
each discovered access point, and are autonomously deleted if the
|
|
access point is not found anymore at the next discovery. All
|
|
entries in this table belonging to an interface are deleted, if
|
|
the corresponding entry is deleted from the apDiscCtrlTable.
|
|
|
|
All variables in this table are volatile and not stored permanently."
|
|
|
|
::= { apdisc 2 }
|
|
|
|
|
|
apDiscEntry OBJECT-TYPE
|
|
SYNTAX ApDiscEntry
|
|
ACCESS not-accessible
|
|
STATUS mandatory
|
|
DESCRIPTION
|
|
"An entry for a discovered access point."
|
|
INDEX { apDiscIfIndex, apDiscProto, apDiscMacAddress }
|
|
::= { apDiscTable 1 }
|
|
|
|
ApDiscEntry ::=
|
|
SEQUENCE {
|
|
apDiscIfIndex INTEGER,
|
|
apDiscProto INTEGER,
|
|
apDiscMacAddress MacAddress,
|
|
apDiscNodeName DisplayString,
|
|
apDiscIpStatus INTEGER,
|
|
apDiscIpAddress IpAddress,
|
|
apDiscNetMask IpAddress,
|
|
apDiscGwAddress IpAddress,
|
|
apDiscLastChange Date,
|
|
apDiscSerialNumber DisplayString,
|
|
apDiscSysDescription DisplayString,
|
|
apDiscVersionString DisplayString
|
|
}
|
|
|
|
|
|
apDiscIfIndex OBJECT-TYPE
|
|
SYNTAX INTEGER
|
|
ACCESS read-only
|
|
STATUS mandatory
|
|
DESCRIPTION
|
|
"The interface on which the access point was detected. The
|
|
interface is identified by its interface index in the
|
|
ifTable."
|
|
|
|
::= { apDiscEntry 1 }
|
|
|
|
|
|
apDiscProto OBJECT-TYPE
|
|
SYNTAX INTEGER { artem(1) }
|
|
ACCESS read-only
|
|
STATUS mandatory
|
|
DESCRIPTION
|
|
"This indicates via which discovery protocol the access
|
|
point was found. Currently only the protocol to discover
|
|
ARtem access points is supported. This is protocol uses
|
|
IP multicast protocol with group address 239.239.239.239
|
|
and UPD port 1111."
|
|
|
|
::= { apDiscEntry 2 }
|
|
|
|
apDiscMacAddress OBJECT-TYPE
|
|
SYNTAX MacAddress
|
|
ACCESS read-only
|
|
STATUS mandatory
|
|
DESCRIPTION
|
|
"The MAC address of the found access point. The ARtem
|
|
access points report via the discovery protocol the MAC
|
|
address of their first ethernet-like interface."
|
|
|
|
::= { apDiscEntry 3 }
|
|
|
|
apDiscNodeName OBJECT-TYPE
|
|
SYNTAX DisplayString (SIZE (0..32))
|
|
ACCESS read-only
|
|
STATUS mandatory
|
|
DESCRIPTION
|
|
"The node name of the access point."
|
|
DEFVAL { "" }
|
|
|
|
::= { apDiscEntry 4 }
|
|
|
|
|
|
apDiscIpStatus OBJECT-TYPE
|
|
SYNTAX INTEGER { unknown(1), static(2), dhcpLease(3),
|
|
dhcpFailed(4) }
|
|
ACCESS read-only
|
|
STATUS mandatory
|
|
DESCRIPTION
|
|
"This indicates how the access point got its IP address,
|
|
netmask and gateway address. 'unknown' means that the
|
|
access point does not give an indication how these values
|
|
have been set, 'static' indicates that the values have been
|
|
set statically or manually, 'dhcpLease' means that the
|
|
values have been set via DHCP, 'dhcpFailed' means that DCHP
|
|
request failed."
|
|
DEFVAL { unknown }
|
|
|
|
::= { apDiscEntry 5 }
|
|
|
|
|
|
apDiscIpAddress OBJECT-TYPE
|
|
SYNTAX IpAddress
|
|
ACCESS read-only
|
|
STATUS mandatory
|
|
DESCRIPTION
|
|
"The IP address of the access point."
|
|
|
|
::= { apDiscEntry 6 }
|
|
|
|
|
|
apDiscNetMask OBJECT-TYPE
|
|
SYNTAX IpAddress
|
|
ACCESS read-only
|
|
STATUS mandatory
|
|
DESCRIPTION
|
|
"The netmask of the access point."
|
|
|
|
::= { apDiscEntry 7 }
|
|
|
|
|
|
apDiscGwAddress OBJECT-TYPE
|
|
SYNTAX IpAddress
|
|
ACCESS read-only
|
|
STATUS mandatory
|
|
DESCRIPTION
|
|
"The gateway address of the access point."
|
|
|
|
::= { apDiscEntry 8 }
|
|
|
|
|
|
apDiscLastChange OBJECT-TYPE
|
|
SYNTAX Date
|
|
ACCESS read-only
|
|
STATUS mandatory
|
|
DESCRIPTION
|
|
"The time (GMT) when the access point was initially
|
|
discovered or has changed its networking configuration
|
|
given in seconds since 01/01/1970 00:00:00."
|
|
|
|
::= { apDiscEntry 9 }
|
|
|
|
|
|
apDiscSerialNumber OBJECT-TYPE
|
|
SYNTAX DisplayString (SIZE (0..32))
|
|
ACCESS read-only
|
|
STATUS mandatory
|
|
DESCRIPTION
|
|
"The serial number of the access point."
|
|
|
|
::= { apDiscEntry 10 }
|
|
|
|
|
|
apDiscSysDescription OBJECT-TYPE
|
|
SYNTAX DisplayString (SIZE (0..64))
|
|
ACCESS read-only
|
|
STATUS mandatory
|
|
DESCRIPTION
|
|
"The system description of the access point."
|
|
|
|
::= { apDiscEntry 11 }
|
|
|
|
|
|
apDiscVersionString OBJECT-TYPE
|
|
SYNTAX DisplayString (SIZE (0..64))
|
|
ACCESS read-only
|
|
STATUS mandatory
|
|
DESCRIPTION
|
|
"The version string of the access point."
|
|
|
|
::= { apDiscEntry 12 }
|
|
|
|
|
|
apDiscSetTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF ApDiscSetEntry
|
|
ACCESS not-accessible
|
|
STATUS mandatory
|
|
DESCRIPTION
|
|
"This table holds one entry for each discovered access point
|
|
allowing to configure the access point's network parameters
|
|
like node name, IP address, netmask and gateway address.
|
|
Whether the change was successful or not is indicated via
|
|
apDiscSetResult. Each access point is identified in this
|
|
table by the interface on which it was detected and its MAC
|
|
address.
|
|
An entry in this table is created autonomously by the system
|
|
for each discovered access point. An entry is autonomously
|
|
deleted if the access point does not reply at the next
|
|
discovery. All entries in this table belonging to an interface
|
|
are deleted if the corresponding entry is deleted from the
|
|
apDiscCtrlTable.
|
|
|
|
All variables in this table are volatile and not stored
|
|
permanently. However the networking parameters are sent to
|
|
the access point and stored in its configuration."
|
|
|
|
|
|
::= { apdisc 3 }
|
|
|
|
|
|
apDiscSetEntry OBJECT-TYPE
|
|
SYNTAX ApDiscSetEntry
|
|
ACCESS not-accessible
|
|
STATUS mandatory
|
|
DESCRIPTION
|
|
"An entry fo an discovered access point allowing to set
|
|
network parameters."
|
|
INDEX { apDiscSetIfIndex, apDiscSetProto, apDiscSetMacAddress }
|
|
::= { apDiscSetTable 1 }
|
|
|
|
ApDiscSetEntry ::=
|
|
SEQUENCE {
|
|
apDiscSetIfIndex
|
|
INTEGER,
|
|
apDiscSetProto
|
|
INTEGER,
|
|
apDiscSetMacAddress
|
|
MacAddress,
|
|
apDiscSetNodeName
|
|
DisplayString,
|
|
apDiscSetIpAddress
|
|
IpAddress,
|
|
apDiscSetNetMask
|
|
IpAddress,
|
|
apDiscSetGwAddress
|
|
IpAddress,
|
|
apDiscSetAdminPassword
|
|
DisplayString,
|
|
apDiscSetOperation
|
|
INTEGER,
|
|
apDiscSetResult
|
|
INTEGER
|
|
}
|
|
|
|
|
|
apDiscSetIfIndex OBJECT-TYPE
|
|
SYNTAX INTEGER
|
|
ACCESS read-only
|
|
STATUS mandatory
|
|
DESCRIPTION
|
|
"The interface on which the access point was detected.
|
|
The interface is identified by its interface index in
|
|
the ifTable."
|
|
|
|
::= { apDiscSetEntry 1 }
|
|
|
|
|
|
apDiscSetProto OBJECT-TYPE
|
|
SYNTAX INTEGER { artem(1) }
|
|
ACCESS read-only
|
|
STATUS mandatory
|
|
DESCRIPTION
|
|
"This indicates via which protocol the access point is
|
|
addressed. Currently only the protocol to discover
|
|
ARtem access points is supported. This is protocol uses
|
|
IP multicast protocol with group address 239.239.239.239
|
|
and UPD port 1111."
|
|
::= { apDiscSetEntry 2 }
|
|
|
|
apDiscSetMacAddress OBJECT-TYPE
|
|
SYNTAX MacAddress
|
|
ACCESS read-only
|
|
STATUS mandatory
|
|
DESCRIPTION
|
|
"The MAC address of the access point. The ARtem
|
|
access points report via the discovery protocol the MAC
|
|
address of their first ethernet-like interface."
|
|
|
|
::= { apDiscSetEntry 3 }
|
|
|
|
apDiscSetNodeName OBJECT-TYPE
|
|
SYNTAX DisplayString (SIZE (0..32))
|
|
ACCESS read-write
|
|
STATUS mandatory
|
|
DESCRIPTION
|
|
"The new node name of the access point to be used in
|
|
the next set request."
|
|
DEFVAL { "" }
|
|
|
|
::= { apDiscSetEntry 4 }
|
|
|
|
apDiscSetIpAddress OBJECT-TYPE
|
|
SYNTAX IpAddress
|
|
ACCESS read-write
|
|
STATUS mandatory
|
|
DESCRIPTION
|
|
"The new IP address of the access point to be used in
|
|
the next set request. The access point uses DHCP if
|
|
apDiscSetIpAddress, apDiscSetNetmask and apDiscSetGwAddress
|
|
are all set to '0.0.0.0'."
|
|
|
|
::= { apDiscSetEntry 5 }
|
|
|
|
|
|
apDiscSetNetMask OBJECT-TYPE
|
|
SYNTAX IpAddress
|
|
ACCESS read-write
|
|
STATUS mandatory
|
|
DESCRIPTION
|
|
"The new netmask of the access point to be used in the
|
|
next set request. The access point uses DHCP if
|
|
apDiscSetIpAddress, apDiscSetNetmask and apDiscSetGwAddress
|
|
are all set to '0.0.0.0'."
|
|
|
|
::= { apDiscSetEntry 6 }
|
|
|
|
|
|
apDiscSetGwAddress OBJECT-TYPE
|
|
SYNTAX IpAddress
|
|
ACCESS read-write
|
|
STATUS mandatory
|
|
DESCRIPTION
|
|
"The new gateway address of the access point to be used
|
|
in the next set request. The gateway address must be in
|
|
the network defined by apDiscSetIpAddress and the
|
|
apDiscSetNetmask. The access point uses DHCP if
|
|
apDiscSetIpAddress, apDiscSetNetmask and apDiscSetGwAddress
|
|
are all set to '0.0.0.0'."
|
|
|
|
::= { apDiscSetEntry 7 }
|
|
|
|
|
|
apDiscSetAdminPassword OBJECT-TYPE
|
|
SYNTAX DisplayString (SIZE(0..64))
|
|
ACCESS read-write
|
|
STATUS mandatory
|
|
DESCRIPTION
|
|
"The access point's password of the administrative user
|
|
account to authorize the set request."
|
|
|
|
::= { apDiscSetEntry 8 }
|
|
|
|
apDiscSetOperation OBJECT-TYPE
|
|
SYNTAX INTEGER { none(1), set(2) }
|
|
ACCESS read-write
|
|
STATUS mandatory
|
|
DESCRIPTION
|
|
"This variable allows to initiate a set operation. After
|
|
the set operation is performed the variable apDiscSetResult
|
|
is updated autonomously to reflect the result of the operation.
|
|
|
|
'none': no set operation is performed or set operation has
|
|
finished.
|
|
|
|
'set': initiate the set request."
|
|
|
|
DEFVAL { none }
|
|
::= { apDiscSetEntry 9 }
|
|
|
|
apDiscSetResult OBJECT-TYPE
|
|
SYNTAX INTEGER { noError(1), invalidIpParam(2),
|
|
accessDenied(3), otherError(4),
|
|
destUnreachable(5), timeout(6),
|
|
internalError(7) }
|
|
ACCESS read-only
|
|
STATUS mandatory
|
|
DESCRIPTION
|
|
"This variable indicates the result of the set operation
|
|
after the operation has finished.
|
|
|
|
'noError': no set operation performed or operation was a
|
|
success.
|
|
|
|
'invalidIpParam': either no proper netmask was specified,
|
|
or the gateway address does not fit to the IP address and
|
|
netmask.
|
|
|
|
'accessDenied': authorization for set operation failed.
|
|
|
|
'otherError': access point replied with an unexpected error.
|
|
Logging and debugging might reveal more information in this
|
|
case.
|
|
|
|
'destUnreachable': the interface is currently not usable.
|
|
Interface is not operational or has no IP address assigned.
|
|
The request could not be sent.
|
|
|
|
'timeout': no response to set request.
|
|
|
|
'internalError': an internal problem detected. The request
|
|
could not be sent. Enabling log and debug messages might
|
|
reveal more information in this case."
|
|
|
|
DEFVAL { noError }
|
|
|
|
::= { apDiscSetEntry 10 }
|
|
|
|
apDiscControl OBJECT IDENTIFIER
|
|
::= { apdisc 4 }
|
|
|
|
apDiscServerEnable OBJECT-TYPE
|
|
SYNTAX INTEGER { enable(1), disable(2)}
|
|
ACCESS read-write
|
|
STATUS mandatory
|
|
DESCRIPTION
|
|
"Enable/disable the discovery server."
|
|
DEFVAL { disable }
|
|
::= { apDiscControl 1 }
|
|
|
|
|
|
END
|