install custom geosource 2.2 (1).pdf

Tutoriel

Version:02Date:26/08/2009Pages:25

InstallationetcustomisationdulogicielGeosource2.2

Rdaction ApprobationWilfriedHeintz&DamienMauriceGIPEcofor GuyLandmannGIPEcofor

Installation&customisationdeGeosourcev21

0Index

1Introduction...................................................................................................................................................32InstallationdeDebianEtch............................................................................................................................4

2.1.InstallationdusystmedebaseDebian.............................................................................................42.2.Rappelssurl'arborescencedesfichiersUNIX.....................................................................................42.3.Accsvotreserveur..........................................................................................................................6

3InstallationdeGeosource2.0.1....................................................................................................................63.1.Modifierlefichierdesdpts(root)......................................................................................................63.2.Misejouretredmarrage(root)........................................................................................................63.3.Synchronisationdel'heureetSSH(root).............................................................................................73.4.InstallationdeApache2(root)..............................................................................................................73.5.InstallationduJDK1.6(root)...............................................................................................................73.6.InstallationdeTomcat5.5(root)..........................................................................................................7

3.6.1Enmodeautomatique..................................................................................................................73.6.2Enmodemanuel(privilgierpourunemeilleurestabilit)........................................................8

3.7.InstallationdePostgreSQL(root).......................................................................................................103.8.InstallationdeGeosourceV2.0.1(root).............................................................................................113.9.InstallationdeslibrairiesXALANrequises(root)...............................................................................113.10.Changementdepropritairedesrpertoires...................................................................................123.11.Miseenplacedulienentrel'applicationgeonetworkettomcat........................................................123.12.Crationdelabasededonnes......................................................................................................143.13.ConnexionentreApacheetTomcat................................................................................................16

3.13.1Utilisationduvirtualhost............................................................................................................163.13.2Utilisationdumodeproxyreverse..............................................................................................16

4Customisationdel'interface.........................................................................................................................194.1.Prsentation.......................................................................................................................................194.2.Ajouterunepagedecontenu.............................................................................................................20

4.2.1.Dclarationd'unservice............................................................................................................204.2.2.Autorisationduservice.............................................................................................................204.2.3.Crationdelapagedecontenu................................................................................................214.2.4.Crationd'unlabelpourl'lmentdemenu..............................................................................214.2.5.Insertiondel'lmentdanslabarredemenu...........................................................................21

4.3.Chartegraphique...............................................................................................................................224.3.1.Modifierlebandeausuprieur(image) .....................................................................................224.3.2.Modifierlemenu.......................................................................................................................234.3.3.Modifierl'aspectdelapagecentrale.........................................................................................244.3.4.Modifierlepieddepage...........................................................................................................254.3.5.Divers.......................................................................................................................................25


1Introduction

Dans le cadrede la miseenplacedu CataloguedesSourcesd'Informationsur la Fort (CaSIF),l'quipeduprojet achoisi desebaser sur l'outil Geosource, dvelopp par leBureaudeRecherchesGologiquesetMinires(BRGM),souslemandatdelaDirectionGnraledelaModernisationdel'Etat(DGME).

GeosourceestluimmebassurlelogicielGeonetwork,cretmaintenuparunelargecommunautdedveloppeurs.

L'objetdecedocumentestd'aiderlesnouveauxutilisateursinstalleretpersonnaliserleurpropreserveurdemtadonnes,sansncessairementseplongerdanslesentraillesdel'administrationduconteneurdeservletTomcatoudanslarigueurdulangageXML...

Eneffet,l'installationdeGeosourceenmodemonopostesousunemachinewindowsestrelativementaise.Enrevanche,l'installationenmodeserveursousunixpeuts'avrernettementplusardue.Lacustomisationdel'outilresteencoregalementpeudocumente.

Pourtoutescesraisons,ilnousasemblintressantdepouvoirpartagernotreexpriencerelativelapriseenmaindecetoutil,quis'avretreparailleursuneexcellentesolutionpoursedoterd'unserveurdemtadonnesrobuste,stableetrespectantdesnormesofficielles.

Geosourcepeuttremisenoeuvreavecdiffrentssystmesetoutils;laconfigurationprsenteicireposesur lesystmeLinuxDebian, leSGBDpostgreSQL, leconteneurdeservlet Tomcatet le serveurWebApache2.

Cettedocumentationesttoujourssusceptibled'trecomplteetamliore.Mercipourvosremarquesetpropositionsd'amliorations.

Cetteversion02dututorielportesurl'installationdegeosourcev2.2avecconfigurationdeTomcatenmodemanuel,suitedesproblmesimportantdestabilitdel'application.Cettedocumentations'appliquedoncladernireversionendatedeGeosource.

Pourplusdedtails,ladocumentionofficielledeGeosourcev2estdisponiblel'adressesuivante:

http://geonetworkopensource.org/documentation/manual/thecompletegeosourcemanual/Manual_fra.pdf


2InstallationdeDebianEtchNous avons choisi d'installer notre serveur sur une distribution Debian4.0r6 dite Etch. Ce systmed'exploitationestrputpourtretrsstablecarpur denombreusesapplicationsinutiles. SonnoyauLinuxgarantitgalementunegrandefiabilit.

