Return to config.frag CVS log

Up to [LON-CAPA] / doc / build

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

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>
1.2     ! albertel   60: <li><a href="confexamples/domain.tab">[EXAMPLE]</a>
        !            61: /home/httpd/lonTabs/domain.tab</li>
1.1       bowersj2   62: <li><a href="confexamples/spare.tab">[EXAMPLE]</a>
                     63: /home/httpd/lonTabs/spare.tab</li>
                     64: <li><a href="confexamples/krb.conf">[EXAMPLE]</a> /etc/krb.conf</li>
                     65: <li><a href="confexamples/htpasswd">[EXAMPLE]</a>
                     66: /home/httpd/lonTabs/htpasswd</li>
                     67: <li><a href="confexamples/ntp.conf">[EXAMPLE]</a> /etc/ntp.conf</li>
                     68: <li><a href="confexamples/step-tickers">[EXAMPLE]</a>
                     69: /etc/ntp/step-tickers</li>
                     70: <li><a href="confexamples/pwauth">[EXAMPLE]</a> /etc/pam.d/pwauth</li>
                     71: </ul>
                     72: <h3>Configuration files that do not have to be altered</h3>
                     73: <p>
                     74: The following configuration files are critical for the correct
                     75: performance of a LON-CAPA server machine.  Typically, these configuration
                     76: files do not need to be adjusted by the system administrator.
                     77: </p>
                     78: <ul>
                     79: <li><a href="confexamples/loncapa_apache.conf">[EXAMPLE]</a>
                     80: /etc/httpd/conf/loncapa_apache.conf</li>
                     81: <li><a href="confexamples/un_keyword.tab">[EXAMPLE]</a>
                     82: /home/httpd/html/res/adm/includes/un_keyword.tab</li>
                     83: </ul>
                     84: 
                     85: <h3>Configuring Secondary Services</h3>
                     86: <p>
                     87: LON-CAPA does not provide integrated support for secondary services.
                     88: The expectation is that knowledgeable system administrators will
                     89: customize these secondary services for their institution.
                     90: </p>
                     91: <p>
                     92: We do, however, provide example configurations of services that you
                     93: may want to deliver with LON-CAPA (i.e. Samba and AppleChooser).
                     94: </p>
                     95: <ul>
                     96: <li><a href="confexamples/smb.conf">[EXAMPLE]</a> /etc/smb.conf</li>
                     97: <li><a href="confexamples/config">[EXAMPLE]</a> /etc/atalk/config</li>
                     98: </ul>