--- doc/build/ubuntu20LTS_install.frag	2020/05/02 01:19:57	1.1
+++ doc/build/ubuntu20LTS_install.frag	2024/08/08 21:22:21	1.6
@@ -55,7 +55,7 @@ DHCP is <em>not</em> supported.
 
 <h2>3. <a name="lin">Ubuntu 20.04 LTS installation</a></h2>
 <p>
-Installing Ubuntu Linux is easy.
+Installing Ubuntu Linux is straightforward.
 Documentation is available from
 <a href="https://help.ubuntu.com/community/Installation">https://help.ubuntu.com/community/Installation/</a>
 Most of the installation screens are self explanatory.
@@ -93,6 +93,7 @@ Use ufw to allow incoming traffic for th
 ssh, www, https
 </p>
 <pre>
+sudo apt-get install ufw
 sudo ufw default deny
 sudo ufw enable
 sudo ufw allow ssh
@@ -125,20 +126,40 @@ sudo apt-get upgrade
 <p>
 If kernel packages were updated, reboot your system before continuing with the installation.
 </p>
-<p>
-Add LON-CAPA ubuntu repository to your /etc/apt/sources.list file. 
-</p>
-<pre>
-sudo apt-get install software-properties-common
-sudo apt-add-repository 'deb http://install.loncapa.org/ubuntu focal main'
-</pre>
 <h2>5. <a name="ilc">Installing LON-CAPA</a></h2>
 <h3>Import the LON-CAPA encryption key</h3>
 <pre>
 wget http://install.loncapa.org/versions/ubuntu/APT-GPG-KEY-loncapa.asc
 sudo apt-get install add-apt-key gpg
 sudo apt-key add APT-GPG-KEY-loncapa.asc
-sudo apt-get update
+</pre>
+<h3>Add LON-CAPA ubuntu repository to /etc/apt/sources.list file</h3>
+<p> Execute: </p>
+<pre>
+sudo apt-get install software-properties-common
+sudo add-apt-repository 'deb http://install.loncapa.org/ubuntu focal main'
+</pre>
+<p>
+You can display which repositories are currently enabled by using:
+</p>
+<pre>
+grep '^deb ' /etc/apt/sources.list |grep ' focal '
+</pre>
+<p>The output should contain:</p>
+<pre>
+deb http://us.archive.ubuntu.com/ubuntu focal main
+deb http://us.archive.ubuntu.com/ubuntu focal universe
+deb http://install.loncapa.org/ubuntu focal 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>
 <p> Execute: </p>
@@ -176,7 +197,6 @@ execute the setup script with the follow
 <pre>
 cd installation
 sudo ./install.pl
-
 </pre>
 <p>
 The script is used to prepare a Linux system to run LON-CAPA, and can also be
@@ -184,7 +204,7 @@ used to check the configuration of a sys
 </p>
 <p>
 The script will analyze your system to determine which actions are recommended.  The script will then prompt you to choose the actions you would like taken.
-Once a choice has been entered for all nine possible actions, required changes will be made.
+Once a choice has been entered for all ten possible actions, required changes will be made.
 </p>
 <p>The possible actions are:
 <ul>
@@ -193,6 +213,7 @@ Once a choice has been entered for all n
 <li>Set-up the MySQL database</li>
 <li>Set-up MySQL permissions</li>
 <li>Configure Apache web server</li>
+<li>Configure systemd security settings for Apache web server</li>
 <li>Configure start-up of services</li>
 <li>Check firewall settings</li>
 <li>Stop services not used by LON-CAPA,<br>
@@ -249,7 +270,7 @@ for it to function at all.  Below is a l
 To configure and install LON-CAPA, execute the following commands:
 </p>
 <pre>
-cd loncapa-X.Y.Z     (X.Y.Z should correspond to a version number like '2.11.3')
+cd ../loncapa-X.Y.Z  (X.Y.Z should correspond to a version number like '2.11.3')
 sudo ./UPDATE
 </pre>
 <p>
@@ -274,11 +295,11 @@ cd
 <h2>7. <a name="sts">Start/Restart Services</a></h2>
 <p>
 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>
 <pre>
-sudo systemctl start loncontrol
-sudo systemctl start apache2
+sudo /home/httpd/perl/loncontrol start
+sudo systemctl restart apache2
 exit
 </pre>
 <p>
@@ -298,7 +319,10 @@ coordinator.  Congratulations!
 <h2>If things aren't working right</h2>
 <p>
 If you've followed the steps above and the server doesn't start or you think 
-there's something wrong, please send a <a href="http://help.loncapa.org/help">help request</a> to the MSU LON-CAPA group.  If there were errors in installation of the dependency .deb packages or errors during the
+there's something wrong, please contact the LON-CAPA helpdesk.
+Installation/update support is available from: helpdesk at loncapa.org
+(replace " at " with @).
+If there were errors in installation of the dependency .deb packages or errors during the
 automatic setup, please send us as much information as possible.
 If some part of this document is unclear please let us know.
 </p>