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