Diff for /doc/install/redhat7.3/new_install_rh73.html between versions 1.5 and 1.12

version 1.5, 2002/06/06 22:34:24 version 1.12, 2003/01/06 18:11:39
Line 1 Line 1
 <html><head><title>Setting up a Red Hat7.3 LON-CAPA Server</title></head><body>  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
   <html>
   <head>
   <meta http-equiv="Content-Type" content="text/html; charset=utf-8"></meta>
   <title>Setting up a Red Hat7.3 LON-CAPA Server</title>
   </head>
   <body>
 <!-- $Id$ -->  <!-- $Id$ -->
 <h1>Setting up a Red Hat 7.3 LON-CAPA Server</h1>  <h1>Setting up a Red Hat 7.3 LON-CAPA Server</h1>
   <h2>Integrated installation</h2>
   <p>
   These instructions combine the installation of RedHat 7.3 and LON-CAPA
   into one straightforward process. 
   More information is available at <a href="http://install.lon-capa.org/">
   http://install.lon-capa.org/</a>.
   </p>
   
 <h2>Before you begin</h2>  <h2>Before you begin</h2>
 <p>  <p>
Line 13  some routine Unix commands.  Some famili Line 27  some routine Unix commands.  Some famili
 <h2>Installation Overview</h2>  <h2>Installation Overview</h2>
 <p>  <p>
 The installation process takes the following steps:  The installation process takes the following steps:
   </p>
 <ol>  <ol>
   <li> Obtain Red Hat 7.3 </li>    <li> Obtain Red Hat 7.3 </li>
   <li> Gather information for installing Red Hat </li>    <li> Gather information for installing Red Hat </li>
Line 25  The installation process takes the follo Line 40  The installation process takes the follo
   <li> Start/Restart services </li>    <li> Start/Restart services </li>
   <li> Log in to LON-CAPA </li>    <li> Log in to LON-CAPA </li>
 </ol>  </ol>
 </p>  
   
 <h2>Obtain the Red Hat 7.3 installation CDs</h2>  <h2>Obtain the Red Hat 7.3 installation CDs</h2>
 <p>  <p>
 If you like, you may contact the LON-CAPA development staff and we can  These are freely available on the internet.
 mail the CDs to you.  Another option is to download the cd images and   
 burn them yourself, or install from a mirror site using ftp or http.  
 </p>  </p>
   
 <h2>Determine Network settings for your site</h2>  <h2>Determine Network settings for your site</h2>
 <p>  <p>
 You will need to have the following information for your site.  You must  You will need to have the following information for your site.  You must
 have a static IP address (do not use DHCP).  have a static IP address (do not use DHCP).
   </p>
 <ul>  <ul>
   <li>ip address </li>    <li>ip address </li>
   <li>netmask </li>    <li>netmask </li>
