Annotation of loncom/html/adm/help/tex/Domain_Configuration_Server_Status.tex, revision 1.2
1.1 raeburn 1: \label{Domain_Configuration_Server_Status}
2: Access to pages which provide server status information for LON-CAPA servers
3: in a domain is controlled by a Domain Coordinator. When a user who has a Domain
4: Coordinator role is logged into LON-CAPA, the user automatically has access to
5: server status pages. Access can also be granted to other users by either (a)
6: specifying username:domain, or (b) specifying IP addresses for the clients from
7: which access will be made. In the case of IP-based access there is no need for
8: the user to be logged into LON-CAPA or even have a LON-CAPA user account.
9:
10: \begin{itemize}
11:
1.2 ! raeburn 12: \item There are ten server status pages:
1.1 raeburn 13:
14: \begin{itemize}
15: \item User Status Summary - information about User Sessions which have been hosted on the server since the last nightly clean-up of lonIDs for stale sessions, and where the user has not logged out. Sessions are classified into: Active, Moderately Active and Inactive.
16: \item Detailed Report - information saved by the nightly run of loncron which checks
17: connections to other servers in the cluster, and includes excerpts from various logs, as well as machine information.
18: \item Apache Status Page - information from the Apache web server about its current status
19: \item LON-CAPA Module Versions - a list of currently installed LON-CAPA perl modules, including version information.
1.2 ! raeburn 20: \item LON-CAPA Module Checking - the results of comparison of version number and checksum for installed LON-CAPA modules, with expected values for the LON-CAPA version (from a data file for the specific release number, available form any of the LON-CAPA Academic Consortium servers).
1.1 raeburn 21: \item Domain status - information about the status of LON-CAPA daemons for servers in the domain.
22: \item Show user environment - Information about the current user's session environment.
1.2 ! raeburn 23: \item Text Display of Domain Configuration - Information about the domain's configuration (essentially a dump of
! 24: the domain's cnfiguration.db GDBM file).
! 25: \item Six-character Course Codes - a listing of course information and codes, for courses for which a six character code has been assigned.
! 26: \item Course/Community Disk Usage - Quota (MB) allocated for content uploaded directly to each course, usage in MB and percent (with choice of courses to display filtered by standard course picker).
1.1 raeburn 27: \end{itemize}
28:
1.2 ! raeburn 29: \item There are five pages which can be used to perform server actions:
1.1 raeburn 30:
31: \begin{itemize}
32: \item Generate Detailed Report - run the loncron command which checks connection to other servers and creates a new version of the detailed server status report.
33: \item Offline: replace Log-in page - replace the standard LON-CAPA index.html page at the
34: Document Root with a temporary page announcing unavailability of LON-CAPA service on that particular server. It is strongly recommended that access to the corresponding ``Online - restore Log-in'' page is set to allow access from your IP address so that you can visit that page to re-enable the standard index.html page (e.g., when maintenance is complete) if you use the Offline page to replace it.
35: \item Online: restore Log-in page - replace the temporary index.html page with the standard index.html (which redirects to /adm/roles -- which will display the log-in page unless the
36: requestor's browser has an unexpired LON-CAPA session cookie).
1.2 ! raeburn 37: \item Toggle debug messages - set which users will have access to a link on the user preferences page to enable/disable display of debug output on screen when rendering a LON-CAPA resource. Note: Domain Coordinators automatically receive the toggle debug link, regardless of settings on the server status page.
! 38: \item Cause server to ping another server - cause the server to attempt to initiate a connection to another LON-CAPA server in the cluster.
1.1 raeburn 39: \end{itemize}
40:
41: \item There are two pages which can be used to display Metadata keyword information for searches in the domain.
42:
43: \begin{itemize}
44: \item Display Metadata Keywords
45: \item Harvest Metadata Searches
46: \end{itemize}
47:
48: \end{itemize}
49:
50: One final setting is for ``Toggle debug messages''. This controls whether a user's ``Set my user preferences'' page will include a ``Toggle Debug Messages'' link which can be used to set display of debugging messages in LON-CAPA either on or off.
51:
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>