Doc/Quickstart bm-grenoble

Configuration dans Eclipse

1. Créer un nouveau workspace /home/ctate/projet/002-bm-grenoble. Click [ OK ]
2. Cliquez sur «Open Perspective» bouton dans le coin supérieur droit d'Eclipse, Choississez la perspective «Java». Arrangez tou

Obtenir le projet bm-grenoble

1. Faites un clique-droit sur le «Package Explorer» -> New -> Project... -> SVN -> Checkout Projects from SVN, Cliques [ Next > ]
2. Choisis «Create a new repository location», cliques [ Next > ]
3. Url: svn+ssh://moorea/home/svn, cliques [ Next > ]
4. Choisis bm-grenoble -> trunk, cliques [ Next > ]
5. Choissis «Check out as a project in the workspace»
6. Project Name: bm-grenoble, cliques [ Finish ]

Obtenir le projet notix

1. Faites un clique-droit sur le «Package Explorer» -> New -> Project... -> SVN -> Checkout Projects from SVN, Cliques [ Next > ]
2. Choisis SVN svn+ssh://moorea/home/svn, cliques [ Next > ]
3. Choisis notix -> trunk, cliques [ Next > ]
4. Choissis «Check out as a project in the workspace»
5. Project Name: notix, cliques [ Finish ]
6. Changer le fichier notix/notix-2.4.2/src/build.xml

<property name="project.code" value="/projet/002-bm-grenoble/notix"/>
<property name="install.dir" value="../../../tomcat/webapps/notix"/>

