File:  [LON-CAPA] / doc / build / config.frag
Revision 1.2: download - view: text, annotated - select for diffs
Wed Oct 8 17:04:20 2003 UTC (19 years, 1 month ago) by albertel
Branches: MAIN
CVS tags: version_2_9_X, version_2_9_99_0, version_2_9_1, version_2_9_0, version_2_8_X, version_2_8_99_1, version_2_8_99_0, version_2_8_2, version_2_8_1, version_2_8_0, version_2_7_X, version_2_7_99_1, version_2_7_99_0, version_2_7_1, version_2_7_0, version_2_6_X, version_2_6_99_1, version_2_6_99_0, version_2_6_3, version_2_6_2, version_2_6_1, version_2_6_0, version_2_5_X, version_2_5_99_1, version_2_5_99_0, version_2_5_2, version_2_5_1, version_2_5_0, version_2_4_X, version_2_4_99_0, version_2_4_2, version_2_4_1, version_2_4_0, version_2_3_X, version_2_3_99_0, version_2_3_2, version_2_3_1, version_2_3_0, version_2_2_X, version_2_2_99_1, version_2_2_99_0, version_2_2_2, version_2_2_1, version_2_2_0, version_2_1_X, version_2_1_99_3, version_2_1_99_2, version_2_1_99_1, version_2_1_99_0, version_2_1_3, version_2_1_2, version_2_1_1, version_2_1_0, version_2_12_X, version_2_11_X, 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, version_2_11_0_RC3, version_2_11_0_RC2, version_2_11_0_RC1, version_2_11_0, version_2_10_X, version_2_10_1, version_2_10_0_RC2, version_2_10_0_RC1, version_2_10_0, version_2_0_X, version_2_0_99_1, version_2_0_2, version_2_0_1, version_2_0_0, version_1_99_3, version_1_99_2, version_1_99_1_tmcc, version_1_99_1, version_1_99_0_tmcc, version_1_99_0, version_1_3_X, version_1_3_3, version_1_3_2, version_1_3_1, version_1_3_0, version_1_2_X, version_1_2_99_1, version_1_2_99_0, version_1_2_1, version_1_2_0, version_1_1_X, version_1_1_99_5, version_1_1_99_4, version_1_1_99_3, version_1_1_99_2, version_1_1_99_1, version_1_1_99_0, version_1_1_3, version_1_1_2, version_1_1_1, version_1_1_0, version_1_0_99_3, version_1_0_99_2, version_1_0_99_1, version_1_0_99, loncapaMITrelate_1, language_hyphenation_merge, language_hyphenation, bz6209-base, bz6209, HEAD, GCI_3, GCI_2, GCI_1, BZ4492-merge, BZ4492-feature_horizontal_radioresponse, BZ4492-feature_Support_horizontal_radioresponse, BZ4492-Support_horizontal_radioresponse
- more BUG#1922

<p>
There are about a dozen files on the LON-CAPA server systems
which the system administrator may need to adjust.
</p>
<p>
The two most important configuration files are:
</p>
<ul>
<li><strong>loncapa.conf</strong> -
typically located in the directory <tt>/etc/httpd/conf/</tt>;
<br /><i>contains machine-specific and institution-specific
variables and modifications necessary for
the effective running of the Apache web server;
note that there is also a <strong>loncapa_apache.conf</strong>
which should be installed, but not modified</i>
<br />&nbsp;
</li>
<li><strong>hosts.tab</strong> -
typically located in the directory <tt>/home/httpd/lonTabs/</tt>;
<br /><i>is a listing of all other internet machines that a server
system considers to be valid server systems on the LON-CAPA
network</i>
<br />&nbsp;
</li>
</ul>
<!-- preamble end -->
<!-- maintext start -->
<h3>Current Reconfiguration Procedure</h3>
<p>
After making any configuration change, you will need to restart system
services.  The two most important system services on a LON-CAPA system are
<strong>loncapa</strong> and <strong>httpd</strong>.  Here are the
commands for restarting the system services:
</p>
<table bgcolor="#aaaaaa" border="1"><tr><td>
<tt>/etc/rc.d/init.d/loncapa restart</tt>
<br /><tt>/etc/rc.d/init.d/httpd restart</tt>
</td></tr></table>
<p>
We recommend that a knowledgeable system administrator should
perform any adjustments on a LON-CAPA server machine.
Locations of these files are by default.  Depending on your
Linux distribution--RedHat, Mandrake, Debian, etc, the file paths
may be elsewhere.
</p>
<h3>Configuration files that will have to be altered</h3>
<p>
LON-CAPA currently depends on the following list of configuration
files.  Note that <tt>loncapa.conf</tt> is automatically
altered by the installation/upgrade scripts associated with
the tarball-distribution (see the <b>INSTALL</b> and <b>UPGRADE</b>
sections of this web-site).  (Thus, the system administrator should
not have to further adjust <tt>loncapa.conf</tt> from the terminal.)
</p>
<ul>
<li><a href="confexamples/loncapa.conf">[EXAMPLE]</a>
/etc/httpd/conf/loncapa.conf</li>
<li><a href="confexamples/hosts.tab">[EXAMPLE]</a>
/home/httpd/lonTabs/hosts.tab</li>
<li><a href="confexamples/domain.tab">[EXAMPLE]</a>
/home/httpd/lonTabs/domain.tab</li>
<li><a href="confexamples/spare.tab">[EXAMPLE]</a>
/home/httpd/lonTabs/spare.tab</li>
<li><a href="confexamples/krb.conf">[EXAMPLE]</a> /etc/krb.conf</li>
<li><a href="confexamples/htpasswd">[EXAMPLE]</a>
/home/httpd/lonTabs/htpasswd</li>
<li><a href="confexamples/ntp.conf">[EXAMPLE]</a> /etc/ntp.conf</li>
<li><a href="confexamples/step-tickers">[EXAMPLE]</a>
/etc/ntp/step-tickers</li>
<li><a href="confexamples/pwauth">[EXAMPLE]</a> /etc/pam.d/pwauth</li>
</ul>
<h3>Configuration files that do not have to be altered</h3>
<p>
The following configuration files are critical for the correct
performance of a LON-CAPA server machine.  Typically, these configuration
files do not need to be adjusted by the system administrator.
</p>
<ul>
<li><a href="confexamples/loncapa_apache.conf">[EXAMPLE]</a>
/etc/httpd/conf/loncapa_apache.conf</li>
<li><a href="confexamples/un_keyword.tab">[EXAMPLE]</a>
/home/httpd/html/res/adm/includes/un_keyword.tab</li>
</ul>

<h3>Configuring Secondary Services</h3>
<p>
LON-CAPA does not provide integrated support for secondary services.
The expectation is that knowledgeable system administrators will
customize these secondary services for their institution.
</p>
<p>
We do, however, provide example configurations of services that you
may want to deliver with LON-CAPA (i.e. Samba and AppleChooser).
</p>
<ul>
<li><a href="confexamples/smb.conf">[EXAMPLE]</a> /etc/smb.conf</li>
<li><a href="confexamples/config">[EXAMPLE]</a> /etc/atalk/config</li>
</ul>

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