db-derby-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Apache Wiki <wikidi...@apache.org>
Subject [Db-derby Wiki] Update of "siddharthsrivastava/QuickStartGuide_NewDevelopers" by siddharthsrivastava
Date Tue, 19 Apr 2011 11:01:48 GMT
Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Db-derby Wiki" for change notification.

The "siddharthsrivastava/QuickStartGuide_NewDevelopers" page has been changed by siddharthsrivastava.
http://wiki.apache.org/db-derby/siddharthsrivastava/QuickStartGuide_NewDevelopers?action=diff&rev1=22&rev2=23

--------------------------------------------------

  ||<tablestyle="margin-left: 1.25in; border-collapse: collapse; border: medium none;"width="127px"
style="border: 1pt solid black; padding: 0in 5.4pt; vertical-align: top;">Operating System
||<width="391px" style="border-width: 1pt 1pt 1pt medium; border-style: solid solid solid
none; border-color: black black black -moz-use-text-color; padding: 0in 5.4pt; vertical-align:
top;">Command ||
  ||<width="127px" style="border-width: medium 1pt 1pt; border-style: none solid solid;
border-color: -moz-use-text-color black black; padding: 0in 5.4pt; vertical-align: top;">Linux
||<width="391px" style="border-width: medium 1pt 1pt medium; border-style: none solid solid
none; border-color: -moz-use-text-color black black -moz-use-text-color; padding: 0in 5.4pt;
vertical-align: top;">export DERBY_HOME=/home/<username>/derby/trunk ||
  ||<width="127px" style="border-width: medium 1pt 1pt; border-style: none solid solid;
border-color: -moz-use-text-color black black; padding: 0in 5.4pt; vertical-align: top;">Windows
||<width="391px" style="border-width: medium 1pt 1pt medium; border-style: none solid solid
none; border-color: -moz-use-text-color black black -moz-use-text-color; padding: 0in 5.4pt;
vertical-align: top;">set DERBY_HOME=C:\derby\trunk ||
- ||<width="127px" style="border-width: medium 1pt 1pt; border-style: none solid solid;
border-color: -moz-use-text-color black black; padding: 0in 5.4pt; vertical-align: top;">Mac
OSX ||<width="391px" style="border-width: medium 1pt 1pt medium; border-style: none solid
solid none; border-color: -moz-use-text-color black black -moz-use-text-color; padding: 0in
5.4pt; vertical-align: top;"> export DERBY_HOME=/Users/<username>/derby/trunk ||
+ ||<width="127px
  
