README.txt - The README file.
lib/hypersonic-license.txt - License agreement to use Hypersonic database.
lib/jakarta-commons-license.txt - License agreement to use Jakarta Commons libraries.
lib/serp-license.txt - License agreement to use Serp libraries.
lib/sun-treetable-license.txt - License agreement to use Sun's treetable.
lib/xanlan-license.txt - License agreement to use Apache Xanlan Project software.
lib/xerces-license.txt - License agreement to use Apache Xerces Project software.
Follow the instructions in the appropriate installation section below.
Note that if you are reading this in the README.txt file, the online documentation can be found at:
http://download.oracle.com/docs/cd/E13189_01/kodo/docs40/index.html
If you received this package on a CD, you will need to download a valid license key from: http://ftpmain.bea.com/download/pub/license/kodo/kodo40/license.bea While obtaining your license key, we highly recommend that you download the latest version of Kodo.
There may be significant differences to properties, mappings, and internal APIs between major releases of Kodo. For information about how to upgrade from a previous Kodo versions, see Appendix D of the Kodo Reference Guide.
A valid Kodo license key. Evaluation keys are available at: http://ftpmain.bea.com/download/pub/license/kodo/kodo40/license.bea
JDK 1.5 or higher for JPA; JDK 1.2 or greater for JDO.
A relational database with JDBC driver, such as Oracle, IBM DB2, Microsoft SQLServer, Sybase, Pointbase, MySQL, PostgreSQL, or Hypersonic SQL. This installation is bundled with Hypersonic, which requires no installation and minimal configuration.
KODOHOMEThis is the directory where you installed Kodo.
JDKHOMEThis is the directory where you installed the JDK.
Read and agree to any third party license agreements.
Edit KODOHOME/bin/kodocmd.bat and KODOHOME/bin/kodocommand.bat so that
KODODIR and JDKHOME are set correctly.
Run KODOHOME/bin/kodocmd.bat or KODOHOME/bin/kodocommand.bat. (The former
relies on 'cmd', the command shell for Windows XP, 2000, and NT; the latter
uses 'command', the command shell for Windows ME, 98, and 95.) All tutorial
commands should be executed from this shell.
Open http://download.oracle.com/docs/cd/E13189_01/kodo/docs40/index.html For JPA, navigate to the Kodo JPA Tutorials. For JDO, navigate to the Kodo JDO Tutorials. These tutorials are in Part IV of the Kodo documentation.
Change to the KODOHOME/tutorial/persistence directory or the
KODOHOME/tutorial/jdo directory.
Start the tutorial.
Open a shell.
Ensure that your CLASSPATH environment variable contains the base
Java runtime package ($JDKHOME/jre/lib/rt.jar for JDK 1.2 or higher).
Change to the KODOHOME directory.
Type 'chmod a+x bin/*'. This will give you execute permissions on all
packaged shell scripts.
Type 'source bin/envsetup' (On Windows with Cygwin, type
'source bin/cygsetup'). This will modify your CLASSPATH and PATH
environment variables to add in the libraries in KODOHOME/lib and the
executables in KODOHOME/bin.
Open http://download.oracle.com/docs/cd/E13189_01/kodo/docs40/index.html For JPA, navigate to the Kodo JPA Tutorials. For JDO, navigate to the Kodo JDO Tutorials. These tutorials are in Part IV of the Kodo documentation.
Change to the KODOHOME/tutorial/persistence directory or the
KODOHOME/tutorial/jdo directory.
Start the tutorial.
Problem: Shell error when running 'javac *.java' or when using 'java'
Solution: Ensure that java and javac are installed and in your path.
To verify that they are installed, type 'java' on a line
by itself. If this returns a usage statement, then java
is installed and in your path. Repeat with 'javac' instead of
'java' to see if javac is installed correctly.
If these tests fail, install JDK 1.2 or greater. Also, please
make sure that kodocmd.bat sets up your path properly.
Problem: When running 'kodoc', you get a NoClassDefFoundError with
a message like the following:
java.lang.NoClassDefFoundError: Animal (wrong name: tutorial/persistence/Animal)
Solution: This often means that you are invoking kodoc from the directory
that contains the class Animal, and '.' is in your classpath.
Fixing your classpath or running kodoc from a different directory
should solve this problem.
Problem: A 'sealing violation' occurs when running the enhancer.
Solution: This indicates that some other library in your CLASSPATH is
conflicting with the jars packaged with this distribution.
If you have any technical questions while evaluating or installing Kodo,
please send an email to <support@solarmetric.com>.
The web site (http://www.solarmetric.com) has Kodo development resources, including frequently asked questions, our bug tracking system, Kodo newsgroups, access to technical support, and links to a variety of technical articles and third party tutorials.
|
|