View source for Guide d'installation de WeBWork 2.5 sur CentOS 5


{{Historical}}

{{Deprecated|2.6.  For up-to-date information view [[Github]]}}


''See also:'' [[History of WeBWorK version control]]


=Préambule=
Une administratrice veut installer WeBWorK pour la toute première fois. 
Les étapes décrites sont décrites par quelqu'un qui n'avait pas d'expérience avec WeBWorK.
Si c'était à refaire, peut-être que certaines parties seraient effectuées autrement - mais bon, le résultat est fonctionnel.
On prend pour acquis une certaine connaissance de l'administration de sites web avec apache 
et d'administration de Linux.

=Installer WebWorK sur un serveur Linux/CentOS 5=
==Prérequis==
* Réf : [http://webwork.maa.org/wiki/Installation_Manual_for_2.3_on_CentOS_5 http://webwork.maa.org/wiki/Installation_Manual_for_2.3_on_CentOS_5]
* [http://webwork.maa.org/wiki/Installation_Manual_for_2.4#Configuring_WeBWorK http://webwork.maa.org/wiki/Installation_Manual_for_2.4#Configuring_WeBWorK]
===Les prérequis faciles!===
 yum install libapreq2
 yum install perl-libapreq2
 yum install perl-TimeDate
 yum install perl-Email-Address
 yum install perl-GD
 yum install perl-LDAP
 yum install perl-Mail-Sender
 yum install perl-String-ShellQuote
 yum install perl-XML-Parser
 yum install perl-XML-Writer
 yum install tetex
 yum install tetex-latex
 yum install tetex-preview
 yum install uuid-perl
 yum install ghostscript
 
 yum install perl-DateTime
 yum install perl-Exception-Class
 yum install perl-SOAP-Lite
 yum install perl-SQL-Abstract
 yum install perl-PHP-Serialization
 
 yum install netpbm-progs
 yum install preview-latex-common
 
 yum install perl-Apache2-SOAP
 
 yum install perl-Locale-Maketext-Simple

===Rpm téléchargés chez Nogin===
 cd /var/src/webwork/rpm_complementaires
 wget http://rpmbin.nogin.org/WebWork/RHEL-5/tth-3.85-1.el5.an.x86_64.rpm
 wget http://rpmbin.nogin.org/WebWork/RHEL-5/tth-3.85-1.el5.i386.rpm
 wget http://rpmbin.nogin.org/WebWork/RHEL-5/perl-Iterator-0.03-1.el5.noarch.rpm
 wget http://rpmbin.nogin.org/WebWork/RHEL-5/perl-Iterator-Util-0.02-1.el5.noarch.rpm
 ### wget http://rpmbin.nogin.org/WebWork/RHEL-5/perl-PHP-Serialization-0.33-1.el5.noarch.rpm  ## Non. Finalement, on l'installe par yum.
 rpm -ivh *.rpm

===Le reste, avec cpan===
 unset LANG 
 perl -MCPAN -e shell
 '''cpan>''' install XML::Parser::EasyTree
 '''cpan>''' install Pod::WSDL 
 '''cpan>''' install Tie::IxHash
 '''cpan>''' install PadWalker
 '''cpan>''' install UUID::Tiny
 '''cpan>''' quit

===Vérifier les prérequis===
 cd /opt/webwork/
 perl webwork2/bin/check_modules.pl apache2

==Installer WebWork==
* svn. Les sources sont dans /var/src/webwork. 
===Récupérer les sources===
 mkdir -p /var/src/webwork/downloads/
 cd /var/src/webwork/downloads/
 svn co http://svn.webwork.maa.org/system/trunk/webwork2 webwork2
 svn co http://svn.webwork.maa.org/system/trunk/pg pg
 svn co http://svn.webwork.maa.org/npl/trunk/NationalProblemLibrary librairies/NationalProblemLibrary
 svn co http://mathjax.svn.sourceforge.net/svnroot/mathjax/trunk/mathjax mathjax

===Installer dans le bon répertoire===
 mkdir /opt/webwork
 cd /var/src/webwork/downloads/
 cp -rp webwork2/ /opt/webwork/
 cp -rp pg /opt/webwork/
 cp -rp librairies /opt/webwork/
 cp -pr mathjax /opt/webwork/webwork2/htdocs/
 mkdir -p /opt/webwork/courses

===Assigner les bonnes propriétés et permissions===
 cd opt/webwork/webwork2
 chown -R root:root .
 chmod -R u=rwX,go=rX .
 chgrp -R apache DATA ../courses htdocs/tmp logs tmp
 chmod -R g+w DATA ../courses htdocs/tmp logs tmp
 find DATA/ ../courses/ htdocs/tmp/ logs/ tmp/ -type d -a ! -name CVS -exec chmod g+s {} \;
===Modifier l'environnement===
 touch /etc/profile.d/webwork.sh
Son contenu : 
 PATH=$PATH:/opt/webwork/webwork2/bin
 WEBWORK_ROOT=/opt/webwork/webwork2
 PG_ROOT=/opt/webwork/pg
 export PATH WEBWORK_ROOT PG_ROOT

===Créer des liens symboliques===
 cd /opt/webwork/libraries/NationalProblemLibrary
 ln -s /opt/webwork/libraries/NationalProblemLibrary /opt/webwork/libraries/ProblemLibrary
 ln -s /opt/webwork/libraries/NationalProblemLibrary /opt/webwork/libraries/database_problems


==Configurer==
 cd /opt/webwork/webwork2/conf
 cp -p global.conf.dist global.conf
 cp -p database.conf.dist database.conf

Je suis en train de configurer le fichier '''/opt/webwork/webwork2/conf/global.conf'''. À la section Databases. Voici les différence entre global.conf et celui de la distribution : 

 $server_root_url   = "http://webwork.mon.univ.edu";  # e.g.  http://webwork.yourschool.edu
 $server_userID     = "apache";  # e.g.  www-data    
 $server_groupID    = "apache";  # e.g.  wwdata
 $mail{smtpServer}            = 'mail.mon.univ.edu';
 $mail{smtpSender}            = 'admin-webwork@mon.univ.edu';
 $database_password = "***********";
 '''#'''$dbLayoutName = "sql_moodle";
 $problemLibrary{root}        = "/opt/webwork/libraries/NationalProblemLibrary";
 $siteDefaults{timezone} = "America/Montreal";

===Identifier les locales de temps perl disponibles===
 perl -MDateTime::TimeZone -e 'print join "\n", DateTime::TimeZone::all_names'

==Base de données==
===Créer la base de données pour webwork===
 mysql -u root -p mysql
 '''mysql>''' create database webwork
 '''mysql>''' GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, DROP, LOCK TABLES ON webwork.* TO webworkWrite@localhost IDENTIFIED BY '**********';
===l'initialiser===
(Attention! Je ne suis plus certaine si c'est vraiment ça que j'ai roulé, car j'ai fait quelques essais-erreurs. SL)
 /opt/webwork/webwork2/bin/wwdb_upgrade
Ouais. C'est peut-être aussi bien ceci :
 
 /opt/webwork/webwork2/bin/old_scripts/wwdb_upgrade

==Serveur web==
===Fichier /opt/webwork/webwork2/conf/webwork.apache2-config=== 
Voici la différences avec le fichier /webwork.apache2-config.dist.

      ''' #'''Options => "FollowSymLinks",
       '''#'''Options => "FollowSymLinks",
  '''#''' Include /opt/webwork/wwqs/conf/problemserver.apache-config
===Fichier /etc/httpd/sites.d/webwork.conf===

 <Directory /opt/webwork>
 AllowOverride None
     Options MultiViews SymLinksIfOwnerMatch IncludesNoExec
         <Limit GET POST OPTIONS PROPFIND>
         Order allow,deny
         Allow from all
     </Limit>
     <LimitExcept GET POST OPTIONS PROPFIND>
         Order deny,allow
         Deny from all
     </LimitExcept>
 </Directory>
 
 <VirtualHost webwork.mon.univ.edu:80>
     DocumentRoot "/opt/webwork"
     ServerName webwork.mon.univ.edu
     ServerAdmin admin-webwork@mon-univ.edu
     ErrorLog logs/webwork_80-error_log
     CustomLog logs/webwork_80-access_log combined
 </VirtualHost>
 
 Include /opt/webwork/webwork2/conf/webwork.apache2-config

===Redémarrer et voilà!===
 service httpd restart
L'URL d'accueil de WeBWorK est alors : http://webwork.mon.univ.edu/webwork2

=Problème : absence du fichier preview.sty=
Latex se plaint de l'absence du fichier preview.sty. 
==Comment le problème s'est présenté==
Je ne m'en rappelle plus.
==Comment on l'a identifié==
En modifiant temporairement le fichier '''/opt/webwork/pg/lib/WeBWorK/PG/ImageGenerator.pm''' pour que les erreurs latex se retrouvent dans les fichiers /var/tmp/latex.err et /var/tmp/latex.out. On l'avait (le fichier ImageGenerator.pm) modifié ainsi : 
 my $latexCommand  = "cd $wd && $latex equation > '''/var/tmp/'''latex.out 2> '''/var/tmp/'''latex.err";
Puis, dans le fichier /var/tmp/latex.out, on voyait clairement que ''preview.sty not found''.

==Comment on l'a corrigé==
 yum provides */preview.sty
 yum install xemacs-packages-extra-20090217
 cp -p ls /usr/share/xemacs/xemacs-packages/etc/auctex/latex/'''preview.sty''' /usr/share/texmf/tex/latex/amsmath/
 texhash