Introduction
This Guide documents the REST API (REpresentational State Transfer API) that exists on the Panorama Server. This interface provides a means of programmatic network discovery, configuration and status retrieval for the Tellabs Optical LAN. Data is exchanged in JSON (JavaScript Object Notation). Requests are processed by the Panorama server and sent to the OLT using the standard Panorama to OLT interface.
General Structure
The Panorama REST interface provides a means to manage the Tellabs OLAN using HTTP methods. The client sends messages to the server in requests, while the server replies with information in responses.
The REST Request
The request is composed of four items; the endpoint, method, headers, and data (or body).
The Endpoint
The endpoint (or route) is the URL requests are sent to. The path of the URL determines the resource used to handle the request. The single resource in the Panorama REST interface has the format:
https://<_SERVER_>:8081/oam/oam-bin
where <_SERVER_> is the IP Address or domain name of the Panorama server host machine.
The Method
The method is the type of HTTP request to be sent to the server. All requests implemented by the Panorama REST interface are POST messages.
The Headers
Headers are used to provide information to both the client and server. They can be used for many purposes, such as authentication and providing information about the body content. HTTP Headers are property-value pairs that are separated by a colon.
The Data
The data (sometimes called "body" or "message") contains the information to be sent to the server. The data used in the body of a Panorama REST API request is a JSON object composed of the following parameters:
| prefix |
Each request has a prefix parameter, which specifies the object of the operation. The prefix parameter can be composed of multiple tokens. This provides a logical interface structure based on object hierarchy and grouping. The supported prefixes are:
alarms - Alarms related commands, only applicable actions are show and getAllProbableCauses.
olt - OLT related commands
ont - ONT related commands, no secondary prefix supported yet
esl - ONT UNI Ethernet port-related commands
esl lldp - Link Layer Discovery Protocol related
esl stp - Spanning Tree Protocol Related
esl pm - Performance monitoring data
xconn - Crossconnect paradigm being used to represent VLAN associations to ports
voiceLine - Analog voice-related commands, including configuration, status, voice line testing
ifc - Interface related commands
ifc pon - PON port related commands
ifc vlan - VLAN property related commands
ifc vlanassign - VLAN assignment related commands
ifc lag - Uplink related commands
ifc eth mac - For MAC address searching
profile - Profile related commands
user - User management related commands
auth - Authentication (namely SSO) related commands
|
| action |
Each request has an action parameter, which specifies the type of the operation. The supported actions are:
show - Retrieve the data configured for an object.
edit - Change the data configured for an object.
status - Retrieve the current status of an object.
statistics - Retrieve the statistical counters for an object.
getAllProbableCauses - Retrieve all alarm causes (alarms prefix only).
SWDn - Download a specific software load to an OLT (olt prefix only).
SWSwitch - Switch software loads (olt prefix only).
SWDnStatus - Retrieve software download status (olt prefix only).
SWSwitchStatus - Retrieve software switch status (olt prefix only).
SWStatus - Retrieve software information (olt prefix only).
|
| tid |
The tid (Target Identifier) parmeter is the name of a specific OLT. The tid parameter can be used to narrow the scope of an operation. It can also serve as a wild card, in certain commands, when set to the empty string (""). |
| aid |
The aid (Access Identifier) parameter is a unique identifier that specifies an object within the OLT. The aid parameter can be used to narrow the scope of an operation. It can also serve as a wild card, when set to the empty string (""), in certain commands. |
| filter |
The filter parameter is a JSON array (possibly complex) that can further limit the scope of an operation. The allowed values, for the filter are command specific.
Syntax: filter: [ { filter1:value1 }, { filter2:value2 } ]
|
| attributes |
The attributes parameter is a JSON array (possibly complex). It can be used, in certain commands, to further limit the scope of the operation. However, the main role of the attributes parameter is to provide values to update an object configuration in edit operations. The allowed values, for the attributes parameter are command specific.
Syntax: attributes: [ { attr1: [ value1a, value1b, value1c ] }, { attr2:value2 } ]
|
Putting it Together
The code samples below illustrate a request in the Panorama REST API.
| Format |
Example: JSON Object Data |
Example: JSON Object Data(Windows) |
Example: JSON File Data |
Rest Interfaces
- OLT Related REST
- PON Related REST
- ONT Related REST
- UNI Related REST
- Voice Line Related REST
- VLAN Related REST
Attribute Dictionary
This section will define all the possible attributes that can be used in requests and their values.
acFailWaitTime
| Name |
acFailWaitTime (Video) |
| Description |
Defines the number of seconds to wait before interrupting RF video services when the AC power fails. For ONTs with battery backup, this helps preserve battery life and lifeline POTs service as long as possible. |
| Allowed Values |
0 to 1800 in 30 second increments
default: 30
Note: Setting this attribute to zero will disable this feature and Video will never shut off. |
| Access |
read/write |
acRestoreWaitTime
| Name |
acRestoreWaitTime (Video) |
| Description |
Defines the number of seconds to wait before re-enabling RF video service after AC power is restored. This helps provide hysteresis in the event that AC power is going up and down. |
| Allowed Values |
0 to 1800 in 30 second increments
default: 30
Note: Setting this attribute to zero will disable this feature and Video will never shut off. |
| Access |
read/write |
adminState
| Name |
adminState |
| Description |
The adminState or administrative state defines the desired state of an object. It can be enabled (allowed to render service) or disabled (not allowed to render service). Most objects within the system have an administrative state. |
| Allowed Values |
enabled: 1
disabled: 2 |
| Access |
read/write |
agcSetting
| Name |
agcSetting |
| Description |
The agcSetting defines the measurement offset that the ONT should use when using the broadband RF signal level or total optical power level as a basis for automatic gain control (AGC). Enter in increments of 1 dB. |
| Allowed Values |
-12 dB to +12 dB
default:-4 dB |
| Access |
read/write |
alarmState
| Name |
alarmState |
| Description |
Defines the current alarm status of a device, card or ONT. |
| Allowed Values |
| 0 |
eCLEARED |
Currently is not in alarm |
| 1 |
eACTIVEREPORTABLEINDETERMINATE |
Could not communicate to obtain alarm state |
| 2 |
eACTIVEREPORTABLEWARNING |
Alarm is warning level, no service affected. |
| 3 |
eACTIVEREPORTABLEMINOR |
Alarm is minor level, some service may be affected. |
| 4 |
eACTIVEREPORTABLEMAJOR |
Alarm is major level, one or more services affected |
| 5 |
eACTIVEREPORTABLECRITICAL |
Alarm is critical level, all or most services affected |
| 6 |
eACTIVEPENDING |
In the process of changing states. |
|
| Access |
readonly |
alignmentErrors
| Name |
alignmentErrors |
| Description |
Alignment errors are the count of the number of frames received that do not end with an even number of octets and have a bad Cyclic Redundancy Check (CRC). This could indicate a cable problem or a faulty transmitter on the network equipment connected at the other end. |
| Allowed Values |
64 bit counter |
| Access |
readonly |
arcMode
| Name |
arcMode |
| Description |
The arcMode or Alarm Report Control defines whether or not to report alarms for this ONT. This attribute is deprecated and should be left at it's default setting of false. |
| Allowed Values |
true - Suppress Alarm Reports
false - Send alarm reports. This is the default and should not be changed from the default value. |
| Access |
read/write |
availState
| Name |
availState |
| Description |
The availState or availability state will be empty whenever the object is in a normal state with no issues. If failed or up but in some way impaired the availState will give a list of reasons for the off normal state. |
| Allowed Values |
| 0 |
eNOTSUPPORTED |
This object is not supported or has been asked to perform an unsupported function. |
| 1 |
eINTEST |
A test is in progress and service may be affected. |
| 2 |
eFAILED |
This object is failed due to a hardware or software fault. |
| 3 |
ePOWEROFF |
AC power is off, if still in service, then on battery backup. |
| 4 |
eOFFLINE |
If the AdminState is disabled the availState will be eOFFLINE. |
| 5 |
eOFFDUTY |
Offduty is not used currently. Indicated scheduled to be offline. |
| 6 |
eDEPENDENCY |
Out of service due to failure of an object that this object depends on. |
| 7 |
eDEGRADED |
The object is still rendering service but is degraded due to errors or low power levels. |
| 8 |
eNOTINSTALLED |
The object is offline due to hardware to support it not being installed. |
| 9 |
eLOGFULL |
The object is impaired due to logs being full. Not used as all logs are rotated. |
| 10 |
eUNAUTHACCESS |
Not used, indicates a failure in authorization. Auth failures are simply logged. |
|
| Access |
readonly |
bridgeProfileName
| Name |
bridgeProfileName |
| Description |
This structure has been deprecated and should always be set to its default value of blank. |
| Allowed Values |
"" |
| Access |
readonly |
buildDate
| Name |
buildDate |
| Description |
Defines the date on which the software was built. |
| Allowed Values |
date: of the form YYMMDD
example: 180228 Feb 28th 2018 |
| Access |
readonly |
buildId
| Name |
buildId |
| Description |
Defines the exact build ID and is unique for every build of the system. |
| Allowed Values |
buildid: XXXXXX
example: 180104 |
| Access |
readonly |
carrierSenseErrors
| Name |
carrierSenseErrors |
| Description |
The count of packets where the packet was attempted to be received but no carrier signal was detected on the port. |
| Allowed Values |
64 bit counter |
| Access |
readonly |
cfi
| Name |
cfi (voice) |
| Description |
Defines the value of the canonical format indicator in the VLAN ID. |
| Allowed Values |
Do not change from its default value of 1. |
| Access |
read/write |
cleiCode
| Name |
cleiCode |
| Description |
CLEI codes or Common Language Equipment Identifiers are used in Telecom service provider systems to uniquely identify a board type and specific revision of that board to Telco management systems. It is not used in Enterprise and will not be populated unless in a Telco environment/software release. |
| Allowed Values |
cleiCode: <string expressing clei code> |
| Access |
readonly |
cpeThreshold
| Name |
cpeThreshold |
| Description |
The cpeThreshold defines the number of consecutive drift corrections of an ONT can occur before raising an alarm. The cpeThreshold should not be modified from it's default value of 3. |
| Allowed Values |
default: 3 |
| Access |
read/write(not recommended) |
cpState
| Name |
cpState |
| Description |
The cpState variable defines status of a circuit pack. |
| Allowed Values |
| 0 |
Unknown |
Card state is unknown due to communications failure. |
| 1 |
Slave |
Card is in inactive standby mode and being controlled by the active card. |
| 2 |
Master |
Card is active and is controlling the standby card. |
| 3 |
Not Ready |
Card is initializing and cannot render service currently. |
| 4 |
Normal |
Card is not redundant and is in the normal state. |
|
| Access |
read/write(not recommended) |
configLock
| Name |
configLock |
| Description |
When an ONT is configured, it state is configLock set to false. Whenever the ONT is successfully ranged the ONT will be "locked" to that ONT ID and will be bound there until deleted. Any ONT that is in the configuration lock set to true has been communicated with successfully at least once in the past. |
| Allowed Values |
true : The ONT has been communicated to and the ONT id assigned and is locked to this id.
false: The ONT has not been communicated with and has not yet been ranged. This is the default on creation. |
| Access |
read/write |
currentIPAddr
| Name |
currentIPAddr |
| Description |
Defines the current IP address of an ONT that is equipped for voice services. This IP is used for SIP and RTP voice transport. ONTs that do not support voice have no IP address. |
| Allowed Values |
currentIPAddr: xx.xx.xx.xx
example: 10.20.70.129 |
| Access |
readonly |
currentdnsprimary
| Name |
currentdnsprimary |
| Description |
Defines the current dns primary server's IP address of an ONT that is equipped for voice services. This IP is used for name resolution in SIP and RTP voice transport. ONTs that do not support voice have no primary dns IP address. |
| Allowed Values |
currentIPAddr: xx.xx.xx.xx
example: 10.20.70.129 |
| Access |
readonly |
currentdnssecondary
| Name |
currentdnssecondary |
| Description |
Defines the current secondary dns server's IP address of an ONT that is equipped for voice services. This IP is used for name resolution in SIP and RTP voice transport when the primary is not available. ONTs that do not support voice have no primary dns IP address. |
| Allowed Values |
currentIPAddr: xx.xx.xx.xx
example: 10.20.70.129 |
| Access |
readonly |
currentmask
| Name |
currentmask |
| Description |
Defines the current IP mask of an ONT that is equipped for voice services. This IP is used for SIP and RTP voice transport. ONTs that do not support voice have no IP mask. |
| Allowed Values |
currentmask: xxx.xxx.xxx.xxx
example: 255.255.255.0 |
| Access |
readonly |
currentgateway
| Name |
currentgateway |
| Description |
Defines the current gateway IP address of an ONT that is equipped for voice services. This IP is used for SIP and RTP voice transport. ONTs that do not support voice have no IP gateway address. |
| Allowed Values |
currentIPAddr: xx.xx.xx.xx
example: 10.20.70.1 |
| Access |
readonly |
dataSheddingInterval
| Name |
dataSheddingInterval |
| Description |
The dataSheddingInterval defines how long after an ONT transitions to battery power that it should start shedding data services such as ethernet and PoE ports. |
| Allowed Values |
900 This attribute is not fully supported and should not be modified from its default value of 900 seconds or 15 minutes. |
| Access |
read/write |
deferredTransmission
| Name |
deferredTransmission |
Description
|
The count of times that a transmission was deferred due to a transmission being detected. This is an legacy counter used when collision detect is present. Full duplex point to point ethernet links should never encounter this. |
| Allowed Values |
64 bit counter |
| Access |
read/write |
degradedThreshold
| Name |
degradedThreshold (Video) |
| Description |
Provides the lower threshold to determine when the degraded Signal (RF Video Signal Degraded) alarm should be generated for an ONT. This threshold is set at the OLT level and applies to all ONTs for that OLT. |
| Allowed Values |
Range is -5 through -12 (default is -9.5). Enter in increments of 0.5 dBm. |
| Access |
read/write |
deviceID
| Name |
deviceID |
| Description |
Defines the device ID which is also used as the hostname for the ONT. Defines the unique name for the Tellabs Configuration ID or hostname associated with the ONT. This identifies the ONT when communicating with the Tellabs Configuration Server. |
| Allowed Values |
Any valid printable text string, up to 24 ASCII characters. |
| Access |
read/write |
dnsprimary
| Name |
dnsprimary (voice) |
| Description |
Defines the primary dns IP address to be used for voice services. |
| Allowed Values |
Standard IP Nomenclature: 0.0.0.0 |
| Access |
read/write |
dnssecondary
| Name |
dnssecondary (voice) |
| Description |
Defines the secondary dns IP address to be used for voice services. |
| Allowed Values |
Standard IP Nomenclature: 0.0.0.0 |
| Access |
read/write |
domainName
| Name |
domainName(voice) |
| Description |
Defines the domain name that was received back from DHCP when the IP address was assigned. |
| Allowed Values |
Standard domain name Nomenclature
example: tellabs.com |
| Access |
read/write |
dot1PortNumber
| Name |
dot1PortNumber |
| Description |
The ifindex assigned to the port |
| Allowed Values |
example: 395 |
| Access |
readonly |
driftWindowThreshold
| Name |
driftWindowThreshold |
| Description |
The driftWindowThreshold will define the the amount of drift allowed in bursts sent from the ONTs versus their assigned transmission window. |
| Allowed Values |
It should not be modified from the default value of 3.
default: 3 |
| Access |
read/write(not recommended) |
fcsErrors
| Name |
fcsErrors |
| Description |
The count of Ethernet frames which included a frame check sum error which indicates an error in the transmitted packet. |
| Allowed Values |
64 bit counter |
| Access |
readonly |
enableFEC
| Name |
enableFEC |
| Description |
The enableFEC attribute controls whether or not FEC or Forward Error Correction is enabled on the port. FEC will correct single-bit and some multi-bit errors in the data passing through the port. FEC is often useful for clearing up marginal optics and will add an equivalent of 3dB of margin to the signal. Enabling FEC will result in a reduction of bandwidth to approximately 8GB on 10GB links. |
| Allowed Values |
true: FEC is enabled on the link
false: FEC is disabled on the link |
| Access |
read/write |
externalPowerAvailable
| Name |
externalPowerAvailable |
| Description |
The externalPowerAvailable attribute defines the power available in the attached power supply for this ONT. It will normally default to the power value of the most commonly used power supply. If remote DC power is utilized, it should be set to 100W as this is the max remote power available. The ONT usage will be subtracted from this number to give the max PoE power available to the ONT which can be found in the nominal PoE power attribute. |
| Allowed Values |
0 to 65535 Units are Watts defaults vary by the AC power supply normally supplied with the ONT. |
| Access |
read/write |
expTypeId
| Name |
expTypeId |
| Description |
The expTypeID is an enumerated type that gives the expected card type ID that should be installed in this slot or ONT id. |
| Allowed Values |
| TypeId |
TypeName |
Description |
|
|
|
| 1 |
BLANKSLOT |
No provisioning |
| 2 |
4xONU |
4xONU, includes QOIU512, QOIU513 |
| 10 |
TDU |
TDU |
| 11 |
ESU |
ESU |
| 30 |
ONT |
ONT circuit pack, SFU702 |
| 53 |
NOT_PROV |
NOT PROVISIONED |
| 54 |
ESU30 |
ESU30 |
| 55 |
ESU2 |
ESU2 |
| 59 |
ONT_2V1E1C |
onts with 2 voice, 1 ethernet, 1 coax |
| 60 |
ONT_NONE |
ONT_NONE |
| 65 |
ONT_2V4E_ETSI |
ETSI ONT with 2 voice,1 Eth and RF overlay includes ONT705 |
| 66 |
OFA |
1134 optical fan assembly |
| 67 |
PWR |
A or B power input |
| 71 |
ONT_4E |
ONT709 with 4 GbE ports |
| 72 |
ONT_24V24E |
ONT729 with 24 GbE ports and 24 Voice |
| 74 |
ONT_24E |
ONT728 with 24 Data |
| 75 |
ONT_24V24EGP |
ONT729GP with 24 Data, 24 Voice |
| 78 |
ONT120 |
ONT120 Base |
| 78 |
ONT140 |
ONT140 Base |
| 80 |
SFUBASIC |
ONT140 Base |
| 81 |
SFP_ONT |
ONT070 1x ESL |
| 82 |
ESU32 |
ESU 1131/1134 |
| 83 |
ONT142R |
ONT142R |
| 84 |
ONT742G |
ONT742G |
| 85 |
ONT742GR |
ONT742GR |
| 86 |
8xPON |
OIU8, QOIU8 |
| 87 |
ONT180 |
ONT180 8x ESL |
| 88 |
ONT205 |
ONT205 5x XGSPON ESL |
| 89 |
ONT131 |
ONT131 3x ESL 1x POTS |
| 90 |
ONT121WX |
ONT121WX 2x ESL 1x POTS |
| 91 |
ONT248 |
ONT248 48x ESL |
| 92 |
ONT140CL |
ONT140CL 4x ESL |
| 93 |
ONT202 |
ONT202 2x Multi-gig ESL |
|
| Access |
read/write |
forcedStopMode
| Name |
forcedStopMode |
| Description |
This attribute allows the ONT to be eSTOP'ed or command it to be silent on the PON until re-enabled. This can happen when the system detects the ONT either drifting, or transmitting outside it's window, or departing and arriving too many times in close succession. If this occurs, the OLT will put the ONT in eSTOP mode. A user can also force this behavior by disabling the ONT which will set the eSTOP mode to on. Changing the AdminState to enabled will turn it back on. |
| Allowed Values |
true The ONT is configured to be in the eSTOP mode.
false The ONT is configured for normal operation. |
| Access |
read/write |
gatewayIPAddress
| Name |
gatewayIPAddress |
| Description |
Defines the gateway IP address when in voice gateway mode. |
| Allowed Values |
Standard IP Nomenclature: 0.0.0.0 |
| Access |
read/write |
hostName
| Name |
hostName(voice) |
| Description |
Defines the host name that was assigned the ONT during configuration for those ONTs that support hostnames. The host name is configured via the Device ID field in the TConfig section. This is only relevant on certain voice ONTs. Data only ONTs have no hostname. |
| Allowed Values |
Standard host name Nomenclature
example: room112-ont729 |
| Access |
readonly |
inPauseFrames
| Name |
inPauseFrames |
| Description |
Count of the number of pause frames received from the peer on the other side of the ethernet link. |
| Allowed Values |
64 bit counter |
| Access |
readonly |
installedType
| Name |
installedType |
| Description |
Defines the actual card type of the device that is installed in a slot or ONT type of an ONT at a given ONT ID. |
| Allowed Values |
The installed type is an enum with the following defintion.
example: room112-ont729 |
| Access |
readonly |
ipAddress
| Name |
ipAddress (voice gateway) |
| Description |
This attribute allows assignment of a static IP address to the ONT when in voice gateway mode. DHCP is ALWAYs used for softswitch mode. |
| Allowed Values |
Standard IP address nomenclature applies: 0.0.0.0 |
| Access |
read/write |
ipAssignmentMode
| Name |
ipAssignmentMode |
| Description |
Defines whether the IP should be assigned via DHCP or static IP |
| Allowed Values |
0 DHCPv4
1 Static IP
2 DHCPv6
3 Dual Stack |
| Access |
read/write |
ledHoldTime
| Name |
ledHoldTime |
| Description |
The ledHoldTime defines the time that an ONT should keep the leds on the ONT faceplate lit after a change in state on the ONT. For hospitality and offices, it is often desirable to have the LEDS of an ONT turn off after some time to keep from disturbing workers or guests near the ONT. (Having something blinking on the wall of a hotel room can make it hard to sleep). After the timer times out, the ONT will turn off all LEDs except for power. They will come back on if there is a change in port state or alarm state and begin the timer again. |
| Allowed Values |
0 to 65535 seconds
0 will set the ONT to always keep the alarm indicators lit. |
| Access |
read/write |
lldpProfileName
| Name |
lldpProfileName |
| Description |
The name of the LLDP profile to be assigned to the port. The LLDP profile must have been defined prior to use. |
| Allowed Values |
"lldpProfileName":"LLDP-Inventory" |
| Access |
read/write |
locationName
| Name |
locationName |
| Description |
The userlabel field on an ONT is known as locationName within the model. |
| Allowed Values |
string: Any valid printable string. |
| Access |
read/write |
maxUpstreamBandwidth
| Name |
maxUpstreamBandwidth |
| Description |
The peak bandwidth that will be given to that class of service(CoS) TCONT. |
| Allowed Values |
0 to the upStreamLineRate |
| Access |
ACCESS HERE |
manufactureDate
| Name |
manufactureDate |
| Description |
The date that the card, ONT or assembly was built. |
| Allowed Values |
MM/YYYY
example: 12/2012 |
| Access |
readonly |
minUpstreamBandwidth
| Name |
minUpstreamBandwidth |
| Description |
The minimum guaranteed bandwidth that will be given to that class of service(CoS) TCONT. |
| Allowed Values |
0 to the upstreamLineRate |
| Access |
readonly |
mtuSize
| Name |
mtuSize |
| Description |
The maximum transmission unit or maximum size in bytes of the payload portion of an ethernet frame going over the port. |
| Allowed Values |
0 to 9000 bytes |
| Access |
readonly |
nacProfileName
| Name |
nacProfileName |
| Description |
The name of a nac or Network Access Control profile to be applied to the port. The profile must have been created prior to assignment. |
| Allowed Values |
"nacProfileName":"VLAN2995-UT" |
| Access |
read/write |
opState
| Name |
opState |
| Description |
The operational state of the object or entity. The operational state can be up or down. |
| Allowed Values |
up 0
down 1 |
| Access |
readonly |
opLineSpeed
| Name |
opLineSpeed |
| Description |
The Ethernet port speed that resulted from negotiation. |
| Allowed Values |
10 (10BT)
100 (100BT)
1000 (1GBT)
2500 (2.5GBT)
5000 (5GBT)
1000 (10GBT) |
| Access |
readonly |
outPauseFrames
| Name |
outPauseFrames |
| Description |
Count of the number of pause frames transmitted of the ethernet link. |
| Allowed Values |
64 bit counter |
| Access |
readonly |
overloadThreshold
| Name |
overloadThreshold (Video) |
| Description |
Provides the upper threshold to determine when the overloadSignal (RF Video Overload) alarm should be generated for an ONT. This threshold is set at the OLT level and applies to all ONTs for that OLT. |
| Allowed Values |
Range is 0 through 5 (default is 2.5). Enter in increments of 0.5 dBm. |
| Access |
read/write |
paeProfileName
| Name |
paeProfileName |
| Description |
The name of a pae or Port Authentication Entity profile to be applied to the port. This profile is used for configuring 802.1x or MAB on the port. The profile must have been created prior to assignment. |
| Allowed Values |
"paeProfileName":<profile name>
example: "paeProfileName":"radius-auth-profile" |
| Access |
read/write |
passwordAutoLearn
| Name |
passwordAutoLearn |
| Description |
The passwordAutoLearn attribute controls define whether or not the ONT password is the serial number of that ONT. The OLT uses the ONT serial number as the password by default. Should not be changed from the default value. |
| Allowed Values |
true(default): ONT serial number is learned from the PON and used as password.
false: Registration ID is used as the PON Password. This is not currently supported. |
| Access |
read/write |
phyHoldTime
| Name |
phyHoldTime |
| Description |
The phyHoldTime defines the time that a port should keep the Ethernet PHY active after the PON uplink has been lost. In many installations, after the PON link goes down, it is desirable to shut off the port to prevent any security violations from occurring while out of contact with the OLT. In some installations like APs and other devices, it may be desirable to keep the port up at all times. Also, bringing the port down during a PON outage forces re-authentication once the PON comes back up. |
| Allowed Values |
0 to 65535 seconds
0 will set the port to never expire and port will stay up during PON outages. |
| Access |
read/write |
physAddress
| Name |
physAddress |
| Description |
The physical location of the port in the system. It is almost identical to the AID of the port. |
| Allowed Values |
1-<slot>-<pon>-<ont id>-<port id>
0 will set the port to never expire and port will stay up during PON outages. |
| Access |
readonly |
pkts64Octets
| Name |
pkts64Octets |
| Description |
The count of packets that are 64 bytes or less. Per the ethernet standard, all packets less than 64 Octets are padded out to 64 octets. |
| Allowed Values |
64 bit counter |
| Access |
readonly |
pkts65to127Octets
| Name |
pkts65to127Octets |
| Description |
The count of packets that are between 65 and 127 Octets. |
| Allowed Values |
64 bit counter |
| Access |
readonly |
pkts128to255Octets
| Name |
pkts128to255Octets |
| Description |
The count of packets that are between 128 and 255 Octets. |
| Allowed Values |
64 bit counter |
| Access |
readonly |
pkts256to511Octets
| Name |
pkts256to511Octets |
| Description |
The count of packets that are between 256 and 511 Octets. |
| Allowed Values |
64 bit counter |
| Access |
readonly |
pkts512to1023Octets
| Name |
pkts512to1023Octets |
| Description |
The count of packets that are between 512 and 1023 Octets. |
| Allowed Values |
64 bit counter |
| Access |
readonly |
pkts1024to1518Octets
| Name |
pkts1024to1518Octets |
| Description |
The count of packets that are between 1024 and 1518 Octets. |
| Allowed Values |
64 bit counter |
| Access |
readonly |
pkts1519to1920Octets
| Name |
pkts1519to1920Octets |
| Description |
The count of packets that are between 1519 and 1920 Octets. |
| Allowed Values |
64 bit counter |
| Access |
readonly |
poeAllocatedPower
| Name |
poeAllocatedPower |
| Description |
The poeAllocatedPower defines the total amount of power for the whole ONT that has been reserved by PoE handshakes with attached devices. This is initially determined by hardware handshake and may optionally be updated by LLDP exchanges. |
| Allowed Values |
0 to 65535 Watts |
| Access |
readonly |
poeConsumedPower
| Name |
poeConsumedPower |
| Description |
The poeConsumedPower defines the total amount of power for the whole ONT that is currently being drawn by attached devices. |
| Allowed Values |
0 to 65535 Watts |
| Access |
readonly |
poeInputCurrent
| Name |
poeInputCurrent |
| Description |
The poeInputCurrent defines the total amount current that is being drawn on the input side of the ONT and being delivered to the device. |
| Allowed Values |
0 to 65535 mA |
| Access |
readonly |
poeInputVoltage
| Name |
poeInputVoltage |
| Description |
The poeInputVoltaget defines the voltage measured at the input of the ONT and being used for Power Over Ethernet Services. |
| Allowed Values |
0 to xx Volts in .1 Volt increments |
| Access |
readonly |
poeHoldTime
| Name |
poeHoldTime |
| Description |
The poeHoldTime defines the time that a port should keep the poe power on an Ethernet PHY active after the PON uplink has been lost. Often, for APs and other devices, it is desirable to keep them powered up even if the PON link goes down to speed recovery time and possibly keep Wifi running locally. |
| Allowed Values |
0 to 65535 seconds
0 will set the port to never expire and port will stay powered up during PON outages. |
| Access |
read/write |
poePortDetectionStatus
| Name |
poePortDetectionStatus |
| Description |
The poePortDetectionStatus defines whether or not the port has detected... |
| Allowed Values |
ALLOWED VALUES HERE |
| Access |
readonly |
poePortMPSAbsentCounter
| Name |
poePortMPSAbsentCounter |
| Description |
The poePortMPSAbsentCounter counts the number of times that power was being provided to the PD and then was no longer detected. It usually reflects the number of times the port has been disconnected. Most reboots don't increment this counter although a small number of devices have a hardware reset that does actually remove the termination briefly and causes this counter to increment. |
| Allowed Values |
64 bit counter |
| Access |
readonly |
poeProfileName
| Name |
poeProfileName |
| Description |
The name of a poe or Power over Ethernet profile to be applied to the port. This profile is used for configuring PoE power settings on the port. The profile must have been created prior to assignment. |
| Allowed Values |
"poeProfileName":<profile name>
example: "poeProfileName":"poe-enabled" |
| Access |
read/write |
poeUsageThreshold
| Name |
poeUsageThreshold |
| Description |
The poeUsageThreshold defines the percentage of the PoE nominal power (the total PoE power available) the user wants the system to alarm. This alarm indicates that the power usage is nearing the maximum allowed by the ONT. |
| Allowed Values |
0 to 100 - Zero to 100% is allowed. |
| Access |
read/write |
ponReach
| Name |
ponReach |
| Description |
The ponReach attribute defines the distance that the furthest ONT is allowed to be on the PON. The OLT supports 20km and 30km reaches currently. For 30km, 0 to 30km reach is supported. |
| Allowed Values |
1: 20km reach.
2: 30km reach. |
| Access |
read/write |
ponProfileName
| Name |
ponProfileName |
| Description |
The ponProfileName attribute defines the name of the PON profile currently assigned to the port. |
| Allowed Values |
String containing the PON Profile Name. |
| Access |
read/write |
profileName
| Name |
profileName |
| Description |
The profileName attribute defines the port profile to be applied to an ONT UNI port. |
| Allowed Values |
String containing the UNI Port Profile Name. |
| Access |
read/write |
pwrRestoreTimerResetInterval
| Name |
pwrRestoreTimerResetInterval |
| Description |
The pwrRestoreTimerResetInterval gives the interval that power must be present before the system considers the power to be up. This provides histeresis to prevent power shedding rapidly turning on and off. |
| Allowed Values |
30 This attribute is not fully supported and should not be modified from its default value of 30 seconds. |
| Access |
read/write |
prot802_1P
| Name |
prot802_1P |
| Description |
The value of the pbit to be utilized in tconfig and SIP communications for voice ONTs. |
| Allowed Values |
pbit: 0 to 7
default: 6 |
| Access |
read/write |
rangeFailWaitTime
| Name |
rangeFailWaitTime (Video) |
| Description |
The rangeFailWaitTimeattribute defines the number of hours to wait before interrupting RF video services if the ONT loses communications over the PON frequencies. This prevents users from continuing to get video services after the PON goes away. Typically, PON and video are on different optical frequencies. |
| Allowed Values |
0 to 76 hours
default: 48 hours |
| Access |
read/write |
rangeFailWaitTimePots
| Name |
rangeFailWaitTimePots |
| Description |
The rangeFailWaitTimePots attribute configures a timer that will turn off the POTs voltage after the PON uplink has failed and the timer expires. It is often desirable to have the POTs turn off the voltage to trigger alarm systems when the uplink fails to prevent thieves from cutting the PON uplink to prevent the alarm system from calling out. |
| Allowed Values |
0 to 360 in 10 second increments, zero disables the feature. |
| Access |
read/write |
registrationId
| Name |
registrationId |
| Description |
When not using the serial number for the password for the ONT on the PON, this holds the value of the registration ID. This attribute is not supported at this time as registration ID is not supported. |
| Allowed Values |
N/A |
| Access |
N/A |
rstpProfileName
| Name |
rstpProfileName |
| Description |
The name of a rstp or Rapid Spanning Tree profile to be applied to the port. This profile is used for configuring RSTP on the port. The profile must have been created prior to assignment. |
| Allowed Values |
"rstpProfileName":<profile name>
example: "rstpProfileName":"rstp-root-protect" |
| Access |
read/write |
rxBIPErrorCount
| Name |
rxBIPErrorCount |
| Description |
The count of Bit Interleaved Parity Errors that have been detected at the receiver of the interface. This indicates that the PON is taking errors. The BIP error count is after FEC correction if enabled. |
| Allowed Values |
64 Bit counter |
| Access |
readonly |
rxAccessViolationDiscardCount
| Name |
rxAccessViolationDiscardCount |
| Description |
The count of packets discarded due to a port blocked due to an Access Violation. |
| Allowed Values |
64 Bit counter |
| Access |
readonly |
rxBroadcastPackets
| Name |
rxBroadcastPackets |
| Description |
The count of Broadcast Packets that were received. |
| Allowed Values |
64 Bit counter |
| Access |
readonly |
rxBytesCount
| Name |
rxBytesCount |
| Description |
The count of bytes that have been received over the interface. |
| Allowed Values |
64 Bit counter |
| Access |
readonly |
rxFloodedPackets
| Name |
rxFloodedPackets |
| Description |
The count of Packets that were received via flooding upstream towards the OLT. |
| Allowed Values |
64 Bit counter |
| Access |
readonly |
rxFloodLimitDiscardCount
| Name |
rxFloodLimitDiscardCount |
| Description |
The count of packets that were discarded due to the flooding limit of broadcast/multicast being exceeded. |
| Allowed Values |
64 Bit counter |
| Access |
readonly |
rxFragments
| Name |
rxFragments |
| Description |
The count of packets that were received that had been fragmented on another interface that had a smaller MTU and were broken into fragments. |
| Allowed Values |
64 Bit counter |
| Access |
readonly |
rxInternalDiscardCount
| Name |
rxInternalDiscardCount |
| Description |
The count of packets discarded due to... NEED DESCRIPTION. |
| Allowed Values |
64 Bit counter |
| Access |
readonly |
rxJabbers
| Name |
rxJabbers |
| Description |
The count of packets that were longer than the MRU, has an invalid crc and no rx error events were detected. |
| Allowed Values |
64 Bit counter |
| Access |
readonly |
rxMissErrorCount
| Name |
rxMissErrorCount |
| Description |
The number of times that a burst from the ONT was expected but didn't occur. Only valid on QOIU7 boards. |
| Allowed Values |
64 Bit counter |
| Access |
readonly |
rxMulticastPackets
| Name |
rxMulticastPackets |
| Description |
The count of Multicast Packets that were received. |
| Allowed Values |
64 Bit counter |
| Access |
readonly |
rxOpticalPower
| Name |
rxOpticalPower |
| Description |
The received optical power reported by the ONT receiver downstream. |
| Allowed Values |
optical power in tenths of a dB |
| Access |
readonly |
rxProtocolFilterDiscardCount
| Name |
rxProtocolFilterDiscardCount |
| Description |
The count of packets that were discarded due to a specific protocol (ARP for example) depleting the buffers above the threshold limit given for that protocol. |
| Allowed Values |
64 Bit counter |
| Access |
readonly |
rxPLOAMCount
| Name |
rxPLOAMCount |
| Description |
The count of PLOAM messages that have been received over the interface. PLOAM stands for Physical Layer Operations Administration and Maintenance messages. |
| Allowed Values |
64 Bit counter |
| Access |
readonly |
rxOversizePkts
| Name |
rxOversizePackets |
| Description |
The count of packets that were received over the wire that were larger than the MTU size on the interface. This can be an error or possibly a Jumbo frame sent on an interface with a smaller MTU such as 1500. |
| Allowed Values |
64 Bit counter |
| Access |
readonly |
rxRunts
| Name |
rxRunts |
| Description |
The count of packets that were received over the wire that were less than 64 bytes. This violates that standard and typically is an errored frame or a device that does not obey the specification. |
| Allowed Values |
64 Bit counter |
| Access |
readonly |
rxUnauthDiscardCount
| Name |
rxUnauthDiscardCount |
| Description |
The count of packets that were discarded due to the port not currently being authenticated. |
| Allowed Values |
64 Bit counter |
| Access |
readonly |
rxUnicastPackets
| Name |
rxUnicastPackets |
| Description |
The count of Unicast Packets that were received. |
| Allowed Values |
64 Bit counter |
| Access |
readonly |
rxUtilization
| Name |
rxUtilization |
| Description |
The percentage utilization of the receive side of the link. |
| Allowed Values |
0 to 100 percent |
| Access |
readonly |
rxVlanFilterDiscardCount
| Name |
rxVlanFilterDiscardCount |
| Description |
The count of packets that were discarded due to the VLAN not being configured on the port. |
| Allowed Values |
64 Bit counter |
| Access |
readonly |
serialNum
| Name |
serialNum |
| Description |
The serial number of the device being retrieved. |
| Allowed Values |
12 byte string, 4 Alpha characters, followed by an 8 digit unique numeric identifier. |
| Access |
readonly |
statsFCS
| Name |
statsFCS |
| Description |
The 15 minute PM statics count of Ethernet frames which included a frame check sum error which indicates an error in the received packet. |
| Allowed Values |
64 bit counter |
| Access |
readonly |
statsFrameTooLong
| Name |
statsFrameTooLong |
| Description |
The 15 minute PM statistics count for frames that are too long. Frames that are longer than 1518 or the current MRU (maximum receive unit) will be counted when this condition is detected. |
| Allowed Values |
64 bit counter |
| Access |
readonly |
statsSingleCollisionFrame
| Name |
statsSingleCollisionFrame |
| Description |
The count of Ethernet frames which included a frame check sum error which indicates an error in the transmitted packet. |
| Allowed Values |
64 bit counter |
| Access |
readonly |
subnetMask
| Name |
subnetMask |
| Description |
Defines the subnet mask for the IP address when in Voice Gateway mode. DHCP is used in softswitch mode. |
| Allowed Values |
Standard IP Nomenclature: 0.0.0.0 |
| Access |
read/write |
supportedCardGroupType
| Name |
supportedCardGroupType |
| Description |
The card or ONT type that is configured to be at a specific location. |
| Allowed Values |
- 65 - ONT704
- 66 - ONT705
- 68 - ONT709
- 71 - ONT729
- 73 - ONT728
- 74 - ONT729GP
- 75 - ONT120
- 76 - ONT140
- 78 - ONT070
- 79 - ONT142R
- 80 - ONT742G
- 81 - ONT742GR
- 83 - ONT180
- 84 - ONT205
- 335 - ONT131W
- 336 - ONT121W
- 337 - ONT121WX
- 338 - ONT248
- 339 - ONT140CL
- 340 - ONT202
- 341 - ONT224
|
| Access |
readonly |
symbolErrors
| Name |
symbolErrors |
| Description |
A symbol error indicates that the interface has detected an undefined or invalid symbol that has been received. This is a layer 1 error, where fcs is a layer 2 error. |
| Allowed Values |
64 bit counter |
| Access |
readonly |
systemVersion
| Name |
systemVersion |
| Description |
The version given to the overall software bundle for the system. Each board and ONT has its own version, but the system version is a co-ordinated release of all software at a known and tested set of revisions. |
| Allowed Values |
systemVersion: <feature package version>_<version>
example: FP29.1_015783 |
| Access |
readonly |
txBroadcastDiscardCount
| Name |
txBroadcastDiscardCount |
| Description |
The count of broadcast frames that were discarded by the downstream shaper due to lack of buffer space. |
| Allowed Values |
64 Bit counter |
| Access |
readonly |
txBroadcastPackets
| Name |
txBroadcastPackets |
| Description |
The count of Broadcast Packets that were transmitted. |
| Allowed Values |
64 Bit counter |
| Access |
readonly |
txFloodedPackets
| Name |
txFloodedPackets |
| Description |
The count of Packets that were transmitted via flooding downstream towards the OLT. |
| Allowed Values |
64 Bit counter |
| Access |
readonly |
txInternalDiscardCount
| Name |
txInternalDiscardCount |
| Description |
DESCRIPTION NEEDED. |
| Allowed Values |
64 Bit counter |
| Access |
readonly |
txBytesCount
| Name |
txBytesCount |
| Description |
The count of bytes that have been transmitted over the interface. |
| Allowed Values |
64 Bit counter |
| Access |
readonly |
txFcsErrorCount
| Name |
txFcsErrorCount |
| Description |
The count of frame checksum errors that have occurred on the interface. |
| Allowed Values |
64 Bit counter |
| Access |
readonly |
txFramesCount
| Name |
txFramesCount |
| Description |
The count of frames (Ethernet frames) that have been transmitted over the interface. |
| Allowed Values |
64 Bit counter |
| Access |
readonly |
txMulticastPackets
| Name |
txMulticastPackets |
| Description |
The count of Multicast Packets that were transmitted. |
| Allowed Values |
64 Bit counter |
| Access |
readonly |
txOpticalPower
| Name |
txOpticalPower |
| Description |
The output power reported by the ONT laser transmitter (upstream). |
| Allowed Values |
Optical power in tenths of a dB |
| Access |
readonly |
txShaperDiscardCount
| Name |
txShaperDiscardCount |
| Description |
The count of frames that were discarded by the downstream shaper due to lack of buffer space. |
| Allowed Values |
64 Bit counter |
| Access |
readonly |
txUnicastPackets
| Name |
txUnicastPackets |
| Description |
The count of Unicast Packets that were transmitted. |
| Allowed Values |
64 Bit counter |
| Access |
readonly |
txUtilization
| Name |
txUtilization |
| Description |
The percentage utilization of the transmit side of the link. |
| Allowed Values |
0 to 100 percent |
| Access |
readonly |
upBERFailThreshold
| Name |
upBERFailThreshold |
| Description |
The upBERFailThreshold will define the upstream Bit Error Rate (BER) threshold for failing the link. Once the error rate exceeds the BER threshold the link is failed and an alarm raised. Expressed as a negative exponent of a power of 10 (e.g. 10e-4). Typically should not be modified from the default. |
| Allowed Values |
Any negative value from -3 to -8.
default: -4 (10e-4) |
| Access |
read/write |
upBERMaintThreshold
| Name |
upBERMaintThreshold |
| Description |
The upBERMaintThreshold will define the upstream Bit Error Rate (BER) threshold for signaling a maintenance alarm on the link. Once the error rate exceeds the BER threshold the link is failed and an alarm raised but the link continues to operate. The idea is to set the threshold 2 orders of magnitude less than the failure threshold to signal a need for maintenance prior to the link actually failing. |
| Allowed Values |
Any negative value from -4 to -10. Typically should not be modified from the default.
default: -6 (10e-6) |
| Access |
read/write |
upStreamLineRate
| Name |
upStreamLineRate |
| Description |
The upStreamLineRate will define the usable upstream bandwidth of the PON link (i.e. 1.2Gb/s, 2.2Gb/s, 9.95Gb/s).Units are in bits per second. |
| Allowed Values |
9,953,280 bps (10Gbps), 1,224,000 bps (1.2Gbps) |
| Access |
readonly |
userlabel
| Name |
userlabel |
| Description |
The userlabel is a user defined text string associated with ONTs and ONT UNI ports that is used to put any user defined identification for the port or ONT. Often it might be the cubicle number, or what is attached to the port. |
| Allowed Values |
Up to 24 ASCII characters, mixed case is supported. |
| Access |
read/write |
username
| Name |
username (Voice) |
| Description |
The username defines the SIP user name that is used when authenticating to perform the SIP configuration download between the ONT and the Tellabs Configuration Server. |
| Allowed Values |
Up to 24 ASCII characters, mixed case is supported. |
| Access |
read/write |
userpasswd
| Name |
userpasswd (Voice) |
| Description |
The userpasswd defines the SIP digest authentication password used when authenticating to perform the SIP configuration download between the ONT and the Tellabs Configuration Server. |
| Allowed Values |
Up to 24 ASCII characters, mixed case is supported. |
| Access |
read/write |
version
| Name |
version |
| Description |
Defines the version number assigned to the software. |
| Allowed Values |
version: free format, typically of the form:
- <board or ONT name>.<major version>.<minor version>.<revision>
example: ONT705GR.3.22.5
|
| Access |
readonly |
videoOverlaySheddingInterval
| Name |
videoOverlaySheddingInterval |
| Description |
The videoOverlaySheddingInterval defines how long after an ONT transitions to battery power that it should start shedding Analog video coax services to save on battery power. |
| Allowed Values |
900 This attribute is not fully supported and should not be modified from its default value of 900 seconds or 15 minutes. |
| Access |
read/write |
vlanid
| Name |
vlanid (voice) |
| Description |
Defines the vlan ID to be used with voice services. |
| Allowed Values |
0 to 4094 |
| Access |
read/write |
voicectrlPersonality
| Name |
voicectrlPersonality |
| Description |
Allows configuration of voice lines in either voice gateway mode, or SIP Softswitch mode. |
| Allowed Values |
0 Unknown/Unconfigured
2 Voice Gateway
3 Softswitch |
| Access |
read/write |