1. Change le fichier {{path|notix/notix-2.4.2/src/WEB-INF/XDBConfig.xml.tmpl

<xdb-config>
	<xdb-system class="XdbXmldbExistStdl" url="localhost:8899">
		<xdb-instance name="exist" user="admin" pass="admin" default="default">
			<xdb-parameter name="create-database">true</xdb-parameter>
			<xdb-parameter name="configuration">notixstdl.xml</xdb-parameter>
			<xdb-parameter name="database-id">exist</xdb-parameter>
		</xdb-instance>
	</xdb-system>
</xdb-config>

Installer l'application Apache Tomcat 6

1. Télécharge un nouveau tomcat6 de http://apache.crihan.fr/dist/tomcat/tomcat-6/v6.0.36/bin/apache-tomcat-6.0.36.zip à /home/ctate/projet/002-bm-grenoble/tomcat
2. Dans tomcat/conf/server.xml, ajouter une attribute comme ceci:
   1. <Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" emptySessionPath="true" />
   2. <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" emptySessionPath="true" maxThreads="100" />
3. Dans Eclipse , cliquez-droit sur «Package Explorer» -> New -> Project... -> Java Project, Cliquez [ Next > ]
4. Project name: tomcat
5. Cliquez [ No ] si il demande pour supprimer les resources dans tomcat/bin
6. supprimez tous les dossiers du chemin de compilation qui n'ont pas de sens par un clic droit sur ​​eux et choisir «Remove from Build Path» comme (webapps/docs/appdev/sample/src)
7. Default output folder: tomcat/output
8. Cliquez [ Finish ]

chmod u+x tomcat/bin/*.sh

Installer eXist-db

1. Télécharge le plus nouveau fichier .jar d'ici http://exist-db.org/exist/download.xml, installer avec la commande: java -jar eXist-setup-1.4.2-rev16251.jar
2. Cliques [ Next ]
3. JDK Path: /usr/lib/jvm/jdk1.6.0_34/, cliques [ Next ]
4. Installation path: /home/ctate/projet/002-bm-grenoble/exist, cliques [ Next ]
5. Data Dir: /home/ctate/projet/002-bm-grenoble/exist/webapp/WEB-INF/data, entrez un mot de passe «admin», cliquez [ Next ]
6. Confirmer repertoire, Cliquez [ OK ]
7. Cliquez [ Next ]
8. Cliquez [ Next ]
9. Cliquez [ Next ]
10. Cliquez [ Next ]
11. Cliquez [ Quit ]
12. Dans Eclipse , cliquez-droit sur «Package Explorer» -> New -> Project... -> Java Project, Cliquez [ Next > ]
13. Project name: exist
14. Cliquez [ Next > ]
15. Default output folder: exist/output
16. Cliquez [ Finish ]
17. Cliquez droit sur le projet dans «Project Explorer» -> Properties
18. supprimez tous les dossiers du chemin de compilation qui n'ont pas de sens par un clic droit sur ​​eux et choisir «Remove from Build Path» sauf que src
19. Dans l '«Order and Export» onglet, mettez «JRE System Library» en haut
20. Cliquez [ Finish ]
21. Changer le «uri» preperty dans le fichier exist/client.properties

uri=xmldb:exist://localhost:8899/exist/xmlrpc

1. Dans le fichier exist/tools/jetty/etc/jetty.xml, changer chaque instance de «8080» à «8899» et «8443» à «8843»

Restaurer une copie de bm-grenoble-prod

Le webapp

1. Etrait une copie dump du webapp (webapp.tar.gz peut-être) dans le workspace /home/ctate/projet/002-bm-grenoble
2. Changer le fichier bm-grenoble-prod/build.xml

<property name="project.code" value="/projet/002-bm-grenoble/bm-grenoble-prod"/>
<property name="install.dir" value="../tomcat/webapps/bm-grenoble"/>
<property name="notix.src.dir" value="../notix/src"/>

1. Change le fichier bm-grenoble-prod/bm-grenoble.properties

install.dir=../tomcat/webapps/bm-grenoble
notix.src.dir=../notix/src

1. Change le fichier bm-grenoble-prod/WEB-INF/XDBConfig.xml

<xdb-config>
	<xdb-system class="XdbXmldbExistStdl" url="localhost:8899">
		<xdb-instance name="exist" user="admin" pass="admin" default="default">
			<xdb-parameter name="create-database">true</xdb-parameter>
			<xdb-parameter name="configuration">notixstdl.xml</xdb-parameter>
			<xdb-parameter name="database-id">bm-grenoble</xdb-parameter>
		</xdb-instance>
	</xdb-system>
</xdb-config>

1. Copier les images du dump dans un repertoire /home/ctate/projet/002-bm-grenoble/images
2. Change le fichier bm-grenoble-prod/WEB-INF/properties/notix-plus.properties

pleade.img-server.racines=/home/ctate/projet/002-bm-grenoble/images
pleade.img-server.racines.vignettes=/home/ctate/projet/002-bm-grenoble/images
pleade.img-server.racines.default=/home/ctate/projet/002-bm-grenoble/images
pleade.media-server.racines=/home/ctate/projet/002-bm-grenoble/images

La base de données

1. Trouver une copie dump de la base de données (exist.tar.gz peut-être) et l'extraire
2. Utilisez le client eXist pour mettre le dump dans eXist:

java -Dexist.home=exist -jar exist/start.jar client

1. Nom d'utilisateur: admin
2. Mot de passe: admin
3. URL: xmldb:exist://localhost:8899/exist/xmlrpc, Cliquez [ OK ]
4. Outils -> Restaurer une copie de sauvegarde
5. Trouver la copie dump de la base de données que vous avez extrait, cliquez [ Select backup file for restore ]
6. Mot de passe: admin

Générer le projet

# Installer notix
cd notix/notix-2.4.2/src
ant install
cd ../../..

# Installer bm-grenoble
cd bm-grenoble-prod
ant install
cd ..

Démarrer le projet

# Démarrer eXist
export JAVA_OPTIONS="-Xmx300m -Djava.awt.headless=true -Dfile.encoding=UTF-8"
exist/bin/startup.sh &
export JAVA_OPTIONS=

# Démarrer Tomcat
export JPDA_ADDRESS=8000
export JPDA_TRANSPORT=dt_socket
export CATALINA_PID=tomcat/bin/catalina.pid
export JAVA_OPTS="-Xms400m -Xmx1000m -Djava.awt.headless=true -server"
tomcat/bin/catalina.sh jpda start
export JPDA_ADDRESS=
export JPDA_TRANSPORT=
export CATALINA_PID=
export JAVA_OPTS=

Éteindre le projet

# Éteindre Tomcat
export CATALINA_PID=tomcat/bin/catalina.pid
tomcat/bin/catalina.sh jpda stop -force

# Éteindre eXist
java -Dexist.home=exist -jar exist/start.jar shutdown --uri=xmldb:exist://localhost:8899/exist/xmlrpc --password=admin

Utiliser Notix

1. D'abord visitez http://localhost:8080/notix/admin pour créer l'utilisateur admin
2. Visitez http://localhost:8080/bm-grenoble

Informations intéressantes

1. Le query sdxall:1 va montrer tous les resultats.
2. L'indexation des elements «Bmgauteur» sont misent dans un dossier: tomcat/webapps/bm-grenoble/recherche/conf/dbs/Bmgauteur/sdx-search-index/main
3. Chaque page avec le regexp pattern de (.*/)?(.*)\.html (voir notix.xmap)
   1. est premierement généré par recherche/sdxapp.xmap par un élément <map:match pattern="*/*.xhtml">
   2. qui est généré par <map:generate type="xsp" src="xsp/document.xsp"> ... <map:parameter name="notice" value="cocoon://{1}/{2}.xht"/>
   3. qui est transformé par <map:when test="xht"> ... <map:transform src="xsl/local-notice.xsl"> dans exist/xmldb.xmap
   4. qui est généré par <map:part element="notice" src="cocoon:/{1}/{2}.xml"/>
   5. qui est généré par <map:match pattern="*/*.xml">
   6. qui vient de la base de données eXist
4. Pour voir les chemins vers XML d'eXiste, mettre un breakpoint sur ligne 218 de XDBSource.java
5. Le site de teste bm-grenoble Notix est: http://delphinum.bm-grenoble.fr/bm-grenoble/admin/login.html
   1. Utilisateur: admin
   2. Mot de passe: notix38
6. Le site de teste bm-grenoble Pleade est: http://bm-grenoble-pleade.ajlsm.com
7. L'indexation commence avec l'URL comme admin/indexation.html
   1. Qui est gérer dans exist/admin.xmap
   2. Qui est construit par exist/xsp/sdx-alim.xsp
   3. Le methode resolveLinks de sdx-alim.xsp mettre des éléments lié au champ
   4. Le fichier resolve-linked-fields.xsl mettre des éléments lié au champ dans le XML Notix
8. La methode add dans SDXDocumentBase.java est ou les documents sont misent dans l'index
9. Ligne 726 dans LuceneDocumentBase.java dans sdx-ajlsm est où les Field SDX sont remplis
10. La methode getIndexationDocument dans LuceneDocumentBase.java est ou les documents Lucene sont remplissent par le XML Notix
11. Pour l'Edition des Notices, regardez rdfs2display.xsl, <xsl:template match="rdf:Property" mode="required">
12. Les liens vers le modification d'un notice
    1. va premièrement vers ecriture.xmap <map:when test="editer">
    2. <map:call function="notixForm">
    3. le function notixForm() dans notix.js
       1. le var form: http://localhost:8080/bm-grenoble/Bmg/cforms/form.xml
       2. le var form.binding: http://localhost:8080/bm-grenoble/Bmg/cforms/binding.xml
13. Pour faire un dump sur prod:
    1. sudo /opt/eXist-pprod-home/bin/backup.sh -u admin -p admin -d /home/fpn/webapps/dump-bmg-notix-20121212 -b /db -ouri=xmldb:exist://localhost:8899/exist/xmlrpc