AfindegarantiruneinstallationdeGeosourceconformecellepropose,nousdcrivonslestapespourinstallerDebianEtchsurunserveur.

Lessourcesd'installationdeDebiansontdisponiblesl'adressehttp://www.debian.org/distrib/netinst

Note:lesinformationsd'installationonttreproduitesavecsuccssurlanouvelleversionLenny.

2.1.InstallationdusystmedebaseDebian

DmarrezvotresystmesurleCDRomDebianousuruneimageduCD;

Choisissezvotrelangueprincipale,votrepaysetladispositionduclavier;

SiladtectiondurseauavecDHCPchoueetquevousconnaissezlaconfigurationrseaudevotremachine(IP,passerelle...),vouspouvezeffectueruneconfigurationmanuelle.Sinon,vouspouvezpassercettetape;

Donnezunnomvotremachine,ainsiqu'unnomdedomaine;

Pourpartitionnervotredisque,choisissezpartitionnementassistavecLVM.Slectionnezledisquepuischoisissezl'optionpartitions/home/usr/varet/tmpspares,puisvalidez;

Une fois le partitionnement achev, crez un mot de passe pour le superutilisateur puis un compteutilisateur;

Lorsquel'installationdusystmeesttermine,choisir non lademanded'utilisationdumiroir surlerseau;

Slectionnez enfin un environnement graphique de bureau en plus du systmestandard. Validez larsolutiondel'cran;

InstallerleprogrammededmarrageGRUBsurlesecteurd'amorage?OUI.

Al'cran"terminerl'installation",retirerleCDd'installation,choisir"Continuer"pourredmarrerdepuisledisquedurpuisterminerl'installationdeDebianparlesmisesjoursibesoin.

Acestade,enprincipe,lesystmedoitbooternormalement.

2.2.Rappelssurl'arborescencedesfichiersUNIX

DebianGNU/Linuxadhrelanormesurlahirarchiedusystmedefichierspourlenommagedesfichiers


etdesrpertoires.Cettenormepermetauxutilisateursetauxlogicielsdeprvoirl'emplacementdesfichiersetdesrpertoires.Lerpertoireracineestsimplementreprsentparlabarreoblique/.Auniveaudelaracine,touslessystmesDebianincluentcesrpertoires:

bin:Binaires(excutables)descommandesessentielles

boot:Fichiersstatiquespourlechargeurd'amorage(boot)

dev:Fichiersdespilotesdepriphriques

etc:Configurationsystmeproprelamachine

home:Rpertoirespersonnelsdesutilisateurs

lib:Bibliothquespartagesetmodulesnoyauxessentiels

mnt:Pointdemontagepourlesmontagestemporaires

proc:Rpertoirevirtuelpourlesinformationssystmes

root:Rpertoirepersonneldel'utilisateurroot

sbin:Excutablessystmeessentiels

tmp:Fichierstemporaires

usr:Hirarchiesecondaire

var:Donnesvariables

opt:Suitesapplicativesadditionnelles

Lalistesuivantedcritquelquescaractristiquesimportantesdesrpertoiresetdespartitions:

Lapartitionracine/doittoujourscontenirlesrpertoires:/etc,/bin,/sbin,/libet/dev,sinonvotresystmenepourrapasdmarrer.Engnral,100Mosontncessaires,maiscelapeutvarier;

/usr : tous les programmes utilisateurs (/usr/bin), les bibliothques (/usr/lib), la documentation(/usr/share/doc)...sontdanscerpertoire.C'estcettepartiedusystmedefichiersquiabesoinduplusd'espace. Vousdevriezdisposer d'aumoins500Mod'espacedisque. Si vousvoulez installer plusdepaquets,vousdevriezaugmenterl'espacedisqueattribucerpertoire;

/home : chaque utilisateur mettra ses donnes dans un sousrpertoire de ce rpertoire. La placencessairedpenddunombred'utilisateurssurlesystme,etdugenredefichiersqu'ilsdevrontstocker.Selonl'utilisationdusystme,vousdevriezrserverenviron100Moparutilisateur, adapterselonvosbesoins;

/var:touteslesdonnesvariablescommelesarticlesdesforumsusenet,lesmessageslectroniques,lessitesweb,lecached'APT,etc.serontplacesdanscerpertoire.Laplacencessairedpendnormmentdel'usagequevousfaitesdevotreordinateur,maispourlaplupartdesadministrateurs,elleseradictepar


lachargedueauxoutilsdegestiondespaquets.SivousenvisagezdefaireuneinstallationcompltedetoutcequeDebianpeutvousoffrirenuneseulefois,rserver2ou3God'espacepour/vardevraitsuffire.Sivousprfrezinstallerletoutenplusieurstapes(p.ex.,d'abordlesservicesetutilitaires,puislesoutilstexte,puisX11...),vouspouvezvouscontenterde300Mopour/var.Sil'espacedisqueestunecontraintemajeureetquevousnevoulezpasutiliserAPT,oudumoinspaspourdesmisesjourmajeures,vouspouvezvouslimiter30ou40Modans/var;

/tmp:siunprogrammecredesdonnestemporaires,ellesserontprobablementplacesdans/tmp.2050Modevraientsuffire.

