--- doc/build/debian10_install.frag 2024/06/20 01:57:44 1.1 +++ doc/build/debian10_install.frag 2024/08/08 21:22:21 1.7 @@ -1,7 +1,7 @@

Installing LON-CAPA on a basic Debian 10 Server

This document guides you through the process of setting up a new LON-CAPA -server/VM running Debian 10 with only the base set of packages installed. +server/VM running Debian 10 with only the base set of packages installed. The machine (virtual or real) will be configured solely as a LON-CAPA server and will be expected to have no other services running. Your server/VM is expected to have a reasonably fast connection to the internet. @@ -68,7 +68,7 @@ There are a few steps that require comme 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 majority of the disk space should be allocated here. If you have 20 GB - of space for Debian, /home should receive at least 10 to 12 GB. + of space for Debian, /home should receive at least 10 to 12 GB. Since MySQL uses the /var filesystem to store its databases you should have at least 4 gigs of space available on /var. Be sure to include adequate swap space. A minimum is 512 Megs, but you should @@ -82,17 +82,17 @@ There are a few steps that require comme

The base system will be installed. Once that is complete you will have the option to select additional software collections. By default, "standard system utilities" will be checked -- leave that checked, and (optionally) also check SSH Server, if you plan to ssh into your Debian 10 Server/VM from another machine.

-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.

-

Enabling sudo>/h3> -

If you wish to allow the username created during installation to have administration privileges using sudo, use su to become root and execute the following, replacing <username> with that specific username: +

Enabling sudo

+

If you wish to allow the username created during installation to have administration privileges using sudo, use su to become root and execute the following, replacing <username> with that specific username:

 apt-get install sudo
-/sbin/adduser  sudo
+/sbin/adduser <username> sudo
 exit
 
-

Now logout and log in again with that username. If you prefer not to use sudo, then you should omit all instances of sudo when executing all commands listed on the remainder of this page, after using su to become root. +

Now logout and log in again with that username. If you prefer not to use sudo, then you should omit all instances of sudo when executing all commands listed on the remainder of this page, after using su to become root.

Firewall Configuration

@@ -231,7 +231,7 @@ used to check the configuration of a sys

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.

The possible actions are:

    @@ -240,6 +240,7 @@ Once a choice has been entered for all n
  • Set-up the MySQL database
  • Set-up MySQL permissions
  • Configure Apache web server
  • +
  • Configure systemd security settings for Apache web server
  • Configure start-up of services
  • Check firewall settings
  • Stop services not used by LON-CAPA,
    @@ -283,11 +284,11 @@ for it to function at all. Below is a l serious trouble. On a laptop, make this root@localhost.
    Support email address
    -
    If you enter an e-mail address here, then users of the system +
    If you enter an e-mail address here, then users of the system will be able to click an "Ask Helpdesk" link in the system to display a web form which they will complete to request support from your institution's helpdesk. On form submission the contents - will be sent to the e-mail address you specify. + will be sent to the e-mail address you specify.
    @@ -345,7 +346,10 @@ coordinator. Congratulations!

    If things aren't working right

    If you've followed the steps above and the server doesn't start or you think -there's something wrong, please send a help request 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.