Professional Documents
Culture Documents
Network Analyzer-Fiber Release 9.2.11: User Guide
Network Analyzer-Fiber Release 9.2.11: User Guide
Release 9.2.11
User Guide
3JB-00149-AAAA-PCAAA
Issue 10
July 2017
Network Analyzer-Fiber
July 2017
Copyright © 2017 Nokia.
Legal Notice
Nokia is a registered trademark of Nokia Corporation. Other products and company names mentioned herein may
be trademarks or tradenames of their respective owners. The information presented is subject to change without
notice. No responsibility for inaccuracies contained herein are assumed. Contains proprietary/trade secret information
which is the property of Nokia and must not be made available to, or copied or used by anyone outside Nokia
without its written authorization. Not to be used or disclosed except in accordance with applicable agreements.
2017-07-10T10:20:49.89-05:00
3JB-00149-AAAA-PCAAA
Contents
iv 3JB-00149-AAAA-PCAAA Issue 10
System Settings tab ................................................................................ 145
Display Label Management tab .............................................................. 153
Fault Notification Filter tab ...................................................................... 156
GIS Management tab ............................................................................. 156
Data Feed tab ......................................................................................... 158
PON Utilization tab ................................................................................ 159
URL inbound and outbound redirection .................................................. 161
Issue 10 3JB-00149-AAAA-PCAAA v
vi 3JB-00149-AAAA-PCAAA Issue 10
Preface
The Nokia Motive Network Analyzer-Fiber (NA-F) is a cost-effective remote management
solution for fiber access networks. NA-F leverages the service provider's existing equipment
capabilities to speed up fiber activation, detect faults, and localize them in the access
infrastructure. NA-F provides visibility into the performance of the network, enabling operations
and customer support with a real-time view into issues and potential faults. Motive NA-F
seamlessly integrates within the Motive Customer Service Console (CSC). When service
disruptions generate customer calls to the helpdesk, Nokia Motive NA-F enriches the CSC
with the troubleshooting information needed by customer service representatives (CSRs), who
can rapidly validate the customer's experience, resolve common customer premises issues,
or forward the issue to the appropriate operations team.
Documentation conventions
Convention Description Example
Key name Press a keyboard key. DELETE
Italics Identifies a variable or other replaceable hostname
element, typically inside a code listing.
monospace Used for code listings, file names, and some /dev/null
code used inline.
Bold GUI elements such as menus, buttons, and Click the OK button
other labels.
↵ Press the Return key. ↵
— An em dash in a table cell indicates that —
there is no information.
Special information
The following are examples of how special information is presented in this document:
Warning Indicates that the described activity or situation might, or will, cause equipment
damage or serious performance problems.
Caution Indicates that the described activity or situation might, or will, cause service
interruption.
Note
Provides information that is, or might be, of special interest.
Nokia® is interested in feedback about your experience with this product and its documentation.
If you have comments or suggestions, send an e-mail message to
mpd-techpubsall@list.nokia.com.
■
■
■
■
■
■
■
Representation of the network
NA-F database and topology
TWDM NG-PON2 overview
PON types: GPON-only, TWDM-only, GPON-TWDM
Link status
Link priority
Link quality
1
NA-F concepts
■ Data collection
■ Embedded OTDR
■ Power validation
■ Fault life cycle
■ Fault detection and localization
■ Relationship between power validation, link quality, and faults
■ PON protection
■ PON BW loss
■ PON BW margin
■ Multivendor alarm integration
■ NA-F in service provider workflows
Issue 10 3JB-00149-AAAA-PCAAA 1
NA-F User Guide NA-F concepts
NA-F reduces costs and improves the quality of service in three phases of the subscriber life
cycle:
■ Service activation
■ Continuous supervision
■ Troubleshooting
Service activation. Power validation during service activation provides the following benefits:
■ Improves coordination and information exchange between partners
■ Qualifies the installation to preserve long-term robustness and ensures that no neighboring
fiber branches are affected
■ Enables subscriber self-installation
See “Power validation” on page 41, “Service activation workflow example” on page 59, and
“Fault detection and localization” on page 50.
Troubleshooting. Fault detection and localization identifies faults and degradations in the
fiber branch, suggests probable locations for the fault, and indicates when the fault first occurred
and how it developed over time. This information reduces the time required to address fiber
issues by improving fault escalations and eliminating the fiber from consideration when it is
not the source of the problem. The power validation performed at service activation provides
a baseline against which to compare current performance. See “Troubleshooting workflow
example” on page 59.
2 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide NA-F concepts
■ Optical Link Diagnosis page. The Optical Link Diagnosis page provides detailed current
and historical link quality data. By knowing when a link was first impacted and how that
impact evolved over time, you can better identify the source of the problem. See “Optical
Link Diagnosis page” on page 105.
■ Network Wide tab. From the Network Wide page, you can easily drill down to individual
fiber branches, locate the cause of faults affecting one or more fiber branches, and determine
when faults and degradations began to impact service. See “The NETWORK WIDE tab” on
page 68.
■ PON Diagnosis page. The PON Diagnosis page lists detected faults affecting a PON.
You can click a detected fault to highlight its location in the PON tree view. The Latest Link
Quality table (top left) lists Customer IDs, Branch IDs, and the current link quality. From the
PON tree view, you can drill down to the Optical Link Diagnosis page for an individual
PON branch.
The History tab gives an overview of the link quality for all branches in the PON so you can
determine when a problem arose and how it has evolved over time. Three or ten days of
optical signal level for every branch are displayed (if data have been collected). When you
click the line showing data for a branch, a detailed graph appears showing the signal level
variations on both the ONT and the OLT sides.
In the context of these use cases, users in different roles interact with NA-F in a number of
ways. These roles include:
■ Network operations personnel. Network operations personnel access use the NA-F and
NA-Southbound Interface (NA-SBI) web applications for:
❐ Proactive monitoring of network health and detected faults to enable preventive
maintenance of the optical infrastructure. In this way, you can prevent having an
accumulation of faults that would impact the subscriber's service.
❐ Detecting faults, locating them in the fiber infrastructure, and identifying when the link
quality issue resulting from the fault began and how it evolved over time.
❐ Application administration activity, such as topology import and update, node
synchronization, user management, and so on.
■ Customer Support Representatives (CSRs). A typical deployment uses the NA-F
northbound interface (NBI) to provide an integration with the service provider's customer
care application, providing the CSR with access to the subset of NA-F functionality necessary
to troubleshoot a problem in the context of a support call. The CSR can quickly determine
whether there was a link quality issue with the fiber branch, how severe the impact is, and
to what group to escalate the call so that the fault can be repaired quickly.
Issue 10 3JB-00149-AAAA-PCAAA 3
NA-F concepts NA-F User Guide
■ Field force personnel. Field technicians access NA-F functionality through a laptop or a
handheld device to perform power validation and other troubleshooting tasks in the context
of an installation or support call.
“NA-F architecture ” on page 4 illustrates the architecture of an NA-F installation, the interfaces
available, and the typical integration points:
NA-F architecture
An NA-F deployment offers several integration points with the provider's environment or other
Nokia products. These integrations are typically provided by Nokia customer projects or as
part of a larger Nokia solution. These integration points, illustrated at the top of the figure
above, include:
■ Customer care integration. CSRs typically have an interface they use in the course of
handling a support call. By integrating with the NA-F NBI, you can to expose the subset of
NA-F functionality relevant to the CSR's task in the same user interface they use for other
support call-related tasks.
4 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide NA-F concepts
■ Field force integration. If it is not practical for the field force personnel to access NA-F
in the field through a laptop, a provider might provide access through a smart phone
application using the NA-F NBI.
■ Topology update integrations. You need to update the optical infrastructure centric
database through ongoing topology maintenance:
❐ When new subscribers have been added
❐ Whenever a subscriber moves
❐ When splitters have been added / moved / deleted
The most effective way to do this is to have the BSS or OSS integrate with the NA-F NBI
and update this information automatically whenever it is updated in the system of record.
For more details, see “NA-F database and topology” on page 10.
■ OSS activation workflows. During service activation, NA-F can qualify the installation
and record the received power measurements to serve as a benchmark for future network
supervision and troubleshooting. NA-F can also check other optical links on the same splitter
to make sure no neighbors were affected by the activation of the new link. When integrated
into the service activation workflow, NA-F improves communication between field and central
office personnel. See “Service activation workflow example” on page 59.
The representation of the network in NA-F is based on two mechanisms: Equipment inventory
and Topology replication.
Equipment inventory
The equipment inventory uses the standard NA-SBI or SDC background data collection
mechanism to retrieve information about ONTs and OLTs, cards, ports, and configuration from
a node provider. The update mechanism (Start [collection] link) from the PON view and the
Quick search operation also trigger an instant update of the Equipment inventory.
However, these collections cannot retrieve splitters or PON branches information: This
information must be provided through a topology import and synchronization; it will only be
visible after a topology has been created.
Issue 10 3JB-00149-AAAA-PCAAA 5
NA-F concepts NA-F User Guide
The equipment inventory will not provision collected ONTs in the access node: This is outside
the scope of NA-F and has to be executed directly in the node.
Similarly, the equipment inventory cannot provision OLTs: This operation has to be executed
in the access node.
After first import, NA-F synchronizes the data from the files with the data collected from
equipment inventory and provides, in the PON view, a network representation that matches
the physical network discovered and the logical topology from the files, and maps them together.
Details about topology operations are provided in “Topology Replication tab” on page 137.
NA-F supports up to three levels of cascaded splitters (primary, secondary, and tertiary).
6 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide NA-F concepts
If we isolate one optical link, the model layers can easily be identified in the sections delimited
by the vertical lines in the figure below:
Issue 10 3JB-00149-AAAA-PCAAA 7
NA-F concepts NA-F User Guide
The above representation of the optical link model is not available in the NA-F Optical Link
view or Optical Link Diagnosis page. Instead, the picture below shows the mapping between
the optical links shown in the PON view and the conceptual model. Colored circles in the top
view correspond to the circles with the same color in the bottom view (note that the ID, S/N,
and SLID data from the ONT do not show in the model view).
8 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide NA-F concepts
The description of the topology files can be found in section “Creating the topology files” on
page 11 below. The description of the synchronization, update, and maintenance phases of
the topology replication mechanism can be found in “Topology Replication tab” on page 137.
NA-F R9.2 provides support for TWDM NG-PON2 OLTs. The following figure shows a network
that combines GPON and TWDM NG-PON2 OLTs using a co-existence element.
Issue 10 3JB-00149-AAAA-PCAAA 9
NA-F concepts NA-F User Guide
By decoupling the ONT, OLT, and passive fiber components, NA-F supports equipment and
topology changes over time. Likewise, modeling the PON branch topology data, such as the
relationships between splitters and the fiber sections connecting them, allows Network
Analyzer-Fiber to detect, diagnose, and isolate the location of faults in the optical infrastructure.
Network Analyzer-Fiber discovers the active equipment (the OLTs and ONTs) in the optical
link from the data it collects from network elements. This is the equipment inventory mechanism
mentioned above.
However, the OSS must provide Network Analyzer-Fiber with information about the passive
equipment (the splitters and the fiber) that connect the OLT to the ONT. Initially, you provide
10 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide NA-F concepts
this information through two CSV files, which you import using the NA-F GUI. This is the
topology replication mechanism mentioned above.
Note
File-based import can be used to integrate the OSS with the Network
Analyzer-Fiber so that changes, such as newly added fiber branches as well
as new ONTs, are added automatically and periodically without manual
operation. For more information, see “File-based topology operations” on
page 166.
Splitter CSV (associate the splitter ports to the OLT port; create or
delete GPON-TWDM PONs)
To define the association between the different splitter ports and the OLT port, use the Splitter
CSV file. Also use this file to create or delete GPON-TWDM PONs, which are PONs that have
both GPON PONs and TWDM PONs. The fields are:
Issue 10 3JB-00149-AAAA-PCAAA 11
NA-F concepts NA-F User Guide
12 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide NA-F concepts
Issue 10 3JB-00149-AAAA-PCAAA 13
NA-F concepts NA-F User Guide
The following example shows a splitter file that has three records. Splitter “SPLX” is connected
to “SOMEGPON:1-1-1-1”, while the splitter “SPLY” is connected to “SPLX” on port 1 and
“SPLZ” is connected to “SPLX” on port 2:
#Splitter name,OLT port Address,Parent splitter name,Parent splitter port,Vendor name,⇦
Model name,Serial number,Splitter ratio,Feeder cable name,CEXName,CG address,PON ID
SPLX,SOMEGPON:1-1-1-1,,,SomeSplitterVendor,SomeSplitterModel,XXX,2,FeederCableName,,,
SPLY,,SPLX,1,SomeSplitterVendor,SomeSplitterModel,XXX,32,FeederCableName,,,
SPLZ,,SPLX,2,SomeSplitterVendor,SomeSplitterModel,XXX,32,FeederCableName,,,
Note
Even though some fields are optional, there must be extra commas in the CSV
file to indicate that the fields are not used. Unused fields get no value, but you
cannot skip them. See the two extra commas in positions 3 and 4 in the first
record of the example above.
“Topology files and the PON” on page 24 provides a graphical representation of this splitter
data.
To create a GPON-TWDM PON, coupling GPON PONs and TWDM PONs. Assume the
following PONs and PON IDs were created during a live collection or hourly collection:
■ GPON-only PON with PON ID = ISAM39:1-1-1-1
■ TWDM-only PON with PON ID = ISAM39:1
To create a GPON-TWDM PON, import a new splitter file with the following line:
Splitter1,ISAM39:1-1-1-1,,,,Feeder1,CEX1,ISAM39:1,PON1
The two PONs are then merged into one PON with PON ID=PON1 and are connected to
Splitter1. Splitter2 and its children are deleted.
To delete a GPON-TWDM PON, decoupling the GPON PONs and TWDM PONs. Assume
you have a GPON-TWDM PON that was created with the following line:
Splitter1,ISAM39:1-1-1-1,,,,Feeder1,CEX1,ISAM39:1,PON1
To delete the GPON-TWDM PON, splitting it into two PONs, import a new splitter file with
these lines:
Splitter1,ISAM39:1-1-1-1,,,,Feeder1,,,
Splitter2,,,,,Feeder1,CEX1,ISAM39:1,PON1
14 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide NA-F concepts
To rename a CEx, import a new splitter file that uses the same lines as the initial import—with
the new name.
To move a CEx to a new GPON or channel group (CG), import a new splitter file that uses the
same lines as the initial import—with a reference to another GPON, CG, or CG splitter.
To delete a CEx, import a new splitter file that has the CEx removed.
Note
For best performance during a topology synchronization / update, group the
ONTs you mention in the CSV file by PON.
R9.0 introduces the notion of critical link. When an optical link is of CRITICAL priority and the
ONT is disconnected (ONT INACT alarm), the link is localized immediately and the alarm is
forwarded to the fault notification interface. See "Optical Link Priority" in the table below.
The number of critical links is limited by an absolute value. When the threshold is reached, all
further imported links are considered regular, even when they are indicated as CRITICAL in
the topology file. However, a warning is present in the response file for those. Actions needed
are explained with details in “Specific actions for critical links” on page 25.
Issue 10 3JB-00149-AAAA-PCAAA 15
NA-F concepts NA-F User Guide
Optional if
not.
3 Splitter Port Within the Optional The splitter port to which the ONT
Number range defined connects.
by the Splitter
ratio A value of ? leaves the existing value in
place.
16 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide NA-F concepts
Note
A question mark (?) can
be used for the ONT Serial
Number. This does not
affect the above
description. Even when a
value was already present
in DB, it is updated with
what is discovered from
the network.
Note
A question mark (?) can
be used for the ONT SLID.
This does not affect the
above description. Even
when a value was already
present in DB, it is
updated with what is
discovered from the
network.
7 Absolute Implicit, as Required if If you omit this field, you should also not
PV the value is a you want to choose that strategy or you get an error
threshold floating-point use the message.
number absolute
threshold A value of ? leaves the existing value in
strategy in place. A blank or nonnumeric value clears
PV the existing value.
calculation.
Optional if Note that a 3dB transceiver accuracy
not. value is subtracted from the imported
value defined here.
Issue 10 3JB-00149-AAAA-PCAAA 17
NA-F concepts NA-F User Guide
The following example shows a PON branch file (with headers; to be omitted in the actual file)
that lists three records. This example uses the ONT Address as the identifier:
PON_branch_ID,Splitter_Name,Splitter_Port_Id,ONT_Address,ONT_SN,ONT_SLID,PBV_Threshold,⇦
Optical_Link_Priority,RESERVED,Custom_Label_1,Custom_Label_2,Custom_Label_3
555 Main 78756,SPLY,1,SOMEGPON:1-1-1-1-1,,,,,,District,Local Area,Vendor
18 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide NA-F concepts
Note
Even though fields 4-5-6-7-8-9-10-11-12 are optional, extra commas must be
used in the CSV file to indicate that the fields are not used. Unused fields get
no value, but you cannot skip them.
“Topology files and the PON” on page 24 provides a graphical representation of this PON
branch data.
NA-F requires the CSV file to include an ONT identifier (address, serial number, or SLID) to
link the ONT to a PON branch. NA-F uses the link when data comes in for an ONT through a
data collection.
When the PON branch CSV file is imported, the linking strategy is selected implicitly per line,
depending on the presence of the identifiers in the file. So, each line must have at least one
of the three identifiers (address, serial number, SLID). The first identifier found determines the
initial linking strategy. If subsequent identifiers are also present, they are ignored. Later, when
the ONT is physically connected or provisioned in the ISAM/GPON node and data is collected
for the ONT, NA-F gets the ONT address through either data collection or discovery.
The linking strategies and their effects on subscriber moves are described below.
■ Address-based linking strategy
The ONT address is used to link the ONT to the PON branch. The last digit of the ONT
address is the ONT number. For example, in SOMEGPON:1-2-3-4-5, "5" is the ONT number,
and "SOMEGPON:1-2-3-4" is the TL1 port address.
For a TWDM-only network or a GPON-TWDM network, you can view the topology in NA-F
only after a live collection or hourly collection happens. Also, feeder cables are not linked
and might need a resynch after an hourly collection.
■ Serial number-based linking strategy
The serial number of the ONT device itself is used to link the ONT to the PON branch. This
scenario requires the ONT serial number to identify the subscriber and the OSS to link the
ONT serial number to the PON branch ID. In case duplicate serial number entries are present
in the NA-F database, the ONT is linked to the first entry found in the database.
■ SLID-based linking strategy
The subscriber location ID, typically assigned to the subscriber using an account number,
is used to link the ONT to the PON branch. This scenario requires the SLID to identify the
Issue 10 3JB-00149-AAAA-PCAAA 19
NA-F concepts NA-F User Guide
subscriber and the OSS to link the SLID to the PON branch ID. In case duplicate SLID entries
are present in the NA-F database, the ONT is linked to the first entry found in the database.
Examples.
■ No data collection has happened for an ONT address; the ONT address, and thus, the serial
number and SLID, are not known in the NA-F system; there is no fiber branch in the NA-F
system.
The fiber branch is created and is linked to the ONT address. The ONT's link status is
Newly Imported. After a background collection for the ONT address, NA-F updates the
serial number and SLID for that ONT and the link status changes according to the optical
link lifecycle, described in “Link status” on page 30.
❐ Serial number-based or SLID-based linking
The fiber branch is created; however, NA-F cannot find the ONT with that serial number
or SLID because data collection has not happened. So, no linking is done. . After a
background collection, the ONT address with its serial number and SLID is discovered in
the NA-F system. At this point, NA-F does not have the link between the PON branch and
the ONT. The provider must import the same topology, which then identifies the ONT from
the serial number or SLID, based on the strategy, and links the PON branch to it. For
information about the optical link lifecycle, see “Link status” on page 30.
■ A data collection has happened for an ONT, but there is no topology for it.
When the provider imports a topology file with an address-based, serial number-based, or
SLID-based linking strategy, the fiber branch is created and linked to the correct ONT.
■ Assume that Mr. Smith moves from 555 Main Street to 444 Oak Street. If Mr. Smith takes
his ONT (serial number ALCLF9A1A28A) to his new address, the provider must assign him
the ONT number previously associated with that fiber branch (ONT #2) so that his ONT
address is now SOMEGPON:1-1-1-1-2 and must associate the new ONT address with Mr.
Smith's account in their database of record. Because the ONT addresses-PON branch ID
associations do not change, no change is required to the NA-F database. NA-F automatically
updates the ONT serial number associated with the fiber branch based on collected data.
20 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide NA-F concepts
ONT #1
1 555 Main 78756 SN ALCLF9A1A28A
SPLY
1
SOMEGPON:
SPLX
1-1-1-1
2
ONT #2
1 444 Oak 78756
SN ALCLF9A1A269
SPLZ
ONT #3
2 333 Pine 78756
SN ALCLF9A1A271
ONT #2
1 444 Oak 78756
SN ALCLF9A1A28A
SPLZ
ONT #3
2 333 Pine 78756
SN ALCLF9A1A271
However, if the OSS keeps the ONT address with Mr. Smith or if the OSS assigns a new
ONT address to Mr. Smith other than the one already assigned to the branch, a change in
the ONT address-PON branch ID association occurs. So, the NA-F topology must be updated
with the new association. This change in association can be accomplished as follows:
❐ Address-based linking
In the topology import file, specify the new TL1 address of the ONT to the PON branch to
which Mr. Smith moves.
❐ Serial number-based linking
You can use this strategy after the OSS has changed the TL1 address of Mr. Smith and
after Mr. Smith has connected his ONT to his new PON branch.
In the topology file, specify the serial number for the PON branch to which Mr. Smith has
moved. The TL1 address need not be specified.
Issue 10 3JB-00149-AAAA-PCAAA 21
NA-F concepts NA-F User Guide
ONT #1
1 555 Main 78756 SN ALCLF9A1A28A
SPLY
1
SOMEGPON:
SPLX
1-1-1-1
2
ONT #2
1 444 Oak 78756
SN ALCLF9A1A269
SPLZ
ONT #3
2 333 Pine 78756
SN ALCLF9A1A271
ONT #1
1 444 Oak 78756
SN ALCLF9A1A28A
SPLZ
ONT #3
2 333 Pine 78756
SN ALCLF9A1A271
❐ SLID-based linking
Similar to the serial-based case, you can use this strategy after the OSS has changed the
TL1 address of Mr. Smith and after Mr. Smith has connected his ONT to his new PON
branch.
In the topology file, specify the subscriber location ID. The TL1 address need not be
specified.
Any values you specify in the Feeder cable CSV file take precedence over the feeder cable
field in the Splitter CSV file.
This CSV file has the following format (both fields are mandatory):
<PON Address>,<Feeder cable name>
22 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide NA-F concepts
The PON with the specified address is renamed using the new PON ID <PON ID name>.
When you specify an address, the address must exist and must be specified using the proper
syntax: For a GPON PON, the syntax is SNMPagent:OLT Port address; for a TWDM PON,
the syntax is SNMPagent:CG address.
Note
Even though some fields are optional, there must be extra commas in the CSV
file to indicate that the fields are not used. Unused fields get no value, but you
cannot skip them.
Example:
#PON_branch_ID, ONT Type
NG2_ONT1,TWDM
NG2_ONT2,TWDM
Issue 10 3JB-00149-AAAA-PCAAA 23
NA-F concepts NA-F User Guide
gponbranch2,GPON
gponbranch5,GPON
ONT #1
1 555 Main 78756 SN ALCLF9A1A28A
SPLY
1
SOMEGPON:
SPLX
1-1-1-1
2
ONT #2
1 444 Oak 78756
SN ALCLF9A1A269
SPLZ
ONT #3
2 333 Pine 78756
SN ALCLF9A1A271
After NA-F has collected data from the network, it correlates the discovered information with
the imported topology data and constructs a graphical PON topology tree. For more information,
see “Topology (classic) tab, Topology (compact) tab, and Topology tab” on page 79.
24 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide NA-F concepts
Overview
Not all optical links are equal, especially in the interpretation of a disconnect. For regular
subscribers, it is expected that the link will go out of service from time to time. However, for
VIP customers or mobile backhaul, such interrupts must be immediately localized and forwarded
to the fault notification interface. This is made possible by defining the optical link as critical.
Critical links are defined in the CSV import topology file by adding CRITICAL at the end of the
line.
Example:
Details
When you import a topology file, if you do not assign a priority of REGULAR or CRITICAL for a link:
■ A new link is assigned the REGULAR priority
■ An existing link retains its priority
The number of critical links is limited. It is an absolute value. When this value is reached, all
links imported are then regular, even when they are marked CRITICAL in the topology file.
However, a warning is included in the response file for these critical links that are considered
regular.
Issue 10 3JB-00149-AAAA-PCAAA 25
NA-F concepts NA-F User Guide
26 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide NA-F concepts
■ If the fault affecting a critical link is not a feeder cable fault and is resolved before an hourly
collection happens, a "fault resolved" notification is not sent.
Topology maintenance
The administrator has several ways to manage topology information in NA-F:
■ Topology synchronization: This action completes the following tasks in the specified order:
1. Adds / updates all the feeder cables specified in the input file.
3. Adds / updates all the PON branches specified in the input file.
4. Removes all the PON branches that exist in the NA-F system but that are not part of the
PON ID CSV file.
5. Removes all the ONTs that satisfy both of the following conditions:
❐ Has no PON branch ID assigned to it
❐ Has link status of NEW, NO_ADDRESS, or NOT_PROVISIONED
6. Removes ALL the splitters that do not have any PON branches linked to them (and are
therefore considered as ‘empty’). The check is done for all the splitters that exist in the
NA-F system—including the ones that were added in step 2.
■ Topology incremental update: This action completes the following tasks in the specified
order:
1. Adds / updates all the feeder cables specified in the input file.
3. Adds / updates all the PON branches specified in the input file.
■ Topology delete: This are two separate requests that the administrator can trigger on-demand:
Issue 10 3JB-00149-AAAA-PCAAA 27
NA-F concepts NA-F User Guide
❐ Remove PON branches: Removes all the PON branches that are specified in the input
CSV file.
❐ Delete empty splitters: Removes ALL the splitters that do not have any PON branches
linked to them.
■ PON ID update: This action enables the administrator to assign a new PON ID to an existing
PON.
For information about how to complete these tasks in the GUI, see “Topology Replication
tab” on page 137.
Best practices.
■ Use the topology update daily to feed NA-F with your daily topology changes
■ Use the topology synchronization weekly to clean up unused components from the topology
This practice is recommended because the topology update has a smaller impact on the
performance and finishes in considerably less time than the topology synchronization, which
is a heavy operation.
Important As an alternative to the topology operations through the user interface, NA-F
also offers a file-based full automated mode, described in “File-based topology
operations” on page 166.
Topology audit
R9.0 introduced a topology auditing process in two situations:
■ At topology synchronization or topology incremental update
This auditing process runs together with the synchronization or incremental update operations.
It reports additional inconsistencies listed in the problems file (next to the existing warnings
and errors). The problems file gives a summary and repair advice for all detected problems.
For more information, see “To have NA-F audit your topology import” on page 143.
■ On explicit request from the administrator, after at least one hour of data collection
This audit is run from the Administration tab ->Topology Audit Report tab. It audits the
whole topology or a specific OLT. The report, generated as a CSV or Excel file, is available
for download from the page that opens after submitting the request. See “Topology Audit
Report tab” on page 144 for more information.
28 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide NA-F concepts
Terminology notes. In NA-F 9.1, the following terms are identical: PON, GPON, OLT port,
ODN. However, starting with NA-F R9.2, PON denotes an ODN with a passive tree-structured
fiber topology that uses GPON, TWDM, or both to transport data.
A channel is a wavelength, or lambda, that transports either a GPON signal or a TWDM channel
pair signal. A channel is terminated on an OLT port.
A PON ID is a unique identifier of the PON. Channels map to the parent object PON through
the PON ID. The PON can be GPON-only, TWDM-only, or GPON-TWDM.
Address format. Because TWDM ONTs are provisioned on a SCG, the address format for
these ONTs is: <ChannelGroup>-<SubChannelGroup>-<ONT>.
Issue 10 3JB-00149-AAAA-PCAAA 29
NA-F concepts NA-F User Guide
For an illustration showing how a GPON-TWDM PON is formed, see “Optical link model” on
page 6.
Link status
NA-F 8.2 introduced a new way of representing the status of the optical links in the network.
This status is a combination of the ONT status and the PON branch status for a individual
optical link (the unique link from the OLT through splitters and PON branches to one user's
ONT).
Phases. An optical link is at any moment in one of the three following phases:
■ Definition (topology or equipment inventory)
■ Activation
■ Operation
Statuses. An optical link can be in any of the following statuses, which in many cases actually
reflect the current status of the considered ONT:
■ During Definition phase, via topology or equipment inventory:
❐ Newly imported (ONT)
❐ Not provisioned (ONT)
■ During Activation phase:
❐ Waiting for ONT
❐ Waiting long for ONT
❐ Never connected ONT
■ During Operation phase:
❐ Connected (ONT)
❐ Disconnected (ONT)
■ Through Configuration:
❐ Discovered (ONT)
❐ Administrative down
❐ Disabled (ONT)
30 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide NA-F concepts
Lifecycle of an optical link. The table below summarizes the possible stages in the lifecycle
of an optical link:
Operational down
Administrative
down
Waiting for…
Disabled
Disabled This is a PON branch without ONT address reference. This
optical link can occur after another PON branch was defined that
referenced the same ONT address, and the original PON
branch was not redefined with a new ONT address (only
one PON branch can reference a given ONT). Another
case is if the PON branch referenced an ONT address with
invalid syntax at import.
Operational down
Administrative
down
Waiting for…
Issue 10 3JB-00149-AAAA-PCAAA 31
NA-F concepts NA-F User Guide
Operational down
Administrative
down
Waiting for…
Disabled
Discovered A discovered optical link is an ONT that is physically Discovered
optical link connected to the PON but was not provisioned in the OLT.
In this state, the ONT cannot be attached to a PON branch.
NA-F displays such ONTs in quick search results or PON
view updates; however, it does not list them in the Optical
Link view.
Link priority
Link priority is either critical or regular. When a disconnect occurs, the priority determines how
the interruption is handled. For more information about link priority, see “Critical links versus
regular links” on page 25.
Link quality
The link quality classifies the optical link according to its optical performance and the (potential)
impact the performance has on the service. NA-F determines the link quality based on LOS,
dying gasp, and by analyzing the received power levels at the OLT (optical line terminal) and
ONT (optical network terminal). The link quality is displayed throughout the user interface in
reports that aggregate the network-wide and PON-wide data, as well as for individual optical
links. Each of the link quality categories is represented in the user interface with a color, as
shown below.
32 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide NA-F concepts
Issue 10 3JB-00149-AAAA-PCAAA 33
NA-F concepts NA-F User Guide
Data collection
NA-F is installed with NA-Southbound Interface (NA-SBI), which maintains the list of all network
elements and the SNMP/TFTP/SFTP configuration used to communicate with them.
Important NA-F requires NA-SBI regardless of the use of an external 5529 SDC.
The live collection is defined as the SNMP collection done when the user visits a PON page
or an Optical Link page or requests a service diagnosis. This live collection is done by NA-F
itself. The SNMP configuration required to communicate with the network elements is fetched
from NA-SBI.
■ The 15-minute background collection
The 15-minute background collection can be done by NA-SBI, an external 5529 SDC R9.0.x,
or an external 5529 SDC R9.4.y (or later). (For the exact SDC version, see the release
notes.)
This collection is supported on ISAM 7302, 7330, 7360 nodes by NA-SBI, 5529 SDC R9.0.x,
and 5529 SDC R9.4.y (or later). The collection is supported on GPON 7342 nodes by NA-SBI
and 5529 SDC R9.4.y (or later). It uses BFMU to collect the data.
■ The hourly background collection
The hourly background collection is done by NA-SBI for GPON 7342 and ISAM 7302, 7330,
7360 nodes.
The live and the hourly data collections gather the following optical infrastructure data:
● ONT and OLT OTM data
● Transceiver parameters
● Tx and Rx power level
● Equipment status data
● Card
● Port
● ONT
34 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide NA-F concepts
● Quality parameters
● Bit error counter
● Configuration parameters
● SLID
● Serial number
● Traffic data
The live and the 15-minute data collections gather traffic data. These traffic counters are used
to display information for Subscriber bandwidth utilization and channel bandwidth utilization in
the PON Utilization tab on the PON Diagnosis page and in the Service Diagnosis tab on
the Optical Link Diagnosis page. See “PON Utilization tab” on page 95 and “Service Diagnosis
tab” on page 120.
For information about how to export these statistics, see “The EXPORT STATISTICS tab” on
page 126.
To use NA-F and do live collection, you must synchronize NA-SBI with a node provider, as
explained in "Synchronizing network element providers" in the NA-SBI User Guide.
To start a collection with NA-SBI, follow the steps in the "To start a statistics collection"
procedure in the NA-SBI User Guide using the NA-F 15 Minutes strategy.
■ 5529 SDC R9.0.x
An external 5529 SDC R9.0.x also comes with the collection strategy named NA-F 15-min
collection for ALU.
To start a collection with an external 5529 SDC R9.0.x, see “Initial startup and configuration”
in NA-F Installation Guide.
Issue 10 3JB-00149-AAAA-PCAAA 35
NA-F concepts NA-F User Guide
To start a collection with an external 5529 SDC R9.4.y (or later), you must run an ipm script.
For more information, see “Initial startup and configuration” in NA-F Installation Guide.
Embedded OTDR
This section describes the embedded ODTR support available starting with NA-F R9.0.
Terminology
OTDR stands for Optical Time Domain Reflectometry
OTDR is a technology that measures the optical reflections. With this technology, you can
measure losses and reflections to determine at what distance from the OLT they occur. For
traditional OTDR measurements, an external test head is required. NA-F supports Nokia
embedded OTDR.
OTDR can only be launched if an eOTDR-enabled SFP is plugged in the PON port.
If the device is not pluggable but is integrated on the board, it is called an SFF: Small Form
Factor.
36 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide NA-F concepts
Alarm-triggered OTDR
1. A cable cut is introduced in the collector section. One of the end-users happens to be
watching TV and notices this immediately, but his neighbors are unaware of the fault.
2. OSS Alarm Dispatcher (5529 OAD) forwards many INACT alarms to NA-F.
3. If more than 50% of the optical links behind a certain splitter port generate an INACT, an
OTDR diagnosis on the PON starts automatically.
5. The current OTDR measurement is compared to the reference OTDR measurement for
that PON. NA-F detects the distance to the fiber cut.
6. If the end-user who was watching TV at the time the fiber was cut calls the helpdesk, the
helpdesk can immediately inform him that they are aware that a fiber cut occurred a couple
of minutes ago. After 10 minutes, a field force can be sent to the exact location.
■ Link loss validation
Link loss validation based on embedded OTDR measures the link loss between the OLT
port and an inserted UPC.
A field technician installs a new ONT and validates the installation. He will insert an open
UPC for this validation test. This will cause a strong reflection. This validation is particularly
beneficial for the very first link behind a splitter. For the links that are activated afterwards,
there is already a benchmark and you can run an accurate power validation.
Many operators suffer from a bad installation: When the first link is bad, one cannot measure
that it is bad (as long as no comparison is possible). With this link loss validation, you can.
The link loss validation is very useful if the installation is done by a third-party installer,
because the results are saved in NA-F and can be checked later on.
Issue 10 3JB-00149-AAAA-PCAAA 37
NA-F concepts NA-F User Guide
OTDR further refines the diagnosis results to narrow down the fault location geographically.
The distance estimation by OTDR is much more precise than the fault localization by correlation
available in Optical Diagnosis & Supervision.
OTDR can be used for PON validation or infrastructure validation. The Optical Diagnosis &
Supervision feature power validation focuses on the drop validation, while infrastructure
validation focuses on OLT-to-distribution-point validation.
OTDR can be launched manually or automatically (based on incoming alarms sent by the 5529
OAD or a third-party alarm dispatcher).
OTDR measurements are retrieved from the network element (NE) using TFTP or SFTP,
depending on settings in the NE and NA-SBI or SDC. For more information, see "File transfer
management" in the SDC User Guide.
OTDR sends a pulse—a kind of a flash—inside a fiber and measures the reflection of this
pulse over time in a trace. This trace provides a view on how the light travels and is reflected
back.
The resulting OTDR trace is a combination of signal attenuation due to Raleigh backscattering
by a fiber, signal loss events, and local reflections. Raleigh backscattering is attenuating the
signal due to impurities of the fiber structure. This is quite similar to sun glasses that dim the
light.
A signal loss event is a sudden loss of signal due to obstacles like dirt or air in between
connectors, or due to splitter signal loss. Because of the downward flank, the receiver will need
to recover, resulting in a attenuation dead zone.
Reflections are like when you see your own image in a glass window. Because of the reflection,
the receiver is temporarily blinded: This is called an event dead zone.
38 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide NA-F concepts
When behind a splitter, the trace displays a combination of multiple signals returning from the
different fiber branches. All signal loss types are combined in one single dimension trace. It is
impossible to assign an event found in the trace to one of the fiber branches. In the case events
overlap, it is also impossible to pull them apart. Therefore, it is almost impossible to detect the
topology from a trace.
OTDR can measure losses and reflections on the feeder section (that is, between the OLT
and the first splitter) at distances up to 20 km.
It can do accurate loss measurements before the first splitter and after one 1:2 splitter.
Because reflections are much easier to detect than optical losses, an open UPC connector
can be detected even after a 1:64 split. A UPC connector is a straight connector that reflects
the signal strongly.
Issue 10 3JB-00149-AAAA-PCAAA 39
NA-F concepts NA-F User Guide
OTDR span
The OTDR trace has an initial dead zone of 200 to 500 m. This is caused by internal reflections
within the SFP. Within this dead zone, it is still possible to detect events like a cut or a dirty or
loose connector, but without localization.
After an event (for example a reflection), there is an event dead zone of 10 m. This means that
it will be impossible to distinguish events if they are situated within 10 m from each other.
In case the first splitter is situated at more than 20 km from the OLT, the OTDR measurement
can accurately identify attenuations within 20 km.
In most cases, the feeder section is less than 20 km. OTDR can measure loss of signals beyond
one 1:2 splitter. The maximum distance from the OLT in such cases is 8 km.
Reflections can be very strong, especially when the end of the fiber is straight, like for a UPC
connector. Most of the signal is reflected back. For an angular connector (APC), there will be
more attenuation and almost no reflection (unless the connector is dirty). Because the reflections
received from an open UPC are so strong, it can even be detected after a split of 1:64 (this
can be after a series of splitters with a total split of up to 1:64, for example three splitters with
a split ratio of 1:4 or a mix of splitters with different ratios).
A poor mechanical splice can be seen after a splitter of 1:16 and a random fiber break after a
splitter of 1:8. A random fiber break is typically not as straight as a UPC connector. There is
more attenuation and less reflection in such cases.
The key advantages of the Nokia NA-F embedded OTDR solution are:
■ In service, no traffic interrupt: NA-F measures OTDR constantly without interrupting the
service on the optical link.
■ In band: The fault impact is measured on the downstream wavelength.
■ OTDR is embedded: No coupler, no extra ODF, and no extra hardware are needed; hence,
it is a cost-effective solution.
40 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide NA-F concepts
Power validation
Power validation, or PV, compares the current upstream and downstream received power
levels of an optical link to a reference value to determine whether the optical link's attenuation
falls within an acceptable range. The result of power validation establishes a baseline for
determining the link quality of the optical link.
The first step consists of estimating some references, in terms of RxPower, for the entire PON
as well as for the last splitter to which the branch requesting the PV is connected. It performs
an estimation of the typical RxPower level that should be expected for a given branch with
respect to what is measured as power in the ONT-neighbors on the PON as well as in the
ONT-neighbors on the same last-splitter.
The second step consists in checking whether the installation of the branch has been properly
performed. In other words, the purpose is to assess if the RxPower is comparable to what the
neighbors in the PON or from the same (last) splitter receive, and if the PHY QoS is good. This
PHY QoS is based on the existence of bit errors.
You can initiate a power validation through the NA-F GUI or using the NBI (see the Northbound
OSS Interface Developer Guide).
This on-demand PV performs a PON-level data collection. The power level is validated for all
the connected ONTs on the PON, and the latest results are updated for them.
Note
Starting with Release 9.0, the power validation is always executed on the PON
level and causes updates for multiple optical link PV results.
From R9.0 on, power validation is also planned at the PON level automatically in the following
cases:
Issue 10 3JB-00149-AAAA-PCAAA 41
NA-F concepts NA-F User Guide
The actual PV is always run as part of an hourly collection, unless it has been done manually
by the user before the planned time.
Example:
Default value = 2
Scenario 1:
Time Action
10:07 Hourly collection: ONT is collected for the first time; plan PV.
11:00 Hourly collection: PV is not run because two hours have not passed since the
planning of PV and only one hourly collection has happened.
12:00 Hourly collection: missed: PV is not run.
13:00 Hourly collection: PV is run because we have two hourly collections and two hours
have passed since the PV planning time (actually already almost three hours).
Scenario 2:
Time Action
10:07 Hourly collection: ONT is collected for the first time; plan PV.
11:00 Hourly collection: PV is not run because two hours have not passed since the
planning of PV and only one hourly collection has happened.
12:00 Hourly collection: PV is not run because two hours have not passed since the
planning of PV.
13:00 Hourly collection: PV is run because we have two hourly collections (in fact, we
have three) and two hours have passed since the PV planning time.
42 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide NA-F concepts
Each optical link has a power validation result that is you can see on the Optical Link Diagnosis
page, under the Power Validation tab.
The UI shows the current and historical data and the originator of the PV (automatic or a specific
user).
When an optical link fails the validation process, it is with high confidence that there is an
impairment and with high statistical significance that it is weaker than its neighbors or that its
PHY QoS is affected.
The possible results for an optical link's power validation are as follows. For more information,
see “Detailed reasons and repair actions” on page 44.
PV results
Value Icon Description
None No power validation has been performed or is currently being performed
on the optical link.
Normal The most recent power validation determined that the optical link's power
level was acceptable. A power validation result is saved as a reference,
consisting of the collected data, a PON branch received power reference,
and the fact that the validation succeeded.
Abnormal The most recent power validation determined that the optical link's power
level was not acceptable. The result, consisting of the collected data, a
PON branch received power reference, and the fact that the validation
failed, is stored.
Not The most recent power validation failed to determine the optical link's
enough power level.
data
PV statuses
Value Description
Planned PV is planned automatically due to:
■ ONT connect (OLS going to connected state)
■ When a new ONT is collected
■ When the ONT, SFP, or OLT card is replaced
Completed PV has run.
Issue 10 3JB-00149-AAAA-PCAAA 43
NA-F concepts NA-F User Guide
PV statuses (continued)
Value Description
Important The status does not say anything about the PV result.
In PV is running.
progress
44 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide NA-F concepts
Issue 10 3JB-00149-AAAA-PCAAA 45
NA-F concepts NA-F User Guide
❐ OLT card S/N change: A new PON PV is planned for all OLT ports, and the current PV
for all optical links connected to the OLT card becomes empty (because they are not valid
anymore - physical change of OLT card).
■ When a ONT at collection time gets connected and there is no current PV:
❐ A PV gets planned for the PON (so you see it for all ONT parts of the PON).
■ When PV fails because of Not Enough Data and there is already a current PV:
❐ The current PV stays and an entry in the table with all completed PV results is added (the
"not enough data" line).
Note
Feeder cable cuts are passive faults. However, because they are based on
alarms, they behave as active faults with respect to the fault life cycle.
Depending on the type, the faults can be in any of the following states:
2. Resolved
Passive equipment fault 1. Active
3. Resolved
46 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide NA-F concepts
Fault transitions
Fault type Transition Comment
Active equipment fault Active to
Resolved
Passive equipment fault Active to Pending The operator confirms that the cause of the
to Resolved interrupted service has been fixed.
Views on faults
NA-F offers different views on faults. Those views are described in their corresponding sections
in Chapter 2, “The NA-F user interface” on page 63.
■ The Network Wide view shows the most recent faults that have been recorded in the
database during the automatic fault collection process that runs hourly.
This view is for supervision or maintenance, as most of the time the faults collected this
way do not impact the service and do not call for immediate solution.
■ The PON view scans the network and returns the list of PONs present in the network. Each
PON can be zoomed, collecting in real time the status of the ONTs composing the PON,
the impacts on service and, if any, the detected faults.
■ The Optical Link view allows you to launch a manual fault collection. It collects faults that
have appeared since the last automatic fault collection. The faults shown here are not
recorded in the database if they are resolved before the next automatic collection.
Issue 10 3JB-00149-AAAA-PCAAA 47
NA-F concepts NA-F User Guide
This view is for troubleshooting. Use it to visualize, identify, and resolve faults that are
impacting the service and require immediate reaction, typically when a customer calls the
online help to report a malfunction.
■ The Fault view displays the history of faults persisted in the NA-F database. This view is for
fault management: Transition to Resolved state, launch of a manual collection through the
PON Diagnosis page or Optical Link Diagnosis page.
View classification
View Name Real time view vs Comment
periodic view
Network Periodic Can be defined as real time if declared during NA-F
Wide installation
PON Real time
Optical Link Real time
Fault [History of faults]
1
The Nokia 5529 OSS Alarm Dispatcher (OAD) is part of the AND EMS Network Management product family. OAD
is an advanced alarm dispatching solution that facilitates the integration of alarm flows into client OSS applications.
The 5529 OAD northbound interface is based on widely accepted web service standards, XML/SOAP. Network element
alarms and EMS alarms are reported in the TMF multi technology MTOSI v1.1 standard. The product simplifies alarm
collection, aggregation, and dispatching to OSSs.
48 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide NA-F concepts
Fault visibility
The table below shows which faults in which state are visible in which view.
Fault visibility
View Visible faults Comment
name
Active Pending Resolved
Network V X X Shows only the active faults in the Most impacting
Wide faults panel.
PON V X X
Optical V V V
Link
Fault V V V You can filter on status using the Filters panel above
the list
Issue 10 3JB-00149-AAAA-PCAAA 49
NA-F concepts NA-F User Guide
Note
The timestamps of the signal interrupts can improve this determination but are
node-dependent. For the list of nodes that support it, see the Customer Release
Notes.
The following system settings are used to correlate detections of the same fault:
❐ Correlation window to aggregate Loss of Signal faults
❐ Correlation window to aggregate Degradation faults with Loss of Signal faults
These settings are available from the Administration tab, on the Fault
Aggregation subtab. For information about these settings, see “Fault
Aggregation group” on page 146.
■ Identify which optical links are affected by the fault and determine the impact it has.
NA-F performs fault detection and localization in two contexts, supervision and troubleshooting:
50 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide NA-F concepts
1. A macrobend in a fiber segment in the optical link increases the optical signal loss above
the level recorded in the power validation reference but does not introduce transmission
errors or cross the ONT/OLT sensitivity threshold. Therefore, NA-F records the link quality
as “Reduced robustness.” See number 1 in Relationship between power validation, link
quality, and faults.
2. Later, a contact misorientation or UPC/APC contact combines with the effect of the
macrobend to further reduce the optical signal. The optical loss now has increased to a
point where transmission errors are introduced, or the ONT/OLT sensitivity threshold is
crossed. NA-F now lists the link quality of the optical link as “Degraded.” See number 2 in
Relationship between power validation, link quality, and faults.
3. At a later point in time, a dirty connector combines with the other two faults to reduce the
signal to a point where connectivity is no longer possible. NA-F now lists the link quality due
to these faults as “Interrupted.” See number 3 in Relationship between power validation,
link quality, and faults.
Any one of these faults would cause only minor problems, but in combination they interrupt
the subscriber's service completely.
Issue 10 3JB-00149-AAAA-PCAAA 51
NA-F concepts NA-F User Guide
PON protection
With the increasing split ratios and deployment of business-critical services, implementing
PON protection schemes is important. ITU-T specification G.984.1 section 14 describes multiple
PON protection schemes. ISAM GPON line cards implement the Type B PON protections
defined in this standard. These protections address route diversity to the first splitter in a 1:1
arrangement. The PON links of the ISAM can be configured in protection groups, or pairs, on
the PON boards across the shelf. (The boards should be of the same type.) In case an active
PON link fails, all traffic is switched to the other port in the protection group without service
loss.
Creating. You do not directly define protection groups. Instead, you import the topology for
a redundant setup. NA-F discovers when a PON is in a protection group but does not provision
it.
The paired PON port is learned from the OLT; do not specify the paired PON in your CSV file.
Specify the feeder cable for the secondary, or paired, PON, in the Feeder cable CSV file
instead of the Splitter CSV file. For more information, see “Feeder cable CSV (specify feeder
cable for a paired PON) ” on page 22.
52 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide NA-F concepts
Forwarding to the primary PON. With a paired PON, you are forwarded to the primary
PON when you:
■ Do a Quick Search using the box in the upper-right corner for a paired PON
■ Use URL-encoded navigation for a paired PON
■ Are on the PON tab, select a paired PON, and click Show
■ Are on the Fault tab, select a fault on a paired PON, and click Go to PON
■ Are on the Alarm tab, select an alarm on a paired PON, and click Go to PON
Tx parameters of active PON used. NA-F uses the Tx parameters of the active PON port
in a protection group. All board-related parameters are relayed to the active PON port.
OTDR not supported. PONs in a protection group do not support OTDR measurements.
Deleting. You cannot delete a PON that is in a protection group. Remove the PON from the
protection group and then delete it.
PON BW loss
The PON BW (bandwidth) loss feature helps you determine when a PON channel is being
overused and by how much.
This feature requires the Service Diagnosis & Supervision license option.
see the Operations and Maintenance Guides for the 7432 GPON and ISAM GPON.
Every 15 minutes, the loss is calculated as a percentile of all normalized, discarded bandwidth
per PON channel over the last n days; intervals with no data are ignored. You can configure
the percentile and number of days as explained in “PON Utilization tab ” on page 159. Also,
Issue 10 3JB-00149-AAAA-PCAAA 53
NA-F concepts NA-F User Guide
you can configure various maximum loss rate thresholds. NA uses those settings to produce
a BW loss indicator with one of three values to simplify troubleshooting:
■
Where BW loss is presented. NA presents the BW loss information in the following locations:
■ Network Wide tab (PON utilization table in upper-left corner) (See “The NETWORK WIDE
tab” on page 68.)
■ PON tab (Loss column) (See “The PON tab” on page 73.)
■ PON Diagnosis page (PON Utilization tab label indicates BW loss in brackets ( [ ] ) if available;
hover for tooltip) (See “The PON Diagnosis page” on page 75.)
■ PON Utilization tab (also shows reasons for a Fail value) (See “PON Utilization tab” on
page 95.)
■ Optical Link Diagnosis page (after PON ID in brackets ( [ ] ); hover for tooltip) (See “Optical
Link Diagnosis page” on page 105.)
Reasons for a Fail value. NA compares loss rates against thresholds configured in “PON
Utilization tab ” on page 159 to get a Pass, Fail, or Unknown value to simplify troubleshooting,
as mentioned above. When a Fail value results, NA indicates the reason for the value by
indicating which thresholds were crossed in the PON Utilization tab, reached from the PON
Diagnosis page. The possible reasons are given below. Multiple items are separated by
commas.
54 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide NA-F concepts
PON BW margin
The PON BW (bandwidth) margin helps you determine when a PON channel is being underused
and how much margin, or headroom, is left.
Important While you can use the NA data to do preliminary planning, use a separate
application to supervise the actual planning to avoid over-planning.
This feature requires the Service Diagnosis & Supervision license option.
see the Operations and Maintenance Guides for the 7432 GPON and ISAM GPON.
Every interval (15 minutes)—regardless of whether data was received, the free capacity per
PON channel is calculated by taking the difference of the maximum achievable bandwidth and
the normalized forwarded bandwidth. The margin is then a percentile of the free capacity over
the last n days; intervals with no data are ignored. You can configure the percentile and number
of days as explained in “PON Utilization tab ” on page 159. Also, you can configure various
minimum margin rate thresholds. NA uses those settings to produce a BW margin factor, or
margin, to simplify planning. This margin is the smallest of the ratios between the calculated
margin rates and the configured thresholds. For example, consider the following table.
The smallest ratio, and thus the margin, is 0.5. If a threshold is not set, its ratio is not calculated
and not taken into account.
Issue 10 3JB-00149-AAAA-PCAAA 55
NA-F concepts NA-F User Guide
No threshold is crossed.
■ Low
No data is available.
Reasons for a Low value. NA compares margin rates against thresholds configured in
“PON Utilization tab ” on page 159 to get a High, Low, or Unknown value, as mentioned above.
When a Low value results, NA indicates the reason for the value by indicating which thresholds
were crossed in the PON Utilization tab, reached from the PON Diagnosis page. NA also
includes the reason in the data feed and exported data. The reason is a comma-separated
concatenation of the flows that have a ratio less than 1, with the ratio in brackets; the items
are ordered from small to large. The possible reasons are given below.
56 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide NA-F concepts
Overview
NA-F allows third-party alarm dispatchers integration. NA-F processes the NEWONT, PONLOS,
and INACT alarms from the third-party alarm dispatchers; also, it synchronizes alarms after a
connection break between the systems. Both new and clear alarm notifications for NEWONT,
PONLOS, and INACT alarms can be sent by the third-party to the NA-F alarm notification.
The NA-F alarm synchronization typically happens once daily and each time a multivendor
daemon is started. It makes the NA-F alarm DB inline with the third-party open alarms.
During synchronization, open alarms from the third-party not existing yet in the NA-F DB are
created, and open alarms in the NA-F DB not received during synch from the third-party are
cleared.
Synchronization only handles PONLOS and NEWONT alarms. An ONT INACT alarm triggers
a real-time data collection; the diagnosis is based on the collected data not on the alarm.
Hence, no synchronization is needed. If the alarm is missed, another diagnosis is performed
after hourly data collection.
Per third party, a separate MV daemon is configured using cluster-ini-spec.xml with the
daemon name. The daemons can be started/stopped as described in the NA-F Installation
Guide (ipm-server start/restart/stop daemon). Detailed logging for the specific daemon is
reported at the command prompt and in the ipm-server.log file if the service has problems in
Issue 10 3JB-00149-AAAA-PCAAA 57
NA-F concepts NA-F User Guide
starting. When starting the daemon is successful, a log directory and a file are created with
the service as name.
Example
alcatel-alarm-bridge-oad93x is the alcatel mvd alarm bridge service and the logging is in the
log directory /var/opt/na/log/alcatel-alarm-bridge-oad93x.
For more information about OAD configuration, see “Optional - Configuration of OSS Alarm
Dispatcher (OAD)” in NA-F Installation Guide.
For more information about how to integrate and configure the MV daemons, contact ALU
support.
Alarm synchronization
PONLOS is directly used to detect feeder cable faults: This alarm is processed during
synchronization.
NEWONT is directly used to report discovered ONTs: This alarm is processed during
synchronization.
As a result, after synchronization, feeder cable faults might get cleared or opened, depending
on the PONLOS clear and open alarms coming from synchronization. Feeder cable diagnosis
tests the fault criteria based on the alarm DB that is now synchronized with the new PONLOS
open and clear alarms.
During synchronization, NA-F continues listening to the alarm notifications. NA-F and alarm
dispatcher connect at startup, the synchronization is performed at that time. After the alarm
dispatcher has been temporarily down, NA-F reconnects and synchronizes automatically.
Synchronization is also done once daily, even when no restart happened.
58 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide NA-F concepts
3. The OSS retrieves the current optical signal quality of the PON from NA-F and issues a
work order.
4. The field technician assigned the work order completes the fiber cross-connect, drop
installation, and ONT installation.
5. After the ONT installation, the field technician can use NA-F to check if the ONT is connected
to the correct PON.
6. NA-F measures and revalidates the optical signal quality of each existing subscriber in the
PON to confirm that no existing subscribers on the PON were affected.
7. NA-F measures and validates the optical signal integrity for the new ONT installation:
a. NA-F qualifies the performance of the new ONT by performing a power validation and
comparing it to the expected value derived from the reference measurement from the
neighboring links in the PON.
b. NA-F notifies the field technician of the results (success or failure) of the validation.
1. A new fiber fault in the collector cable interrupts the optical signal for four subscribers.
2. One of these subscribers attempts to watch live IPTV, notices that the service is not available,
and calls the help desk to report a problem.
Issue 10 3JB-00149-AAAA-PCAAA 59
NA-F concepts NA-F User Guide
3. The automated voice flow identifies the customer and retrieves from the NA-F northbound
interface the historical link quality originating from the access network (physical or Ethernet).
4. NA-F indicates that the link is currently impacted by a fiber fault and that the fault impacts
three additional subscribers.
5. The automated voice flow compares the time at which the fault was introduced to a record
of digging activities, but finds no correlated activity.
6. The automated voice flow opens a trouble ticket for the subscriber and also opens three
additional trouble tickets for each of the other affected subscribers.
7. The automated voice flow creates a work order that includes the following information:
a. The fiber section location and time the fault began to affect the fiber.
b. For each link, the reference power validation and the recent signal level statistics, including
the last time the signal level was not impacted.
8. When the subscriber finishes the automated voice flow and speaks with a CSR, the CSR
can acknowledge the problem and provide details about the scheduled work order.
9. The technician assigned the work order travels directly to the fiber section with the fault,
repairs the fault, and remotely initiates a new PON diagnosis to verify that the link quality
on the related links has been cleared, as indicated by a signal value higher than the reference
power validation.
60 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide NA-F concepts
Use the buttons along the bottom of the window to manipulate the tag:
Icon Function
Close the dialog.
Page through the list of tags for this object, one tag at a time.
Jump to the first or last tag in the list for this object.
For more information about the PON topology tree, see “Topology (classic) tab, Topology
(compact) tab, and Topology tab” on page 79.
Issue 10 3JB-00149-AAAA-PCAAA 61
NA-F concepts NA-F User Guide
62 3JB-00149-AAAA-PCAAA Issue 10
This chapter covers:
■
■
■
■
■
■
■
Overview
The NETWORK WIDE tab
The PON tab
The OPTICAL LINK tab
The FEEDER CABLE tab
The FAULT tab
The ALARM tab
2
The NA-F user interface
Issue 10 3JB-00149-AAAA-PCAAA 63
NA-F User Guide The NA-F user interface
Overview
For information about how to access the NA-F graphical user interface, see “Logging in to the
NA-SBI and NA-F GUIs” on page 164.
The Network Analyzer-Fiber user interface has NETWORK WIDE, PON, and OPTICAL LINK
tabs that provide high-level views into the network and a means to drill down to the Optical
Service Diagnosis and PON Diagnosis pages.
Getting help. Release 9.0 introduced a Help button ( ). Click this button from any page to
open the corresponding description of the page in the Online User Guide or, if there is no
specific information for the page, the section the page belongs to.
Note
Depending on the browser settings, warnings might be issued about pop-up
windows. The NA-F Online Help displays in a pop-up window, which may have
to be allowed in the way appropriate with the browser. In case a pop-up window
cannot be used, many browsers open a new tab called User Guide and display
the documentation of the page where the Help button was clicked.
NA-F header
The Search box in the header provides another way to access the Optical Link Diagnosis and
PON Diagnosis pages.
■ Search field: Enter an OLT address and press ENTER to launch an Optical Link Diagnosis
for an optical link, or enter a PON ID to go directly to the PON Diagnosis page.
Note: Entering a feeder cable name in the Search field opens the FEEDER CABLE tab, not
a Diagnosis page.
64 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide The NA-F user interface
In this list, click the numbers of optical links for each category to open the Optical Link
tab and show a list of the optical links filtered according to their link quality.
❐ A list of Most impacting faults that provides the number of subscribers affected by each
fault
In this list, click the equipment name in the Fault location column to drill down to the
Optical Link Diagnosis page for a given fault.
❐ A Link Quality Evolution graph that shows the changes over time to link quality
❐ A Faults per hour graph that gives an overview of how many faults were detected during
the last 48 hours
■ “The PON tab” on page 73: This tab provides the PON overview list, a list of PONs that
can be filtered by PON name, by feeder cable name, or by PON address. This list indicates
the total number of optical links on each PON. Select a PON and click Show to open the
PON Diagnosis page.
❐ “The PON Diagnosis page” on page 75: The PON Diagnosis page provides four views
into the state of optical links connected to a single PON, showing:
● Optical links by link quality
● A list of detected faults
● A graphical view of the PON Topology tree
● A view displaying the OTDR diagnosis data
● An History tab showing the evolution of link quality by optical link over time
● A view displaying the PON Utilization
● If GIS management is enabled, a Map tab locating the faults on a geographical map
Issue 10 3JB-00149-AAAA-PCAAA 65
The NA-F user interface NA-F User Guide
■ “The OPTICAL LINK tab” on page 99: This tab provides a list of optical links that you can
sort by column heading and filter using the selectors on top of the page. The filters can be
saved and shared. This table provides information about each link, including its link quality,
status, power validation status, PON branch ID, ONT address, ONT serial number, and
SLID. For each link, you can also navigate to the Optical Link Diagnosis page or to the
PON Diagnosis page.
❐ To open the Optical Link Diagnosis page, select an optical link in the list, and then click
Go to Optical Link.
“Optical Link Diagnosis page” on page 105: The Optical Link Diagnosis page provides
detailed information about a given optical link, its properties, active faults, current and
historical link quality, and tags associated with any portion of the link. From this page, you
can also start a real-time data collection, a power validation, and a service diagnosis; also,
you can start/stop a real-time monitoring (default: one day).
❐ To open the PON Diagnosis page, select an optical link in the list, and then click Go to
PON. See above “The PON Diagnosis page” on page 75.
■ “The FEEDER CABLE tab” on page 122: This tab provides the list of feeder cables provided
with a topology import. From there, you can display an overview of PONs for a given feeder
cable, and then open each PON in its own PON Diagnosis view.
■ “The FAULT tab” on page 123: This tab provides the list of all faults persisted in the database.
Use filters to select any subset of faults that are of interest in a given situation. The filters
can be saved and shared. The PON Diagnosis page or Optical Link Diagnosis can be reached
for any particular equipment listed. The list can be instantly exported to a CSV or Excel file
to open with an appropriate external application. The Resolve button cleans faults manually.
■ “The ALARM tab” on page 124: This tab provides the list of alarms raised on ALU or third-party
network elements. The PON Diagnosis page or Optical Link Diagnosis page can be reached
for any particular equipment listed, provided the equipment is known in the network topology.
The list can be filtered and exported to a CSV or Excel file to open with an appropriate
external application.
■ “The EXPORT STATISTICS tab” on page 126: From this tab, you can export collected statistics
to a CSV or Excel file on the NA-F host.
■ “The ADMINISTRATION tab” on page 135: This tab provides access to NA-F-specific
administrative features. You perform most administrative tasks, such as user management,
collection management, and so on, through the NA-SBI interface. See Chapter 3,
“Administration” on page 163 for information about administrative tasks performed through
the NA-SBI interface. The Administration tab has these tabs:
66 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide The NA-F user interface
Map of the NA-F GUI shows how the pages in the NA-F graphical user interface are linked
together:
Issue 10 3JB-00149-AAAA-PCAAA 67
The NA-F user interface NA-F User Guide
Note
This map of the NA-F GUI is valid for a user with the 'Administrator' role.
Operator roles cannot access the content of the Administration tab.
68 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide The NA-F user interface
PON utilization
The PON utilization table, which is updated hourly, summarizes the number of channels with
bandwidth loss and low bandwidth margin. For a channels definition, see Terminology notes on
page 29.
Note
The table is only visible if you have the Service Diagnosis & Supervision license
option.
Click the PON count to go to the PON tab with the view filtered for PON channels with loss or
PON channels with low margin.
Issue 10 3JB-00149-AAAA-PCAAA 69
The NA-F user interface NA-F User Guide
For information about these items, see “PON BW loss ” on page 53 and “PON BW margin ” on
page 55.
Link quality
The Link quality table, which is updated hourly, shows the number of affected optical links
sorted by link quality category. Links to the Optical Link tab provide a list of optical links filtered
by that link quality.
Category
The quality of the link. For information about the link quality levels, see “Link quality” on
page 32.
Optical links
The number of optical links with the given link quality. Click the number in this column to
navigate to the Optical Link tab, which provides a list of optical links filtered by that link
quality.
Also, this column shows in parentheses how many of those links, if any, have a link priority
of critical. For example, "10 (1)" indicates 10 links with one of those links being critical. If
there are no critical links, only the total number of links is shown. For more information,
see “Link priority ” on page 32.
70 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide The NA-F user interface
High impact means service interrupting. Low impact is not service interrupting. For example,
admin down and loss of signal are service interrupting; while a fiber bend and connector issues
might interrupt a few ONTs but not all, so they might qualify as both high impact and low impact
depending on the fault location.
For a detailed explanation of the fault types, locations and severities, see “The FAULT tab” on
page 123.
Sev. (Severity)
This column indicates the fault's severity:
Type
This column indicates the type of equipment that contains the fault.
An (R) is shown if the equipment is part of a redundant setup, also known as a protection
group.
Detected
This column shows the time and date when the fault was detected.
Issue 10 3JB-00149-AAAA-PCAAA 71
The NA-F user interface NA-F User Guide
Fault location
The location of the faults in the network.
Degraded #
The number of optical links that have reduced robustness or that are close to interruption
due to problems of this type.
Interrupted #
The number of optical links with service interrupted due to problems of this type.
Also, this column shows in parentheses how many of those links, if any, have a link priority
of critical. For example, "10 (3)" indicates 10 links with three of those links being critical. If
there are no critical links, only the total number of links is shown. For more information,
see “Link priority ” on page 32.
The graph title changes based on the amount of data used to create the graph:
72 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide The NA-F user interface
For sorting and filtering information, see “Sorting and filtering in the PON tab and the ALARM
tab” on page 182.
Click a PON channel in the list and use the Go to PON, Edit, or Delete buttons to operate on
the given PON channel.
The "Paired Feeder Cable ID" and "Paired Address" columns appear only in environments
with protection groups (also known as redundant setups).
Use the CSV or Excel buttons to export data in the corresponding format. For information
about automatic daily exports, see “Auto Data Export Settings group” on page 148.
Issue 10 3JB-00149-AAAA-PCAAA 73
The NA-F user interface NA-F User Guide
With the PON Utilization box at the top of the page (only visible if you have the Service
Diagnosis & Supervision license option), you can limit the list to PON channels with certain
margin and loss traits. For information about these values, see “PON BW margin ” on page 55
and “PON BW loss ” on page 53.
PON ID
The PON ID column displays the PON name as stored in the NA-F database. By default,
this is the same as the PON Address or OLT port address, but you can edit the value using
the Edit button here or in the PON topology tree.
A PON ID is a unique identifier of the PON. Channels map to the parent object PON through
the PON ID. The PON can be GPON-only, TWDM-only, or GPON-TWDM.
Feeder Cable ID
The Feeder Cable ID column displays the name of the feeder cable the PON belongs to.
Address
The Address column displays the TL1 port address of the OLT for the PON.
Paired Address
The Paired Address column displays the TL1 port address of the OLT for the paired PON
in a protection group.
If no TWDM channel pair is present, this column is not shown. For GPONs, this column is
empty.
Optical links
The Optical links column shows the total number of links in the PON. Also, this column
shows in parentheses how many of those links, if any, have a link priority of critical. For
example, "9 (1)" indicates nine links with one of those links being critical. If a PON has no
critical links, only the total number of links is shown.
74 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide The NA-F user interface
Margin
Note
Values are presented only if you have the Service Diagnosis & Supervision
license option. Otherwise, a hashtag is displayed.
The bandwidth margin for the PON channel, which you can use for preliminary capacity
planning. Hover your cursor over the value for an explanation of the value. For information,
see “PON BW margin ” on page 55.
Loss
Note
Values are presented only if you have the Service Diagnosis & Supervision
license option. Otherwise, a hashtag is displayed.
The bandwidth loss indicator for the PON channel, which helps you identify an overused
PON. Hover your cursor over the value for an explanation of the value. For information,
see, “PON BW loss ” on page 53.
Arrow buttons
Use the arrow buttons to browse through a list of PONs longer than one page. The arrow
buttons do not show when the list has only one page.
Button Function
Return to the first page in the list.
Jump back 10 pages in the list or to the first page if you are not already on a
page higher than page 10.
Jump back one page in the list.
Issue 10 3JB-00149-AAAA-PCAAA 75
The NA-F user interface NA-F User Guide
Customer ID
The Customer ID or SLID (Subscriber Location ID) associated with this PON branch.
Branch ID
The PON branch ID.
LQ (Link Quality)
The current link quality for this PON branch. See “Link quality” on page 32.
LP (Link Priority)
The current link priority for the PON branch. See “Link priority ” on page 32.
76 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide The NA-F user interface
Click the down arrow on the left of each row to display a description or a suggested repair
action.
Severity
This column indicates the fault's severity:
Type
A brief description of the type of fault. Click the down arrow on the left to display the
description and, if applicable, repair advice for the fault.
An (R) is shown if the fault is present on a redundant setup, also known as a protection
group.
Detected
The time at which the fault was first detected.
Fault location
The location of the fault. For fiber faults, the location can be:
■ Between the PON port and the first splitter (the feeder)
■ In a fiber section between two splitters (a collector)
■ Between the last splitter and the ONT (Distribution of PON branch ID)
The location value can also be Unknown.
Issue 10 3JB-00149-AAAA-PCAAA 77
The NA-F user interface NA-F User Guide
Degraded #
The number of optical links on this PON that have a degraded service signal due to this
fault.
Also, this column shows in parentheses how many of those links, if any, have a link priority
of critical. For example, "10 (3)" indicates 10 links with three of those links being critical. If
there are no critical links, only the total number of links is shown. For more information,
see “Link priority ” on page 32.
Interrupted #
The number of optical links on this PON with interrupted service due to this fault.
Also, this column shows in parentheses how many of those links, if any, have a link priority
of critical. For example, "10 (3)" indicates 10 links with three of those links being critical. If
there are no critical links, only the total number of links is shown. For more information,
see “Link priority ” on page 32.
Highlight
Click the highlight icon in the Latest Detected Faults list ( ) to highlight probable locations
for this fault in the PON topology tree below.
In the following figure, the location of the fault is highlighted in the PON topology tree.
You can also highlight from the PON topology tree. Click the orange cross in the topology
tree, if present, to highlight the corresponding fault in the fault list.
Note
This is only valid for fiber cuts ( ). It is currently not possible to highlight other
faults from the PON topology tree.
78 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide The NA-F user interface
To remove the highlight that resulted from the first click, click again the highlight icon or
the fault location cross.
These tabs display the PON topology combining information collected from the OLT with
uploaded topology data to create representations of the PON:
■ A graphical representation of the PON that shows the OLT (left) to the splitters (middle) to
the ONT (right).
This representation appears only in the Topology (classic) tab for GPON-only PONs.
■ A table-based representation of the PON.
This representation appears in the Topology (compact) tab for GPON-only PONs and in
the Topology tab for TWDM PONs and for GPON-TWDM PONs
You can use the “Top right list: PON Latest detected faults” on page 77 list to highlight possible
fault locations on the tree.
This figure shows the Topology (classic) representation for a GPON-only PON.
Note
The splitters and ONTs are sorted and listed according to their parent port
number.
PON properties
The PON properties table (on the left) lists information about the PON:
Issue 10 3JB-00149-AAAA-PCAAA 79
The NA-F user interface NA-F User Guide
Field Description
ID An arbitrary name for the PON. By default, this is the TL1 address. Click
the edit icon ( ) to change this value.
Address The TL1 address of the OLT.
Feeder Cable ID The name or reference of the feeder cable for this PON.
Paired Address In a protection group, the TL1 address of the OLT for the paired PON.
In a protection group, this information is for the active PON port. For
more information, see “PON protection” on page 52.
Tx power level Transmit power level.
In a protection group, this information is for the active PON port. For
more information, see “PON protection” on page 52.
SFP S/N The serial number or reference of the OTDR SFP module.
In a protection group, this information is for the active PON port. For
more information, see “PON protection” on page 52.
Tags ( )
In the PON topology tree, tag icons ( ) appear on the PON properties table, fiber sections,
splitter icons, and by each ONT. When you click a tag icon ( ), a window opens so you
can view or edit the notes on the associated object. A tag icon is green ( ) when it contains
one or more notes. You can use these notes to record information such as trouble ticket
numbers, maintenance actions performed or planned, and so on to improve communication
between groups. In an integration scenario, other applications can create such messages
using the NBI. For more information, see the Northbound OSS Interface Developer Guide.
Click the calendar icons ( ) or use the text fields to set the start or end date indicating
the date range to which this message applies.
80 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide The NA-F user interface
Use the buttons along the bottom of the window to manipulate the tag:
Icon Function
Close the dialog.
Page through the list of tags for this object, one tag at a time.
Jump to the first or last tag in the list for this object.
Fiber sections ( )
Grey lines represent the fiber sections that connect OLTs, splitters, and ONTs. Use the
tag icon ( ) to add notes to any fiber section. Click the highlight icon ( ) in the Detected
faults table to see possible locations for each fault rendered over the fiber sections in the
topology tree. The following figure shows a portion of a topology tree with a fault between
the OLT and splitter, at feeder cable level, marked with a red X:
Issue 10 3JB-00149-AAAA-PCAAA 81
The NA-F user interface NA-F User Guide
Note that feeder cable cuts are not shown on the affected PON feeder. The fault is listed
in the top right fault table as a cable with a red cross. There is no corresponding icon in
the PON tree, but the icon is shown in the PON table next to the feeder cable ID.
Splitters
The splitter icon represents an individual splitter and associated data.
1. The total number of number of ONTs ultimately connected to this splitter. See callout
number 1 in the figure.
2. The number of optical links in this splitter by link quality. See callout number 2 in the
figure.
3. The split ratio (number of fiber sections created by this splitter). When you mouse over
the number showing the split ratio (here, 8), a tool tip pops up showing the splitter
82 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide The NA-F user interface
properties. This information is supplied during the topology import. See callout number
3 in the figure.
■ Name: A unique, provider-defined name for the splitter within the NA-F database.
■ Address: The OLT to which this splitter ultimately connects. Discovered during data
collection and supplied during topology import.
■ Parent Port Number: The port number on the parent splitter.
■ Vendor: Name of the vendor of the splitter.
■ Model Name: Name of the splitter model provided by the vendor.
■ S/N: The serial number of the splitter.
■ Split Ratio: The number of fiber sections into which the splitter divides the incoming
fiber section.
ONT list
The ONT list provides information about the ONTs connected to this splitter.
ONT#
The ONT number assigned to this ONT.
ONT ID
The ONT model name discovered during data collection.
Icon
Switched off
Robustness
Interrupted
Degraded
Unknown
Reduced
Description
Good
Issue 10 3JB-00149-AAAA-PCAAA 83
The NA-F user interface NA-F User Guide
Icon
Switched off
Robustness
Interrupted
Degraded
Unknown
Reduced
Description
Good
Note
An intermittent problem on the fiber can produce a link quality of reduced
robustness when there is no corresponding fault detected. This can happen
when the fault detection cannot quantify the type of the fault. Similarly, a
degradation fault might be detected while the link quality is good. In this case,
despite the fault, the subscriber has good service. The operator must consider
both the fault and the link quality to decide whether to take action. In both these
cases, the link quality computation takes precedence over the detected fault
when making a decision. Nevertheless, this behavior is rare and intermittent.
84 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide The NA-F user interface
PV results
Value Icon Description
None No power validation has been performed or is currently being performed
on the optical link.
Issue 10 3JB-00149-AAAA-PCAAA 85
The NA-F user interface NA-F User Guide
PV results (continued)
Value Icon Description
Normal The most recent power validation determined that the optical link's power
level was acceptable. A power validation result is saved as a reference,
consisting of the collected data, a PON branch received power reference,
and the fact that the validation succeeded.
Abnormal The most recent power validation determined that the optical link's power
level was not acceptable. The result, consisting of the collected data, a
PON branch received power reference, and the fact that the validation
failed, is stored.
Not The most recent power validation failed to determine the optical link's
enough power level.
data
PON branch ID
Besides topology import through files, the administrator can use the GUI to define
branch IDs for ONTs and to link ONTs to a specific splitter and splitter port. An Edit
icon appears when moving the mouse over the branch ID. When you click this icon,
the Edit Branch window below opens, allowing you to change the branch ID name
and to select another splitter and splitter port (valid value range: from 1 to 128). Branch
ID and Splitter are mandatory; Splitter Port is optional.
86 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide The NA-F user interface
S/N
The ONT serial number discovered during data collection or defined during topology
import.
SLID
The SLID (Subscriber Location ID) discovered during data collection or defined during
topology import. The value is rendered in ASCII or HEX format depending on the SLID
interpretation mode setting in the OLT.
Custom labels
Up to three custom labels can be added to this table. Use Administration->Display
Label Management->Label Name to change the names of the labels. Only custom
labels that have the Enabled option set in the Display Label Management tab appear
in this table. See “Display Label Management tab” on page 153 for more information.
The following image shows three custom labels: District, Local Area, and Vendor.
PP#
The number of the PON or Splitter Port this ONT is connected to.
Rx Pwr
Received power measurement on the ONT side.
OLT side
Received power measurement on the OLT side.
Tag icon ( )
The tag icon to log notes about this piece of equipment in the NA-F database.
This figure shows the Topology (compact) representation for a GPON-only PON.
Issue 10 3JB-00149-AAAA-PCAAA 87
The NA-F user interface NA-F User Guide
Hover your cursor over the icon in the upper-left corner of the view to show channel details,
as shown below.
For descriptions of the items, see “Topology (classic) tab” on page 79.
Topology tab
Hover your cursor over the icon in the upper-left corner of the view to show channel details,
as shown below.
88 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide The NA-F user interface
Lambda Profile indicates the wavelength used. Aλ and Pλ indicate the actual and preferred
wavelengths, respectively.
For descriptions of the other items, see “Topology (classic) tab” on page 79.
OTDR tab
Note
TWDM networks do not support OTDR measurements.
In all tabs of the PON Diagnosis page, the bottom panel can be maximized, masking the two
top tables.
For both OTDR diagnosis and OTDR link loss, whenever something goes wrong, an appropriate
error message is displayed inside the Start button.
For example, you see an "SFTP: Authentication failed" error message in the following cases:
■ The submitted credentials, either the username or password, are incorrect.
■ NA-F is configured to use key-based authentication, but the node is configured for
password-based authentication.
■ NA-F is configured to use password-based authentication, but the node is configured for
key-based authentication.
The following screenshot shows another error message in the red rectangle.
Issue 10 3JB-00149-AAAA-PCAAA 89
The NA-F user interface NA-F User Guide
OTDR Diagnosis
With Release 8.1, Network Analyzer - Fiber introduced embedded OTDR (Optical Time-Domain
Reflectometry). OTDR diagnosis measures the signal attenuation on a fiber so you can identify
the distance to, or geographical location of, a fiber cut with a 10-meter accuracy. This feature
is in service (traffic is not interrupted), in band (the fault impact is measured on the downstream
traffic frequency), and is embedded (no coupler, no extra ODF, and no extra hardware are
required).
The user has the following options for OTDR diagnosis for the PON:
■ Click Start to create a new reference measurement.
■ Click Start same ref to reuse the reference of a previous validation (only visible if a previous
validation has been done).
■ Save or discard a reference measurement under the OTDR tab.
Note
When you manually save a reference measurement: NA-F saves the previous
hour's data; that manually saved reference is not overwritten when you start a
new diagnosis using either Start or Start same ref; the Reference column
heading shows "Reference (manually saved: discard)." To automatically create
references again, discard the manually saved reference.
The OTDR tab displays the OTDR Measurements table and OTDR Trace graph. The table
shows the available measurements (Current, Long Term, Reference); the graph shows the
OTDR trace over distance, optionally cumulating any of the three available measurements
(Current in green; Long Term in red in the example), and the position of the current events
from the table above (three events in the example).
90 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide The NA-F user interface
OTDR Measurements
Types include:
■ R--
Reflection
■ R-G
Reflection
due to ghost
(< 500m
Issue 10 3JB-00149-AAAA-PCAAA 91
The NA-F user interface NA-F User Guide
Reflection
due to
splitter
Graph legend
Selectors Check-boxes to select the corresponding measurement trace to display in the
graph to the right
Refresh Button to trace again the graph after you have selected a new trace above
Zoom Switch from the original view to views magnified by 2, 4, or 6 (for example, an
original view showing 22 kms shows 11, then 5.5, etc.)
R9.0 introduced the link loss validation feature. It helps validating the NA-F
installation/deployment based on an OTDR measurement. Nokia embedded OTDR SFP is
required for this feature.
The result of the link loss measurement is an accurate estimate of the link loss in both
downstream and upstream. This result must be compared to the design specification to see
whether it falls inline with what is designed. Finally, the result can be saved to an optical link
for future reference.
The SC/UPC end has to be kept open during the measurement. It generates a "fingerprint"
in the OTDR trace that allows you to estimate the link loss up to the point of the open
SC/UPC end.
2. Start an OTDR link loss measurement (clicking the button OTDR Link Loss Start) from
the top of the PON page to which the patch fiber is connected.
92 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide The NA-F user interface
3. This started OTDR measurement is compared with an older OTDR measurement, which
is called the reference measurement. After two to six minutes, the started measurement
completes and the result is shown under the OTDR tab of the respective PON page.
NA-F automatically creates the reference measurement used in step 3 based on OTDR
measurements of the previous hour.
History tab
In all tabs of the PON Diagnosis page, the bottom panel can be maximized, masking the two
top tables.
The History tab shows the link quality of all the optical links, ordered by splitter, in a PON over
time. (Before R9.1.5, this tab was the Link Quality tab.)
Also, if any ONTs support RFoG (radio frequency over glass) and you have selected the Enable
RFoG Views option (“RFoG Settings group ” on page 150), a checkbox appears in the upper-right
corner of the History tab so that you can separately enable the display of link quality and RF
overlay quality history. The RF overlay quality history for a PON is shown immediately after
the PON's link quality history. You can compare:
■ RF overlay quality (RFQ) between ONTs on the same splitter and/or on the same PON to
identify anomalies over time that affect multiple ONTs
Issue 10 3JB-00149-AAAA-PCAAA 93
The NA-F user interface NA-F User Guide
■ RF overlay quality with the link quality (LQ) between ONTs on the same splitter to identify
anomalies over time that affect both GPON and RF overlay signals and multiple ONTs
Note
The red circles do not apply to RF optical signal level line graphs.
❐
Click the Close button ( ) to close a signal level line graph.
■ The darkness of the colors in the contour chart indicate the signal level for that period. The
legend maps colors to signal levels. Here are examples and the legend.
Note
The darkness does not apply to the RFQ contour chart.
94 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide The NA-F user interface
The Switched off and Reduced robustness categories do not apply to RFQ history. Also,
the Signal Values along the bottom do not apply to RFQ history.
You can widen or narrow the gradient range in the legend using the settings described in
“PON history group” on page 152.
Issue 10 3JB-00149-AAAA-PCAAA 95
The NA-F user interface NA-F User Guide
This feature is under control of the Service Diagnosis & Supervision option of the license key;
it works within the constraints of the Optical Diagnosis & Supervision license (with respect to
the number of equipments).
Note
This utilization data requires that the underlying statistics are available, meaning
that the OLTs are configured to produce the data and that OLTs have the
appropriate software, such as ISAM 5.2 or later or FGU 4.10 or later, installed.
■ Channel bandwidth utilization: The graphs show the consumption by all subscribers on a
particular channel.
In the Select Channel drop-down, a coupled GPON-TWDM network shows up with two channel
addresses.
Several traffic counters are collected every 15 min and displayed in graphs.
For information about how to start the collection of the needed 15-min counters on ALU nodes,
see the Installation Guide topic "Initial startup and configuration" and its "If your NA-F license
includes a Service Diagnosis license, start the 15-minute background collection" step.
Note
NA-F R9.1.5 introduced the naf.ngsdc.enable.pon.utilization property to
control whether the latest node-supported PON utilization data is collected when
using ISAM 5.2 and later or FGU 4.10 and later. Contact your Nokia technical
support representative for assistance in changing this property.
The tab label includes a BW Loss indicator in square brackets ( [ ] ). When you open the tab,
a Loss Indicator appears in the upper-right corner of the tab to present the same information.
When the value is Fail though, reasons for the value are also given. For more information
about this indicator, see “PON BW loss ” on page 53. A Margin Factor also appears in the
upper-right corner. When the value is Low, reasons for the value are given. For more
information, see “PON BW margin ” on page 55.
The following graphs are generated, depending on the availability of the counters:
■ On the PON Diagnosis page, you get a forwarded bandwidth graph and a discarded
bandwidth graph in the PON Utilization tab by selecting one of the following tabs:
❐ Total DS bandwidth
❐ Unicast DS bandwidth
96 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide The NA-F user interface
Also includes a Top 5 ONT table and options to show the bandwidth for those ONTs on
the forwarded/discarded bandwidth graphs.
❐ Multicast DS bandwidth
❐ Total US bandwidth
Also includes a Top 5 ONT table and options to show the bandwidth for those ONTs on
the forwarded/discarded bandwidth graphs.
Note
The Top 5 ONT tables can show a value of up to 2100 in the Occurrences
column. However, the Average Bandwidth calculation is made using at most
2016 data points (12 data points/hour * 24 hours * 7 days = 2016).
This bandwidth is the maximum possible bandwidth for each of the traffic counters (Total
DS, Unicast DS, Multicast DS, and Total US). The maximum possible value of Total DS,
Unicast DS, and Total US is fixed and is dependent on the PON technology. The maximum
value of Multicast DS is configurable and is the value configured in the QOS CAC profile
of the PON.
■ On the Optical Link Diagnosis page, you get graphs per interface in the Service Diagnosis
tab. See “Service Diagnosis tab” on page 120.
Limitations
This feature is only supported for nodes for which the needed counters can be retrieved by
NA-F.
■ ISAM versions
❐ With ISAM version earlier than (<) R5.2 AND NA-SBI collector configured: ALU 73xx
FD/FX platforms only provide the unicast counters, so no graphs on multicast traffic are
generated.
❐ With ISAM version later than or at (>=) R5.2 AND configured on OLT AND NA-SBI collector
configured: Graphs are generated.
❐ With ISAM version later than or at (>=) R5.2 AND configured on OLT AND SDC 9.4+ is
configured: Graphs are generated.
Issue 10 3JB-00149-AAAA-PCAAA 97
The NA-F user interface NA-F User Guide
NA-F is prepared to show unicast and multicast counters for multivendor nodes that provide
all the needed counters.
Data archiving
NA-F creates a zip archive of previous day traffic counter files on a daily basis. These files are
kept for 10 days by default and deleted later. For more information, see “Archive files” on
page 169.
Map tab
In all tabs of the PON Diagnosis page, the bottom panel can be maximized, masking the two
top tables.
The Map tab can display the physical location of PON elements and faults on a geographical
map. NA-F needs integration with an external GIS (Geographical Information System) system
to display the map: The operator or Customer Projects must provide a callback script. The GIS
system has knowledge about the topology via operator and listens for fault notifications from
NA-F.
98 3JB-00149-AAAA-PCAAA Issue 10
NA-F User Guide The NA-F user interface
❐ No notification is sent for faults detected through live collection. These faults cannot be
shown by the external GIS system.
❐ After highlighting faults, the map must be refreshed. To refresh, click the Map tab again.
The link opens the GIS map in another browser window or tab,
depending on the browser settings.
To open a pop-up window that shows the callback URL that was called and the URL that
the script returned, click the icon on the map's upper-right corner. The parameters are
listed in a table. If live faults were selected, the total number of live faults is listed with a
warning that those cannot be shown. This information is useful to mention to support when
something goes wrong.
When selecting a fault, a Go to map button becomes visible. It brings you to this PON page's
Map tab.
Issue 10 3JB-00149-AAAA-PCAAA 99
The NA-F user interface NA-F User Guide
■ To open the PON Diagnosis view, select an optical link in the list and click Go to PON.
For more information about sorting, filtering, and searching the list, see “Sorting and filtering
in the OPTICAL LINK tab and the FAULT tab” on page 183.
Filters management. On both the Optical Link tab and the Fault tab, the Manage filters
area on the upper-right allows you to define, save, share, update, and delete filters.
Note
The screen captures below were made in the Fault tab. The behavior of this
feature is the same on both Optical Link and Fault tabs.
The filter is applied immediately at every change. The "My filters" that are shared are now
displayed with [shared] after their names. "Shared Filters" displays the filters that have been
saved and shared (if any) by other users, with [user login] after the names.
After system installation, no filters are present: The My Filters link and the Shared Filters link
are empty.
3. Click Submit.
In the Manage Filters area, the My Filters link is now followed by a ">" to indicate the
presence of at least one saved filter.
5. The Manage Filters area now shows the currently applied filter and the available actions
on this filter: Update filter (to change the selection and the name or share it), Delete filter.
Using the text filter fields to limit the list. With the text filter fields in the header line, you
can limit the list by typing in any field a search criterion with an asterisk (*) as a wildcard
anywhere in the expression—except for ONT address, as explained in “Sorting and filtering in
the PON tab and the ALARM tab” on page 182.
Type your search criterion in the filter you want, and then press Return to refresh the list. To
get the full list back, clear the search criterion and hit Return again.
The results list can be sorted using the arrows next to the column title.
The following figure shows the first page of the full list.
The next figure shows the list limited to the optical links that have an address that starts with
"RB4".
Note
Due to SQL injection protection, some characters or character combinations
are not allowed in these filters. However, this does not mean that the column
filtered cannot contain such characters or character combinations. Some filtering
might not work as expected because of this. When a filter with such character
combinations is used on top of the page, it is replaced with what is allowed.
This is a way to detect whether you have broken certain SQL injection rules in
the filter.
LQ (Link Quality)
The current link quality for the optical link. See “Link quality” on page 32.
LS (Link Status)
The current status of the ONT. See “ONT Status Indicators Table” on page 84.
PV (Power validation)
This column indicates the state of the current power validation.
The possible results for an optical link's power validation are as follows. For more
information, see “Detailed reasons and repair actions” on page 44.
PV results
Value Icon Description
None No power validation has been performed or is currently being performed
on the optical link.
Normal The most recent power validation determined that the optical link's power
level was acceptable. A power validation result is saved as a reference,
consisting of the collected data, a PON branch received power reference,
and the fact that the validation succeeded.
Abnormal The most recent power validation determined that the optical link's power
level was not acceptable. The result, consisting of the collected data, a
PON branch received power reference, and the fact that the validation
failed, is stored.
Not The most recent power validation failed to determine the optical link's
enough power level.
data
LP (Link Priority)
The current link priority for the optical link. See “Critical links versus regular links” on
page 25.
Mon
This column shows the status of the monitoring action on the optical links for which this
action has been launched using the Start Monitoring button (or the Real-Time Monitoring
Start link in the top toolbar of the Optical Link Diagnosis page). The indicator shows the
date when the monitoring completed (1) or the currently completed percentage (2). If no
indicator is present, no monitoring action has ever been launched on this optical link.
By default, a maximum of 10 real-time monitoring actions can run concurrently. See “System
Settings group” on page 145, Maximum number of concurrent real-time monitorings.
Branch ID
The PON branch ID supplied during topology import. The filter accepts an asterisk (*)
anywhere as a wildcard character.
PON ID
The PON ID supplied during topology import. The filter accepts an asterisk (*) anywhere
as a wildcard character.
Custom labels (District, Local Area, and Vendor in this case) appear between the SLID
and ONT ID columns. Define custom labels as explained in “Display Label Management
tab” on page 153. You can filter only on custom labels that are imported by file; custom
labels that use the callback mechanism do not support sorting or filtering.
Click the Go to Optical Link button to open the “Optical Link Diagnosis page” on page 105.
Click the Go to PON button to show the PON Diagnosis page for the currently selected
Optical Link.
Click the Start Monitoring button to start a monitoring on the selected optical link. (This
button is not present for TWDM ONTs.)
Arrow buttons
Use the arrow buttons to browse through a list longer than one page. The arrows buttons
do not show when the list has only one page.
Button Function
Return to the first page in the list.
Jump back 10 pages in the list or to the first page if you are not already on a
page higher than page 10.
Jump back one page in the list.
In the table header, the value in parentheses is the PON branch ID.
Actual Channel
For ONTs of type TWDM. The actual channel (pair) that the ONT is using. This value
matches the preferred channel (pair) when the preferred channel is available.
Channel
For ONTs of type GPON. The optical link's port on the LT board.
Custom labels
Up to three custom labels can be added to this table. Use Administration->Display Label
Management->Label Name to change the names of the labels. Only custom labels that
have the Enabled option set in the Display Label Management tab appear in Optical
link details table. See “Display Label Management tab” on page 153 for more information.
The following image shows three custom labels: District, Local Area, and Vendor.
Distance to OLT
Distance in kilometers determined during ranging.
Feeder Cable ID
The name of the feeder cable this ONT is connected to.
Link Priority
The current “Link priority ” on page 32 for this optical link.
Link Status
The current “Link status” on page 30 for this optical link.
Loss Indicator
A value of Pass, Fail, or Unknown—as explained in “PON BW loss ” on page 53.
ONT Address
The address of the ONT for this optical link.
ONT ID
The ONT model name discovered during data collection.
ONT S/N
The serial number of the ONT.
ONT SLID
The Customer ID or SLID (Subscriber Location ID) associated with this PON branch. The
value is rendered in ASCII or HEX format depending on the SLID interpretation mode
setting in the OLT.
ONT Type
The type of the ONT: GPON or TWDM.
PON ID
A user-editable name of the PON stored only in the NA-F database. Click the PON ID to
navigate to the PON Diagnosis page for that PON. You can edit the name from the PON
topology tree.
If bandwidth information is collected and you have the Service Diagnosis & Supervision
license option, square brackets ( [ ] ) and a BW Loss indicator for the PON appear. For
information, see “PON BW loss ” on page 53. Click the indicator to see the PON utilization
tab for the PON.
Preferred Channel
For ONTs of type TWDM. The preferred channel (pair) that the ONT is configured to use.
The ONT uses the preferred channel when available. When the preferred channel is not
available, the Actual Channel value indicates the channel that the ONT is using.
RF Overlay
The RF Overlay status for this optical link.
Note
This item appears only when you select the Enable RFoG Views option in
“RFoG Settings group ” on page 150.
Speed
For GPON, 2.5/1.25 Gbps. For TWDM, the same value as is shown in the PON tab.
Faults history
The Faults history list shows the active faults discovered through the latest collection and the
faults collected by the hourly troubleshooting collection. The latest faults, with the exception
of the ONT UNI diagnostic faults, are persisted in the database. For more information, see
“Fault detection and localization” on page 50.
2. The fault type icon (See “Faults: types and states” on page 46.)
Click this button to remove a fault from NA-F manually. For more information about clearing
faults, see “Fault detection and localization” on page 50.
Rogue ONT. When an ONT on the PON exhibits one or more of the following behaviors, it
is considered a “rogue” ONT. Rogue ONTs, due to the malfunction, disrupt other ONTs on the
same PON.
■ ONT laser continuously sends light into the fiber, rendering the PON unusable.
■ Two ONTs with the same serial number prevent correct ranging of both ONTs.
■ ONT misinterprets the bandwidth map, causing the ONT to transmit for the wrong time slot
allocation, disrupting the PON for another ONT that is trying to use its correctly allocated
time slot.
■ ONT signal is outside its timing window, affecting the start of another ONT time slot.
■ ONT signal is too low or too high, causing bit rate errors or a ranging failure.
Alien ONT. A non-GPON ONT on the PON is considered an alien ONT when it exhibits all
of the following conditions:
■ Sends continuous laser light into the fiber
■ Has the same operating wavelength with GPON ONTs that is 1260nm to 1360nm in the
upstream direction
■ Does not have service impact or BER to the PON, except for the impact to ranging of other
GPON ONTs
These conditions may have an effect on other GPON ONTs using the same PON. An alien
ONT indicates that the ONT or SFP module does not follow the GPON protocol. Therefore,
alien ONTs can disrupt the ranging process of other ONTs on the same PON.
To detect rogue ONTs or alien ONTs, run diagnostic tests on the OLT. When the OLT detects
a rogue ONT, NA-F creates an "ONT disabled" fault. When the OLT detects alien ONTs on a
channel, NA-F creates an "OLT port alien ONT" fault.
History tab
Notes
The Notes list provides a list of operator's messages manually added to components of the
optical infrastructure for this optical link. See “Tagging the optical infrastructure with notes” on
page 60 for information about those notes.
Notes list
History chart
The History chart provides a historical view of the link quality to this optical link.
Also, if any ONTs support RFoG (radio frequency over glass) and you have selected the Enable
RFoG Views option (“RFoG Settings group ” on page 150), the chart provides RF overlay quality
(RFQ) history. This RFQ history is shown immediately after the PON's link quality (LQ) history.
You can compare the RFQ history with the LQ history of an optical link to identify anomalies
over time that affect both the GPON and RF overlay signals.
Use the 3 days and 10 days buttons to change the number of days of data to focus on using
the slider. Use the slider to specify which days to show. This data is not aggregated.
History chart
In the legend, the Switched off and Reduced robustness categories do not apply to RFQ
history.
For the long-term data, the information is aggregated in the following, priority order by default:
■ INTERRUPTED (highest priority)
■ DEGRADED
■ REDUCED_ROBUSTNESS
■ GOOD
■ SWITCHED_OFF
■ UNKNOWN
For information about configuring this order, see “Link Quality priority order for long-term
aggregation group ” on page 152.
So in the long-term data, in a given day, the link quality with the highest priority is the quality
reported for that day. Here are some examples:
■ Consider a day in which the link quality was at times UNKNOWN, INTERRUPTED, or
SWITCHED_OFF. In the aggregation for this day, the quality is INTERRUPTED.
■ Consider another day in which the link quality was at times SWITCHED_OFF, GOOD, or
INTERRUPTED. In this case, the aggregation is INTERRUPTED.
Select the type of chart to show. See “Chart types” on page 115 for a description of each
icon.
The minimum, maximum, average, and latest measurement in the unit of the selected chart
(dBm, µA, °C, V, etc.) at both ends of the link. (RR is reduced robustness.) When no data
is available, a dash (-) character appears.
Use the 3 days and 10 days buttons to change the number of days of data shown in the
chart ( ). Drag the slider ( ) in place, or click the timeline to move it to the start of the
days to show in the chart.
A graph showing the measurement for the time window specified by the slider ( ) and the
type of graph selected ( ).
Chart types
Icon Description
Click this icon to show all the charts and data for all categories:
● Bit error counter (ONT and OLT) (bit errors/hour)
● Transceiver bias current (ONT and OLT) (microA)
● Optical signal level (ONT and OLT) (dBm)
● Transceiver temperature (ONT and OLT) (Celsius degree)
● Transceiver voltage (ONT and OLT) (uV)
The Bec per Hour chart and data show the bit error counter (BEC) data for the optical
link.
Vertical dotted lines on the signal line indicate that a fault was detected. Colored
backgrounds indicate a degraded signal (translucent red background, shown), an
interrupted signal (dark red), or switched off (black).
To start a PV, click the Start link ( ) in the Current PV button below the main menu bar.
In the Power Validation tab, the Current result table shows the result for the most recent
Power Validation.
Beneath that, the History table shows the results for the latest Power Validations ( ). Select
a result line in the History table ( ) to display the corresponding values in the table to the
right ( ). When a result line has automatic as the user, the reason the PV was triggered is
shown in square brackets ([, ]).
Planned PV information appears above the History table ( ). This information can include
links to additional information. For example, if the trigger reason mentions one ONT, the
information has a link to the Optical Link Details page; if the trigger reason mentions several
ONTs, the information has a link to the list of optical links.
In case there is not enough data, the view shows the message "Not enough data" with advice
or a reason (for example: ONT not linked to topology - No Data to perform PV), and "#" for
Measured Signal.
Note
The Theoretical Value (if any) is provided at the Import Topology stage and is
used for comparison with the Measured Signal. For more information, see
“Topology Replication tab” on page 137.
For general information about the Power Validation process, see “Power validation” on page 41.
Note
This tab is not available for ONTs of type TWDM.
By default, a maximum of 10 real-time monitoring actions can run concurrently. See “System
Settings group” on page 145, Maximum number of concurrent real-time monitorings.
Each line in the list provides links to a CSV file and Excel file that has the inspection data.
Note
The real-time monitoring can be scheduled for an NE that is not configured in
NA-SBI. These are two separate tasks, which do not interact.
1. An NA-F user can first schedule real-time monitoring on an NE and only later
configure that NE in NA-SBI. The real-time monitoring starts producing files as
soon as the NE is configured.
When real-time monitoring is scheduled, the icon next to the action button starts
spinning.
This does not mean that real-time monitoring is ongoing, but that it is scheduled
and that it produces files regularly if the NE is configured.
Whether the NE is not configured can always be observed when the most-left
action button reads as shown below:
This tells you no files for real-time monitoring are being produced even though
the real-time monitoring icon is the spinning wheel.
This collection starts automatically when you perform any of the following actions:
■ Select an optical link on the Optical Link tab and click Go to Optical Link to view the details
for the optical link
■ Do a Quick Search using the box in the upper-right corner
■ Use URL-encoded navigation
You can also manually start the Service Diagnosis (Start link in the top toolbar on the details
page).
Launching a Service Diagnosis discovers the interfaces and services configured on an ONT
and displays bandwidth graphs and tables for that ONT.
Note
Starting with NA-F R9.1.5, the service diagnosis graphs are at the ONT level
instead of the interface level.
The bandwidth data displayed in the graphs are historical, the result of the background collection
that happens every 15 minutes. The tick size in the graphs is 5 minutes. In addition, tables
that show the list of bandwidth profiles used on the node are shown if available (for ALU nodes,
this is available only on 7342).
The Interfaces and Services tree shows the ONT UNI card information (type and interface
number) and Ethernet interface information (carrier status; actual speed and duplex mode;
configured speed and duplex mode in parentheses; QoS session profile and bandwidth profile
names for unicast and for VLan services).
The Today volume data displayed in the tree is the accumulated bandwidth measured from
12:00AM on the current day.
The Current bandwidth data displayed in the tree is the bandwidth measured during the
discovery of the interfaces with one 5-second interval (Current bandwidth, forwarded traffic
1
only).
The Discarded bandwidth data displayed in the tree is the current ratio of discarded traffic /
(forwarded/discarded) measured during the discovery of the interfaces with one 5-second
interval and expressed in %.
You can select the option to include channel bandwidth in the graphs.
1
This can show 0 values if the user is not using the connection at the time the Service Diagnosis is run.
Example
Shows how many ONTs are connected to the same splitter. Here, there are 6 more ONTs
next to the one displayed.
■ Number of collected optical links: 1
Shows how many optical links were collected to derive the location of faults on the ONT. If
there is no fault, this number is 1 because only the displayed ONT is collected. When there
is a fault, it is necessary to collect more ONTs to determine where the fault location is and
then this number grows.
■ Number of optical links used for fault correlation: 7
This value shows how many ONTs were used for fault correlation. The number of collected
and used ONTs can differ because some ONTs are ignored for the fault correlation, like for
instance the ones that are found to be switched off.
This action shows the [Feeder Cable Name] table, which lists the PONs that have their
feeder fibers in this feeder cable. The latest status of each PON is shown. If a PONLOS
occurred on the PON, its detection time is also shown. In this example, the feeder cable,
named FC, has one non-faulty PON.
Feeder Cable
This action displays the PON Diagnosis view for the selected PON.
The figure below identifies the feeder cable and primary splitter of PON1 in the PON
Diagnosis view.
The list provides information about each fault, including its severity, category, type, location,
number of impacted links (regular and critical), status, time of the fault detection, time when
set to pending, and time when resolved.
For each fault, you can use the buttons that appear to navigate to the Diagnosis page of the
Optical Link or PON where the fault has been located, and you can Resolve the fault.
Note
If the fault is located in an optical link, the Go to Optical Link button does not
show. If the fault is resolved already, the Resolve button does not show. These
are intended behaviors.
■ To export data, click the CSV or Excel buttons. (For information about automatic daily
exports, see “Auto Data Export Settings group” on page 148.)
■ To open the Optical Link Diagnosis page, select a fault in the list and click Go to Optical
Link.
■ To open the PON Diagnosis view, select a fault in the list and click Go to PON.
■ To resolve a fault, select a fault in the list and click Resolve.
For more information about sorting, filtering, and searching the list, see “Sorting and filtering
in the OPTICAL LINK tab and the FAULT tab” on page 183.
When to use the Resolve button. When the fault is in Pending state, clicking Resolve
acknowledges the status and changes it to Resolved. If the fault is not yet in Pending state, it
cannot be resolved: The fault must have been cleared (by system operation) before you can
resolve it.
For sorting and filtering information, see “Sorting and filtering in the PON tab and the ALARM
tab” on page 182.
You can export the data (possibly filtered) in the table to a CSV or Excel file by clicking the
CSV or Excel buttons. (For information about automatic daily exports, see “Auto Data Export
Settings group” on page 148.)
The values in the first column Notification ID indicate the source of the alarm: AMS:430603
identifies that the alarm was received from AMS.
The table below describes the columns in the Alarm Overview table.
When you select an alarm in the list, one or both of the following buttons appear, depending
on the alarm:
■ Go to Optical Link
Click this button to open the Optical Link Diagnosis page. (For information about this page,
see “Optical Link Diagnosis page” on page 105.)
■ Go to PON
Click this button to open the PON Diagnosis page. (For information about this page, see
“The PON Diagnosis page” on page 75.)
Note
In some situations, no button appears after you select an alarm. For example,
if a PONLOS alarm is raised for a PON that has not yet been imported in the
network topology, the alarm is shown; however, one cannot go to that PON.
Therefore, the Go to PON button does not appear. The importance of such an
alarm is that the operator can see that the topology should be updated.
Caution NA-F never visualizes any alarms in the Diagnosis pages, only faults. Based on an
alarm, a fault might get created—or not. For example, NEWONT alarms do not
cause a fault to be created; they simply indicate that the ONT is not yet in the
topology. An INACT alarm also does not necessarily lead to a fault: It depends on
what caused the ONT to go inactive. One should not automatically assume a link
between alarms and faults all the time. For more information, see “Fault life cycle” on
page 46.
The Export statistics feature does not export current data: The exported stats are derived from
data collected over the previous day by the hourly background collection. (This time frame is
known as the monitoring period.) For example, if today is 04/08/2015, the data collected during
the previous day means the data collected each hour for each ONT from 00:00:00 03/08/2015
until 23:59:59 03/08/2015.
The exported files contain the data used to populate the charts described in “Charts & Faults
tab” on page 113 and also contains the information in “Optical link details” on page 105. The two
tables below describe the exported data.
Note
For a given set of stats that end with _avg, _max, and _min (for example,
distanceToOlt_avg, distanceToOlt_max, and distanceToOlt_min), the stats are
meaningful only if the _notNullValuesNr stat (for example,
distanceToOlt_notNullValuesNr) is positive. If the _notNullValuesNr is 0 (zero),
the corresponding _avg, _max, and _min stats are also reported as 0—and you
should consider those _avg, _max, and _min stats as invalid values.
For a TWDM ONT, this field is the ontNr: ID of the ONT defining
the Optical Link
subaddressfield4 For a GPON ONT, this field is the portNr: OLT PON port ID
containing the Optical Link (ONT)
3. Select CSV or Excel to set the desired type for the exported files. Note that the files in
Excel format are still suffixed with .csv.
4. To limit the export to a single OLT, select the name of this OLT in the drop-down. If you
leave the field blank, stats for all OLTs are exported.
5. Click Export.
6. When the export completes, you are prompted to download the files. Click the icon to
download the ONT (Optical Link) or OLT (PON) file.
ONTs in the following states appear in the Network-wide view but not in the exported
statistics because they do not have actual data:
● Not provisioned
❐ The exported stats feature does not report ONTs that are not collected by the "NAF 1
Hour" collection.
■ The ranking of an ONT in the exported stats with regard to link quality is selected according
to the following rule: ONTs can go through different rankings of link quality. The ranking in
the exported file is selected, by default, according to the following hierarchy in link quality
states (the top-most is ranked higher):
(For information about configuring this order, see “Link Quality priority order for long-term
aggregation group ” on page 152.)
Based on the order above, if an ONT has been in INTERRUPTED state even for one hour
on a particular day, it is aggregated to INTERRUPTED and exported as Interrupted in the
exported stats. In the Network-wide view, the ranking of the last hour is displayed.
Use the NA-SBI user interface to make configuration changes such as: user management,
node synchronization, and other data collection-related configurations. See Chapter 3,
“Administration” on page 163 for more information.
Information tab
The Information tab provides product version and license information, including the ability to
update the license.
Product information
The product name, vendor URL, and version and build information.
License information
The Host Id, licensed version, and license details for this installation.
OTDR
The total number of licensed OLT ports with OTDR enabled compared to the actual number
of licensed OLT ports with OTDR enabled in the NA-F database; in other words, your
current consumption of licensed links and ports with OTDR enabled.
Integration options
The features that have been licensed for this installation. The list varies according to the
licensed features.
NA-F features
Features Description
Northbound Interface Support for the northbound interface. See the NA-F Northbound
OSS Interface Developer Guide.
Multi-vendor plugin Support Support the plugin for other vendors' material.
LDAP Support for LDAP integration. See “Authenticating users with an
LDAP server (optional)” on page 166 for more information.
Data Feed Support for making NA-F data available to external reporting
applications.
2. Click Administration.
3. Click Information.
6. Click Submit to activate the new license or Cancel to return to the previous screen.
files. For more information about the format and content of the CSV files, see “Creating the
topology files” on page 11.
Also, see the recommendation Topology import best practice in “Topology maintenance
” on page 27.
Important As an alternative to the topology operations through the user interface described
here, NA-F offers a file-based full automated mode, described in “File-based
topology operations” on page 166.
Caution The NA-F system interprets all imported files as UTF-8 encoded files. To upload
files with special (non-ASCII) characters, make sure they are always UTF-8 encoded.
To check the character encoding of a file, you can use the following (Linux)
command:
To convert a file from another character encoding to UTF-8, you can use the following
(Linux) command:
For more information about the format and content of the CSV files, see “Creating the topology
files” on page 11.
Caution The Delete empty splitters option is applicable not only to files being imported at
a particular moment; it also deletes all empty splitters in the system.
2. Click Administration.
a. Click Browse...
b. Locate the desired file on your local system and click OK.
5. Click Synchronize.
6. The Historical topology updates table shows information about the status of the import
and indicates when it is complete.
For information about this table, see “Overview: "Historical topology updates" table” on
page 143.
Note
When decoupling a network, the decoupling should be done in the same topology
update.
2. Click Administration.
a. Click Browse...
b. Locate the desired file on your local system and click OK.
5. Click Update.
6. The Historical topology updates table shows information about the status of the update
and indicates when it is complete.
For information about this table, see “Overview: "Historical topology updates" table” on
page 143.
2. Click Administration.
4. Select the CSV file that has the PON Branch IDs to delete:
a. Click Browse...
b. Locate the desired file on your local system and click OK.
6. The Historical topology updates table shows information about the status of the update
and indicates when it is complete.
For information about this table, see “Overview: "Historical topology updates" table” on
page 143.
2. Click Administration.
a. Click Browse...
b. Locate the desired file on your local system and click OK.
5. Click Update.
6. The Historical topology updates table shows information about the status of the import
and indicates when it is complete.
For information about this table, see “Overview: "Historical topology updates" table” on
page 143.
Note
If you use custom labels, custom labels that have the Enabled option set in the
Display Label Management tab appear in the OntTopologyExport* file
mentioned below. See “Display Label Management tab” on page 153 for more
information.
2. Click Administration.
4. Specify an OLT name to get only the topology for that OLT. Leave the drop-down with no
OLT name selected to include all the OLTs.
Note
Empty export files occur for OLTs that do not have a topology. (This can occur
when NA-F discovers ONTs, but no topology for the ONTs has been imported.
The OLTs appear in the drop-down, even though there is no topology to export,
because NA-F has created a PON for the unlinked OLTs.)
6. The Historical topology updates table shows information about the status of the export
and indicates when it is complete.
For information about this table, see “Overview: "Historical topology updates" table” on
page 143.
When the export is complete, the table contains an entry with a link to download the export.
■ OntTopologyExport_yyyy-MM-dd_HH-mm-ss.csv
■ FeederCableTopologyExport_yyyy-MM-dd_HH-mm-ss.csv
This action runs the import audit together with the import, and reports additional
inconsistencies in the problems file, next to existing warnings and errors.
ID
The ID of the operation. The number increments by one each time you perform an operation,
so the highest number is the most recent operation.
Type
The type of the action: Synchronization, Incremental update, PON Branches delete, Empty
splitters delete, PON IDs rename, Export topology.
Source
The source of the action: GUI (as used in this procedure) or File (see “File-based topology
operations” on page 166).
Status
The status of the operation. A green check mark ( ) indicates success. A red X ( )
indicates failure.
Progress
Indicates the number of lines from the CSV files that are already processed.
Time
Shows the date and time of the operation.
Problems
During topology import, errors do not stop the import process but are written to a file while
the process goes on. At the end of it, the Problems column shows the following information:
■ A download link to the file containing the list and location of all errors that happened
during import.
■ Single errors are still possible. If an invalid input file is provided, the message states that
the whole input file is invalid.
The administrator can run the topology audit for the complete topology or limited to a specific
OLT. The OLT name (optional) field can be populated using the drop-down or left empty. The
report can be generated as a CSV or Excel file. The filename is either OLT_inventory(_
OLTname )_<timestamp> (complete topology) or Optical_link_inventory(_ OLTname
)_<timestamp> (specific OLT).
To generate the report for the complete topology or a specific OLT, click Submit. A new page
opens offering a button to download the generated file.
Warning Detection of such inconsistencies is only possible after a first hourly collection of
the imported topology.
This Topology Audit Report is different from the report obtained after selecting the
Topology Audit Report check-box described in the Topology Replication tab
above, which is provided by the replication mechanism after it has completed.
For more information about the topology audit and for an explanation about the differences
between the two audit reports, see “Topology audit” on page 28
Note
This setting does not apply to the
EXPORT STATISTICS tab.
The two fields allow you to define the maximum time duration for statuses "Waiting for ONT"
( ) (default: 6 hours) and "Waiting long for ONT" ( ) (default: 24 hours).
Number of fraction digits: The number of decimals used when showing the distance, in the
unit defined below: 3.506 km for 3 kilometers 506 meters.
Unit of measurements: The unit used to show the distance between the fault position and the
OLT. Default: km.
Orphaned ONTs are components that belong to the previous topology but are not in the last
one imported. They have to be cleaned up at the end of the import process: This operation
can take an excessively long time. When a topology import with synchronization leaves more
orphans than this limit, the operation fails and reports an error.
Enable or disable automatic daily export of CSV files that match the CSV exports from the
following tabs:
■ PON
■ OPTICAL LINK
■ FAULT
■ ALARM
■ EXPORT STATISTICS
The file from the FAULT tab lists faults that are not pending and not resolved.
The file from the ALARM tab lists alarms that are not cleared.
If you have defined any custom labels, those labels are included in the exports. For more
information about these labels, see “Display Label Management tab” on page 153.
Contact your Alcatel-Lucent technical support representative for assistance in setting the time
when this export occurs and changing the number of days before a purge occurs.
http://<IP_address>/search?q=TEL-NB
You can leave this value empty. If you do leave this value
empty, the callback should return an empty string.
Understanding the difference between Search Callback and Custom Label Search.
With Search Callback, you can search for a given input string (entered in the Quick Search
box in the upper-right corner) on an external location. The Search Callback URL specifies the
location to search. The search callback application returns zero, one, or more matches. Instead
of returning zero matches though, you can return a dedicated value for "No Results" that you
specify in the System Settings. Matches can either be ONT addresses, ONT serial numbers,
or ONT SLIDs. When there is more than one value, a semicolon (;) is the expected separator.
There can only be one type of return value. For example, if the first value of multiple matches
is an SLID, then all the other values are also SLIDs.
With Custom Label Search, you can also search for a given input string (entered in the Quick
Search box in the upper-right corner) on an external location—but only in a database that is
related to the defined custom labels. Matches are only ONT addresses.
For example, using the default settings, the RF Overlay categories are as follows:
■ GOOD (green bullet in UI) if 100 >= signal level >= 25.1 dBµW
■ DEGRADED (orange bullet in UI) if 0 < signal level < 25.1 dBµW
■ INTERRUPTED (red bullet in UI) if signal level = 0 dBµW
■ UNKNOWN (grey bullet in UI) if signal level > 100 dBµW
As described in “History tab” on page 111, in the long-term data, in a given day, the link quality
with the highest priority is the quality reported for that day. That section also provides examples.
Note
If you change the priority order, only new aggregations are affected by the
change. That is, previous aggregations are not affected.
Note
Customers are expected to write
their own clients to listen to this URL
and respond.
Enabled Whether the custom label is enabled for use in the Empty
UI and topology files or prefix URL.
Understanding the difference between Search Callback and Custom Label Search.
With Search Callback, you can search for a given input string (entered in the Quick Search
box in the upper-right corner) on an external location. The Search Callback URL specifies the
location to search. The search callback application returns zero, one, or more matches. Instead
of returning zero matches though, you can return a dedicated value for "No Results" that you
specify in the System Settings. Matches can either be ONT addresses, ONT serial numbers,
or ONT SLIDs. When there is more than one value, a semicolon (;) is the expected separator.
There can only be one type of return value. For example, if the first value of multiple matches
is an SLID, then all the other values are also SLIDs.
With Custom Label Search, you can also search for a given input string (entered in the Quick
Search box in the upper-right corner) on an external location—but only in a database that is
related to the defined custom labels. Matches are only ONT addresses.
Note
The fault notifications are put on the fault notification interface and are not
directly visible in NA-F itself.
NA-F replaces ${PON} by the PON name. If ${faults} is used, NA-F replaces it with 0 to n faults.
If there are no faults, the ampersand symbol at the end of the URL is removed. If there are
faults, the replacement is like this: ...&f1=<id>&f2=<id>&...&fn=<id>.
The script must return the full URL that points to the correct GIS map. The URL is embedded
in the NA-F GUI as it is received.
The script can return an error instead of a URL. The format of the error is: {ERROR}<your
text>. NA-F displays <your text> on the screen instead of the map.
Enabling and disabling reporting. Use the Data Feed tab to enable and disable the data
feeds of Optical Diagnosis & Supervision data and Service Diagnosis & Supervision data. The
options are:
■ Enable data feed of Optical Diagnosis & Supervision data
This option is not available if either the Data Feed license is inactive or the Optical Diagnosis
& Supervision license is inactive.
■ Enable data feed of Service Diagnosis & Supervision data
This option is not available if either the Data Feed license is inactive or the Service Diagnosis
& Supervision license is inactive.
The archive files. For information about the archive files, see “Exporting NA-F data to
external reporting applications” on page 170.
Normalization rules. For each link status, indicate whether the value is applicable or not.
The following figure shows the possible rules.
PON utilization data is used to assess whether more ONTs can be added to a PON. However,
an ONT that is planned (and not yet connected) or is disconnected, for example, does not
consume any capacity. As a result, the PON utilization data should correct for the possibility
that such ONTs would be connected.
Available link
A link is available if, in its current state, it can send or receive traffic. An available link can
be active (connected and sending/receiving traffic) or inactive (switched off, no user traffic).
Do not confuse available with uptime, downtime, or reliability. In this PON utilization/traffic
context, it means able to transport traffic.
Unavailable link
A link is unavailable (or idle) if, in its current state, it cannot send or receive traffic. Such
states include administrative down and disconnected.
Because of differences in operator definitions for these terms, you normalization rules to indicate
whether an item is applicable (normalized), applicable (not normalized), or not applicable.
The Connected link status is always Applicable (Not Normalized) and cannot be changed.
Margin settings. These settings have the indicated defaults and ranges. For information,
see “PON BW margin ” on page 55.
Loss settings. These settings have the indicated defaults and ranges. For information, see
“PON BW loss ” on page 53.
■
■
■
■
■
■
■
Logging in to the NA-SBI and NA-F GUIs
Logging in and changing the UNIX user's password
Starting and stopping services
Updating NA-F server properties
User management
Authenticating users with an LDAP server (optional)
File-based topology operations
3
Administration
Network Analyzer-Fiber relies on NA-SBI for data collection and certain system administration
functionality, such as user management. The sections below describe administration procedures
and interfaces in both NA-F and NA-SBI.
You can connect to the default interface of either NA-SBI or NA-F over http at the URL
http://hostname, which displays one link to NA-F and one to NA-SBI.
You can also enter the desired program directly by adding /sbi or /naf to the URL.
■ NA-SBI. See the procedure “Starting and stopping services” on page 165 for instructions
on about starting NA-SBI. Note the following:
❐ By default, you access the NA-SBI interface over http at the URL: http://hostname/sbi,
but see the section on HTTP and HTTPs in the NA-F Installation Guide.
❐ Log in for the first time using the default administrator user name (admin) and password.
Contact your Nokia support representative for the default password. Nokia recommends
that you change the default administrator password and create new accounts or configure
NA-SBI to use an LDAP server, as discussed in “Authenticating users with an LDAP server
(optional)” on page 166.
■ NA-F. By default, you connect to the NA-F interface over http at the URL:
http://hostname/naf, but see the section on HTTP and HTTPs in the NA-F Installation Guide.
User management for the NA-F server is controlled by NA-SBI. See “User management” on
page 165 for more information.
2. Type the password. Contact your Nokia technical support representative for the default
password.
b. Type:
passwd ↵
User management
Manager users through the NA-SBI GUI. The application is preconfigured with three user
profiles:
● Administrator: Use this profile to create administrative users.
● Operator: Use this profile when creating uses who log in to perform day-to-day operations.
● Northbound: Use this profile to invoke operations through the northbound interface (NBI).
Note
When selecting a profile for a user, be aware that:
■ Users with the Administrator profile can access the Administration tab and
delete/edit PONs; users with the Operator profile cannot.
■ Users with the Northbound profile cannot access the GUI.
where
sbihostis the IP address or fully qualified domain name of an NA-SBI server or the load
balancer.
Note
If you are using https, depending on your browser, one or more security
certificate warnings might appear. Follow the on-screen instructions to accept
the self-signed certificate and continue.
3. Consult the NA-SBI User Guide for information about how to manage users in NA-SBI.
Note
Avoid changing the roles assigned to the preconfigured user profiles.
The zip file name must be unique. After creating the zip file and copying it to the creating
directory, use the following command to append a timestamp to the zip file name and ensure
that the zip file name is unique:
cp /path-to-zip-file/<fileName>.zip <shared_dir>/app/naf/topology/creating/<fileName>⇦
_$(date +"%Y-%m-%d_%H-%M-%S").zip
For details about the topology files naming and format, refer to “Creating the topology files” on
page 11.
1. For topology synchronization or update, the zip file must contain the following files:
■ onts.csv = PON branch CSV file in the GUI
■ splitters.csv = Splitter CSV file in the GUI
■ import.properties = Property file that specifies the topology operation
The format of the import.properties file should be as below. Possible values for the
properties are separated by a "|".
job.source=FILE
job.type=INCREMENTAL_UPDATE|SYNCHRONIZATION
create.audit.report=false|true
2. To delete PON branches, the zip file must contain the following files:
■ branches.csv = PON branch ID CSV file in the GUI
■ import.properties file with the following lines:
job.source=FILE
job.type=PON_BRANCHES_DELETE
Note that no topology audit is executed when deleting PON branches, even if the
create.audit.report property is added and set to true in the import.properties.
3. To delete empty splitters, the zip file should only contain an import.properties file that has
the following lines:
job.source=FILE
job.type=EMPTY_SPLITTERS_DELETE
create.audit.report=false|true
4. To rename PON IDs, the zip file should contain the following files:
■ pon.csv = PON ID CSV file in the GUI
Note that no topology audit is executed when renaming PON IDs, even if the
create.audit.report property is added and set to true in the import.properties file.
If errors occur during the automated execution of the topology operations, a problems file is
available in the failed directory of <shared_dir>/app/naf/topology. This is a zip file named
job-X-syntax-errors.zip, where X is the job ID number. The zip file contains files that list all
warnings and errors.
If the property create.audit.report has been added and set to true in the import.properties
file, the job-X-syntax-errors.zip file also contains the detected topology inconsistencies found
during topology audit (see the equivalent operation through the user interface in “To have NA-F
audit your topology import” on page 143).
Important To start a collection, see “Initial startup and configuration” in NA-F Installation
Guide.
Caution If you have to perform a node upgrade, you MUST stop data collection before
proceeding, and start collection again when the node upgrade has completed.
■ Monitoring collections per node (SDC User Guide)
■ Monitoring collections and protocol statistics (NA-SBI User Guide)
■ Monitoring collections for the system (SDC User Guide)
■ Failure logs
Archive files
By default, NA-F archives the results of the hourly collections for the last 10 days, once a day,
in /shared/app/naf/stats/success on the shared drive.
The path for the shared drive might be different on your system if a non-default configuration
has been used following the instructions in the NA-F Installation Guide, section 2.7 "Setting
up NFS shared directories".
The format of the archive file name is archive-<date>_<time>.zip. The date and time show
when the archive file was created; the file contains the CSV files of the day before (and possibly
CSV files that would have been created on the current day before the process creating the
archive would run).
To clean up, ensure that you only clean up files that are archived. It could happen that a new
CSV file arrives between the time the archive process starts and finishes.
You start and stop collections with the naf-configure-ams-sdc ipm script. For more information,
see “Initial startup and configuration” in NA-F Installation Guide.
Important The naf-configure-ams-sdc script does not stop the 15-minute collection in 5529
SDC 9.4.y if the related AMS is in a cluster setup. Because NA-F cannot
determine whether the AMS is in a cluster setup, the script always displays the
following warning:
Warning: 'Stop' operation will not work on AMS Cluster system. Use AMS ⇦
GUI to stop the collection.
If your AMS is actually in a cluster setup, explicitly stop the collection using the
AMS GUI.
For more information about how to manage statistics collection in 5529 SDC R9.4.y (or later),
see the 5529 SDC Installation and User Guide for R9.4.y (or later). (For the exact SDC version,
see the release notes.)
Archive files. NA-F archives some collections as explained in “Archive files” on page 169.
In any future version (major, minor, maintenance, patches) of NA-F, data feed changes can
occur. Any client consuming the data feed should take into account—upfront—the following
possibilities:
■ Columns might be added (header and values), moved (header and values), removed (header
and values), or null-ified (header is kept; values become null or empty) to any file in the
archive.
■ Obsolete/phased-out files might be removed from the archive.
■ Files might be added to the archive.
■ The order of the parameters in the files is NOT fixed.
■ Not all parameters in the files are always present. You can get more or fewer parameters.
Note
■ Make sure that the directory exists and that the na user has write permissions
for it.
■ The archive files can become very big. Make sure that writing to this directory
will not create performance issues.
Every night at 2 A.M., the directory is purged of files older than 7 days
(default).
To enable/disable the creation of these files, use the Administration > Data Feed tab and its
Enable data feed of Optical Diagnosis & Supervision data option, as explained in “Data
Feed tab” on page 158.
When you enable the Optical Diagnosis & Supervision data feed, NA-F creates an archive file
for every network element at each hourly collection and stores it in the directory mentioned
above.
HourlyData_YYYY-MM_DD-HH-mm-ss_<NE_name>.tar.gz
Example: HourlyData_2015-01-18-09-13-23_GPONOTDR.tar.gz
File Contents
index.properties General parameters like NE information, collection
timestamps, and language setting.
File Contents
■ ONTId
■ ONTSoftwareVersion
■ ONTSerialNumber
■ ONTSubscriberLocationId
■ ONTDistance
■ PONStatsBerDS
■ PONStatsBerUS
■ ONTFecUSInd
■ ONTLaserBiasCurrent
■ ONTPowerFeedVoltage
■ ONTTemperature
■ ONTRxOpticalSignalLevel
■ ONTTxOpticalSignalLevel
■ ONTOLTRxOpticalSignalLevel
■ ONTRfOpticalSignalLevel
■ ActualCP
■ PreferredCP
■ ONTType
■ MTBE
■ custom_label_n, where n is 1, 2, or 3 (Define these labels
as explained in “Display Label Management tab” on
page 153.)
a Parameters collected for the OLT Ports:
PON_oltPorts.csv
■ PONId
■ FeederCableId
■ Address
File Contents
■ ItfAdminStateOLT
■ ItfOperationalStateOLT
■ PONConfigFecDSInd
■ PONOLTLaserBiasCurrent
■ PONOLTVoltage
■ PONOLTTemperature
■ PONOLTTxOpticalSignalLevel
■ SCGAddress
■ Speed
■ LambdaProfile
■ PortProtectionStatus
■ PairedFeederCableId
■ PairedAddress
■ PairedPortProtectionStatus
■ PairedItfAdminStateOLT
■ PairedItfOperationalStateOLT
PON_oltCards.csv Parameters collected for the OLT Cards:
■ Address
■ BoardActualType
■ EqptBoardAdminStatus
■ EqptBoardOperStatus
a The following parameters for each optical link.
PON_opticalLinks.csv
■ Address
■ BranchId
■ LinkQuality
File Contents
■ LinkStatus
■ PowerValidation
■ Topology
■ RfOpticalQuality
■ ONTType
When there are "-" signs within the separate elements, those
are escaped (preceded by a \ character). Example:
ISAM\-138:1\-1\-1\-1-0-ISAM\-13801010101L1-1-ISAM\-⇦
13801010101L101L2-4-ONTISAM\-13801010101L101L2006
in which:
■ PON ID = ISAM-138:1-1-1-1
■ Parent port of the primary splitter = 0
■ Primary Splitter = ISAM-13801010101L1
■ Primary Splitter Port = 1
■ Secondary Splitter = ISAM-13801010101L101L2
■ Secondary Splitter Port = 4
■ PONBranch = ONTISAM-13801010101L101L2006
PON_faults.csv Fault information.
■ FaultId
■ Timestamp
■ Status
■ Category
■ TypeDisplay
File Contents
■ Type
■ Redundancy
■ Severity
■ NumberOfLocations
PON_faultLocations.csv Fault information. Fault locations link to the faults via the
faultId. There can be more locations per fault.
■ FaultId
■ LocationId
File Contents
In this case, LocationId is the fiberBranchID, and
Address is the ont-address.
❐ SPLITTER: Fault on a splitter
To enable/disable the creation of these files, use the Administration > Data Feed tab and its
Enable data feed of Service Diagnosis & Supervision data option, as explained in “Data
Feed tab” on page 158.
When you enable the Service Diagnosis & Supervision data feed, NA-F creates an archive file
for every network element at each quarter-hourly collection and stores it in the directory
mentioned above.
QuarterlyData_YYYY-MM_DD-HH-mm-ss_<NE_name>.tar.gz
Example: QuarterlyData_2015-01-17-17-33-57_GPONOTDR.tar.gz
File Contents
index.properties NE information and NA-F version.
PON_oltPortTrafficStats.csv Note
As of NA-F R9.1.5, the content depends on the compatibility
mode. Contact your Nokia technical support representative
for assistance in changing the mode.
File Contents
The header in the file indicates the units, such as bps, for the upstream
and downstream values.
PON_ontTrafficStats.csv Note
As of NA-F R9.1.5, the content depends on the compatibility
mode. Contact your Nokia technical support representative
for assistance in changing the mode.
File Contents
The header in the file indicates the units, such as bps, for the upstream
and downstream values.
PON_topONTDsTrafficStats. For the top ONTs, a row with the following data:
csv
■ Interval Number
■ Rank
■ ONTAddress
■ Bandwidth
PON_topONTUsTrafficStats. For the top ONTs, a row with the following data:
csv
■ Interval Number
■ Rank
■ ONTAddress
■ Bandwidth
Not all parameters in the files are always present. You can get more or fewer
parameters.
■
■
■
Common sorting and filtering operations
URL-encoded navigation
Tagging the optical infrastructure with notes
4
Common operations
This chapter describes operations that users can execute in many locations in the NA-F user
interface: Filtering and using URL encoded navigation.
The operation Tagging the optical infrastructure with notes is, however, only available in the
PON Topology tree.
Overview
This section describes the sorting and filtering capabilities available with NA-F. They might
differ depending on the tabs considered: While PON and ALARM tabs have a basic, 'key with
wildcard' based filtering, the OPTICAL LINK tab and FAULT tab offer a more sophisticated
system.
Sorting and filtering in the PON tab and the ALARM tab
Sorting. To sort the list by this column in ascending order, click the white diamond next to
the column header. To sort in descending order, click it a second time.
Filtering. To filter the rows to a particular value, enter the value in the text field below the
column header and press ENTER. The filter accepts an asterisk (*) as a wildcard character at
the end of the search key sequence in any searchable field.
Address, Paired Address, and PON Address fields are searchable with these guidelines:
■ You can specify the full address.
■ You can use wildcards with these restrictions:
❐ You must specify a partial or full SNMP agent name (that is, you cannot wildcard the entire
name).
For example, you could specify RB6-FD2* without a rack number to display results such
as RB6-FD2:1-1-3-4-1, RB6-FD2:1-1-3-4-2, RB6-FD2:1-1-3-4-3, and so on. You could
specify RB6-FD2*:1* to display the same results.
❐ You must specify the address separator dash (-) when you use wildcards for rackNr,
subRackNr, slotNr, portNr, or ontNr.
StartTime and ClearTime fields in the ALARM tab are searchable with the following restrictions:
■ They do not support wildcards.
■ You enter either the date only or the full timestamp. For example, with '5/9/14 10:29 AM' as
the timestamp, you can filter using '5/9/14' or '5/9/14 10:29 AM'.
■ The combination of filters on StartTime and ClearTime uses logical AND:
❐ Start time filter (4/16/14): Alarms started on 2014-04-16.
❐ Clear time filter (4/18/14): Alarms cleared on 2014-04-18.
❐ Start time filter (4/16/14) and clear time filter (4/18/14): Alarms started on the 16th AND
cleared on 18th of April.
Sorting and filtering in the OPTICAL LINK tab and the FAULT
tab
Sorting. In both tabs, you can sort the list using the diamond arrows next to the column
titles.
In the OPTICAL LINK tab, the LQ, LS, PV, and LP columns have icons, where each icon has
a name as well. The name is displayed in the filter section at the top of the page. The column
values are sorted in a fixed order instead of alphabetically by name because the names are
configurable.
■ For LQ, the order is: Good, Reduced robustness, Degraded, Interrupted, Switched off,
Unknown.
■ For LS, the order is: Administrative down, Operational down, Waiting for ONT, Waiting long
for ONT, Never connected ONT, Newly imported, Connected, Disconnected, Discovered,
Switched off, Disabled.
■ For PV, the order is: None, Normal, Abnormal, Not enough data.
■ For LP, the order is: Critical, Regular.
Note
No matter what you use as sorting criteria, new ONTs, discovered by alarms
and not yet part of the current topology, are always sorted on top.
In the FAULT tab, the Type and Status column values are sorted in a fixed order instead of
alphabetically by name because the names are configurable.
■ For Type, the order is:
❐ ONT_OPER_DOWN
❐ ONT_ADMIN_DOWN
❐ OLT_PORT_OPER_DOWN
❐ OLT_PORT_ADMIN_DOWN
❐ OLT_CARD_OPER_DOWN
❐ OLT_CARD_ADMIN_DOWN
❐ OLT_PORT_MALFUNCTIONING_TRANSCEIVER
❐ ONT_MALFUNCTIONING_TRANSCEIVER
❐ LOSS_OF_SIGNAL
❐ FIBER_MACRO_BEND
❐ FIBER_MICRO_BEND
❐ FIBER_BEND
❐ DEGRADED_SIGNAL
❐ FIBER_CONNECTOR
❐ FEEDER_CABLE_CUT
❐ ONT_DISABLED
❐ CHANNEL_GROUP_ADMIN_DOWN
❐ SUB_CHANNEL_GROUP_ADMIN_DOWN
❐ OLT_PORT_ALIEN_ONT_DETECTED
❐ PON_BW_LOSS
■ For Status, the order is: Active, Pending, Resolved.
OPTICAL LINK tab: Filtering the Address column. Filter the Address column as explained
in “Sorting and filtering in the PON tab and the ALARM tab” on page 182.
OPTICAL LINK tab: Using the selection zone to limit the list. The selection zone of the
Optical Link tab offers these sets of selectors: Link Status, Link Priority, Link Quality, Power
Validation, and Audit. You can easily check the selectors that match the list you want to receive,
including and excluding optical links depending on their status in any of the selectors' groups.
Checking/unchecking a selector with a label in bold (All Online, etc.) selects/unselects all the
selectors in that group. The list is refreshed on each selection.
Warning The filtering is AND-based between the sets, but OR-based within the sets.
FAULT tab: Using the selection zone to filter the list. The selection zone of the Fault tab
offers these sets of selectors: Status, Link Priority, Redundant, and Type grouping (Operational
faults, Configuration faults, Malfunctioning equipment faults, Degradation faults, Interruption
faults, PON Utilization faults). You can easily check the selectors that match the list you want
to receive, including and excluding faults from any of the selection groups. Checking/unchecking
a selector with a label in bold (All Operational, etc.) selects/unselects all the selectors in that
group.
Warning The filtering is AND-based between the sets, but OR-based within the sets. If nothing
is selected for a certain set, it is assumed that no filtering happens for that particular
set. So selecting all or nothing is basically the same.
Filters management. On both the Optical Link tab and the Fault tab, the Manage filters
area on the upper-right allows you to define, save, share, update, and delete filters.
Note
The screen captures below were made in the Fault tab. The behavior of this
feature is the same on both Optical Link and Fault tabs.
The filter is applied immediately at every change. The "My filters" that are shared are now
displayed with [shared] after their names. "Shared Filters" displays the filters that have been
saved and shared (if any) by other users, with [user login] after the names.
After system installation, no filters are present: The My Filters link and the Shared Filters link
are empty.
3. Click Submit.
In the Manage Filters area, the My Filters link is now followed by a ">" to indicate the
presence of at least one saved filter.
5. The Manage Filters area now shows the currently applied filter and the available actions
on this filter: Update filter (to change the selection and the name or share it), Delete filter.
URL-encoded navigation
The NA-F interface allows you to navigate to individual PONs, ONTs, and feeder cables from
the corresponding tabs available on the main page, as explained in the description of the tabs
in “Overview ” on page 64.
Starting with NA-F R8.1, if you are already logged in to NA-F, you can also directly access
individual pages for PONs, ONTs, and feeder cables using a URL from external systems.
http://your.hostname.com/naf/
/pon/
/opticallink/
/feedercable/
Note
For any given ONT, the addresses of the ONT and of the PON and name of
the feeder cable it belongs to are shown on the “Optical link details” on page 105
of this ONT.
You can now compose a full URL by concatenating the three parts, for example:
■ http://your.hostname.com/naf/opticallink/GPONOTDR:1-1-2-1-10
Using this URL from an external system, you get the Optical Link Diagnosis page for the
specified ONT.
Use the buttons along the bottom of the window to manipulate the tag:
Icon Function
Close the dialog.
Page through the list of tags for this object, one tag at a time.
Jump to the first or last tag in the list for this object.
See “Topology (classic) tab, Topology (compact) tab, and Topology tab” on page 79 for more
information about the PON topology tree.
channel
A wavelength, or lambda, that transports a GPON signal, a TWDM channel pair signal, an
XGS channel pair signal.
channel group
A group that combines different channel pairs (with different wavelengths) onto the optical
network.
channel pair
A dedicated wavelength pair on an LT port.
collector
In an optical link, a fiber section between two splitters.
See also fiber section , distribution , feeder .
connector
A passive element of the PON branch that connects one fiber section to another.
distribution
In an optical link, a fiber section between the last splitter and the ONT (optical network
terminal).
See also fiber section , collector , feeder .
feeder
A fiber section in an optical link between the PON port and the first splitter.
See also fiber section , collector , distribution .
fiber section
A section of fiber cable between two elements in the optical link (that is between splitters,
between OLT and splitter, and so on).
See also distribution , collector , feeder .
NBI
Northbound interface
ONT address
The ONT address is the TL1 address of the port on the network element with the ONT
number appended. For example, SOMEGPON:1-1-1-1-1, where SOMEGPON:1-1-1-1 is
the TL1 port address and the final digit (“-1”) is the ONT number.
optical link
In a PON (passive optical network), the optical transmission channel, including the active
and passive equipment.
passive equipment
Portions of the optical link that do not require an external power source such as the splitters,
connectors, and fiber sections.
All ONTs share the upstream and downstream bandwidth of the ODN. There are several
kinds of PON, such as ATM Passive Optical Network (APON), Broadband Passive Optical
Network (BPON), Ethernet Passive Optical Network (EPON), Gigabit Passive Optical
Network (GPON), and Time- and wavelength-division multiplexed Passive Optical Network
(TWDM NG-PON2).
PON branch
The portion of the optical link that includes only the passive equipment.
PON ID
A unique identifier of the PON. Channels map to the parent object PON through the PON
ID. The PON can be GPON-only, TWDM-only, or GPON-TWDM.
service impact
Service impact classifies the optical link according to its optical performance and the
(potential) impact the performance has on the service. Possible service impact classifications
are: Available, Reduced robustness, Close to interruption, Interrupted, Switched off, and
Unknown.
splitter
A passive element of the PON that branches a single fiber into two or more branches.
subscriber
In industry usage, an individual who pays for Internet access or other services from a
provider.
In Motive™ usage, an end-user who uses Motive software as a result of purchasing services
from a provider.
TL1
Transaction Language 1
F OTDR Tab, 92
failure logs, 168 link priority, 32
(see also failures) link quality, 32
failures relationship to power validation and faults,
clearing for DSLAMs, 168 51
displaying for DSLAMs, 168 Link quality, 70, 76
displaying per DSLAM, 168 Link quality evolution graph, 72
fault detection, 50 link status, 30
fault localization, 50 linking strategy, 19
Fault Notification Filter, 156 localization of faults, 50
faults logging in, 164
relationship to link quality and power loss, 53, 74
validation, 51
Faults history list, 108 M
Faults per hour graph, 73 macrobend, 51
Feeder Cable ID, 74 managing a CEx (co-existence element), 15
Feeder Cable tab, 122 map of the NA-F GUI, 68
field force integration, 5 Map tab, 98
field force personnel, 4 margin, 55, 74
filtering margin factor, 96
GUI information, 168 monitoring
bulk collector, 168
G collection throughput, 168
GIS management, 156 granular collector, 168
GPON-TWDM PONs statistics collection for DSLAMs, 168
creating, 14 statistics collection per DSLAM, 168
deleting, 14 Most impacting faults, 70
granular collector
monitoring, 168 N
GUI NA-F
filtering information, 168 changing password, 165
listing information, 168 logging in, 164
sorting information, 168 NA-F and SDC architecture, 4
network operations personnel, 3
H Network Wide tab, 68
History, 93 Faults per hour graph, 73
History tab Link quality evolution graph, 72
in Optical Link Diagnosis, 111 Link quality table, 70
Most impacting faults, 70
PON utilization table, 69
I notes, 60
integrations, 4 Notes list
in Optical Link Diagnosis, 111
L
Latest detected faults, 77
Link Loss Validation
P S
Paired Feeder Cable ID, 74 SDC
paired PON, 52 collection control, 168-169
Paired PON port address, 74 filtering information, 168
password intervals, 168
changing, 165 listing information, 168
PON branch ID, 86 sorting information, 168
PON BW loss , 53 statistics collection management, 168-169
PON BW margin , 55 service activation, 2
PON Diagnosis page, 75 service activation workflow example, 59
GIS Map, 98 Service Diagnosis & Supervision, 53, 55
History tab, 93 Service Diagnosis tab
Latest detected faults list, 77 in Optical Link Diagnosis, 120
Link quality table, 76 service provider workflows, 58
OTDR tab, 89 splitter icon, 82
PON topology tree, 79 Splitter link
PON history, 152 add through GUI, 86
PON ID, 74 starting
PON port address, 74 services, 165
PON protection, 22, 52 statistics collections, 168-169
pON protection, 52 statistics
PON tab, 73 exporting from NA-F, 133
PON utilization , 69, 74 statistics collection
PON Utilization tab , 159 clearing failures DSLAMs, 168
power validation, 41 clearing per DSLAM, 168
relationship to link quality and faults, 51
T
tagging the optical infrastructure with notes,
60, 188
tags, 60, 80, 188
Topology (classic) tab, 79
Topology (compact) tab, 79
Topology Audit, 28
Topology Audit Report, 28, 144
Topology Replication tab, 137
Topology tab, 79
topology update integration, 5
troubleshooting, 2
troubleshooting workflow example, 59
TWDM NG-PON2 overview, 29
type B PON protection, 52
U
user interface
map of, 68
NA-F, 64