2.3.Accsvotreserveur

Ils'agitensuited'attribueruneadresseIPvotreserveurafinqueceluicisoitaccessibledepuislerseauInternet.Adressezvousvotreadministrateurrseaupourdeplusamplesdtailssurcetteconfiguration.

Nousvousconseillonsdelimiterl'accsdepuisl'extrieurensshethttpuniquement;onpeutfaireduftptraverslesshcarceprocessusestscuris.Cetaccssousentendqu'onaccdeauserveurenmodelignedecommande(pasd'interfacegraphique).Danstous lescas,conformezvousauxrecommendationsdevotreadministrateursystme/rseau.

DepuisunposteWindows:avecl'outillibreputty.LepackageestrecommandcarilproposedesoutilssupplmentairescommePSCPouPSFTPpour transfrer bilatrallement des fichiers entre serveursetmachinedistante(http://www.chiark.greenend.org.uk/~sgtatham/putty/)

Depuisunposteenlinux:utiliserlestunnelsssh.

3InstallationdeGeosource2.2

3.1.Modifierlefichierdesdpts(root)

vim /etc/apt/sources.list

Ondoitavoirlecontenusuivant:

# deb cdrom:[Debian GNU/Linux 4.0 r3 _Etch_ - Official i386 NETINST Binary-1 20080218-14:15]/ etch contrib main

deb cdrom:[Debian GNU/Linux 4.0 r3 _Etch_ - Official i386 NETINST Binary-1 20080218-14:15]/ etch contrib maindeb http://debian.mirror.inra.fr/debian/ etch main contrib non-freedeb http://debian.jouy.inra.fr/debian/ etch main contrib non-freedeb-src http://debian.mirror.inra.fr/debian/ etch main contrib non-freedeb-src http://debian.jouy.inra.fr/debian/ etch main contrib non-freedeb http://security.debian.org/ etch/updates main contribdeb-src http://security.debian.org/ etch/updates main contrib

Danslecadred'uneinstallationsousDebianLenny,remplacercidessusetchparlenny

3.2.Misejouretredmarrage(root)

apt-get updateapt-get dist-upgrade


shutdown -r now

3.3.Synchronisationdel'heureetSSH(root)

apt-get install ssh ntp

3.4.InstallationdeApache2(root)

apt-get install apache2

3.5.InstallationduJDK1.6(root)

Apriori,aucunjdkn'estinstallcestade,pourvrifier:

java -version

Siaucunrsultatn'esttrouv,c'estqu'iln'yapasdeJREouJDKsurlesystme.Danslecascontraires'assurerquel'indicedervisionsoit1.6.xsinonl'installerensuivantlaprocduresuivante:

apt-get install sun-j2sdk1.6

Vrifierl'installation

java -version

Ondoitobtenirlemessagesuivant:

java version "1.6.0_07"Java(TM) SE Runtime Environment (build 1.6.0_07-b06)Java HotSpot(TM) Client VM (build 10.0-b23, mixed mode, sharing)

Siuneautreversiondejavaestutilise,utiliserlacommandesuivantepourchoisirlaversiondejavautilisepardfaut:

update-alternatives --config java

Crer un lien vers votre rpertoire d'installation Java. Pour cela diter les fichiers ~/.bashrc (pourl'utilisateurcourant)et/etc/bash.bashrc(pourtouslesutilisateurs)puisajouterenfindesfichierslalignesuivante:

export JAVA_HOME=/usr/lib/jvm/java-6-sun

3.6.InstallationdeTomcat5.5(root)

3.6.1Enmodeautomatique

apt-get install tomcat5

Onpeutoptionnellementinstallerlesdeuxpaquetssuivants(maisilestconseilldelesretirerlorsdelamiseenproductionduserveursiondoitl'ouvrirsurl'Internet):

apt-get install tomcat5-admin tomcat5-webapps

Dfinirlechemindujdkpourtomcatetdsactiverlascurit:

vim /etc/default/tomcat5


Dcommenterventuellementetrenseignercommecidessousleslignessuivantes:JAVA_HOME=/usr/lib/j2sdk1.6-sunTOMCAT5_SECURITY=no

Silespaquetstomcat5adminettomcat5webappsonttinstalls,modifierlefichierdeconfigurationdesutilisateursdetomcatcommeindiqucidessous:

vim /var/lib/tomcat5/conf/tomcat-users.xml

Crerlerle"manager"etl'ajouterl'utilisateurtomcat5:

