forked from pentaho/mondrian
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathinstall_fr.html
1089 lines (749 loc) · 33 KB
/
install_fr.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<!--
== This software is subject to the terms of the Eclipse Public License v1.0
== Agreement, available at the following URL:
== http://www.eclipse.org/legal/epl-v10.html.
== You must accept the terms of that agreement to use this software.
==
== Copyright (C) 2001-2005 Julian Hyde
== Copyright (C) 2005-2007 Pentaho and others
== All Rights Reserved.
-->
<link rel="stylesheet" type="text/css" href="stylesheet.css">
<title>Pentaho Analysis Services: How to Install Mondrian</title>
</head>
<body class="contentrightmargin">
<!-- doc2web start -->
<!-- page title -->
<div class="contentheading">Comment installer Mondrian</div>
<!-- end page title -->
<hr noshade="noshade" size="1">
<ol>
<li><a href="#1_Introduction">Introduction</a></li>
<li><a href="#2_Set_up_test_data">Installer les
données test avec une base de données non
embarquée</a>
<ol>
<li><a href="#2_1_Microsoft_Access">Microsoft
Access</a></li>
<li><a href="#2_2_Non_Access_setup">Autre Base
de données</a></li>
</ol>
</li>
<li><a href="#3_Deploy_and_run_the_web_app">Déployer
et exécuter une application web avec une base de
données non embarquée</a></li>
<li><a href="#4_Deploy_and_run_the_embedded_web_app">Déployer
et exécuter une application web avec la base de test
embarquée</a> </li>
<li><a href="#5_How_to_configure_Mondrian_as_an_XMLA_provider">Comment
configurer Mondrian comme fournisseur de XML/A</a>
<ol>
<li><a href="#5_1_Describe_the_data_sources_in_datasources.xml">Décrire
les sources de données dans <code>datasources.xml</code></a></li>
<li><a href="#5_2_Configure_XmlaServlet_in_your_web.xml">Configurer
<code> XmlaServlet</code> dans votre <code>web.xml</code></a></li>
</ol>
</li>
<li><a href="#6_Miscellaneous">Divers</a></li>
<ol>
<li><a href="install.html#6_1_mondrian_properties">Configurer
<code>mondrian.properties</code></a></li>
<li><a href="#6_2_Cache_setup">Installation du
système de mémoire Cache</a></li>
</ol>
<li><a href="#7_Database_compatibility">Compatibilité
des Bases de données</a></li>
<li><a href="#8_Compatibility_issues">Problèmes
de compatibilité</a></li>
<ol>
<li><a href="#8_1_Weblogic_6_1_and_Xerces">Weblogic
6.1 et Xerces</a></li>
<li><a href="#8_2_Xalan_and_Tomcat">Xalan et
Tomcat</a></li>
<li><a href="#8_3_Log4j_and_Tomcat">Log4j et
Tomcat</a></li>
</ol>
</ol>
<h2>1. Introduction<a name="1_Introduction"></a></h2>
<p>Le noyau de Mondrian est un fichier JAR qui agit comme un
pilote "JDBC pour OLAP":
il fournit des connexions aux bases de données
relationnelles sous-jacentes et exécute les instructions
SQL. Ce paquet se conduit comme une interface avec ces bases de
données. Le programme Mondrian peut être
livré :</p>
<ol>
<li>comme une librairie WAR incluant JPivot, un environnement
de travail web OLAP et des données exemple pouvant
être chargées dans la base de données
de
votre choix.</li>
<li>comme une librairie WAR, incluant JPivot et une base de
données <b>embarquée</b>
Derby, ce qui ne demandera aucune installation
supplémentaire pour déployer cette librairie avec
un serveur d'application web. </li>
</ol>
<p>Les deux distributions contiennent les programmes sources
Mondrian. Tous les fichiers JARs
nécessaires à Mondrian sont contenus dans
l'archive WAR du répertoire /WEB-INF/lib.</p>
<p>Voici comment installer la distribution:</p>
<ol>
<li>Installer le Java SDK (1.4.2 ou supérieur).</li>
<li>Télécharger la dernière
version <code>mondrian-<i>version</i>.zip</code>
depuis <a href="http://sourceforge.net/projects/mondrian">SourceForge</a>,
et décompressez-la.</li>
<li>Pour la distribution non embarquée, installer le
jeu de données "FoodMart", comme décrit dans
la <a href="#2_Set_up_test_data">section 2</a>.</li>
<li>Installer et démarrer l'application web, comme
décrit dans la <a href="#3_Deploy_and_run_the_web_app">section
3 ou 4</a>.</li>
</ol>
<p>Si vous êtes un développeur Mondrian, il
y a des instructions supplémentaires pour accéder
au serveur des programmes sources (Perforce) et compiler le code
dans <a href="developer.html">le guide du
développeur</a>.</p>
<h2>2. <a name="2_Set_up_test_data">Installer
les données test avec une base de données non
embarquée</a></h2>
<p>La base de données test 'FoodMart' fait partie de
la distribution non-embarquée. Elle est livrée
sous deux formats: une base Microsoft Access
(<code>demo/access/MondrianFoodMart.mdb</code>) et un
script SQL pour insérer les tables au sein de votre base de
données (<code>demo/FoodMartCreateData.sql</code>).</p>
<p>Sous windows, utiliser la base de
données Access
est l'installation la plus facile, parce que vous avez juste besoin de
définir une source de données ODBC. Si vous
voulez tester une base de données autre qu'Access ou si vous
n'êtes pas dans un environnement Windwos, vous aurez
à créer votre propre base de données
vierge et aurez à charger cette base de données
avec l'utilitaire
MondrianFoodMartLoader.</p>
<h3>2.1. Microsoft Access<a name="2_1_Microsoft_Access"></a></h3>
<p>Si vous utilisez Windows, Microsoft Access est la
base de données la plus facile à utiliser comme
base de données test. Vous avez juste besoin d'installer une
source de données ODBC pour la base test.</p>
<p>La base test a besoin d'être
accédée si vous ne testez que l'accès
à cette base, ou elle devra être
chargée dans une autre base.</p>
<p>Dans le menu 'Outils d'administration', cliquez sur l'item
'Sources de données
(ODBC)' pour ouvrir la boîte d'administration des sources de
données ODBC.
Ensuite, créez un DSN Système appelé <code>MondrianFoodMart</code>
pointant sur
<code><i>MONDRIAN_HOME</i>/demo/access/MondrianFoodMart.mdb</code>.
(Cela permettra à Mondrian d'accéder
à la source de données en utilisant la
chaîne de connexion "<code>jdbc:odbc:MondrianFoodMart</code>".</p>
<h3>2.2. Autres bases de données<a name="2_2_Non_Access_setup"></a></h3>
<p>Si vous n'utilisez pas Access, utilisez l'utilitaire
MondrianFoodMartLoader pour créer une base de
données et charger les données avec le script SQL.</p>
<h4>Syntaxe</h4>
<blockquote> <code>MondrianFoodMartLoader<br>
[-verbose] [-tables] [-data] [-indexes]<br>
-jdbcDrivers=<jdbcDrivers><br>
-outputJdbcURL=<jdbcURL><br>
[ [ [-outputJdbcUser=user]
[-outputJdbcPassword=password] [-outputJdbcBatchSize=<batch
size>] ]<br>
| -outputDirectory=<directory
name><br>
]<br>
[ [-inputJdbcURL=<jdbcURL>
[-inputJdbcUser=user] [-inputJdbcPassword=password] ]<br>
| [-inputFile=<file name>]<br>
]</code>
</blockquote>
<h4>Options</h4>
<table style="border-color: rgb(0, 0, 0); text-align: left; margin-left: 10px; margin-right: 10px;" border="1" cellpadding="2" cellspacing="0">
<tbody>
<tr>
<td style="vertical-align: top; text-align: center;">
<b>Option</b></td>
<td style="vertical-align: top; text-align: center;">
<b>Description</b></td>
</tr>
<tr>
<td style="vertical-align: top;"><code>-verbose</code></td>
<td style="vertical-align: top;">mode verbeux.</td>
</tr>
<tr>
<td style="vertical-align: top;"><code>-tables</code></td>
<td style="vertical-align: top;">Crée les
tables dans la sortie JDBC, ou génère
une instruction CREATE TABLE dans le répertoire de sortie
pour toutes les tables FoodMart, de façon
appropriée pour le type de votre base de données.
Si cela est non précisé, les tables sont
considérées comme déjà
existantes et elles seront tout d'abor supprimées.</td>
</tr>
<tr>
<td style="vertical-align: top;"><code>-data</code></td>
<td style="vertical-align: top;">Charge les
données depuis l'entrée (JDBC,
fichier d'instruction d'insertion) vers la sortie (JDBC, fichier
d'instruction d'insertion). Toutes les données existantes
seront tout d'abord supprimées.</td>
</tr>
<tr>
<td style="vertical-align: top;"><code>-indexes</code></td>
<td style="vertical-align: top;">Crée les
index dans la sortie JDBC,
ou génère une instruction CREATE INDEX dans le
répertoire de sortie pour toutes les tables
FoodMart, de façon appropriée pour le
type de votre base de données.</td>
</tr>
<tr>
<td style="vertical-align: top;"><code>-jdbcDrivers=</code><i><code><driver
list></code></i></td>
<td style="vertical-align: top;">liste de pilotes
séparée par des virgules nécessaire
pour se connecter à la base de données source et
cible. Les fichiers JAR
contenant ces pilotes doivent également se trouver dans
le classpath (l'option <code>-cp</code>
dans la commande <code>java</code> ).</td>
</tr>
<tr>
<td style="vertical-align: top;" nowrap="nowrap"><code>-outputJdbcURL<i>=<jdbcURL></i></code></td>
<td style="vertical-align: top;">
<p>Url JDBC pour la base de données cible</p>
</td>
</tr>
<tr>
<td style="vertical-align: top;"><code>-outputJdbcUser=<i><user></i></code></td>
<td style="vertical-align: top;">Utilisateur pour la
base de données cible</td>
</tr>
<tr>
<td style="vertical-align: top;"><code>-outputJdbcPassword=<i><password></i></code></td>
<td style="vertical-align: top;">Mot de passe pour
la base de données cible</td>
</tr>
<tr>
<td style="vertical-align: top;" nowrap="nowrap"><code>-outputDirectory=<i><directory
name></i></code></td>
<td style="vertical-align: top;">Optionnel.
Répertoire dans lequel se trouvera le script de
création de la base de données. Les instructions
SQL seront dans le format du type de base de données
spécifié par l'option outputJdbcURL.</td>
</tr>
<tr>
<td style="vertical-align: top;"><code>-outputJdbcBatchSize=<i><batch
size></i></code></td>
<td style="vertical-align: top;">Taille du lot pour
les instruction INSERT. Par défaut à 50. Si mis
à la valeur 1, la fonction lot (batch) JDBC n'est
pas utilisée.</td>
</tr>
<tr>
<td style="vertical-align: top;" nowrap="nowrap"><code>-inputJdbcURL=<i><jdbcURL></i></code></td>
<td style="vertical-align: top;">Url JDBC pour la
base de données source</td>
</tr>
<tr>
<td style="vertical-align: top;"><code>-inputJdbcUser=<i><user></i></code></td>
<td style="vertical-align: top;">Utilisateur pour la
base de données source</td>
</tr>
<tr>
<td style="vertical-align: top;"><code>-inputJdbcPassword=<i><password></i></code></td>
<td style="vertical-align: top;">Mot de passe pour
la base de données source</td>
</tr>
<tr>
<td style="vertical-align: top;"><code>-inputFile=<i><file
name></i></code></td>
<td style="vertical-align: top;">Optionnel. Si aucun
paramètre n'est donné pour la base de
données source, les données sont
censées provenir du fichier passé en argument.</td>
</tr>
</tbody>
</table>
<p>La source usuelle pour
l'utilitaire MondrianFoodMartLoader est un script SQL (<code>[-inputFile=<file
name>]</code>). Cependant, si vous avez
déjà chargé les données au
sein d'une source de données JDBC (par exemple Microsoft
Access), utilisez l'option <code>
-inputJdbcURL</code> et les autres options en relation avec
celle-ci pour accéder à une autre base de
donées
JDBC.</p>
<p>Le chargeur utilise le standard J2SE JDBC, le
pilote JDBC approprié pour les fichiers JARs,
et quelques classes externes à Mondrian qui ne sont pas
attachées à des fichiers additionnel JARs.
Tout cela a été testé
avec Oracle, Postgres, MySQL et Microsoft Access.</p>
<p>Si votre base de données cible est une base de
données JDBC, vous devez créer en premier lieu la
base de données et le schéma des tables. Cela
doit être une base de données
spécifique au jeu de test.</p>
<p>Vous pouvez en toute sécurité ignorer
ces avertissements log4j:</p>
<blockquote> <code>log4j:WARN No appenders could be found
for logger
(mondrian.rolap.RolapUtil). <br>
log4j:WARN Please initialize the log4j system properly.</code>
</blockquote>
<h4>Exemples</h4>
<p>Vous trouverez ci-dessous quelques exemples pour vous donner
une idée générale de comment
<code>MondrianFoodMartLoader</code> est
invoqué. La ligne de commande que vous utiliserez
dépendra bien sûr de votre environnement, de votre
base de données source et cible.</p>
<h5>Exemple 1. Chargement dans MySQL depuis un fichier
sous Linux</h5>
<p>L'exemple suivant est une ligne de commande linux pour
créer une base MySQL appelée
'foodmart', puis créer les tables
FoodMart depuis le jeu de données inclus dans le script SQL.
En premier lieu, on crée une base de données <code>foodmart</code>
et un utilisateur <code>foodmart</code> :</p>
<blockquote> <code><i><b>$</b></i>
mysqladmin create foodmart<b><i><br>
$</i></b> mysql<b><br>
<i>mysql></i> grant all privileges on *.* to
'foodmart'@'localhost' identified by 'foodmart';<br>
<i>Query OK, 0 rows affected (0.00 sec)<br>
<br>
mysql> </i></b>quit<b><i><br>
Bye</i></b></code>
</blockquote>
<p>Puis on charge les données:</p>
<blockquote> <code><b><i>$</i></b>java
-cp
"/mondrian/lib/mondrian.jar:/mondrian/lib/log4j-1.2.9.jar:/mondrian/lib/eigenbase-xom.jar:/mondrian/lib/eigenbase-resgen.jar:/mondrian/lib/eigenbase-properties.jar:/usr/local/mysql/mysql-connector-java-3.0.16-ga-bin.jar"<br>
mondrian.test.loader.MondrianFoodMartLoader<br>
-verbose -tables -data -indexes<br>
-jdbcDrivers=com.mysql.jdbc.Driver<br>
-inputFile=/mondrian/demo/FoodMartCreateData.sql <br>
-outputJdbcURL="jdbc:mysql://localhost/foodmart?user=foodmart&password=foodmart"</code>
</blockquote>
<h5>Exemple 2. Chargement dans PostgreSQL
depuis Access sous Windows</h5>
<p>L'exemple suivant est une ligne de commande windows pour
créer les tables FoodMart dans une
base PostgreSQL depuis le jeu de test de la
base Access:</p>
<blockquote> <code><i><b>C:\mondrian></b></i>
java -cp
"C:\mondrian\lib\mondrian.jar;C:\mondrian\lib\log4j-1.2.9.jar;
C:\mondrian\lib\eigenbase-xom.jar;
C:\mondrian\lib\eigenbase-resgen.jar;
C:\mondrian\lib\eigenbase-properties.jar;
C:\mondrian\lib\postgres-jdbc.jar"<br>
mondrian.test.loader.MondrianFoodMartLoader<br>
-verbose -tables -data -indexes<br>
-jdbcDrivers="org.postgresql.Driver,sun.jdbc.odbc.JdbcOdbcDriver"<br>
-inputJdbcURL="jdbc:odbc:MondrianFoodMart"<br>
-outputJdbcURL="jdbc:postgresql://localhost/foodmart"<br>
-outputJdbcUser=postgres<br>
-outputJdbcPassword=password</code>
</blockquote>
<h2>3. Déployer and exécuter une
application web avec une base de données non
embarquée<a name="3_Deploy_and_run_the_web_app"> </a></h2>
<ol>
<li>Installer Tomcat (version 5.0.25 ou supérieure).</li>
<li>Depuis la distribution décompressée,
décompresser <code>lib/mondrian.war</code>
dans le répertoire <code><i>TOMCAT_HOME</i>/webapps/mondrian</code></li>
<li>Ouvrir le fichier mondrian.properties dans le
répertoire <code><i>TOMCAT_HOME</i>/webapps/mondrian</code>
et personnalisez-le <code>mondrian.jdbcDrivers</code>
en fonction de la base de données utilisée.</li>
<li>Ouvrir le fichier web.xml dans le
répertoire <code><i>TOMCAT_HOME</i>/webapps/mondrian/WEB-INF</code>
et personnalisez-le avec les deux chaînes de connexion que
vous avez utilisées pour la base de données test.
Cela:
<blockquote> <code>Provider=mondrian;Jdbc=jdbc:odbc:MondrianFoodMart;Catalog=/WEB-INF/queries/FoodMart.xml;JdbcDrivers=sun.jdbc.odbc.JdbcOdbcDriver;</code>
</blockquote>
devient
<blockquote> <code>Provider=mondrian;Jdbc=jdbc:mysql://localhost/foodmart?user=foodmart&#38;password=foodmart;Catalog=/WEB-INF/queries/FoodMart.xml;JdbcDrivers=com.mysql.jdbc.Driver;</code>
</blockquote>
</li>
<li>Modifier le fichier <code>fourheir.jsp</code>,
<code>mondrian.jsp</code>, <code>colors.jsp</code>
ainsi que le fichier <code>arrows.jsp </code>dans le
répertoire <code><i>TOMCAT_HOME</i>/webapps/mondrian/WEB-INF/queries</code>.
Modifier les lignes
<blockquote><code><jp:mondrianQuery id="query01"
jdbcDriver="sun.jdbc.odbc.JdbcOdbcDriver"
jdbcUrl="jdbc:odbc:MondrianFoodMart"
catalogUri="/WEB-INF/queries/FoodMart.xml"></code> </blockquote>
<p>avec les paramètres de votre base de
données FoodMart database. Pour MySQL, cela donnera quelque
chose du genre: </p>
<blockquote><code><jp:mondrianQuery id="query01"
jdbcDriver="com.mysql.jdbc.Driver"
jdbcUrl="jdbc:mysql://localhost/foodmart?user=foodmart&password=foodmart"
catalogUri="/WEB-INF/queries/FoodMart.xml"></code> </blockquote>
<p></p>
</li>
<li>Copier les fichiers suivants:
<ul>
<li>Si besoin, copier votre pilote JDBC (fichier
JARà dans le répertoire <code>TOMCAT_HOME/common/endorsed</code></li>
<li>Copier le fichier <code>xalan.jar</code>
dans le répertoire <code><i>TOMCAT_HOME</i>/common/endorsed</code></li>
</ul>
</li>
<li>Démarrer votre base de données, si
besoin.</li>
<li>Cliquer sur <a href="http://localhost:8080/mondrian" target="_new">http://localhost:8080/mondrian</a>.</li>
</ol>
<h2>4. Déployer et exécuter l'application
web avec une base de données embarquée<a name="4_Deploy_and_run_the_embedded_web_app"> </a></h2>
<ol>
<li>Depuis la distribution décompressée,
décompresser <code>lib/mondrian-embedded.war</code>
dans le répertoire <code><i>TOMCAT_HOME</i>/webapps/mondrian-embedded</code></li>
<li>Démarrer Tomcat</li>
<li>Cliquer sur <a href="http://localhost:8080/mondrian-embedded" target="_new">http://localhost:8080/mondrian-embedded</a></li>
</ol>
<h2>5. Comment configurer Mondrian comme un fournisseur
XML/A<a name="5_How_to_configure_Mondrian_as_an_XMLA_provider"> </a></h2>
<p>Pour installer le service XMLA service, suivez les
étapes suivantes.</p>
<h3>1. Décrire les sources de données dans <code>datasources.xml</code><a name="5_1_Describe_the_data_sources_in_datasources.xml"> </a></h3>
<p>Dans le répertoire WEB-INF de votre webapp,
créer un fichier <code>datasources.xml</code>,
avec un contenu comme celui-ci:</p>
<blockquote> <code><?xml version="1.0"?><br>
<DataSources><br>
<DataSource><br>
<DataSourceName>MondrianFoodMart</DataSourceName><br>
<DataSourceDescription>FoodMart 2000 Data
Warehouse From MS Analysis
Services</DataSourceDescription><br>
<URL>http://localhost:8080/mondrian/xmla</URL><br>
<DataSourceInfo>Provider=mondrian;
Jdbc=jdbc:odbc:MondrianFoodMart;
JdbcDrivers=sun.jdbc.odbc.JdbcOdbcDriver</DataSourceInfo><br>
<ProviderType>MDP</ProviderType><br>
<AuthenticationMode>Unauthenticated</AuthenticationMode><br>
<Catalogs><br>
<Catalog name="FoodMart"><br>
<Definition>/WEB-INF/schema/FoodMart.xml</Definition><br>
</Catalog><br>
<Catalog name="Marketing"><br>
<DataSourceInfo>Provider=mondrian;
Jdbc=jdbc:odbc:MarketingDB;
JdbcDrivers=sun.jdbc.odbc.JdbcOdbcDriver</DataSourceInfo><br>
<Definition>/WEB-INF/schema/Marketing.xml</Definition><br>
</Catalog><br>
</Catalogs><br>
</DataSource><br>
<br>
<DataSource><br>
<DataSourceName>PostgreSQLTest</DataSourceName><br>
<DataSourceDescription>Test Data Warehouse On
PostgreSQL</DataSourceDescription><br>
<URL>http://localhost:8080/mondrian/xmla</URL><br>
<DataSourceInfo>Provider=mondrian;
Jdbc=jdbc:postgresql://localhost/olap;
JdbcDrivers=org.postgresql.Driver; JdbcUser=pgsql;
JdbcPassword=pgsql</DataSourceInfo><br>
<ProviderName>Mondrian</ProviderName><br>
<ProviderType>MDP</ProviderType><br>
<AuthenticationMode>Unauthenticated</AuthenticationMode><br>
<Catalogs><br>
<Catalog name="Test"><br>
<Definition>/WEB-INF/schema/TestPgsql.xml</Definition><br>
<Catalog><br>
</Catalogs><br>
</DataSource><br>
</DataSources></code>
</blockquote>
<p>
<code><ProviderType></code> et <code><AuthenticationMode></code>
sont ignorés carl'implémentation XML/A ne
supporte pas encore 'MDP' et 'Unauthenticated'.</p>
<h4>Sources de données et catalogues multiples</h4>
<p>Si vous avez l'intention d'utiliser Mondrian avec la librairie
du client Microsoft ADOMD.NETou <a href="http://www.simba.com/Technologies/odbotoxmla.htm">Simba's
O2X bridge</a>, les fichiers des sources de données
doivent avoir un seul élément <code><DataSource></code>.
Ces clients ne prendront en compte qu'une seule base de
données. Les autres clients, comme
<a href="http://sourceforge.net/projects/whex">Rex</a>,
fonctionne parfaitement avec des bases de données multiples.</p>
<p>Veuillez noter que chaque catalogue posède
un attribut nom, et l'URI (répertoire) d'un
fichier XML. Le nom du catalogue doit correspondre
à l'attribut utilisé dans le fichier XML (par
exemple <code><Schema name="FoodMart"></code>).</p>
<p>Que vous utilisiez une ou plusieurs sources de
données, les catalogues dans le fichier <code>datasources.xml</code>
doivent avoir un nom unique.</p>
<h3>5.2. Configurer XmlaServlet dans votre <code>web.xml</code><a name="5_2_Configure_XmlaServlet_in_your_web.xml"> </a></h3>
<p>Par exemple:</p>
<blockquote> <code><servlet><br>
<servlet-name>MondrianXmlaServlet</servlet-name><br>
<servlet-class>mondrian.xmla.impl.DefaultXmlaServlet</servlet-class><br>
</servlet></code>
</blockquote>
<h2>6. Divers<a name="6_Miscellaneous"> </a></h2>
<h3>6.1. Configurer <code>mondrian.properties</code><a name="6_1_mondrian_properties"> </a></h3>
<p>Les propriétés sont décrites
dans le <a href="configuration.html">Guide
de Configuration</a>.</p>
<h3>6.2. Installation de la mémpoire Cache<a name="6_2_Cache_setup"> </a></h3>
<p>Vous aurez besoin de préciser la
quantité de mémoire autorisée pour le
cache en utilisant l'option -Xms de la machine virtuelle Java, par
exemple -Xms256m pour 256 megs de mémoire of ram
pour la machine virtuelle Java.</p>
<h2>7. Compatibilité des bases de données<a name="7_Database_compatibility"> </a></h2>
<p>Mondrian fonctionne avec les bases de données
suivantes:</p>
<ol>
<li>Apache Derby (connu sous le nom de Cloudscape)</li>
<li>Firebird</li>
<li>hsqldb</li>
<li>IBM DB2</li>
<li>Informix</li>
<li>Ingres</li>
<li>Interbase</li>
<li>LucidDB</li>
<li>Microsoft Access</li>
<li>Microsoft SQL Server</li>
<li>MySQL</li>
<li>NuoDB</li>
<li>Oracle</li>
<li>PostgreSQL</li>
<li>Sybase</li>
<li>Teradata</li>
</ol>
<p>Mondrian peut fonctionner avec la plupart des sources de
données JDBC, même si votre base de
données n'apparaît pas dans la liste ci-dessus,
vous devriez essayer. Mondrian peut généralement
le SQL en conséquence.</p>
<p>Si vous vous apercevez que Mondrian fonctionne avec
une autre base de données, faites le nous savoir. Dites nous
quel pilote vous utilisez, la version de votre base de
données, les paramètres utilisés et
tout ce dont vous avez eu besoin.</p>
<h3>Trucs généraux sur les bases de
données</h3>
<p>Pour des exemples de chaînes de connexion, regardez
dans le fichier
<code><a href="http://p4web.eigenbase.org/open/mondrian/mondrian.properties">mondrian.properties</a></code>.
Il s'y trouve des exemple de chaînes de connexion pour la
plupart des bases de données citées.</p>
<h3>Ingres</h3>
<p>Andy Grimm écrit:</p>
<blockquote>
<p>En plus, j'ai du exécuter la commande perl
suivante<br>
<br>
> <code>perl -pi -e "s/:00\.0/:00/g"
FoodMartCreateData.sql</code><br>
<br>
Cela a permis que le format des dates soit une date valide en enlevant
le ".0" pour chacun des timestamp. Notre prochaine version supportera
timestamps. Ceci est donc un truc pour une durée
brève.</p>
</blockquote>
<h3> </h3>
<h3>Sybase</h3>
<p><a href="http://forums.pentaho.com/showthread.php?t=47918">mizar_sf
écrit</a>:</p>
<blockquote>
<p>J'ai essayé plusieurs voies pour utiliser
Mondrian (version 2.1RC) connecté avec un serveur de base de
données base Sybase ASE [version 12.5]. Finalement, j'ai
trouvé cette solution:</p>
<ul>
<li>Télécharger un pilote compatible
jdbc3 comme jtds-1.2.jar sur sourceforge.</li>
<li>Placer le pilote dans le répertoire
TOMCAT_HOME/common/endorsed</li>
<li>Dans les fichiers de configuration comme
<ul>
<li>mondrian/WEB-INF/datasources.xml</li>
<li>mondrian/WEB-INF/web.xml</li>
</ul>
J'ai modifié les paramètres de cette
façon:
<blockquote> <code>Provider=mondrian;
JdbcUser=userName; JdbcPassword=userPass;
Jdbc=jdbc:jtds:sybase://xxx.xxx.xxx.xxx:port/dbName;
JdbcDrivers=net.sourceforge.jtds.jdbc.Driver;
Catalog=/WEB-INF/queries/myCatalog.xml</code> </blockquote>
(Le fichier datasources.xml semble ne pas avoir besoin d'être
modifié si vous testez juste la base de
données,mais vous en aurez besoin pour OPENI par
exemple)</li>
</ul>
</blockquote>
<h2>8. Problèmes de compatibilité<a name="8_Compatibility_issues"> </a></h2>
<h3>8.1. Weblogic 6.1 et Xerces<a name="8_1_Weblogic_6_1_and_Xerces"> </a></h3>
<p>Weblogic 6.1 est fourni avec une version ancienne et
incompatible de Xerces.
Le symptome est l'erreur suivante</p>
<blockquote> <code>java.lang.VerifyError: (class:
org/eigenbase/xom/wrappers/XercesDOMParser, method: parse signature:
(Lorg/xml/sax/InputSource;)Lorg/w3c/dom/Document;) Incompatible object
argument for function call<br>
at java.lang.Class.forName0(Native Method)<br>
at java.lang.Class.forName(Class.java:120)<br>
at org.eigenbase.xom.XOMUtil.createDefaultParser(XOMUtil.java:165)<br>
at org.eigenbase.resgen.Util.load(Util.java:49)<br>
...</code>
</blockquote>
<p>La solution est de placer <code>xml-apis.jar</code>
et <code>xercesImpl.jar</code>
avant <code>weblogic.jar</code> dans votre class-path.</p>
<p>Generalement, Mondrian utilise un parseur XML
compatible JAXP fourni par le système.
Malheureusement, le parseur de Weblogic ne fonctionne pas en
mode non-validé, mode que requiert Mondrian. Par
conséquent, dans un environnement Weblogic,
Mondrian
utilise explicitement Xerces. <a href="http://xml.apache.org/soap/faq/faq-for-WL6.1beta.html">Cette
notice</a>
décrit comme changer le parseur par défaut de
Weblogic.</p>
<h3>8.2. JDK, Xalan et Tomcat<a name="8_2_Xalan_and_Tomcat"> </a></h3>
<p>Les distributions Mondrian, requiert JDK 1.4.x, Xalan
2.6.0, et
Tomcat
5.0.25 ou supérieur. Les choses fonctionnent mieux ainsi..</p>
<p>Si vous exécutez JDK 1.3.<i>x</i>,
vous aurez besoin de fichiers JAR
supplémentaires, parce que JDK 1.3 n'inclut pas le
parseur XML. Copiez <code> xalan.jar</code> et <code>xml-apis.jar</code>
dans le répertoire <code><i>TOMCAT_HOME</i>/common/lib</code>.
(ou <code><i>TOMCAT_HOME</i>/common/endorsed</code>,
si votre version de Tomcat dispose de ce répertoire). Si
vous disposez d'une mauvaise configuration, alors, l'erreur typique
sera celle-ci:</p>
<blockquote> <code>java.lang.VerifyError: Cannot inherit
from final class<br>
at java.lang.ClassLoader.defineClass0(Native Method)<br>
at java.lang.ClassLoader.defineClass(ClassLoader.java:502)<br>
at
java.security.SecureClassLoader.defineClass(SecureClassLoader.java:123)<br>