db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Satheesh Bandaram <sathe...@Sourcery.Org>
Subject Re: Availability of Derby client ...
Date Tue, 19 Apr 2005 18:05:38 GMT
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
  <meta content="text/html;charset=ISO-8859-1" http-equiv="Content-Type">
<body bgcolor="#ffffff" text="#000000">
Thanks Myrna. If Derby client vote is accepted, I will apply your
changes as a patch to original Derby README file.<br>
Myrna van Lunteren wrote:<br>
<blockquote cite="midc25576af05041813417c9556ab@mail.gmail.com"
  <pre wrap="">Hi Satheesh, Jeremy,

I looked at the changed java/testing/README.htm, &amp; felt we should
replace the references to DerbyNet framework with DerbyNetClient in a
couple more places.
While I was at it, I also changed some of the notes. 

So, here is an updated README.htm to go with the DerbyClient offering. 
I started from the original, so this has no MS references.


On 4/15/05, Satheesh Bandaram <a class="moz-txt-link-rfc2396E" href="mailto:satheesh@sourcery.org">&lt;satheesh@sourcery.org&gt;</a>
  <blockquote type="cite">
    <pre wrap="">Good catch... I will remove Microsoft Office headers...


Jeremy Boynes wrote:

    <blockquote type="cite">
      <pre wrap="">Myrna van Lunteren wrote:

      <blockquote type="cite">
        <pre wrap="">I had used Mozilla's html editor when I created the file.
What's the Microsoft Office junk you refer to?

      <pre wrap="">Stuff like that below taken from the patch ... the Microsoft
proprietary markup makes editing the file difficult using a real HTML
editor (like vi) which is what we will need to do going forward.

--- java/testing/README.htm    (revision 161156)
+++ java/testing/README.htm    (working copy)
@@ -1,1189 +1,2159 @@
 &lt;!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"&gt;
+&lt;html xmlns:o="urn:schemas-microsoft-com:office:office"
+xmlns=<a class="moz-txt-link-rfc2396E" href="http://www.w3.org/TR/REC-html40">"http://www.w3.org/TR/REC-html40"</a>&gt;
-  &lt;meta content="text/html; charset=ISO-8859-1"
- http-equiv="content-type"&gt;
-  &lt;title&gt;readme.htm&lt;/title&gt;
+&lt;meta http-equiv=Content-Type content="text/html; charset=iso-8859-1"&gt;
+&lt;meta name=ProgId content=Word.Document&gt;
+&lt;meta name=Generator content="Microsoft Word 10"&gt;
+&lt;meta name=Originator content="Microsoft Word 10"&gt;
+&lt;link rel=File-List href="README_files/filelist.xml"&gt;
+ name="date"/&gt;
+ name="City"/&gt;
+ name="State"/&gt;
+ name="place"/&gt;
+ name="time"/&gt;
+&lt;!--[if gte mso 9]&gt;&lt;xml&gt;
+ &lt;o:DocumentProperties&gt;
+  &lt;o:Author&gt;IBM_User&lt;/o:Author&gt;
+  &lt;o:LastAuthor&gt;IBM_User&lt;/o:LastAuthor&gt;
+  &lt;o:Revision&gt;2&lt;/o:Revision&gt;
+  &lt;o:TotalTime&gt;4&lt;/o:TotalTime&gt;
+  &lt;o:Created&gt;2005-04-07T04:38:00Z&lt;/o:Created&gt;
+  &lt;o:LastSaved&gt;2005-04-07T04:42:00Z&lt;/o:LastSaved&gt;
+  &lt;o:Pages&gt;1&lt;/o:Pages&gt;
+  &lt;o:Words&gt;4678&lt;/o:Words&gt;
+  &lt;o:Characters&gt;26668&lt;/o:Characters&gt;
+  &lt;o:Company&gt;IBM&lt;/o:Company&gt;
+  &lt;o:Lines&gt;222&lt;/o:Lines&gt;
+  &lt;o:Paragraphs&gt;62&lt;/o:Paragraphs&gt;
+  &lt;o:CharactersWithSpaces&gt;31284&lt;/o:CharactersWithSpaces&gt;
+  &lt;o:Version&gt;10.6714&lt;/o:Version&gt;
+ &lt;/o:DocumentProperties&gt;
+&lt;/xml&gt;&lt;![endif]--&gt;&lt;!--[if gte mso 9]&gt;&lt;xml&gt;
+ &lt;w:WordDocument&gt;
+  &lt;w:SpellingState&gt;Clean&lt;/w:SpellingState&gt;
+  &lt;w:GrammarState&gt;Clean&lt;/w:GrammarState&gt;
+  &lt;w:Compatibility&gt;
+   &lt;w:ApplyBreakingRules/&gt;
+   &lt;w:UseFELayout/&gt;
+  &lt;/w:Compatibility&gt;
+  &lt;w:BrowserLevel&gt;MicrosoftInternetExplorer4&lt;/w:BrowserLevel&gt;
+ &lt;/w:WordDocument&gt;
+&lt;/xml&gt;&lt;![endif]--&gt;&lt;!--[if !mso]&gt;&lt;object
+ classid=<a class="moz-txt-link-rfc2396E" href="clsid:38481807-CA0E-42D2-BF39-B33AF135CC4D">"clsid:38481807-CA0E-42D2-BF39-B33AF135CC4D"</a>

  <pre wrap=""><!---->&gt;
  <pre wrap="">
