Return to config.frag CVS log

Up to [LON-CAPA] / doc / build

Annotation of doc/build/config.frag, revision 1.1

1.1     ! bowersj2    1: <p>
        !             2: There are about a dozen files on the LON-CAPA server systems
        !             3: which the system administrator may need to adjust.
        !             4: </p>
        !             5: <p>
        !             6: The two most important configuration files are:
        !             7: </p>
        !             8: <ul>
        !             9: <li><strong>loncapa.conf</strong> -
        !            10: typically located in the directory <tt>/etc/httpd/conf/</tt>;
        !            11: <br /><i>contains machine-specific and institution-specific
        !            12: variables and modifications necessary for
        !            13: the effective running of the Apache web server;
        !            14: note that there is also a <strong>loncapa_apache.conf</strong>
        !            15: which should be installed, but not modified</i>
        !            16: <br />&nbsp;
        !            17: </li>
        !            18: <li><strong>hosts.tab</strong> -
        !            19: typically located in the directory <tt>/home/httpd/lonTabs/</tt>;
        !            20: <br /><i>is a listing of all other internet machines that a server
        !            21: system considers to be valid server systems on the LON-CAPA
        !            22: network</i>
        !            23: <br />&nbsp;
        !            24: </li>
        !            25: </ul>
        !            26: <!-- preamble end -->
        !            27: <!-- maintext start -->
        !            28: <h3>Current Reconfiguration Procedure</h3>
        !            29: <p>
        !            30: After making any configuration change, you will need to restart system
        !            31: services.  The two most important system services on a LON-CAPA system are
        !            32: <strong>loncapa</strong> and <strong>httpd</strong>.  Here are the
        !            33: commands for restarting the system services:
        !            34: </p>
        !            35: <table bgcolor="#aaaaaa" border="1"><tr><td>
        !            36: <tt>/etc/rc.d/init.d/loncapa restart</tt>
        !            37: <br /><tt>/etc/rc.d/init.d/httpd restart</tt>
        !            38: </td></tr></table>
        !            39: <p>
        !            40: We recommend that a knowledgeable system administrator should
        !            41: perform any adjustments on a LON-CAPA server machine.
        !            42: Locations of these files are by default.  Depending on your
        !            43: Linux distribution--RedHat, Mandrake, Debian, etc, the file paths
        !            44: may be elsewhere.
        !            45: </p>
        !            46: <h3>Configuration files that will have to be altered</h3>
        !            47: <p>
        !            48: LON-CAPA currently depends on the following list of configuration
        !            49: files.  Note that <tt>loncapa.conf</tt> is automatically
        !            50: altered by the installation/upgrade scripts associated with
        !            51: the tarball-distribution (see the <b>INSTALL</b> and <b>UPGRADE</b>
        !            52: sections of this web-site).  (Thus, the system administrator should
        !            53: not have to further adjust <tt>loncapa.conf</tt> from the terminal.)
        !            54: </p>
        !            55: <ul>
        !            56: <li><a href="confexamples/loncapa.conf">[EXAMPLE]</a>
        !            57: /etc/httpd/conf/loncapa.conf</li>
        !            58: <li><a href="confexamples/hosts.tab">[EXAMPLE]</a>
        !            59: /home/httpd/lonTabs/hosts.tab</li>
        !            60: <li><a href="confexamples/spare.tab">[EXAMPLE]</a>
        !            61: /home/httpd/lonTabs/spare.tab</li>
        !            62: <li><a href="confexamples/krb.conf">[EXAMPLE]</a> /etc/krb.conf</li>
        !            63: <li><a href="confexamples/htpasswd">[EXAMPLE]</a>
        !            64: /home/httpd/lonTabs/htpasswd</li>
        !            65: <li><a href="confexamples/ntp.conf">[EXAMPLE]</a> /etc/ntp.conf</li>
        !            66: <li><a href="confexamples/step-tickers">[EXAMPLE]</a>
        !            67: /etc/ntp/step-tickers</li>
        !            68: <li><a href="confexamples/pwauth">[EXAMPLE]</a> /etc/pam.d/pwauth</li>
        !            69: </ul>
        !            70: <h3>Configuration files that do not have to be altered</h3>
        !            71: <p>
        !            72: The following configuration files are critical for the correct
        !            73: performance of a LON-CAPA server machine.  Typically, these configuration
        !            74: files do not need to be adjusted by the system administrator.
        !            75: </p>
        !            76: <ul>
        !            77: <li><a href="confexamples/loncapa_apache.conf">[EXAMPLE]</a>
        !            78: /etc/httpd/conf/loncapa_apache.conf</li>
        !            79: <li><a href="confexamples/un_keyword.tab">[EXAMPLE]</a>
        !            80: /home/httpd/html/res/adm/includes/un_keyword.tab</li>
        !            81: </ul>
        !            82: 
        !            83: <h3>Configuring Secondary Services</h3>
        !            84: <p>
        !            85: LON-CAPA does not provide integrated support for secondary services.
        !            86: The expectation is that knowledgeable system administrators will
        !            87: customize these secondary services for their institution.
        !            88: </p>
        !            89: <p>
        !            90: We do, however, provide example configurations of services that you
        !            91: may want to deliver with LON-CAPA (i.e. Samba and AppleChooser).
        !            92: </p>
        !            93: <ul>
        !            94: <li><a href="confexamples/smb.conf">[EXAMPLE]</a> /etc/smb.conf</li>
        !            95: <li><a href="confexamples/config">[EXAMPLE]</a> /etc/atalk/config</li>
        !            96: </ul>