--- doc/install/redhat7.3/new_install_rh73.html 2002/05/22 22:02:59 1.1
+++ doc/install/redhat7.3/new_install_rh73.html 2002/06/03 13:27:37 1.4
@@ -1,6 +1,6 @@
Setting up a Red Hat7.3 LON-CAPA Server
-
-Setting up a Red Hat7.3 LON-CAPA Server
+
+Setting up a Red Hat 7.3 LON-CAPA Server
Before you begin
@@ -14,16 +14,16 @@ some routine Unix commands. Some famili
The installation process takes the following steps:
- - Obtain Red Hat 7.3
-
- Gather information for installing Red Hat
-
- Install Red Hat 7.3
-
- Determine your LON-CAPA Settings
-
- Install LON-CAPA
-
- Configure LON-CAPA
-
- Pick a hosts.tab file
-
- Create a Domain Coordinator
-
- Start/Restart services
-
- Log in to LON-CAPA
+
- Obtain Red Hat 7.3
+ - Gather information for installing Red Hat
+ - Install Red Hat 7.3
+ - Determine your LON-CAPA Settings
+ - Install LON-CAPA
+ - Configure LON-CAPA
+ - Pick a hosts.tab file
+ - Create a Domain Coordinator
+ - Start/Restart services
+ - Log in to LON-CAPA
@@ -31,25 +31,21 @@ The installation process takes the follo
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.
-Gather information for the Red Hat Installation
-
-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.
-
-Network settings for your site
+Determine Network settings for your site
+You will need to have the following information for your site. You must
+have a static IP address (do not use DHCP).
- - ip address
-
- netmask
-
- network
-
- broadcast
-
- hostname
-
- gateway
-
- domain name server(s)
+
- ip address
+ - netmask
+ - network
+ - broadcast
+ - hostname
+ - gateway
+ - domain name server(s)
@@ -78,9 +74,9 @@ is in the order the issues appear in the
Package Group Selection
At a minimum, install the following packages:
- - NFS File Server
-
- Windows File Server
-
- Web Server
+
- NFS File Server
+ - Windows File Server
+ - Web Server
Other packages can be installed as you like.
X Windows Configuration
@@ -91,7 +87,7 @@ is in the order the issues appear in the
Other notes:
- Use md5 and shadow passwords if you are given the choice (this is
- the default).
+ the default).
@@ -110,13 +106,15 @@ for it to function at all. Below is a l
LON-CAPA domain
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. Restriction: One word, no hyphens, underscores, or special characters!
LON-CAPA host id
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. Restriction:
+One word, no hyphens, underscores, or special characters!
Host administrator email
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 root@localhost.
Root password for SQL database
In order to keep people from corrupting the MYSQL database, a root
password is needed. You'll need to remember this.
@@ -144,34 +142,53 @@ cd /root/loncapa/
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):
- Cache Expiration Time
- 86400
- Server Load
- 2.0
+You can deviate from the above settings if you know what you are doing.
Picking a hosts.tab file
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.
-
+
+Note: for non-standalone configurations, you do need to add
+yourself to the /home/httpd/lonTabs/hosts.tab to initially test your
+configuration. Eventually, you will be added to the general cluster tables by
+LON-CAPA staff, so this is temporary. A hosts.tab entry has the
+format
+
+lonHostID:domain:hosttype:dns-name:ipaddress
+
+for example
+
+103l5:library:s17.lite.msu.edu:35.8.63.27
+
+Please edit this file with a UNIX editor, not a PC or Mac one, so that the
+linebreaks are correct.
+
+
Creating a Domain Coordinator
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
grants them additional privileges. The make_domain_coordinator.pl script
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
appropriate user name and your domain.
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
@@ -187,6 +204,13 @@ The services take about 10 minutes to st
+Make Sure that Services Autostart on Boot
+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..
+
Log in to your LON-CAPA Machine
Point a web browser at your new machine and log in as the domain