Annotation of doc/build/install.html, revision 1.15
1.11 harris41 1: <!-- The LearningOnline Network with CAPA -->
1.15 ! harris41 2: <!-- $Id: install.html,v 1.14 2002/04/23 12:41:23 harris41 Exp $ -->
1.11 harris41 3: <html>
4: <head>
5: <title>LON-CAPA Installation</title>
1.12 harris41 6: <!-- pdfahref install.pdf -->
7: <!-- button INSTALL -->
1.11 harris41 8: </head>
1.12 harris41 9: <body bgcolor='#ffffff'>
10: <!-- preamble start -->
11: <br />
12: <p>
13: You will need to check all the following things to ensure proper
14: installation of your LON-CAPA system.
15: <ul>
1.13 harris41 16: <li><a href="#wwwuser">
17: Creating a user 'www'</a></li>
18: <li><a href="#shadow">
1.12 harris41 19: Make a LON-CAPA system work with shadow passwords</a></li>
1.13 harris41 20: <li><a href="#install">
21: Installing LON-CAPA files</a></li>
22: <li><a href="#checkrpms">
23: Checking your Linux RPMs</a></li>
24: <li><a href="#mysql">
25: Configuring the MySQL database</a></li>
1.15 ! harris41 26: <li><a href="#testing">
! 27: Testing to see if the LON-CAPA server is operational</a></li>
1.12 harris41 28: </ul>
29: <br />
30: <!-- preamble end -->
31: <!-- maintext start -->
1.13 harris41 32: <a name="wwwuser" />
33: <h3>Creating a user 'www'</h3>
34: <p>
1.14 harris41 35: Execute the following command to create a user named 'www' on your
36: LON-CAPA server:
1.13 harris41 37: </p>
1.14 harris41 38: <table bgcolor="#aaaaaa" border="1"><tr><td>
39: <tt>/usr/sbin/useradd www</tt>
40: </td></tr></table>
1.13 harris41 41: <a name="shadow" />
1.12 harris41 42: <h3>Make a LON-CAPA system work with shadow passwords</h3>
43: <p>
1.14 harris41 44: <table border="1">
1.12 harris41 45: <tr><th>Step #</th><th>Description</th></tr>
46: <tr><td>
1.14 harris41 47: <font size="+1">1</font>
1.12 harris41 48: </td><td>
49: <p>Is your system using shadow passwords? (Note: LON-CAPA will
50: work with either MD5/non-MD5 configured systems). If your
51: system is not using shadow passwords, then do not perform
52: any of the additional steps. If your system is using shadow
53: passwords, then you will need to perform the additional steps below.
54: </p>
55: <p>
56: <strong>How to detect:</strong>
57: <br />command: <tt>cat /etc/passwd | grep ':x:'</tt>
58: </p>
59: <p>If there is output such as "<tt>root:x:0:0:root:/root:/bin/bash</tt>",
60: then your system is using shadow passwords and you will need to continue with
61: the steps below.
62: </p>
63: </td></tr>
64: <tr><td>
65: <font size='+1'>2</font>
66: </td><td>
67: <p><strong>Retrieve the mod_auth_external source</strong> by
68: running the following command
69: </p>
70: <p><tt>
71: wget http://www.wwnet.net/~janc/software/mod_auth_external-2.1.13.tar.gz
72: </tt>
73: </p>
74: </td></tr>
1.13 harris41 75: <tr><td>
76: <font size='+1'>3</font>
77: </td><td>
78: <p><strong>More steps...</strong>
79: </p>
80: <p><tt>
81: There are more steps to include here.
82: </tt>
83: </p>
84: </td></tr>
85: </table>
86: </p>
87: <a name="install" />
88: <h3>Installing LON-CAPA files</h3>
89: <p>
90: Download the most current
91: <a href="http://install.lon-capa.org/versions/current/loncapa.tar.gz">
92: loncapa.tar.gz</a>.
93: </p>
1.14 harris41 94: <p>
95: The <strong>UPDATE</strong> command will refresh your filesystem with all
96: the latest LON-CAPA software.
97: </p>
98: <table bgcolor="#aaaaaa" border="1">
99: <tr><td><tt>./UPDATE</tt></td></tr>
100: </table>
1.13 harris41 101: <a name="checkrpms" />
102: <h3>Checking your Linux RPMs</h3>
103: <p>
1.14 harris41 104: The <strong>CHECKRPMS</strong> command will check the RPMs on your machine
105: against an FTP repository.
1.13 harris41 106: </p>
1.14 harris41 107: <table bgcolor="#aaaaaa" border="1">
1.13 harris41 108: <tr><td><tt>./CHECKRPMS</tt></td></tr>
1.12 harris41 109: </table>
1.13 harris41 110: <a name="mysql" />
111: <h3>Configuring the MySQL database</h3>
112: <p>
113: The following commands describe how to configure the MySQL database
114: on your LON-CAPA server.
1.12 harris41 115: </p>
1.14 harris41 116: <table bgcolor="#aaaaaa" border="1"><tr><td>
1.13 harris41 117: <pre>
118: Enter the mysql shell---
119: mysql -u root -p mysql
120:
121: Run these commands---
122: CREATE DATABASE loncapa;
123:
124: INSERT INTO user (Host, User, Password)
125: VALUES ('localhost','www',password('SOMEPASSWORD'));
126:
127: GRANT ALL PRIVILEGES ON *.* TO www@localhost;
128:
129: FLUSH PRIVILEGES;
130:
131: shell> mysql -u root mysql
132: mysql> SET PASSWORD FOR root@localhost=PASSWORD('new_password');
133: </pre>
134: </td></tr></table>
1.15 ! harris41 135: <a name="testing" />
! 136: <h3>Testing to see if the LON-CAPA server is operational</h3>
! 137: <p>
! 138: The <strong>TEST</strong> command will check the installation software,
! 139: the perl libraries on your system, the MySQL database, and
! 140: will also automatically test the real-time operation of the
! 141: LON-CAPA Apache web server.
! 142: </p>
! 143: <table bgcolor="#aaaaaa" border="1">
! 144: <tr><td><tt>./TEST</tt></td></tr>
! 145: </table>
1.12 harris41 146: <!-- maintext end -->
1.11 harris41 147: </body>
148: </html>
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>