You will need to check all the following things to ensure proper installation of your LON-CAPA system. Be sure to use the RedHat 7.3 or Fedora specific instructions if they apply, as that will be much easier for you.
Current Release is Version LATESTVERSION. This version was released on LATESTDATE.
You can download the most current version of LON-CAPA at http://install.lon-capa.org/versions/loncapa-current.tar.gz (version LATESTVERSION).
The development release of LON-CAPA is at: http://install.lon-capa.org/versions/loncapa-unstable.tar.gz.
To view the code development history of LON-CAPA, you will need to use the CVS tool, the open standard for version control. Please contact the MSU LON-CAPA group (helpdesk@lon-capa.org) to request a CVS USERNAME.
The initial CVS commands would be:
export CVSROOT=:ext:USERNAME@source.lon-capa.org:/home/cvs cvs login cvs co loncapa
For more information on using CVS, please visit http://www.cvshome.org/ or read loncom/build/readme.html after downloading the current version of LON-CAPA as described above.
Execute the following command to create a user named 'www' on your LON-CAPA server:
/usr/sbin/useradd www |
Step # | Description |
---|---|
1 |
Is your system using shadow passwords? (Note: LON-CAPA will work with either MD5/non-MD5 configured systems). It is strongly recommended to use shadow passwords. If your system is currently not using shadow passwords, run the "pwconv" command (as root) in order to convert to shadow passwords. If you choose not to use shadow passwords, then do not perform any of the additional steps. If your system is using shadow passwords, then you will need to perform the additional steps below.
How to detect:
If there is output such as "root:x:0:0:root:/root:/bin/bash", then your system is using shadow passwords and you will need to continue with the steps below. |
2 |
Retrieve the mod_auth_external source by running the following command wget http://www.unixpapa.com/software/mod_auth_external-2.1.15.tar.gz |
3 |
Unpack the mod_auth_external source by running the following command tar xzvf mod_auth_external-2.1.15.tar.gz |
4 |
Go to the pwauth directory by running the following command cd mod_auth_external-2.1.15/pwauth/ |
5 |
Edit config.h and change SERVER_UIDS definition
Determine the user id of 'www':
|
6 |
Compile the pwauth executable by running the following command make |
7 |
Install pwauth by doing the following
cp pwauth /usr/local/sbin/
Edit (creating the file) /etc/pam.d/pwauth to have the contents: auth required /lib/security/pam_pwdb.so shadow nullok auth required /lib/security/pam_nologin.so account required /lib/security/pam_pwdb.so |
Download the most current loncapa-current.tar.gz.
wget http://install.lon-capa.org/versions/loncapa-current.tar.gz
tar xzvf loncapa-current.tar.gz cd loncapa-N.N (N.N is the version number) |
The UPDATE command will refresh your filesystem with all the latest LON-CAPA software.
./UPDATE |
Lon-CAPA uses a large numbe of perl modules that need to be installed. Some of these may be available on your machine already, some can be gotten from packages in your Linux Distribution. Some will probably need to come from CPAN
You can check which modules you have and which ones you need by running the TEST script. It will generate a CPAN_STATUS_REPORT. You can install an missing perl modules by doing:
perl -MCPAN -e 'install MODULENAME' |
More documentation on how CPAN works is available here
The CHECKRPMS command will check the RPMs on your machine against an FTP repository, if you're using a RedHat server.
./CHECKRPMS |
If you are not installing on RedHat, you may need to manually install some software. The following pointers may be useful:
A common RedHat glitch of new installations (RedHat's fault, not LON-CAPA) is the generation of /etc/hosts.
It should look something like this (except the myschool line should be replaced with settings specific to your machine):
127.0.0.1 localhost.localdomain localhost 12.34.56.78 www.myschool.edu myschool |
The following commands describe how to configure the MySQL database
on your LON-CAPA server.
Note:
The following instructions assume you are logged in as 'root'.
Entering the mysql shell
mysql -u root -p mysql OR mysql -u root mysql (depending on whether you have set a root password) |
Creating the mysql 'www' user (after entering mysql shell)
mysql> CREATE DATABASE loncapa; mysql> INSERT INTO user (Host, User, Password) mysql> VALUES ('localhost','www',password('localhostkey')); mysql> INSERT INTO db VALUES ('localhost','loncapa','www', mysql> 'Y','Y','Y','Y','Y','Y','N','Y','Y','Y'); mysql> FLUSH PRIVILEGES; |
SECURITY: set a password for the mysql 'root' user
shell> mysql -u root mysql mysql> SET PASSWORD FOR root@localhost=PASSWORD('ROOTPASSWORD'); |
SECURITY: only allow access from localhost
shell> mysql -u root -p mysql mysql> DELETE FROM user WHERE host<>'localhost'; |
The TEST command will check the installation software, the perl libraries on your system, the MySQL database, and will also automatically test the real-time operation of the LON-CAPA Apache web server.
./TEST |
Using the TEST command will likely be an iterative process. It is normal to expect that the TEST command will recommend you perform various steps to ensure optimal performance of your LON-CAPA server.