RelancerettesterTomcat(http://127.0.0.1:8180)

/etc/init.d/tomcat5 restart

3.6.2Enmodemanuel(privilgierpourunemeilleurestabilit)

L'installationvia aptget detomcatsembleposerdesproblmesd'instabilit. Sur leserveurCaSIF,parexemple,partird'uneinstallationdetomcatviaaptgetquifonctionnait,ilestdevenusubitementimpossibled'avoirunerponsedetomcatmalgrunprocessuslanc.L'arrtdetomcatnesefaisaitpasproprement(process tu). Aprs dsinstallation complte et rinstallation via aptget, les mmes symptmesapparaissaient.Seuleuneinstallationetuneconfigurationmanuelleontpermisderetrouveruntomcat5.5oprationnel.

TlchargementdeTomcat:Tlchargezlaversion5.5.26deTomcatsurlesiteofficiel(tomcat.apache.org)Onchoisitlaversioncore.tar.gz:apachetomcat5.5.26.tar.gzliendirect:http://archive.apache.org/dist/tomcat/tomcat5/v5.5.26/bin/apachetomcat5.5.26.tar.gz

Installationsurlesystmedefichiers:Dcompressezl'archivedanslerpertoire/usr/local

tar xvzf apache-tomcat-5.5.26.tar.gz /usr/local

Crezunliensymboliquevers/usr/local/apachetomcat5.5.26

ln -s /usr/local/apache-tomcat-5.5.26 /usr/local/tomcat

Configurationdel'environnement:Alafindufichier/etc/bashrcou/etc/bash.bashrc,ajoutezleslignessuivantes:

export CATALINA_HOME=/usr/local/tomcatexport PATH=$CATALINA_HOME/bin:$PATH

Crerunutilisateurtomcat.Tomcatseraensuitelancaveccetutilisateuretnonpasenroot.

adduser tomcat

Changez l'utilisateur courant en tomcat sur le rpertoire /usr/local/apachetomcat5.5.26 (Attention, lelancement de tomcat en root au lieu de tomcat change le propritaire de certains fichiers sous/usr/local/apachetomcat5.5.26enl'attribuantrootetprovoquealorsdeserreursaudmarragedeTomcatparl'utilisateurtomcatensuite).

chown -R tomcat:tomcat /usr/local/apache-tomcat-5.5.26


Changementduportdeconnexion:diterlefichierdeconfigurationserver.xml

vim /usr/local/apache-tomcat-5.5.26/conf/server.xml

Etmodifierlalignesuivantepourcoutersurleport8180(versligne94):

then echo $"Starting Tomcat..." su -l tomcat -c "(export JAVA_HOME=$JAVA_HOME; export

CATALINA_HOME=$CATALINA_HOME; export CATALINA_BASE=$CATALINA_BASE; $CATALINA_HOME/bin/startup.sh)" fi ;;

stop) if [ -f $CATALINA_HOME/bin/shutdown.sh ]; then

echo $"Stopping Tomcat..." su -l tomcat -c "(export JAVA_HOME=$JAVA_HOME; export

CATALINA_HOME=$CATALINA_HOME; export CATALINA_BASE=$CATALINA_BASE; $CATALINA_HOME/bin/shutdown.sh)" fi;;

*)

echo $"Usage: $0 {start|stop}" echo Usage : $0 "{start | stop}" ;;

esac

Rendezlescriptexcutable

chmod +x /etc/init.d/tomcat

Ajoutezlescriptausystmededmarrage:

update-rc.d tomcat defaults

3.7.InstallationdePostgreSQL(root)

Note:pouruneinstallationsousUbuntuserveur8.04oubiensousDebianLenny,laversiondePostgreSQLestla8.3

apt-get install postgresql-8.1

Changerlemotdepassedel'utilisateurpostgrescr parl'install(postgres);c'est l'administrateurdepostgresql.

passwd postgres

Lemotdepassedel'utilisateurpostgresdoittremodifigalementdanspostgresql:

su postgrespsql template1ALTER USER postgres WITH ENCRYPTED PASSWORD 'pwd1';

Laconnexionestprsentfonctionnelleavecl'utilisateurpostgres.

Ajouterunnouvelutilisateur(totodansl'exemple)avecunmotdepasseetluiattribuerledroitdecrerdesbasesdedonnes.Crervotrebase(db1dansl'exemple)enforantl'encodageUTF8etenmettantvotreutilisateurcommepropritaire:

psql


CREATE USER toto WITH ENCRYPTED PASSWORD 'pwd2'; ALTER ROLE toto WITH CREATEDB;CREATE DATABASE db1 OWNER toto ENCODING='UTF-8';\q poursortirdepsql

Notepourl'installationdephppgadminsousUbuntuserver:

apt-get install phppgadmin

Ilsepeutquepgsqlnesoitpasreconnu;rajouterdanscecaslaligneextension=pgsql.solafindufichier/etc/php5/apache2/php.inipuiscrerleliensymboliquevers/usr/share/phppgadmin:

ln -s /etc/phppgadmin/apache.conf /etc/apache2/conf.d/phppgadmin.conf

RechargerApache:

/etc/init.d/apache2 reload

Pourautoriser la connection phppgadmin via l'adresse http://IPserveur/phppgadmin, il faut modifier lefichier/etc/apache/conf.d/phppgadmin.SelonquevoussouhaitezdonnerunaccsdesposteslocauxsurvotrerseauinterneoubiendesutilisateurssurInternet,vousdevezajouterleslignessuivantes,aprslalignedenyfromall

allow from 192.168.x.x IP locales

allow from all IP internet

RelancerApache:

/etc/init.d/apache2 restart

3.8.InstallationdeGeosourceV2.2(root)

