Skip Navigation

External error pages for Self Service throttling

When the
AtHoc
Self Service application is throttled to use only 30% of CPU, it is likely that IIS will display errors with a status code of “503” or “500” when the system is under heavy load and unable to handle requests. If these errors occur, IIS displays a default error page that does not contain a lot of useful information for users.
These errors are usually not customizable at the IIS level on the same server, as documented by Microsoft.
BlackBerry AtHoc
provides friendly messages in static pages that can be used in place of the default error pages, provided that the
BlackBerry AtHoc
system is deployed behind a proxy server or load balancer that supports error message customization. You can configure these load balancers or proxy servers to trap these errors and redirect to the friendlier messages instead. The error pages are available on the application server at the following path:
AtHocENS\wwwroot\errorpages
.
You can take the
errorpages
folder and host it on any web server that is capable of serving HTML, CSS, and Javascript pages.
The server where you host your error pages should be different than the
AtHoc
server where you are running the
AtHoc
applications.
To host the folder, administrators copy the folder and make it publicly available from their web server. For example, if you hosted these pages directly under the root folder of the web server, the error pages can then be accessed using the following URLs, where <domainnameofserver> refers to the actual domain name of the server:
Error page
Error page URL
Message
500 – Internal Server Error
https://<domainnameofserver>/errorpages/index.html?code=500
The server encountered an unexpected condition which prevented it from fulfilling the request. Try to access the page again. If this doesn't work, wait a few minutes, restart your browser, and then try again.
503 – Service Unavailable
https://<domainnameofserver>/errorpages/index.html?code=503
The server is unable to load the page you are requesting. This could be because increased traffic is overwhelming the server. Wait a few minutes and then try again.
After these pages are hosted on a different server than the
AtHoc
server, you can configure the individual proxy server or load balancers to redirect to the static hosted pages based on the error that IIS returns to the client.
Because the configuration process varies depending on the type of load balancer or proxy server being used, the configuration process is not documented here.