--- doc/build/Attic/install.html 2000/10/26 08:01:26 1.3 +++ doc/build/Attic/install.html 2002/05/10 16:30:03 1.21 @@ -1,66 +1,237 @@ - - -LON-CAPA Installation - - -

LON-CAPA Installation

-

Current Installation Procedure

-

-This is the current list of steps to support LON-CAPA installation. These steps have -been tested. -

    -
  1. Get Redhat 6.2 on a CD by - -
  2. Install RedHat 6.2 - -
  3. After installation, install extra RPMs/upgrades by downloading all files from - -http://install.lon-capa.org/3.1/SupplementalRPMS. - -
  4. Remove extra RPMs by downloading and running the script - -http://install.lon-capa.org/3.1/scripts/remove_extra.sh as root. -
  5. After installing the supplemental RPMS, install a final RPM set by downloading all files from - -http://install.lon-capa.org/3.1/FinalRPMS. - -
  6. Configure needed files. - -
-

-

Future Installation Procedure (not yet implemented)

-

-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. -

- - + + + + + + +LON-CAPA Installation + + + + + +
  +

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

+ +
  + + + +

Creating a user 'www'

+

+Execute the following command to create a user named 'www' on your +LON-CAPA server: +

+
+/usr/sbin/useradd www +
+
+

Make a LON-CAPA system work with shadow passwords

+ + + + + + + + + +
Step #Description
+1 + +

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

+

+How to detect: +
command: cat /etc/passwd | grep ':x:' +

+

If there is output such as "root:x:0:0:root:/root:/bin/bash", +then your system is using shadow passwords and you will need to continue with +the steps below. +

+
+2 + +

Retrieve the mod_auth_external source by +running the following command +

+

+wget http://www.wwnet.net/~janc/software/mod_auth_external-2.1.13.tar.gz + +

+
+3 + +

Unpack the mod_auth_external source by +running the following command +

+

+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

+

+Download the most current + +loncapa.tar.gz. +

+

+The UPDATE command will refresh your filesystem with all +the latest LON-CAPA software. +

+ + +
./UPDATE
+ +

Checking your Linux RPMs

+

+The CHECKRPMS command will check the RPMs on your machine +against an FTP repository. +

+ + +
./CHECKRPMS
+
+

Configuring the MySQL database

+

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

+ +

Entering the mysql shell

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

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

+
+
+mysql> CREATE DATABASE loncapa;
+
+mysql> INSERT INTO user (Host, User, Password)
+mysql> VALUES ('localhost','www',password('WWWPASSWORD'));
+
+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('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. +

+ + + +