FTTX Demo Tutorial

Help

Troubleshooting & FAQ

Quick answers: sync failed, no optical power, a menu is missing, ONU not found, and more.

For everyone
On this page

Signing in and access #

I cannot sign in
  • Check the e-mail for typing mistakes and that Caps Lock is off.
  • Forgot the password? An administrator sets a new one on the Users page.
  • A message that the account cannot sign in means it was suspended: ask an administrator.
A menu entry or button that my colleague has is missing

Menus and buttons follow your role. Each topic of this tutorial says at the top which roles can use the page. Ask an administrator if you need more rights.

I see fewer OLTs / ONUs / customers than others

Your account has limited device access. Check My account → My device access. Also check that no filter is set: the ONU list remembers your last filters.

I get a “403” or “not allowed” page

You opened a link to a page your role may not use, or to an OLT / ONU outside your device access. Go back to the dashboard from the menu.

The page says the licence is not active, or a feature is not included

The installation's licence has expired or does not cover that feature. Only the company's owner can solve this with the software provider. Press Check again on that page once it is renewed.

Syncs and old data #

An OLT shows “Failed”
  1. Open the OLT; read the message under SNMP sync (or the red line on its card).
  2. Press Test connection.
  3. No response: the OLT is off or unreachable, or the IP / SNMP port / community is wrong. Check on Edit.
  4. Timed out: the OLT is very large or slow. One failure is not a worry; it retries. If it repeats, tell your administrator.
  5. CLI sync failed: wrong CLI username / password / port, or the collector service is down (see System).
“Sync now” seems to do nothing

The sync is waiting in the queue. The OLT page shows its place. If jobs wait but nothing runs, the queue worker on the server is stopped: check System → Services.

All data looks hours old
  1. Dashboard → Last sync … ago confirms it.
  2. Sync logs → trigger Schedule → Today: no rows means the scheduler is not running.
  3. Tell the server administrator: “the scheduler / queue worker is down” (System → Services shows which).
An OLT lost all its ONUs, or shows ONUs that were removed

When a sync reads zero ONUs, the app keeps the stored ones on purpose, so a bad sync cannot wipe an OLT. ONUs that were really removed on the OLT disappear after the OLT has confirmed it (on some models, after two syncs in a row).

Signal and readings #

An ONU shows “—” instead of power
  • The ONU is offline: there is nothing to measure.
  • Or that OLT model does not report this value. OLT Rx in particular is missing on several models; that is normal.
  • Or the OLT needs CLI access for it: ask your administrator to enable CLI enrichment for that OLT.
An ONU has no router MAC or no customer
  • Router MACs are learned only while the customer's router is on. An offline ONU keeps the last known one.
  • Some OLT firmware does not say which ONU a MAC is behind. Then the customer must be linked by hand on the customer form.
I cannot find an ONU by its serial
  • Type only part of it (the last 6–8 characters), without spaces or dashes.
  • Clear the other filters (status, OLT, ownership).
  • A brand-new ONU appears after the next sync of its OLT: press Sync on the OLT.
  • On OLTs that need registration, an unregistered ONU is not listed: see Add an ONU.
The OLT health card shows no CPU / memory

That OLT model does not report it, or it has not been read yet. If no OLT shows a reading right after an update, a Super Admin should press Restart workers on the System page.

Map and phone #

“Use my location” or “Record my walk” does not work
  • Allow the location permission when the browser asks (or switch it on for this site in the browser's settings).
  • Turn on the phone's GPS / location.
  • The app's address must start with https://. On a plain http:// address browsers refuse to give the location.
An ONU is not on the map

Only ONUs that were placed are on the map. Find it in the ONU list and press Place on map. Also check that the ONUs layer chip is switched on.

The map background is grey

The background needs the internet. Check your connection, or switch between Street and Satellite.

I cannot install the app on my phone

Installing needs an https:// address and a current Chrome (Android) or Safari (iPhone). See Getting started → On a phone.

Reporting a problem well #

When you ask your administrator or the software provider for help, send:

  1. The page you were on (copy the address from the browser).
  2. What you did and what you expected.
  3. The exact message on screen: a screenshot is best.
  4. The OLT name / ONU serial concerned.
  5. The app version from the bottom of the page (for example “v1.160”).

Finished this topic?

Tick it off; the topic list shows what you have read.