Difference between revisions of "Installing on RedHat Enterprise 4"

From EPrints Documentation
Jump to: navigation, search
m (Removing spam.)
m (Removing spam.)
Line 1: Line 1:
[http://saibso.org/tv-hqpsr.htm tv hqp421sr] [http://psisemiya.com/images/small/key-for/ key for yankse] [http://kinunia.cn/coito.htm coito] [http://saibso.org/toshiba-satellite.htm toshiba satellite l10-125] [http://nobinters.org/feme-like.htm feme like u] [http://chaba.info/il-calendario/ il calendario di giorgia palmas 2005] [http://davte.info/library/html/estefan-hoy.htm estefan hoy] [http://amohseni.info/img/styles/www-lanebryantcatalog/ www lanebryantcatalog com] [http://amohseni.info/img/styles/niht/ niht] [http://nobinters.org/notebook.htm notebook 13] [http://helmed.info/topic/mission-mas/ mission m3as] [http://davte.info/library/html/i-simpson.htm i simpson - stagione 1] [http://saibso.org/scope-elettriche.htm scope elettriche lava] [http://chaba.info/wusbgp-wireless/ wusb54gp wireless] [http://kinunia.cn/stima.htm stima] [http://psisemiya.com/images/small/tim-un/ tim. un uomo da odiare] [http://kinunia.cn/jeanette-winterson.htm jeanette winterson] [http://amohseni.info/img/styles/abrasive-blasting/ abrasive blasting] [http://amohseni.info/img/styles/ex-z/ ex z55] [http://davte.info/library/html/lettore-divx.htm lettore divx lg dvx 9900] [http://ustall.org/web/motorizzazione-como.htm motorizzazione como] [http://chaba.info/franchising-immobiliare/ franchising immobiliare] [http://bloprofeldi.info/lib/freelander.htm freelander 2002] [http://psisemiya.com/images/small/immagini-disney/ immagini disney hentai] [http://chaba.info/pornodonne/ pornodonne] [http://saibso.org/lcd-x.htm lcd 1920x1080] [http://chaba.info/thermaltake-polo/ thermaltake polo 735] [http://ashythro.info/library/html/weekend-lunghi/ weekend lunghi al mare] [http://nobinters.org/madasun.htm madasun] [http://nobinters.org/annuncio-lavoro.htm annuncio lavoro molise] [http://nobinters.org/luomo-di.htm luomo di hong kong] [http://nobinters.org/netgear-adsl.htm netgear adsl modem router] [http://saibso.org/sigma-mm.htm sigma 55-200mm f4-5 6 dc] [http://nobinters.org/pencere.htm pencere] [http://ustall.org/web/casa-vacanza.htm casa vacanza emilia romagna] [http://ashythro.info/library/html/modello-side/ modello side] [http://davte.info/library/html/tata-young.htm tata young i believe in love] [http://chaba.info/vicopisano/ vicopisano] [http://helmed.info/topic/parrucchieri-on/ parrucchieri on line] [http://ustall.org/web/digicom-isdn.htm digicom isdn] [http://davte.info/library/html/www-scienze.htm www scienze uniba it] [http://saibso.org/pegperego-navetta.htm peg-perego navetta] [http://ustall.org/web/hard-disk.htm hard disk esterno 500] [http://chaba.info/casin/ casin] [http://nobinters.org/qtek-s.htm qtek s100 italia] [http://chaba.info/gigaset-segreteria/ gigaset segreteria] [http://ustall.org/web/ferro-termozeta.htm ferro termozeta] [http://davte.info/library/html/manuela-falorni.htm manuela falorni] [http://saibso.org/prezzi-alpitour.htm prezzi alpitour] [http://helmed.info/topic/cardiofrequenzimetri-polar/ cardiofrequenzimetri polar] [http://bloprofeldi.info/lib/dice-finley.htm dice finley quaye] [http://ustall.org/web/himno-nacional.htm himno nacional de brasil] [http://helmed.info/topic/universita-venezia/ universita venezia] [http://kinunia.cn/paul-theroux.htm paul theroux] [http://ustall.org/web/severina-vuckovic.htm severina vuckovic stolen home video] [http://ashythro.info/library/html/sesso-extreme/ sesso extreme] [http://bloprofeldi.info/lib/tyler-hero.htm tyler hero] [http://ashythro.info/library/html/ermengarda/ ermengarda] [http://ustall.org/web/panasonic-dsnap.htm panasonic d-snap sv-av50] [http://bloprofeldi.info/lib/embarazadas-con.htm embarazadas con perros] [http://psisemiya.com/images/small/segni-zodiacali/ segni zodiacali immagine disegni] [http://saibso.org/testi-canzoni.htm testi canzoni anni 70] [http://bloprofeldi.info/lib/foto-tiziano.htm foto tiziano ferro] [http://davte.info/library/html/club-punto.htm club punto] [http://ustall.org/web/due-come.htm due come noi. vol. 02] [http://psisemiya.com/images/small/video-she/ video she s the one] [http://nobinters.org/diffusori-jbl.htm diffusori jbl 6 1] [http://ustall.org/web/nova-art.htm nova art explosion] [http://kinunia.cn/sito-e.htm sito e nuove immagini per alexander] [http://ashythro.info/library/html/hp-c/ hp 2400c] [http://kinunia.cn/monitor-crt.htm monitor crt flat 19] [http://kinunia.cn/do-you.htm do you wanna touch me] [http://ustall.org/web/giuseppe-martoni.htm giuseppe martoni] [http://bloprofeldi.info/lib/ati-xgi.htm ati xgi] [http://saibso.org/chat-mexico.htm chat mexico] [http://davte.info/library/html/lexmark.htm lexmark 1000] [http://helmed.info/topic/autoventilante/ autoventilante] [http://chaba.info/office/ office 97] [http://helmed.info/topic/movie-porn/ movie porn] [http://davte.info/library/html/casalina.htm casalina] [http://amohseni.info/img/styles/green-mountains/ green mountains] [http://saibso.org/slipknot-disasterpieces.htm slipknot. disasterpieces] [http://psisemiya.com/images/small/norah-jones/ norah jones what am i to you] [http://amohseni.info/img/styles/slogan/ slogan] [http://saibso.org/bijewel.htm bi-jewel] [http://kinunia.cn/joe-e.htm joe e cooker] [http://bloprofeldi.info/lib/cartina-geografica.htm cartina geografica dell adige] [http://ustall.org/web/hotel-mercure.htm hotel mercure] [http://davte.info/library/html/acer-easy.htm acer easy mp3] [http://nobinters.org/frocio.htm frocio] [http://davte.info/library/html/trailer-film.htm trailer film j m] [http://kinunia.cn/rochy.htm rochy] [http://ustall.org/web/sporca.htm sporca] [http://saibso.org/il-chitarrista.htm il chitarrista graziani] [http://amohseni.info/img/styles/ghosts-ship/ ghosts ship] [http://bloprofeldi.info/lib/monitor-philips.htm monitor philips 109e50 19] [http://ustall.org/web/hp-proliant.htm hp proliant dl380] [http://saibso.org/www-sbn.htm www sbn it] [http://chaba.info/la-vita/ la vita agra] [http://ashythro.info/library/html/optio-lf/ optio 33lf pentax] [http://nobinters.org/geosat-navigatore.htm geosat navigatore] [http://amohseni.info/img/styles/daje-ti/ daje ti ric] [http://helmed.info/topic/piaseczny-a/ piaseczny a] [http://bloprofeldi.info/lib/www-peppesex.htm www peppesex it] [http://davte.info/library/html/synchronizer.htm synchronizer] [http://ustall.org/web/creative-muvo.htm creative muvo slim lettori mp3] [http://kinunia.cn/sakas.htm sakas] [http://davte.info/library/html/il-contadino.htm il contadino allegro] [http://kinunia.cn/adsl-rj.htm adsl rj11] [http://kinunia.cn/torna-a.htm torna a sorrento] [http://ashythro.info/library/html/deskjet-c/ deskjet 1120c] [http://ashythro.info/library/html/oral-cum/ oral cum] [http://ustall.org/web/guantoni-everlast.htm guantoni everlast] [http://ashythro.info/library/html/jeep-perugia/ jeep perugia] [http://ashythro.info/library/html/immagini-copyleft/ immagini copyleft] [http://davte.info/library/html/once-upon.htm once upon a time in mexico] [http://saibso.org/marcuzzi-tette.htm marcuzzi tette] [http://saibso.org/juego-de.htm juego de la logica] [http://kinunia.cn/santa-lucia.htm santa lucia belpasso] [http://chaba.info/frigoriferi-combi/ frigoriferi combi da incasso rex] [http://amohseni.info/img/styles/inno-americano/ inno americano] [http://amohseni.info/img/styles/demo-e/ demo e sito italiano per rollercoaster tycoon 3] [http://psisemiya.com/images/small/foto-differents/ foto differents] [http://davte.info/library/html/ufficio-.htm ufficio - macchine e attrezzature] [http://amohseni.info/img/styles/ingoio-sperma/ ingoio sperma] [http://davte.info/library/html/cartoline-auguri.htm cartoline auguri natale] [http://nobinters.org/fornitura-caffe.htm fornitura caffe uffici] [http://kinunia.cn/har-disk.htm har disk rete] [http://ustall.org/web/move-your.htm move your feet] [http://ashythro.info/library/html/pantaloni-fitness/ pantaloni fitness uomo] [http://kinunia.cn/medieval.htm medieval] [http://kinunia.cn/wuhan.htm wuhan] [http://bloprofeldi.info/lib/jvc-telecamera.htm jvc telecamera hd] [http://kinunia.cn/occhiale-roberto.htm occhiale roberto cavallo] [http://ustall.org/web/una-prostituta.htm una prostituta per il governatore] [http://saibso.org/compilation-inter.htm compilation inter] [http://ustall.org/web/bring-the.htm bring the elements] [http://nobinters.org/juliana-knust.htm juliana knust] [http://amohseni.info/img/styles/mercatone-uno/ mercatone uno] [http://kinunia.cn/classroom.htm classroom] [http://helmed.info/topic/trucchi-civilization/ trucchi civilization 3] [http://davte.info/library/html/giochi-da.htm giochi da vestire] [http://ustall.org/web/yahoo-france.htm yahoo france] [http://nobinters.org/corvara-it.htm corvara it] [http://saibso.org/www-expert.htm www expert italia it] [http://davte.info/library/html/lettore-cd.htm lettore cd con radio] [http://nobinters.org/sapphire-radeon.htm sapphire radeon 9600 atlantis 256mb agp] [http://saibso.org/kenwood-dvf.htm kenwood dvf 3250s] [http://helmed.info/topic/hayfa-wahbi/ hayfa wahbi] [http://kinunia.cn/radio-sonnenschein.htm radio sonnenschein] [http://kinunia.cn/boney-james.htm boney james] [http://nobinters.org/samsung-tv.htm samsung tv 23] [http://saibso.org/hercule.htm hercule] [http://nobinters.org/nuovi-animali.htm nuovi animali per impossible creatures] [http://ustall.org/web/deumidificatore.htm deumidificatore 300] [http://bloprofeldi.info/lib/mah-jhong.htm mah jhong] [http://helmed.info/topic/canzoni-neck/ canzoni neck] [http://kinunia.cn/cuffie-fm.htm cuffie fm] [http://davte.info/library/html/il-sesto.htm il sesto giorno. la vendetta] [http://chaba.info/zombie/ zombie 6000] [http://ustall.org/web/el-gringo.htm el gringo barbarosa] [http://bloprofeldi.info/lib/hum-e.htm hum e cocaina] [http://ustall.org/web/il-cavalierenero.htm il cavaliere.nero] [http://davte.info/library/html/play.htm play 2] [http://bloprofeldi.info/lib/vice-cit.htm vice cit] [http://kinunia.cn/casio-.htm casio 7 2 mp] [http://davte.info/library/html/parigi-pensioni.htm parigi pensioni] [http://davte.info/library/html/uno-strano.htm uno strano campione di football] [http://ustall.org/web/tv-e.htm tv e wifi] [http://bloprofeldi.info/lib/v-raptor.htm v raptor 1000] [http://chaba.info/kisses-the/ kisses the rain] [http://bloprofeldi.info/lib/proteggi-schermo.htm proteggi schermo] [http://amohseni.info/img/styles/dvd-cinema/ dvd cinema] [http://ustall.org/web/baricco-alessandro.htm baricco alessandro libri] [http://bloprofeldi.info/lib/thanhnienvn-com.htm thanhnienvn com] [http://helmed.info/topic/last-minute/ last minute offerta speciali] [http://nobinters.org/libri-musica.htm libri musica] [http://davte.info/library/html/lg-monitor.htm lg monitor 1715s] [http://nobinters.org/fratelli-ditalia.htm fratelli ditalia] [http://nobinters.org/sceen-savers.htm sceen savers] [http://davte.info/library/html/doc-programmazione.htm doc programmazione matrix revolutions] [http://psisemiya.com/images/small/penguin-cafe/ penguin cafe] [http://davte.info/library/html/piccinini.htm piccinini] [http://helmed.info/topic/la-tierra/ la tierra prometida] [http://kinunia.cn/scanner-hp.htm scanner hp scanjet 4670] [http://amohseni.info/img/styles/ricetta-al/ ricetta al cacao] [http://chaba.info/fiocco-di/ fiocco di neve] [http://bloprofeldi.info/lib/usb-hub.htm usb hub card] [http://helmed.info/topic/tsm-v/ tsm 100v] [http://ustall.org/web/carica-nella.htm carica nella jungla] [http://chaba.info/xlater/ xlater] [http://ustall.org/web/lucia-diriso.htm lucia diriso] [http://bloprofeldi.info/lib/havana-kenny.htm havana kenny g] [http://psisemiya.com/images/small/pisseri/ pisseri] [http://psisemiya.com/images/small/forno-microonde/ forno microonde sharp] [http://kinunia.cn/sindaco-comune.htm sindaco comune tavagnacco] [http://nobinters.org/foto-annuncio.htm foto annuncio incontro privato] [http://ustall.org/web/pianta-aloe.htm pianta aloe] [http://ustall.org/web/www-calcio.htm www calcio 2000 it] [http://bloprofeldi.info/lib/concerto-roma.htm concerto roma] Here is my step by step guide to getting EPrints 2.3.10 to install on a brand new Red Hat Enterprise Linux 4 install.
+
Here is my step by step guide to getting EPrints 2.3.10 to install on a brand new Red Hat Enterprise Linux 4 install.
  
 
There may be some more issues that arrise, if you have a workaround, please add it. If it's just a bug, please leave a comment at the end of this page so I can try and resolve it.
 
There may be some more issues that arrise, if you have a workaround, please add it. If it's just a bug, please leave a comment at the end of this page so I can try and resolve it.
Line 37: Line 37:
 
then exit cpan (type exit) and run the perlmodule installer which came with EPrints.
 
then exit cpan (type exit) and run the perlmodule installer which came with EPrints.
  
Make sure apache
+
Make sure apache & mysql start when you reboot
 +
 
 +
/sbin/chkconfig mysqld on
 +
/sbin/chkconfig httpd on
 +
 
 +
 
 +
If you really want to install GDOME, see the appendix at the bottom
 +
of this page. GDOME has not been updated in years and in my experience perl-XML-DOM performs well on modern machines (searching hundreds of documents in less than 1 second on a Pentium 4).
 +
 
 +
== Install EPrints ==
 +
 
 +
=== Download ===
 +
cd /root
 +
wget http://software.eprints.org/files/eprints2/eprints-2.3.10.tar.gz
 +
tar xzvf eprints-2.3.10.tar.gz
 +
 
 +
=== Add an "eprints" user and group ===
 +
 
 +
useradd eprints
 +
 
 +
This will create a user and group called ''eprints''. Alternatively, you can run EPrints as user/group ''apache''.
 +
 
 +
===Configure and install ===
 +
 
 +
Find out what your outgoing SMTP (email) server is and put it in the configuration options.
 +
 
 +
./configure --with-smtp-server smtp.mydomain.ac.uk
 +
./install.pl
 +
 
 +
=== Set up apache ===
 +
 
 +
Edit the apache config:
 +
 
 +
vi /etc/httpd/conf/httpd.conf
 +
 
 +
In httpd.conf, change the "User" and "Group" to be "eprints"
 +
 
 +
User eprints
 +
Group eprints
 +
 
 +
Also in httpd.conf add this to the end:
 +
 
 +
Include /opt/eprints2/cfg/apache.conf
 +
 
 +
=== Set up the indexer as a linux service ===
 +
 
 +
To make the indexer into a service which starts and stops on reboots etc. like httpd and mysqld do the following (as root):
 +
 
 +
ln -s /opt/eprints2/bin/epindexer /etc/init.d/epindexer
 +
chkconfig --add epindexer
 +
chkconfig epindexer on
 +
 
 +
The epindexer script runs as root, changes user to "eprints" (or whatever uid your eprints install runs as) and then calls indexer.
 +
 
 +
=== Configure an archive ===
 +
 
 +
Now start setting up an archive. See the main documentation for details.
 +
 
 +
== Troubleshooting ==
 +
 
 +
=== Seems to install, but nothing runs ===
 +
 
 +
SELinux (Security-Enhanced Linux) restricts Apache to the /var/www/
 +
directory, see http://fedora.redhat.com/docs/selinux-faq/ for more information or turn it off with:
 +
 
 +
setenforce 0
 +
sed -i 's;SELINUX=.*;SELINUX=disabled;' /etc/sysconfig/selinux
 +
 
 +
=== Problem starting apache? ===
 +
 
 +
The apache which comes with RH Enterprise 4 has https configured, but no certificate. This means when you try to start apache, it may give an error message that it needs a certificate. If this happens you have two options:
 +
* make a certificate, this is only needed if you intend to use https
 +
* disable https
 +
 
 +
To disable https: comment out (adding a # to the start of each line) all the lines in "/etc/httpd/conf.d/ssl.conf". Do not delete this file as if you do, and then upgrade apache using RPMs, the new RPM will just recreate the file. If it exists and has been modified then it won't.
 +
 
 +
 
 +
== Installing GDOME and the perl GDOME interface ==
 +
 
 +
This is not essential. Non-RH RPMs are available at http://linux.reb00t.com/RPMS/
 +
 
 +
libxml2 should already be installed.
 +
 
 +
Install the GDOME rpms.
 +
 
 +
cd /root
 +
wget http://gdome2.cs.unibo.it/rpm/gdome2-0.8.1-1.i386.rpm
 +
wget http://gdome2.cs.unibo.it/rpm/gdome2-devel-0.8.1-1.i386.rpm
 +
rpm -Uvh gdome2-0.8.1-1.i386.rpm gdome2-devel-0.8.1-1.i386.rpm
 +
 
 +
(You can get more recent versions if they are available).
 +
 
 +
=== Fix the bug in gdome-config ===
 +
 
 +
When I installed gdome-config it appeared to have a slight error when it installed.
 +
 
 +
To see if the bug is a problem run:
 +
 
 +
gdome-config --libs
 +
 
 +
If you get something like:
 +
 
 +
/usr/bin/gdome-config: line 86: --libs: command not found
 +
/usr/bin/gdome-config: line 87: --cflags: command not found
 +
 
 +
then you need to fix the bug. Don't worry, it's easy.
 +
 
 +
As root edit /usr/bin/gdome-config
 +
 
 +
vi /usr/bin/gdome-config
 +
 
 +
Around line 88 find these two lines:
 +
 
 +
the_libs="$the_libs -L${exec_prefix}/lib -lgdome ` --libs` `xml2-config --libs`"
 +
the_flags="$the_flags -I${prefix}/include -I${prefix}/include/libgdome ` --cflags` `xml2-config --cflags`"
 +
 
 +
And change them to this:
 +
the_libs="$the_libs -L${exec_prefix}/lib -lgdome `/usr/bin/glib-config --libs` `xml2-config --libs`"
 +
the_flags="$the_flags -I${prefix}/include -I${prefix}/include/libgdome `/usr/bin/glib-config --cflags` `xml2-config --cflags`"
 +
 
 +
=== Install XML::GDOME ===
 +
 
 +
note: you need the RPM glib-devel installed for this to work. (Possibly "up2date glib-devel" will sort this if up2date is set up)
 +
 
 +
Do this from source, not via CPAN as one of the tests is broken.
 +
cd /root
 +
wget http://cpan.uwinnipeg.ca/cpan/authors/id/T/TJ/TJMATHER/XML-GDOME-0.86.tar.gz
 +
tar xzvf XML-GDOME-0.86.tar.gz
 +
cd XML-GDOME-0.86
 +
perl Makefile.PL
 +
make
 +
make install
 +
 
 +
If you want you can run "make test" before install, but don't worry about the "SAX" test failing.
 +
 
 +
==RHEL 4 mod_perl "Apache2::Const::OK" not allowed while "strict subs"==
 +
 
 +
The current distributed version of mod_perl on RHEL 4 is 1.99, there seems to be some compatibility issues with this release which may cause Apache to fail on startup. Research suggests upgrading the module to at least vesion 2.0.1. If you use the stock install of RHEL 4 this is a little tricky, however RH do have a Beta channel that can be subscribed to in order to load the required version.
 +
 
 +
'''Use with CAUTION this is only Beta, don't blame me if something goes wrong on your production server!'''
 +
 
 +
Channel name : Red Hat Web Application Stack 1.0 Beta (for AS v. 4 x86)
 +
 
 +
In RHN select your system profile, Alter Channel Subscriptions, pick this channel from the list and apply.
 +
 
 +
On the command line :
 +
 
 +
up2date -u mod_perl
 +
 
 +
This will install mod_perl 2.0.2 '''AND''' upgrade Perl to 5.8.8 - '''BEWARE''' this may cause problems with other applications on the server test everything!
 +
 
 +
Hope this helps, Neil Marjoram.

Revision as of 08:21, 20 August 2007

Here is my step by step guide to getting EPrints 2.3.10 to install on a brand new Red Hat Enterprise Linux 4 install.

There may be some more issues that arrise, if you have a workaround, please add it. If it's just a bug, please leave a comment at the end of this page so I can try and resolve it.

Install Linux and Prerequisites

Install Red Hat Enterprise Linux 4, the latest Update [=ISOs=] are available through Red Hat Network. If RHN is working, use it to get all the required packages:

up2date -u httpd wget gunzip xpdf lynx unzip
up2date -u mod_perl perl-DBI perl-DBD-MySQL perl-XML-Parser

Note: you will need to make sure your machine has the "Extras" channel in RHN or install mysql-server from the 'extras' disk, even if you selected to install MySQL in the menus:

up2date mysql-server

If you want the LaTeX functionality install a TeX system and ImageMagick:

up2date tetex-latex ImageMagick

Other perl modules

EPrints requires several perl modules not available through RHN. One place to get them is from Dag Wieers' high-quality repository, see http://dag.wieers.com/home-made/apt/FAQ.php#B. Install other perl modules like this:

rpm --import http://dag.wieers.com/packages/RPM-GPG-KEY.dag.txt
cat >> /etc/sysconfig/rhn/sources <<EOF
yum dag-rhel-4 http://apt.sw.be/redhat/el4/en/i386/dag/
EOF
up2date -u perl-Data-ShowTable perl-MIME-Base64 perl-Unicode-String
# turn off Dag's repo when not using 
sed -i 's;yum dag;#yum dag;g' /etc/sysconfig/rhn/sources

Alternatively, you can use CPAN with the automated script which comes with eprints; run "cpan" and answer the questions.

cpan

then exit cpan (type exit) and run the perlmodule installer which came with EPrints.

Make sure apache & mysql start when you reboot

/sbin/chkconfig mysqld on
/sbin/chkconfig httpd on


If you really want to install GDOME, see the appendix at the bottom of this page. GDOME has not been updated in years and in my experience perl-XML-DOM performs well on modern machines (searching hundreds of documents in less than 1 second on a Pentium 4).

Install EPrints

Download

cd /root
wget http://software.eprints.org/files/eprints2/eprints-2.3.10.tar.gz
tar xzvf eprints-2.3.10.tar.gz

Add an "eprints" user and group

useradd eprints

This will create a user and group called eprints. Alternatively, you can run EPrints as user/group apache.

Configure and install

Find out what your outgoing SMTP (email) server is and put it in the configuration options.

./configure --with-smtp-server smtp.mydomain.ac.uk
./install.pl

Set up apache

Edit the apache config:

vi /etc/httpd/conf/httpd.conf

In httpd.conf, change the "User" and "Group" to be "eprints"

User eprints
Group eprints

Also in httpd.conf add this to the end:

Include /opt/eprints2/cfg/apache.conf

Set up the indexer as a linux service

To make the indexer into a service which starts and stops on reboots etc. like httpd and mysqld do the following (as root):

ln -s /opt/eprints2/bin/epindexer /etc/init.d/epindexer
chkconfig --add epindexer
chkconfig epindexer on

The epindexer script runs as root, changes user to "eprints" (or whatever uid your eprints install runs as) and then calls indexer.

Configure an archive

Now start setting up an archive. See the main documentation for details.

Troubleshooting

Seems to install, but nothing runs

SELinux (Security-Enhanced Linux) restricts Apache to the /var/www/ directory, see http://fedora.redhat.com/docs/selinux-faq/ for more information or turn it off with:

setenforce 0 
sed -i 's;SELINUX=.*;SELINUX=disabled;' /etc/sysconfig/selinux

Problem starting apache?

The apache which comes with RH Enterprise 4 has https configured, but no certificate. This means when you try to start apache, it may give an error message that it needs a certificate. If this happens you have two options:

  • make a certificate, this is only needed if you intend to use https
  • disable https

To disable https: comment out (adding a # to the start of each line) all the lines in "/etc/httpd/conf.d/ssl.conf". Do not delete this file as if you do, and then upgrade apache using RPMs, the new RPM will just recreate the file. If it exists and has been modified then it won't.


Installing GDOME and the perl GDOME interface

This is not essential. Non-RH RPMs are available at http://linux.reb00t.com/RPMS/

libxml2 should already be installed.

Install the GDOME rpms.

cd /root
wget http://gdome2.cs.unibo.it/rpm/gdome2-0.8.1-1.i386.rpm 
wget http://gdome2.cs.unibo.it/rpm/gdome2-devel-0.8.1-1.i386.rpm
rpm -Uvh gdome2-0.8.1-1.i386.rpm gdome2-devel-0.8.1-1.i386.rpm

(You can get more recent versions if they are available).

Fix the bug in gdome-config

When I installed gdome-config it appeared to have a slight error when it installed.

To see if the bug is a problem run:

gdome-config --libs 

If you get something like:

/usr/bin/gdome-config: line 86: --libs: command not found
/usr/bin/gdome-config: line 87: --cflags: command not found

then you need to fix the bug. Don't worry, it's easy.

As root edit /usr/bin/gdome-config

vi /usr/bin/gdome-config

Around line 88 find these two lines:

the_libs="$the_libs -L${exec_prefix}/lib -lgdome ` --libs` `xml2-config --libs`"
the_flags="$the_flags -I${prefix}/include -I${prefix}/include/libgdome ` --cflags` `xml2-config --cflags`"

And change them to this:

the_libs="$the_libs -L${exec_prefix}/lib -lgdome `/usr/bin/glib-config --libs` `xml2-config --libs`"
the_flags="$the_flags -I${prefix}/include -I${prefix}/include/libgdome `/usr/bin/glib-config --cflags` `xml2-config --cflags`"

Install XML::GDOME

note: you need the RPM glib-devel installed for this to work. (Possibly "up2date glib-devel" will sort this if up2date is set up)

Do this from source, not via CPAN as one of the tests is broken.

cd /root
wget http://cpan.uwinnipeg.ca/cpan/authors/id/T/TJ/TJMATHER/XML-GDOME-0.86.tar.gz
tar xzvf XML-GDOME-0.86.tar.gz
cd XML-GDOME-0.86
perl Makefile.PL
make
make install

If you want you can run "make test" before install, but don't worry about the "SAX" test failing.

RHEL 4 mod_perl "Apache2::Const::OK" not allowed while "strict subs"

The current distributed version of mod_perl on RHEL 4 is 1.99, there seems to be some compatibility issues with this release which may cause Apache to fail on startup. Research suggests upgrading the module to at least vesion 2.0.1. If you use the stock install of RHEL 4 this is a little tricky, however RH do have a Beta channel that can be subscribed to in order to load the required version.

Use with CAUTION this is only Beta, don't blame me if something goes wrong on your production server!

Channel name : Red Hat Web Application Stack 1.0 Beta (for AS v. 4 x86)

In RHN select your system profile, Alter Channel Subscriptions, pick this channel from the list and apply.

On the command line :

up2date -u mod_perl

This will install mod_perl 2.0.2 AND upgrade Perl to 5.8.8 - BEWARE this may cause problems with other applications on the server test everything!

Hope this helps, Neil Marjoram.