doc/gutshtml/FastInstallation.html - view

File: [LON-CAPA] / doc / gutshtml / FastInstallation.html
Revision 1.2: download - view: text, annotated - select for diffs
Tue Jul 22 14:47:00 2003 UTC (21 years, 7 months ago) by bowersj2
Branches: MAIN
CVS tags: version_2_9_X, version_2_9_99_0, version_2_9_1, version_2_9_0, version_2_8_X, version_2_8_99_1, version_2_8_99_0, version_2_8_2, version_2_8_1, version_2_8_0, version_2_7_X, version_2_7_99_1, version_2_7_99_0, version_2_7_1, version_2_7_0, version_2_6_X, version_2_6_99_1, version_2_6_99_0, version_2_6_3, version_2_6_2, version_2_6_1, version_2_6_0, version_2_5_X, version_2_5_99_1, version_2_5_99_0, version_2_5_2, version_2_5_1, version_2_5_0, version_2_4_X, version_2_4_99_0, version_2_4_2, version_2_4_1, version_2_4_0, version_2_3_X, version_2_3_99_0, version_2_3_2, version_2_3_1, version_2_3_0, version_2_2_X, version_2_2_99_1, version_2_2_99_0, version_2_2_2, version_2_2_1, version_2_2_0, version_2_1_X, version_2_1_99_3, version_2_1_99_2, version_2_1_99_1, version_2_1_99_0, version_2_1_3, version_2_1_2, version_2_1_1, version_2_1_0, version_2_12_X, version_2_11_X, version_2_11_6_msu, version_2_11_6, version_2_11_5_msu, version_2_11_5, version_2_11_4_uiuc, version_2_11_4_msu, version_2_11_4, version_2_11_3_uiuc, version_2_11_3_msu, version_2_11_3, version_2_11_2_uiuc, version_2_11_2_msu, version_2_11_2_educog, version_2_11_2, version_2_11_1, version_2_11_0_RC3, version_2_11_0_RC2, version_2_11_0_RC1, version_2_11_0, version_2_10_X, version_2_10_1, version_2_10_0_RC2, version_2_10_0_RC1, version_2_10_0, version_2_0_X, version_2_0_99_1, version_2_0_2, version_2_0_1, version_2_0_0, version_1_99_3, version_1_99_2, version_1_99_1_tmcc, version_1_99_1, version_1_99_0_tmcc, version_1_99_0, version_1_3_X, version_1_3_3, version_1_3_2, version_1_3_1, version_1_3_0, version_1_2_X, version_1_2_99_1, version_1_2_99_0, version_1_2_1, version_1_2_0, version_1_1_X, version_1_1_99_5, version_1_1_99_4, version_1_1_99_3, version_1_1_99_2, version_1_1_99_1, version_1_1_99_0, version_1_1_3, version_1_1_2, version_1_1_1, version_1_1_0, version_1_0_99_3, version_1_0_99_2, version_1_0_99_1, version_1_0_99, version_1_0_3, version_1_0_2, version_1_0_1, version_1_0_0, version_0_99_5, version_0_99_4, loncapaMITrelate_1, language_hyphenation_merge, language_hyphenation, bz6209-base, bz6209, HEAD, GCI_3, GCI_2, GCI_1, BZ4492-merge, BZ4492-feature_horizontal_radioresponse, BZ4492-feature_Support_horizontal_radioresponse, BZ4492-Support_horizontal_radioresponse

Convert GUTs HTML to PROPER line endings.

