--- doc/build/sles12_install.frag	2015/05/31 00:27:08	1.1
+++ doc/build/sles12_install.frag	2024/08/08 21:22:21	1.4
@@ -12,7 +12,7 @@ More information is available at
 
 <h2>Before you begin</h2>
 <p>
-Installing Linux is getting easier and easier.
+Installing Linux is straightforward.
 You will be required to log in to the machine and execute
 some routine Unix commands.  Familiarity with the Apache web server, mod_perl,
 perl, and MySQL are not required to install and run LON-CAPA.
@@ -36,7 +36,7 @@ The installation process takes the follo
 <hr>
 <h2>1. <a name="obt">Obtain SuSE Linux Enterprise Server 12</a></h2>
 <p>
-SuSE ISO files can be obtained from the Novell site: <a href="http://www.novell.com/products/server/">http://www.novell.com/products/server/</a>.  Only DVD1 is required (DVD2 contains source rpms for the various packages).
+SLES12 ISO files can be obtained from the SuSE site: <a href="https://www.suse.com/download/sles/">https://www.suse.com/download/sles/</a>.  Download the SLE-12-SP5-Full-x86_64-GM-Media1.iso.
 </p>
 
 <h2>2. <a name="net">Determine Network Settings</a></h2>
@@ -83,62 +83,77 @@ There are a few steps that require comme
        include adequate swap space.  A minimum is 512 MB, but you should
        typically have 1 or 2x as much swap space as you do physical RAM.
        </dd>
-   <dt>Software Selection</dt>
-   <dd>
-   Installation of the minimum set of packages is recommended.  This will involve unchecking all checkboxes except for the base SLES installation.</dd>
-</dl>
-<p>Once you system has rebooted, you will use yast to complete the configuration. Change the following settings:
-<dl style="list-style:square outside none">
    <dt>Network Configuration</dt>
    <dd>LON-CAPA will <b>not</b> work with a machine set up to use a dynamic
        IP address.  When configuring your network card, you should include you static IP address, netmask, host name information (e.g., host name = tmp1, domain = lite.msu.edu), as well as name servers and gateway.
    </dd>
-   <dt>Online update</dt>
-   <dd>Indicate "Yes" when prompted to "run online update now?"</dd>
+   <dt>Available Extensions and Modules</dt>
+   <dd>Register the system with suse.com, and then check boxes for the following<ul>
+       <li>SuSE Linux Enterprise Software Development Kit</li>
+       <li>SUSE Package Hub</li>
+       </ul>
+   </dd>
+   <dt>System Role</dt>
+   <dd>Select: Default System</dd>
+   <dt>Software Selection</dt>
+   <dd>Customize by clicking "Software" on the Installation Settings screen
+       Uncheck the boxes for "GNOME Desktop Environment" and X Window System.<br />
+       Check the boxes for the following:<ul>
+       <li>Help and Support Documentation</li>
+       <li>Base System</li>
+       <li>AppArmor</li>
+       <li>Minimal System (Appliances)  
+       <li>YaST2 configuration packages</li>
+       </ul>
+   </dd>
+   <dt>Security</dt>
+   <dd>The following should be set on the Installation Settings screen:
+    <ul>
+     <li>Firewall will be enabled>/li>
+     <li>SSH service will be enabled</li>
+    </ul>
+    If you will need command line access other than via the console, click the link to toggle the setting for the SSH port so it will be open.
+  </dd>
 </dl>
 <p>
-Finish installing your server, read the "readme", reboot and log in as root.
+Finish installing your server, reboot and log in as root.
 </p>
 
-<h2>4. <a name="upd">Change software sources for your system</a></h2>
+<h2>4. <a name="upd">Add software sources for your system</a></h2>
 <p>
-You will use yast to import packages required for LON-CAPA.<br>
+Use zypper to add package repositories for LON-CAPA and the statistics package: R.<br />
 Execute:
 </p>
 <pre>
