--- doc/build/centos8_install.frag 2019/10/03 15:12:52 1.1 +++ doc/build/centos8_install.frag 2019/10/07 15:34:19 1.3 @@ -34,17 +34,17 @@ The installation process takes the follo
-

1. Obtain CentOS Linux 8

+

1. Obtain CentOS Linux 8

CentOS 8 isos can be obtained from links included on the CentOS download page. Either download the Boot ISO or the CentOS 8 DVD1 ISO.

-

2. Determine Network Settings

+

2. Determine Network Settings

You will need to know the following network settings for your installation. -Note:You must have a static IP address to use LON-CAPA. +Note: You must have a static IP address to use LON-CAPA. DHCP is not supported.

-

3. Minimal CentOS Linux 8 Install

+

3. Minimal CentOS Linux 8 Install

Documentation is available from @@ -100,7 +100,7 @@ sudo firewall-cmd --zone=public --perman sudo firewall-cmd --reload -

4. Update your system

+

4. Update your system

Update your system to the latest versions of the system software using dnf.

@@ -134,6 +134,31 @@ mv centos8_PowerTools_yum.conf /etc/yum. +

+Install the loncapa.repo file from the LON-CAPA install site: +

+
+wget -O /etc/yum.repos.d/loncapa.repo http://install.loncapa.org/versions/centos/8/loncapa.repo
+
+

+Verify the required repositories are enabled: +

+
+dnf repolist enabled
+
+

+The list of enabled repos should be as follows: +

+ + + + + + + + + +
repo idrepo name
AppStreamCentOS-8 - AppStream
BaseOSCentOS-8 - Base
PowerToolsCentOS-8 - PowerTools
*epelExtra Packages for Enterprise Linux 8 - x86_64
extrasCentOS-8 - Extras
loncapa-updates-basearchCentOS 8 LON-CAPA x86_64 Updates
loncapa-updates-noarchCentOS 8 LON-CAPA noarch Updates

Install and enable a Mail Transfer Agent (MTA), e.g., postfix

@@ -159,7 +184,7 @@ mv loncapa_selinux_config /etc/selinux/c
 reboot
 
-

5. Installing LON-CAPA

+

5. Installing LON-CAPA

Install prerequisites

Execute:

@@ -181,8 +206,8 @@ Extract the archive with the following c
 tar xf install.tar
 

-This creates a directory named installation. Change to it and -execute the setup script with the following commands: +This creates a directory named installation. +Change to it and execute the setup script with the following commands:

 cd installation
@@ -224,8 +249,8 @@ for it to function at all.  Below is a l
   
LON-CAPA domain
Each site or school which installs LON-CAPA needs its own domain. Here at MSU we use 'msu'. You should choose something short but - meaningful. Restriction: One word, no hyphens, underscores, or - special characters.
Domain names which include a departmental + meaningful. Restriction: One word, no underscores, and no special + characters except . or - .
Domain names which include a departmental abbreviation are not recommended as although LON-CAPA may start in a single department, other departments frequently join subsequently. For a domain name: 'msu' is a superior choice to 'msuphys' for example. @@ -233,17 +258,20 @@ for it to function at all. Below is a l
LON-CAPA host id
Each LON-CAPA server requires a unique internal name. We use names such as "msul1" for the first library server. Restriction: One word, - no hyphens, underscores, or special characters. + no underscores, and no special characters except - .
Domain's Primary Library Server ID
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.
Host administrator email
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 - serious trouble. On a laptop, make this root@localhost. + 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 + root@localhost.
Support email address
-
If you enter an e-mail address here, then users of the system +
Enter an e-mail address here, so 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 @@ -264,7 +292,7 @@ You will need to enter the LON-CAPA conf in the previous section.

-

6. Creating a Domain Coordinator

+

6. Creating a Domain Coordinator

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 @@ -280,33 +308,39 @@ cd /root/loncapa-X.Y.Z/loncom/build perl make_domain_coordinator.pl USERNAME DOMAIN

-

7. Start/Restart Services

+

7. Start/Restart Services

The LON-CAPA network services take a moment to start. Most misconfigurations will be apparent at this step.

 /etc/init.d/loncontrol start
-service httpd start
+systemctl start httpd
 

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: +

 rpm -q LONCAPA-prerequisites rpm
 
-If it is not installed, check that the LON-CAPA Linux repository is a listed repo: -
-more /etc/yum.repos.d/loncapa.repo
-
-and if so, do: +

+If it is not installed, ensure that the required Linux repositories are enabled (see +the "Set up access to package repositories" section above), then install it: +

 dnf install LONCAPA-prerequisites
 
+

If you still have errors, please contact the LON-CAPA Helpdesk: helpdesk at loncapa.org

+

Ensure that LON-CAPA network services and the httpd service are set to start on boot: +

+systemctl enable loncontrol
+systemctl enable httpd
+
-

8. Log in to your LON-CAPA Machine

+

8. Log in to your LON-CAPA Machine

Point a web browser at your new machine and log in as the domain coordinator. Congratulations!