1: <html xmlns:o="urn:schemas-microsoft-com:office:office" 2: xmlns:w="urn:schemas-microsoft-com:office:word" 3: xmlns="http://www.w3.org/TR/REC-html40"> 4: 5: <head> 6: <meta name=Title content="Fast Installation: Setting up a Red Hat 7"> 7: <meta name=Keywords content=""> 8: <meta http-equiv=Content-Type content="text/html; charset=macintosh"> 9: <meta name=ProgId content=Word.Document> 10: <meta name=Generator content="Microsoft Word 10"> 11: <meta name=Originator content="Microsoft Word 10"> 12: <link rel=File-List href="Fast%20Installation_files/filelist.xml"> 13: <title>Fast Installation: Setting up a Red Hat 7</title> 14:  43: <style> 44:  188: </style> 189: </head> 190: 191: <body bgcolor=white lang=EN-US style='tab-interval:.5in'> 192: 193: <div class=Section1> 194: 195: <h1>Fast Installation: Setting up a Red Hat 7.3 LON-CAPA Server</h1> 196: 197: <h2><a name="_Toc421867176">Before you begin</a></h2> 198: 199: Installing Linux is getting easier and easier. However, it is still a 200: non-trivial undertaking and experience with Red Hat Linux will make this 201: process easier. You will be required to log in to the machine and execute some 202: routine Unix commands. Some familiarity with Linux is assumed. 203: 204: <h2><a name="_Toc421867177">Installation Overview</a></h2> 205: 206: The installation process takes the following steps: 207: 208: <![if !supportLists]>1.     210: <![endif]>Obtain Red Hat 7.3 211: 212: <![if !supportLists]>2.     214: <![endif]>Gather information for installing Red Hat 215: 216: <![if !supportLists]>3.     218: <![endif]>Install Red Hat 7.3 219: 220: <![if !supportLists]>4.     222: <![endif]>Determine your LON-CAPA Settings 223: 224: <![if !supportLists]>5.     226: <![endif]>Install LON-CAPA 227: 228: <![if !supportLists]>6.     230: <![endif]>Configure LON-CAPA 231: 232: <![if !supportLists]>7.     234: <![endif]>Pick a hosts.tab file 235: 236: <![if !supportLists]>8.     238: <![endif]>Create a Domain Coordinator 239: 240: <![if !supportLists]>9.     242: <![endif]>Start/Restart services 243: 244: <![if !supportLists]>10.  246: <![endif]>Log in to LON-CAPA 247: 248: <h2><a name="_Toc421867178">Obtain the Red Hat 7.3 installation CDs</a></h2> 249: 250: If you like, you may contact the LON-CAPA development staff and we can mail 251: the CDs to you. Another option is to download the cd images and burn them 252: yourself, or install from a mirror site using ftp or http. 253: 254: <h2><a name="_Toc421867179">Determine Network settings for your site</a></h2> 255: 256: You will need to have the following information for your site. You must have 257: a static IP address (do not use DHCP). 258: 259: <ul style='margin-top:0in' type=disc> 260: <li class=MsoNormal style='mso-list:l0 level1 lfo2;tab-stops:list .5in'>ip 261: address </li> 262: <li class=MsoNormal style='mso-list:l0 level1 lfo2;tab-stops:list .5in'>netmask 263: </li> 264: <li class=MsoNormal style='mso-list:l0 level1 lfo2;tab-stops:list .5in'>network 265: </li> 266: <li class=MsoNormal style='mso-list:l0 level1 lfo2;tab-stops:list .5in'>broadcast 267: </li> 268: <li class=MsoNormal style='mso-list:l0 level1 lfo2;tab-stops:list .5in'>hostname 269: </li> 270: <li class=MsoNormal style='mso-list:l0 level1 lfo2;tab-stops:list .5in'>gateway 271: </li> 272: <li class=MsoNormal style='mso-list:l0 level1 lfo2;tab-stops:list .5in'>domain 273: name server(s) </li> 274: </ul> 275: 276: <h2><a name="_Toc421867180">Install Red Hat 7.3</a></h2> 277: 278: When you install RedHat you will need to ensure the following (the list 279: below is in the order the issues appear in the installation of Red Hat 7.3): 280: 281: Installation Type 282: 283: You should definitely do a 284: "Server" install. We do not recommend Trying to install LON-CAPA with 285: a different installation type. 286: 287: Partitioning your Drive 288: 289: You may want to use the automatic 290: partitioning feature of Red Hat, however you should review the results and be 291: prepared to modify them. LON-CAPA resource files are stored in the /home 292: directory, so the lion's share of the drive should be allocated here. If you 293: have 8 GB of space for Red Hat, /home should receive 4 to 6 gigs. Be sure to 294: include adequate swap space. A minimum is 512 Megs, but you should typically 295: have 1 or 2x as much swap space as you do physical RAM. 296: 297: Network Configuration 298: 299: LON-CAPA will not work with a machine set up to use a dynamic IP 301: address. When configuring your network card, be sure to unselect the DHCP 302: option and enter in your network information. 303: 304: Firewall Configuration 305: 306: The installation script will remove 307: and disable your firewall. 308: 309: Package Group Selection 310: 311: At a minimum, install the following 312: packages: 313: 314: <ul style='margin-top:0in' type=disc> 315: <li class=MsoNormal style='mso-list:l2 level1 lfo3;tab-stops:list .5in'>NFS 316: File Server </li> 317: <li class=MsoNormal style='mso-list:l2 level1 lfo3;tab-stops:list .5in'>Windows 318: File Server </li> 319: <li class=MsoNormal style='mso-list:l2 level1 lfo3;tab-stops:list .5in'>Web 320: Server </li> 321: </ul> 322: 323: Other packages can be installed as 324: you like. 325: 326: X Windows Configuration 327: 328: If you chose to install the 329: X-windows packages you will need to configure them. If you are unsure of the 330: support for your video card you may wish to skip the configuration. 331: 332: Other notes: 333: 334: <ul style='margin-top:0in' type=disc> 335: <li class=MsoNormal style='mso-list:l3 level1 lfo4;tab-stops:list .5in'>Use 336: md5 and shadow passwords if you are given the choice (this is the 337: default). </li> 338: </ul> 339: 340: <h2><a name="_Toc421867181">Determine LON-CAPA settings</a></h2> 341: 342: LON-CAPA requires a number of identifying parameters be set in order for it 343: to function at all. Below is a list with descriptions. 344: 345: Host Type (library or access) 346: 347: The server must be designated a 348: 'library' or an 'access' server. In general you should have a library server 349: for your instructors to create their course content on and run their courses. 350: Students should connect to access servers. If you are doing the first install 351: of LON-CAPA at your site, or if you are playing with it for your own 352: edification, you should make your machine a 'library' server. 353: 354: LON-CAPA domain 355: 356: Each site or school which installs 357: LON-CAPA needs its own domain. Here at MSU we use 'msu'. You should choose 358: something short but meaningful. Restriction: One word, no hyphens, 359: underscores, or special characters! 360: 361: LON-CAPA host id 362: 363: Each LON-CAPA server requires a 364: unique internal name. We use names such as "msul1" for the first 365: library server. Restriction: One word, no hyphens, underscores, or special 366: characters! 367: 368: Host administrator email 369: 370: The amount of email sent to this 371: address is relatively minimal. Messages are sent every time the system starts 372: up, or if the system is in serious trouble. On a laptop, make this <tt>root@localhost</tt>. 374: 375: Root password for SQL database 376: 377: In order to keep people from 378: corrupting the MYSQL database, a root password is needed. You'll need to 379: remember this. 380: 381: <h2><a name="_Toc421867182">Install LON-CAPA</a></h2> 382: 383: Log in as root with the password you provided during the Red Hat 384: installation process. 385: 386: <pre> wget http://install.loncapa.org/versions/rh73install/loncapa-rh73install.tar tar xf loncapa-rh73install.tar cd install ./install.pl </pre> 387: 388: <h2><a name="_Toc421867183">Configure LON-CAPA</a></h2> 389: 390: Execute the following commands 391: 392: <pre> cd /root/loncapa/ ./UPDATE </pre> 393: 394: You will need to enter the LON-CAPA configuration 395: information you requested above. Additionally, you will need to enter the 396: following information (options 5 and 6 in the menu, recommended settings): 397: 398: Cache Expiration Time 399: 400: 86400 401: 402: Server Load 403: 404: 2.0 405: 406: You can deviate from the above settings if you know what you 407: are doing. 408: 409: <h2><a name="_Toc421867184">Picking a hosts.tab file</a></h2> 410: 411: The "hosts.tab" file controls which LON-CAPA servers 412: your server attempts to access and which servers it will respond to. If this is 413: your first install of LON-CAPA on your network, we suggest choosing a 414: 'standalone' "hosts.tab". On a laptop, you must choose 'standalone'. 415: Please contact the support staff at www.loncapa.org for information about 416: adding more hosts to your "hosts.tab" file. 417: 418: Note: for non-standalone configurations, you do need to add 420: yourself to the <tt>/home/httpd/lonTabs/hosts.tab</tt> 421: to initially test your configuration. Eventually, you will be added to the 422: general cluster tables by LON-CAPA staff, so this is temporary. A <tt>hosts.tab</tt> entry has the format 424: 425: <pre> lonHostID:domain:hosttype:dns-name:ipaddress </pre> 426: 427: for example 428: 429: <pre> 103l5:library:s17.lite.msu.edu:35.8.63.27 </pre> 430: 431: Please edit this file with a UNIX editor, not a PC or Mac 432: one, so that the linebreaks are correct. 433: 434: <h2><a name="_Toc421867185">Creating a Domain Coordinator</a></h2> 435: 436: You will need at least one user at your site who has the role of 'domain 437: coordinator'. This user creates accounts for other users and grants them 438: additional privileges. The make_domain_coordinator.pl script invoked below 439: requires that you enter the users password. The password will show in plaintext 440: as you type it. Feel free to use the "passwd username" command to 441: change it later. Replace USERNAME and DOMAIN with an appropriate user name and 442: your domain. 443: 444: <pre> 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> 445: 446: <h2><a name="_Toc421867186">Start/Restart Services</a></h2> 447: 448: The services take about 10 minutes to start. 449: 450: <pre> /etc/init.d/loncontrol start /etc/init.d/httpd restart </pre> 451: 452: <h2><a name="_Toc421867187">Make Sure that Services Autostart on Boot</a></h2> 453: 454: On Redhat 7.3 it is not guaranteed that Apache and MySQL automatically 455: restart on boot, even when installing with "server" configuration. 456: After logging in as root, check under "Programs" - "System" 457: - "Service Configuration" that "Start on Boot" is checked 458: for httpd and mysqld, save and restart.. 459: 460: <h2><a name="_Toc421867188">Log in to your LON-CAPA Machine</a></h2> 461: 462: Point a web browser at your new machine and log in as the domain 463: coordinator. Congratulations! 464: 465: </div> 466: 467: 469: 470: 471: <div class=Section2> 472: 473: <![if !supportEmptyParas]> <![endif]><o:p></o:p> 474: 475: </div> 476: 477: </body> 478: 479: </html>