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.4 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.