doc/build/fedora_install.frag - diff

Return to fedora_install.frag CVS log

Up to [LON-CAPA] / doc / build

Diff for /doc/build/fedora_install.frag between versions 1.3 and 1.11

version 1.3, 2004/03/17 18:49:45	version 1.11, 2004/07/15 14:35:38
Line 1	Line 1
<h1>Installing LON-CAPA on a Fedora Linux System</h1>	<h1>Installing LON-CAPA on a Fedora Core 2 Linux System</h1>
<p>	<p>
This document guides you through the process of setting up a new LON-CAPA	This document guides you through the process of setting up a new LON-CAPA
server running Fedora Linux. The computer will be configured solely as	server running Fedora Core 2 (FC2). The computer will be configured solely as
a LON-CAPA server and will be expected to have no other services running	a LON-CAPA server and will be expected to have no other services running
on it.	on it.
</p><p>	</p><p>
Line 27 The installation process takes the follo	Line 27 The installation process takes the follo
<li> Obtain Fedora Linux </li>	<li> Obtain Fedora Linux </li>
<li> Determine Network Settings</li>	<li> Determine Network Settings</li>
<li> Install Fedora </li>	<li> Install Fedora </li>
	<li> Uninstall the http server </li>
<li> Install LON-CAPA Dependencies </li>	<li> Install LON-CAPA Dependencies </li>
<li> Determine your LON-CAPA Settings </li>	<li> Determine your LON-CAPA Settings </li>
<li> Install LON-CAPA </li>	<li> Install LON-CAPA </li>
Line 57 DHCP is <em>not</em> supported.	Line 58 DHCP is <em>not</em> supported.
<li>domain name server(s) </li>	<li>domain name server(s) </li>
</ul>	</ul>

<h2>Gather needed information</h2>



<h2>Install Fedora</h2>	<h2>Install Fedora</h2>
<p>	<p>
Installing Fedora is quite easy if you've installed any of the Red Hat products	Installing Fedora is quite easy if you've installed any of the Red Hat products
Line 101 There are a few sections that require co	Line 98 There are a few sections that require co
<li>Editors</li>	<li>Editors</li>
<li>Text Based Internet</li>	<li>Text Based Internet</li>
<li>Authoring and Publishing</li>	<li>Authoring and Publishing</li>
<li>Development Tools	<li>Server Configuration Tools</li>
<li>Administration Tools	<li>Development Tools</li>
<li>Printing Support	<li>Administration Tools</li>
	<li>Printing Support</li>