Tlcharger le fichier d'installation de geosource, nomm geosourceinstall2.20.jar" l'adressehttp://sourceforge.net/projects/geonetwork/files/G_oSource%20%20french%20only/G_oSource%202.2/geosourceinstall2.20.jar/download.Installer geosource dans le rpertoire /usr/local/geosource ( crer dans l'interface d'installation, vouspouvezutiliserunautrenomquegeosource)

java -jar /home/your_username/Desktop/geosource-install-2.2-0.jar

Suivrelesinstructionsl'cran.

3.9.InstallationdeslibrairiesXALANrequises(root)

Tlchargersurlebureaulefichierxalanj_2_7_0bin.tar.gzl'adressesuivante:http://www.apache.org/dist/xml/xalanj/binaries/xalanj_2_7_0bin.tar.gzpuisextrairel'archiveetcopierlesfichiers:


cd /home/your_username/Desktop

tar xvzf xalan-j_2_7_0-bin.tar.gzcp xalan-j_2_7_0/*.jar /usr/share/tomcat5/common/endorsed/

Supprimerlesfichiersetrpertoiressuivants:

rm -rf xalan-j_2_7_0/rm xalan-j_2_7_0-bin.tar.gzr

3.10.Changementdepropritairedesrpertoires

chown -R tomcat5 /usr/local/geosource/web*chown -R tomcat5 /var/lib/tomcat5

3.11.Miseenplacedulienentrel'applicationgeonetworkettomcat

Crerunfichierxmlpropreaucontexte,icigeonetwork.xml(cenomestobligatoire)

cd /usr/share/tomcat5/conf/Catalina/localhostvim geonetwork.xml

Ecrirelalignesuivante:

Attentionbienrespecterlasyntaxeetlacasse!

Changerlepropritairedegeonetwork.xmlsicen'estpastomcat5:

chown tomcat5:tomcat5 geonetwork.xml

Ousilegroupetomcat5n'existepas:

chown tomcat5:root geonetwork.xml

RelancerTomcat(http://127.0.0.1:8180)

/etc/init.d/tomcat5 restart

Sitomcatmanagerestinstall,onpeuts'yconnecter(cf.copied'crancidessous)aveclesidentifiantsuser: tomcat5 et mdp : mot de passe tomcat (renseign au paragraphe 3.6) puis voir dans la liste desapplicationssil'applicationgeonetworkatdployeetestdmarre(runningtrueetcommandestartdsactive).


Rappel : sur un serveur en production, il est recommand de dsinstaller l'application TomcatAdministrationetdedsinstallerouderestreindrel'accsl'applicationTomcatManager.PourdsinstallerTomcatAdministration,cliquersurlacommandeundeploycorrespondantedanslapaged'accueildeTomcatManager.SielleesttoujoursprsentedansleTomcatManager,supprimerlerpertoireadmindanslerpertoirewebappsdurpertoired'installationdetomcat.Pour restreindre l'accs l'application Tomcat Manager, par exemple uniquement pour l'ip 127.0.0.1(local),onpeututiliserlavalveRemoteAddressFilterdanslecontextdeTomcatManager

vim /usr/share/tomcat5/conf/Catalina/localhost/manager.xml

Selonlesprconisationsdevotreadministrateursystme/rseau,vouspouvezchoisirdenepluspermettred'accsauTomcatManagerenretirantlerle"manager"touslesutilisateurs:

vim/var/lib/tomcat5/conf/tomcatusers.xml


3.12.Crationdelabasededonnes

Onlancel'utilitaireGastfournidanslerpertoired'installationdegeosourceV2:

sucd /usr/local/geosource/bin./gast.sh

DansmenuDBMS,choisir PostgreSQL, puis renseigner leschampscommesuit ( remplacer par vospropresparamtres):

server:127.0.0.1port:5432base:bd1username:totopassword:pwd2

PuisBasededonnes>Cration>siuneerreur(contraintecyclique)estrencontre,refairecrationetl'erreurnedoitplusrapparaitre.

Normalement,Gastdoitavoirmodifilaconfigurationdel'applicationpourprendreencomptecettebasededonnes;levrifierdelamaniresuivante:

vim /usr/local/geosource/web/geonetwork/WEB-INF/config.xml

Vrifierl'existencedeslignessuivantes:

main-db jeeves.resources.dbms.DbmsPool

toto pwd2 org.postgresql.Driver jdbc:postgresql://127.0.0.1:5432/db1 10

Relancertomcatsouslecomptetomcatettesterl'application.

DansTomcatmanager,ondoitvoirapparaitreunelignenomme/geonetwork.Sicetteapplicationatdployecorrectement,elledoittreindiquecommefonctionnant,sontatDmarrernonsoulign(noncliquable).Cliquersur/geonetworkpourtesterl'application(http://ipduserveur:8180/geonetwork).Connexionpardfautgeosource:admin/admin

Optimisationdelammoire:Sil'applicationdoitfonctionnercestade,ilestpossibled'optimiserlagestiondelammoireparlamachinejavapourTomcatdanslefichiercatalina.sh:

vim /usr/local/apache-tomcat-5.5.26/bin/catalina.sh

ajouterlalignesuivantejusteendessousdupremierblocdecommentaires:

export JAVA_OPTS="-server -Xmx512m -Xms368m -XX:PermSize=128m


-XX:MaxPermSize=256m"

Desrglages inadaptsdecesparamtressont souvent l'originedeserreurde typeOutOfMemory /heapSpace.

Prcautionspourunserveurenproduction:accsTomcatmanager

L'accsTomcatmanagerpeutparprcaution,enplusdumotdepassedclardanslefichiertomcatusers.xml,trelimit en localoubien partird'uneadresseipparticulireenajoutantunevalvesoncontextecommececi:

Vim /usr/local/apache-tomcat-5.5.26/conf/Catalina/localhost/manager.xml

Pouraccderaumanager,tresurleserveurluimme:http://ipduserveur:8180/manager

dsactivationdesexemplesetdocsLes exemples et documentations peuvent tre dsactivs simplement en renommant le dossier/usr/local/apache-tomcat-5.5.26/webapps pluttquedelesupprimerpourlemoment.

cd /usr/local/apache-tomcat-5.5.26mv webapps webappsNotUsed

http://ipDuServeur:8080doitrenvoyerunepageblancheprsent.

connexionauserveurOnadjvuqueTomcatnedevaitpastrelancavecroot.Demmerootettomcatnedoiventpastreautorissseconnecterensshauserveur.Editer(root)lefichiersshd_config

vim /etc/ssh/sshd_config

etajouterlalignesuivante:

AllowUsers nom_du_serveur votre_nom_utilisateur

modifierlapropritdelogpourroot

PermitRootLogin no

Sauvegardezlefichieretrelancezledaemonssh:

/etc/init.d/ssh restart

3.13.ConnexionentreApacheetTomcat

Cetteconnexionpeutsefairesoitvialevirtualhost,soitvial'utilisationdumodeReverseProxyafindene


pasafficherleport8180deTomcatdansl'url.

3.13.1Utilisationduvirtualhost

Crerunfichiervirtualhostpoursite_web(lenomdevotresiteweb)danslerepertoiredessitespublis

cd /etc/apache2/sites-enabledvim site_web

etsaisirlecontenusuivant: // mettre ici l'IP de votre serveur ServerAdmin webmaster@localhost ServerName nom_du_serveur DocumentRoot /var/www/ #Options Indexes FollowSymLinks MultiViews

Options None AllowOverride None Order deny,allow allow from all # This directive allows us to have apache2's default start page # in /apache2-default/, but still have / go to the right place RedirectMatch permanent ^.*/geosource$ http://xxx.xxx.xxx.xxx:8180/geonetwork RedirectMatch permanent ^.*/site_web$ http://xxx.xxx.xxx.xxx:8180/geonetwork RedirectMatch permanent ^.*/geonetwork$ http://xxx.xxx.xxx.xxx:8180/geonetwork

