version 1.2, 2002/05/23 14:29:37
|
version 1.5, 2002/06/06 22:34:24
|
Line 1
|
Line 1
|
<html><head><title>Setting up a Red Hat7.3 LON-CAPA Server</title></head><body> |
<html><head><title>Setting up a Red Hat7.3 LON-CAPA Server</title></head><body> |
<!-- $Id$ --> |
<!-- $Id$ --> |
<h1>Setting up a Red Hat7.3 LON-CAPA Server</h1> |
<h1>Setting up a Red Hat 7.3 LON-CAPA Server</h1> |
|
|
<h2>Before you begin</h2> |
<h2>Before you begin</h2> |
<p> |
<p> |
Line 31 The installation process takes the follo
|
Line 31 The installation process takes the follo
|
<p> |
<p> |
If you like, you may contact the LON-CAPA development staff and we can |
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 |
mail the CDs to you. Another option is to download the cd images and |
burn them yourself. |
burn them yourself, or install from a mirror site using ftp or http. |
</p> |
</p> |
|
|
<h2>Determine Network settings for your site</h2> |
<h2>Determine Network settings for your site</h2> |
Line 106 for it to function at all. Below is a l
|
Line 106 for it to function at all. Below is a l
|
<dt>LON-CAPA domain |
<dt>LON-CAPA domain |
<dd>Each site or school which installs LON-CAPA needs its own domain. |
<dd>Each site or school which installs LON-CAPA needs its own domain. |
Here at MSU we use 'msu'. You should choose something short but |
Here at MSU we use 'msu'. You should choose something short but |
meaningful. |
meaningful. <i>Restriction: One word, no hyphens, underscores, or special characters!</i> |
<dt>LON-CAPA host id |
<dt>LON-CAPA host id |
<dd>Each LON-CAPA server requires a unique internal name. We use names |
<dd>Each LON-CAPA server requires a unique internal name. We use names |
such as "msul1" for the first library server. |
such as "msul1" for the first library server. <i>Restriction: |
|
One word, no hyphens, underscores, or special characters!</i> |
<dt>Host administrator email |
<dt>Host administrator email |
<dd>The amount of email sent to this address is relatively minimal. Messages |
<dd>The amount of email sent to this address is relatively minimal. Messages |
are sent every time the system starts up. |
are sent every time the system starts up, or if the system is in serious |
|
trouble. On a laptop, make this <tt>root@localhost</tt>. |
<dt>Root password for SQL database |
<dt>Root password for SQL database |
<dd>In order to keep people from corrupting the MYSQL database, a root |
<dd>In order to keep people from corrupting the MYSQL database, a root |
password is needed. You'll need to remember this. |
password is needed. You'll need to remember this. |
Line 140 cd /root/loncapa/
|
Line 142 cd /root/loncapa/
|
</pre> |
</pre> |
You will need to enter the LON-CAPA configuration information you requested |
You will need to enter the LON-CAPA configuration information you requested |
above. Additionally, you will need to enter the following information |
above. Additionally, you will need to enter the following information |
(options 5 and 6 in the menu): |
(options 5 and 6 in the menu, recommended settings): |
<dl> |
<dl> |
<dt>Cache Expiration Time |
<dt>Cache Expiration Time |
<dd>86400 |
<dd>86400 |
<dt>Server Load |
<dt>Server Load |
<dd>2.0 |
<dd>2.0 |
</dl> |
</dl> |
|
You can deviate from the above settings if you know what you are doing. |
</p> |
</p> |
|
|
<h2>Picking a hosts.tab file</h2> |
<h2>Picking a hosts.tab file</h2> |
The "hosts.tab" file controls which LON-CAPA servers your server attempts |
The "hosts.tab" file controls which LON-CAPA servers your server attempts |
to access and which servers it will respond to. If this is your first |
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' |
install of LON-CAPA on your network, we suggest choosing a 'standalone' |
"hosts.tab". Please contact the support staff at www.loncapa.org for |
"hosts.tab". On a laptop, you must choose 'standalone'. |
|
Please contact the support staff at www.loncapa.org for |
information about adding more hosts to your "hosts.tab" file. |
information about adding more hosts to your "hosts.tab" file. |
|
<p> |
|
<b>Note:</b> for <b>non</b>-standalone configurations, you do need to add |
|
yourself to the <tt>/home/httpd/lonTabs/hosts.tab</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>hosts.tab</tt> entry has the |
|
format |
|
<pre> |
|
lonHostID:domain:hosttype:dns-name:ipaddress |
|
</pre> |
|
for example |
|
<pre> |
|
103l5:library:s17.lite.msu.edu:35.8.63.27 |
|
</pre> |
|
Please edit this file with a UNIX editor, not a PC or Mac one, so that the |
|
linebreaks are correct. |
|
|
|
</p> |
<h2>Creating a Domain Coordinator</h2> |
<h2>Creating a Domain Coordinator</h2> |
<p> |
<p> |
You will need at least one user at your site who has the role of |
You will need at least one user at your site who has the role of |
Line 168 appropriate user name and your domain.
|
Line 188 appropriate user name and your domain.
|
<pre> |
<pre> |
cd /root/loncapa/loncom/build |
cd /root/loncapa/loncom/build |
perl make_domain_coordinator.pl USERNAME DOMAIN |
perl make_domain_coordinator.pl USERNAME DOMAIN |
|
(WILL PROMPT FOR PASSWORD HERE) |
mkdir ~USERNAME/public_html |
mkdir ~USERNAME/public_html |
chown USERNAME:www ~USERNAME/public_html |
chown USERNAME:www ~USERNAME/public_html |
chmod 0775 ~USERNAME/public_html |
chmod 0775 ~USERNAME/public_html |
Line 183 The services take about 10 minutes to st
|
Line 204 The services take about 10 minutes to st
|
</pre> |
</pre> |
</p> |
</p> |
|
|
|
<h2>Make Sure that Services Autostart on Boot</h2> |
|
<p>On Redhat 7.3 it is not guaranteed that Apache and MySQL automatically |
|
restart on boot. You should run /usr/sbin/ntsysv and set the following |
|
daemons to be started at boot: |
|
<pre> |
|
httpd |
|
mysqld |
|
</pre> |
|
It is not necessary to reboot after doing this as they should already be |
|
running by this point in the installation. |
|
<pre> |
|
/etc/init.d/httpd restart |
|
/etc/init.d/mysqld restart |
|
</pre> |
|
</p> |
<h2>Log in to your LON-CAPA Machine</h2> |
<h2>Log in to your LON-CAPA Machine</h2> |
<p> |
<p> |
Point a web browser at your new machine and log in as the domain |
Point a web browser at your new machine and log in as the domain |