</ul>	</ul>
</dd>	</dd>
</dl>	</dl>
Line 132 tar xf fedora_install.tar	Line 130 tar xf fedora_install.tar
This creates a directory named <tt>installation</tt>.	This creates a directory named <tt>installation</tt>.
</p>	</p>

	<h2>Uninstall the http server</h2>
	<p>
	Fedora Core 2 installs the http server even if you have not chosen it in
	the package selection part of the install. LON-CAPA will not work with this
	web server installed. It must be removed.
	Use the following commands to remove the http and mod_perl packages if they
	exist: (<b>Note:</b>
	<i>The commands below use backticks, not single quotes.</i>:
	</p>
	<p>
	<pre>
	rpm -e `rpm -q -a \| grep mod_perl`
	rpm -e `rpm -q -a \| grep httpd`
	</pre>
	</p><p>
	If the above commands returns no output (the usual indicator of success), or an
	error message 'rpm: no packages given for erase' (meaning there were no
	packages that contain httpd or mod_perl), you are good to go.
	</p>

<h2>Installing LON-CAPA Dependencies</h2>	<h2>Installing LON-CAPA Dependencies</h2>
<p>	<p>
This section walks you through installing the packages which LON-CAPA requires.	This section walks you through installing the packages which LON-CAPA requires.
There are a lot of dependencies. They have been grouped in a	There are a lot of dependencies. They have been grouped in a
somewhat logical fashion to make them easier to deal with. When installing	somewhat logical fashion to make them easier to deal with. When installing
the rpms you should watch for errors.	the rpms you should watch for errors. Errors generated by RPMs which are
</p><p>	already should not be considered a problem, although you will have to ensure
The quick instructions are:	the other rpms in the directory get installed.
	</p>

	<p>
	To install the many LON-CAPA dependencies, execute the following commands:
</p>	</p>
<pre>	<pre>
cd installation	cd installation
Line 154 rpm -Uvh *rpm	Line 176 rpm -Uvh *rpm
cd ../GD	cd ../GD
rpm -Uvh *rpm	rpm -Uvh *rpm
cd ../gnuplot	cd ../gnuplot
rpm --install --oldpackage readline-2.2.1-6.i386.rpm	rpm -Uvh *rpm
rpm --install --oldpackage --excludedocs libpng-1.0.12-2.i386.rpm
rpm -Uvh gnuplot-3.7.1-5.i386.rpm libgd-1.3-4.i386.rpm ncurses4-5.0-5.i386.rpm
cd ../misc	cd ../misc
rpm -Uvh *rpm	rpm -Uvh *rpm
cd ..	cd ..
Line 168 cd ..	Line 188 cd ..
Administering LON-CAPA machines does not yet mean becoming a	Administering LON-CAPA machines does not yet mean becoming a
database administrator.</li>	database administrator.</li>
<li>Apache 1.3 and mod_perl 1.x are required by LON-CAPA. These are	<li>Apache 1.3 and mod_perl 1.x are required by LON-CAPA. These are
provided in the installation package.	provided in the installation package. The mod_perl package has been
<li>A specific version of Gnuplot is required by LON-CAPA. Do not	repackaged from the Redhat sources with the name 'mod_perl_1' in
install a version different from the one included in the LON-CAPA	order to prevent version 1.99 of mod_perl from being installed by
installation package.</li>	yum or other package managers.</li>
</ul>	</ul>
</p>	</p>

Line 228 for it to function at all. Below is a l	Line 248 for it to function at all. Below is a l
To configure and install LON-CAPA, execute the following commands:	To configure and install LON-CAPA, execute the following commands:
</p>	</p>
<pre>	<pre>
cd /root/loncapa-N.N (N.N should correspond to a version number like '1.1')	cd /root/loncapa-N.N (N.N should correspond to a version number like '1.2')
./UPDATE	./UPDATE
</pre>	</pre>
<p>	<p>
Line 250 appropriate user name and your domain.	Line 270 appropriate user name and your domain.
cd /root/loncapa-N.N/loncom/build	cd /root/loncapa-N.N/loncom/build
perl make_domain_coordinator.pl USERNAME DOMAIN	perl make_domain_coordinator.pl USERNAME DOMAIN
(WILL PROMPT FOR PASSWORD HERE)	(WILL PROMPT FOR PASSWORD HERE)
	mkdir ~USERNAME/public_html
	chown USERNAME:www ~USERNAME/public_html
	chmod 0775 ~USERNAME/public_html
	chmod a+x ~USERNAME
</pre>	</pre>

<h2>Start/Restart Services</h2>	<h2>Start/Restart Services</h2>
Line 261 will be appearant at this step.	Line 285 will be appearant at this step.
/etc/init.d/loncontrol start	/etc/init.d/loncontrol start
/etc/init.d/httpd start	/etc/init.d/httpd start
</pre>	</pre>
	<p>
	If you receive warnings when starting the httpd about missing perl modules,
	please make sure you followed the instructions in
	<b>Installing LON-CAPA Dependencies</b>. If you still have errors, please
	contact the LON-CAPA development team.
	</p>
<h2>Log in to your LON-CAPA Machine</h2>	<h2>Log in to your LON-CAPA Machine</h2>
<p>	<p>
Point a web browser at your new machine and log in as the domain	Point a web browser at your new machine and log in as the domain
coordinator. Congratulations!	coordinator. Congratulations!
</p>	</p>

	<h2>If Things aren't working right</h2>
	<p>
	If you've followed the steps above and the server doesn't start or you think
	there's something wrong, please get in touch with the LON-CAPA developers.
	If there were errors in installation of the dependency RPMs or during the
	automatic setup, please send us as much information as possible.
	If some part of this document is unclear please let us know.
	</p>

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

Removed from v.1.3
changed lines
	Added in v.1.11