Toutcequiarrivesurleport80surlamachineestgrdanscevirtualhostenrenvoyantlesdemandes/geosource, /geonetwork et /site_web vers l'adresse de l'application geosource sur cette machine soithttp://xxx.xxx.xxx.xxx:8180/geonetwork.

Cettesolutionpourlacommunicationentreapacheettomcatestprfrablel'utilisationdemodjk;l'intrtdecederniertantsagestiondelarpartitiondechargequin'estpasutiletantquevotreserveurn'estpasassaillideconnexions.

3.13.2Utilisationdumodeproxyreverse

Pourquel'applicationrpondesurleport80etnonleport8180,onpeututiliserunefonctiondereverseproxyqu'offreApache.L'utilisationduport8180poseuncertainnombredeproblmes:

L'utilisateurn'estpashabitudevoirindiquerleportdanssesURLs,leportHTTPpardfaut80tantutilisdansl'immensemajoritdescas, Prsenter un port par serveur expose inutilement l'architecture interne de l'application et de

l'infrastructure,ainsiquelesventuellestechnologiesutilises, Prsenterdemultiplesportsncessited'ouvrirautantd'accsversl'extrieurdurseaudansles

parefeuetl'urlpeutdonctrerejete.

Silaconfigurationaveclevirtualhostatprcdemmentmiseenplace,lefichiervirtualhostsite_webdoit tresupprimoudplacde/etc/apache2/sitesenabledvers/etc/apache2/sitesavailable

LemoduleproxyestinstallavecApache2.


Lacommandea2enmod(Apache2EnabledModule)permetd'activerunmoduledjinstall(prsentdansledossier/etc/apache2/modsavalaibleencrantunliendansledossier/etc/apache2/modsenabled)

a2enmod proxy

a2enmod proxy_http --proxy_ajp utilise le protocole ajp et peut tout fait tre utilis ici

Afin de valider la bonne activation du module, vrifiez que les liens symboliques /etc/apache2/modsenabled/proxy.load, /etc/apache2/modsenabled/proxy_http.load et /etc/apache2/modsenabled/proxy.confontbientcrs.

Relancerapachepourprendreencomptelemodule:

/etc/init.d/apache2 force-reload

Dans/etc/apache2/modsenabled/proxy.confajouterlessectionsLocationsuivantes:

#turning ProxyRequests on and allowing proxying from all may allow #spammers to use your proxy to send email.

ProxyRequests Off

AddDefaultCharset off Order deny,allow Deny from all #Allow from .example.com

