version 1.2, 2006/10/10 20:51:52
|
version 1.8, 2013/12/13 18:28:42
|
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 installation screens are self explanatory. |
There are a few steps that require comment and are dealt with below. |
There are a few steps that require comment and are dealt with below. |
</p> |
</p> |
<dl style="list-style:square outside none"> |
<dl style="list-style:square outside none"> |
|
<dt>Installation Language</dt> |
|
<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 91 There are a few steps that require comme
|
Line 95 There are a few steps that require comme
|
</dd> |
</dd> |
<dt>Online update</dt> |
<dt>Online update</dt> |
<dd>Indicate "Yes" when prompted to "run online update now?"</dd> |
<dd>Indicate "Yes" when prompted to "run online update now?"</dd> |
</dt> |
|
</dl> |
</dl> |
<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. |
</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: |
</p> |
</p> |
<pre> |
<pre> |
Line 116 cp -rv /mnt/* sles10/CD1
|
Line 120 cp -rv /mnt/* sles10/CD1
|
umount /mnt |
umount /mnt |
</pre> |
</pre> |
<p> |
<p> |
Repeat those steps with CD2, CD3 and CD4.</p> |
Repeat those steps with CD2, CD3 and CD4. |
|
</p> |
<h3>Add an additional installation source</h3> |
<h3>Add an additional installation source</h3> |
<p>Add the LON-CAPA SLES 10 repository as an additional installation source, so software installation in yast will have access to at least two repositories - a SuSE/Novell source (for packages included for the standard distribution) and the LON-CAPA repository (for extra packages needed to run LON-CAPA). For the LON-CAPA source you will use: |
<p> |
|
Add the LON-CAPA SLES 10 repository as an additional installation source, so software installation in yast will have access to at least two repositories - a SuSE/Novell source (for packages included for the standard distribution) and the LON-CAPA repository (for extra packages needed to run LON-CAPA). For the LON-CAPA source you will use: |
|
</p> |
<dl style="list-style:square outside none"> |
<dl style="list-style:square outside none"> |
<dd>Protocol</dd> |
<dd>Protocol</dd> |
<dt>HTTP</dt> |
<dt>HTTP</dt> |
Line 129 Repeat those steps with CD2, CD3 and CD4
|
Line 136 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. |
<p> |
|
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> |
yast -i LONCAPA-prerequisites |
yast -i LONCAPA-prerequisites |
</pre><p> |
</pre><p> |
This may take a moment due to LON-CAPA's large number of dependencies. |
This may take some minutes due to LON-CAPA's large number of dependencies. |
</p> |
</p> |
<h3>Retrieve and execute LON-CAPA setup program</h3> |
<h3>Retrieve and execute LON-CAPA setup program</h3> |
<p> |
<p> |
Retrieve the LON-CAPA setup with one of the following commands: |
Retrieve the LON-CAPA setup with one of the following commands: |
</p> |
</p> |
<pre> |
<pre> |
wget http://install.loncapa.org/versions/suse/sles10/sles10_install.tar |
wget http://install.loncapa.org/linux/install.tar |
</pre> |
</pre> |
<p> |
<p> |
Extract the archive with the following command: |
Extract the archive with the following command: |
</p> |
</p> |
<pre> |
<pre> |
tar xf sles10_install.tar |
tar xf install.tar |
</pre> |
</pre> |
<p> |
<p> |
This creates a directory named <tt>installation</tt>. Change to it and |
This creates a directory named <tt>installation</tt>. Change to it and |
Line 160 cd installation
|
Line 170 cd installation
|
./install.pl |
./install.pl |
</pre> |
</pre> |
<p> |
<p> |
This script will prompt you for the MySQL root password and will download the latest LON-CAPA release. |
The script is used to prepare a Linux system to run LON-CAPA, and can also be |
|
used to check the configuration of a system on which LON-CAPA has already been installed. Typically, though, you will run this script only once, when you first install LON-CAPA. |
|
</p> |
|
<p> |
|
The script will analyze your system to determine which actions are recommended. The script will then prompt you to choose the actions you would like taken. |
|
Once a choice has been entered for all nine possible actions, required changes will be made. |
</p> |
</p> |
|
<p>The possible actions are: |
|
<ul> |
|
<li>Create the www user/group</li> |
|
<li>Install the package LON-CAPA uses to authenticate users.</li> |
|
<li>Set-up the MySQL database</li> |
|
<li>Set-up MySQL permissions</li> |
|
<li>Configure Apache web server</li> |
|
<li>Configure start-up of services</li> |
|
<li>Check firewall settings</li> |
|
<li>Stop services not used by LON-CAPA,<br> |
|
e.g., services for a print server: cups daemon</li> |
|
<li>Download LON-CAPA source code in readiness for installation</li> |
|
</ul> |
|
</p> |
|
|
<h3>Determine LON-CAPA Settings</h3> |
<h3>Determine LON-CAPA Settings</h3> |
<p> |
<p> |
LON-CAPA requires a number of identifying parameters to be set in order |
LON-CAPA requires a number of identifying parameters to be set in order |
Line 172 for it to function at all. Below is a l
|
Line 202 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 198 for it to function at all. Below is a l
|
Line 228 for it to function at all. Below is a l
|
To configure and install LON-CAPA, execute the following commands: |
To configure and install LON-CAPA, execute the following commands: |
</p> |
</p> |
<pre> |
<pre> |
cd /root/loncapa-N.N.N (N.N.N should correspond to a version number like '2.2.2') |
cd /root/loncapa-X.Y.Z (X.Y.Z should correspond to a version number like '2.10.0') |
./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 35 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 user's password. |
show in plaintext as you type it. Feel free to use the "passwd username" |
Feel free to use the "passwd username" command to change it later. |
command to change it later. Replace USERNAME and DOMAIN with an |
Replace USERNAME and DOMAIN with an appropriate user name and your domain. |
appropriate user name and your domain. |
|
</p> |
</p> |
<pre> |
<pre> |
cd /root/loncapa-N.N/loncom/build |
cd /root/loncapa-X.Y.Z/loncom/build |
perl make_domain_coordinator.pl USERNAME DOMAIN |
perl make_domain_coordinator.pl USERNAME DOMAIN |
(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 235 will be apparent at this step.
|
Line 265 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 support team. |
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 |
there's something wrong, please get in touch with the LON-CAPA support team. |
there's something wrong, please get in touch with the LON-CAPA group. |
You can submit a help request using our web form:<br /> |
You can submit a help request using our web form:<br> |
<a href="http://support.loncapa.org/help/">http://support.loncapa.org/help/</a><br /> |
<a href="http://help.loncapa.org/help/">http://help.loncapa.org/help/</a><br> |
If there were errors in installation of the dependency RPMs or during the |
If there were errors in installation of the dependency RPMs or during the |
automatic setup, please send us as much information as possible. |
automatic setup, please send us as much information as possible. |
If some part of this document is unclear please let us know. |
If some part of this document is unclear please let us know. |