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.1 and 1.13

version 1.1, 2003/12/12 21:31:05	version 1.13, 2004/11/19 21:08:47
Line 1	Line 1
<h1>Installing LON-CAPA on a Fedora Linux System</h1>	<html>
	<head><title>New installation instructions</title></head>
	<body>

	<h1>Installing LON-CAPA on a minimal 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) with a minimum of packages installed.
a LON-CAPA server and will be expected to have no other services running	The computer will be configured solely as a LON-CAPA server and will be
on it.	expected to have no other services running. Your server is expected to have
	a reasonably fast connection to the internet.
</p><p>	</p><p>
More information is available at <a href="http://install.lon-capa.org/">	More information is available at <a href="http://install.lon-capa.org/">
http://install.lon-capa.org/</a>.	http://install.lon-capa.org/</a>.
Line 27 The installation process takes the follo	Line 32 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> Install LON-CAPA Dependencies </li>	<li> Updating your system </li>
<li> Determine your LON-CAPA Settings </li>	<li> Installing LON-CAPA </li>
<li> Install LON-CAPA </li>
<li> Configure LON-CAPA </li>
<li> Pick a hosts.tab file </li>
<li> Create a Domain Coordinator </li>	<li> Create a Domain Coordinator </li>
<li> Start/Restart services </li>	<li> Start/Restart services </li>
<li> Log in to LON-CAPA </li>	<li> Log in to LON-CAPA </li>
Line 39 The installation process takes the follo	Line 41 The installation process takes the follo

<h2>Obtain Fedora Linux</h2>	<h2>Obtain Fedora Linux</h2>
<p>	<p>
Fedora linux ISO files can be obtained from the projects main site,	FC2 ISO files can be obtained from the projects main site,
<a href="http://fedora.redhat.com/">http://fedora.redhat.com/</a>.	<a href="http://fedora.redhat.com/">http://fedora.redhat.com/</a>.
</p>	You will need only the first ISO image for the minimal install.
	</p>

<h2>Determine Network Settings</h2>	<h2>Determine Network Settings</h2>
<p>	<p>
Line 57 DHCP is <em>not</em> supported.	Line 60 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>Minimal FC2 Install</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
before. Some documentation is available from	before. Some documentation is available from
Line 78 There are a few sections that require co	Line 77 There are a few sections that require co
however you should review the results and be prepared to modify them.	however you should review the results and be prepared to modify them.
LON-CAPA resource files are stored in the /home directory, so the	LON-CAPA resource files are stored in the /home directory, so the
lion's share of the drive should be allocated here. If you have 20 GB	lion's share of the drive should be allocated here. If you have 20 GB
of space for Fedora, /home should receive 16 gigs. Be sure to	of space for Red Hat, /home should receive at least 10 to 12 gigs.
	Since MySQL uses the /var filesystem to store its databases you should
	have at least 4 gigs of space available on /var. Be sure to
include adequate swap space. A minimum is 512 Megs, but you should	include adequate swap space. A minimum is 512 Megs, but you should
typically have 1 or 2x as much swap space as you do physical RAM.</dd>	typically have 1 or 2x as much swap space as you do physical RAM.</dd>
<dt>Network Configuration</dt>	<dt>Network Configuration</dt>
Line 90 There are a few sections that require co	Line 91 There are a few sections that require co
Additional ports used by LON-CAPA are 5663 and 8080.	Additional ports used by LON-CAPA are 5663 and 8080.
Enter these in the entry box as <nobr>"5663:tcp, 8080:tcp"</nobr>.</dd>	Enter these in the entry box as <nobr>"5663:tcp, 8080:tcp"</nobr>.</dd>
<dt>Package Group Selection</dt>	<dt>Package Group Selection</dt>
<dd>	<dd>Choose 'minimal install'</dd>
<b>Do not</b> install a web server. It is intentially omitted from
this list. Installing packages not listed below is not recommended.
If you install packages not listed below you should expect difficulties
when installing the LON-CAPA dependencies.
<ul>
<li>Editors</li>
<li>Text Based Internet</li>
<li>Authoring and Publishing</li>
<li>Development Tools
<li>Administration Tools
<li>Printing Support
</ul>
</dd>
</dl>	</dl>
<p>	<p>
Finish installing your server, reboot it, and log in as root.	Finish installing your server, reboot it, and log in as root.
</p>	</p>