Order deny,allow Allow from all ProxyPass http://147.99.208.243:8180/geonetwork/ ProxyPassReverse http://147.99.208.243:8180/geonetwork/




# Enable/disable the handling of HTTP/1.1 "Via:" headers. # ("Full" adds the server version; "Block" removes all outgoing Via: headers) # Set to one of: Off | On | Full | Block

ProxyVia On

Relancerapache:

/etc/init.d/apache2 restart


4Customisationdel'interface

4.1.Prsentation

Lafigurecidessousprsentel'interfacegraphiquepardfautdeGeosourceV2:

Ilestpossibledepersonnaliserlachartegraphiquedecetteinterfaceainsiquelecontenudesdiffrentespages.Nousnerentreronspasdansledtaildesimbricationsentrelesdiffrentespagesconstitutivesdusiteweb.Sivoussouhaitezavoirplusdedtailsdecetordre,nousvousconseillonsvivementdeconsulterletutorieldeStefanoGiaccol'adresse:

http://geonetworkopensource.org/documentation/workshops/workshop2006/geonetworkopensourceworkshopapril2006(rubriquetechnicalsessions).

Dans ce chapitre, nous vous indiquerons les endroits du code qu'il est ncessaire de modifier pourcustomiservotreinterfacegeosource.


4.2.Ajouterunepagedecontenu

Lebutdecettepartieestderajouterunlmentdemenuquipointeversuncontenus'affichantdanslapageprincipale.Nousallonsvoirqueladmarcheestbienmoinsaisequ'enHTMLetqu'ilnesuffitpasderajouterunsimplelien.Pourl'exemple,nousallonsrajouterunlmentmentionslgalesquipointeversunepagedescriptivedesmentionsd'utilisationdenotresiteweb.

4.2.1.Dclarationd'unservice

