Skip to main content

Troubleshooting

Find the thing you are seeing, read what it means, and do what the last column says. Nothing on this page requires technical knowledge.

If you have to report a problem, note the exact wording of any message, the screen you were on and roughly when it happened. That is usually all the IFMS team needs.


Signing in​

What you seeWhat it meansWhat to do
A message such as Invalid username or password on the ministry sign-in formThe user name and password do not matchType them again carefully. The user name is usually your work email address. Repeated failures can lock the account for a while — wait a few minutes rather than trying again immediately
Account is disabled, or the form keeps refusing a password you are sure ofYour account may have been deactivated — this is what a deactivated person sees — or never had a password setAsk your administrator to check the Users screen and, if the account is Inactive, to Reactivate it. If you never set a password, use Forgot Password? to get a fresh link
No invitation email arrivedThe message may be in the spam folder, or the address on your account is not the one you are watchingCheck spam, then ask your administrator which address the account carries. You cannot change it yourself
The invitation link says it has expiredInvitation links are single-use and last about 7 daysDo not ask for another invitation. Use Forgot Password? on the sign-in form — it sends a new link, valid for about 12 hours
You select Sign in with Keycloak and are signed straight in, with no passwordThe ministry sign-in service still holds your earlier sessionNormal, and convenient on your own computer. On a shared computer always finish with Sign out from the user menu, never by closing the tab
You signed in from a link to a particular alert or page, but landed on OverviewIFMS always returns you to the Overview after signing inSign in first, then open the link again, or find the item from your Inbox
A new browser tab shows the welcome page although you are signed in in another tabYour session belongs to one tabSign in again in the new tab, or keep working in the first one
You are suddenly back on the welcome page, with no explanationYour session ended after 30 minutes without activity. IFMS says nothing when this happensSign in again. Nothing you saved is lost. See Your session and signing out
Session timeout — "Your session is about to expire due to inactivity. You will be signed out in 4:07."Five minutes' warning before an automatic sign-outSelect Stay signed in. Moving the mouse also cancels it, so the box can close on its own before you read it

"Access denied" and missing menu items​

Access denied appears inside the normal workspace — the menu and header stay where they are, and the web address does not change. It shows a shield, the heading Access denied, the sentence "You don't have permission to view this page. If you think this is a mistake, contact your administrator." and a Back to overview button.

What you seeWhat it meansWhat to do
Access denied on a page you opened from a link or a search resultYour role does not cover that screen. The search box and the Overview are open to everybody, but what they lead to is notSelect Back to overview. Ask your administrator for the role you need — What each role can do says which one that is
A button described in this manual is simply not on your screenIFMS hides what your role does not allow instead of greying it outCheck What each role can do. If the role should include it, tell your administrator
A policy opens but has no Edit buttonYour role may read alert policies but not change them. Selecting a row opens the policy read onlyNothing is wrong. Ask somebody who may change policies
A row has no three-dot buttonYour role allows none of the actions that menu would holdThe same as a missing button. Nothing is broken
A role you need is not in the Roles list when adding or editing a userYou may give only some roles: an Operational manager may give Operational manager, Supervisor and Operator. Machine roles are hiddenAsk a System admin to give the role. See Which roles you can give
A provider is missing from the provider list in the policy wizard or an alert-routing rule, or shows as Unnamed provider (…)The provider has not sent IFMS a readable name yet. Pickers leave unnamed providers outWait for the provider's name to arrive, or report it to the IFMS team
The sidebar shows every item for a second, then shortensIFMS is still working out your rights when the page first drawsNormal. Wait a moment
The sidebar stays short — only Overview — although your role allows moreYour rights failed to loadReload the page. If the menu is still short after a second try, tell your administrator
An administrator has just changed your roles but nothing has changed for youThe portal keeps your rights for about five minutes, and an open page keeps them until it is reloadedReload the page. If it still has not changed, sign out and back in
You cannot find Live map or Inbox in the menuNeither has a menu entryLive map: Open live map on the Overview. Inbox: the bell, then View all. See Find your way around

A table is empty when it should not be​

