doc/install/fedora/single_file_install.html - view

File: [LON-CAPA] / doc / install / fedora / single_file_install.html
Revision 1.3: download - view: text, annotated - select for diffs
Fri Feb 11 17:42:59 2005 UTC (19 years, 3 months ago) by matthew
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_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, 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

Added a bit about copying the loncapa_yum.conf file to /etc.

1: <html> 2: <head><title>New installation instructions</title></head> 3: <body> 4:  5: <h1>Installing LON-CAPA on a Fedora Core 3 Linux System</h1> 6: <p> 7: This document guides you through the process of installing LON-CAPA on a 8: Fedora Core 3 (FC3) system. Information about Fedora is available from 9: <a href="http://fedora.redhat.com/">http://fedora.redhat.com/</a>. 10: More information about LON-CAPA is available from 11: <a href="http://www.loncapa.org">http://www.loncapa.org</a> and 12: <a href="http://install.loncapa.org">http://install.loncapa.org</a>. 13: </p><p> 14: These instructions assume you have installed Fedora Core 3 on your system 15: and it is running properly. All of the LON-CAPA data is stored in 16: /home/httpd. MySQL is used to store temporary caches of system data, by 17: default this uses storage space in /var/lib/mysql. You will want to be sure 18: you have enough disk space for these two partitions. 19: </p><p> 20: Please keep your system up to date. By default, LON-CAPA will add its 21: own repository to your /etc/yum.conf file. Additionally, yum will be run 22: every morning to determine if there are any packages which need to be 23: upgraded. If there are, an email will be sent to the server administrator 24: (specified in the LON-CAPA installation). It behooves you to keep your 25: system up to date. 26: </p> 27: 28: <h2>Installation Overview</h2> 29: <p> 30: The installation must be done as root. 31: </p><p> 32: The installation process takes the following steps: 33: </p> 34: <ol> 35: <li> Install LON-CAPA yum.conf </li> 36: <li> Install LON-CAPA </li> 37: <li> Create a Domain Coordinator </li> 38: <li> Start/Restart services </li> 39: <li> Log in to LON-CAPA </li> 40: </ol> 41: 42: <h2>Install LON-CAPA yum.conf</h2> 43: <p> 44: You will need to copy the loncapa_yum.conf file over the default yum.conf 45: file. 46: <pre> 47: mv /etc/yum.conf /etc/yum.conf.backup 48: cp loncapa_yum.conf /etc/yum.conf 49: </pre> 50: </p> 51: <h2>Install LON-CAPA</h2> 52: <h3>Remove conflicting packages</h3> 53: <p> 54: You will need to remove the following packages which conflict with LON-CAPA. 55: <ul> 56: <li> httpd 57: <li> php 58: <li> mod_throttle 59: <li> mod_bandwidth 60: <li> mod_perl 61: </ul> 62: List the packages you have installed that match by executing: 63: <pre> 64: rpm -q -f | grep PACKAGENAME 65: </pre> 66: You can remove the packages individually using 67: <pre> 68: rpm -e PACKAGENAME 69: </pre> 70: You will need to remove all of the packages which depend on the ones you are 71: removing. 72: You can remove the associated packages en mass if you are satisfied the prior 73: command selected all the appropriate packages: 74: <pre> 75: rpm -q -a | grep PACKAGENAME | rpm -e 76: </pre> 77: </p> 78: 79: <h3>Install prerequisites</h3> 80: <p> 81: We have provided many of the packages needed for LON-CAPA in the installation 82: bundle. They reside in the prerequisites directory. You will need to install them using the following commands: 83: <pre> 84: cd prerequisites 85: rpm -Uvh *rpm 86: </pre> 87: You will need to resolve any errors this process generated. For packages that are already installed you can simply remove them from the directory: 88: <pre> 89: mv CONFLICTINPACKAGE*.rpm .. 90: </pre> 91: And try the installation command again. If there are required packages which 92: have not been installed, these should be found on your Fedora Core 3 installation CDs. 93: </p> 94: 95: <h3>Determine LON-CAPA Settings</h3> 96: <p> 97: LON-CAPA requires a number of identifying parameters be set in order 98: for it to function at all. Below is a list with descriptions. 99: </p> 100: <dl> 101: <dt>Host Type (library or access)</dt> 102: <dd>The server must be designated a 'library' or an 'access' server. In 103: general you should have a library server for your instructors to create 104: their course content on and run their courses. Students should connect 105: to access servers. If you are doing the first install of LON-CAPA at 106: your site, or if you are playing with it for your own edification you 107: should make your machine a 'library' server.</dd> 108: <dt>LON-CAPA domain</dt> 109: <dd>Each site or school which installs LON-CAPA needs its own domain. 110: Here at MSU we use 'msu'. You should choose something short but 111: meaningful. <i>Restriction: One word, no hyphens, underscores, or 112: special characters.</i> 113: </dd> 114: <dt>LON-CAPA host id</dt> 115: <dd>Each LON-CAPA server requires a unique internal name. We use names 116: such as "msul1" for the first library server. <i>Restriction: One word, 117: no hyphens, underscores, or special characters.</i> 118: </dd> 119: <dt>Host administrator email</dt> 120: <dd>The amount of email sent to this address is relatively minimal. Messages 121: are sent every time the system starts up, or if the system is in 122: serious trouble. On a laptop, make this <tt>root@localhost</tt>. 123: </dd> 124: </dl> 125: 126: <h3>Install and Configuring LON-CAPA</h3> 127: <p> 128: To configure and install LON-CAPA, execute the following commands: 129: </p> 130: <pre> 131: cd ~/loncapa_install/ 132: ./install.pl 133: </pre> 134: You will need to enter a root password for MySQL. Once this is complete 135: you will need to execute: 136: <pre> 137: cd /root/loncapa-1.3.2 138: ./UPDATE 139: </pre> 140: <p> 141: You will need to enter the LON-CAPA configuration information you determined 142: in the previous section. 143: </p> 144: 145: <h2>Creating a Domain Coordinator</h2> 146: <p> 147: You will need at least one user at your site who has the role of 148: 'domain coordinator'. This user creates accounts for other users and 149: grants them additional privileges. The make_domain_coordinator.pl script 150: invoked below requires that you enter the users password. The password will 151: show in plaintext as you type it. Feel free to use the "passwd username" 152: command to change it later. Replace USERNAME and DOMAIN with an 153: appropriate user name and your domain. 154: </p> 155: <pre> 156: cd /root/loncapa-1.3.2/loncom/build 157: perl make_domain_coordinator.pl USERNAME DOMAIN 158: (WILL PROMPT FOR PASSWORD HERE) 159: mkdir ~USERNAME/public_html 160: chown USERNAME:www ~USERNAME/public_html 161: chmod 0775 ~USERNAME/public_html 162: chmod a+x ~USERNAME 163: </pre> 164: 165: <h2>Start/Restart Services</h2> 166: <p> 167: The LON-CAPA network services take a moment to start. Most misconfigurations 168: will be appearant at this step. 169: </p> 170: <pre> 171: /etc/init.d/loncontrol start 172: /etc/init.d/httpd start 173: </pre> 174: <p> 175: If you receive warnings when starting the httpd about missing perl modules, 176: please make sure you followed the instructions in 177: <b>Installing LON-CAPA Dependencies</b>. If you still have errors, please 178: contact the LON-CAPA development team. 179: </p> 180: <h2>Log in to your LON-CAPA Machine</h2> 181: <p> 182: Point a web browser at your new machine and log in as the domain 183: coordinator. Congratulations! 184: </p> 185: 186: <h2>If Things aren't working right</h2> 187: <p> 188: If you've followed the steps above and the server doesn't start or you think 189: there's something wrong, please get in touch with the LON-CAPA developers. 190: If there were errors in installation of the dependency RPMs or during the 191: automatic setup, please send us as much information as possible. 192: If some part of this document is unclear please let us know. 193: </p> 194: 195: </body> 196: </html>