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

version 1.1, 2002/05/22 22:02:59 version 1.5, 2002/06/06 22:34:24
Line 1 Line 1
 <html><head><title>Setting up a Red Hat7.3 LON-CAPA Server</title></head><body>  <html><head><title>Setting up a Red Hat7.3 LON-CAPA Server</title></head><body>
 <!-- $Id$ -->  <!-- $Id$ -->
 <h1>Setting up a Red Hat7.3 LON-CAPA Server</h1>  <h1>Setting up a Red Hat 7.3 LON-CAPA Server</h1>
   
 <h2>Before you begin</h2>  <h2>Before you begin</h2>
 <p>  <p>
Line 14  some routine Unix commands.  Some famili Line 14  some routine Unix commands.  Some famili
 <p>  <p>
 The installation process takes the following steps:  The installation process takes the following steps:
 <ol>  <ol>
   <li> Obtain Red Hat 7.3    <li> Obtain Red Hat 7.3 </li>
   <li> Gather information for installing Red Hat    <li> Gather information for installing Red Hat </li>
   <li> Install Red Hat 7.3    <li> Install Red Hat 7.3 </li>
   <li> Determine your LON-CAPA Settings    <li> Determine your LON-CAPA Settings </li>
   <li> Install LON-CAPA    <li> Install LON-CAPA </li>
   <li> Configure LON-CAPA    <li> Configure LON-CAPA </li>
   <li> Pick a hosts.tab file    <li> Pick a hosts.tab file </li>
   <li> Create a Domain Coordinator    <li> Create a Domain Coordinator </li>
   <li> Start/Restart services    <li> Start/Restart services </li>
   <li> Log in to LON-CAPA    <li> Log in to LON-CAPA </li>
 </ol>  </ol>
 </p>  </p>
   
Line 31  The installation process takes the follo Line 31  The installation process takes the follo
 <p>  <p>
 If you like, you may contact the LON-CAPA development staff and we can  If you like, you may contact the LON-CAPA development staff and we can
 mail the CDs to you.  Another option is to download the cd images and   mail the CDs to you.  Another option is to download the cd images and 
 burn them yourself.  burn them yourself, or install from a mirror site using ftp or http.
 </p>  </p>
   
 <h2>Gather information for the Red Hat Installation</h2>  <h2>Determine Network settings for your site</h2>
 <p>  
 You will need to gather some network information for your server.  You will   
 also need to determine some of the LON-CAPA configuration information before   
 you begin.  
 </p>  
 <h3>Network settings for your site</h3>  
 <p>  <p>
   You will need to have the following information for your site.  You must
   have a static IP address (do not use DHCP).
 <ul>  <ul>
   <li>ip address    <li>ip address </li>
   <li>netmask    <li>netmask </li>
   <li>network    <li>network </li>
   <li>broadcast    <li>broadcast </li>
   <li>hostname    <li>hostname </li>
   <li>gateway    <li>gateway </li>
   <li>domain name server(s)    <li>domain name server(s) </li>
 </ul>  </ul>
 </p>  </p>
   
Line 78  is in the order the issues appear in the Line 74  is in the order the issues appear in the
    <dt>Package Group Selection     <dt>Package Group Selection
    <dd>At a minimum, install the following packages:     <dd>At a minimum, install the following packages:
       <ul>        <ul>
         <li>NFS File Server          <li>NFS File Server </li>
         <li>Windows File Server          <li>Windows File Server </li>
         <li>Web Server          <li>Web Server </li>
       </ul>        </ul>
        Other packages can be installed as you like.         Other packages can be installed as you like.
    <dt>X Windows Configuration     <dt>X Windows Configuration
Line 91  is in the order the issues appear in the Line 87  is in the order the issues appear in the
 Other notes:  Other notes:
 <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).        the default). </li>
 </ul>  </ul>
 </p>  </p>
   
Line 110  for it to function at all.  Below is a l Line 106  for it to function at all.  Below is a l
   <dt>LON-CAPA domain    <dt>LON-CAPA domain
   <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.        meaningful. <i>Restriction: One word, no hyphens, underscores, or special characters!</i>
   <dt>LON-CAPA host id    <dt>LON-CAPA host id
   <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.        such as "msul1" for the first library server. <i>Restriction: 
   One word, no hyphens, underscores, or special characters!</i>
   <dt>Host administrator email    <dt>Host administrator email
   <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.        are sent every time the system starts up, or if the system is in serious
   trouble. On a laptop, make this <tt>root@localhost</tt>.
   <dt>Root password for SQL database    <dt>Root password for SQL database
   <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.
Line 144  cd /root/loncapa/ Line 142  cd /root/loncapa/
 </pre>  </pre>
 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.  Additionally, you will need to enter the following information 
 (options 5 and 6 in the menu):  (options 5 and 6 in the menu, recommended settings):
 <dl>  <dl>
    <dt>Cache Expiration Time     <dt>Cache Expiration Time
    <dd>86400     <dd>86400
    <dt>Server Load     <dt>Server Load
    <dd>2.0     <dd>2.0
 </dl>  </dl>
   You can deviate from the above settings if you know what you are doing.
 </p>  </p>
   
 <h2>Picking a hosts.tab file</h2>  <h2>Picking a hosts.tab file</h2>
 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".  Please contact the support staff at www.loncapa.org for  "hosts.tab".  On a laptop, you must choose 'standalone'.
   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>
   <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 
   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 
   format
   <pre>
   lonHostID:domain:hosttype:dns-name:ipaddress
   </pre>
   for example
   <pre>
   103l5:library:s17.lite.msu.edu:35.8.63.27
   </pre>
   Please edit this file with a UNIX editor, not a PC or Mac one, so that the 
   linebreaks are correct.
     
   </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
 'domain coordinator'.  This user creates accounts for other users and  'domain coordinator'.  This user creates accounts for other users and
 grants them additional privileges.  The make_domain_coordinator.pl script  grants them additional privileges.  The make_domain_coordinator.pl script
 invoked below requires that you enter the users password.  The password will  invoked below requires that you enter the users password.  The password will
 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.
 <pre>  <pre>
 cd /root/loncapa/loncom/build  cd /root/loncapa/loncom/build
 perl make_domain_coordinator.pl USERNAME DOMAIN  perl make_domain_coordinator.pl USERNAME DOMAIN
   (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
Line 187  The services take about 10 minutes to st Line 204  The services take about 10 minutes to st
 </pre>  </pre>
 </p>  </p>
   
   <h2>Make Sure that Services Autostart on Boot</h2>
   <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 
   daemons to be started at boot:
   <pre>
   httpd
   mysqld
   </pre>
   It is not necessary to reboot after doing this as they should already be 
   running by this point in the installation.  
   <pre>
   /etc/init.d/httpd restart
   /etc/init.d/mysqld restart
   </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

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


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