- 
- (ii)Make sure that java is included in your classpath. To test it run java –version from
the command prompt(windows)/terminal(linux).
- 
- (iii)Set PATH variable
- 
- ||<tablestyle="margin-left: 1.25in; border-collapse: collapse; border: medium none;"width="127px"
height="17.05pt" style="border: 1pt solid black; padding: 0in 5.4pt; vertical-align: top;">Operating
System ||<width="391px" height="17.05pt" style="border-width: 1pt 1pt 1pt medium; border-style:
solid solid solid none; border-color: black black black -moz-use-text-color; padding: 0in
5.4pt; vertical-align: top;">Command ||
- ||<width="127px" style="border-width: medium 1pt 1pt; border-style: none solid solid;
border-color: -moz-use-text-color black black; padding: 0in 5.4pt; vertical-align: top;">Linux
/ OSX ||<width="391px" style="border-width: medium 1pt 1pt medium; border-style: none solid
solid none; border-color: -moz-use-text-color black black -moz-use-text-color; padding: 0in
5.4pt; vertical-align: top;">export PATH="$DERBY_HOME/bin:$PATH" ||
- ||<width="127px" style="border-width: medium 1pt 1pt; border-style: none solid solid;
border-color: -moz-use-text-color black black; padding: 0in 5.4pt; vertical-align: top;">Windows
||<width="391px" style="border-width: medium 1pt 1pt medium; border-style: none solid solid
none; border-color: -moz-use-text-color black black -moz-use-text-color; padding: 0in 5.4pt;
vertical-align: top;">set PATH=%DERBY_HOME%\bin;%PATH% You can also add %DERBY_HOME%\bin
at   the of the system path from Control Panel. ||
- 
- 
- (iv)Setting CLASSPATH: Following are the jars that needs to be included in your classpath
- 
- ||<tablestyle="margin-left: 0.75in; border-collapse: collapse; border: medium none;"width="283px"
style="border: 1pt solid black; padding: 0in 5.4pt; vertical-align: top;">'''Jar name'''
||<width="283px" style="border-width: 1pt 1pt 1pt medium; border-style: solid solid solid
none; border-color: black black black -moz-use-text-color; padding: 0in 5.4pt; vertical-align:
top;">'''Purpose''' ||
- ||<width="283px" height="19.75pt" style="border-width: medium 1pt 1pt; border-style:
none solid solid; border-color: -moz-use-text-color black black; padding: 0in 5.4pt; vertical-align:
top;">jakarta-oro-2.0.8.jar  (trunk\tools\java) ||<width="283px" height="19.75pt" style="border-width:
medium 1pt 1pt medium; border-style: none solid solid none; border-color: -moz-use-text-color
black black -moz-use-text-color; padding: 0in 5.4pt; vertical-align: top;">Required for
running Derby harness tests ||
- ||<width="283px" style="border-width: medium 1pt 1pt; border-style: none solid solid;
border-color: -moz-use-text-color black black; padding: 0in 5.4pt; vertical-align: top;">derbyTesting.jar
||<width="283px" style="border-width: medium 1pt 1pt medium; border-style: none solid solid
none; border-color: -moz-use-text-color black black -moz-use-text-color; padding: 0in 5.4pt;
vertical-align: top;">test files and classes ||
- ||<width="283px" style="border-width: medium 1pt 1pt; border-style: none solid solid;
border-color: -moz-use-text-color black black; padding: 0in 5.4pt; vertical-align: top;">derby.jar
||<width="283px" style="border-width: medium 1pt 1pt medium; border-style: none solid solid
none; border-color: -moz-use-text-color black black -moz-use-text-color; padding: 0in 5.4pt;
vertical-align: top;">main derby package classes ||
- ||<width="283px" style="border-width: medium 1pt 1pt; border-style: none solid solid;
border-color: -moz-use-text-color black black; padding: 0in 5.4pt; vertical-align: top;">derbytools.jar
||<width="283px" style="border-width: medium 1pt 1pt medium; border-style: none solid solid
none; border-color: -moz-use-text-color black black -moz-use-text-color; padding: 0in 5.4pt;
vertical-align: top;">derby tools classes for tools like ij   and dblook ||
- ||<width="283px" style="border-width: medium 1pt 1pt; border-style: none solid solid;
border-color: -moz-use-text-color black black; padding: 0in 5.4pt; vertical-align: top;">derbyrun.jar
||<width="283px" style="border-width: medium 1pt 1pt medium; border-style: none solid solid
none; border-color: -moz-use-text-color black black -moz-use-text-color; padding: 0in 5.4pt;
vertical-align: top;">executable jar file for tools like ij   and dblook ||
- ||<width="283px" style="border-width: medium 1pt 1pt; border-style: none solid solid;
border-color: -moz-use-text-color black black; padding: 0in 5.4pt; vertical-align: top;">derbynet.jar
||<width="283px" style="border-width: medium 1pt 1pt medium; border-style: none solid solid
none; border-color: -moz-use-text-color black black -moz-use-text-color; padding: 0in 5.4pt;
vertical-align: top;">derby network server classes ||
- ||<width="283px" height="20.2pt" style="border-width: medium 1pt 1pt; border-style: none
solid solid; border-color: -moz-use-text-color black black; padding: 0in 5.4pt; vertical-align:
top;">derbyclient.jar ||<width="283px" height="20.2pt" style="border-width: medium 1pt
1pt medium; border-style: none solid solid none; border-color: -moz-use-text-color black black
-moz-use-text-color; padding: 0in 5.4pt; vertical-align: top;">derby client classes ||
- ||<width="283px" style="border-width: medium 1pt 1pt; border-style: none solid solid;
border-color: -moz-use-text-color black black; padding: 0in 5.4pt; vertical-align: top;">junit.jar
||<width="283px" style="border-width: medium 1pt 1pt medium; border-style: none solid solid
none; border-color: -moz-use-text-color black black -moz-use-text-color; padding: 0in 5.4pt;
vertical-align: top;">assertion-based test machinery. It needs to be   manually put into
trunk/tools/java directory.     See BUILDING.html for details.   It is required for running
JUnit tests in Derby ||
- 
- 
- For Derby checked out from the trunk, the classpath should be set as follows:  Say, you
want to add derbyclient.jar to the classpath:
- 
- ||<tablestyle="margin-left: 54.9pt; border-collapse: collapse; border: medium none;"width="222px"
style="border: 1pt solid black; padding: 0in 5.4pt; vertical-align: top;">Operating System
||<width="343px" style="border-width: 1pt 1pt 1pt medium; border-style: solid solid solid
none; border-color: black black black -moz-use-text-color; padding: 0in 5.4pt; vertical-align:
top;">Command ||
- ||<width="222px" style="border-width: medium 1pt 1pt; border-style: none solid solid;
border-color: -moz-use-text-color black black; padding: 0in 5.4pt; vertical-align: top;">Linux
/ OSX ||<width="343px" style="border-width: medium 1pt 1pt medium; border-style: none solid
solid none; border-color: -moz-use-text-color black black -moz-use-text-color; padding: 0in
5.4pt; vertical-align: top;">export CLASSPATH=$DERBY_HOME/sane/jars/derbyclient.jar ||
- ||<width="222px" style="border-width: medium 1pt 1pt; border-style: none solid solid;
border-color: -moz-use-text-color black black; padding: 0in 5.4pt; vertical-align: top;">Windows
||<width="343px" style="border-width: medium 1pt 1pt medium; border-style: none solid solid
none; border-color: -moz-use-text-color black black -moz-use-text-color; padding: 0in 5.4pt;
vertical-align: top;">set CLASSPATH=%DERBY_HOME%\jars\sane\derbyclient.jar ||
- 
- Note: It is advisable to set the classpath only for the session for Derby if you have other
versions of junit, jakarta-oro etc. set in the global classpath.
- To set the classpath for only a session: set the classpath from the terminal/command window.
- 
- b) __Building Derby from source:__
-     Refer to [[http://svn.apache.org/viewvc/db/derby/code/trunk/BUILDING.html?view=co|BUILDING.html]]
for  detailed instructions.
- 
- c) __Running Regression Tests__
-      There are two types of test in Derby: Harness Tests and [[http://wiki.apache.org/db-derby/IntroToJUnit|JUnit]]
Tests. We are converting the harness tests to       JUnit Tests . [[http://wiki.apache.org/db-derby/KillDerbyTestHarness#Goals|Why]]
? Whenever you make changes to the code, these tests need to be run so as to make sure that
the changes didn’t break any other part of Derby.
- 
-    To run '''suites.All''' (the suite that runs all the JUnit tests in Derby), add junit.jar
to your classpath and run:
- 
-    ''                 ''java -XX'':''MaxPermSize=512m  junit''.''textui''.TestRunner ''org.apache.derbyTesting.functionTests.suites.All
- 
-    (Note: It can take approximately 4-6 hours for regression tests to complete)
- 
-    To run derbyAll (the suite for running harness tests in Derby), add jakarta-oro-2.0.8.jar
 to your classpath and run:
- 
-    ''                                ''java org'''.'''apache'''.'''derbyTesting'''.'''functionTests'''.'''harness'''.''''''''RunSuite
'''   ''derbyall''' '''
- 
-    ''' '''For detailed information about tests''', '''refer'''  [[http://svn.apache.org/viewvc/db/derby/code/trunk/java/testing/README.htm?view=co|Testing
README]] '''
- 
- '''Developer Tips:'''''' '''
- 
- 1) While running tests, clean your current directory containing any artifacts from previous
tests. Refer''' [[https://issues.apache.org/jira/browse/DERBY-5129|DERBY-5129]] '''
- 
- 2) When you rebuild Derby,  if you face issues related to the build procedure (buildjars),
not being able to overwrite some of the existing jars, delete the existing jars from trunk/jars/sane
directory and run the buildjars (ant –quiet buildjars) again.See''' [[https://issues.apache.org/jira/browse/DERBY-5128|DERBY-5128]]
'''
- 

Mime
View raw message