From 5ce690b530772ec6dab0c9d12e3f0d3147f7973b Mon Sep 17 00:00:00 2001
From: Dave Whiteland <dave@mysociety.org>
Date: Mon, 29 Sep 2014 11:03:51 -0500
Subject: cleanup of AMI and Next Steps documentation

Includes addition of the "emergency user"
This is largely after following the instructions through on a clean
AMI install and noticing all the pinnch-points where confusiion or
even errors occurred.

revisited on arrival in Mexico (after 2 weeks' holiday, so this got a bit behind)
---
 docs/glossary.md | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)

(limited to 'docs/glossary.md')

diff --git a/docs/glossary.md b/docs/glossary.md
index 0029cdc24..b5239a32a 100644
--- a/docs/glossary.md
+++ b/docs/glossary.md
@@ -23,6 +23,7 @@ Definitions
   <li><a href="#capistrano">Capistrano</a></li>
   <li><a href="#censor-rule">censor rule</a></li>
   <li><a href="#development">development site</a></li>
+  <li><a href="#emergency">emergency user</a></li>
   <li><a href="#foi">freedom of information</a></li>
   <li><a href="#git">git</a></li>
   <li><a href="#holding_pen">holding pen</a></li>
@@ -230,6 +231,40 @@ Definitions
     </p>
   </dd>
 
+  <dt>
+    <a name="emergency">emergency user</a>
+  </dt>
+  <dd>
+    Alaveteli ships with a configuration setting for an <strong>emergency user</strong>.
+    This provides a username and password you can use to access the admin, even though
+    the user doesn't appear in the database.
+    <p>
+      When the system has been bootstrapped (that is, you've used the emergency user to
+      grant a user account full <em>super</em> privileges), you must disable the emergency
+      user.
+    </p>
+    <div class="more-info">
+      <p>More information:</p>
+      <ul>
+        <li>
+          The username and password are defined by the configuration settings
+          <code><a href="{{site.baseurl}}docs/customising/config/#admin_username">ADMIN_USERNAME</a></code>
+          and 
+          <code><a href="{{site.baseurl}}docs/customising/config/#admin_password">ADMIN_PASSWORD</a></code>.
+        </li>
+        <li>
+          For an example of using the emergency user, see
+          <a href="{{site.baseurl}}docs/installing/next_steps/#create-a-superuser-account-for-yourself">creating
+            a superuser account</a>.
+        </li>
+        <li>
+          Disable the emergency user by setting
+          <code><a href="{{site.baseurl}}docs/customising/config/#disable_emergency_user">DISABLE_EMERGENCY_USER:</a> true</code>
+        </li>
+      </ul>
+    </div>
+  </dd>
+
   <dt>
     <a name="foi">Freedom of Information</a> (also FOI)
   </dt>
-- 
cgit v1.2.3