When a list could not be loaded, it says so: "This list could not be loaded" with a Try again button, or "You don't have access to this list" when your role does not include it. The live map table and Reports are the exceptions: they show their empty message whatever the reason, so an empty table there is not proof that there is nothing to do.

The messages below mean that the list loaded and nothing matched.

ScreenThe empty message
FleetNo vehicles match — "Try a different search, or clear the filters."
A provider's vehiclesNo vehicles — "This provider has no vehicles in the catalogue."
ProvidersNo providers found — "Try a different search."
EventsNo events match — "Adjust the filters or wait for the live feed."
Alert PoliciesNo policies yet — "Create a policy to start raising alerts."
Geofencing listNo geozones — "No geozones match your search." or "Add a geozone to start monitoring corridor points of interest."
Geofencing map, with no switched-on zonesNo geozones yet — "No geozones yet. Create one with Add geozone, or import a CSV."
Geofencing, Show deletedNo deleted geozones
Licences & PermitsNothing needs attention — "No licence or permit in this view needs attention right now." Also shown when your search or status buttons match nothing
A provider's recent alerts"No events recorded for this provider."
A reportNo data for this period yet. — "New data appears within a few minutes." Also shown when the search or filters match nothing
UsersNo users found — "Try a different filter, or add a new user."
RolesNo roles found — "Try a different search, or add a new role."
Alert routingNo routing rules yet — "Add a rule to send email/SMS for alerts. In-app delivery already works for everyone."
InboxYou're all caught up — "Alerts routed to you will appear here."
The bellNo notifications yet

Work through it in this order.

  1. Did a red message appear in the corner at the same time? If so, the request failed. Reload the page.
  2. Clear the search box and set every filter back to All. A filter you set earlier is remembered while you stay on the screen.
  3. Check you are on the right page of a long list, using the arrows at the bottom.
  4. Reload the page. On a busy or a test installation, a list that failed once usually succeeds on the second try.
  5. Check your role covers the data. A provider's page, for example, needs separate rights for its alerts and for its vehicles, and without them it reports having neither.

Two empty tables have a specific cause worth knowing:

  • A report shows nothing for the last few minutes. Reports take in new data a few minutes after it arrives. Use the live screens for what is happening now.
  • The Inbox says you are all caught up, but colleagues have notifications. If the notification service cannot be reached, the bell shows no count and the Inbox shows the same "all caught up" message as a genuinely empty inbox. There is no error message for this. Reload; if the Events screen has alerts that your Inbox does not, report it.

A vehicle, alert or zone you expected is missing​

What you seeWhat it meansWhat to do
A vehicle disappears from all vehicle viewsIFTMS may no longer say it is legalCheck Events for a legality alert. Its history is kept but hidden
The Overview counters do not match FleetBoth show only legal vehicles. Fleet may have search or filters appliedClear Fleet filters and reload both screens
Filtering the live map table by Region or GPS empties itThose two columns are not filled in from live data, so every vehicle carries the same placeholderUse the Status, Provider and Type filters, or the search box
New alerts do not appear while you watch the Events screenThe Events list does not refresh by itself, despite the wording "wait for the live feed"Reload the page, or change a filter or a page — either reloads the list. The bell keeps counting in the background
The geozone list has no group headingsThe groups could not be loaded; a red box says "Groups could not be loaded, so zones are shown without their groups."Select Try again
A geozone has disappeared from the listSomebody deleted itSwitch on Show deleted and Restore it. See Delete and restore a geozone
A policy never firesIt may be switched off, scoped to a switched-off geozone, or set to Specific vehicles with nobody on the listCheck the Active switch, open the policy and check its scope and its vehicle list. See Policy recipes

A page will not load, or loads slowly​

IFMS asks for several things at once when a screen opens — your rights, the list itself, the counters, the map — and they arrive at different moments. That makes a slow connection look like a broken screen.

