|
version 1.2, 2008/05/22 21:39:15
|
version 1.4, 2009/09/07 14:56:19
|
|
Line 1
|
Line 1
|
| <h1>Installing LON-CAPA on a minimal SuSE Linux 10.3 System</h1> |
<h1>Installing LON-CAPA on a minimal SuSE Linux 10.3 System</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 10.3 with a minimum of packages installed. |
server running SuSE Linux 10.3 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 a reasonably fast connection to the internet. |
expected to have no other services running. Your server is expected to have 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. You will be required to log in to the machine and execute some routine Unix commands. Familiarity with the Apache web server, mod_perl, perl, and MySQL are not required to install and run LON-CAPA. |
Installing Linux is getting easier and easier. You will be required to log in to the machine and execute some routine Unix commands. Familiarity with the Apache web server, mod_perl, perl, and MySQL are not required to install and run LON-CAPA. |
| </p> |
</p> |
| |
|
| <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> |
</p> |
| <ol> |
<ol> |
| <li> Obtain SuSE 10.3 installation media (DVD, or CD)</li> |
<li><a href="#obt">Obtain SuSE 10.3 installation media (DVD, or CD)</a></li> |
| <li> Determine Network Settings</li> |
<li><a href="#net">Determine Network Settings</a></li> |
| <li> Install Suse 10.3</li> |
<li><a href="#lin">Install Suse 10.3</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 10.3</h2> |
<hr /> |
| |
|
| |
<h2>1. <a name="obt">Obtain SuSE Linux 10.3</a></h2> |
| <p> |
<p> |
| A SuSE 10.3 iso for burning to DVD can be obtained from the opensuse download site: <a href="http://software.opensuse.org/">http://http://software.opensuse.org/</a>, or from an opensuse mirror site - <a href="http://en.opensuse.org/Mirrors_Released_Version">http://en.opensuse.org/Mirrors_Released_Version</a>. You will also find links there to sites with iso files for burning a Start-CD-Image (a mini.iso) used in a network install, if burning a CD is more convenient for you. |
A SuSE 10.3 iso for burning to DVD can be obtained from the opensuse download site: <a href="http://software.opensuse.org/">http://http://software.opensuse.org/</a>, or from an opensuse mirror site - <a href="http://en.opensuse.org/Mirrors_Released_Version">http://en.opensuse.org/Mirrors_Released_Version</a>. You will also find links there to sites with iso files for burning a Start-CD-Image (a mini.iso) used in a network install, if burning a CD is more convenient for you. |
| </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. |
|
Line 43 DHCP is <em>not</em> supported.
|
Line 48 DHCP is <em>not</em> supported.
|
| <li>gateway </li> |
<li>gateway </li> |
| <li>domain name server(s) </li> |
<li>domain name server(s) </li> |
| </ul> |
</ul> |
| <h2>Minimal SuSE 10.3 Install</h2> |
|
| |
<h2>3. <a name="lin">Minimal SuSE 10.3 Install</a></h2> |
| <p> |
<p> |
| Installing SuSE 10.3 is quite easy if you've installed Linux products |
Installing SuSE 10.3 is quite easy if you've installed Linux products |
| before. Some documentation is available from |
before. Some documentation is available from |
| <a href="http://en.opensuse.org/INSTALL_Local"> |
<a href="http://en.opensuse.org/INSTALL_Local"> |
| http://en.opensuse.org/INSTALL_Local</a> for installations from DVD and |
http://en.opensuse.org/INSTALL_Local</a> for installations from DVD and |
| <a href="http://en.opensuse.org/INSTALL_Internet">http://en.opensuse.org/INSTALL_Internet</a> for installations via the network, booting from the mini.iso CD.<br /><br /> |
<a href="http://en.opensuse.org/INSTALL_Internet">http://en.opensuse.org/INSTALL_Internet</a> for installations via the network, booting from the mini.iso CD.<br /><br /> |
|
Line 61 There are a few steps that require comme
|
Line 67 There are a few steps that require comme
|
| <dt>Software Selection</dt> |
<dt>Software Selection</dt> |
| <dd>Choose Expert Mode and for Software enable Base System, Yast Installation Packages and Software Management</dd> |
<dd>Choose Expert Mode and for Software enable Base System, Yast Installation Packages and Software Management</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 |
| permenent data are stored on an access server. |
permenent 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 SuSE 10.3, /home should |
If you have 20 GB of space for SuSE 10.3, /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> |
|
Line 96 proceed to have you create a user accoun
|
Line 102 proceed to have you create a user accoun
|
| and let you configure any extra hardware, and then finish up the boot |
and let you configure any extra hardware, and then finish up the boot |
| process. At the prompt login as root. |
process. At the prompt login as root. |
| </p> |
</p> |
| <h2>Change software sources for your system</h2> |
|
| |
<h2>4. <a name="upd">Change software sources for your system</a></h2> |
| <p>If you do not already have a SuSE 10.3 installation source at your location, you may want to consider creating one from the iso file for the DVD. Proceed as follows (e.g., for 32 bit):</p> |
<p>If you do not already have a SuSE 10.3 installation source at your location, you may want to consider creating one from the iso file for the DVD. Proceed as follows (e.g., for 32 bit):</p> |
| <pre> |
<pre> |
| mkdir -p suse103/DVD |
mkdir -p suse103/DVD |
|
Line 127 Select "Installation Source" and change
|
Line 134 Select "Installation Source" and change
|
| <dd>Authentication</dd> |
<dd>Authentication</dd> |
| <dt>Anonymous</dt> |
<dt>Anonymous</dt> |
| </dl> |
</dl> |
| After saving this configuration information for the LON-CAPA repository, you will need to import a public LON-CAPA key, before the catalog is read, and the repository is available to you. Quit yast. |
After saving this configuration information for the LON-CAPA repository, you will need to import a public LON-CAPA key, before the catalog is read, and the repository is available to you. Quit yast. |
| </p> |
</p> |
| <h2>Installing LON-CAPA</h2> |
|
| |
<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 171 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 201 cd /root/loncapa-N.N (N.N should cor
|
Line 209 cd /root/loncapa-N.N (N.N should cor
|
| ./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> |
| <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 219 cd /root/loncapa-N.N/loncom/build
|
Line 228 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 230 will be apparent at this step.
|
Line 240 will be apparent at this step.
|
| </pre> |
</pre> |
| <p> |
<p> |
| If you receive warnings about missing perl modules when starting apache2, |
If you receive warnings about missing perl modules when starting apache2, |
| 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 MSU 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 MSU 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. |
| Please let us know if any parts of this document are unclear. |
Please let us know if any parts of this document are unclear. |
| </p> |
</p> |
![[BACK]](/icons/back.gif){kind=icon}
Return to suse10.3_install.frag CVS log ![[TXT]](/icons/text.gif){kind=icon}
![[DIR]](/icons/dir.gif){kind=icon}
Up to [LON-CAPA] / doc / build