--- doc/build/Attic/install.html 2002/04/23 12:33:40 1.13 +++ doc/build/Attic/install.html 2002/04/26 13:17:51 1.17 @@ -1,5 +1,7 @@ + - + LON-CAPA Installation @@ -23,6 +25,8 @@ Installing LON-CAPA files Checking your Linux RPMs
  • Configuring the MySQL database
    • +
  • +Testing to see if the LON-CAPA server is operational

    •   @@ -30,15 +34,19 @@ Configuring the MySQL database

    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 @@ -69,11 +77,65 @@ 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
+

    @@ -85,13 +147,20 @@ 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. +The CHECKRPMS command will check the RPMs on your machine +against an FTP repository.

    - +
    ./CHECKRPMS
     @@ -100,7 +169,7 @@ an FTP repository. The following commands describe how to configure the MySQL database on your LON-CAPA server.

    -
    +
     Enter the mysql shell---
 mysql -u root -p mysql
@@ -119,48 +188,24 @@ shell> mysql -u root mysql
 mysql> SET PASSWORD FOR root@localhost=PASSWORD('new_password');
    - -

    LON-CAPA Installation

    -

    Current Installation Procedure

    + +

    Testing to see if the LON-CAPA server is operational

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

    -

    $Date: 2002/04/23 12:33:40 $; $Revision: 1.13 $

    + + +
    ./TEST

    -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. -
    2. Install with CD-ROM -
      3. -
    3. 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. -
      4. -
    -
    -

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

    +