version 1.2, 2011/06/08 22:04:31
|
version 1.8, 2013/12/16 13:44:33
|
Line 33 The installation process takes the follo
|
Line 33 The installation process takes the follo
|
<li><a href="#log">Log in to LON-CAPA</a></li> |
<li><a href="#log">Log in to LON-CAPA</a></li> |
</ol> |
</ol> |
|
|
<hr /> |
<hr> |
<h2>1. <a name="obt">Obtain Ubuntu 8.04 LTS .iso file</a></h2> |
<h2>1. <a name="obt">Obtain Ubuntu 8.04 LTS .iso file</a></h2> |
<p> |
<p> |
Ubuntu 8.04 LTS (server install) isos can be obtained from links on the <a href="http://mirrors.kernel.org/ubuntu-releases/hardy/HEADER.html>Ubuntu Releases page </a> at mirrors.kernel.org.<br /> |
Ubuntu 8.04 LTS (server install) isos can be obtained from links on the <a href="http://mirrors.kernel.org/ubuntu-releases/hardy/HEADER.html">Ubuntu Releases</a> page at mirrors.kernel.org.<br> |
An .iso file (either 32 bit or 64 bit) can be burned to a CD. |
An .iso file (either 32 bit or 64 bit) can be burned to a CD. |
</p> |
</p> |
|
|
Line 68 There are a few steps that require comme
|
Line 68 There are a few steps that require comme
|
<dt>Installation Type</dt> |
<dt>Installation Type</dt> |
<dd>If this is a fresh install choose "Install Ubuntu Server".</dd> |
<dd>If this is a fresh install choose "Install Ubuntu Server".</dd> |
<dt>Partitioning your Drive</dt> |
<dt>Partitioning your Drive</dt> |
<dd>For a fresh install may want to use the automatic partitioning feature of the installer. |
<dd>For a fresh install you may want to use the automatic partitioning feature of the installer. |
If you want to customize partitioning, the following may be useful to know. |
If you decide to customize partitioning, the following may be useful to know. |
LON-CAPA resource files are stored in the /home directory, so the |
LON-CAPA resource files are stored in the /home directory, so the |
majority of the disk space should be allocated here. If you have 20 GB |
majority of the disk space should be allocated here. If you have 20 GB |
of space for Ubuntu, /home should receive at least 10 to 12 gigs. |
of space for Ubuntu, /home should receive at least 10 to 12 gigs. |
Line 86 There are a few steps that require comme
|
Line 86 There are a few steps that require comme
|
<dd>The base system will be installed. Once that is complete you will have the option to select additional software collections. Leave all unselected.</dd> |
<dd>The base system will be installed. Once that is complete you will have the option to select additional software collections. Leave all unselected.</dd> |
</dl> |
</dl> |
<p> |
<p> |
|
|
Finish installing your server, reboot it, and log in with the username you created during installation. |
Finish installing your server, reboot it, and log in with the username you created during installation. |
<dt>Firewall Configuration</dt> |
</p> |
<dd>Use ufw to allow incoming traffic for the following services: |
<h3>Firewall Configuration</h3> |
ssh, www, https |
<p> |
</dd> |
Use ufw to allow incoming traffic for the following services: |
|
ssh, www, https |
|
</p> |
<pre> |
<pre> |
sudo ufw default deny |
sudo ufw default deny |
sudo ufw enable |
sudo ufw enable |
sudo allow ssh |
sudo ufw allow ssh |
sudo allow www |
sudo ufw allow www |
sudo allow https |
sudo ufw allow https |
</pre> |
</pre> |
<dt>E-mail Configuration</dt> |
<h3>E-mail Configuration</h3> |
<dd>By default Ubuntu disallows mailing to remote domains. Change using<dd> |
<p> |
|
By default Ubuntu disallows mailing to remote domains. Change using |
|
</p> |
<pre> |
<pre> |
sudo dpkg-reconfigure exim4-config |
sudo dpkg-reconfigure exim4-config |
</pre |
</pre> |
</p> |
|
|
|
<h2>4. <a name="upd">Update your system</a></h2> |
<h2>4. <a name="upd">Update your system</a></h2> |
<p> |
<p> |
Line 142 sudo apt-get update
|
Line 144 sudo apt-get update
|
<h3>Install prerequisites</h3> |
<h3>Install prerequisites</h3> |
<p> Execute: </p> |
<p> Execute: </p> |
<pre> |
<pre> |
sudo apt-get install loncpa-prerequisites |
sudo apt-get install 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> |
Line 185 Once a choice has been entered for all n
|
Line 187 Once a choice has been entered for all n
|
<li>Configure Apache web server</li> |
<li>Configure Apache web server</li> |
<li>Configure start-up of services</li> |
<li>Configure start-up of services</li> |
<li>Check firewall settings</li> |
<li>Check firewall settings</li> |
<li>Stop services not used by LON-CAPA,<br /> |
<li>Stop services not used by LON-CAPA,<br> |
e.g., services for a print server: cups daemon</li> |
e.g., services for a print server: cups daemon</li> |
<li>Download LON-CAPA source code in readiness for installation</li> |
<li>Download LON-CAPA source code in readiness for installation</li> |
</ul> |
</ul> |
Line 208 for it to function at all. Below is a l
|
Line 210 for it to function at all. Below is a l
|
<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><br />Domain names which include a departmental |
special characters.</i><br>Domain names which include a departmental |
abbreviation are not recommended as although LON-CAPA may start in |
abbreviation are not recommended as although LON-CAPA may start in |
a single department, other departments frequently join subsequently. |
a single department, other departments frequently join subsequently. |
For a domain name: 'msu' is a superior choice to 'msuphys' for example. |
For a domain name: 'msu' is a superior choice to 'msuphys' for example. |
Line 240 To configure and install LON-CAPA, becom
|
Line 242 To configure and install LON-CAPA, becom
|
</p> |
</p> |
<pre> |
<pre> |
sudo -i |
sudo -i |
cd /root/loncapa-N.N (N.N should correspond to a version number like '2.10.0') |
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> |
Line 253 in the previous section.
|
Line 255 in the previous section.
|
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" |
Replace USERNAME and DOMAIN with an appropriate username and your domain. |
command to change it later. Replace USERNAME and DOMAIN with an |
|
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>7. <a name="sts">Start/Restart Services</a></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. Lastly exit from root status to resume use of your regular account. |
will be apparent at this step. Lastly, exit from root status to resume use of your regular account. |
</p> |
</p> |
<pre> |
<pre> |
/etc/init.d/loncontrol start |
/etc/init.d/loncontrol start |
Line 287 Point a web browser at your new machine
|
Line 286 Point a web browser at your new machine
|
coordinator. Congratulations! |
coordinator. Congratulations! |
</p> |
</p> |
|
|
<hr /> |
<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 |