1 What the page means
The page appears when SoftwareCentral cannot complete what you asked it to do.
The error may be caused by insufficient permissions, or because you are trying to access a resource that does not exist. The page is the same for all of these causes, so the text under the heading tells you which one it was (see What the page shows).
2 What to do
Work through these steps in order.
- Restart your browser, closing all open tabs.
- Go back to SoftwareCentral and try again.
- If the error persists, contact your help desk or SoftwareCentral administrator. Give them the date and time shown at the bottom of the page.
Note the time
The date and time at the bottom of the page is the time of the error. It helps your administrator find the matching entry in the SoftwareCentral log.
3 What the page shows
The page has a heading, a short reason and a time. Some parts appear only in certain cases.
| Part of the page | What it tells you |
|---|---|
| Oops - something went wrong! (heading) | The page is an error page. The browser tab shows SoftwareCentral - An unhandled exception occurred. |
| Details: | The reason, in short words. The messages are listed in the Troubleshooting table. |
| Date and time: | The time of the error in your time zone, with its UTC offset. |
| Close button | Shown only when the page is open in a SoftwareCentral window. It closes that window. |
| Help button | At the bottom of the page. It opens this help page. |
Engineering mode
When your administrator has Engineering mode turned on, the page also shows the technical error message and the stack trace.
4 Where to look next
If the steps above do not help, these pages cover the most common causes.
| Page | Use it when |
|---|---|
| Troubleshooting | A tool does not start from SoftwareCentral, for example because of the URI Scheme or the connection to the computer. |
| Troubleshooting (Remote Control) | The Remote Control Tool, or another external tool, does not start from SoftwareCentral. |
| Advanced troubleshooting | A deployment failed and you want to find out why in the client logs. |
| Log | You want to find the full error in the SoftwareCentral log, at the time shown on the page. |
5 Best practice
- If a link or bookmark fails, type the base address of the site instead. The error page itself suggests this for the missing security token error.
- Let the server reach the Microsoft sign-in service. The server running SoftwareCentral must reach login.microsoftonline.com and graph.microsoft.com on port 443. These are two different addresses, and access to one does not give access to the other. If the network uses a proxy, it must be set for the account the application pool runs as.
- Keep Engineering mode off on a live site. With it on, every user sees the technical message and the stack trace on the page.
- Look in the SoftwareCentral log at the time shown. The full error is written there, so the time on the page is enough to find it.
6 Troubleshooting
| Symptom | Cause | What to do |
|---|---|---|
| The details say The requested file does not exist or you do not have access to it. | You do not have access to the page or item, or it no longer exists. | Check with your administrator that your role gives you access to the page. Go back to SoftwareCentral and open it again from the menu. |
| The details say An error has occurred. Please try to restart the browser. | An unexpected error in the page, shown as an object reference error. | Restart your browser, closing all open tabs, then go back to SoftwareCentral. |
| The details say Error: The sign in service could not be reached | The server running SoftwareCentral did not get an answer from the Microsoft sign-in service in time, so you cannot be signed in. | Reload the page. If it keeps happening, your administrator must check the server's access to login.microsoftonline.com and graph.microsoft.com on port 443, and any proxy (see Best practice). |
| The details say Error: Missing Security Token | The sign-in request is missing its security token (nonce), which SoftwareCentral needs to keep the sign-in safe. | Make sure you use HTTPS, and that your account belongs to a tenant that is allowed to use this page. Type the base address of the site, reload the page, and clear your browser cache. |
| The browser tab shows SoftwareCentral - An unhandled exception occurred | Any error that SoftwareCentral did not expect. The title is the same for all of the causes above. | Follow the steps in What to do, and give your administrator the time shown on the page. |
| The details show Error Caught in, Error Message and Stack Trace | Engineering mode is on (see What the page shows). | Tell your administrator. They can turn Engineering mode off. |