|
version 1.1, 2008/12/10 19:13:41
|
version 1.8, 2011/11/26 20:54:07
|
|
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> |
<pre>reboot</pre> |
| |
|
| |
<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 119 yum update
|
Line 125 yum update
|
| Reboot your system before continuing with the installation. |
Reboot your system before continuing with the installation. |
| </p> |
</p> |
| <p> |
<p> |
| Retrieve the rhel5_loncapa_yum file from the LON-CAPA install site: |
Retrieve the centos5_loncapa_yum file from the LON-CAPA install site: |
| </p> |
</p> |
| <pre> |
<pre> |
| wget http://install.loncapa.org/versions/centos/5/centos5_loncapa_yum.conf |
wget http://install.loncapa.org/versions/centos/5/centos5_loncapa_yum.conf |
|
Line 127 wget http://install.loncapa.org/versions
|
Line 133 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> |
| 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/centos/5/centos5_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: |
| </p> |
</p> |
| <pre> |
<pre> |
| tar xf centos5_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 <tt>installation</tt>. Change to it and |
|
Line 164 cd installation
|
Line 172 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: |
| 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> |
</p> |
| |
|
| <h3>Determine LON-CAPA Settings</h3> |
<h3>Determine LON-CAPA Settings</h3> |
|
Line 197 for it to function at all. Below is a l
|
Line 211 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 242 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> |
| 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 |
| 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>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 279 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 |
![[BACK]](/icons/back.gif){kind=icon}
Return to centos5_install.frag CVS log ![[TXT]](/icons/text.gif){kind=icon}
![[DIR]](/icons/dir.gif){kind=icon}
Up to [LON-CAPA] / doc / build