[LON-CAPA-cvs] cvs: doc / new_install_rh73.html
www
lon-capa-cvs@mail.lon-capa.org
Fri, 31 May 2002 15:45:42 -0000
www Fri May 31 11:45:42 2002 EDT
Modified files:
/doc new_install_rh73.html
Log:
Added some notes from Jeremy, etc.
Index: doc/new_install_rh73.html
diff -u doc/new_install_rh73.html:1.2 doc/new_install_rh73.html:1.3
--- doc/new_install_rh73.html:1.2 Thu May 23 10:29:37 2002
+++ doc/new_install_rh73.html Fri May 31 11:45:42 2002
@@ -1,6 +1,6 @@
<html><head><title>Setting up a Red Hat7.3 LON-CAPA Server</title></head><body>
-<!-- $Id: new_install_rh73.html,v 1.2 2002/05/23 14:29:37 matthew Exp $ -->
-<h1>Setting up a Red Hat7.3 LON-CAPA Server</h1>
+<!-- $Id: new_install_rh73.html,v 1.3 2002/05/31 15:45:42 www Exp $ -->
+<h1>Setting up a Red Hat 7.3 LON-CAPA Server</h1>
<h2>Before you begin</h2>
<p>
@@ -31,7 +31,7 @@
<p>
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
-burn them yourself.
+burn them yourself, or install from a mirror site using ftp or http.
</p>
<h2>Determine Network settings for your site</h2>
@@ -106,13 +106,15 @@
<dt>LON-CAPA 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
- meaningful.
+ meaningful. <i>Restriction: One word, no hyphens, underscores, or special characters!</i>
<dt>LON-CAPA host id
<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
<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
<dd>In order to keep people from corrupting the MYSQL database, a root
password is needed. You'll need to remember this.
@@ -140,22 +142,40 @@
</pre>
You will need to enter the LON-CAPA configuration information you requested
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>
<dt>Cache Expiration Time
<dd>86400
<dt>Server Load
<dd>2.0
</dl>
+You can deviate from the above settings if you know what you are doing.
</p>
<h2>Picking a hosts.tab file</h2>
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
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.
-
+<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>
<p>
You will need at least one user at your site who has the role of
@@ -168,6 +188,7 @@
<pre>
cd /root/loncapa/loncom/build
perl make_domain_coordinator.pl USERNAME DOMAIN
+(WILL PROMPT FOR PASSWORD HERE)
mkdir ~USERNAME/public_html
chown USERNAME:www ~USERNAME/public_html
chmod 0775 ~USERNAME/public_html