Skip to content

Commit

Permalink
MONDRIAN: Fix servlet defn in install guide (bug 1541580); bring Span…
Browse files Browse the repository at this point in the history 
…ish install guide up to date.

[git-p4: depot-paths = "//open/mondrian/": change = 7464]
  • Loading branch information
@julianhyde
julianhyde committed Aug 24, 2006
1 parent d6912ae commit 659ad16
Show file tree
Hide file tree
Showing 2 changed files with 188 additions and 138 deletions.
58 changes: 35 additions & 23 deletions doc/install.html
View file
Expand Up @@ -21,7 +21,7 @@
</head>
<body>
<h1>How to install Mondrian</h1>
<p>By Julian Hyde and others; last updated May, 2006. Also available in [<a href="install_es.html">Espa&ntilde;ol</a>].</p>
<p>By Julian Hyde and others; last updated August, 2006. Also available in [<a href="install_es.html">Espa&ntilde;ol</a>].</p>
<hr color="#000000" noshade="noshade" size="1">
<ol>
<li><a href="#1_Introduction">Introduction</a></li>
Expand Down Expand Up @@ -121,7 +121,8 @@ <h3><a name="2_2_Non_Access_setup">2.2. Other database</a></h3>
create a database, and load data from a SQL script.</p>
<h4>Syntax</h4>
<blockquote>
<p><code>MondrianFoodMartLoader<br>
<div style="border-style: solid; border-width: 1px; padding-left: 4px; padding-right: 4px; padding-top: 1px; padding-bottom: 1px">
<code>MondrianFoodMartLoader<br>
&nbsp;&nbsp;&nbsp; [-verbose] [-tables] [-data] [-indexes]<br>
&nbsp;&nbsp;&nbsp; -jdbcDrivers=&lt;jdbcDrivers&gt;<br>
&nbsp;&nbsp;&nbsp; -outputJdbcURL=&lt;jdbcURL&gt;<br>
Expand All @@ -133,7 +134,7 @@ <h4>Syntax</h4>
&nbsp;&nbsp;&nbsp; [ [-inputJdbcURL=&lt;jdbcURL&gt;
[-inputJdbcUser=user] [-inputJdbcPassword=password] ]<br>
&nbsp;&nbsp;&nbsp; | [-inputFile=&lt;file name&gt;]<br>
&nbsp;&nbsp;&nbsp; ]</code></p>
&nbsp;&nbsp;&nbsp; ]</code></div>
</blockquote>

<h4>Options</h4>
Expand Down Expand Up @@ -296,15 +297,16 @@ <h5>Example 2. Loading PostgreSQL from Access on Windows</h5>
dataset in the Access database:</p>

<blockquote>
<p><code><i><b>C:\mondrian&gt;</b></i> java -cp
<div style="border-style: solid; border-width: 1px; padding-left: 4px; padding-right: 4px; padding-top: 1px; padding-bottom: 1px">
<code><i><b>C:\mondrian&gt;</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>
&nbsp;&nbsp;&nbsp;&nbsp; mondrian.test.loader.MondrianFoodMartLoader<br>
&nbsp;&nbsp;&nbsp;&nbsp; -verbose -tables -data -indexes<br>
&nbsp;&nbsp;&nbsp;&nbsp; -jdbcDrivers="org.postgresql.Driver,sun.jdbc.odbc.JdbcOdbcDriver"<br>
&nbsp;&nbsp;&nbsp;&nbsp; -inputJdbcURL="jdbc:odbc:MondrianFoodMart"<br>
&nbsp;&nbsp;&nbsp;&nbsp; -outputJdbcURL="jdbc:postgresql://localhost/foodmart"<br>
&nbsp;&nbsp;&nbsp;&nbsp; -outputJdbcUser=postgres<br>
&nbsp;&nbsp;&nbsp;&nbsp; -outputJdbcPassword=password</code></p>
&nbsp;&nbsp;&nbsp;&nbsp; -outputJdbcPassword=password</code></div>
</blockquote>

<h2><a name="3_Deploy_and_run_the_web_app">3. Deploy and run the web
Expand All @@ -322,13 +324,17 @@ <h2><a name="3_Deploy_and_run_the_web_app">3. Deploy and run the web
you installed as per the above instructions. That is,

