Creating a simple HTML maintenance page for EmpowerID

Owned by Pooja Gupta 2 (Unlicensed)
Jun 02, 2021
2 min read

A maintenance page can be used when EmpowerID is inoperable due to technical problems, such as scheduled system reboots after a patching cycle or an outage caused by hardware or database failures.

Create a file named app_offline.htm with the following contents:

<html>
<head>
<title>EmpowerID maintenance</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<style>
body { text-align: center; padding: 150px; background-color: #23C3FF; }
h1 { font-size: 50px; }
body { font: 20px Helvetica, sans-serif; color: #000; }
article { display: block; text-align: left; width: 650px; margin: 0 auto; }
</style>
</head>
<body>
<article>
<h1>EmpowerID is temporarily unavailable.</h1>
<p>We are currently performing scheduled maintenance. Site will back soon.</p>
<p>We apologize for any inconvenience.</p>
</article>
</body>
</html>

To activate maintenance mode, simply copy app_offline.htm into the following locations:

X:\Program Files\TheDotNetFactory\EmpowerID\Web Sites\EmpowerID.ClickOnce
X:\Program Files\TheDotNetFactory\EmpowerID\Web Sites\EmpowerID.Web.ServiceProvider
X:\Program Files\TheDotNetFactory\EmpowerID\Web Sites\EmpowerID.Web.IdP.Forms
X:\Program Files\TheDotNetFactory\EmpowerID\Web Sites\EmpowerID.Web.IdP.OAuthProvider
X:\Program Files\TheDotNetFactory\EmpowerID\Web Sites\EmpowerID.Web.IdP.SmartCard
X:\Program Files\TheDotNetFactory\EmpowerID\Web Sites\EmpowerID.Web.IdP.Windows
X:\Program Files\TheDotNetFactory\EmpowerID\Web Sites\EmpowerID.Web.IdP.WSFederation
X:\Program Files\TheDotNetFactory\EmpowerID\Web Sites\EmpowerID.Web.Reports

Replace X:\ with the drive letter where EmpowerID is installed.

Please note that restarting the EmpowerID application pools, running IISRESET or restarting the EmpowerID windows services is not necessary. When app_offline.htm is present in the root of an ASP.NET web application, any new requests to a URL, any URL, in that ASP.NET web application will redirect to app_offline.htm, allowing you to perform maintenance or alert users of an outage.

To deactivate maintenance mode, simply delete the app_offline.htm file from the locations mentioned above.

Please feel free to contact us by e-mail at support@empowerid.com or by phone at (877) 996-4276 (Option 2) if you have any questions or concerns regarding this guide.