docs/8.0/ayanova/docs/ops-profile.md

@@ -1,8 +1,9 @@
-# OPS-PROFILE Placeholder
+# Ops-profile 
+
 ![THIS PAGE UNDER CONSTRUCTION](img/underconstruction.svg)
-primarily for tech support diagnosis in case of slowness
-only keeps last half hour of stats
-how to use: trigger slow operation, then go to this page right away and walk through looking for slow ness
-take screenshot to provide tech support or give tech support a ops restricted login so they can view it themselves
+
+- primarily for tech support diagnosis in case of slowness
+- only keeps last half hour of stats
+- how to use: trigger slow operation, then go to this page right away and walk through looking for slowness take screenshot to provide tech support or give tech support a ops restricted login so they can view it themselves
 
 

docs/8.0/ayanova/docs/ops-server-state.md

@@ -1,4 +1,76 @@
-# OPS SERVER STATE
+# Server state
 
-![THIS PAGE UNDER CONSTRUCTION](img/underconstruction.svg)
-#b4beta
+The Server state [form](ay-start-form-overview.md) is used to control the availability of the AyaNova server.
+
+## Authorization Roles required
+
+This form is available to User's with the following [roles](ay-biz-admin-roles.md):
+
+Full access
+
+- System operations
+
+Read only access
+
+- all users will be shown the server state and "reason" text if they attempt to use AyaNova when it's in a closed state
+
+## How to access server state
+
+Server state form is accessed in the following ways:
+
+- From the `Server operations` navigation pane `Server state` item to open this form
+
+## How Server state works
+
+Server state controls whether the server is generally accessible to Users or not. The SuperUser account can _always_ log in to the AyaNova server regardless of the state.
+
+The server itself will also control state, for example, during an automated backup the server will lock out general Users for the duration of the backup process.
+
+### Server re-starts and state
+
+Server state does not survive a re-start of the AyaNova server. When booted the server will automatically go to an open state whenever possible.
+
+### States
+
+Internally the server has 5 possible states:
+
+#### Unknown
+
+The server is in an undertermined state, usually a brief time during boot up.
+
+#### Closed
+
+No access to any users, the server API is completely locked down. Set by the server itself internally only. Users can't set this state.
+Typically you will see this when a backup operation is in progress. Once the condition is resolved at the server it will return to whatever previous state was set. Locked out users will be able to continue working the moment the server reverts to an open state.
+
+#### Migrate mode
+
+Access only for the SuperUser account for the purposes of migration from older versions of AyaNova. This puts the server in a special state to facilitate migrating data _to_ the AyaNova server without allowing other changes that might affect migration operations. Do not use this state unless directed to do so by migration procedures.
+
+If a migration is in progress and this state is changed it _will_ break the migration process.
+
+#### Operations only
+
+Access only for Users with a Operations [role](ay-biz-admin-roles.md). Can be set by a Server operations role user in this form.
+
+This is what you want to set when server maintenance needs to be done and you don't want Users affecting data while you are working.
+
+Logged in users will receive an error similar to a validation error indicating the server is closed and displaying the "Reason" message if any when they attempt to make any requests to the AyaNova server. Users who are locked out do _not_ need to close their AyaNova web app; once the server is set back to an open state they can continue working as normal, save any pending changes etc.
+
+Not logged in users will not be able to login unless they are the SuperUser or have a System operations role. Instead they will receive an error on the login page that the server is closed and also the "Reason" message if any will display.
+
+#### Open
+
+This is the default server state, open to all users. Can be set by a Server operations role user in this form.
+
+### Changing server state
+
+Select the desired state optionally enter a "Reason" message and click the Save menu item. The reason message will display to the Users who are locked out.
+
+## Shutting down the AyaNova server
+
+This form has a menu option `Shut down server` to gracefully stop and shut down the AyaNova server software. This is the preferred way to stop an AyaNova server as pending jobs and notifications will be processed before closing down in a controlled manner.
+
+The alternative is to press ctrl-c at the server console however that type of shutdown is immediate and uncontrolled and not recommended in production use.
+
+**Warning**: The server can _not_ be _started_ remotely via the web app, only shut down.

server/AyaNova/ControllerHelpers/ApiServerState.cs

@@ -185,7 +185,7 @@ namespace AyaNova.Api.ControllerHelpers
         {
             get
             {
-                return _currentState != ServerState.Closed && !SYSTEM_LOCK;
+                return _currentState != ServerState.Closed && _currentState != ServerState.OpsOnly && !SYSTEM_LOCK ;
             }
         }