version 1.1, 2012/07/30 13:04:37
|
version 1.4, 2021/03/17 03:21:24
|
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 12.04 LTS .iso file</a></h2> |
<h2>1. <a name="obt">Obtain Ubuntu 12.04 LTS .iso file</a></h2> |
<p> |
<p> |
Ubuntu 12.04 LTS (server install) isos can be obtained from the <a href="http://www.ubuntu.com/download/server/download">Ubuntu Server download</a> page<br /> |
Ubuntu 12.04 LTS (server install) isos can be obtained from the <a href="http://www.ubuntu.com/download/server/download">Ubuntu Server download</a> page<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 56 DHCP is <em>not</em> supported.
|
Line 56 DHCP is <em>not</em> supported.
|
|
|
<h2>3. <a name="lin">Ubuntu 12.04 LTS installation</a></h2> |
<h2>3. <a name="lin">Ubuntu 12.04 LTS installation</a></h2> |
<p> |
<p> |
Installing Ubuntu Linux is easy. |
Installing Ubuntu Linux is straightforward. |
Documentation is available from |
Documentation is available from |
<a href="https://help.ubuntu.com/community/Installation">https://help.ubuntu.com/community/Installation/</a> |
<a href="https://help.ubuntu.com/community/Installation">https://help.ubuntu.com/community/Installation/</a> |
Most of the installation screens are self explanatory. |
Most of the installation screens are self explanatory. |
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 apt-get install ufw |
sudo ufw default deny |
sudo ufw default deny |
sudo ufw enable |
sudo ufw enable |
sudo ufw allow ssh |
sudo ufw allow ssh |
sudo ufw allow www |
sudo ufw allow www |
sudo ufw allow https |
sudo ufw allow https |
</pre> |
</pre> |
<dt>E-mail: Postfix Installation</dt> |
<h3>E-mail: Postfix Installation</h3> |
<dd>Configure to "Internet Site" to allow LON-CAPA to send e-mail to users.</dd> |
<p> |
|
Configure to "Internet Site" to allow LON-CAPA to send e-mail to users. |
|
</p> |
<pre> |
<pre> |
sudo apt-get install postfix |
sudo apt-get install postfix |
</pre> |
</pre> |
<dt>E-mail: Postfix Configuration</dt> |
<h3>E-mail: Postfix Configuration</h3> |
<dd>If you need to change the postfix configuration in the future use:<dd> |
<p> |
|
If you need to change the postfix configuration in the future use: |
|
</p> |
<pre> |
<pre> |
sudo dpkg-reconfigure postfix |
sudo dpkg-reconfigure postfix |
</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 122 sudo apt-get upgrade
|
Line 127 sudo apt-get upgrade
|
<p> |
<p> |
If kernel packages were updated, reboot your system before continuing with the installation. |
If kernel packages were updated, reboot your system before continuing with the installation. |
</p> |
</p> |
<p> |
|
Add LON-CAPA ubuntu repository to your /etc/apt/sources.list file. |
|
</p> |
|
<pre> |
|
sudo apt-get install python-software-properties |
|
sudo apt-add-repository 'deb http://install.loncapa.org/ubuntu precise main' |
|
</pre> |
|
<h2>5. <a name="ilc">Installing LON-CAPA</a></h2> |
<h2>5. <a name="ilc">Installing LON-CAPA</a></h2> |
<h3>Import the LON-CAPA encryption key</h3> |
<h3>Import the LON-CAPA encryption key</h3> |
<pre> |
<pre> |
Line 136 wget http://install.loncapa.org/versions
|
Line 134 wget http://install.loncapa.org/versions
|
sudo apt-key add APT-GPG-KEY-loncapa.asc |
sudo apt-key add APT-GPG-KEY-loncapa.asc |
sudo apt-get update |
sudo apt-get update |
</pre> |
</pre> |
|
<h3>Add LON-CAPA ubuntu repository to /etc/apt/sources.list</h3> |
|
<p> Execute: </p> |
|
<pre> |
|
sudo apt-get install python-software-properties |
|
sudo apt-add-repository 'deb http://install.loncapa.org/ubuntu precise main' |
|
</pre> |
|
<p> |
|
You can display which repositories are currently enabled by using: |
|
</p> |
|
<pre> |
|
sudo apt-cache policy |
|
</pre> |
<h3>Install prerequisites</h3> |
<h3>Install prerequisites</h3> |
<p> Execute: </p> |
<p> Execute: </p> |
<pre> |
<pre> |
Line 143 sudo apt-get install loncapa-prerequisit
|
Line 153 sudo apt-get install loncapa-prerequisit
|
</pre><p> |
</pre><p> |
This may take some minutes 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>Secure MySQL</h3> |
|
<p> Execute: </p> |
|
<pre> |
|
sudo mysql_secure_installation |
|
</pre><p> |
|
Answer “Y” (yes) to the prompts to: |
|
(a) remove anonymous users, |
|
(b) restrict root user access to the local machine, |
|
and (c) remove the test database.</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 script and dependencies with the following command: |
Retrieve the LON-CAPA setup script and dependencies with the following command: |
Line 182 Once a choice has been entered for all n
|
Line 201 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 205 for it to function at all. Below is a l
|
Line 224 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 233 for it to function at all. Below is a l
|
Line 252 for it to function at all. Below is a l
|
|
|
<h3>Configuring LON-CAPA</h3> |
<h3>Configuring LON-CAPA</h3> |
<p> |
<p> |
To configure and install LON-CAPA, become root and execute the following commands: |
To configure and install LON-CAPA execute the following commands: |
</p> |
</p> |
<pre> |
<pre> |
sudo -i |
cd ../loncapa-X.Y.Z (X.Y.Z should correspond to a version number like '2.11.0') |
cd /root/loncapa-X.Y.Z (X.Y.Z should correspond to a version number like '2.11.0') |
sudo ./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 |
Line 254 invoked below requires that you enter th
|
Line 272 invoked below requires that you enter th
|
Replace USERNAME and DOMAIN with an appropriate username and your domain. |
Replace USERNAME and DOMAIN with an appropriate username and your domain. |
</p> |
</p> |
<pre> |
<pre> |
cd /root/loncapa-X.Y.Z/loncom/build |
cd loncom/build |
perl make_domain_coordinator.pl USERNAME DOMAIN |
sudo perl make_domain_coordinator.pl USERNAME DOMAIN |
|
cd |
</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. |
</p> |
</p> |
<pre> |
<pre> |
/etc/init.d/loncontrol start |
sudo /etc/init.d/loncontrol start |
/etc/init.d/apache2 restart |
sudo service apache2 restart |
exit |
exit |
</pre> |
</pre> |
<p> |
<p> |
Line 281 Point a web browser at your new machine
|
Line 300 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 |