version 1.4, 2000/10/27 02:25:43
|
version 1.13, 2002/04/23 12:33:40
|
Line 1
|
Line 1
|
<HTML> |
<!-- The LearningOnline Network with CAPA --> |
<HEAD> |
<!-- $Id$ --> |
<TITLE>LON-CAPA Installation</TITLE> |
<html> |
</HEAD> |
<head> |
<BODY> |
<title>LON-CAPA Installation</title> |
<H1>LON-CAPA Installation</H1> |
<!-- pdfahref install.pdf --> |
<H3>Current Installation Procedure</H3> |
<!-- button INSTALL --> |
<P> |
</head> |
|
<body bgcolor='#ffffff'> |
|
<!-- preamble start --> |
|
<br /> |
|
<p> |
|
You will need to check all the following things to ensure proper |
|
installation of your LON-CAPA system. |
|
<ul> |
|
<li><a href="#wwwuser"> |
|
Creating a user 'www'</a></li> |
|
<li><a href="#shadow"> |
|
Make a LON-CAPA system work with shadow passwords</a></li> |
|
<li><a href="#install"> |
|
Installing LON-CAPA files</a></li> |
|
<li><a href="#checkrpms"> |
|
Checking your Linux RPMs</a></li> |
|
<li><a href="#mysql"> |
|
Configuring the MySQL database</a></li> |
|
</ul> |
|
<br /> |
|
<!-- preamble end --> |
|
<!-- maintext start --> |
|
<a name="wwwuser" /> |
|
<h3>Creating a user 'www'</h3> |
|
<p> |
|
|
|
</p> |
|
<a name="shadow" /> |
|
<h3>Make a LON-CAPA system work with shadow passwords</h3> |
|
<p> |
|
<table border='1'> |
|
<tr><th>Step #</th><th>Description</th></tr> |
|
<tr><td> |
|
<font size='+1'>1</font> |
|
</td><td> |
|
<p>Is your system using shadow passwords? (Note: LON-CAPA will |
|
work with either MD5/non-MD5 configured systems). If your |
|
system is not using shadow passwords, then do not perform |
|
any of the additional steps. If your system is using shadow |
|
passwords, then you will need to perform the additional steps below. |
|
</p> |
|
<p> |
|
<strong>How to detect:</strong> |
|
<br />command: <tt>cat /etc/passwd | grep ':x:'</tt> |
|
</p> |
|
<p>If there is output such as "<tt>root:x:0:0:root:/root:/bin/bash</tt>", |
|
then your system is using shadow passwords and you will need to continue with |
|
the steps below. |
|
</p> |
|
</td></tr> |
|
<tr><td> |
|
<font size='+1'>2</font> |
|
</td><td> |
|
<p><strong>Retrieve the mod_auth_external source</strong> by |
|
running the following command |
|
</p> |
|
<p><tt> |
|
wget http://www.wwnet.net/~janc/software/mod_auth_external-2.1.13.tar.gz |
|
</tt> |
|
</p> |
|
</td></tr> |
|
<tr><td> |
|
<font size='+1'>3</font> |
|
</td><td> |
|
<p><strong>More steps...</strong> |
|
</p> |
|
<p><tt> |
|
There are more steps to include here. |
|
</tt> |
|
</p> |
|
</td></tr> |
|
</table> |
|
</p> |
|
<a name="install" /> |
|
<h3>Installing LON-CAPA files</h3> |
|
<p> |
|
Download the most current |
|
<a href="http://install.lon-capa.org/versions/current/loncapa.tar.gz"> |
|
loncapa.tar.gz</a>. |
|
</p> |
|
<a name="checkrpms" /> |
|
<h3>Checking your Linux RPMs</h3> |
|
<p> |
|
The CHECKRPMS command will check the RPMs on your machine against |
|
an FTP repository. |
|
</p> |
|
<table bgcolor="#aaaaaa"> |
|
<tr><td><tt>./CHECKRPMS</tt></td></tr> |
|
</table> |
|
<a name="mysql" /> |
|
<h3>Configuring the MySQL database</h3> |
|
<p> |
|
The following commands describe how to configure the MySQL database |
|
on your LON-CAPA server. |
|
</p> |
|
<table bgcolor="#aaaaaa"><tr><td> |
|
<pre> |
|
Enter the mysql shell--- |
|
mysql -u root -p mysql |
|
|
|
Run these commands--- |
|
CREATE DATABASE loncapa; |
|
|
|
INSERT INTO user (Host, User, Password) |
|
VALUES ('localhost','www',password('SOMEPASSWORD')); |
|
|
|
GRANT ALL PRIVILEGES ON *.* TO www@localhost; |
|
|
|
FLUSH PRIVILEGES; |
|
|
|
shell> mysql -u root mysql |
|
mysql> SET PASSWORD FOR root@localhost=PASSWORD('new_password'); |
|
</pre> |
|
</td></tr></table> |
|
<!-- maintext end --> |
|
<h1>LON-CAPA Installation</h1> |
|
<h3>Current Installation Procedure</h3> |
|
<p> |
Scott Harrison |
Scott Harrison |
</P> |
</p> |
<P> |
<p>$Date$; $Revision$</p> |
Last updated: 10/26/2000 |
<p> |
</P> |
This is the current list of steps to support LON-CAPA installation. These |
<P> |
steps have been tested.</p> |
This is the current list of steps to support LON-CAPA installation. These steps have |
<ol> |
been tested. |
<li>Get LON-CAPA on a CD by |
<OL> |
<ul> |
<LI>Get Redhat 6.2 on a CD by |
<li>Requesting a LON-CAPA installation CD (c/o Helen Keefe, |
<UL> |
helen@lon-capa.org).</li> |
<LI>Using a RedHat 6.2 CD |
<li>Or, downloading a LON-CAPA installation |
<LI>Downloading a RedHat 6.2 <A HREF="http://install.lon-capa.org/3.1/currentcdimage">CD image</A> and burning a CD |
<a href="http://install.lon-capa.org/3.1/currentcdimage">CD image</A> and |
<LI>Or, alternatively do a network install from a <A HREF="http://install.lon-capa.org/3.1/currentcdsource"> |
burning a CD.</li> |
RedHat 6.2 CD source tree</A>. You need to burn a boot floppy disk with a network boot image; |
<li>(Depending on whether your computer has a bootable CD-ROM, you may |
<A HREF="http://install.lon-capa.org/3.1/currentcdsource/images/bootnet-20000407.img"> |
need to also make a boot floppy. Download this floppy disk image file: |
bootnet-20000407.img</A>. (Download the image file; insert a blank floppy disk; and type a |
<a href= |
command similar to: <TT>dd if=bootnet-20000407.img of=/dev/fd0</TT>). For installation, you |
"http://install.lon-capa.org/3.1/currentcdsource/images/boot-20000407.img"> |
need to specify <TT>http://www.lon-capa.org</TT> as your download URL, and <TT>/install/3.1/currentcdsource</TT> |
boot-20000407.img</a>. (Download the image file; insert a blank floppy disk; |
as the source location. |
and type this command: <tt>dd if=boot-20000407.img of=/dev/fd0</tt>).</li> |
</UL> |
</ul></li> |
<LI>Install RedHat 6.2 |
<li>Install with CD-ROM |
<UL> |
<ul> |
<LI><B>Important: Do a "GNOME Workstation Install" and go with their default list of packages</B> |
<li>Follow the <A HREF="instructions_with_cd.html"> |
<LI><B>Important: Make sure you add a user "www"</B> |
CD-ROM installation instructions</a></li> |
</UL> |
</ul></li> |
<LI>After installation, install extra RPMs/upgrades by downloading all files from |
<li>After installation, restart the computer. Login as root. Enter this |
<A HREF="http://install.lon-capa.org/3.1/SupplementalRPMS/"> |
command (you only need to do this after your first reboot): |
http://install.lon-capa.org/3.1/SupplementalRPMS</A>. |
<ol> |
<UL> |
<li><tt>sh /usr/sbin/loncapa_configure</tt></li> |
<LI>Use this command to install the RPMs you download: <TT>rpm -Uvh --force *.rpm</TT>. |
</ol></li> |
</UL> |
</ol> |
<LI>Remove extra RPMs by downloading and running the script |
<hr /> |
<A HREF="http://install.lon-capa.org/3.1/scripts/remove_extra.sh"> |
<p> |
http://install.lon-capa.org/3.1/scripts/remove_extra.sh</A> as root. |
You can also try to install LON-CAPA on an existing installation of |
<LI>After installing the supplemental RPMS, install a final RPM set by downloading all files from |
RedHat 6.2. Please see <a |
<A HREF="http://install.lon-capa.org/3.1/FinalRPMS/"> |
href='how_to_install_loncapa_on_a_preinstalled_system.txt'> |
http://install.lon-capa.org/3.1/FinalRPMS</A>. |
how_to_install_loncapa_on_a_preinstalled_system.txt</a>. |
<UL> |
</p> |
<LI>Use this command to install the RPMs you download: <TT>rpm -Uvh --force *.rpm</TT>. |
</body> |
</UL> |
</html> |
<LI>Configure needed files. |
|
<UL> |
|
<LI>Currently, reconfiguration must be handled manually and involves an administrator |
|
altering configuration files present throughout the system. For a list of these |
|
files and their descriptions, visit <A HREF="http://install.lon-capa.org/3.1/loncapafiles/loncapafiles.html"> |
|
http://install.lon-capa.org/3.1/loncapafiles/loncapafiles.html</A>. |
|
<LI>Important files are /etc/httpd/conf/access.conf, /etc/ntp.conf, /etc/krb.conf, |
|
/home/httpd/lonTabs/spare.tab, /home/httpd/lonTabs/hosts.tab (if setting up a cluster different |
|
than MSU's). |
|
<LI>Run, as root, <TT>/etc/rc.d/init.d/loncontrol start</TT>. |
|
<LI>After 10 minutes, you should be able to check the file <TT>/home/httpd/html/lon-status/index.html</TT> |
|
to see if your machine has been successfully set up. |
|
</UL> |
|
</OL> |
|
</P> |
|
<H3>Future Installation Procedure (not yet implemented)</H3> |
|
<P> |
|
In the future, LON-CAPA Installation will be distributed on a CD complete with a |
|
customized interface. Many elements for doing this have been coded, and are in place, but |
|
it awaits completion. |
|
</P> |
|
</BODY> |
|
</HTML> |
|