What you seeWhat it meansWhat to do
A spinner in the middle of the page that does not go awayIFMS is still checking your session or your rightsWait a few seconds, then reload
Counter cards all showing 0, then jumping to real numbersThe counters have no loading sign and show 0 until their answer arrivesWait for them to settle before reading them. On a slow day this takes a few seconds
A blank white panel where a provider's page should beThe provider page draws nothing at all while it loadsWait, then reload
Provider not found — "The provider you are looking for does not exist."There is no provider at that addressGo Back to providers and open it from the list
Couldn't load provider — "The request failed, so nothing about this provider is shown. It has not been removed."The provider list could not be fetchedSelect Try again
Couldn't load vehicle, with a technical sentence underneath and a Retry buttonThe vehicle could not be fetched. The sentence is addressed to the IFMS team, not to youSelect Retry. If it fails repeatedly, note the wording and report it
Vehicle not found — "This vehicle may have been removed from the fleet."The vehicle was removed or is no longer legalGo Back to fleet. A removed vehicle comes back, with its history, the next time its provider sends a position while IFTMS says it is legal
That policy no longer existsSomebody deleted the policy while you had the linkGo Back to the policy list
A map area that stays blank, or reads Live map unavailableThe mapping service is not available to this installation. The second line of that panel is a technical note for whoever installed IFMSEverything except the map still works — use the Table view on the live map. Report it: it is not something you can fix
The drawing map shows a plain grey area with no streetsThe map tiles did not loadReload the page before you start drawing; a zone drawn on a blank map is easy to place wrongly
Test and training installations are slower

On a test or training copy of IFMS, requests fail intermittently — a list comes back empty, a counter stays at zero, a screenshot-perfect page shows a red message. Reloading once or twice almost always fixes it, and nothing you have saved is affected. On the live installation this should be rare; if it is not, report it.


Red messages in the corner​

A failed action always shows a red message in the top-right corner. It disappears by itself, so read it while it is there.

The messageWhat it meansWhat to do
Something went wrongIFMS has no more detail to giveReload and try once more. If it happens again, report what you were doing
Network errorYour browser could not reach IFMSCheck your connection, then reload
Something of the form Field name: explanation, sometimes with (+2 more)One or more fields were refused. The field is named firstCorrect that field and save again. Common causes: text that is too long, or a phone number in the wrong shape
A short word in capitals, such as NOT_FOUND or CONFLICTThe refusal came back without a readable sentenceNote the word and what you were doing, and report it
The alert is not in a state that allows this action.You tried to acknowledge an alert that has already been closedNothing to do. A closed alert is final and cannot be reopened

| "A user with that email or username already exists" | The address already belongs to an IFMS account, possibly a deactivated one | Set Status to All, search for the address and Reactivate the account instead of adding it again | | "You may not grant that role" | You picked a role you are not allowed to give | Pick from what the list offers, or ask a System admin | | "You can't deactivate yourself." | Nobody can deactivate their own account | Ask another administrator | | "At least one System admin must remain active." | This is the last active System admin | Give System admin to somebody else first | | "The identity provider is unavailable" / "The identity provider did not disable the account" | The Ministry sign-in system did not answer, or did not confirm the change | Try again in a little while. If it keeps happening, report it |

One silent failure is worth knowing about, because no message appears: notifications that fail to reach you produce no message anywhere. See the Inbox note above.


Saving and actions​

