Annotation of doc/build/loncapanetwork.html, revision 1.1

1.1     ! harris41    1: <HTML>
        !             2: <HEAD>
        !             3: <TITLE>LON-CAPA Network Processes Documentation</TITLE>
        !             4: </HEAD>
        !             5: <BODY>
        !             6: <H1>LON-CAPA Network Processes Documentation</H1>
        !             7: <P>
        !             8: Scott Harrison
        !             9: </P>
        !            10: <P>
        !            11: Last updated: 10/26/2000
        !            12: </P>
        !            13: <H3>Introduction</H3>
        !            14: <P>
        !            15: This file describes issues associated with the basic network
        !            16: layer of the LON-CAPA system.  When upgrading, installing, or reconfiguring a LON-CAPA system,
        !            17: it is often necessary to stop and start the network processes so that the code
        !            18: they are running with is up-to-date.
        !            19: </P>
        !            20: <P><I>
        !            21: There are also secondary network layers associated with the LON-CAPA system
        !            22: which are discussed elsewhere in the <A HREF="http://install.lon-capa.org/docs/index.html">
        !            23: documentation</A>.  These include NFS, Appleshare, and Samba (Windows Network Neighborhood).
        !            24: </I></P>
        !            25: <P>
        !            26: There are two basic levels of client-server processes associated with
        !            27: implementing the LON-CAPA network.
        !            28: <OL>
        !            29: <LI><B>Web level</B>: LON-CAPA users communicate with the system through their web browser
        !            30: <LI><B>Server-to-server level</B>: LON-CAPA machines communicate with other LON-CAPA machines
        !            31: </OL>
        !            32: </P>
        !            33: <H3>Description</H3>
        !            34: <P>
        !            35: The web level is implemented through a web server.  LON-CAPA uses the Apache web server.
        !            36: The apache web server forks off daemon children (<TT>httpd</TT>) which handle client requests
        !            37: (http requests from web browsers on the internet).  The more http requests, the more daemon children are
        !            38: made available.
        !            39: </P>
        !            40: <P>
        !            41: LON-CAPA functionality is enabled in the web level through the use of mod_perl.  mod_perl
        !            42: allows perl modules to be compiled once, and reside in memory in order to coordinate the
        !            43: interaction of http requests with services and resources provided by the LON-CAPA server machine.
        !            44: </P>
        !            45: <P>
        !            46: The server-to-server level is implemented through forked system processes which communicate with the
        !            47: TCP/IP protocol.  There are two types of children processes that LON-CAPA server machines maintain.
        !            48: <OL>
        !            49: <LI><TT>lonc</TT>- proxy server processes, these allow a LON-CAPA machine to act as a client toward another machine
        !            50: <LI><TT>lond</TT>- remote command interpreter, these respond to the proxy server processes to allow a LON-CAPA machine
        !            51: to act as a server toward another machine
        !            52: </OL>
        !            53: </P>
        !            54: <P>
        !            55: Of course, it becomes exciting when information passed through the web level requires the server to retrieve
        !            56: data through the server-to-server (TCP/IP) level.  This is handled by a perl module (loaded with mod_perl) that
        !            57: interfaces to <TT>lonc</TT>.  This perl module is <TT>lonnet.pm</TT>.
        !            58: </P>
        !            59: <H3>Managing Network Processes the Normal Way (/etc/rc.d/init.d)</H3>
        !            60: <P>
        !            61: <BR>Log in as <TT>root</TT>.  
        !            62: <BR>To stop the web level: <TT>/etc/rc.d/init.d/httpd stop</TT>
        !            63: <BR>To start the web level: <TT>/etc/rc.d/init.d/httpd start</TT>
        !            64: <BR>To restart the web level: <TT>/etc/rc.d/init.d/httpd restart</TT>
        !            65: <BR>To look at the status of the web level: <TT>/etc/rc.d/init.d/httpd status</TT>
        !            66: <BR>To stop the server-to-server and web level: <TT>/etc/rc.d/init.d/loncontrol stop</TT>
        !            67: <BR>To start the server-to-server and web level: <TT>/etc/rc.d/init.d/loncontrol start</TT>
        !            68: <BR>To restart the server-to-server and web level: <TT>/etc/rc.d/init.d/loncontrol restart</TT>
        !            69: <BR>To look at the status of the server-to-server and web level: <TT>/etc/rc.d/init.d/loncontrol status</TT>
        !            70: </P>
        !            71: <H3>Managing Network Processes the Dirty Way (killing pids directly)</H3>
        !            72: <P>
        !            73: <FONT SIZE=+3>Log in as <TT>www</TT></FONT>.  <B>Do not enter these commands as root</B>.
        !            74: <BR>To stop the server-to-server level: <TT>kill `cat /home/httpd/perl/logs/*.pid`</TT>
        !            75: <BR>To start the server-to-server level: <TT>/home/httpd/perl/loncron</TT>
        !            76: <BR>To restart the server-to-server level: <TT>kill `cat /home/httpd/perl/logs/*.pid`; /home/httpd/perl/loncron</TT>
        !            77: <BR>To look at the status of the server-to-server level: <TT>ps auxwww | grep lonc; ps auxwww | grep lond</TT>
        !            78: </P>
        !            79: </BODY>
        !            80: </HTML>

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