--- doc/build/Attic/install.html 2002/02/13 15:06:22 1.12 +++ doc/build/Attic/install.html 2003/05/02 19:25:01 1.40 @@ -1,7 +1,10 @@ + - + + LON-CAPA Installation @@ -12,26 +15,56 @@

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

+

+NOTE: +If you want to simultaneously install both RedHat 7.3 and LON-CAPA +(to ensure 100% reliability), follow these +alternative directions. +


  - -

Make a LON-CAPA system work with shadow passwords

+
+

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

Is your system using shadow passwords? (Note: LON-CAPA will work +with either MD5/non-MD5 configured systems). It is strongly +recommended to use shadow passwords. If your system is currently not +using shadow passwords, run the "pwconv" command (as root) in order to +convert to shadow passwords. If you choose not to use 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: @@ -49,54 +82,200 @@ the steps below. running the following command

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

+3 + +

Unpack the mod_auth_external source by +running the following command +

+

+tar xzvf mod_auth_external-2.1.15.tar.gz +

+
+4 + +

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

+

+cd mod_auth_external-2.1.15/pwauth/ +

+
+5 + +

Edit config.h and change SERVER_UIDS definition +

+

+Determine the user id of 'www': +
id -u www +
+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-current.tar.gz.

- -

LON-CAPA Installation

-

Current Installation Procedure

+ + +
wget http://install.lon-capa.org/versions/loncapa-current.tar.gz + +
+tar xzvf loncapa-current.tar.gz +
+cd loncapa-N.N (N.N is the version number)

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

-

$Date: 2002/02/13 15:06:22 $; $Revision: 1.12 $

+ + +
./UPDATE
+ +

Checking your Linux RPMs

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

-
    -
  1. Get LON-CAPA on a CD by -
  2. -
  3. Install with CD-ROM +The CHECKRPMS command will check the RPMs on your machine +against an FTP repository. +

    + + +
    ./CHECKRPMS
    +

    +Also, please be sure to install the LON-CAPA-systemperl RPM as described on +the Downloads page. +

    + +

    Fixing /etc/hosts

    +

    +A common RedHat glitch of new installations (RedHat's fault, not LON-CAPA) +is the generation of /etc/hosts. +

    +

    +It should look something like this (except the myschool line +should be replaced with settings specific to your machine): +

    + + +
    +
    +127.0.0.1		localhost.localdomain localhost
    +12.34.56.78		www.myschool.edu myschool
    +
    +
    +

    Configuring the MySQL database

    +

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

  4. -
  5. After installation, restart the computer. Login as root. Enter this -command (you only need to do this after your first reboot): -
      -
    1. sh /usr/sbin/loncapa_configure
    2. -
  6. -
-
-

-You can also try to install LON-CAPA on an existing installation of -RedHat 6.2. Please see -how_to_install_loncapa_on_a_preinstalled_system.txt. +

  • you should substitute 'ROOTPASSWORD' with something very hard to guess +(it does not have to be the Linux OS root password) +
  • +
  • The MySQL www@localhost user must always have a password of 'localhostkey' +in order for there to be correct operation of a standard LON-CAPA system. +
  • + +

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

    +

    Entering 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;
    +
    +mysql> INSERT INTO user (Host, User, Password)
    +mysql> VALUES ('localhost','www',password('localhostkey'));
    +
    +mysql> INSERT INTO db VALUES ('localhost','loncapa','www',
    +mysql> 'Y','Y','Y','Y','Y','Y','N','Y','Y','Y');
    +
    +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. +

    + +