Annotation of loncom/html/adm/help/tex/Domain_Configuration_Server_Status.tex, revision 1.4

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.3       raeburn    12: \item There are eleven 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.3       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 from 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
1.3       raeburn    24: the domain's configuration.db GDBM file).
1.2       raeburn    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.4     ! raeburn    27: \item Course/Community Catalog with enrollment data - Detailed report, including current, future and/or past enrollment for each course, and totals for all courses (with choice of courses to display filtered by categories).
1.1       raeburn    28: \end{itemize}
                     29: 
1.2       raeburn    30: \item There are five pages which can be used to perform server actions:
1.1       raeburn    31: 
                     32: \begin{itemize}
                     33: \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.
                     34: \item Offline: replace Log-in page - replace the standard LON-CAPA index.html page at the
                     35: 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.  
                     36: \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
                     37: requestor's browser has an unexpired LON-CAPA session cookie).
1.2       raeburn    38: \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.
                     39: \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    40: \end{itemize}
                     41: 
                     42: \item There are two pages which can be used to display Metadata keyword information for searches in the domain.
                     43: 
                     44: \begin{itemize}
                     45: \item Display Metadata Keywords
                     46: \item Harvest Metadata Searches
                     47: \end{itemize}
                     48: 
                     49: \end{itemize}
                     50: 
                     51: 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. 
                     52: 

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>