|
version 1.4, 2008/12/10 19:57:29
|
version 1.5, 2009/09/07 14:56:53
|
|
Line 1
|
Line 1
|
| <h1>Installing LON-CAPA on a minimal SuSE Linux Enterprise Server (SLES) 10</h1> |
<h1>Installing LON-CAPA on a minimal SuSE Linux Enterprise Server (SLES) 10</h1> |
| <p> |
<p> |
| This document guides you through the process of setting up a new LON-CAPA |
This document guides you through the process of setting up a new LON-CAPA |
| server running SuSE Linux Enterprise Server 10 (SLES 10) with a minimum of packages installed. |
server running SuSE Linux Enterprise Server 10 (SLES 10) with a minimum of packages installed. |
| The computer will be configured solely as a LON-CAPA server and will be |
The computer will be configured solely as a LON-CAPA server and will be |
| expected to have no other services running. Your server is expected to have |
expected to have no other services running. Your server is expected to have |
| a reasonably fast connection to the internet. |
a reasonably fast connection to the internet. |
| </p><p> |
</p><p> |
| More information is available at |
More information is available at |
| <a href="http://install.lon-capa.org/">http://install.lon-capa.org/</a>. |
<a href="http://install.lon-capa.org/">http://install.lon-capa.org/</a>. |
| </p> |
</p> |
| |
|
| <h2>Before you begin</h2> |
<h2>Before you begin</h2> |
| <p> |
<p> |
| Installing Linux is getting easier and easier. |
Installing Linux is getting easier and easier. |
| You will be required to log in to the machine and execute |
You will be required to log in to the machine and execute |
| some routine Unix commands. Familiarity with the Apache web server, mod_perl, |
some routine Unix commands. Familiarity with the Apache web server, mod_perl, |
| perl, and MySQL are not required to install and run LON-CAPA. |
perl, and MySQL are not required to install and run LON-CAPA. |
| </p> |
</p> |
| |
|
|
Line 23 perl, and MySQL are not required to inst
|
Line 23 perl, and MySQL are not required to inst
|
| The installation process takes the following steps: |
The installation process takes the following steps: |
| </p> |
</p> |
| <ol> |
<ol> |
| <li> Obtain SLES 10 installation media</li> |
<li><a href="#obt">Obtain SLES 10 installation media</a></li> |
| <li> Determine Network Settings</li> |
<li><a href="#net">Determine Network Settings</a></li> |
| <li> Install SLES 10</li> |
<li><a href="#lin">Install SLES 10</a></li> |
| <li> Update your system </li> |
<li><a href="#upd">Update your system</a></li> |
| <li> Install LON-CAPA </li> |
<li><a href="#ilc">Install LON-CAPA</a></li> |
| <li> Create a Domain Coordinator </li> |
<li><a href="#cdc">Create a Domain Coordinator</a></li> |
| <li> Start/Restart services </li> |
<li><a href="#sts">Start/Restart services</a></li> |
| <li> Log in to LON-CAPA </li> |
<li><a href="#log">Log in to LON-CAPA</a></li> |
| </ol> |
</ol> |
| |
|
| <h2>Obtain SuSE Linux Enterprise Server 10</h2> |
<hr /> |
| |
<h2>1. <a name="obt">Obtain SuSE Linux Enterprise Server 10</a></h2> |
| <p> |
<p> |
| SuSE ISO files can be obtained from the Novell site: <a href="http://www.novell.com/products/server/">http://www.novell.com/products/server/</a>. |
SuSE ISO files can be obtained from the Novell site: <a href="http://www.novell.com/products/server/">http://www.novell.com/products/server/</a>. |
| </p> |
</p> |
| |
|
| <h2>Determine Network Settings</h2> |
<h2>2. <a name="net">Determine Network Settings</a></h2> |
| <p> |
<p> |
| You will need to know the following network settings for your installation. |
You will need to know the following network settings for your installation. |
| <b>Note:</b>You must have a static IP address to use LON-CAPA. |
<b>Note:</b>You must have a static IP address to use LON-CAPA. |
| DHCP is <em>not</em> supported. |
DHCP is <em>not</em> supported. |
| </p> |
</p> |
|
Line 52 DHCP is <em>not</em> supported.
|
Line 53 DHCP is <em>not</em> supported.
|
| <li>domain name server(s) </li> |
<li>domain name server(s) </li> |
| </ul> |
</ul> |
| |
|
| <h2>Minimal SLES 10 Install</h2> |
<h2>3. <a name="lin">Minimal SLES 10 Install</a></h2> |
| <p> |
<p> |
| Installing SuSE Linux Enterprise Server is quite easy if you've installed Linux products |
Installing SuSE Linux Enterprise Server is quite easy if you've installed Linux products |
| before. Some documentation is available from |
before. Some documentation is available from |
| <a href="http://www.novell.com/documentation/sles10/"> |
<a href="http://www.novell.com/documentation/sles10/"> |
| http://www.novell.com/documentation/sles10/</a>.<br /><br /> |
http://www.novell.com/documentation/sles10/</a>.<br /><br /> |
| Most of the subsequent installation screens are self explanatory. |
Most of the subsequent installation screens are self explanatory. |
|
Line 66 There are a few steps that require comme
|
Line 67 There are a few steps that require comme
|
| <dd>Use English as your installation language.</dd> |
<dd>Use English as your installation language.</dd> |
| |
|
| <dt>Partitioning your Drive</dt> |
<dt>Partitioning your Drive</dt> |
| <dd>For a LON-CAPA library server (i.e., the main server used |
<dd>For a LON-CAPA library server (i.e., the main server used |
| for permanent storage of course and user data), |
for permanent storage of course and user data), |
| a separate partition is recommended for /home, as this |
a separate partition is recommended for /home, as this |
| simplifies future upgrades of the operating system. |
simplifies future upgrades of the operating system. |
| If you are adding an additional access server to an |
If you are adding an additional access server to an |
| existing LON-CAPA domain, this does not apply as no |
existing LON-CAPA domain, this does not apply as no |
| permanent data are stored on an access server. |
permanent data are stored on an access server. |
| As LON-CAPA resource files are stored in the /home directory, |
As LON-CAPA resource files are stored in the /home directory, |
| the majority of the disk space should be allocated here. |
the majority of the disk space should be allocated here. |
| If you have 20 GB of space for SLES10, /home should |
If you have 20 GB of space for SLES10, /home should |
| receive at least 10 to 12 gigs. Since MySQL uses the /var |
receive at least 10 to 12 gigs. Since MySQL uses the /var |
| filesystem to store its databases you should have as least |
filesystem to store its databases you should have as least |
| 4 gigs of space available on /var. Be sure to |
4 gigs of space available on /var. 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> |
</dd> |
| <dt>Software Selection</dt> |
<dt>Software Selection</dt> |
| <dd> |
<dd> |
| Installation of the minimum set of packages is recommended. This will involve unchecking all checkboxes except for the base SuSE installation.</dd> |
Installation of the minimum set of packages is recommended. This will involve unchecking all checkboxes except for the base SuSE installation.</dd> |
| </dl> |
</dl> |
| <p>Once you system has rebooted, you will use yast to complete the configuration. Change the following settings: |
<p>Once you system has rebooted, you will use yast to complete the configuration. Change the following settings: |
|
Line 99 There are a few steps that require comme
|
Line 100 There are a few steps that require comme
|
| <p> |
<p> |
| Finish installing your server, read the "readme", reboot and log in as root. |
Finish installing your server, read the "readme", reboot and log in as root. |
| </p> |
</p> |
| <h2>Configure Firewall Settings</h2> |
<h3>Configure Firewall Settings</h3> |
| <p>After reboot you should start yast, and select Security and Users -> Firewall. At step 2 include the following services: HTTP, HTTP with SSL, and Secure Shell. Use the "Expert..." option to add additional TCP services on ports 5663 and 8080. |
<p>After reboot you should start yast, and select Security and Users -> Firewall. At step 2 include the following services: HTTP, HTTP with SSL, and Secure Shell. Use the "Expert..." option to add additional TCP services on ports 5663 and 8080. |
| </p> |
</p> |
| <h2>Change software sources for your system</h2> |
|
| |
<h2>4. <a name="upd">Change software sources for your system</a></h2> |
| <p> |
<p> |
| You will use yast to import packages required for LON-CAPA.<br /> |
You will use yast to import packages required for LON-CAPA.<br /> |
| Execute: |
Execute: |
|
Line 132 Repeat those steps with CD2, CD3 and CD4
|
Line 134 Repeat those steps with CD2, CD3 and CD4
|
| <dd>Authentication</dd> |
<dd>Authentication</dd> |
| <dt>Anonymous</dt> |
<dt>Anonymous</dt> |
| </dl> |
</dl> |
| After saving this configuration information for the LON-CAPA repository, quit yast. |
After saving this configuration information for the LON-CAPA repository, quit yast. |
| </p> |
</p> |
| |
|
| |
<h2>5. <a name="ilc">Installing LON-CAPA</a></h2> |
| <h3>Install prerequisites</h3> |
<h3>Install prerequisites</h3> |
| <p> Execute: </p> |
<p> Execute: </p> |
| <pre> |
<pre> |
|
Line 175 for it to function at all. Below is a l
|
Line 179 for it to function at all. Below is a l
|
| <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.</dd> |
should make your machine a 'library' server.</dd> |
| <dt>LON-CAPA domain</dt> |
<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. <i>Restriction: One word, no hyphens, underscores, or |
meaningful. <i>Restriction: One word, no hyphens, underscores, or |
| special characters.</i> |
special characters.</i> |
| </dd> |
</dd> |
| <dt>LON-CAPA host id</dt> |
<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. <i>Restriction: One word, |
such as "msul1" for the first library server. <i>Restriction: One word, |
| no hyphens, underscores, or special characters.</i> |
no hyphens, underscores, or special characters.</i> |
| </dd> |
</dd> |
| <dt>Host administrator email</dt> |
<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>. |
| </dd> |
</dd> |
| </dl> |
</dl> |
|
Line 205 cd /root/loncapa-N.N.N (N.N.N should
|
Line 209 cd /root/loncapa-N.N.N (N.N.N should
|
| ./UPDATE |
./UPDATE |
| </pre> |
</pre> |
| <p> |
<p> |
| You will need to enter the LON-CAPA configuration information you determined |
You will need to enter the LON-CAPA configuration information you determined |
| in the previous section. |
in the previous section. |
| </p> |
</p> |
| <p>After installing LON-CAPA, and taking any actions included in the WARNINGS file created during installation, it is recommended that you set loncontrol to start automatically on boot, by executing the following command:</p> |
<p>After installing LON-CAPA, and taking any actions included in the WARNINGS file created during installation, it is recommended that you set loncontrol to start automatically on boot, by executing the following command:</p> |
| <pre> |
<pre> |
| /sbin/chkconfig --level 345 loncontrol on |
/sbin/chkconfig --level 345 loncontrol on |
| </pre> |
</pre> |
| <h2>Creating a Domain Coordinator</h2> |
|
| |
<h2>6. <a name="cdc">Creating a Domain Coordinator</a></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. |
| </p> |
</p> |
| <pre> |
<pre> |
|
Line 227 cd /root/loncapa-N.N/loncom/build
|
Line 232 cd /root/loncapa-N.N/loncom/build
|
| perl make_domain_coordinator.pl USERNAME DOMAIN |
perl make_domain_coordinator.pl USERNAME DOMAIN |
| (WILL PROMPT FOR PASSWORD HERE) |
(WILL PROMPT FOR PASSWORD HERE) |
| </pre> |
</pre> |
| <h2>Start/Restart Services</h2> |
|
| |
<h2>7. <a name="sts">Start/Restart Services</a></h2> |
| <p> |
<p> |
| The LON-CAPA network services take a moment to start. Most misconfigurations |
The LON-CAPA network services take a moment to start. Most misconfigurations |
| will be apparent at this step. |
will be apparent at this step. |
|
Line 238 will be apparent at this step.
|
Line 244 will be apparent at this step.
|
| </pre> |
</pre> |
| <p> |
<p> |
| If you receive warnings when starting the httpd about missing perl modules, |
If you receive warnings when starting the httpd about missing perl modules, |
| please make sure you followed the instructions in |
please make sure you followed the instructions in |
| <b>Installing LON-CAPA Dependencies</b>. If you still have errors, please |
<b>Installing LON-CAPA Dependencies</b>. If you still have errors, please |
| contact the LON-CAPA group. |
contact the LON-CAPA group. |
| </p> |
</p> |
| <h2>Log in to your LON-CAPA Machine</h2> |
|
| |
<h2>8. <a name="log">Log in to your LON-CAPA Machine</a></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> |
| |
|
| |
<hr /> |
| <h2>If things aren't working right</h2> |
<h2>If things aren't working right</h2> |
| <p> |
<p> |
| If you've followed the steps above and the server doesn't start or you think |
If you've followed the steps above and the server doesn't start or you think |
![[BACK]](/icons/back.gif){kind=icon}
Return to sles10_install.frag CVS log ![[TXT]](/icons/text.gif){kind=icon}
![[DIR]](/icons/dir.gif){kind=icon}
Up to [LON-CAPA] / doc / build