version 1.1, 2002/05/22 22:02:59
|
version 1.4, 2002/06/03 13:27:37
|
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 14 some routine Unix commands. Some famili
|
Line 14 some routine Unix commands. Some famili
|
<p> |
<p> |
The installation process takes the following steps: |
The installation process takes the following steps: |
<ol> |
<ol> |
<li> Obtain Red Hat 7.3 |
<li> Obtain Red Hat 7.3 </li> |
<li> Gather information for installing Red Hat |
<li> Gather information for installing Red Hat </li> |
<li> Install Red Hat 7.3 |
<li> Install Red Hat 7.3 </li> |
<li> Determine your LON-CAPA Settings |
<li> Determine your LON-CAPA Settings </li> |
<li> Install LON-CAPA |
<li> Install LON-CAPA </li> |
<li> Configure LON-CAPA |
<li> Configure LON-CAPA </li> |
<li> Pick a hosts.tab file |
<li> Pick a hosts.tab file </li> |
<li> Create a Domain Coordinator |
<li> Create a Domain Coordinator </li> |
<li> Start/Restart services |
<li> Start/Restart services </li> |
<li> Log in to LON-CAPA |
<li> Log in to LON-CAPA </li> |
</ol> |
</ol> |
</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>Gather information for the Red Hat Installation</h2> |
<h2>Determine Network settings for your site</h2> |
<p> |
|
You will need to gather some network information for your server. You will |
|
also need to determine some of the LON-CAPA configuration information before |
|
you begin. |
|
</p> |
|
<h3>Network settings for your site</h3> |
|
<p> |
<p> |
|
You will need to have the following information for your site. You must |
|
have a static IP address (do not use DHCP). |
<ul> |
<ul> |
<li>ip address |
<li>ip address </li> |
<li>netmask |
<li>netmask </li> |
<li>network |
<li>network </li> |
<li>broadcast |
<li>broadcast </li> |
<li>hostname |
<li>hostname </li> |
<li>gateway |
<li>gateway </li> |
<li>domain name server(s) |
<li>domain name server(s) </li> |
</ul> |
</ul> |
</p> |
</p> |
|
|
Line 78 is in the order the issues appear in the
|
Line 74 is in the order the issues appear in the
|
<dt>Package Group Selection |
<dt>Package Group Selection |
<dd>At a minimum, install the following packages: |
<dd>At a minimum, install the following packages: |
<ul> |
<ul> |
<li>NFS File Server |
<li>NFS File Server </li> |
<li>Windows File Server |
<li>Windows File Server </li> |
<li>Web Server |
<li>Web Server </li> |
</ul> |
</ul> |
Other packages can be installed as you like. |
Other packages can be installed as you like. |
<dt>X Windows Configuration |
<dt>X Windows Configuration |
Line 91 is in the order the issues appear in the
|
Line 87 is in the order the issues appear in the
|
Other notes: |
Other notes: |
<ul> |
<ul> |
<li>Use md5 and shadow passwords if you are given the choice (this is |
<li>Use md5 and shadow passwords if you are given the choice (this is |
the default). |
the default). </li> |
</ul> |
</ul> |
</p> |
</p> |
|
|
Line 110 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 144 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 |
'domain coordinator'. This user creates accounts for other users and |
'domain coordinator'. This user creates accounts for other users and |
grants them additional privileges. The make_domain_coordinator.pl script |
grants them additional privileges. The make_domain_coordinator.pl script |
invoked below requires that you enter the users password. The password will |
invoked below requires that you enter the users password. The password will |
show in plaintext as you type it. Feel free to use the passwd username |
show in plaintext as you type it. Feel free to use the "passwd username" |
command to change it later. Replace USERNAME and DOMAIN with an |
command to change it later. Replace USERNAME and DOMAIN with an |
appropriate user name and your domain. |
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 187 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, even when installing with "server" configuration. |
|
After logging in as root, check under "Programs" - "System" - |
|
"Service Configuration" that "Start on Boot" is checked for httpd and mysqld, |
|
save and restart.. |
|
</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 |