version 1.1, 2019/10/03 15:12:52
|
version 1.2, 2019/10/03 23:40:32
|
Line 34 The installation process takes the follo
|
Line 34 The installation process takes the follo
|
</ol> |
</ol> |
|
|
<hr /> |
<hr /> |
<h2>1. <a name="obt">Obtain CentOS Linux 8</a></h2> |
<h2>1. <a id="obt">Obtain CentOS Linux 8</a></h2> |
<p> |
<p> |
CentOS 8 isos can be obtained from links included on the |
CentOS 8 isos can be obtained from links included on the |
<a href="http://mirror.centos.org/centos/8/isos/x86_64">CentOS download page</a>. |
<a href="http://mirror.centos.org/centos/8/isos/x86_64">CentOS download page</a>. |
Either download the Boot ISO or the CentOS 8 DVD1 ISO. |
Either download the Boot ISO or the CentOS 8 DVD1 ISO. |
</p> |
</p> |
|
|
<h2>2. <a name="net">Determine Network Settings</a></h2> |
<h2>2. <a id="net">Determine Network Settings</a></h2> |
<p> |
<p> |
You will need to know the following network settings for your installation. |
You will need to know the following network settings for your installation. |
<b>Note:</b>You must have a static IP address to use LON-CAPA. |
<b>Note: </b>You must have a static IP address to use LON-CAPA. |
DHCP is <em>not</em> supported. |
DHCP is <em>not</em> supported. |
|
|
<ul> |
<ul> |
Line 55 DHCP is <em>not</em> supported.
|
Line 55 DHCP is <em>not</em> supported.
|
<li>domain name server(s) </li> |
<li>domain name server(s) </li> |
</ul> |
</ul> |
|
|
<h2>3. <a name="lin">Minimal CentOS Linux 8 Install</a></h2> |
<h2>3. <a id="lin">Minimal CentOS Linux 8 Install</a></h2> |
<p> |
<p> |
Documentation is available from |
Documentation is available from |
<a href="https://docs.centos.org/en-US/8-docs/"> |
<a href="https://docs.centos.org/en-US/8-docs/"> |
Line 100 sudo firewall-cmd --zone=public --perman
|
Line 100 sudo firewall-cmd --zone=public --perman
|
sudo firewall-cmd --reload |
sudo firewall-cmd --reload |
</pre> |
</pre> |
|
|
<h2>4. <a name="upd">Update your system</a></h2> |
<h2>4. <a id="upd">Update your system</a></h2> |
<p> |
<p> |
Update your system to the latest versions of the system software using dnf. |
Update your system to the latest versions of the system software using dnf. |
</p> |
</p> |
Line 134 mv centos8_PowerTools_yum.conf /etc/yum.
|
Line 134 mv centos8_PowerTools_yum.conf /etc/yum.
|
</pre> |
</pre> |
</li> |
</li> |
</ol> |
</ol> |
|
<p> |
|
Check the required repositories are enabled |
|
</p> |
|
<pre> |
|
dnf repolist enabled |
|
</pre> |
|
<p> |
|
The list of enabled repos should be as follows: |
|
</p> |
|
<table style="border: 0px; border-collapse: collapse;"> |
|
<tr><th>repo id</th><th>repo name</th></tr> |
|
<tr><td>AppStream</td><td>CentOS-8 - AppStream</td></tr> |
|
<tr><td>BaseOS</td><td>CentOS-8 - Base</td></tr> |
|
<tr><td>PowerTools</td><td>CentOS-8 - PowerTools</td></tr> |
|
<tr><td>*epel</td><td>Extra Packages for Enterprise Linux 8 - x86_6</td></tr> |
|
<tr><td>extras</td><td>CentOS-8 - Extras</td></tr> |
|
<tr><td>loncapa-updates-basearch</td><td>CentOS 8 LON-CAPA x86_64 Updates</td></tr> |
|
<tr><td>loncapa-updates-noarch</td><td>CentOS 8 LON-CAPA noarch Updates</td></tr> |
|
</table> |
|
|
<h3>Install and enable a Mail Transfer Agent (MTA), e.g., postfix</h3> |
<h3>Install and enable a Mail Transfer Agent (MTA), e.g., postfix</h3> |
<pre> |
<pre> |
Line 159 mv loncapa_selinux_config /etc/selinux/c
|
Line 178 mv loncapa_selinux_config /etc/selinux/c
|
reboot |
reboot |
</pre> |
</pre> |
|
|
<h2>5. <a name="ilc">Installing LON-CAPA</a></h2> |
<h2>5. <a id="ilc">Installing LON-CAPA</a></h2> |
<h3>Install prerequisites</h3> |
<h3>Install prerequisites</h3> |
<p> Execute: </p> |
<p> Execute: </p> |
<pre> |
<pre> |
Line 181 Extract the archive with the following c
|
Line 200 Extract the archive with the following c
|
tar xf install.tar |
tar xf install.tar |
</pre> |
</pre> |
<p> |
<p> |
This creates a directory named <tt>installation</tt>. Change to it and |
This creates a directory named <span style="font-family: 'Lucida Console','Menlo','Monaco','Courier', monospace;">installation</span>. |
execute the setup script with the following commands: |
Change to it and execute the setup script with the following commands: |
</p> |
</p> |
<pre> |
<pre> |
cd installation |
cd installation |
Line 224 for it to function at all. Below is a l
|
Line 243 for it to function at all. Below is a l
|
<dt>LON-CAPA domain</dt> |
<dt>LON-CAPA domain</dt> |
<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 underscores, and no special |
special characters.</i><br>Domain names which include a departmental |
characters except . or -</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 252 for it to function at all. Below is a l
|
<dt>LON-CAPA host id</dt> |
<dt>LON-CAPA host id</dt> |
<dd>Each LON-CAPA server requires a unique internal name. We use names |
<dd>Each LON-CAPA server requires a unique internal name. We use names |
such as "msul1" for the first library server. <i>Restriction: One word, |
such as "msul1" for the first library server. <i>Restriction: One word, |
no hyphens, underscores, or special characters.</i> |
no underscores, and no special characters except -</i> . |
</dd> |
</dd> |
<dt>Domain's Primary Library Server ID</dt> |
<dt>Domain's Primary Library Server ID</dt> |
<dd>If you are setting up a domain with a single library server, then the domain's primary library server ID will be the LON-CAPA host id of that server (e.g., msul1). Once your domain grows and you need to add more servers, one of the library servers in the domain should be assigned as the domain's primary library server. This will be where domain-wide settings will be stored.<dd> |
<dd>If you are setting up a domain with a single library server, then the domain's primary library server ID will be the LON-CAPA host id of that server (e.g., msul1). Once your domain grows and you need to add more servers, one of the library servers in the domain should be assigned as the domain's primary library server. This will be where domain-wide settings will be stored.<dd> |
<dt>Host administrator email</dt> |
<dt>Host administrator email</dt> |
<dd>The amount of email sent to this address is relatively minimal. Messages |
<dd>The amount of email sent to this address is relatively minimal. Messages |
are sent every time the system starts up, or if the system is in |
are sent every time the system starts up, or if the system is in |
serious trouble. On a laptop, make this <tt>root@localhost</tt>. |
serious trouble. If you are installing a LON-CAPA instance on a laptop, |
|
because you are planning to contribute to LON-CAPA development, |
|
make this <span style="font-family: 'Lucida Console','Menlo','Monaco','Courier', monospace;"> |
|
root@localhost</span>. |
</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>Enter an e-mail address here, so 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 |
Line 264 You will need to enter the LON-CAPA conf
|
Line 286 You will need to enter the LON-CAPA conf
|
in the previous section. |
in the previous section. |
</p> |
</p> |
|
|
<h2>6. <a name="cdc">Creating a Domain Coordinator</a></h2> |
<h2>6. <a id="cdc">Creating a Domain Coordinator</a></h2> |
<p> |
<p> |
You will need at least one user at your site who has the role of |
You will need at least one user at your site who has the role of |
'domain coordinator'. This user creates accounts for other users and |
'domain coordinator'. This user creates accounts for other users and |
Line 280 cd /root/loncapa-X.Y.Z/loncom/build
|
Line 302 cd /root/loncapa-X.Y.Z/loncom/build
|
perl make_domain_coordinator.pl USERNAME DOMAIN |
perl make_domain_coordinator.pl USERNAME DOMAIN |
</pre> |
</pre> |
|
|
<h2>7. <a name="sts">Start/Restart Services</a></h2> |
<h2>7. <a id="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. |
will be apparent at this step. |
</p> |
</p> |
<pre> |
<pre> |
/etc/init.d/loncontrol start |
/etc/init.d/loncontrol start |
service httpd start |
systemctl start httpd |
</pre> |
</pre> |
<p> |
<p> |
If you receive warnings about missing perl modules, when starting the httpd service |
If you receive warnings about missing perl modules, when starting the httpd service |
please make sure that the LONCAPA-prerequisites rpm is installed using this command: |
please make sure that the LONCAPA-prerequisites rpm is installed using this command: |
|
</p> |
<pre> |
<pre> |
rpm -q LONCAPA-prerequisites rpm |
rpm -q LONCAPA-prerequisites rpm |
</pre> |
</pre> |
If it is not installed, check that the LON-CAPA Linux repository is a listed repo: |
<p> |
<pre> |
If it is not installed, ensure that the required Linux repositories are enabled (see |
more /etc/yum.repos.d/loncapa.repo |
the "Set up access to package repositories" section above), then install it: |
</pre> |
</p> |
and if so, do: |
|
<pre> |
<pre> |
dnf install LONCAPA-prerequisites |
dnf install LONCAPA-prerequisites |
</pre> |
</pre> |
|
<p> |
If you still have errors, please contact the LON-CAPA Helpdesk: helpdesk at loncapa.org |
If you still have errors, please contact the LON-CAPA Helpdesk: helpdesk at loncapa.org |
</p> |
</p> |
|
<p>Ensure that LON-CAPA network services and the httpd service are set to start on boot: |
|
<pre> |
|
systemctl enable loncontrol |
|
systemctl enable httpd |
|
</pre> |
|
|
<h2>8. <a name="log">Log in to your LON-CAPA Machine</a></h2> |
<h2>8. <a id="log">Log in to your LON-CAPA Machine</a></h2> |
<p> |
<p> |
Point a web browser at your new machine and log in as the domain |
Point a web browser at your new machine and log in as the domain |
coordinator. Congratulations! |
coordinator. Congratulations! |