--- doc/build/Attic/install.html 2002/04/23 12:41:23 1.14 +++ doc/build/Attic/install.html 2002/07/11 05:05:36 1.30 @@ -1,7 +1,10 @@ + - + + LON-CAPA Installation @@ -9,9 +12,21 @@
  +

+ +CLICK ON THIS RED LINK +
+ +*ALTERNATIVE FAST-TRACK* +
+INSTRUCTIONS ALSO AVAILABLE +
+
+

You will need to check all the following things to ensure proper installation of your LON-CAPA system. +


  @@ -38,7 +55,6 @@ LON-CAPA server:

Make a LON-CAPA system work with shadow passwords

-

-
Step #Description
@@ -73,15 +89,68 @@ wget http://www.wwnet.net/~janc/software
3 -

More steps... +

Unpack the mod_auth_external source by +running the following command

-

-There are more steps to include here. - +

+tar xzvf mod_auth_external-2.1.13.tar.gz

+ +4 + +

Go to the pwauth directory by +running the following command +

+

+cd mod_auth_external-2.1.13/pwauth/ +

+ + +5 + +

Edit config.h and change SERVER_UIDS definition

+

+Determine the user id of 'www': +
grep ^www /etc/passwd | cut -d':' -f3 +
+Change the line +
#define SERVER_UIDS 99 /* user "nobody" */ +
to be +
#define SERVER_UIDS 513 /* user "www" */ +
where in this example 513 corresponds to the user id of 'www'. +

+ + +6 + +

Compile the pwauth executable by +running the following command +

+

+make +

+ + +7 + +

Install pwauth by doing the following +

+

+cp pwauth /usr/local/sbin/ +
chmod 6755 /usr/local/sbin/pwauth +

+

+Edit (creating the file) /etc/pam.d/pwauth to have the contents: +

+
+        auth       required     /lib/security/pam_pwdb.so shadow nullok
+        auth       required     /lib/security/pam_nologin.so
+        account    required     /lib/security/pam_pwdb.so
+
+ +

Installing LON-CAPA files

@@ -89,6 +158,14 @@ Download the most current loncapa.tar.gz.

+ + +
wget http://install.lon-capa.org/versions/current/loncapa.tar.gz + +
+tar xzvf loncapa.tar.gz +
+cd loncapa

The UPDATE command will refresh your filesystem with all the latest LON-CAPA software. @@ -110,26 +187,73 @@ against an FTP repository.

The following commands describe how to configure the MySQL database on your LON-CAPA server. +
Note:

+ +

+The following instructions assume you are logged in as 'root'. +

+

Entering the mysql shell

-Enter the mysql shell---
 mysql -u root -p mysql
+OR
+mysql -u root mysql (depending on whether you have set a root password)
+
+
+

Creating the mysql 'www' user (after entering mysql shell)

+
+
+mysql> CREATE DATABASE loncapa;
 
-Run these commands---
-CREATE DATABASE loncapa;
-
-INSERT INTO user (Host, User, Password)
-VALUES ('localhost','www',password('SOMEPASSWORD'));
-
-GRANT ALL PRIVILEGES ON *.* TO www@localhost;
+mysql> INSERT INTO user (Host, User, Password)
+mysql> VALUES ('localhost','www',password('localhostkey'));
 
-FLUSH PRIVILEGES;
+mysql> GRANT ALL PRIVILEGES ON *.* TO www@localhost;
 
+mysql> FLUSH PRIVILEGES;
+
+
+

SECURITY: set a password for the mysql 'root' user

+
+
 shell> mysql -u root mysql
-mysql> SET PASSWORD FOR root@localhost=PASSWORD('new_password');
+mysql> SET PASSWORD FOR root@localhost=PASSWORD('ROOTPASSWORD');
+
+
+

SECURITY: only allow access from localhost

+
+
+shell> mysql -u root -p mysql
+mysql> DELETE FROM user WHERE host<>'localhost';
 
+ +

Testing to see if the LON-CAPA server is operational

+

+The TEST 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. +

+ + +
./TEST
+

+Using the TEST command will likely +be an iterative process. +It is normal to expect that the TEST command +will recommend you perform various steps to ensure optimal +performance of your LON-CAPA server. +

+