<blockquote>
<code>Provider=mondrian;Jdbc=jdbc:odbc:MondrianFoodMart;Catalog=/WEB-INF/queries/FoodMart.xml;JdbcDrivers=sun.jdbc.odbc.JdbcOdbcDriver;</code></p>
<div style="border-style: solid; border-width: 1px; padding-left: 4px; padding-right: 4px; padding-top: 1px; padding-bottom: 1px">
<code>Provider=mondrian;Jdbc=jdbc:odbc:MondrianFoodMart;Catalog=/WEB-INF/queries/FoodMart.xml;JdbcDrivers=sun.jdbc.odbc.JdbcOdbcDriver;</code></div>
</p>
</blockquote>

becomes

<blockquote>
<div style="border-style: solid; border-width: 1px; padding-left: 4px; padding-right: 4px; padding-top: 1px; padding-bottom: 1px">
<code>Provider=mondrian;Jdbc=jdbc:mysql://localhost/foodmart?user=foodmart&amp;#38;password=foodmart;Catalog=/WEB-INF/queries/FoodMart.xml;JdbcDrivers=com.mysql.jdbc.Driver;</code>
</div>
</blockquote>
</li>

Expand All @@ -338,21 +344,25 @@ <h2><a name="3_Deploy_and_run_the_web_app">3. Deploy and run the web
Modify the line

<blockquote>
<div style="border-style: solid; border-width: 1px; padding-left: 4px; padding-right: 4px; padding-top: 1px; padding-bottom: 1px">
<code>&lt;jp:mondrianQuery id="query01"
jdbcDriver="sun.jdbc.odbc.JdbcOdbcDriver"
jdbcUrl="jdbc:odbc:MondrianFoodMart"
catalogUri="/WEB-INF/queries/FoodMart.xml"&gt;</code>
</div>
</blockquote>

<p>to the same database parameters for the FoodMart database you
installed as per the above instructions. For MySQL, this would be
something like the following:

<blockquote>
<div style="border-style: solid; border-width: 1px; padding-left: 4px; padding-right: 4px; padding-top: 1px; padding-bottom: 1px">
<code>&lt;jp:mondrianQuery id="query01"
jdbcDriver="com.mysql.jdbc.Driver"
jdbcUrl="jdbc:mysql://localhost/foodmart?user=foodmart&amp;password=foodmart"
catalogUri="/WEB-INF/queries/FoodMart.xml"&gt;</code></blockquote></p></li>
catalogUri="/WEB-INF/queries/FoodMart.xml"&gt;</code></div>
</blockquote></p></li>

<li>Copy the following files:</li>
<ul>
Expand Down Expand Up @@ -384,7 +394,8 @@ <h3><a name="5_1_Describe_the_data_sources_in_datasources.xml">1. Describe the d
<p>In WEB-INF directory of your webapp, create a file called <code>
datasources.xml</code>, with content like this:</p>
<blockquote>
<p><code>&lt;?xml version="1.0"?&gt;<br>
<div style="border-style: solid; border-width: 1px; padding-left: 4px; padding-right: 4px; padding-top: 1px; padding-bottom: 1px">
<code>&lt;?xml version="1.0"?&gt;<br>
&lt;DataSources&gt;<br>
&nbsp; &lt;DataSource&gt;<br>
&nbsp;&nbsp;&nbsp;
Expand Down Expand Up @@ -426,7 +437,7 @@ <h3><a name="5_1_Describe_the_data_sources_in_datasources.xml">1. Describe the d
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;Catalog&gt;<br>
&nbsp;&nbsp;&nbsp; &lt;/Catalogs&gt;<br>
&nbsp; &lt;/DataSource&gt;<br>
&lt;/DataSources&gt;</code></p>
&lt;/DataSources&gt;</code></div>
</blockquote>
<p>
<code>&lt;ProviderType&gt;</code> and <code>&lt;AuthenticationMode&gt;</code>
Expand Down Expand Up @@ -455,17 +466,12 @@ <h3><a name="5_2_Configure_XmlaServlet_in_your_web.xml">2. Configure XmlaServlet

