|
version 1.6, 2002/06/19 21:09:52
|
version 1.7, 2002/07/18 18:40:10
|
|
Line 1
|
Line 1
|
| <html><head><title>Setting up a Red Hat7.3 LON-CAPA Server</title></head><body> |
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" |
| |
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
| |
<html> |
| |
<head> |
| |
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"></meta> |
| |
<title>Setting up a Red Hat7.3 LON-CAPA Server</title> |
| |
</head> |
| |
<body> |
| <!-- $Id$ --> |
<!-- $Id$ --> |
| <h1>Setting up a Red Hat 7.3 LON-CAPA Server</h1> |
<h1>Setting up a Red Hat 7.3 LON-CAPA Server</h1> |
| |
|
|
Line 13 some routine Unix commands. Some famili
|
Line 20 some routine Unix commands. Some famili
|
| <h2>Installation Overview</h2> |
<h2>Installation Overview</h2> |
| <p> |
<p> |
| The installation process takes the following steps: |
The installation process takes the following steps: |
| |
</p> |
| <ol> |
<ol> |
| <li> Obtain Red Hat 7.3 </li> |
<li> Obtain Red Hat 7.3 </li> |
| <li> Gather information for installing Red Hat </li> |
<li> Gather information for installing Red Hat </li> |
|
Line 25 The installation process takes the follo
|
Line 33 The installation process takes the follo
|
| <li> Start/Restart services </li> |
<li> Start/Restart services </li> |
| <li> Log in to LON-CAPA </li> |
<li> Log in to LON-CAPA </li> |
| </ol> |
</ol> |
| </p> |
|
| |
|
| <h2>Obtain the Red Hat 7.3 installation CDs</h2> |
<h2>Obtain the Red Hat 7.3 installation CDs</h2> |
| <p> |
<p> |
|
Line 38 burn them yourself, or install from a mi
|
Line 45 burn them yourself, or install from a mi
|
| <p> |
<p> |
| You will need to have the following information for your site. You must |
You will need to have the following information for your site. You must |
| have a static IP address (do not use DHCP). |
have a static IP address (do not use DHCP). |
| |
</p> |
| <ul> |
<ul> |
| <li>ip address </li> |
<li>ip address </li> |
| <li>netmask </li> |
<li>netmask </li> |
|
Line 47 have a static IP address (do not use DHC
|
Line 55 have a static IP address (do not use DHC
|
| <li>gateway </li> |
<li>gateway </li> |
| <li>domain name server(s) </li> |
<li>domain name server(s) </li> |
| </ul> |
</ul> |
| </p> |
|
| |
|
| <h2>Install Red Hat 7.3</h2> |
<h2>Install Red Hat 7.3</h2> |
| <p> |
<p> |
| When you install RedHat you will need to ensure the following (the list below |
When you install RedHat you will need to ensure the following (the list below |
| is in the order the issues appear in the installation of Red Hat 7.3): |
is in the order the issues appear in the installation of Red Hat 7.3): |
| |
</p> |
| <dl> |
<dl> |
| <dt>Installation Type |
<dt>Installation Type</dt> |
| <dd>You should definitely do a "Server" install. We do not recommend |
<dd>You should definitely do a "Server" install. We do not recommend |
| Trying to install LON-CAPA with a different installation type. |
Trying to install LON-CAPA with a different installation type.</dd> |
| <dt>Partitioning your Drive |
<dt>Partitioning your Drive</dt> |
| <dd>You may want to use the automatic partitioning feature of Red Hat, |
<dd>You may want to use the automatic partitioning feature of Red Hat, |
| however you should review the results and be prepared to modify them. |
however you should review the results and be prepared to modify them. |
| LON-CAPA resource files are stored in the /home directory, so the |
LON-CAPA resource files are stored in the /home directory, so the |
| lion's share of the drive should be allocated here. If you have 8 GB |
lion's share of the drive should be allocated here. If you have 8 GB |
| of space for Red Hat, /home should receive 4 to 6 gigs. Be sure to |
of space for Red Hat, /home should receive 4 to 6 gigs. Be sure to |
| include adequate swap space. A minimum is 512 Megs, but you should |
include adequate swap space. A minimum is 512 Megs, but you should |
| typically have 1 or 2x as much swap space as you do physical RAM. |
typically have 1 or 2x as much swap space as you do physical RAM.</dd> |
| <dt>Network Configuration |
<dt>Network Configuration</dt> |
| <dd>LON-CAPA will <b>not</b> work with a machine set up to use a dynamic |
<dd>LON-CAPA will <b>not</b> work with a machine set up to use a dynamic |
| IP address. When configuring your network card, be sure to unselect |
IP address. When configuring your network card, be sure to unselect |
| the DHCP option and enter in your network information. |
the DHCP option and enter in your network information.</dd> |
| <dt>Firewall Configuration |
<dt>Firewall Configuration</dt> |
| <dd>The installation script will remove and disable your firewall. |
<dd>The installation script will remove and disable your firewall.</dd> |
| <dt>Package Group Selection |
<dt>Package Group Selection</dt> |
| <dd>At a minimum, install the following packages: |
<dd>At a minimum, install the following packages: |
| <ul> |
<ul> |
| <li>NFS File Server </li> |
<li>NFS File Server </li> |
| <li>Windows File Server </li> |
<li>Windows File Server </li> |
| <li>Web Server </li> |
<li>Web Server </li> |
| </ul> |
</ul> |
| Other packages can be installed as you like. |
Other packages can be installed as you like.</dd> |
| <dt>X Windows Configuration |
<dt>X Windows Configuration</dt> |
| <dd>If you chose to install the X-windows packages you will need to |
<dd>If you chose to install the X-windows packages you will need to |
| configure them. If you are unsure of the support for your video |
configure them. If you are unsure of the support for your video |
| card you may wish to skip the configuration. |
card you may wish to skip the configuration.</dd> |
| </dl> |
</dl> |
| |
<p> |
| Other notes: |
Other notes: |
| |
</p> |
| <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). </li> |
the default). </li> |
| </ul> |
</ul> |
| </p> |
|
| |
|
| <h2>Determine LON-CAPA settings</h2> |
<h2>Determine LON-CAPA settings</h2> |
| <p> |
<p> |
| LON-CAPA requires a number of identifying parameters be set in order |
LON-CAPA requires a number of identifying parameters be set in order |
| for it to function at all. Below is a list with descriptions. |
for it to function at all. Below is a list with descriptions. |
| |
</p> |
| <dl> |
<dl> |
| <dt>Host Type (library or access) |
<dt>Host Type (library or access)</dt> |
| <dd>The server must be designated a 'library' or an 'access' server. In |
<dd>The server must be designated a 'library' or an 'access' server. In |
| general you should have a library server for your instructors to create |
general you should have a library server for your instructors to create |
| their course content on and run their courses. Students should connect |
their course content on and run their courses. Students should connect |
| to access servers. If you are doing the first install of LON-CAPA at |
to access servers. If you are doing the first install of LON-CAPA at |
| your site, or if you are playing with it for your own edification, you |
your site, or if you are playing with it for your own edification, you |
| should make your machine a 'library' server. |
should make your machine a 'library' server.</dd> |
| <dt>LON-CAPA domain |
<dt>LON-CAPA domain</dt> |
| <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> |
<i>Restriction: One word, no hyphens, underscores, or special characters</i> |
| <dt>LON-CAPA host id |
</dd> |
| |
<dt>LON-CAPA host id</dt> |
| <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> |
<i>Restriction: One word, no hyphens, underscores, or special characters</i> |
| <dt>Host administrator email |
</dd> |
| |
<dt>Host administrator email</dt> |
| <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, or if the system is in |
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>. |
serious trouble. On a laptop, make this <tt>root@localhost</tt>. |
| <dt>Root password for SQL database |
</dd> |
| |
<dt>Root password for SQL database</dt> |
| <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.</dd> |
| </dl> |
</dl> |
| </p> |
|
| |
|
| <h2>Install LON-CAPA</h2> |
<h2>Install LON-CAPA</h2> |
| <p> |
<p> |
| Log in as root with the password you provided during the Red Hat |
Log in as root with the password you provided during the Red Hat |
| installation process. |
installation process. |
| |
</p> |
| <pre> |
<pre> |
| wget http://install.loncapa.org/versions/rh73install/loncapa-rh73install.tar |
wget http://install.loncapa.org/versions/rh73install/loncapa-rh73install.tar |
| tar xf loncapa-rh73install.tar |
tar xf loncapa-rh73install.tar |
| cd install |
cd install |
| ./install.pl |
./install.pl |
| </pre> |
</pre> |
| </p> |
|
| |
|
| <h2>Configure LON-CAPA</h2> |
<h2>Configure LON-CAPA</h2> |
| <p> |
<p> |
| Execute the following commands |
Execute the following commands |
| |
</p> |
| <pre> |
<pre> |
| cd /root/loncapa/ |
cd /root/loncapa/ |
| ./UPDATE |
./UPDATE |
| </pre> |
</pre> |
| |
<p> |
| 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. |
above. |
| </p> |
</p> |
| |
|
| <h2>Picking a hosts.tab file</h2> |
<h2>Picking a hosts.tab file</h2> |
| |
<p> |
| 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". On a laptop, you must choose 'standalone'. |
"hosts.tab". On a laptop, you must choose 'standalone'. |
| Please contact the support staff at www.loncapa.org for |
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> |
| <p> |
<p> |
| <b>Note:</b> for <b>non</b>-standalone configurations, you do need to add |
<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 |
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 |
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 |
LON-CAPA staff, so this is temporary. A <tt>hosts.tab</tt> entry has the |
| format |
format |
| |
</p> |
| <pre> |
<pre> |
| lonHostID:domain:hosttype:dns-name:ipaddress |
lonHostID:domain:hosttype:dns-name:ipaddress |
| </pre> |
</pre> |
| |
<p> |
| for example |
for example |
| |
</p> |
| <pre> |
<pre> |
| 103l5:library:s17.lite.msu.edu:35.8.63.27 |
103l5:library:s17.lite.msu.edu:35.8.63.27 |
| </pre> |
</pre> |
| |
<p> |
| Please edit this file with a UNIX editor, not a PC or Mac one, so that the |
Please edit this file with a UNIX editor, not a PC or Mac one, so that the |
| linebreaks are correct. |
linebreaks are correct. |
| |
|
| </p> |
</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 178 invoked below requires that you enter th
|
Line 198 invoked below requires that you enter th
|
| 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. |
| |
</p> |
| <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 |
|
Line 187 chown USERNAME:www ~USERNAME/public_html
|
Line 208 chown USERNAME:www ~USERNAME/public_html
|
| chmod 0775 ~USERNAME/public_html |
chmod 0775 ~USERNAME/public_html |
| chmod a+x ~USERNAME |
chmod a+x ~USERNAME |
| </pre> |
</pre> |
| </p> |
|
| |
|
| <h2>Start/Restart Services</h2> |
<h2>Start/Restart Services</h2> |
| <p> |
<p> |
| The services take about 10 minutes to start. |
The services take about 10 minutes to start. |
| |
</p> |
| <pre> |
<pre> |
| /etc/init.d/loncontrol start |
/etc/init.d/loncontrol start |
| /etc/init.d/httpd restart |
/etc/init.d/httpd restart |
| </pre> |
</pre> |
| </p> |
|
| |
|
| <h2>Make Sure that Services Autostart on Boot</h2> |
<h2>Make Sure that Services Autostart on Boot</h2> |
| <p>On Redhat 7.3 it is not guaranteed that Apache and MySQL automatically |
<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 |
restart on boot. You should run /usr/sbin/ntsysv and set the following |
| daemons to be started at boot: |
daemons to be started at boot: |
| |
</p> |
| <pre> |
<pre> |
| httpd |
httpd |
| mysqld |
mysqld |
| </pre> |
</pre> |
| |
<p> |
| It is not necessary to reboot after doing this as they should already be |
It is not necessary to reboot after doing this as they should already be |
| running by this point in the installation. |
running by this point in the installation. |
| |
</p> |
| <pre> |
<pre> |
| /etc/init.d/httpd restart |
/etc/init.d/httpd restart |
| /etc/init.d/mysqld restart |
/etc/init.d/mysqld restart |
| </pre> |
</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 |
| coordinator. Congratulations! |
coordinator. Congratulations! |
| </p> |
</p> |
| |
</body> |
| |
</html> |
![[BACK]](/icons/back.gif){kind=icon}
Return to new_install_rh73.html CVS log ![[TXT]](/icons/text.gif){kind=icon}
![[DIR]](/icons/dir.gif){kind=icon}
Up to [LON-CAPA] / doc / install / redhat7.3