version 1.6, 2010/05/26 23:42:50
|
version 1.9, 2013/12/16 13:53:28
|
Line 32 The installation process takes the follo
|
Line 32 The installation process takes the follo
|
<li><a href="#sts">Start/Restart services</a></li> |
<li><a href="#sts">Start/Restart services</a></li> |
<li><a href="#log">Log in to LON-CAPA</a></li> |
<li><a href="#log">Log in to LON-CAPA</a></li> |
</ol> |
</ol> |
<hr /> |
|
|
<hr> |
<h2>1. <a name="obt">Obtain Red Hat Enterprise Linux 5 CDs</a></h2> |
<h2>1. <a name="obt">Obtain Red Hat Enterprise Linux 5 CDs</a></h2> |
<p> |
<p> |
RHEL5 CDs can be purchased from Red Hat: |
RHEL5 CDs can be purchased from Red Hat: |
<a href="http://redhat.com/">http://redhat.com/</a>. |
<a href="http://redhat.com/">http://redhat.com/</a>. |
For the minimal install on 32-bit architecture you will need only the first CD. |
For the minimal install on 32-bit architecture you will need only the first CD. |
For the minimal install on 64-bit architecture you will need CDs 1, 2, and 4. |
For the minimal install on 64-bit architecture you will need CDs 1, 2, and 4. |
|
|
</p> |
</p> |
|
|
<h2>2. <a name="net">Determine Network Settings</a></h2> |
<h2>2. <a name="net">Determine Network Settings</a></h2> |
Line 90 There are a few steps that require comme
|
Line 90 There are a few steps that require comme
|
<dd>Click the "Customize Now" radio button and for a minimal install uncheck all packages except "Base" in the Base System category. If you leave other packages checked in any of the other categories, you'll need additional ISO CDs.</dd> |
<dd>Click the "Customize Now" radio button and for a minimal install uncheck all packages except "Base" in the Base System category. If you leave other packages checked in any of the other categories, you'll need additional ISO CDs.</dd> |
</dl> |
</dl> |
<p> |
<p> |
|
|
Finish installing your server, reboot it, and log in as root. The |
Finish installing your server, reboot it, and log in as root. The |
first time you log-in, the Setup Agent will be displayed. (If you exit it early you can enter it again buy running the command |
first time you log-in, the Setup Agent will be displayed. (If you exit it early you can enter it again buy running the command |
|
</p> |
<pre> |
<pre> |
setup |
setup |
</pre> |
</pre> |
This should tool be used to configure the Firewall and SELinux. |
<h3>Firewall and SELinux Configuration</h3> |
|
<p> |
<dt>Firewall Configuration</dt> |
This tool should be used to configure the Firewall and SELinux. |
|
|
<dd>Select Security Level: Enabled, and Customize, to allow |
|
incoming: SSH (remote login), WWW (HTTP) and secure WWW |
|
(HTTPS). |
|
</dd> |
|
<dd> Set SELinux to Disabled.</dd> |
|
<dd> Select OK, and then Quit</dd> |
|
</p> |
</p> |
|
<ol> |
|
<li>Select Security Level: Enabled, and Customize, to allow |
|
incoming: SSH (remote login), WWW (HTTP) and secure WWW |
|
(HTTPS). |
|
</li> |
|
<li>Set SELinux to Disabled.</li> |
|
<li>Select OK, and then Quit</li> |
|
</ol> |
|
|
<h2>4. <a name="upd">Update your system</a></h2> |
<h2>4. <a name="upd">Update your system</a></h2> |
<p> |
<p> |
Line 127 wget http://install.loncapa.org/versions
|
Line 128 wget http://install.loncapa.org/versions
|
<p> |
<p> |
Install the rhel5_loncapa_yum.conf |
Install the rhel5_loncapa_yum.conf |
</p> |
</p> |
<p> |
|
<pre> |
<pre> |
mv /etc/yum.conf /etc/yum.conf.backup |
mv /etc/yum.conf /etc/yum.conf.backup |
cp rhel5_loncapa_yum.conf /etc/yum.conf |
cp rhel5_loncapa_yum.conf /etc/yum.conf |
yum update |
yum update |
</pre> |
</pre> |
</p> |
|
<h2>5. <a name="ilc">Installing LON-CAPA</a></h2> |
<h2>5. <a name="ilc">Installing LON-CAPA</a></h2> |
<h3>Install prerequisites</h3> |
<h3>Install prerequisites</h3> |
<p> Execute: </p> |
<p> Execute: </p> |
<pre> |
<pre> |
yum install LONCAPA-prerequisites |
yum install LONCAPA-prerequisites |
</pre><p> |
</pre><p> |
This may take a moment due to LON-CAPA's large number of dependencies. |
This may take some minutes due to LON-CAPA's large number of dependencies. |
</p> |
</p> |
<h3>Retrieve and execute LON-CAPA setup program</h3> |
<h3>Retrieve and execute LON-CAPA setup program</h3> |
<p> |
<p> |
Retrieve the LON-CAPA setup with the following command: |
Retrieve the LON-CAPA setup with the following command: |
</p> |
</p> |
<pre> |
<pre> |
wget http://install.loncapa.org/versions/redhat/5Server/rhel5_install.tar |
wget http://install.loncapa.org/linux/install.tar |
</pre> |
</pre> |
<p> |
<p> |
Extract the archive with the following command: |
Extract the archive with the following command: |
Line 164 cd installation
|
Line 164 cd installation
|
./install.pl |
./install.pl |
</pre> |
</pre> |
<p> |
<p> |
This script will prompt you for the MySQL root password and will download the latest LON-CAPA release.<br /> |
The script is used to prepare a Linux system to run LON-CAPA, and can also be |
You can safely ignore the following warnings from gcc 4 when compiling pwauth:<br /> |
used to check the configuration of a system on which LON-CAPA has already been installed. Typically, though, you will run this script only once, when you first install LON-CAPA. |
<tt> |
</p> |
pwauth.c: In function ‘lastlog’: |
<p> |
<ul> |
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. |
<li>pwauth.c:541: warning: incompatible implicit declaration of built-in function ‘strncpy’</li> |
Once a choice has been entered for all nine possible actions, required changes will be made. |
<li>pwauth.c:543: warning: incompatible implicit declaration of built-in function ‘strlen’</li> |
</p> |
</ul> |
<p>The possible actions are:</p> |
pwauth.c: In function ‘main’: |
|
<ul> |
<ul> |
<li>pwauth.c:692: warning: incompatible implicit declaration of built-in function ‘strlen’</li> |
<li>Create the www user/group</li> |
|
<li>Install the package LON-CAPA uses to authenticate users.</li> |
|
<li>Set-up the MySQL database</li> |
|
<li>Set-up MySQL permissions</li> |
|
<li>Configure Apache web server</li> |
|
<li>Configure start-up of services</li> |
|
<li>Check firewall settings</li> |
|
<li>Stop services not used by LON-CAPA,<br> |
|
e.g., services for a print server: cups daemon</li> |
|
<li>Download LON-CAPA source code in readiness for installation</li> |
</ul> |
</ul> |
</tt> |
|
|
|
</p> |
|
|
|
<h3>Determine LON-CAPA Settings</h3> |
<h3>Determine LON-CAPA Settings</h3> |
<p> |
<p> |
LON-CAPA requires a number of identifying parameters to be set in order |
LON-CAPA requires a number of identifying parameters to be set in order |
Line 197 for it to function at all. Below is a l
|
Line 201 for it to function at all. Below is a l
|
<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 hyphens, underscores, or |
special characters.</i><br />Domain names which include a departmental |
special characters.</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 228 for it to function at all. Below is a l
|
Line 232 for it to function at all. Below is a l
|
To configure and install LON-CAPA, execute the following commands: |
To configure and install LON-CAPA, execute the following commands: |
</p> |
</p> |
<pre> |
<pre> |
cd /root/loncapa-N.N (N.N should correspond to a version number like '1.3') |
cd /root/loncapa-X.Y.Z (X.Y.Z should correspond to a version number like '2.10.0') |
./UPDATE |
./UPDATE |
</pre> |
</pre> |
<p> |
<p> |
Line 241 in the previous section.
|
Line 245 in the previous section.
|
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 |
grants them additional privileges. The make_domain_coordinator.pl script |
grants them additional privileges. The make_domain_coordinator.pl script |
invoked below requires that you enter the users password. The password will |
invoked below requires that you enter the user's password. |
show in plaintext as you type it. Feel free to use the "passwd username" |
Feel free to use the "passwd username" command to change it later. |
command to change it later. Replace USERNAME and DOMAIN with an |
Replace USERNAME and DOMAIN with an appropriate user name and your domain. |
appropriate user name and your domain. |
|
</p> |
</p> |
<pre> |
<pre> |
cd /root/loncapa-N.N/loncom/build |
cd /root/loncapa-X.Y.Z/loncom/build |
perl make_domain_coordinator.pl USERNAME DOMAIN |
perl make_domain_coordinator.pl USERNAME DOMAIN |
(WILL PROMPT FOR PASSWORD HERE) |
|
</pre> |
</pre> |
|
|
<h2>7. <a name="sts">Start/Restart Services</a></h2> |
<h2>7. <a name="sts">Start/Restart Services</a></h2> |
Line 267 please make sure you followed the instru
|
Line 269 please make sure you followed the instru
|
<b>Installing LON-CAPA Dependencies</b>. If you still have errors, please |
<b>Installing LON-CAPA Dependencies</b>. If you still have errors, please |
contact the MSU LON-CAPA group. |
contact the MSU LON-CAPA group. |
</p> |
</p> |
|
|
<h2>8. <a name="log">Log in to your LON-CAPA Machine</a></h2> |
<h2>8. <a name="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! |
</p> |
</p> |
|
|
<hr /> |
<hr> |
<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 |