|
version 1.1, 2011/06/08 21:54:03
|
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 |
| /etc/init.d/httpd start |
/etc/init.d/apache2 restart |
| exit |
exit |
| </pre> |
</pre> |
| <p> |
<p> |
| If you receive warnings when starting the httpd about missing perl modules, |
If you receive warnings when starting Apache 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 prerequisites</b>. If you still have errors, please |
| contact the MSU LON-CAPA group. |
contact the MSU LON-CAPA group. |
| </p> |
</p> |
| |
|
|
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 |
![[BACK]](/icons/back.gif){kind=icon}
Return to ubuntu8LTS_install.frag CVS log ![[TXT]](/icons/text.gif){kind=icon}
![[DIR]](/icons/dir.gif){kind=icon}
Up to [LON-CAPA] / doc / build