|
version 1.1, 2024/06/20 01:57:44
|
version 1.7, 2024/08/08 21:22:21
|
|
Line 1
|
Line 1
|
| <h1>Installing LON-CAPA on a basic Debian 10 Server</h1> |
<h1>Installing LON-CAPA on a basic Debian 10 Server</h1> |
| <p> |
<p> |
| This document guides you through the process of setting up a new LON-CAPA |
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 |
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 |
expected to have no other services running. Your server/VM is expected to have |
| a reasonably fast connection to the internet. |
a reasonably fast connection to the internet. |
|
Line 68 There are a few steps that require comme
|
Line 68 There are a few steps that require comme
|
| If you decide to customize partitioning, the following may be useful to know. |
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 |
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 |
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 |
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 |
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 |
include adequate swap space. A minimum is 512 Megs, but you should |
|
Line 82 There are a few steps that require comme
|
Line 82 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. 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.</dd> |
<dd>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.</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. |
| </p> |
</p> |
| <h3>Enabling sudo>/h3> |
<h3>Enabling sudo</h3> |
| <p>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 <i><username><i> with that specific username: |
<p>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 <i><username></i> with that specific username: |
| </p> |
</p> |
| <pre> |
<pre> |
| apt-get install sudo |
apt-get install sudo |
| /sbin/adduser <username> sudo |
/sbin/adduser <username> sudo |
| exit |
exit |
| </pre> |
</pre> |
| <p>Now logout and log in again with that username. If you prefer not to use sudo, then you should omit all instances of <l>sudo<i> when executing all commands listed on the remainder of this page, after using su to become root. |
<p>Now logout and log in again with that username. If you prefer not to use sudo, then you should omit all instances of <i>sudo</i> when executing all commands listed on the remainder of this page, after using su to become root. |
| </p> |
</p> |
| <h3>Firewall Configuration</h3> |
<h3>Firewall Configuration</h3> |
| <p> |
<p> |
|
Line 231 used to check the configuration of a sys
|
Line 231 used to check the configuration of a sys
|
| </p> |
</p> |
| <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. |
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> |
| <p>The possible actions are: |
<p>The possible actions are: |
| <ul> |
<ul> |
|
Line 240 Once a choice has been entered for all n
|
Line 240 Once a choice has been entered for all n
|
| <li>Set-up the MySQL database</li> |
<li>Set-up the MySQL database</li> |
| <li>Set-up MySQL permissions</li> |
<li>Set-up MySQL permissions</li> |
| <li>Configure Apache web server</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>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> |
|
Line 283 for it to function at all. Below is a l
|
Line 284 for it to function at all. Below is a l
|
| serious trouble. On a laptop, make this <tt>root@localhost</tt>. |
serious trouble. On a laptop, make this <tt>root@localhost</tt>. |
| </dd> |
</dd> |
| <dt>Support email address</dt> |
<dt>Support email address</dt> |
| <dd>If you enter an e-mail address here, then users of the system |
<dd>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 |
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 |
display a web form which they will complete to request support from |
| your institution's helpdesk. On form submission the contents |
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. |
| </dd> |
</dd> |
| </dl> |
</dl> |
| |
|
|
Line 345 coordinator. Congratulations!
|
Line 346 coordinator. Congratulations!
|
| <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 |
| 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. |
automatic setup, please send us as much information as possible. |
| If some part of this document is unclear please let us know. |
If some part of this document is unclear please let us know. |
| </p> |
</p> |
![[BACK]](/icons/back.gif){kind=icon}
Return to debian10_install.frag CVS log ![[TXT]](/icons/text.gif){kind=icon}
![[DIR]](/icons/dir.gif){kind=icon}
Up to [LON-CAPA] / doc / build