version 1.1, 2008/12/10 19:13:41
|
version 1.5, 2010/12/09 14:11:31
|
Line 23 perl, and MySQL are not required to inst
|
Line 23 perl, and MySQL are not required to inst
|
The installation process takes the following steps: |
The installation process takes the following steps: |
</p> |
</p> |
<ol> |
<ol> |
<li> Obtain CentOS Linux 5 installation CDs</li> |
<li><a href="#obt">Obtain CentOS Linux 5 installation CDs</a></li> |
<li> Determine Network Settings</li> |
<li><a href="#net">Determine Network Settings</a></li> |
<li> Install CentOS Linux 5 </li> |
<li><a href="#lin">Install CentOS Linux 5</a></li> |
<li> Update your system </li> |
<li><a href="#upd">Update your system</a></li> |
<li> Install LON-CAPA </li> |
<li><a href="#ilc">Install LON-CAPA</a></li> |
<li> Create a Domain Coordinator </li> |
<li><a href="#cdc">Create a Domain Coordinator</a></li> |
<li> Start/Restart services </li> |
<li><a href="#sts">Start/Restart services</a></li> |
<li> Log in to LON-CAPA </li> |
<li><a href="#log">Log in to LON-CAPA</a></li> |
</ol> |
</ol> |
|
|
<h2>Obtain CentOS Linux 5 CDs</h2> |
<hr> |
|
<h2>1. <a name="obt">Obtain CentOS Linux 5 CDs</a></h2> |
<p> |
<p> |
CentOS isos can be obtained from links included on the <a href="http://mirror.centos.org/centos/5/isos/">CentOS download page</a><br /> |
CentOS isos can be obtained from links included on the <a href="http://mirror.centos.org/centos/5/isos/">CentOS download page</a><br> |
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>Determine Network Settings</h2> |
<h2>2. <a name="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. |
|
|
Line 55 DHCP is <em>not</em> supported.
|
Line 56 DHCP is <em>not</em> supported.
|
<li>domain name server(s) </li> |
<li>domain name server(s) </li> |
</ul> |
</ul> |
|
|
<h2>Minimal CentOS Linux 5 Install</h2> |
<h2>3. <a name="lin">Minimal CentOS Linux 5 Install</a></h2> |
<p> |
<p> |
Installing CentOS Linux is quite easy, particularly if you've installed any of the Red Hat, Fedora or CentOS Linux distributions before. |
Installing CentOS Linux is quite easy, particularly if you've installed any of the Red Hat, Fedora or CentOS Linux distributions before. |
Documentation is available from |
Documentation is available from |
<a href="http://wiki.centos.org/">http://wiki.centos.org/</a> |
<a href="http://wiki.centos.org/">http://wiki.centos.org/</a> |
Most of the installation screens are self explanatory. |
Most of the installation screens are self explanatory. |
There are a few steps that require comment and are dealt with below. |
There are a few steps that require comment and are dealt with below. |
</p> |
</p> |
<dl style="list-style:square outside none"> |
<dl style="list-style:square outside none"> |
Line 87 There are a few steps that require comme
|
Line 88 There are a few steps that require comme
|
<dt>Software</dt> |
<dt>Software</dt> |
<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> |
|
|
|
Finish installing your server, reboot it, and log in as root. The |
<p> |
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 |
Finish installing your server, reboot it, and log in as root. |
<pre> |
</p> |
setup |
|
</pre> |
|
This should tool be used to configure the Firewall and SELinux. |
|
|
|
<dt>Firewall Configuration</dt> |
<h3>Firewall and SELinux Configuration</h3> |
|
<p> |
|
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 |
|
</p> |
|
<pre>setup</pre> |
|
<p> |
|
This tool should be used to configure the Firewall and SELinux. |
|
</p> |
|
|
<dd>Select Security Level: Enabled, and Customize, to allow |
<ol> |
|
<li>Select Security Level: Enabled, and Customize, to allow |
incoming: SSH (remote login), WWW (HTTP) and secure WWW |
incoming: SSH (remote login), WWW (HTTP) and secure WWW |
(HTTPS). (LON-CAPA also will use ports 5663 and 8080, but the |
(HTTPS). |
loncontrol startup script should open and close thos ports |
</li> |
itself.) |
<li> Set SELinux to Disabled.</li> |
</dd> |
<li> Select OK, and then Quit</li> |
<dd> Set SELinux to Disabled.</dd> |
</ol> |
<dd> Select OK, and then Quit</dd> |
|
</p> |
|
|
|
<h2>Update your system</h2> |
<h2>4. <a name="upd">Update your system</a></h2> |
<p> |
<p> |
Update your system to the latest versions of the system software using yum. |
Update your system to the latest versions of the system software using yum. |
</p> |
</p> |
Line 127 wget http://install.loncapa.org/versions
|
Line 132 wget http://install.loncapa.org/versions
|
<p> |
<p> |
Install the centos5_loncapa_yum.conf |
Install the centos5_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 centos5_loncapa_yum.conf /etc/yum.conf |
cp centos5_loncapa_yum.conf /etc/yum.conf |
yum update |
yum update |
</pre> |
</pre> |
</p> |
|
<h2>Installing LON-CAPA</h2> |
|
|
<h2>5. <a name="ilc">Installing LON-CAPA</a></h2> |
|
<h3>Import the LON-CAPA encryption key</h3> |
|
<pre>rpm --import http://install.loncapa.org/versions/centos/RPM-GPG-KEY-loncapa</pre> |
<h3>Install prerequisites</h3> |
<h3>Install prerequisites</h3> |
<p> Execute: </p> |
<p> Execute: </p> |
<pre> |
<pre> |
Line 164 cd installation
|
Line 171 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 /> |
This script will prompt you for the MySQL root password and will download the latest LON-CAPA release.<br> |
You can safely ignore the following warnings from gcc 4 when compiling pwauth:<br /> |
You can safely ignore the following warnings from gcc 4 when compiling pwauth:<br> |
<tt> |
</p> |
|
<div style="font-family:monospace;"> |
pwauth.c: In function ‘lastlog’: |
pwauth.c: In function ‘lastlog’: |
<ul> |
<ul> |
<li>pwauth.c:541: warning: incompatible implicit declaration of built-in function ‘strncpy’</li> |
<li>pwauth.c:541: warning: incompatible implicit declaration of built-in function ‘strncpy’</li> |
Line 176 pwauth.c: In function ‘main’:
|
Line 184 pwauth.c: In function ‘main’:
|
<ul> |
<ul> |
<li>pwauth.c:692: warning: incompatible implicit declaration of built-in function ‘strlen’</li> |
<li>pwauth.c:692: warning: incompatible implicit declaration of built-in function ‘strlen’</li> |
</ul> |
</ul> |
</tt> |
</div> |
|
|
</p> |
|
|
|
<h3>Determine LON-CAPA Settings</h3> |
<h3>Determine LON-CAPA Settings</h3> |
<p> |
<p> |
Line 197 for it to function at all. Below is a l
|
Line 204 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 233 cd /root/loncapa-N.N (N.N should cor
|
Line 240 cd /root/loncapa-N.N (N.N should cor
|
</pre> |
</pre> |
<p> |
<p> |
You will need to enter the LON-CAPA configuration information you determined |
You will need to enter the LON-CAPA configuration information you determined |
in the previous section. |
in the previous section. |
</p> |
</p> |
|
|
<h2>Creating a Domain Coordinator</h2> |
<h2>6. <a name="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 252 perl make_domain_coordinator.pl USERNAME
|
Line 259 perl make_domain_coordinator.pl USERNAME
|
(WILL PROMPT FOR PASSWORD HERE) |
(WILL PROMPT FOR PASSWORD HERE) |
</pre> |
</pre> |
|
|
<h2>Start/Restart Services</h2> |
<h2>7. <a name="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. |
Line 267 please make sure you followed the instru
|
Line 274 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>Log in to your LON-CAPA Machine</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> |
<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 |