<hr size="4" width="90%">
Index: java/testing/README.htm
--- java/testing/README.htm	(revision 161498)
+++ java/testing/README.htm	(working copy)
@@ -13,7 +13,7 @@
 &lt;small&gt;created by <a class="moz-txt-link-abbreviated" href="mailto:myrna@golux.com">myrna@golux.com</a>&lt;br&gt;
-last updated on 12/02/2004 by: <a class="moz-txt-link-abbreviated" href="mailto:myrna@golux.com">myrna@golux.com</a>&lt;br&gt;
+last updated on 04/18/2005 by: <a class="moz-txt-link-abbreviated" href="mailto:m.v.lunteren@gmail.com">m.v.lunteren@gmail.com</a>&lt;br&gt;
@@ -90,7 +90,9 @@
 Before you can run, you need to setup your environment:&lt;br&gt;
-  &lt;li&gt;Obtain a jdk or jre (based on jdk 1.3.1 specification or higher).
+  &lt;li&gt;Obtain a jdk or jre (based on jdk 1.3.1 specification &lt;small&gt;&lt;a
+ href="README.htm#Note1:"&gt;&lt;small&gt;See Note1&lt;/small&gt;&lt;/a&gt;&lt;/small&gt;
 Add the bin directory to your $PATH. Currently supported are:&lt;br&gt;
@@ -134,9 +136,11 @@
     &lt;small&gt;&amp;nbsp;&amp;nbsp;&amp;nbsp; derby tools classes for
tools like ij
 and dblook&lt;/small&gt;&lt;li&gt;&lt;small&gt;derbynet.jar&lt;br&gt;
-    &lt;small&gt;&amp;nbsp;&amp;nbsp;&amp;nbsp; derby network server
-and db2jcc_license_c.jar &lt;br&gt;
+    &lt;small&gt;&amp;nbsp;&amp;nbsp;&amp;nbsp; derby network server
+    &lt;small&gt;&amp;nbsp;&amp;nbsp;&amp;nbsp; derby client classes&lt;/small&gt;&lt;li&gt;&lt;small&gt;db2jcc.jar
+and db2jcc_license_c.jar&lt;br&gt;
+      &lt;/small&gt;&lt;/li&gt;
     &lt;small&gt;&amp;nbsp;&amp;nbsp;&amp;nbsp; IBM Universal JDBC Driver
classes. (See
 IBM &lt;a href=<a class="moz-txt-link-rfc2396E" href="http://www-106.ibm.com/developerworks/db2/downloads/jcc/">"http://www-106.ibm.com/developerworks/db2/downloads/jcc/"</a>&gt;developerworks&lt;/a&gt;
 for download)&lt;/small&gt;&lt;br&gt;
@@ -158,12 +162,14 @@
       &lt;td style="vertical-align: top;"&gt;&lt;small&gt;(note that $jardir
-only a convenience variable and that the command below has carriage
+only a convenience variable and that the set CLASSPATH command below
+has carriage
 returns for formatting reasons):&lt;br&gt;
       &lt;/small&gt;&lt;small&gt;set jardir=/local/derbyjar&lt;br&gt;
@@ -205,12 +211,13 @@
-To run a test with network server, add -Dframework=DerbyNet to the run.
+To run a test with network server, using the derbyclient driver, add
+-Dframework=DerbyNetClient to the run.
 The test harness will to start
 network server at port 1527 or connect to a running one, run the test,
 and stop network server thereafter.&lt;br&gt;
 for example:&lt;br&gt;
-&amp;nbsp;&amp;nbsp;&amp;nbsp; &amp;nbsp;&amp;nbsp;&amp;nbsp; java
+&amp;nbsp;&amp;nbsp;&amp;nbsp; &amp;nbsp;&amp;nbsp;&amp;nbsp; java
       &lt;/small&gt;&lt;small&gt; &lt;/small&gt;&lt;/td&gt;
@@ -275,16 +282,24 @@
     &lt;li&gt;tested on a variety of hardware takes from 1.15m to 2.00 hours&lt;br&gt;
+  &lt;li&gt;derbynetclientmats&lt;/li&gt;
+  &lt;ul&gt;
+    &lt;li&gt;basic network server tests using the derby client&lt;br&gt;
+    &lt;/li&gt;
+    &lt;li&gt;variety of tests, including some from derbylang suite&lt;/li&gt;
+    &lt;li&gt;tested on a variety of hardware takes from 15 to 30 minutes&lt;/li&gt;
+  &lt;/ul&gt;
-    &lt;li&gt;basic network server tests.&lt;/li&gt;
+    &lt;li&gt;basic network server tests using the IBM Universal JDBC driver&lt;br&gt;
+    &lt;/li&gt;
     &lt;li&gt;variety of tests, including some from derbylang suite&lt;/li&gt;
     &lt;li&gt;tested on a variety of hardware takes from 15 to 30 minutes&lt;/li&gt;
-    &lt;li&gt;tests networkserver functionality without requiring
-networkserver framework&lt;br&gt;
+    &lt;li&gt;tests network server functionality without requiring
+network server framework&lt;br&gt;
@@ -424,7 +439,8 @@
-    &lt;li&gt;tests that characters outside simple ascii scope do not result in errors.
+    &lt;li&gt;tests that characters outside simple ascii scope do not result
+in errors. &lt;/li&gt;
     &lt;li&gt;takes 5 to 10 minutes&lt;br&gt;
@@ -436,7 +452,7 @@
     &lt;li&gt;tested on a variety of hardware takes from 3.00 - 6.00 hours &lt;/li&gt;
-  &lt;li&gt;&lt;a href="#Note1:"&gt;&lt;small&gt;See Note1&lt;/small&gt;&lt;/a&gt;&lt;br&gt;
+  &lt;li&gt;&lt;a href="#Note2:"&gt;&lt;small&gt;See Note2&lt;/small&gt;&lt;/a&gt;&lt;br&gt;
@@ -547,9 +563,8 @@
 &lt;p&gt;See section 2.1 for the basic steps to run 1 test.
 &lt;p&gt;To pass on system level properties to the test harness, use the test
-harness property -DtestSpecialFlags. For
-example, to run a test forcing
-the message text to be retrieved from the network server:
+harness property -DtestSpecialFlags. For example, to ensure extra
+information is appended to the log:&amp;nbsp;&lt;br&gt;
  style="text-align: left; width: 558px; height: 32px; margin-left: 40px;"
@@ -557,8 +572,8 @@
       &lt;td style="vertical-align: top;"&gt; &lt;small&gt;java
@@ -567,9 +582,10 @@
 Tests will be executed in the current directory. When
 running a test
-using the network server, i.e. -Dframework=DerbyNet, the test will run
-in a subdirectory (automatically created) 'DerbyNet'. &lt;small&gt; &lt;br&gt;
-&lt;a href="#Note2:"&gt;See Note2&lt;/a&gt;.&lt;br&gt;
+using the network server and derby client, i.e.
+-Dframework=DerbyNetClient, the test will run
+in a subdirectory (automatically created) 'DerbyNetClient'. &lt;small&gt; &lt;a
+ href="#Note3:"&gt;&lt;/a&gt;&lt;br&gt;
 The test will normally create the following:&lt;br&gt;
@@ -603,7 +619,7 @@
 When the test is successful, cleanup will occur unless the test harness
 property -Dkeepfiles=true is used. Cleanup will attempt to cleanup all
 files except for .pass. &lt;small&gt;&lt;br&gt;
-&lt;a href="#Note3:_"&gt;See Note3.&lt;/a&gt;&lt;/small&gt;
+&lt;a href="#Note3:"&gt;See Note3.&lt;/a&gt;&lt;/small&gt;
 A successful run (this example is from a dos environment) would
@@ -839,7 +855,8 @@
 For example, if we are running a test and the flag -Dframework=DerbyNet
-is used and the jvm we are
+is used, to use network server and the IBM Universal JDBC Driver
+('jcc'), and the jvm we are
 using is Sun's jdk 142, and the jcc version is 2.4 (not available at
 time of writing) then the search for the master to compare with
 starts in the functionTests/derbynet/jcc2.4/jdk14 directory. If a .out
