doc/build/centos8_install.frag - diff

Return to centos8_install.frag CVS log

Up to [LON-CAPA] / doc / build

Diff for /doc/build/centos8_install.frag between versions 1.1 and 1.2

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!

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>

Removed from v.1.1
changed lines
	Added in v.1.2