Line 47  have a static IP address (do not use DHC Line 60  have a static IP address (do not use DHC
   <li>gateway </li>    <li>gateway </li>
   <li>domain name server(s) </li>    <li>domain name server(s) </li>
 </ul>  </ul>
 </p>  
   
 <h2>Install Red Hat 7.3</h2>  <h2>Install Red Hat 7.3</h2>
 <p>  <p>
 When you install RedHat you will need to ensure the following (the list below  When you install RedHat you will need to ensure the following (the list below
 is in the order the issues appear in the installation of Red Hat 7.3):  is in the order the issues appear in the installation of Red Hat 7.3):
   </p>
 <dl>  <dl>
    <dt>Installation Type     <dt>Installation Type</dt>
    <dd>You should definitely do a "Server" install.  We do not recommend     <dd>You should definitely do a "Server" install.  We do not recommend
        Trying to install LON-CAPA with a different installation type.         Trying to install LON-CAPA with a different installation type.</dd>
    <dt>Partitioning your Drive     <dt>Partitioning your Drive</dt>
    <dd>You may want to use the automatic partitioning feature of Red Hat,     <dd>You may want to use the automatic partitioning feature of Red Hat,
        however you should review the results and be prepared to modify them.         however you should review the results and be prepared to modify them.
        LON-CAPA resource files are stored in the /home directory, so the         LON-CAPA resource files are stored in the /home directory, so the
        lion's share of the drive should be allocated here.  If you have 8 GB          lion's share of the drive should be allocated here.  If you have 8 GB 
        of space for Red Hat, /home should receive 4 to 6 gigs.  Be sure to          of space for Red Hat, /home should receive 4 to 6 gigs.  Be sure to 
        include adequate swap space.  A minimum is 512 Megs, but you should         include adequate swap space.  A minimum is 512 Megs, but you should
        typically have 1 or 2x as much swap space as you do physical RAM.         typically have 1 or 2x as much swap space as you do physical RAM.</dd>
    <dt>Network Configuration     <dt>Network Configuration</dt>
    <dd>LON-CAPA will <b>not</b> work with a machine set up to use a dynamic      <dd>LON-CAPA will <b>not</b> work with a machine set up to use a dynamic 
        IP address.  When configuring your network card, be sure to unselect         IP address.  When configuring your network card, be sure to unselect
        the DHCP option and enter in your network information.         the DHCP option and enter in your network information.</dd>
    <dt>Firewall Configuration     <dt>Firewall Configuration</dt>
    <dd>The installation script will remove and disable your firewall.     <dd>The installation script will remove and disable your firewall.</dd>
    <dt>Package Group Selection     <dt>Package Group Selection</dt>
    <dd>At a minimum, install the following packages:     <dd>At a minimum, install the following packages:
       <ul>        <ul>
         <li>NFS File Server </li>          <li>NFS File Server </li>
         <li>Windows File Server </li>          <li>Windows File Server </li>
         <li>Web Server </li>          <li>Web Server </li>
       </ul>        </ul>
        Other packages can be installed as you like.         Other packages can be installed as you like.</dd>
    <dt>X Windows Configuration     <dt>X Windows Configuration</dt>
    <dd>If you chose to install the X-windows packages you will need to      <dd>If you chose to install the X-windows packages you will need to 
        configure them.  If you are unsure of the support for your video         configure them.  If you are unsure of the support for your video
        card you may wish to skip the configuration.         card you may wish to skip the configuration.</dd>
 </dl>  </dl>
   <p>
 Other notes:  Other notes:
   </p>
 <ul>  <ul>
   <li>Use md5 and shadow passwords if you are given the choice (this is    <li>Use md5 and shadow passwords if you are given the choice (this is
       the default). </li>        the default). </li>
 </ul>  </ul>
 </p>  
   
 <h2>Determine LON-CAPA settings</h2>  <h2>Determine LON-CAPA settings</h2>
 <p>  <p>
 LON-CAPA requires a number of identifying parameters be set in order  LON-CAPA requires a number of identifying parameters be set in order
 for it to function at all.  Below is a list with descriptions.  for it to function at all.  Below is a list with descriptions.
   </p>
 <dl>  <dl>
   <dt>Host Type (library or access)    <dt>Host Type (library or access)</dt>
   <dd>The server must be designated a 'library' or an 'access' server.  In    <dd>The server must be designated a 'library' or an 'access' server.  In
       general you should have a library server for your instructors to create        general you should have a library server for your instructors to create
       their course content on and run their courses.  Students should connect        their course content on and run their courses.  Students should connect
       to access servers.  If you are doing the first install of LON-CAPA at         to access servers.  If you are doing the first install of LON-CAPA at 
       your site, or if you are playing with it for your own edification, you        your site, or if you are playing with it for your own edification, you
       should make your machine a 'library' server.        should make your machine a 'library' server.</dd>
   <dt>LON-CAPA domain    <dt>LON-CAPA domain</dt>
   <dd>Each site or school which installs LON-CAPA needs its own domain.    <dd>Each site or school which installs LON-CAPA needs its own domain.
       Here at MSU we use 'msu'.  You should choose something short but        Here at MSU we use 'msu'.  You should choose something short but
       meaningful. <i>Restriction: One word, no hyphens, underscores, or special characters!</i>        meaningful.
   <dt>LON-CAPA host id     <i>Restriction: One word, no hyphens, underscores, or special characters</i>
     </dd>
     <dt>LON-CAPA host id</dt>
   <dd>Each LON-CAPA server requires a unique internal name.  We use names    <dd>Each LON-CAPA server requires a unique internal name.  We use names
       such as "msul1" for the first library server. <i>Restriction:         such as "msul1" for the first library server. 
 One word, no hyphens, underscores, or special characters!</i>     <i>Restriction: One word, no hyphens, underscores, or special characters</i>
   <dt>Host administrator email    </dd>
     <dt>Host administrator email</dt>
   <dd>The amount of email sent to this address is relatively minimal.  Messages    <dd>The amount of email sent to this address is relatively minimal.  Messages
       are sent every time the system starts up, or if the system is in serious        are sent every time the system starts up, or if the system is in 
 trouble. On a laptop, make this <tt>root@localhost</tt>.        serious trouble. On a laptop, make this <tt>root@localhost</tt>.
   <dt>Root password for SQL database    </dd>
     <dt>Root password for SQL database</dt>
   <dd>In order to keep people from corrupting the MYSQL database, a root    <dd>In order to keep people from corrupting the MYSQL database, a root
       password is needed.  You'll need to remember this.        password is needed.  You'll need to remember this.</dd>
 </dl>  </dl>
 </p>  
   
 <h2>Install LON-CAPA</h2>  <h2>Install LON-CAPA</h2>
 <p>  <p>
 Log in as root with the password you provided during the Red Hat   Log in as root with the password you provided during the Red Hat 
 installation process.  installation process.
   </p><p>
   Stop the http daemon while we're installing LON-CAPA.
   <pre>
   /etc/init.d/httpd stop
   </pre>
   </p><p>
   Retrieve the LON-CAPA installation package
 <pre>  <pre>
 wget http://install.loncapa.org/versions/rh73install/loncapa-rh73install.tar  wget http://install.loncapa.org/versions/rh73install/loncapa-rh73install.tar
 tar xf loncapa-rh73install.tar  tar xf loncapa-rh73install.tar
Line 136  cd install Line 161  cd install
 <h2>Configure LON-CAPA</h2>  <h2>Configure LON-CAPA</h2>
 <p>  <p>
 Execute the following commands  Execute the following commands
   </p>
 <pre>  <pre>
 cd /root/loncapa/  cd /root/loncapa-N.N     (N.N should correspond to a version number like '0.6')
 ./UPDATE  ./UPDATE
 </pre>  </pre>
   <p>
 You will need to enter the LON-CAPA configuration information you requested  You will need to enter the LON-CAPA configuration information you requested
 above.  Additionally, you will need to enter the following information   above.
 (options 5 and 6 in the menu, recommended settings):  </p>
 <dl>  
    <dt>Cache Expiration Time  <h2>Update your system</h2>
    <dd>86400  <p>
    <dt>Server Load  It is very important that you update your LON-CAPA system to use the
    <dd>2.0  latest RedHat packages.  LON-CAPA uses CHECKRPMS to notify users their system
 </dl>  needs updating.  
 You can deviate from the above settings if you know what you are doing.  <pre>
   /usr/local/loncapa/bin/CHECKRPMS
   </pre>
   CHECKRPMS will give you the option of downloading the updates you need.
   Say yes.  Then issue the following commands:
   <pre>
   cd /tmp/loncapa_rpm_updates'
   rpm -Uvh *
   </pre>
   </p><p>
   You will need to reboot your system to begin running the new Linux Kernel
   put out by RedHat.  You can wait until the end of the LON-CAPA installation
   process to reboot.
   </p><p>
   Congratulate yourself - your system is up to date.  Please do your best to
   keep it that way!  When LON-CAPA is installed it sets itself up to run 
   CHECKRPMS script every night and email you the results.  
   <b>Please do not ignore these emails.</b>  
   You will need to update the RPMs yourself when it notifies you.  
   Keeping your system up-to-date goes a long way towards ensuring the 
   integrity of your student records.
 </p>  </p>
   
 <h2>Picking a hosts.tab file</h2>  <h2>Picking a hosts.tab file</h2>
   <p>
 The "hosts.tab" file controls which LON-CAPA servers your server attempts   The "hosts.tab" file controls which LON-CAPA servers your server attempts 
 to access and which servers it will respond to.  If this is your first   to access and which servers it will respond to.  If this is your first 
 install of LON-CAPA on your network, we suggest choosing a 'standalone'   install of LON-CAPA on your network, we suggest choosing a 'standalone' 
 "hosts.tab".  On a laptop, you must choose 'standalone'.  "hosts.tab".  On a laptop, you must choose 'standalone'.
 Please contact the support staff at www.loncapa.org for  Please contact the support staff at www.loncapa.org for
 information about adding more hosts to your "hosts.tab" file.  information about adding more hosts to your "hosts.tab" file.
   </p>
 <p>  <p>
 <b>Note:</b> for <b>non</b>-standalone configurations, you do need to add   <b>Note:</b> for <b>non</b>-standalone configurations, you do need to add 
 yourself  to the <tt>/home/httpd/lonTabs/hosts.tab</tt> to initially test your   yourself  to the <tt>/home/httpd/lonTabs/hosts.tab</tt> to initially test your 
 configuration. Eventually, you will be added to the general cluster tables by  configuration. Eventually, you will be added to the general cluster tables by
 LON-CAPA staff, so this is temporary. A <tt>hosts.tab</tt> entry has the   LON-CAPA staff, so this is temporary. A <tt>hosts.tab</tt> entry has the 
 format  format
   </p>
 <pre>  <pre>
 lonHostID:domain:hosttype:dns-name:ipaddress  lonHostID:domain:hosttype:dns-name:ipaddress
 </pre>  </pre>
   <p>
 for example  for example
   </p>
 <pre>  <pre>
 103l5:library:s17.lite.msu.edu:35.8.63.27  103l5:library:s17.lite.msu.edu:35.8.63.27
 </pre>  </pre>
   <p>
 Please edit this file with a UNIX editor, not a PC or Mac one, so that the   Please edit this file with a UNIX editor, not a PC or Mac one, so that the 
 linebreaks are correct.  linebreaks are correct.
     
 </p>  </p>
   
 <h2>Creating a Domain Coordinator</h2>  <h2>Creating a Domain Coordinator</h2>
 <p>  <p>
 You will need at least one user at your site who has the role of  You will need at least one user at your site who has the role of
Line 185  invoked below requires that you enter th Line 238  invoked below requires that you enter th
 show in plaintext as you type it.  Feel free to use the "passwd username"  show in plaintext as you type it.  Feel free to use the "passwd username"
 command to change it later.  Replace USERNAME and DOMAIN with an   command to change it later.  Replace USERNAME and DOMAIN with an 
 appropriate user name and your domain.  appropriate user name and your domain.
   </p>
 <pre>  <pre>
 cd /root/loncapa/loncom/build  cd /root/loncapa-N.N/loncom/build
 perl make_domain_coordinator.pl USERNAME DOMAIN  perl make_domain_coordinator.pl USERNAME DOMAIN
 (WILL PROMPT FOR PASSWORD HERE)  (WILL PROMPT FOR PASSWORD HERE)
 mkdir ~USERNAME/public_html  mkdir ~USERNAME/public_html
 chown USERNAME:www ~USERNAME/public_html  chown USERNAME:www ~USERNAME/public_html
 chmod 0775 ~USERNAME/public_html  chmod 0775 ~USERNAME/public_html
   chmod a+x ~USERNAME
 </pre>  </pre>
 </p>  
   
 <h2>Start/Restart Services</h2>  <h2>Start/Restart Services</h2>
 <p>  <p>
 The services take about 10 minutes to start.  The LON-CAPA network services take about a minute to start.
   </p>
 <pre>  <pre>
 /etc/init.d/loncontrol start  /etc/init.d/loncontrol start
 /etc/init.d/httpd restart  /etc/init.d/httpd restart
 </pre>  </pre>
 </p>  
   
 <h2>Make Sure that Services Autostart on Boot</h2>  <h2>Make Sure that Services Autostart on Boot</h2>
 <p>On Redhat 7.3 it is not guaranteed that Apache and MySQL automatically   <p>On Redhat 7.3 it is not guaranteed that Apache and MySQL automatically 
 restart on boot.  You should run /usr/sbin/ntsysv and set the following   restart on boot.  You should run /usr/sbin/ntsysv and set the following 
 daemons to be started at boot:  daemons to be started at boot:
   </p>
 <pre>  <pre>
 httpd  httpd
 mysqld  mysqld
 </pre>  </pre>
   <p>
 It is not necessary to reboot after doing this as they should already be   It is not necessary to reboot after doing this as they should already be 
 running by this point in the installation.    running by this point in the installation.  
   </p>
 <pre>  <pre>
 /etc/init.d/httpd restart  /etc/init.d/httpd restart
 /etc/init.d/mysqld restart  /etc/init.d/mysqld restart
 </pre>  </pre>
 </p>  
 <h2>Log in to your LON-CAPA Machine</h2>  <h2>Log in to your LON-CAPA Machine</h2>
 <p>  <p>
 Point a web browser at your new machine and log in as the domain  Point a web browser at your new machine and log in as the domain
 coordinator.  Congratulations!  coordinator.  Congratulations!
 </p>  </p>
   </body>
   </html>
   

Removed from v.1.5  
changed lines
  Added in v.1.12


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