Diff for /doc/gutshtml/FastInstallation.html between versions 1.1 and 1.2

version 1.1, 2002/06/28 20:30:29 version 1.2, 2003/07/22 14:47:00
Line 1 Line 1
 <html xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns="http://www.w3.org/TR/REC-html40"> <head> <meta name=Title content="Fast Installation: Setting up a Red Hat 7"> <meta name=Keywords content=""> <meta http-equiv=Content-Type content="text/html; charset=macintosh"> <meta name=ProgId content=Word.Document> <meta name=Generator content="Microsoft Word 10"> <meta name=Originator content="Microsoft Word 10"> <link rel=File-List href="Fast%20Installation_files/filelist.xml"> <title>Fast Installation: Setting up a Red Hat 7</title> <!--[if gte mso 9]><xml> <o:DocumentProperties>  <o:Author>Gerd Kortemeyer</o:Author>  <o:Template>Normal</o:Template>  <o:Revision>1</o:Revision>  <o:TotalTime>0</o:TotalTime>  <o:Created>2002-06-27T21:54:00Z</o:Created>  <o:Pages>1</o:Pages>  <o:Words>1010</o:Words>  <o:Characters>5762</o:Characters>  <o:Company>Michigan State University</o:Company>  <o:Lines>48</o:Lines>  <o:Paragraphs>11</o:Paragraphs>  <o:CharactersWithSpaces>7076</o:CharactersWithSpaces>  <o:Version>10.1412</o:Version> </o:DocumentProperties> <o:OfficeDocumentSettings>  <o:AllowPNG/>  <o:DownloadComponents>120</o:DownloadComponents>  <o:PixelsPerInch>1600x1200</o:PixelsPerInch> </o:OfficeDocumentSettings> </xml><![endif]--><!--[if gte mso 9]><xml> <w:WordDocument>  <w:Zoom>0</w:Zoom>  <w:DisplayHorizontalDrawingGridEvery>0</w:DisplayHorizontalDrawingGridEvery>  <w:DisplayVerticalDrawingGridEvery>0</w:DisplayVerticalDrawingGridEvery>  <w:UseMarginsForDrawingGridOrigin/> </w:WordDocument> </xml><![endif]--> <style> <!-- /* Font Definitions */ @font-face {font-family:"Times New Roman"; panose-1:0 2 2 6 3 5 4 5 2 3; mso-font-charset:0; mso-generic-font-family:auto; mso-font-pitch:variable; mso-font-signature:50331648 0 0 0 1 0;} @font-face {font-family:Arial; panose-1:0 2 11 6 4 2 2 2 2 2; mso-font-charset:0; mso-generic-font-family:auto; mso-font-pitch:variable; mso-font-signature:50331648 0 0 0 1 0;} @font-face {font-family:"Courier New"; panose-1:0 2 7 3 9 2 2 5 2 4; mso-font-charset:0; mso-generic-font-family:auto; mso-font-pitch:variable; mso-font-signature:50331648 0 0 0 1 0;} @font-face {font-family:Wingdings; panose-1:0 5 2 1 2 1 8 4 8 7; mso-font-charset:2; mso-generic-font-family:auto; mso-font-pitch:variable; mso-font-signature:0 16 0 0 -2147483648 0;} /* Style Definitions */ p.MsoNormal, li.MsoNormal, div.MsoNormal {mso-style-parent:""; margin:0in; margin-bottom:.0001pt; mso-pagination:widow-orphan; font-size:12.0pt; font-family:Times;} h1 {mso-style-next:Normal; margin:0in; margin-bottom:.0001pt; mso-pagination:widow-orphan; page-break-after:avoid; mso-outline-level:1; font-size:14.0pt; font-family:"Times New Roman"; mso-font-kerning:0pt; font-weight:bold;} h2 {mso-style-next:Normal; margin-top:12.0pt; margin-right:0in; margin-bottom:3.0pt; margin-left:0in; mso-pagination:widow-orphan; page-break-after:avoid; mso-outline-level:2; font-size:12.0pt; font-family:Arial; font-weight:bold; font-style:italic;} p {margin-right:0in; mso-margin-top-alt:auto; mso-margin-bottom-alt:auto; margin-left:0in; mso-pagination:widow-orphan; font-size:12.0pt; font-family:"Times New Roman";} pre {margin:0in; margin-bottom:.0001pt; mso-pagination:widow-orphan; tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size:10.0pt; font-family:"Courier New";} tt {} @page Section1 {size:8.5in 11.0in; margin:1.0in 1.25in 1.0in 1.25in; mso-header-margin:.5in; mso-footer-margin:.5in; mso-paper-source:0;} div.Section1 {page:Section1;} @page Section2 {size:8.5in 11.0in; margin:1.0in 1.25in 1.0in 1.25in; mso-header-margin:.5in; mso-footer-margin:.5in; mso-paper-source:0;} div.Section2 {page:Section2;} /* List Definitions */ @list l0 {mso-list-id:526917976; mso-list-type:hybrid; mso-list-template-ids:-1331112906 -1406905024 -344398962 1467254890 -638782688 -1081826792 -637395960 -765828298 -2120437558 -454631360;} @list l0:level1 {mso-level-number-format:bullet; mso-level-text:\F0B7; mso-level-tab-stop:.5in; mso-level-number-position:left; text-indent:-.25in; font-size:10.0pt; font-family:Symbol;} @list l1 {mso-list-id:716245914; mso-list-type:hybrid; mso-list-template-ids:-1772223172 1239213712 -1405203140 -1939727986 -1001496134 -1507811686 436794448 1330569048 -202857512 871669244;} @list l1:level1 {mso-level-tab-stop:.5in; mso-level-number-position:left; text-indent:-.25in;} @list l2 {mso-list-id:1211651025; mso-list-type:hybrid; mso-list-template-ids:1720480662 -1156523330 764584900 693815576 577507578 -1668380266 -358728502 1637385602 869286030 86140684;} @list l2:level1 {mso-level-number-format:bullet; mso-level-text:\F0B7; mso-level-tab-stop:.5in; mso-level-number-position:left; text-indent:-.25in; font-size:10.0pt; font-family:Symbol;} @list l3 {mso-list-id:1738747246; mso-list-type:hybrid; mso-list-template-ids:589056050 295589242 -1260124096 -821652718 -1874822846 1139856888 962002586 434413380 -1859721930 -926639952;} @list l3:level1 {mso-level-number-format:bullet; mso-level-text:\F0B7; mso-level-tab-stop:.5in; mso-level-number-position:left; text-indent:-.25in; font-size:10.0pt; font-family:Symbol;} ol {margin-bottom:0in;} ul {margin-bottom:0in;} --> </style> </head> <body bgcolor=white lang=EN-US style='tab-interval:.5in'> <div class=Section1> <h1>Fast Installation: Setting up a Red Hat 7.3 LON-CAPA Server</h1> <h2><a name="_Toc421867176">Before you begin</a></h2> <p>Installing Linux is getting easier and easier. However, it is still a non-trivial undertaking and experience with Red Hat Linux will make this process easier. You will be required to log in to the machine and execute some routine Unix commands. Some familiarity with Linux is assumed. </p> <h2><a name="_Toc421867177">Installation Overview</a></h2> <p>The installation process takes the following steps: </p> <p class=MsoNormal style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo1; tab-stops:list .5in'><![if !supportLists]>1.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp; </span><![endif]>Obtain Red Hat 7.3 </p> <p class=MsoNormal style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo1; tab-stops:list .5in'><![if !supportLists]>2.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp; </span><![endif]>Gather information for installing Red Hat </p> <p class=MsoNormal style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo1; tab-stops:list .5in'><![if !supportLists]>3.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp; </span><![endif]>Install Red Hat 7.3 </p> <p class=MsoNormal style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo1; tab-stops:list .5in'><![if !supportLists]>4.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp; </span><![endif]>Determine your LON-CAPA Settings </p> <p class=MsoNormal style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo1; tab-stops:list .5in'><![if !supportLists]>5.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp; </span><![endif]>Install LON-CAPA </p> <p class=MsoNormal style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo1; tab-stops:list .5in'><![if !supportLists]>6.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp; </span><![endif]>Configure LON-CAPA </p> <p class=MsoNormal style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo1; tab-stops:list .5in'><![if !supportLists]>7.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp; </span><![endif]>Pick a hosts.tab file </p> <p class=MsoNormal style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo1; tab-stops:list .5in'><![if !supportLists]>8.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp; </span><![endif]>Create a Domain Coordinator </p> <p class=MsoNormal style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo1; tab-stops:list .5in'><![if !supportLists]>9.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp; </span><![endif]>Start/Restart services </p> <p class=MsoNormal style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo1; tab-stops:list .5in'><![if !supportLists]>10.<span style='font:7.0pt "Times New Roman"'>&nbsp; </span><![endif]>Log in to LON-CAPA </p> <h2><a name="_Toc421867178">Obtain the Red Hat 7.3 installation CDs</a></h2> <p>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 burn them yourself, or install from a mirror site using ftp or http. </p> <h2><a name="_Toc421867179">Determine Network settings for your site</a></h2> <p>You will need to have the following information for your site. You must have a static IP address (do not use DHCP). </p> <ul style='margin-top:0in' type=disc> <li class=MsoNormal style='mso-list:l0 level1 lfo2;tab-stops:list .5in'>ip     address </li> <li class=MsoNormal style='mso-list:l0 level1 lfo2;tab-stops:list .5in'>netmask     </li> <li class=MsoNormal style='mso-list:l0 level1 lfo2;tab-stops:list .5in'>network     </li> <li class=MsoNormal style='mso-list:l0 level1 lfo2;tab-stops:list .5in'>broadcast     </li> <li class=MsoNormal style='mso-list:l0 level1 lfo2;tab-stops:list .5in'>hostname     </li> <li class=MsoNormal style='mso-list:l0 level1 lfo2;tab-stops:list .5in'>gateway     </li> <li class=MsoNormal style='mso-list:l0 level1 lfo2;tab-stops:list .5in'>domain     name server(s) </li> </ul> <h2><a name="_Toc421867180">Install Red Hat 7.3</a></h2> <p>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): </p> <p class=MsoNormal>Installation Type </p> <p class=MsoNormal style='margin-left:.5in'>You should definitely do a &quot;Server&quot; install. We do not recommend Trying to install LON-CAPA with a different installation type. </p> <p class=MsoNormal>Partitioning your Drive </p> <p class=MsoNormal style='margin-left:.5in'>You may want to use the automatic partitioning feature of Red Hat, however you should review the results and be prepared to modify them. 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 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 typically have 1 or 2x as much swap space as you do physical RAM. </p> <p class=MsoNormal>Network Configuration </p> <p class=MsoNormal style='margin-left:.5in'>LON-CAPA will <b>not</b><span style='font-weight:normal'> work with a machine set up to use a dynamic IP address. When configuring your network card, be sure to unselect the DHCP option and enter in your network information. </span></p> <p class=MsoNormal>Firewall Configuration </p> <p class=MsoNormal style='margin-left:.5in'>The installation script will remove and disable your firewall. </p> <p class=MsoNormal>Package Group Selection </p> <p class=MsoNormal style='margin-left:.5in'>At a minimum, install the following packages: </p> <ul style='margin-top:0in' type=disc> <li class=MsoNormal style='mso-list:l2 level1 lfo3;tab-stops:list .5in'>NFS     File Server </li> <li class=MsoNormal style='mso-list:l2 level1 lfo3;tab-stops:list .5in'>Windows     File Server </li> <li class=MsoNormal style='mso-list:l2 level1 lfo3;tab-stops:list .5in'>Web     Server </li> </ul> <p class=MsoNormal style='margin-left:.5in'>Other packages can be installed as you like. </p> <p class=MsoNormal>X Windows Configuration </p> <p class=MsoNormal style='margin-left:.5in'>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 card you may wish to skip the configuration. </p> <p class=MsoNormal>Other notes: </p> <ul style='margin-top:0in' type=disc> <li class=MsoNormal style='mso-list:l3 level1 lfo4;tab-stops:list .5in'>Use     md5 and shadow passwords if you are given the choice (this is the     default). </li> </ul> <h2><a name="_Toc421867181">Determine LON-CAPA settings</a></h2> <p>LON-CAPA requires a number of identifying parameters be set in order for it to function at all. Below is a list with descriptions. </p> <p class=MsoNormal>Host Type (library or access) </p> <p class=MsoNormal style='margin-left:.5in'>The server must be designated a 'library' or an 'access' server. In general you should have a library server for your instructors to create 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 your site, or if you are playing with it for your own edification, you should make your machine a 'library' server. </p> <p class=MsoNormal>LON-CAPA domain </p> <p class=MsoNormal style='margin-left:.5in'>Each site or school which installs LON-CAPA needs its own domain. Here at MSU we use 'msu'. You should choose something short but meaningful. <i>Restriction: One word, no hyphens, underscores, or special characters!</i><span style='font-style:normal'> </span></p> <p class=MsoNormal>LON-CAPA host id </p> <p class=MsoNormal style='margin-left:.5in'>Each LON-CAPA server requires a unique internal name. We use names such as &quot;msul1&quot; for the first library server. <i>Restriction: One word, no hyphens, underscores, or special characters!</i><span style='font-style:normal'> </span></p> <p class=MsoNormal>Host administrator email </p> <p class=MsoNormal style='margin-left:.5in'>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 trouble. On a laptop, make this <tt><span style='font-family:"Courier New"'>root@localhost</span></tt>. </p> <p class=MsoNormal>Root password for SQL database </p> <p class=MsoNormal style='margin-left:.5in'>In order to keep people from corrupting the MYSQL database, a root password is needed. You'll need to remember this. </p> <h2><a name="_Toc421867182">Install LON-CAPA</a></h2> <p>Log in as root with the password you provided during the Red Hat installation process. </p> <pre><span style="mso-spacerun: yes">&nbsp;</span>wget http://install.loncapa.org/versions/rh73install/loncapa-rh73install.tar tar xf loncapa-rh73install.tar cd install ./install.pl </pre> <h2><a name="_Toc421867183">Configure LON-CAPA</a></h2> <p>Execute the following commands </p> <pre><span style="mso-spacerun: yes">&nbsp;</span>cd /root/loncapa/ ./UPDATE </pre> <p class=MsoNormal>You will need to enter the LON-CAPA configuration information you requested above. Additionally, you will need to enter the following information (options 5 and 6 in the menu, recommended settings): </p> <p class=MsoNormal>Cache Expiration Time </p> <p class=MsoNormal style='margin-left:.5in'>86400 </p> <p class=MsoNormal>Server Load </p> <p class=MsoNormal style='margin-left:.5in'>2.0 </p> <p class=MsoNormal>You can deviate from the above settings if you know what you are doing. </p> <h2><a name="_Toc421867184">Picking a hosts.tab file</a></h2> <p class=MsoNormal>The &quot;hosts.tab&quot; file controls which LON-CAPA servers your server attempts 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' &quot;hosts.tab&quot;. On a laptop, you must choose 'standalone'. Please contact the support staff at www.loncapa.org for information about adding more hosts to your &quot;hosts.tab&quot; file. </p> <p><b>Note:</b><span style='font-weight:normal'> for </span><b>non</b><span style='font-weight:normal'>-standalone configurations, you do need to add yourself to the </span><tt><span style='font-family:"Courier New"'>/home/httpd/lonTabs/hosts.tab</span></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><span style='font-family:"Courier New"'>hosts.tab</span></tt> entry has the format </p> <pre><span style="mso-spacerun: yes">&nbsp;</span>lonHostID:domain:hosttype:dns-name:ipaddress </pre> <p class=MsoNormal>for example </p> <pre><span style="mso-spacerun: yes">&nbsp;</span>103l5:library:s17.lite.msu.edu:35.8.63.27 </pre> <p class=MsoNormal>Please edit this file with a UNIX editor, not a PC or Mac one, so that the linebreaks are correct. </p> <h2><a name="_Toc421867185">Creating a Domain Coordinator</a></h2> <p>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 grants them additional privileges. The make_domain_coordinator.pl script invoked below requires that you enter the users password. The password will show in plaintext as you type it. Feel free to use the &quot;passwd username&quot; command to change it later. Replace USERNAME and DOMAIN with an appropriate user name and your domain. </p> <pre><span style="mso-spacerun: yes">&nbsp;</span>cd /root/loncapa/loncom/build perl make_domain_coordinator.pl USERNAME DOMAIN (WILL PROMPT FOR PASSWORD HERE) mkdir ~USERNAME/public_html chown USERNAME:www ~USERNAME/public_html chmod 0775 ~USERNAME/public_html </pre> <h2><a name="_Toc421867186">Start/Restart Services</a></h2> <p>The services take about 10 minutes to start. </p> <pre><span style="mso-spacerun: yes">&nbsp;</span>/etc/init.d/loncontrol start /etc/init.d/httpd restart </pre> <h2><a name="_Toc421867187">Make Sure that Services Autostart on Boot</a></h2> <p>On Redhat 7.3 it is not guaranteed that Apache and MySQL automatically restart on boot, even when installing with &quot;server&quot; configuration. After logging in as root, check under &quot;Programs&quot; - &quot;System&quot; - &quot;Service Configuration&quot; that &quot;Start on Boot&quot; is checked for httpd and mysqld, save and restart.. </p> <h2><a name="_Toc421867188">Log in to your LON-CAPA Machine</a></h2> <p>Point a web browser at your new machine and log in as the domain coordinator. Congratulations! </p> </div> <span style='font-size:12.0pt;font-family:Times;mso-ansi-language:EN-US'><br clear=ALL style='page-break-before:always;mso-break-type:section-break'> </span> <div class=Section2> <p class=MsoNormal><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></p> </div> </body> </html>  
   
   <html xmlns:o="urn:schemas-microsoft-com:office:office"
   xmlns:w="urn:schemas-microsoft-com:office:word"
   xmlns="http://www.w3.org/TR/REC-html40">
   
   <head>
   <meta name=Title content="Fast Installation: Setting up a Red Hat 7">
   <meta name=Keywords content="">
   <meta http-equiv=Content-Type content="text/html; charset=macintosh">
   <meta name=ProgId content=Word.Document>
   <meta name=Generator content="Microsoft Word 10">
   <meta name=Originator content="Microsoft Word 10">
   <link rel=File-List href="Fast%20Installation_files/filelist.xml">
   <title>Fast Installation: Setting up a Red Hat 7</title>
   <!--[if gte mso 9]><xml>
    <o:DocumentProperties>
     <o:Author>Gerd Kortemeyer</o:Author>
     <o:Template>Normal</o:Template>
     <o:Revision>1</o:Revision>
     <o:TotalTime>0</o:TotalTime>
     <o:Created>2002-06-27T21:54:00Z</o:Created>
     <o:Pages>1</o:Pages>
     <o:Words>1010</o:Words>
     <o:Characters>5762</o:Characters>
     <o:Company>Michigan State University</o:Company>
     <o:Lines>48</o:Lines>
     <o:Paragraphs>11</o:Paragraphs>
     <o:CharactersWithSpaces>7076</o:CharactersWithSpaces>
     <o:Version>10.1412</o:Version>
    </o:DocumentProperties>
    <o:OfficeDocumentSettings>
     <o:AllowPNG/>
     <o:DownloadComponents>120</o:DownloadComponents>
     <o:PixelsPerInch>1600x1200</o:PixelsPerInch>
    </o:OfficeDocumentSettings>
   </xml><![endif]--><!--[if gte mso 9]><xml>
    <w:WordDocument>
     <w:Zoom>0</w:Zoom>
     <w:DisplayHorizontalDrawingGridEvery>0</w:DisplayHorizontalDrawingGridEvery>
     <w:DisplayVerticalDrawingGridEvery>0</w:DisplayVerticalDrawingGridEvery>
     <w:UseMarginsForDrawingGridOrigin/>
    </w:WordDocument>
   </xml><![endif]-->
   <style>
   <!--
    /* Font Definitions */
   @font-face
    {font-family:"Times New Roman";
    panose-1:0 2 2 6 3 5 4 5 2 3;
    mso-font-charset:0;
    mso-generic-font-family:auto;
    mso-font-pitch:variable;
    mso-font-signature:50331648 0 0 0 1 0;}
   @font-face
    {font-family:Arial;
    panose-1:0 2 11 6 4 2 2 2 2 2;
    mso-font-charset:0;
    mso-generic-font-family:auto;
    mso-font-pitch:variable;
    mso-font-signature:50331648 0 0 0 1 0;}
   @font-face
    {font-family:"Courier New";
    panose-1:0 2 7 3 9 2 2 5 2 4;
    mso-font-charset:0;
    mso-generic-font-family:auto;
    mso-font-pitch:variable;
    mso-font-signature:50331648 0 0 0 1 0;}
   @font-face
    {font-family:Wingdings;
    panose-1:0 5 2 1 2 1 8 4 8 7;
    mso-font-charset:2;
    mso-generic-font-family:auto;
    mso-font-pitch:variable;
    mso-font-signature:0 16 0 0 -2147483648 0;}
    /* Style Definitions */
   p.MsoNormal, li.MsoNormal, div.MsoNormal
    {mso-style-parent:"";
    margin:0in;
    margin-bottom:.0001pt;
    mso-pagination:widow-orphan;
    font-size:12.0pt;
    font-family:Times;}
   h1
    {mso-style-next:Normal;
    margin:0in;
    margin-bottom:.0001pt;
    mso-pagination:widow-orphan;
    page-break-after:avoid;
    mso-outline-level:1;
    font-size:14.0pt;
    font-family:"Times New Roman";
    mso-font-kerning:0pt;
    font-weight:bold;}
   h2
    {mso-style-next:Normal;
    margin-top:12.0pt;
    margin-right:0in;
    margin-bottom:3.0pt;
    margin-left:0in;
    mso-pagination:widow-orphan;
    page-break-after:avoid;
    mso-outline-level:2;
    font-size:12.0pt;
    font-family:Arial;
    font-weight:bold;
    font-style:italic;}
   p
    {margin-right:0in;
    mso-margin-top-alt:auto;
    mso-margin-bottom-alt:auto;
    margin-left:0in;
    mso-pagination:widow-orphan;
    font-size:12.0pt;
    font-family:"Times New Roman";}
   pre
    {margin:0in;
    margin-bottom:.0001pt;
    mso-pagination:widow-orphan;
    tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;
    font-size:10.0pt;
    font-family:"Courier New";}
   tt {}
   @page Section1
    {size:8.5in 11.0in;
    margin:1.0in 1.25in 1.0in 1.25in;
    mso-header-margin:.5in;
    mso-footer-margin:.5in;
    mso-paper-source:0;}
   div.Section1
    {page:Section1;}
   @page Section2
    {size:8.5in 11.0in;
    margin:1.0in 1.25in 1.0in 1.25in;
    mso-header-margin:.5in;
    mso-footer-margin:.5in;
    mso-paper-source:0;}
   div.Section2
    {page:Section2;}
    /* List Definitions */
   @list l0
    {mso-list-id:526917976;
    mso-list-type:hybrid;
    mso-list-template-ids:-1331112906 -1406905024 -344398962 1467254890 -638782688 -1081826792 -637395960 -765828298 -2120437558 -454631360;}
   @list l0:level1
    {mso-level-number-format:bullet;
    mso-level-text:\F0B7;
    mso-level-tab-stop:.5in;
    mso-level-number-position:left;
    text-indent:-.25in;
    font-size:10.0pt;
    font-family:Symbol;}
   @list l1
    {mso-list-id:716245914;
    mso-list-type:hybrid;
    mso-list-template-ids:-1772223172 1239213712 -1405203140 -1939727986 -1001496134 -1507811686 436794448 1330569048 -202857512 871669244;}
   @list l1:level1
    {mso-level-tab-stop:.5in;
    mso-level-number-position:left;
    text-indent:-.25in;}
   @list l2
    {mso-list-id:1211651025;
    mso-list-type:hybrid;
    mso-list-template-ids:1720480662 -1156523330 764584900 693815576 577507578 -1668380266 -358728502 1637385602 869286030 86140684;}
   @list l2:level1
    {mso-level-number-format:bullet;
    mso-level-text:\F0B7;
    mso-level-tab-stop:.5in;
    mso-level-number-position:left;
    text-indent:-.25in;
    font-size:10.0pt;
    font-family:Symbol;}
   @list l3
    {mso-list-id:1738747246;
    mso-list-type:hybrid;
    mso-list-template-ids:589056050 295589242 -1260124096 -821652718 -1874822846 1139856888 962002586 434413380 -1859721930 -926639952;}
   @list l3:level1
    {mso-level-number-format:bullet;
    mso-level-text:\F0B7;
    mso-level-tab-stop:.5in;
    mso-level-number-position:left;
    text-indent:-.25in;
    font-size:10.0pt;
    font-family:Symbol;}
   ol
    {margin-bottom:0in;}
   ul
    {margin-bottom:0in;}
   -->
   </style>
   </head>
   
   <body bgcolor=white lang=EN-US style='tab-interval:.5in'>
   
   <div class=Section1>
   
   <h1>Fast Installation: Setting up a Red Hat 7.3 LON-CAPA Server</h1>
   
   <h2><a name="_Toc421867176">Before you begin</a></h2>
   
   <p>Installing Linux is getting easier and easier. However, it is still a
   non-trivial undertaking and experience with Red Hat Linux will make this
   process easier. You will be required to log in to the machine and execute some
   routine Unix commands. Some familiarity with Linux is assumed. </p>
   
   <h2><a name="_Toc421867177">Installation Overview</a></h2>
   
   <p>The installation process takes the following steps: </p>
   
   <p class=MsoNormal style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo1;
   tab-stops:list .5in'><![if !supportLists]>1.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;
   </span><![endif]>Obtain Red Hat 7.3 </p>
   
   <p class=MsoNormal style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo1;
   tab-stops:list .5in'><![if !supportLists]>2.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;
   </span><![endif]>Gather information for installing Red Hat </p>
   
   <p class=MsoNormal style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo1;
   tab-stops:list .5in'><![if !supportLists]>3.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;
   </span><![endif]>Install Red Hat 7.3 </p>
   
   <p class=MsoNormal style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo1;
   tab-stops:list .5in'><![if !supportLists]>4.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;
   </span><![endif]>Determine your LON-CAPA Settings </p>
   
   <p class=MsoNormal style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo1;
   tab-stops:list .5in'><![if !supportLists]>5.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;
   </span><![endif]>Install LON-CAPA </p>
   
   <p class=MsoNormal style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo1;
   tab-stops:list .5in'><![if !supportLists]>6.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;
   </span><![endif]>Configure LON-CAPA </p>
   
   <p class=MsoNormal style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo1;
   tab-stops:list .5in'><![if !supportLists]>7.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;
   </span><![endif]>Pick a hosts.tab file </p>
   
   <p class=MsoNormal style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo1;
   tab-stops:list .5in'><![if !supportLists]>8.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;
   </span><![endif]>Create a Domain Coordinator </p>
   
   <p class=MsoNormal style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo1;
   tab-stops:list .5in'><![if !supportLists]>9.<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;
   </span><![endif]>Start/Restart services </p>
   
   <p class=MsoNormal style='margin-left:.5in;text-indent:-.25in;mso-list:l1 level1 lfo1;
   tab-stops:list .5in'><![if !supportLists]>10.<span style='font:7.0pt "Times New Roman"'>&nbsp;
   </span><![endif]>Log in to LON-CAPA </p>
   
   <h2><a name="_Toc421867178">Obtain the Red Hat 7.3 installation CDs</a></h2>
   
   <p>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 burn them
   yourself, or install from a mirror site using ftp or http. </p>
   
   <h2><a name="_Toc421867179">Determine Network settings for your site</a></h2>
   
   <p>You will need to have the following information for your site. You must have
   a static IP address (do not use DHCP). </p>
   
   <ul style='margin-top:0in' type=disc>
    <li class=MsoNormal style='mso-list:l0 level1 lfo2;tab-stops:list .5in'>ip
        address </li>
    <li class=MsoNormal style='mso-list:l0 level1 lfo2;tab-stops:list .5in'>netmask
        </li>
    <li class=MsoNormal style='mso-list:l0 level1 lfo2;tab-stops:list .5in'>network
        </li>
    <li class=MsoNormal style='mso-list:l0 level1 lfo2;tab-stops:list .5in'>broadcast
        </li>
    <li class=MsoNormal style='mso-list:l0 level1 lfo2;tab-stops:list .5in'>hostname
        </li>
    <li class=MsoNormal style='mso-list:l0 level1 lfo2;tab-stops:list .5in'>gateway
        </li>
    <li class=MsoNormal style='mso-list:l0 level1 lfo2;tab-stops:list .5in'>domain
        name server(s) </li>
   </ul>
   
   <h2><a name="_Toc421867180">Install Red Hat 7.3</a></h2>
   
   <p>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): </p>
   
   <p class=MsoNormal>Installation Type </p>
   
   <p class=MsoNormal style='margin-left:.5in'>You should definitely do a
   &quot;Server&quot; install. We do not recommend Trying to install LON-CAPA with
   a different installation type. </p>
   
   <p class=MsoNormal>Partitioning your Drive </p>
   
   <p class=MsoNormal style='margin-left:.5in'>You may want to use the automatic
   partitioning feature of Red Hat, however you should review the results and be
   prepared to modify them. 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 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 typically
   have 1 or 2x as much swap space as you do physical RAM. </p>
   
   <p class=MsoNormal>Network Configuration </p>
   
   <p class=MsoNormal style='margin-left:.5in'>LON-CAPA will <b>not</b><span
   style='font-weight:normal'> work with a machine set up to use a dynamic IP
   address. When configuring your network card, be sure to unselect the DHCP
   option and enter in your network information. </span></p>
   
   <p class=MsoNormal>Firewall Configuration </p>
   
   <p class=MsoNormal style='margin-left:.5in'>The installation script will remove
   and disable your firewall. </p>
   
   <p class=MsoNormal>Package Group Selection </p>
   
   <p class=MsoNormal style='margin-left:.5in'>At a minimum, install the following
   packages: </p>
   
   <ul style='margin-top:0in' type=disc>
    <li class=MsoNormal style='mso-list:l2 level1 lfo3;tab-stops:list .5in'>NFS
        File Server </li>
    <li class=MsoNormal style='mso-list:l2 level1 lfo3;tab-stops:list .5in'>Windows
        File Server </li>
    <li class=MsoNormal style='mso-list:l2 level1 lfo3;tab-stops:list .5in'>Web
        Server </li>
   </ul>
   
   <p class=MsoNormal style='margin-left:.5in'>Other packages can be installed as
   you like. </p>
   
   <p class=MsoNormal>X Windows Configuration </p>
   
   <p class=MsoNormal style='margin-left:.5in'>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 card you may wish to skip the configuration. </p>
   
   <p class=MsoNormal>Other notes: </p>
   
   <ul style='margin-top:0in' type=disc>
    <li class=MsoNormal style='mso-list:l3 level1 lfo4;tab-stops:list .5in'>Use
        md5 and shadow passwords if you are given the choice (this is the
        default). </li>
   </ul>
   
   <h2><a name="_Toc421867181">Determine LON-CAPA settings</a></h2>
   
   <p>LON-CAPA requires a number of identifying parameters be set in order for it
   to function at all. Below is a list with descriptions. </p>
   
   <p class=MsoNormal>Host Type (library or access) </p>
   
   <p class=MsoNormal style='margin-left:.5in'>The server must be designated a
   'library' or an 'access' server. In general you should have a library server
   for your instructors to create 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 your site, or if you are playing with it for your own
   edification, you should make your machine a 'library' server. </p>
   
   <p class=MsoNormal>LON-CAPA domain </p>
   
   <p class=MsoNormal style='margin-left:.5in'>Each site or school which installs
   LON-CAPA needs its own domain. Here at MSU we use 'msu'. You should choose
   something short but meaningful. <i>Restriction: One word, no hyphens,
   underscores, or special characters!</i><span style='font-style:normal'> </span></p>
   
   <p class=MsoNormal>LON-CAPA host id </p>
   
   <p class=MsoNormal style='margin-left:.5in'>Each LON-CAPA server requires a
   unique internal name. We use names such as &quot;msul1&quot; for the first
   library server. <i>Restriction: One word, no hyphens, underscores, or special
   characters!</i><span style='font-style:normal'> </span></p>
   
   <p class=MsoNormal>Host administrator email </p>
   
   <p class=MsoNormal style='margin-left:.5in'>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 trouble. On a laptop, make this <tt><span
   style='font-family:"Courier New"'>root@localhost</span></tt>. </p>
   
   <p class=MsoNormal>Root password for SQL database </p>
   
   <p class=MsoNormal style='margin-left:.5in'>In order to keep people from
   corrupting the MYSQL database, a root password is needed. You'll need to
   remember this. </p>
   
   <h2><a name="_Toc421867182">Install LON-CAPA</a></h2>
   
   <p>Log in as root with the password you provided during the Red Hat
   installation process. </p>
   
   <pre><span style="mso-spacerun: yes">&nbsp;</span>wget http://install.loncapa.org/versions/rh73install/loncapa-rh73install.tar tar xf loncapa-rh73install.tar cd install ./install.pl </pre>
   
   <h2><a name="_Toc421867183">Configure LON-CAPA</a></h2>
   
   <p>Execute the following commands </p>
   
   <pre><span style="mso-spacerun: yes">&nbsp;</span>cd /root/loncapa/ ./UPDATE </pre>
   
   <p class=MsoNormal>You will need to enter the LON-CAPA configuration
   information you requested above. Additionally, you will need to enter the
   following information (options 5 and 6 in the menu, recommended settings): </p>
   
   <p class=MsoNormal>Cache Expiration Time </p>
   
   <p class=MsoNormal style='margin-left:.5in'>86400 </p>
   
   <p class=MsoNormal>Server Load </p>
   
   <p class=MsoNormal style='margin-left:.5in'>2.0 </p>
   
   <p class=MsoNormal>You can deviate from the above settings if you know what you
   are doing. </p>
   
   <h2><a name="_Toc421867184">Picking a hosts.tab file</a></h2>
   
   <p class=MsoNormal>The &quot;hosts.tab&quot; file controls which LON-CAPA servers
   your server attempts 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' &quot;hosts.tab&quot;. On a laptop, you must choose 'standalone'.
   Please contact the support staff at www.loncapa.org for information about
   adding more hosts to your &quot;hosts.tab&quot; file. </p>
   
   <p><b>Note:</b><span style='font-weight:normal'> for </span><b>non</b><span
   style='font-weight:normal'>-standalone configurations, you do need to add
   yourself to the </span><tt><span style='font-family:"Courier New"'>/home/httpd/lonTabs/hosts.tab</span></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><span
   style='font-family:"Courier New"'>hosts.tab</span></tt> entry has the format </p>
   
   <pre><span style="mso-spacerun: yes">&nbsp;</span>lonHostID:domain:hosttype:dns-name:ipaddress </pre>
   
   <p class=MsoNormal>for example </p>
   
   <pre><span style="mso-spacerun: yes">&nbsp;</span>103l5:library:s17.lite.msu.edu:35.8.63.27 </pre>
   
   <p class=MsoNormal>Please edit this file with a UNIX editor, not a PC or Mac
   one, so that the linebreaks are correct. </p>
   
   <h2><a name="_Toc421867185">Creating a Domain Coordinator</a></h2>
   
   <p>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 grants them
   additional privileges. The make_domain_coordinator.pl script invoked below
   requires that you enter the users password. The password will show in plaintext
   as you type it. Feel free to use the &quot;passwd username&quot; command to
   change it later. Replace USERNAME and DOMAIN with an appropriate user name and
   your domain. </p>
   
   <pre><span style="mso-spacerun: yes">&nbsp;</span>cd /root/loncapa/loncom/build perl make_domain_coordinator.pl USERNAME DOMAIN (WILL PROMPT FOR PASSWORD HERE) mkdir ~USERNAME/public_html chown USERNAME:www ~USERNAME/public_html chmod 0775 ~USERNAME/public_html </pre>
   
   <h2><a name="_Toc421867186">Start/Restart Services</a></h2>
   
   <p>The services take about 10 minutes to start. </p>
   
   <pre><span style="mso-spacerun: yes">&nbsp;</span>/etc/init.d/loncontrol start /etc/init.d/httpd restart </pre>
   
   <h2><a name="_Toc421867187">Make Sure that Services Autostart on Boot</a></h2>
   
   <p>On Redhat 7.3 it is not guaranteed that Apache and MySQL automatically
   restart on boot, even when installing with &quot;server&quot; configuration.
   After logging in as root, check under &quot;Programs&quot; - &quot;System&quot;
   - &quot;Service Configuration&quot; that &quot;Start on Boot&quot; is checked
   for httpd and mysqld, save and restart.. </p>
   
   <h2><a name="_Toc421867188">Log in to your LON-CAPA Machine</a></h2>
   
   <p>Point a web browser at your new machine and log in as the domain
   coordinator. Congratulations! </p>
   
   </div>
   
   <span style='font-size:12.0pt;font-family:Times;mso-ansi-language:EN-US'><br
   clear=ALL style='page-break-before:always;mso-break-type:section-break'>
   </span>
   
   <div class=Section2>
   
   <p class=MsoNormal><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></p>
   
   </div>
   
   </body>
   
   </html>

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


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