@@ -955,7 +972,7 @@
       &lt;td style="vertical-align: top;"&gt;&lt;small&gt;-----------------------derbyall.properties---------------&lt;br&gt;
-suites=derbylang derbynetmats storeall xa derbytools&lt;br&gt;
+suites=derbylang derbynetclientmats derbynetmats storeall xa derbytools&lt;br&gt;
@@ -964,7 +981,8 @@
 The derbylang suite is only a derbylang.runall, which lists the tests.
-The derbynetmats suite has both a .runall and a .properties file, so
+The derbynetclientmats suite has both a .runall and a .properties file,
 some additional properties can be specified that are true for all tests
 in that suite. &lt;/p&gt;
@@ -972,9 +990,9 @@
  border="1" cellpadding="2" cellspacing="2"&gt;
-      &lt;td style="vertical-align: top;"&gt;&lt;small&gt;------------------derbynetmats.properties-----------------&lt;br&gt;
+      &lt;td style="vertical-align: top;"&gt;&lt;small&gt;------------------derbynetclientmats.properties-----------------&lt;br&gt;
+suites=derbynetclientmats derbynetmats&lt;br&gt;
@@ -1068,9 +1086,9 @@
 Other skip reasons are encryption protocols specific to a certain jvm. &lt;br&gt;
 &lt;p&gt;Another skipping mechanism works on entire 'frameworks'. Currently
