[BACK]Return to install.html CVS log [TXT] [DIR] Up to [LON-CAPA] / doc / build

Diff for /doc/build/Attic/install.html between versions 1.8 and 1.13

version 1.8, 2000/11/21 15:45:00 version 1.13, 2002/04/23 12:33:40
Line 1 Line 1
 <HTML>  <!-- The LearningOnline Network with CAPA -->
 <HEAD>  <!-- $Id$ -->
 <TITLE>LON-CAPA Installation</TITLE>  <html>
 </HEAD>  <head>
 <BODY>  <title>LON-CAPA Installation</title>
 <H1>LON-CAPA Installation</H1>  <!-- pdfahref install.pdf -->
 <H3>Current Installation Procedure</H3>  <!-- button INSTALL -->
 <P>  </head>
   <body bgcolor='#ffffff'>
   <!-- preamble start -->
   <br />&nbsp;
   <p>
   You will need to check all the following things to ensure proper
   installation of your LON-CAPA system.
   <ul>
   <li><a href="#wwwuser">
   Creating a user 'www'</a></li>
   <li><a href="#shadow">
   Make a LON-CAPA system work with shadow passwords</a></li>
   <li><a href="#install">
   Installing LON-CAPA files</a></li>
   <li><a href="#checkrpms">
   Checking your Linux RPMs</a></li>
   <li><a href="#mysql">
   Configuring the MySQL database</a></li>
   </ul>
   <br />&nbsp;
   <!-- preamble end -->
   <!-- maintext start -->
   <a name="wwwuser" />
   <h3>Creating a user 'www'</h3>
   <p>
   
   </p>
   <a name="shadow" />
   <h3>Make a LON-CAPA system work with shadow passwords</h3>
   <p>
   <table border='1'>
   <tr><th>Step #</th><th>Description</th></tr>
   <tr><td>
   <font size='+1'>1</font>
   </td><td>
   <p>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.
   </p>
   <p>
   <strong>How to detect:</strong>
   <br />command: <tt>cat /etc/passwd | grep ':x:'</tt>
   </p>
   <p>If there is output such as "<tt>root:x:0:0:root:/root:/bin/bash</tt>",
   then your system is using shadow passwords and you will need to continue with
   the steps below.
   </p>
   </td></tr>
   <tr><td>
   <font size='+1'>2</font>
   </td><td>
   <p><strong>Retrieve the mod_auth_external source</strong> by
   running the following command
   </p>
   <p><tt>
   wget http://www.wwnet.net/~janc/software/mod_auth_external-2.1.13.tar.gz
   </tt>
   </p>
   </td></tr>
   <tr><td>
   <font size='+1'>3</font>
   </td><td>
   <p><strong>More steps...</strong>
   </p>
   <p><tt>
   There are more steps to include here.
   </tt>
   </p>
   </td></tr>
   </table>
   </p>
   <a name="install" />
   <h3>Installing LON-CAPA files</h3>
   <p>
   Download the most current
   <a href="http://install.lon-capa.org/versions/current/loncapa.tar.gz">
   loncapa.tar.gz</a>.
   </p>
   <a name="checkrpms" />
   <h3>Checking your Linux RPMs</h3>
   <p>
   The CHECKRPMS command will check the RPMs on your machine against
   an FTP repository.
   </p>
   <table bgcolor="#aaaaaa">
   <tr><td><tt>./CHECKRPMS</tt></td></tr>
   </table>
   <a name="mysql" />
   <h3>Configuring the MySQL database</h3>
   <p>
   The following commands describe how to configure the MySQL database
   on your LON-CAPA server.
   </p>
   <table bgcolor="#aaaaaa"><tr><td>
   <pre>
   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');
   </pre>
   </td></tr></table>
   <!-- maintext end -->
   <h1>LON-CAPA Installation</h1>
   <h3>Current Installation Procedure</h3>
   <p>
 Scott Harrison  Scott Harrison
 </P>  </p>
 <P>  <p>$Date$; $Revision$</p>
 Last updated: 11/21/2000  <p>
 </P>  This is the current list of steps to support LON-CAPA installation.  These
 <P>  steps have been tested.</p>
 This is the current list of steps to support LON-CAPA installation.  These steps have  <ol>
 been tested.  <li>Get LON-CAPA on a CD by
 <OL>  <ul>
 <LI>Get Redhat 6.2 on a CD by  <li>Requesting a LON-CAPA installation CD (c/o Helen Keefe, 
 <UL>  helen@lon-capa.org).</li>
 <LI>Using a RedHat 6.2 CD  <li>Or, downloading a LON-CAPA installation
 <LI>Downloading a RedHat 6.2 <A HREF="http://install.lon-capa.org/3.1/currentcdimage">CD image</A> and burning a CD  <a href="http://install.lon-capa.org/3.1/currentcdimage">CD image</A> and
 <LI>Or, alternatively do a network install from a <A HREF="http://install.lon-capa.org/3.1/currentcdsource">  burning a CD.</li>
 RedHat 6.2 CD source tree</A>.  You need to burn a boot floppy disk with a network boot image;  <li>(Depending on whether your computer has a bootable CD-ROM, you may
 <A HREF="http://install.lon-capa.org/3.1/currentcdsource/images/bootnet-20000407.img">  need to also make a boot floppy.  Download this floppy disk image file: 
 bootnet-20000407.img</A>.  (Download the image file; insert a blank floppy disk; and type a  <a href=
 command similar to: <TT>dd if=bootnet-20000407.img of=/dev/fd0</TT>).  For installation, you  "http://install.lon-capa.org/3.1/currentcdsource/images/boot-20000407.img">
 need to specify <TT>hobbes.lite.msu.edu/~loninst</TT> as your download URL, and <TT>/3.1/currentcdsource</TT>  boot-20000407.img</a>.  (Download the image file; insert a blank floppy disk;
 as the source location.  and type this command: <tt>dd if=boot-20000407.img of=/dev/fd0</tt>).</li>
 </UL>  </ul></li>
 <LI>Install RedHat 6.2  <li>Install with CD-ROM
 <UL>  <ul>
 <LI><B>Important: Do a "GNOME Workstation Install" and go with their default list of packages</B>  <li>Follow the <A HREF="instructions_with_cd.html">
 <LI><B>Important: Make sure you add a user "www"</B>  CD-ROM installation instructions</a></li>
 </UL>  </ul></li>
 <LI>After installation, restart the computer.  Login as root.  Enter these two commands:  <li>After installation, restart the computer.  Login as root.  Enter this
 <OL>  command (you only need to do this after your first reboot):
 <LI><TT>lynx -source http://install.lon-capa.org/3.1/scripts/postinstall.pl&gt;postinstall.pl</TT>  <ol>
 <LI><TT>perl postinstall.pl</TT>  <li><tt>sh /usr/sbin/loncapa_configure</tt></li>
 </OL>  </ol></li>
 <LI>As postinstall.pl runs, you will be asked various questions.  Follow the instructions to correctly  </ol>
 enter in the appropriate parameter values.  <hr />
 </OL>  <p>
 <HR>  You can also try to install LON-CAPA on an existing installation of
 <H1>Old steps; do not use these...</H1>  RedHat 6.2.  Please see <a
 Last updated: 11/01/2000  href='how_to_install_loncapa_on_a_preinstalled_system.txt'>
 </P>  how_to_install_loncapa_on_a_preinstalled_system.txt</a>.
 <P>  </p>
 This is the current list of steps to support LON-CAPA installation.  These steps have  </body>
 been tested.  </html>
 <OL>  
 <LI>Get Redhat 6.2 on a CD by  
 <UL>  
 <LI>Using a RedHat 6.2 CD  
 <LI>Downloading a RedHat 6.2 <A HREF="http://install.lon-capa.org/3.1/currentcdimage">CD image</A> and burning a CD  
 <LI>Or, alternatively do a network install from a <A HREF="http://install.lon-capa.org/3.1/currentcdsource">  
 RedHat 6.2 CD source tree</A>.  You need to burn a boot floppy disk with a network boot image;  
 <A HREF="http://install.lon-capa.org/3.1/currentcdsource/images/bootnet-20000407.img">  
 bootnet-20000407.img</A>.  (Download the image file; insert a blank floppy disk; and type a  
 command similar to: <TT>dd if=bootnet-20000407.img of=/dev/fd0</TT>).  For installation, you  
 need to specify <TT>hobbes.lite.msu.edu/~loninst</TT> as your download URL, and <TT>/3.1/currentcdsource</TT>  
 as the source location.  
 </UL>  
 <LI>Install RedHat 6.2  
 <UL>  
 <LI><B>Important: Do a "GNOME Workstation Install" and go with their default list of packages</B>  
 <LI><B>Important: Make sure you add a user "www"</B>  
 </UL>  
 <LI>After installation, install extra RPMs/upgrades by downloading all files from  
 <A HREF="http://install.lon-capa.org/3.1/SupplementalRPMS/">  
 http://install.lon-capa.org/3.1/SupplementalRPMS</A>.  
 <UL>  
 <LI>Use this command to install the RPMs you download: <TT>rpm -Uvh --force *.rpm</TT>.  
 </UL>  
 <LI>Remove extra RPMs by downloading and running the script   
 <A HREF="http://install.lon-capa.org/3.1/scripts/remove_extra.sh">  
 http://install.lon-capa.org/3.1/scripts/remove_extra.sh</A> as root.  
 <LI>After installing the supplemental RPMS, install a final RPM set by downloading all files from  
 <A HREF="http://install.lon-capa.org/3.1/FinalRPMS/">  
 http://install.lon-capa.org/3.1/FinalRPMS</A>.  
 <UL>  
 <LI>Use this command to install the RPMs you download: <TT>rpm -Uvh --force *.rpm</TT>.  
 </UL>  
 <LI>Configure needed files.  
 <UL>  
 <LI>Currently, reconfiguration must be handled manually and involves an administrator  
 altering configuration files present throughout the system.  For a list of these  
 files and their descriptions, visit <A HREF="http://install.lon-capa.org/3.1/loncapafiles/loncapafiles.html">  
 http://install.lon-capa.org/3.1/loncapafiles/loncapafiles.html</A>.  
 </UL>  
 <LI>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).  
 <LI>Unshadow passwords  
 <UL>  
 <PRE>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.  
 </PRE>  
 </UL>  
 <LI>Run, as root, <TT>ln -s /etc/mime.types /etc/httpd/conf/mime.types</TT>  
 <LI>Run, as root, <TT>/etc/rc.d/init.d/httpd start</TT>.  
 <LI>Run, as root, <TT>/etc/rc.d/init.d/loncontrol start</TT>.  
 <LI>After 10 minutes, you should be able to check the file <TT>/home/httpd/html/lon-status/index.html</TT>  
 to see if your machine has been successfully set up.  
 </UL>  
 </OL>  
 </P>  
 <H3>Future Installation Procedure (not yet implemented)</H3>  
 <P>  
 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.  
 </P>  
 </BODY>  
 </HTML>  
Removed from v.1.8  
changed lines
  Added in v.1.13

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>