These release notes include:
jar, WinZip 6.0 or higher, or another ZIP extraction tool.
gtar, to extract files.
The minimum recommended system configuration is:
Note: The disk space specified above reflects the minimum system requirements to install and run the Enhydra example applications. A minimum installation consists of:
make system was changed in stdconf.mk from "\;" to ";" to make Enhdyra compatible with JDK 1.3. This is relevant when you build a legacy Enhydra application on Windows if your project incorporated custom make rules that used the variable PS, defined in stdrules.mk. To migrate to the new syntax, add double quotes around the entire path that uses PS. For example:
ENHYDRA_CLASSPATH=/a/b$(PS)/c/d
is changed to:
ENHYDRA_CLASSPATH="/a/b$(PS)/c/d"
./configure script, in .conf files, and when adding JARs to the CLASSPATH, use the <drive>:/<dir> format in place of //<drive>/<dir>. If you have installed Enhydra on a drive other than your Cygwin drive, the .configure script will incorrectly calculate your <ENHYDRA_DIR> using //<drive>/<dir>. You will have to manually edit the script to point to your <ENHYDRA_DIR>. This may occur in other scripts and Makefiles.
.mk variable definitions.
newapp script has been replaced by the more full-featured appwizard command-line and GUI tool. (Bug 10241)
getElementById()), the LazyDOM may be slower. In which case, compiling with -dom xerces will revert to the standard DOM.
idb.jar and jta-spec1_0_1.jar in the @OUTPUT@/../libdirectory. Make sure you copy the InstantDB JAR files to this directory.
-urlmapping in the XMLC wizard, it should not have double or single quotes around the mapped files. For example, adding -urlmapping "Welcome.html" "Welcome.po" does not work. -urlmapping Welcome.html Welcome.po does work. Quoted files do work, however, when you use xmlc from the command line. (Bug 10449)
make. There is no way to run DODS to create data objects and create the tables in your database from within Kelp. (Bug 10403)
.xml file type is not included by default in the XMLC types tab in the XMLC wizard. Add xml as a new extension. (Bug 10438)
CreateVirgin factory. The parameterless constructor for BDOs was public, but the parameterless constructor for DOs is private. For example, if you had code that uses:
SomeBDO mybdo = new SomeBDO();
you can not just replace it with:
SomeDO mydo = new SomeDO();It must be replaced with:
SomeDO mydo = SomeDO.CreateVirgin();
The workaround is to always change the name of the 'root' (base) package as the first step when creating a new .doml file. If you must change a package name, edit the .doml file by hand to make the change. Always make a backup copy before editing a .doml file by hand.
The workaround is to always create a new DO in the base package, and then drag it to the desired package.
.bashrc file. Either don't install the Cygwin tools from the installer, or make a backup copy of your .bashrc file before installing Enhydra 3.1. (Bug 10096)
writeHTML() instead of writeDOM() due to the XHTML content type defined by writeDOM() not being viewable in any browsers. (Bug 10307)
appwizard in Unix with no X Windows session running, you will get an exception. Set the DISPLAY environment variable to refer to a valid X session. (Bug 10493)
Enhydra applications and Servlet 2.2 contexts (a "web app") can be accessed through multiple URLs. This is achieved by creating more than one connection method. In the case of Servlet 2.2 Web applications there is a restriction that each connection method must have the same URL path prefix (the port number may be different).
In general, multiple connection methods are discouraged. They are useful for providing a "special" access path to an application for debugging or for privileged access to an application designed for such purposes.
The GUI of the Enhydra object-to-relational mapping technology is provided as a convenience. It does not prevent the operator from creating illegal mappings that cannot be automatically built or that can cause errors in the tool. Careful use of the tool can prevent these errors. The user is encouraged to edit the DOML (XML specification file created by the DODS GUI) directly and run DODS in command line mode to avoid these problems. See the latest DODS documentation in the documentation.
When debugging Servlet 2.2 applications, you may occasionally see duplicate entries. This is caused by the Servlet 2.2 internal redirection mechanism or "server side redirect" and correspond to a single client request. The debugger picks up each of these requests, hence the two entries.
To report Enhydra bugs, please submit them at http://www.enhydra.org/community/resources/bugReports/index.html. Be sure to include the steps to reproduce the problem, exact error messages, and code snippets, if applicable, to help us better evaluate your report.