doc/install/fedora/single_file_install.html - view

File: [LON-CAPA] / doc / install / fedora / single_file_install.html
Revision 1.1: download - view: text, annotated - select for diffs
Mon Oct 18 20:57:38 2004 UTC (19 years, 7 months ago) by matthew
Branches: MAIN
CVS tags: version_1_3_X, version_1_3_3, version_1_3_2, version_1_3_1, version_1_3_0, version_1_2_99_1, version_1_2_99_0, HEAD

Single file installation instructions.

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