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 see | What it means | What to do |
|---|---|---|
| A message such as Invalid username or password on the ministry sign-in form | The user name and password do not match | Type 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 of | Your account may have been deactivated — this is what a deactivated person sees — or never had a password set | Ask 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 arrived | The message may be in the spam folder, or the address on your account is not the one you are watching | Check spam, then ask your administrator which address the account carries. You cannot change it yourself |
| The invitation link says it has expired | Invitation links are single-use and last about 7 days | Do 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 password | The ministry sign-in service still holds your earlier session | Normal, 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 Overview | IFMS always returns you to the Overview after signing in | Sign 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 tab | Your session belongs to one tab | Sign in again in the new tab, or keep working in the first one |
| You are suddenly back on the welcome page, with no explanation | Your session ended after 30 minutes without activity. IFMS says nothing when this happens | Sign 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-out | Select 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 see | What it means | What to do |
|---|---|---|
| Access denied on a page you opened from a link or a search result | Your role does not cover that screen. The search box and the Overview are open to everybody, but what they lead to is not | Select 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 screen | IFMS hides what your role does not allow instead of greying it out | Check What each role can do. If the role should include it, tell your administrator |
| A policy opens but has no Edit button | Your role may read alert policies but not change them. Selecting a row opens the policy read only | Nothing is wrong. Ask somebody who may change policies |
| A row has no three-dot button | Your role allows none of the actions that menu would hold | The same as a missing button. Nothing is broken |
| A role you need is not in the Roles list when adding or editing a user | You may give only some roles: an Operational manager may give Operational manager, Supervisor and Operator. Machine roles are hidden | Ask 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 out | Wait for the provider's name to arrive, or report it to the IFMS team |
| The sidebar shows every item for a second, then shortens | IFMS is still working out your rights when the page first draws | Normal. Wait a moment |
| The sidebar stays short — only Overview — although your role allows more | Your rights failed to load | Reload 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 you | The portal keeps your rights for about five minutes, and an open page keeps them until it is reloaded | Reload the page. If it still has not changed, sign out and back in |
| You cannot find Live map or Inbox in the menu | Neither has a menu entry | Live 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.
| Screen | The empty message |
|---|---|
| Fleet | No vehicles match — "Try a different search, or clear the filters." |
| A provider's vehicles | No vehicles — "This provider has no vehicles in the catalogue." |
| Providers | No providers found — "Try a different search." |
| Events | No events match — "Adjust the filters or wait for the live feed." |
| Alert Policies | No policies yet — "Create a policy to start raising alerts." |
| Geofencing list | No geozones — "No geozones match your search." or "Add a geozone to start monitoring corridor points of interest." |
| Geofencing map, with no switched-on zones | No geozones yet — "No geozones yet. Create one with Add geozone, or import a CSV." |
| Geofencing, Show deleted | No deleted geozones |
| Licences & Permits | Nothing 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 report | No data for this period yet. — "New data appears within a few minutes." Also shown when the search or filters match nothing |
| Users | No users found — "Try a different filter, or add a new user." |
| Roles | No roles found — "Try a different search, or add a new role." |
| Alert routing | No routing rules yet — "Add a rule to send email/SMS for alerts. In-app delivery already works for everyone." |
| Inbox | You're all caught up — "Alerts routed to you will appear here." |
| The bell | No notifications yet |
Work through it in this order.
- Did a red message appear in the corner at the same time? If so, the request failed. Reload the page.
- Clear the search box and set every filter back to All. A filter you set earlier is remembered while you stay on the screen.
- Check you are on the right page of a long list, using the arrows at the bottom.
- Reload the page. On a busy or a test installation, a list that failed once usually succeeds on the second try.
- 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 see | What it means | What to do |
|---|---|---|
| A vehicle disappears from all vehicle views | IFTMS may no longer say it is legal | Check Events for a legality alert. Its history is kept but hidden |
| The Overview counters do not match Fleet | Both show only legal vehicles. Fleet may have search or filters applied | Clear Fleet filters and reload both screens |
| Filtering the live map table by Region or GPS empties it | Those two columns are not filled in from live data, so every vehicle carries the same placeholder | Use the Status, Provider and Type filters, or the search box |
| New alerts do not appear while you watch the Events screen | The 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 headings | The 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 list | Somebody deleted it | Switch on Show deleted and Restore it. See Delete and restore a geozone |
| A policy never fires | It may be switched off, scoped to a switched-off geozone, or set to Specific vehicles with nobody on the list | Check 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 see | What it means | What to do |
|---|---|---|
| A spinner in the middle of the page that does not go away | IFMS is still checking your session or your rights | Wait a few seconds, then reload |
| Counter cards all showing 0, then jumping to real numbers | The counters have no loading sign and show 0 until their answer arrives | Wait 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 be | The provider page draws nothing at all while it loads | Wait, then reload |
| Provider not found — "The provider you are looking for does not exist." | There is no provider at that address | Go 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 fetched | Select Try again |
| Couldn't load vehicle, with a technical sentence underneath and a Retry button | The vehicle could not be fetched. The sentence is addressed to the IFMS team, not to you | Select 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 legal | Go 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 exists | Somebody deleted the policy while you had the link | Go Back to the policy list |
| A map area that stays blank, or reads Live map unavailable | The mapping service is not available to this installation. The second line of that panel is a technical note for whoever installed IFMS | Everything 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 streets | The map tiles did not load | Reload the page before you start drawing; a zone drawn on a blank map is easy to place wrongly |
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 message | What it means | What to do |
|---|---|---|
| Something went wrong | IFMS has no more detail to give | Reload and try once more. If it happens again, report what you were doing |
| Network error | Your browser could not reach IFMS | Check 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 first | Correct 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 CONFLICT | The refusal came back without a readable sentence | Note 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 closed | Nothing 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 see | What it means | What to do |
|---|---|---|
| A Save or Next button stays greyed out and nothing explains why | A required field is empty or invalid. IFMS disables the button instead of explaining | Go 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 incomplete | Fill in all four |
| Geozone name is required / Group name is required / Enter a role name. | A name field is empty | Type a name |
| A note is required to continue | Acknowledging or closing an alert needs a note | Type 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 role | The key IFMS made from the name is taken — typing a built-in role's name, such as "Operational manager", does this | Change 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 country | The number does not fit the country chosen beside it | For 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 heading | Select 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 has | Close the window and open the role again |
| A vehicle's description now holds text you never typed | The edit box fills itself with the make and model when the vehicle has no description | Clear 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 switch | IFMS asks before it starts or stops sending emails and text messages for that rule | Select 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 out | Your role allows switching in one direction only | Ask 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 count | Choose 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 group | Change or delete the policies named, then delete again |
| A CSV import says "S imported, F failed" and the window stays open | The Server result lists each refused row and why | Correct or remove those rows, then import again. Import stays grey until you change the contents |
Searching, filtering and paging
| What you see | What it means | What to do |
|---|---|---|
| The search box does nothing | Most 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 elsewhere | The 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 open | Use the search box on the screen you need |
| The page number jumps backwards when you change a filter | The list has become shorter than the page you were on | Normal |
| You changed Rows per page and went back to page 1 | Changing the page size always returns to the first page | Normal |
Exporting and files
| What you see | What it means | What to do |
|---|---|---|
| No events to export | The page of alerts you are looking at is empty | Clear the filters, or move to a page that has rows |
| Export is greyed out on a report | The report is still loading, or has no rows | Wait 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 once | Wait a minute, then export again |
| PDF is greyed out in the export window | The report has more than 2,000 rows | Narrow the period or the filters, or choose Excel |
| The exported alert file has only ten rows | Export CSV on Events exports the page you are looking at, not the whole filtered set | Set 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 Excel | The CSV file has no marker telling Excel which alphabet to use | Export to Excel instead, or import the CSV into Excel choosing UTF-8 |
| The export window closed but no file arrived | The browser blocked the download | Check your browser's downloads and its blocked-download warning |
| Could not copy location | The browser refused access to the clipboard | Select 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.