-there are only 3 supported in the harness, embedded, NetworkServer with
-the IBM Universal JDBC Driver ('DerbyNet') and NetworkServer with the
-not yet available new driver ('DerbyNetClient'). In the suites
+there are only 3 supported in the harness, embedded, network server
+with the derbyclient driver ('DerbyNetClient') and network server with
+the IBM Universal JDBC Driver ('DerbyNet'). In the suites
 directory there are .exclude files for each of the frameworks - if for
 some reason an exclude file were not there, you would see a warning
 message show up for every test run. In this 'framework'.exclude file
@@ -1083,13 +1101,17 @@
 &lt;h3&gt;&lt;a name="frameworks"&gt;&lt;/a&gt;4.11 Frameworks&lt;/h3&gt;
-Currently, the only framework used is DerbyNet for network server. &lt;br&gt;
-Setting framework property setting will invoke the test harness class
-NetServer, which currently has configuration for connecting to DB2 via
-jcc (the IBM Universal Driver), and via the older db2 driver. But there
-are currently no tests to exercise these settings.&lt;br&gt;
+Currently, there are two frameworks used for network server,&amp;nbsp;&lt;span
+ style=""&gt;&lt;/span&gt;&lt;span class="SpellE"&gt;&lt;/span&gt;&lt;span
+which uses the derby Client driver, and DerbyNet, which uses the IBM
+Universal JDBC Driver. &lt;br&gt;
+Setting the framework property will invoke the test harness class
+NetServer which has the actual configuration (driver name, portnumber
+etc.) used for the individual frameworks. &lt;small&gt;&lt;a
+ href="README.htm#Note3:"&gt;See Note4.&lt;/a&gt;&lt;/small&gt;&lt;br&gt;
 Setting this framework also causes the search for expected output to
