File:  [LON-CAPA] / loncom / html / adm / help / tex / Domain_Configuration_Server_Status.tex
Revision 1.4: download - view: text, annotated - select for diffs
Sat May 30 21:07:41 2015 UTC (9 years, 2 months ago) by raeburn
Branches: MAIN
CVS tags: version_2_12_X, version_2_11_X, version_2_11_5_msu, version_2_11_5, version_2_11_4_uiuc, version_2_11_4_msu, version_2_11_4, version_2_11_3_uiuc, version_2_11_3_msu, version_2_11_3, version_2_11_2_uiuc, version_2_11_2_msu, version_2_11_2_educog, version_2_11_2, version_2_11_1, HEAD
- Document configuration to set access to detailed Course/Community Catalog
  with enrollment data for specific IPs or users.

    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: 
   12: \item There are eleven server status pages: 
   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.
   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). 
   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.
   23: \item Text Display of Domain Configuration - Information about the domain's configuration (essentially a dump of
   24: the domain's configuration.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).
   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).
   28: \end{itemize}
   29: 
   30: \item There are five pages which can be used to perform server actions:
   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).
   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.
   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>