--- doc/build/Attic/install.html 2000/11/21 15:35:09 1.7 +++ doc/build/Attic/install.html 2002/04/23 12:33:40 1.13 @@ -1,138 +1,166 @@ - - -LON-CAPA Installation - - -

LON-CAPA Installation

-

Current Installation Procedure

-

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

+

+ +

+
+

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

More steps... +

+

+There are more steps to include here. + +

+
+

+
+

Installing LON-CAPA files

+

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

+ +

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

+
+
+Enter the mysql shell---
+mysql -u root -p mysql
+
+Run these commands---
+CREATE DATABASE loncapa;
+
+INSERT INTO user (Host, User, Password)
+VALUES ('localhost','www',password('SOMEPASSWORD'));
+
+GRANT ALL PRIVILEGES ON *.* TO www@localhost;
+
+FLUSH PRIVILEGES;
+
+shell> mysql -u root mysql
+mysql> SET PASSWORD FOR root@localhost=PASSWORD('new_password');
+
+
+ +

LON-CAPA Installation

+

Current Installation Procedure

+

Scott Harrison -

-

-Last updated: 11/21/2000 -

-

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

    -

    -After installation, restart the computer. Login as root. Enter these two commands: -

      -
    1. lynx -source http://install.lon-capa.org/3.1/scripts/postinstall.pl>postinstall.pl -
    2. perl postinstall.pl -
    -

    -

    -As postinstall.pl runs, you will be asked various questions. Follow the instructions to correctly -enter in the appropriate parameter values. -

    -
    -

    Old steps; do not use these...

    -Last updated: 11/01/2000 -

    -

    -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 -
        -
      • Using a RedHat 6.2 CD -
      • Downloading a RedHat 6.2 CD image and burning a CD -
      • Or, alternatively do a network install from a -RedHat 6.2 CD source tree. You need to burn a boot floppy disk with a network boot image; - -bootnet-20000407.img. (Download the image file; insert a blank floppy disk; and type a -command similar to: dd if=bootnet-20000407.img of=/dev/fd0). For installation, you -need to specify hobbes.lite.msu.edu/~loninst as your download URL, and /3.1/currentcdsource -as the source location. -
      -
    2. Install RedHat 6.2 -
        -
      • Important: Do a "GNOME Workstation Install" and go with their default list of packages -
      • Important: Make sure you add a user "www" -
      -
    3. After installation, install extra RPMs/upgrades by downloading all files from - -http://install.lon-capa.org/3.1/SupplementalRPMS. -
        -
      • Use this command to install the RPMs you download: rpm -Uvh --force *.rpm. -
      -
    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. -
        -
      • Use this command to install the RPMs you download: rpm -Uvh --force *.rpm. -
      -
    6. Configure needed files. - -
    7. Important files are /etc/httpd/conf/access.conf, /etc/ntp.conf, /etc/krb.conf, -/home/httpd/lonTabs/spare.tab, /home/httpd/lonTabs/hosts.tab (if setting up a cluster different -than MSU's). -
    8. Unshadow passwords -
        -
        You can do this by these 5 steps:
        -1. enter the system command, as "root", pwunconv
        -2. enter the system command, as "root", grpunconv
        -3. Set the following to be the /etc/pam.d/login file on your system
        -#%PAM-1.0
        -auth       required     /lib/security/pam_securetty.so
        -auth       required     /lib/security/pam_pwdb.so shadow nullok
        -auth       required     /lib/security/pam_nologin.so
        -account    required     /lib/security/pam_pwdb.so
        -password   required     /lib/security/pam_cracklib.so
        -password   required     /lib/security/pam_pwdb.so nullok use_authtok
        -session    required     /lib/security/pam_pwdb.so
        -session    optional     /lib/security/pam_console.so
        -4. Set the following to be the /etc/pam.d/passwd file on your system
        -#%PAM-1.0
        -auth       required     /lib/security/pam_pwdb.so shadow nullok
        -account    required     /lib/security/pam_pwdb.so
        -password   required     /lib/security/pam_cracklib.so retry=3
        -password   required     /lib/security/pam_pwdb.so use_authtok nullok
        -5. Set/reset passwords.  As "root" use 'passwd', and 'passwd www'
        -to change the important passwords.  This creates crypt-processible
        -passwords in /etc/passwd.
        -
        -
      -
    9. Run, as root, ln -s /etc/mime.types /etc/httpd/conf/mime.types -
    10. Run, as root, /etc/rc.d/init.d/httpd start. -
    11. Run, as root, /etc/rc.d/init.d/loncontrol start. -
    12. After 10 minutes, you should be able to check the file /home/httpd/html/lon-status/index.html -to see if your machine has been successfully set up. - -
    -

    -

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

    - - +

    +

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

    +

    +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 +
        +
      • Requesting a LON-CAPA installation CD (c/o Helen Keefe, +helen@lon-capa.org).
      • +
      • Or, downloading a LON-CAPA installation +CD image and +burning a CD.
      • +
      • (Depending on whether your computer has a bootable CD-ROM, you may +need to also make a boot floppy. Download this floppy disk image file: + +boot-20000407.img. (Download the image file; insert a blank floppy disk; +and type this command: dd if=boot-20000407.img of=/dev/fd0).
      • +
    2. +
    3. Install with CD-ROM +
    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. +

    + +