-include DerbyNet and jcc version specific subdirectories under master.&lt;br&gt;
+include appropriate DerbyNetClient or&amp;nbsp; DerbyNet and jcc version
+specific subdirectories under the master directory.&lt;br&gt;
 &lt;h3&gt;&lt;a name="props"&gt;&lt;/a&gt;4.12 Some test harness
@@ -1107,7 +1129,8 @@
 section &lt;a href="#skipping"&gt;4.10&lt;/a&gt;&lt;br&gt;
 &amp;nbsp;&amp;nbsp;&amp;nbsp; specifies which framework to run with. For example:&lt;br&gt;
java -Dframework=DerbyNet
 org.apache.derbyTesting.functionTests.RunTest &lt;br&gt;
@@ -1129,13 +1152,19 @@
-&lt;small&gt;&lt;a name="Note1:"&gt;&lt;/a&gt; Note1:&lt;br&gt;
+&lt;small&gt;&lt;a name="Note1:"&gt;&lt;/a&gt;Note1:&lt;br&gt;
+&lt;div style="margin-left: 40px;"&gt;&lt;small&gt;A number of tests require
+packages that are optional with jdk13, but included with later jvms:
+jdbc20ext.jar and jta1_2.jar&lt;/small&gt;&lt;small&gt;. When running with
+these need to be downloaded separately &amp;amp; placed in the jre/lib/ext
+directory of your jvm installation.&lt;/small&gt;&lt;br&gt;
+&lt;a name="Note2:"&gt;&lt;/a&gt; Note2:&lt;br&gt;
 &lt;div style="margin-left: 40px;"&gt;&lt;small&gt;There is one more suite
 included: the j9derbynetmats
 suite is a modification of the derbynetmats suite. It is available to
@@ -1155,35 +1184,29 @@
 on the executable, j9.exe), based on the property 'serverJvm'. Running
 this suite requires providing the property&amp;nbsp; bootcp,
 which is&amp;nbsp; interpreted from the test harness class j9_13. See also
-section on adding a new &lt;a href="#ov9%22"&gt;jvm setup&lt;/a&gt;.
+section on adding a new &lt;a href="#ov9"&gt;jvm setup&lt;/a&gt;.
-Another suite is derbynetclientmats. This suite is for testing the
-networkserver with a yet to be contributed open source client. IBM
-staff is working on contributing this. In essence it is the same as the
-derbynetmats suite.&amp;nbsp; At this time, it can only be run by the IBM
-staff working on this driver.&lt;br&gt;
-&lt;small&gt;&lt;a name="Note2:"&gt;&lt;/a&gt;Note2:&lt;br&gt;
+&lt;small&gt;&lt;a name="Note3:"&gt;&lt;/a&gt;Note3:&lt;br&gt;
-&lt;div style="margin-left: 40px;"&gt;&lt;small&gt;setting
-RetrieveMessagesFromServerOnGetMessage to true
-for the test harness is purely for
-illustration, the test harness actually forces
-RetrieveMessagesFromServerOnGetMessage to true for the tests so the
-output is always as expected.&lt;/small&gt;&lt;br&gt;
-&lt;small&gt;&lt;a name="Note3:_"&gt;&lt;/a&gt;Note3: &lt;br&gt;
-&lt;div style="margin-left: 40px;"&gt;&lt;small&gt;occasionally, cleanup
+&lt;div style="margin-left: 40px;"&gt;O&lt;small&gt;ccasionally, cleanup
 unsuccessful. This does not
-constitute a problem in any way, as the harness starts with a clean
+constitute a problem in any way, as the harness for most suites starts
+with a clean
 database, and clean copies of all files. However, you will see
 something like this in the output:&lt;/small&gt;&lt;br&gt;
 &lt;small&gt;Warning: Cleanup failed on baseDir:
+&lt;small&gt;&lt;a name="Note4:_"&gt;&lt;/a&gt;Note4: &lt;br&gt;
+&lt;div style="margin-left: 40px;"&gt;&lt;small&gt;NetServer also has a
+configuration for connecting to DB2 via jcc - the IBM Universal Driver
+- and via the older DB2 driver. But there are currently no tests to
+exercise these settings.&lt;/small&gt;&lt;br&gt;

View raw message