Mailing-List: contact empire-db-user-help@incubator.apache.org; run by ezmlm
Precedence: bulk
Reply-To: empire-db-user@incubator.apache.org
Received-SPF: pass (athena.apache.org: local policy)
DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws;
  s=s1024; d=yahoo.com;
  h=DKIM-Signature:Received:X-Yahoo-SMTP:X-YMail-OSG:X-Yahoo-Newman-Property:From:Content-Type:Subject:Date:Message-Id:To:Mime-Version:X-Mailer;
  b=wOeEYyToBy+9l4eYy9m9HEdvnynKmtIJqQbZ3t/uGxgZZC/wjexc8lQgT+Lk7GQZJ94JcIn0LxEoxksvdNVd4fgDFfcWFrEbifNOoB9eqpAbgZKeE0yxaZoZH/joOAKJwe2SSsspRvwfu3xXszZzIBkAc4rRZMpnYOERL0p4m6E=
  ;
From: Tim Colson <timcolson@yahoo.com>
Content-Type: multipart/alternative; boundary=Apple-Mail-2-156055753
Subject: Problems in docs for running example-basic
Date: Wed, 13 Apr 2011 15:21:26 -0700
Message-Id: <1EEB4BC1-713B-47DC-BEF6-0DD46D1A4E3C@yahoo.com>
To: empire-db-user@incubator.apache.org
Mime-Version: 1.0 (Apple Message framework v1084)


--Apple-Mail-2-156055753
Content-Transfer-Encoding: quoted-printable
Content-Type: text/plain;
	charset=us-ascii

I managed to get the basic example to run in both Eclipse and Intellij =
IDEA after some effort troubleshooting.=20

Here are observations on the docs/tutorial info that were confusing or =
incorrect.

I pulled down the distro and expanded into /appdev, cd =
/appdev/apache-empire-db-2.1.0-incubating/src, and then ran mvn =
idea:idea. The project opened in Intellij IDEA, ran SampleApp.java... =
gives an error saying it cannot get the config value for =
empireDBDriverClass which suggests config.xml file was found, but can't =
load that node.=20

I switched to Eclipse since the docs mention it specifically....

The website Getting started and Tutorial instructions incorrectly say to =
import empire-db-2.0.0/examples/DBSample which does not exist in the 2.1 =
distro. The Tutorial PDF inside the distro is more accurate for the =
path, but says to use mvn eclipse:eclipse, but the README.txt says "mvn =
clean install" to build and  "mvn clean eclipse:eclipse =
-DdownloadSources=3Dtrue" - so I did both steps.=20

I imported the projects Eclipse, but it complained of a missing =
"M2_REPO" variable. I googled and fixed and the sample ran!

I went back to Intellij IDEA, and on a hunch checked the working =
directory. It was set to the root of the src folder, so I set it to  =
empire-db-example-basic. The sample ran fine! :-)

I guessed that the config.xml wasn't actually loading, but the error is =
misleading. I reviewed XMLConfiguration.java, line 114, =
FileNotFoundException, but since log4j reported a problem initializing, =
I added a System.out.println() and re-ran - it printed that config.xml =
was not found.=20

Suggestions:=20
* update the Tutorial and Getting Started docs to align with the current =
release
* maybe add a footnote for Intellij users to make sure to set the =
working directory so the config.xml is loaded.=20
* Review logging setup - since until config is loaded, the log system =
isn't init'd so the log message about not being able to load the file =
fails.

Cheers!
-Tim

Intellij IDEA -- error....

log4j:WARN No appenders could be found for logger =
(org.apache.empire.commons.ErrorType).
log4j:WARN Please initialize the log4j system properly.
Running DB Sample...
*** Step 1: getJDBCConnection() ***
*** Step 2: getDatabaseProvider() ***
java.lang.RuntimeException: Configuration error: Element =
'empireDBDriverClass' not found in node 'properties-hsqldb'
	at =
org.apache.empire.samples.db.SampleApp.getDatabaseDriver(SampleApp.java:20=
1)
	at =
org.apache.empire.samples.db.SampleApp.main(SampleApp.java:85)
java.lang.RuntimeException: java.lang.RuntimeException: Configuration =
error: Element 'empireDBDriverClass' not found in node =
'properties-hsqldb'
java.lang.RuntimeException: java.lang.RuntimeException: Configuration =
error: Element 'empireDBDriverClass' not found in node =
'properties-hsqldb'
	at =
org.apache.empire.samples.db.SampleApp.getDatabaseDriver(SampleApp.java:22=
1)
	at =
org.apache.empire.samples.db.SampleApp.main(SampleApp.java:85)
Caused by: java.lang.RuntimeException: Configuration error: Element =
'empireDBDriverClass' not found in node 'properties-hsqldb'
	at =
org.apache.empire.samples.db.SampleApp.getDatabaseDriver(SampleApp.java:20=
1)
	... 1 more


--Apple-Mail-2-156055753
Content-Transfer-Encoding: quoted-printable
Content-Type: text/html;
	charset=us-ascii