Il s'agit en premier lieu de dclarer un nouveau service. Ceci s'opre dans le fichier {chemind'installationdegeosource}/web/geonetwork/WEBINF/config.xml

Note : dans la suite dece document, nous utiliserons l'abrviation CIGpour chemin d'installation de geosource

Ligne303,nousallonsnousbasersurl'lmentdemenuaboutqui,commelapagementionslgalesquenoussouhaitonscrer,nepointequeversducontenudescriptif.

Lasyntaxeestdonclasuivante:

nom_du_service:nomparlequelvousappelerezcettepagedansvotrehref(lienhypertexte).

nom_de_la_page_principale:nomdublocdanslequels'afficheralecontenudcrivantlesmentionslgales.

nom_de_la_page_descriptive:nomdufichierxmlquicontientletextedescriptif.Nousverronsplusloinquelmomentilfautcrercettepage.

Dansnotreexemple,lecodeinsrprendralaformesuivante:

4.2.2.Autorisationduservice

A ce stade, il faut autoriser l'excution de ce service. Ceci se fait dans le fichier{CIG}/web/geonetwork/xml/userprofiles.xml


Ligne253,ilsuffitderajouterlalignesuivante:enprenantsoindemettrelemmenomqueprcdemment.

4.2.3.Crationdelapagedecontenu

Lecontenudescriptifdesmentionslgalesdoittreinsrdansunepageadquate,quiporteralenomattribuplushaut,iementions.xmldansnotreexemple.

Cettepagedevratreenregistredanslerpertoire{CIG}/web/loc/fr/xml.

Commetoutepagexml,elledevratrestructuredelamaniresuivante:

situdanslerpertoire{CIG}/web/geonetwork/xsl/

Ligne99,ilfautrajouterlecodesuivant:

nommantrespectivementheaderleft.jpgetheaderright.gif(solutionlaplussimple).Sivouschoisissezdelesnommerdiffremment,vousdevrezmodifierlescheminsd'accscesimagesdanslefichier:

{CIG}/web/geonetwork/xsl/banner.xsl

lignes14et17,remplacerheaderleft.jpgetheaderright.gifparlenomdevosimages.

3etape:modifierlefichier{CIG}/web/geonetwork/css/geosource.css

~ligne182 td.banner :modifielescaractresdelacellulecontenantl'imagedelabannire.Aprioriil n'estncessairedemodifierqueleparamtrecolor.

4.3.2.Modifierlemenu

Lesmodificationss'effectuentdans{CIG}/web/geonetwork/css/geosource.css

~ligne189td.bannermenu:tailleetcouleurdepolice,couleurd'arrireplan,cartement,hauteur,largeur...dubandeaudemenu.

~ ligne 200 td.bannerlogin : taille et couleur depolice, couleur d'arrireplan, cartement, hauteur,largeur...dubandeaudemenudelogin.

~ligne222a.banner:attributsdutextedemenunonactif

~ligne228a.banner:hover:attributsdutextedemenunonactifausurvoldelasouris

~ligne247span.banner:attributsdessparateursdutextedemenu

~ligne311font.banneractive:attributsdutextedemenuactif

~ligne333input.banner:attributsdutextecontenudanslecadreduformulairedeconnexion

~ligne342button.banner:attributsduboutondeconnexion

Pourcequiconcernelecontenudumenuetdelabarredeconnexion,lesmodificationss'oprentdanslefichier{CIG}/web/geonetwork/loc/fr/xml/strings.xml

Accueil:ligne408

Contact:ligne257

Liens:ligne428

Apropos:ligne267

Nomd'utilisateur:ligne696


Motdepasse:ligne547

Boutondeconnexion:ligne436etligne440

Rsultatdelapersonnalisation:

4.3.3.Modifierl'aspectdelapagecentrale

Modificationdelacouleurdepoliceprincipale:ligne14degeosource.css:attributcolordansBodyCeparamtrenemodifiepaslacouleurdetousleslmentsdelapage.

Lalargeurdusiteestdfinieparleparamtrewidth.

Dansl'ensembledudocumentgeosource.css,faireunrechercher/remplacerdescodessuivants:064377,2a628f,,0263b2et266397(bleuduplusaumoinsfonc)remplacezlespardescodesapproprisvotrechartegraphique.

Ligne488degeosource.css:div.button,button.contentpermetdemodifierl'aspectdesboutons.

Ligne93desearchform_advanced.xsl:remplacerlavaleur266397parlavtre(quicodepourlacouleurdelabordureduformulairederecherche).Danscemmefichier,ligne90,ilestpossibledemodifierlatailledutexteRecherche.

Dans{CIG}/web/geonetwork/images/geosource/modifierlesimagessuivantespourrespectervotrechartegraphique:

arrowright.gif

calendar.gif

arrowdown.gif

searchleft.gif

searchright.gif

searchbg.gif

rightarrow.gif

Lahauteurdelapageprincipale(entrelabarredemenuetlehautdupieddepage)estmodifiablelaligne28danslefichier{CIG}/web/geonetwork/xsl/main.xsl

Danscemmefichiermain.xslilestpossibledesupprimerlesliensrssetautresimagesencommentantletextedelaligne49laligne59,soitlecontenudublocfooterl.


Nepasoublierdemodifierlefichier{CIG}/web/geonetwork/xsl/res.xsl:ligne19,remplacerlechemindel'imagedubandeau(sivousavezchoisideluidonnerunnomdiffrentdeheaderleft.jpg).Fairedemmelaligne201dufichier{CIG}/web/geonetwork/xsl/banner.xsl

4.3.4.Modifierlepieddepage

Seule lapaged'accueil proposeuncontenuaupieddepage.Celuici est modifiable la ligne454destrings.xml,entrelesbalises

4.3.5.Divers

OnpeutsupprimerleIDquis'afficheenbasdelapageencommentantlaligne16dufichierpage.xsl

Dansxsl/thesaurus/thesaurusadmin.xsl, lignes57et 72, il faut changer lescodescouleurs. Idemdansxsl/contact/contactadmin.xsl, lignes73et89,etdansxsl/contact/contactsearchresults.xsl, lignes100et155.

Dansxsl/admin.xsl,lignes33,34,61,62,67,68,ilfautrajouterclass=''padded''dansl'lmentpourque les lments concerns (mtadonnes inutilises, modifier le mot de passe et modifier lesinformationsutilisateurs)soientalignsaveclerestedesitems.

Il estpossibledemodifier le logoquis'affiche gauchedesmtadonnes.Pourcela,effectuerunclicgauchesurcelogoetnoterlenomdel'image(dutype8f7743ce3ac34e6f8e70347bdf79a30f.gif).Ensuite,crerlelogodevotrechoixdanslerpertoire{CIG}/web/geonetwork/images/logosenprenantsoindeluidonnerlemmeidentifiantqueceluirelev(enpratique:encrasantlefichierexistant).

RsultatdelapersonnalisationdanslecadreduprojetCaSIF:


1 -Introduction 2 -Installation de Debian Etch2.1. Installation du systme de base Debian 2.2. Rappels sur l'arborescence des fichiers UNIX2.3. Accs votre serveur

3 -Installation de Geosource 2.2 3.1. Modifier le fichier des dpts (root)3.2. Mise jour et redmarrage (root)3.3. Synchronisation de l'heure et SSH (root)3.4. Installation de Apache2 (root)3.5. Installation du JDK 1.6 (root)3.6. Installation de Tomcat 5.5 (root)3.6.1 En mode automatique3.6.2 En mode manuel ( privilgier pour une meilleure stabilit)

3.7. Installation de PostgreSQL (root)3.8. Installation de Geosource V2.2 (root)3.9. Installation des librairies XALAN requises (root) 3.10. Changement de propritaire des rpertoires3.11.Mise en place du lien entre l'application geonetwork et tomcat3.12. Cration de la base de donnes3.13. Connexion entre Apache et Tomcat3.13.1 Utilisation du virtual host3.13.2 Utilisation du mode proxy reverse

4 -Customisation de l'interface4.1. Prsentation4.2. Ajouter une page de contenu4.2.1. Dclaration d'un service4.2.2. Autorisation du service4.2.3. Cration de la page de contenu4.2.4. Cration d'un label pour l'lment de menu4.2.5. Insertion de l'lment dans la barre de menu

4.3. Charte graphique 4.3.1. Modifier le bandeau suprieur (image)4.3.2. Modifier le menu4.3.3. Modifier l'aspect de la page centrale4.3.4. Modifier le pied de page4.3.5. Divers

install custom geosource 2.2 (1).pdf

Documents