-yast
+zypper addrepo http://install.loncapa.org/suse/sles12/ 'LON-CAPA'
+zypper addrepo 'https://download.opensuse.org/repositories/devel:/languages:/R:/released/SLE_12/' 'R-released SLE_12'
+zypper refresh
 </pre>
 <p>
-Select "Change Source of Installation". The media you used to install SLES12 will be listed as an installation source. If you do not already have a SLES12 installation source at your location, you may want to consider creating one from the iso files you used to create .  Proceed as follows:</p>
+Verify the required repositories are enabled:
+</p>
 <pre>
-mkdir -p sles12/DVD1
-mount -o ro,loop SLE-12-Server-DVD-x86_64-GM-DVD1.iso /mnt
-cp -rv /mnt/* sles12/DVD1
-umount /mnt
+zypper lr -E
 </pre>
-<h3>Add an additional installation source</h3>
-<p>
-Add the LON-CAPA SLES 12 repository as an additional installation source, so software installation in yast will have access to at least two repositories - a SuSE/Novell source (for packages included for the standard distribution) and the LON-CAPA repository (for extra packages needed to run LON-CAPA). For the LON-CAPA source you will use:
-</p>
-<dl style="list-style:square outside none">
-<dd>Protocol</dd>
-<dt>HTTP</dt>
-<dd>Server Name</dd>
-<dt>install.loncapa.org</dt>
-<dd>Directory on server</dd>
-<dt>suse/sles12/</dt>
-<dd>Authentication</dd>
-<dt>Anonymous</dt>
-</dl>
 <p>
-After saving this configuration information for the LON-CAPA repository, quit yast.
+The list of enabled repos should be as follows:
 </p>
-
+<table style="border: 0px; border-collapse: collapse;">
+<tr><th>Alias</th><th>Name</th></tr>
+<tr><td>LON-CAPA</td><td>LON-CAPA</td></tr>
+<tr><td>R-released SLE_12</td><td>R-released SLE_12</td></tr>
+<tr><td>SUSE_Linux_Enterprise_Server_12_SP5_x86_64:SLE-Product-SLES12-SP5-Pool</td><td>SLES12-SP5-Pool</td></tr>
+<tr><td>SUSE_Linux_Enterprise_Server_12_SP5_x86_64:SLE-Product-SLES12-SP5-Updates</td><td>SLES12-SP5-Updates</td></tr>
+<tr><td>SUSE_Linux_Enterprise_Software_Development_Kit_12_SP5_x86_64:SLE-SDK12-SP5-Pool</td><td>SLE-SDK12-SP5-Pool</td></tr>
+<tr><td>SUSE_Linux_Enterprise_Software_Development_Kit_12_SP5_x86_64:SLE-SDK12-SP5-Updates</td><td>SLE-SDK12-SP5-Updates</td></tr>
+<tr><td>SUSE_Package_Hub_12_SP5_x86_64:SUSE-PackageHub-12-SP5-Pool</td><td>SUSE-PackageHub-12-SP5-Pool</td></tr>
+<tr><td>SUSE_Package_Hub_12_SP5_x86_64:SUSE-PackageHub-12-SP5-Standard-Pool</td><td>SUSE-PackageHub-12-SP5-Standard-Pool</td></tr>
+</table>
 <h2>5. <a name="ilc">Installing LON-CAPA</a></h2>
 <h3>Install prerequisites</h3>
 <p> Execute: </p>
 <pre>
-yast -i LONCAPA-prerequisites
+zypper in LONCAPA-prerequisites
 </pre><p>
 This may take some minutes due to LON-CAPA's large number of dependencies.
 </p>
@@ -172,7 +187,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>
@@ -181,6 +196,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>
@@ -272,11 +288,11 @@ coordinator.  Congratulations!
 <hr>
 <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 get in touch with the LON-CAPA group.
-You can submit a help request using our web form:<br>
-<a href="http://help.loncapa.org/help/">http://help.loncapa.org/help/</a><br>
-If there were errors in installation of the dependency RPMs or during the
+If you've followed the steps above and the server doesn't start or you think 
+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 RPMs 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>