<html><head></head><body style=3D"word-wrap: break-word; =
-webkit-nbsp-mode: space; -webkit-line-break: after-white-space; =
"><div>I managed to get the basic example to run in both Eclipse and =
Intellij IDEA after some effort =
troubleshooting.&nbsp;</div><div><br></div><div>Here are observations on =
the docs/tutorial info that were confusing or =
incorrect.</div><div><br></div><div>I pulled down the distro and =
expanded into =
/appdev,&nbsp;cd&nbsp;/appdev/apache-empire-db-2.1.0-incubating/src, and =
then ran mvn idea:idea. The project&nbsp;opened in Intellij IDEA, ran =
SampleApp.java... gives an error saying it cannot get the config value =
for empireDBDriverClass which suggests config.xml file was found, but =
can't load that node.&nbsp;</div><div><br></div><div>I switched to =
Eclipse since the docs mention it =
specifically....</div><div><br></div><div>The website Getting started =
and Tutorial instructions incorrectly say to import&nbsp;<span =
class=3D"Apple-style-span" style=3D"font-family: Arial, Helvetica, =
sans-serif; font-size: 13px; ">empire-db-2.0.0/examples/DBSample which =
does not exist in the 2.1 distro. </span>The Tutorial PDF inside the =
distro is more accurate for the path, but says to use mvn =
eclipse:eclipse, but the README.txt says "mvn clean install" to build =
and &nbsp;"mvn clean eclipse:eclipse -DdownloadSources=3Dtrue" - so I =
did both steps.&nbsp;</div><div><br></div><div>I imported the projects =
Eclipse, but it complained of a missing "M2_REPO" variable. I googled =
and fixed and the sample ran!</div><div><br></div><div>I went back to =
Intellij IDEA, and on a hunch checked the working directory. It was set =
to the root of the src folder, so I set it to =
&nbsp;empire-db-example-basic. The sample ran fine! =
:-)</div><div><br></div><div>I guessed that the config.xml wasn't =
actually loading, but the error is misleading. I reviewed =
XMLConfiguration.java, line 114, FileNotFoundException, but since log4j =
reported a problem initializing, I added a System.out.println() and =
re-ran - it printed that config.xml was not =
found.&nbsp;</div><div><br></div><div>Suggestions:&nbsp;</div><div>* =
update the Tutorial and Getting Started docs to align with the current =
release</div><div>* maybe add a footnote for Intellij users to make sure =
to set the working directory so the config.xml is =
loaded.&nbsp;</div><div>* Review logging setup - since until config is =
loaded, the log system isn't init'd so the log message about not being =
able to load the file =
fails.</div><div><br></div><div>Cheers!</div><div>-Tim</div><div><br></div=
><div>Intellij IDEA -- error....</div><div><br></div><div>log4j:WARN No =
appenders could be found for logger =
(org.apache.empire.commons.ErrorType).</div><div>log4j:WARN Please =
initialize the log4j system properly.</div><div>Running DB =
Sample...</div><div>*** Step 1: getJDBCConnection() ***</div><div>*** =
Step 2: getDatabaseProvider() ***</div><div>java.lang.RuntimeException: =
Configuration error: Element 'empireDBDriverClass' not found in node =
'properties-hsqldb'</div><div><span class=3D"Apple-tab-span" =
style=3D"white-space:pre">	</span>at =
org.apache.empire.samples.db.SampleApp.getDatabaseDriver(SampleApp.java:20=
1)</div><div><span class=3D"Apple-tab-span" style=3D"white-space:pre">	=
</span>at =
org.apache.empire.samples.db.SampleApp.main(SampleApp.java:85)</div><div>j=
ava.lang.RuntimeException: java.lang.RuntimeException: Configuration =
error: Element 'empireDBDriverClass' not found in node =
'properties-hsqldb'</div><div>java.lang.RuntimeException: =
java.lang.RuntimeException: Configuration error: Element =
'empireDBDriverClass' not found in node =
'properties-hsqldb'</div><div><span class=3D"Apple-tab-span" =
style=3D"white-space:pre">	</span>at =
org.apache.empire.samples.db.SampleApp.getDatabaseDriver(SampleApp.java:22=
1)</div><div><span class=3D"Apple-tab-span" style=3D"white-space:pre">	=
</span>at =
org.apache.empire.samples.db.SampleApp.main(SampleApp.java:85)</div><div>C=
aused by: java.lang.RuntimeException: Configuration error: Element =
'empireDBDriverClass' not found in node =
'properties-hsqldb'</div><div><span class=3D"Apple-tab-span" =
style=3D"white-space:pre">	</span>at =
org.apache.empire.samples.db.SampleApp.getDatabaseDriver(SampleApp.java:20=
1)</div><div><span class=3D"Apple-tab-span" style=3D"white-space:pre">	=
</span>... 1 more</div><div><br></div><div><br></div></body></html>=

--Apple-Mail-2-156055753--