version 1.3, 2000/10/26 08:01:26
|
version 1.16, 2002/04/23 13:04:54
|
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> |
This is the current list of steps to support LON-CAPA installation. These steps have |
<body bgcolor='#ffffff'> |
been tested. |
<!-- preamble start --> |
<OL> |
<br /> |
<LI>Get Redhat 6.2 on a CD by |
<p> |
<UL> |
You will need to check all the following things to ensure proper |
<LI>Using a RedHat 6.2 CD |
installation of your LON-CAPA system. |
<LI>Downloading a RedHat 6.2 <A HREF="http://install.lon-capa.org/3.1/currentcdimage">CD image</A> and burning a CD |
<ul> |
<LI>Or, alternatively do a network install from a <A HREF="http://install.lon-capa.org/3.1/currentcdsource"> |
<li><a href="#wwwuser"> |
RedHat 6.2 CD source tree</A>. You need to burn a boot floppy disk with a network boot image; |
Creating a user 'www'</a></li> |
<A HREF="http://install.lon-capa.org/3.1/currentcdsource/images/bootnet-20000407.img"> |
<li><a href="#shadow"> |
bootnet-20000407.img</A>. (Download the image file; insert a blank floppy disk; and type a |
Make a LON-CAPA system work with shadow passwords</a></li> |
command similar to: <TT>dd if=bootnet-20000407.img of=/dev/fd0</TT>). For installation, you |
<li><a href="#install"> |
need to specify <TT>http://www.lon-capa.org</TT> as your download URL, and <TT>/install/3.1/currentcdsource</TT> |
Installing LON-CAPA files</a></li> |
as the source location. |
<li><a href="#checkrpms"> |
</UL> |
Checking your Linux RPMs</a></li> |
<LI>Install RedHat 6.2 |
<li><a href="#mysql"> |
<UL> |
Configuring the MySQL database</a></li> |
<LI><B>Important: Do a "GNOME Workstation Install" and go with their default list of packages</B> |
<li><a href="#testing"> |
<LI><B>Important: Make sure you add a user "www"</B> |
Testing to see if the LON-CAPA server is operational</a></li> |
</UL> |
</ul> |
<LI>After installation, install extra RPMs/upgrades by downloading all files from |
<br /> |
<A HREF="http://install.lon-capa.org/3.1/SupplementalRPMS/"> |
<!-- preamble end --> |
http://install.lon-capa.org/3.1/SupplementalRPMS</A>. |
<!-- maintext start --> |
<UL> |
<a name="wwwuser" /> |
<LI>Use this command to install the RPMs you download: <TT>rpm -Uvh --force *.rpm</TT>. |
<h3>Creating a user 'www'</h3> |
</UL> |
<p> |
<LI>Remove extra RPMs by downloading and running the script |
Execute the following command to create a user named 'www' on your |
<A HREF="http://install.lon-capa.org/3.1/scripts/remove_extra.sh"> |
LON-CAPA server: |
http://install.lon-capa.org/3.1/scripts/remove_extra.sh</A> as root. |
</p> |
<LI>After installing the supplemental RPMS, install a final RPM set by downloading all files from |
<table bgcolor="#aaaaaa" border="1"><tr><td> |
<A HREF="http://install.lon-capa.org/3.1/FinalRPMS/"> |
<tt>/usr/sbin/useradd www</tt> |
http://install.lon-capa.org/3.1/FinalRPMS</A>. |
</td></tr></table> |
<UL> |
<a name="shadow" /> |
<LI>Use this command to install the RPMs you download: <TT>rpm -Uvh --force *.rpm</TT>. |
<h3>Make a LON-CAPA system work with shadow passwords</h3> |
</UL> |
<p> |
<LI>Configure needed files. |
<table border="1"> |
<UL> |
<tr><th>Step #</th><th>Description</th></tr> |
<LI>Currently, reconfiguration must be handled manually and involves an administrator |
<tr><td> |
altering configuration files present throughout the system. For a list of these |
<font size="+1">1</font> |
files and their descriptions, visit <A HREF="http://install.lon-capa.org/3.1/loncapafiles/loncapafiles.html"> |
</td><td> |
http://install.lon-capa.org/3.1/loncapafiles/loncapafiles.html</A>. |
<p>Is your system using shadow passwords? (Note: LON-CAPA will |
<LI>Important files are /etc/httpd/conf/access.conf, /etc/ntp.conf, /etc/krb.conf, |
work with either MD5/non-MD5 configured systems). If your |
/home/httpd/lonTabs/spare.tab, /home/httpd/lonTabs/hosts.tab (if setting up a cluster different |
system is not using shadow passwords, then do not perform |
than MSU's). |
any of the additional steps. If your system is using shadow |
<LI>Run, as root, <TT>/etc/rc.d/init.d/loncontrol start</TT>. |
passwords, then you will need to perform the additional steps below. |
<LI>After 10 minutes, you should be able to check the file <TT>/home/httpd/html/lon-status/index.html</TT> |
</p> |
to see if your machine has been successfully set up. |
<p> |
</UL> |
<strong>How to detect:</strong> |
</OL> |
<br />command: <tt>cat /etc/passwd | grep ':x:'</tt> |
</P> |
</p> |
<H3>Future Installation Procedure (not yet implemented)</H3> |
<p>If there is output such as "<tt>root:x:0:0:root:/root:/bin/bash</tt>", |
<P> |
then your system is using shadow passwords and you will need to continue with |
In the future, LON-CAPA Installation will be distributed on a CD complete with a |
the steps below. |
customized interface. Many elements for doing this have been coded, and are in place, but |
</p> |
it awaits completion. |
</td></tr> |
</P> |
<tr><td> |
</BODY> |
<font size='+1'>2</font> |
</HTML> |
</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> |
|
<p> |
|
The <strong>UPDATE</strong> command will refresh your filesystem with all |
|
the latest LON-CAPA software. |
|
</p> |
|
<table bgcolor="#aaaaaa" border="1"> |
|
<tr><td><tt>./UPDATE</tt></td></tr> |
|
</table> |
|
<a name="checkrpms" /> |
|
<h3>Checking your Linux RPMs</h3> |
|
<p> |
|
The <strong>CHECKRPMS</strong> command will check the RPMs on your machine |
|
against an FTP repository. |
|
</p> |
|
<table bgcolor="#aaaaaa" border="1"> |
|
<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" border="1"><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> |
|
<a name="testing" /> |
|
<h3>Testing to see if the LON-CAPA server is operational</h3> |
|
<p> |
|
The <strong>TEST</strong> command will check the installation software, |
|
the perl libraries on your system, the MySQL database, and |
|
will also automatically test the real-time operation of the |
|
LON-CAPA Apache web server. |
|
</p> |
|
<table bgcolor="#aaaaaa" border="1"> |
|
<tr><td><tt>./TEST</tt></td></tr> |
|
</table> |
|
<p> |
|
Using the <strong>TEST</strong> command will likely |
|
be an iterative process. |
|
It is normal to expect that the <strong>TEST</strong> command |
|
will recommend you perform various steps to ensure optimal |
|
performance of your LON-CAPA server. |
|
</p> |
|
<!-- maintext end --> |
|
</body> |
|
</html> |