What you seeWhat it meansWhat to do
A Save or Next button stays greyed out and nothing explains whyA required field is empty or invalid. IFMS disables the button instead of explainingGo back through the fields with a red asterisk. In the policy wizard, check the name, the speed limit (it must be a number above zero), the geozone and the provider. In the geozone editor, the line under the button says what is missing — "Draw the geozone on the map to save it" — and nothing can be saved until a shape has been drawn
Enter a first name, last name, email and at least one role.The Add user form is incompleteFill in all four
Geozone name is required / Group name is required / Enter a role name.A name field is emptyType a name
A note is required to continueAcknowledging or closing an alert needs a noteType what you did or what you found. Keep it under about 500 characters, or it is refused
"Another role already uses this key." / "This key belongs to a built-in role." under Role key, when adding a roleThe key IFMS made from the name is taken — typing a built-in role's name, such as "Operational manager", does thisChange the Role key. If the name is written only in Amharic letters, the key stays empty: type one in Latin letters
Phone number is too short / too long / Invalid phone number for the selected countryThe number does not fit the country chosen beside itFor Ethiopia, leave out the leading 0 — type nine digits, 91…, not 091…
An amber box: "Profile saved; roles weren't changed." or "Role saved; permissions weren't changed."IFMS saves the details first and the roles or permissions second, and the second step was refused. The reason is under the headingSelect Retry roles or Retry permissions. If the reason says you may not give a role, remove it
"This role's current permissions could not be loaded, so it cannot be edited safely. Close the dialog and try again."The role editor could not fetch what the role grants today. Save changes stays greyed out until it hasClose the window and open the role again
A vehicle's description now holds text you never typedThe edit box fills itself with the make and model when the vehicle has no descriptionClear the box before saving if that is not what you want. Saving an empty box erases the stored value
Turn on this rule? or Turn off this rule? when you flip an Alert routing Enabled switchIFMS asks before it starts or stops sending emails and text messages for that ruleSelect Turn on or Turn off. A green "Rule turned on." or "Rule turned off." confirms it; Cancel leaves the rule as it was
A geozone's Active switch is greyed outYour role allows switching in one direction onlyAsk somebody with the full right to do it, or ask your administrator to extend the role
Another geozone already uses this name. / "A geo-zone with this name already exists."Another zone in use has that name — capitals and spaces at either end do not countChoose another name, or rename or delete the other zone
Can't delete this geozone / "This geozone is used by: …" / "This group is used by: …"An alert policy watches the zone or groupChange or delete the policies named, then delete again
A CSV import says "S imported, F failed" and the window stays openThe Server result lists each refused row and whyCorrect or remove those rows, then import again. Import stays grey until you change the contents

Searching, filtering and paging​

What you seeWhat it meansWhat to do
The search box does nothingMost searches need at least a moment's pause, and the header's fleet search needs at least 3 characters — below that it says "Type at least 3 characters to search."Type more, then wait a second
The header search shows No results found. for something you can see elsewhereThe box searches plates, truck and chassis numbers, descriptions, provider names, drivers, licence and permit numbers, and geozone names — and only the kinds your role can openUse the search box on the screen you need
The page number jumps backwards when you change a filterThe list has become shorter than the page you were onNormal
You changed Rows per page and went back to page 1Changing the page size always returns to the first pageNormal

Exporting and files​

What you seeWhat it meansWhat to do
No events to exportThe page of alerts you are looking at is emptyClear the filters, or move to a page that has rows
Export is greyed out on a reportThe report is still loading, or has no rowsWait for the table to fill, or widen the period
"Several exports are already running. Try again in a minute."Too many report files are being made at onceWait a minute, then export again
PDF is greyed out in the export windowThe report has more than 2,000 rowsNarrow the period or the filters, or choose Excel
The exported alert file has only ten rowsExport CSV on Events exports the page you are looking at, not the whole filtered setSet Rows per page to 100 and export each page, or use the Reports screen, which exports everything
Dashes, degree signs or Amharic text look like nonsense in ExcelThe CSV file has no marker telling Excel which alphabet to useExport to Excel instead, or import the CSV into Excel choosing UTF-8
The export window closed but no file arrivedThe browser blocked the downloadCheck your browser's downloads and its blocked-download warning
Could not copy locationThe browser refused access to the clipboardSelect the text and copy it by hand

Times and dates look wrong​

Some times in the portal — Added, Last updated and Record changed, and the "3 hours ago" forms of them — can be shown a few hours out from the real time, while Last checked and Last seen are correct. You may see a vehicle "last checked" after it was "last updated", although both came from the same moment.

Trust Last seen for how recently a vehicle reported, and treat the record times as approximate. This is a known fault; see Known limitations.


When to ask for help​

Ask your administrator when:

  • a screen or a button you need is missing — that is a role question;
  • somebody has left and their access must end;
  • an invitation or a password email never arrives.

Ask the IFMS team when:

  • the same red message keeps coming back after reloading;
  • a map never draws;
  • numbers on two screens disagree in a way this manual does not explain;
  • an import or an export loses data.

Have ready: the exact wording of the message, the screen, the plate or the name of the record, and the time. A screenshot is better than a description.