<h2>Retrieving the LON-CAPA Installation Archive</h2>	<h2>Updating your system</h2>
<p>	<p>
Execute the following command:	Retrieve the loncapa_yum.conf file from the LON-CAPA install site:
</p>	</p>
<pre>	<pre>
wget http://install.loncapa.org/versions/fedora/fedora_install.tar	wget http://install.loncapa.org/versions/fedora/loncapa_yum.conf
</pre>	</pre>
<p>	<p>
This will retrieve from the LON-CAPA website all the packages needed to get	Copy the loncapa_yum.conf file to /etc/yum.conf:
LON-CAPA running on your system, except for the LON-CAPA source itself.
</p>	</p>
	<pre>
	mv /etc/yum.conf /etc/yum.conf.backup
	cp loncapa_yum.conf /etc/yum.conf
	</pre>
<p>	<p>
Extract the archive with the following command:	Update your system to the latest versions of the system software:
</p>	</p>
<pre>	<pre>
tar xf fedora_install.tar	yum update
</pre>	</pre>
<p>	<p>
This creates a directory named <tt>installation</tt>.	You will need to reboot your system after yum finishes. Reboot your system before proceeding with the LON-CAPA install.
</p>	</p>

<h2>Installing LON-CAPA Dependencies</h2>	<h2>Installing LON-CAPA</h2>
	<h3>Install prerequisites</h3>
<p>	<p>
This section walks you through installing the packages which LON-CAPA requires.	<p>
There are a lot of dependencies to deal with. They have been grouped in a	Installating the LON-CAPA prerequisites is pretty straightforward. Execute:
somewhat logical fashion to make them easier to deal with. When installing	</p><pre>
the rpms you should watch for errors.	yum install LONCAPA-prerequisites ntp
</p><p>	</pre><p>
The quick instructions are:	This may take a moment due to LON-CAPA's large number of dependencies.
	</p>
	<h3>Retrieve and execute LON-CAPA setup program</h3>
	<p>
	Retrieve the LON-CAPA setup with the following command:
</p>	</p>
<pre>	<pre>
cd installation	wget http://install.loncapa.org/versions/fedora/fedora_install.tar
cd mysql
rpm -Uvh *rpm
cd ../apache
rpm -Uvh *rpm
cd ../mod_perl
rpm -Uvh *rpm
cd ../perl_dependencies
rpm -Uvh *rpm
cd ../GD
rpm -Uvh *rpm
cd ../gnuplot
rpm --install --oldpackage readline-2.2.1-6.i386.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
rpm -Uvh *rpm
cd ..
</pre>	</pre>
<p>	<p>
<b>Notes:</b>	Extract the archive with the following command:
<ul>
<li>MySQL is used to store caches of data, not original copies.
Administering LON-CAPA machines does not yet mean becoming a
database administrator.</li>
<li>Apache 1.3 and mod_perl 1.x are required by LON-CAPA. These are
provided in the installation package.
<li>A specific version of Gnuplot is required by LON-CAPA. Do not
install a version different from the one included in the LON-CAPA
installation package.</li>
</ul>
</p>	</p>
	<pre>
<h2>Configuring LON-CAPA Dependencies</h2>	tar xf fedora_install.tar
	</pre>
<p>	<p>
We have prepared a script which takes care of most of the configuration that	This creates a directory named <tt>installation</tt>. Change to it and
must be done to get the newly installed packages working with LON-CAPA.	execute the setup script with the following commands:
This script will retrieve the latest LON-CAPA release from
<a href="http://install.loncapa.org">http://install.loncapa.org</a>.
You will be prompted for a root password for your MySQL server. You
will need to remember this password in case you should ever need to make
changes the the server.
</p><p>
Execute the script as follows:
</p>	</p>
<pre>	<pre>
cd setup;	cd installation
./install.pl	./install.pl
</pre>	</pre>
	<p>
	This script will prompt you for the MySQL root password and will download the latest LON-CAPA release.
	</p>

<h2>Determine LON-CAPA Settings</h2>	<h3>Determine LON-CAPA Settings</h3>
<p>	<p>
LON-CAPA requires a number of identifying parameters be set in order	LON-CAPA requires a number of identifying parameters be set in order
for it to function at all. Below is a list with descriptions.	for it to function at all. Below is a list with descriptions.
Line 221 for it to function at all. Below is a l	Line 187 for it to function at all. Below is a l
</dd>	</dd>
</dl>	</dl>

<h2>Configuring LON-CAPA</h2>	<h3>Configuring LON-CAPA</h3>
<p>	<p>
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 248 appropriate user name and your domain.	Line 214 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 259 will be appearant at this step.	Line 229 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>

	</body>

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

Removed from v.1.1
changed lines
	Added in v.1.13