File:
[LON-CAPA] /
doc /
install /
fedora /
single_file_install.html
Revision
1.3:
download - view:
text,
annotated -
select for diffs
Fri Feb 11 17:42:59 2005 UTC (19 years, 6 months ago) by
matthew
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_5,
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,
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
Added a bit about copying the loncapa_yum.conf file to /etc.
1: <html>
2: <head><title>New installation instructions</title></head>
3: <body>
4: <!-- $Id: single_file_install.html,v 1.3 2005/02/11 17:42:59 matthew Exp $-->
5: <h1>Installing LON-CAPA on a Fedora Core 3 Linux System</h1>
6: <p>
7: This document guides you through the process of installing LON-CAPA on a
8: Fedora Core 3 (FC3) system. Information about Fedora is available from
9: <a href="http://fedora.redhat.com/">http://fedora.redhat.com/</a>.
10: More information about LON-CAPA is available from
11: <a href="http://www.loncapa.org">http://www.loncapa.org</a> and
12: <a href="http://install.loncapa.org">http://install.loncapa.org</a>.
13: </p><p>
14: These instructions assume you have installed Fedora Core 3 on your system
15: and it is running properly. All of the LON-CAPA data is stored in
16: /home/httpd. MySQL is used to store temporary caches of system data, by
17: default this uses storage space in /var/lib/mysql. You will want to be sure
18: you have enough disk space for these two partitions.
19: </p><p>
20: Please keep your system up to date. By default, LON-CAPA will add its
21: own repository to your /etc/yum.conf file. Additionally, yum will be run
22: every morning to determine if there are any packages which need to be
23: upgraded. If there are, an email will be sent to the server administrator
24: (specified in the LON-CAPA installation). It behooves you to keep your
25: system up to date.
26: </p>
27:
28: <h2>Installation Overview</h2>
29: <p>
30: The installation must be done as root.
31: </p><p>
32: The installation process takes the following steps:
33: </p>
34: <ol>
35: <li> Install LON-CAPA yum.conf </li>
36: <li> Install LON-CAPA </li>
37: <li> Create a Domain Coordinator </li>
38: <li> Start/Restart services </li>
39: <li> Log in to LON-CAPA </li>
40: </ol>
41:
42: <h2>Install LON-CAPA yum.conf</h2>
43: <p>
44: You will need to copy the loncapa_yum.conf file over the default yum.conf
45: file.
46: <pre>
47: mv /etc/yum.conf /etc/yum.conf.backup
48: cp loncapa_yum.conf /etc/yum.conf
49: </pre>
50: </p>
51: <h2>Install LON-CAPA</h2>
52: <h3>Remove conflicting packages</h3>
53: <p>
54: You will need to remove the following packages which conflict with LON-CAPA.
55: <ul>
56: <li> httpd
57: <li> php
58: <li> mod_throttle
59: <li> mod_bandwidth
60: <li> mod_perl
61: </ul>
62: List the packages you have installed that match by executing:
63: <pre>
64: rpm -q -f | grep PACKAGENAME
65: </pre>
66: You can remove the packages individually using
67: <pre>
68: rpm -e PACKAGENAME
69: </pre>
70: You will need to remove all of the packages which depend on the ones you are
71: removing.
72: You can remove the associated packages en mass if you are satisfied the prior
73: command selected all the appropriate packages:
74: <pre>
75: rpm -q -a | grep PACKAGENAME | rpm -e
76: </pre>
77: </p>
78:
79: <h3>Install prerequisites</h3>
80: <p>
81: We have provided many of the packages needed for LON-CAPA in the installation
82: bundle. They reside in the prerequisites directory. You will need to install them using the following commands:
83: <pre>
84: cd prerequisites
85: rpm -Uvh *rpm
86: </pre>
87: You will need to resolve any errors this process generated. For packages that are already installed you can simply remove them from the directory:
88: <pre>
89: mv CONFLICTINPACKAGE*.rpm ..
90: </pre>
91: And try the installation command again. If there are required packages which
92: have not been installed, these should be found on your Fedora Core 3 installation CDs.
93: </p>
94:
95: <h3>Determine LON-CAPA Settings</h3>
96: <p>
97: LON-CAPA requires a number of identifying parameters be set in order
98: for it to function at all. Below is a list with descriptions.
99: </p>
100: <dl>
101: <dt>Host Type (library or access)</dt>
102: <dd>The server must be designated a 'library' or an 'access' server. In
103: general you should have a library server for your instructors to create
104: their course content on and run their courses. Students should connect
105: to access servers. If you are doing the first install of LON-CAPA at
106: your site, or if you are playing with it for your own edification you
107: should make your machine a 'library' server.</dd>
108: <dt>LON-CAPA domain</dt>
109: <dd>Each site or school which installs LON-CAPA needs its own domain.
110: Here at MSU we use 'msu'. You should choose something short but
111: meaningful. <i>Restriction: One word, no hyphens, underscores, or
112: special characters.</i>
113: </dd>
114: <dt>LON-CAPA host id</dt>
115: <dd>Each LON-CAPA server requires a unique internal name. We use names
116: such as "msul1" for the first library server. <i>Restriction: One word,
117: no hyphens, underscores, or special characters.</i>
118: </dd>
119: <dt>Host administrator email</dt>
120: <dd>The amount of email sent to this address is relatively minimal. Messages
121: are sent every time the system starts up, or if the system is in
122: serious trouble. On a laptop, make this <tt>root@localhost</tt>.
123: </dd>
124: </dl>
125:
126: <h3>Install and Configuring LON-CAPA</h3>
127: <p>
128: To configure and install LON-CAPA, execute the following commands:
129: </p>
130: <pre>
131: cd ~/loncapa_install/
132: ./install.pl
133: </pre>
134: You will need to enter a root password for MySQL. Once this is complete
135: you will need to execute:
136: <pre>
137: cd /root/loncapa-1.3.2
138: ./UPDATE
139: </pre>
140: <p>
141: You will need to enter the LON-CAPA configuration information you determined
142: in the previous section.
143: </p>
144:
145: <h2>Creating a Domain Coordinator</h2>
146: <p>
147: You will need at least one user at your site who has the role of
148: 'domain coordinator'. This user creates accounts for other users and
149: grants them additional privileges. The make_domain_coordinator.pl script
150: invoked below requires that you enter the users password. The password will
151: show in plaintext as you type it. Feel free to use the "passwd username"
152: command to change it later. Replace USERNAME and DOMAIN with an
153: appropriate user name and your domain.
154: </p>
155: <pre>
156: cd /root/loncapa-1.3.2/loncom/build
157: perl make_domain_coordinator.pl USERNAME DOMAIN
158: (WILL PROMPT FOR PASSWORD HERE)
159: mkdir ~USERNAME/public_html
160: chown USERNAME:www ~USERNAME/public_html
161: chmod 0775 ~USERNAME/public_html
162: chmod a+x ~USERNAME
163: </pre>
164:
165: <h2>Start/Restart Services</h2>
166: <p>
167: The LON-CAPA network services take a moment to start. Most misconfigurations
168: will be appearant at this step.
169: </p>
170: <pre>
171: /etc/init.d/loncontrol start
172: /etc/init.d/httpd start
173: </pre>
174: <p>
175: If you receive warnings when starting the httpd about missing perl modules,
176: please make sure you followed the instructions in
177: <b>Installing LON-CAPA Dependencies</b>. If you still have errors, please
178: contact the LON-CAPA development team.
179: </p>
180: <h2>Log in to your LON-CAPA Machine</h2>
181: <p>
182: Point a web browser at your new machine and log in as the domain
183: coordinator. Congratulations!
184: </p>
185:
186: <h2>If Things aren't working right</h2>
187: <p>
188: If you've followed the steps above and the server doesn't start or you think
189: there's something wrong, please get in touch with the LON-CAPA developers.
190: If there were errors in installation of the dependency RPMs or during the
191: automatic setup, please send us as much information as possible.
192: If some part of this document is unclear please let us know.
193: </p>
194:
195: </body>
196: </html>
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>