<p>For example:</p>
<blockquote>
<p><code>&lt;servlet&gt;<br>
<div style="border-style: solid; border-width: 1px; padding-left: 4px; padding-right: 4px; padding-top: 1px; padding-bottom: 1px">
<code>&lt;servlet&gt;<br>
&nbsp; &lt;servlet-name&gt;MondrianXmlaServlet&lt;/servlet-name&gt;<br>
&nbsp;
&lt;servlet-class&gt;mondrian.xmla.XmlaServlet&lt;/servlet-class&gt;<br>
&nbsp; &lt;init-param&gt;<br>
&nbsp;&nbsp;&nbsp;
&lt;param-name&gt;DataSourcesConfig&lt;/param-name&gt;<br>
&nbsp;&nbsp;&nbsp;
&lt;param-value&gt;datasources.xml&lt;/param-value&gt;<br>
&nbsp; &lt;/init-param&gt;<br>
&lt;/servlet&gt;</code></p>
&lt;servlet-class&gt;mondrian.xmla.impl.DefaultXmlaServlet&lt;/servlet-class&gt;<br>
&lt;/servlet&gt;</code></div>
</blockquote>
<h2>
<a name="6_Miscellaneous">6. Miscellaneous</a></h2>
Expand Down Expand Up @@ -527,7 +533,9 @@ <h3>Sybase</h3>
<li>mondrian/WEB-INF/datasources.xml</li>
<li>mondrian/WEB-INF/web.xml</li></ul>
I modified the parameters line in this way:<blockquote>
<div style="border-style: solid; border-width: 1px; padding-left: 4px; padding-right: 4px; padding-top: 1px; padding-bottom: 1px">
<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>
</div>
</blockquote>
(The datasources.xml doesn't need to be modified if you are only testing
the db, but if you are using something like OPENI you have to.)</li>
Expand All @@ -541,7 +549,9 @@ <h3><a name="8_1_Weblogic_6_1_and_Xerces">8.1. Weblogic 6.1 and Xerces</a></h3>
<p>Weblogic 6.1 ships with an older, incompatible, version of Xerces.
The symptom is the error</p>
<blockquote>
<div style="border-style: solid; border-width: 1px; padding-left: 4px; padding-right: 4px; padding-top: 1px; padding-bottom: 1px">
<pre>java.lang.VerifyError: (class: org/eigenbase/xom/wrappers/XercesDOMParser,<br> method: parse signature: (Lorg/xml/sax/InputSource;)Lorg/w3c/dom/Document;)<br> 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>...</pre>
</div>
</blockquote>
<p>The solution is to place <code>xml-apis.jar</code> and <code>xercesImpl.jar</code>
before <code>weblogic.jar</code> on your class-path.</p>
Expand All @@ -568,7 +578,8 @@ <h3><a name="8_2_Xalan_and_Tomcat">8.2. JDK, Xalan and Tomcat</a></h3>
if your version of Tomcat has one). If you get the configuration wrong,
a typical error is</p>
<blockquote>
<p><code>java.lang.VerifyError: Cannot inherit from final class<br>
<div style="border-style: solid; border-width: 1px; padding-left: 4px; padding-right: 4px; padding-top: 1px; padding-bottom: 1px">
<code>java.lang.VerifyError: Cannot inherit from final class<br>
&nbsp; at java.lang.ClassLoader.defineClass0(Native Method)<br>
&nbsp; at java.lang.ClassLoader.defineClass(ClassLoader.java:502)<br>
&nbsp; at
Expand Down Expand Up @@ -606,7 +617,7 @@ <h3><a name="8_2_Xalan_and_Tomcat">8.2. JDK, Xalan and Tomcat</a></h3>
org.apache.xerces.parsers.IntegratedParserConfiguration.&lt;init&gt;(Unknown
Source)<br>
&nbsp; at sun.reflect.NativeConstructorAccessorImpl.newInstance0(Native
Method)</code></p>
Method)</code></div>
</blockquote>
<p>This error occurred under JDK 1.3.1, Tomcat 4.1.18, Xalan 2.4.1. The
solutions to the error were (a) move to JDK 1.4 and remove <code>xml-apis.jar</code>
Expand All @@ -629,9 +640,10 @@ <h3><a name="8_3_Log4j_and_Tomcat">8.3. Log4j and Tomcat</a></h3>
<tbody>
<tr>
<td class="content"> <a target="_top" href="index.html">Home</a>
| <a target="_top" href="#">No frames</a> | This file is<i> <a
href="http://mondrian.sourceforge.net/install.html">$Id$ </a></i> (<a
href="http://perforce.eigenbase.org:8080/open/mondrian/doc/install.html?ac=22">log</a>)</td>
| <a target="_top" href="#">No frames</a> | This file is<i>
<a href="http://mondrian.sourceforge.net/install.html">
$Id$
</a></i> (<a href="http://perforce.eigenbase.org:8080/open/mondrian/doc/install.html?ac=22">log</a>)</td>
<td align="right"> <a href="http://sourceforge.net"> <img
src="http://sourceforge.net/sflogo.php?group_id=35302&amp;type=1"
alt="SourceForge.net Logo" border="0" height="31" width="88"> </a> </td>
Expand Down

0 comments on commit 659ad16

Please sign in to comment.