doc/build/ubuntu12LTS_install.frag - diff

Return to ubuntu12LTS_install.frag CVS log

Up to [LON-CAPA] / doc / build

Diff for /doc/build/ubuntu12LTS_install.frag between versions 1.1 and 1.5

version 1.1, 2012/07/30 13:04:37	version 1.5, 2022/03/26 19:00:51
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 add-apt-repository 'deb http://install.loncapa.org/ubuntu precise main'
	</pre>
	<p>
	You can display which repositories are currently enabled by using:
	</p>
	<pre>
	grep '^deb ' /etc/apt/sources.list \|grep ' precise '
	</pre>
	<p>The output should contain:</p>
	<pre>
	deb http://us.archive.ubuntu.com/ubuntu precise main
	deb http://us.archive.ubuntu.com/ubuntu precise universe
	deb http://install.loncapa.org/ubuntu precise main
	</pre>
	<p>If the Ubuntu universe repository is absent it can be added using:</p>
	<pre>
	sudo add-apt-repository universe
	</pre>
	<p>If other Ubuntu repositories, e.g., restricted and multiverse are enabled,
	you can disable them, as they are not needed for LON-CAPA, by using:</p>
	<pre>
	sudo add-apt-repository --remove restricted
	sudo add-apt-repository --remove multiverse
	</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 169 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 217 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 240 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 268 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 288 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 316 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

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>

Removed from v.1.1
changed lines
	Added in v.1.5