File:
[LON-CAPA] /
doc /
build /
Attic /
reconfig.html
Revision
1.11:
download - view:
text,
annotated -
select for diffs
Sat Jul 27 23:08:10 2002 UTC (22 years, 1 month ago) by
harris41
Branches:
MAIN
CVS tags:
version_1_0_3,
version_1_0_2,
version_1_0_1,
version_1_0_0,
version_0_99_5,
version_0_99_4,
version_0_99_3,
version_0_99_2,
version_0_99_1,
version_0_99_0,
version_0_6_2,
version_0_6,
version_0_5_1,
version_0_5,
conference_2003,
HEAD
categorizing the different types of configuration files and
discussing how to treat them
1: <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2: "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3: <!-- $Id: reconfig.html,v 1.11 2002/07/27 23:08:10 harris41 Exp $ -->
4: <html>
5: <head>
6: <meta http-equiv="Content-Type" content="text/html; charset=utf-8"></meta>
7: <title>Configuration of a LON-CAPA Server</title>
8: <!-- pdfahref index.pdf -->
9: <!-- button CONFIGURE -->
10: </head>
11: <body bgcolor="#ffffff">
12: <!-- preamble start -->
13: <p>
14: There are about a dozen files on the LON-CAPA server systems
15: which the system administrator may need to adjust.
16: </p>
17: <p>
18: The two most important configuration files are:
19: </p>
20: <ul>
21: <li><strong>loncapa.conf</strong> -
22: typically located in the directory <tt>/etc/httpd/conf/</tt>;
23: <br /><i>contains machine-specific and institution-specific
24: variables and modifications necessary for
25: the effective running of the Apache web server;
26: note that there is also a <strong>loncapa_apache.conf</strong>
27: which should be installed, but not modified</i>
28: <br />
29: </li>
30: <li><strong>hosts.tab</strong> -
31: typically located in the directory <tt>/home/httpd/lonTabs/</tt>;
32: <br /><i>is a listing of all other internet machines that a server
33: system considers to be valid server systems on the LON-CAPA
34: network</i>
35: <br />
36: </li>
37: </ul>
38: <!-- preamble end -->
39: <!-- maintext start -->
40: <h3>Current Reconfiguration Procedure</h3>
41: <p>
42: After making any configuration change, you will need to restart system
43: services. The two most important system services on a LON-CAPA system are
44: <strong>loncapa</strong> and <strong>httpd</strong>. Here are the
45: commands for restarting the system services:
46: </p>
47: <table bgcolor="#aaaaaa" border="1"><tr><td>
48: <tt>/etc/rc.d/init.d/loncapa restart</tt>
49: <br /><tt>/etc/rc.d/init.d/httpd restart</tt>
50: </td></tr></table>
51: <p>
52: We recommend that a knowledgeable system administrator should
53: perform any adjustments on a LON-CAPA server machine.
54: Locations of these files are by default. Depending on your
55: Linux distribution--RedHat, Mandrake, Debian, etc, the file paths
56: may be elsewhere.
57: </p>
58: <h3>Configuration files that will have to be altered</h3>
59: <p>
60: LON-CAPA currently depends on the following list of configuration
61: files. Note that <tt>loncapa.conf</tt> is automatically
62: altered by the installation/upgrade scripts associated with
63: the tarball-distribution (see the <b>INSTALL</b> and <b>UPGRADE</b>
64: sections of this web-site). (Thus, the system administrator should
65: not have to further adjust <tt>loncapa.conf</tt> from the terminal.)
66: </p>
67: <ul>
68: <li><a href="confexamples/loncapa.conf">[EXAMPLE]</a>
69: /etc/httpd/conf/loncapa.conf</li>
70: <li><a href="confexamples/hosts.tab">[EXAMPLE]</a>
71: /home/httpd/lonTabs/hosts.tab</li>
72: <li><a href="confexamples/spare.tab">[EXAMPLE]</a>
73: /home/httpd/lonTabs/spare.tab</li>
74: <li><a href="confexamples/krb.conf">[EXAMPLE]</a> /etc/krb.conf</li>
75: <li><a href="confexamples/htpasswd">[EXAMPLE]</a>
76: /home/httpd/lonTabs/htpasswd</li>
77: <li><a href="confexamples/ntp.conf">[EXAMPLE]</a> /etc/ntp.conf</li>
78: <li><a href="confexamples/step-tickers">[EXAMPLE]</a>
79: /etc/ntp/step-tickers</li>
80: <li><a href="confexamples/pwauth">[EXAMPLE]</a> /etc/pam.d/pwauth</li>
81: </ul>
82: <h3>Configuration files that do not have to be altered</h3>
83: <p>
84: The following configuration files are critical for the correct
85: performance of a LON-CAPA server machine. Typically, these configuration
86: files do not need to be adjusted by the system administrator.
87: </p>
88: <ul>
89: <li><a href="confexamples/loncapa_apache.conf">[EXAMPLE]</a>
90: /etc/httpd/conf/loncapa_apache.conf</li>
91: <li><a href="confexamples/un_keyword.tab">[EXAMPLE]</a>
92: /home/httpd/html/res/adm/includes/un_keyword.tab</li>
93: </ul>
94:
95: <h3>Configuring Secondary Services</h3>
96: <p>
97: LON-CAPA does not provide integrated support for secondary services.
98: The expectation is that knowledgeable system administrators will
99: customize these secondary services for their institution.
100: </p>
101: <p>
102: We do, however, provide example configurations of services that you
103: may want to deliver with LON-CAPA (i.e. Samba and AppleChooser).
104: </p>
105: <ul>
106: <li><a href="confexamples/smb.conf">[EXAMPLE]</a> /etc/smb.conf</li>
107: <li><a href="confexamples/config">[EXAMPLE]</a> /etc/atalk/config</li>
108: </ul>
109: <!-- maintext end -->
110: <!-- validated -->
111: </body>
112: </html>
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>