<!-- The LearningOnline Network with CAPA -->
<!-- $Id: install.html,v 1.14 2002/04/23 12:41:23 harris41 Exp $ -->
<html>
<head>
<title>LON-CAPA Installation</title>
<!-- pdfahref install.pdf -->
<!-- button INSTALL -->
</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>
Execute the following command to create a user named 'www' on your
LON-CAPA server:
</p>
<table bgcolor="#aaaaaa" border="1"><tr><td>
<tt>/usr/sbin/useradd www</tt>
</td></tr></table>
<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>
<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>
<!-- maintext end -->
</body>
</html>
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>