Annotation of doc/install/fedora/single_file_install.html, revision 1.1
1.1 ! matthew 1: <html>
! 2: <head><title>New installation instructions</title></head>
! 3: <body>
! 4: <!-- $Id$-->
! 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>
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>
![[BACK]](/icons/back.gif){kind=icon}
Return to single_file_install.html CVS log ![[TXT]](/icons/text.gif){kind=icon}
![[DIR]](/icons/dir.gif){kind=icon}
Up to [LON-CAPA] / doc / install / fedora