Copyright © 2006 Together Teamlösungen EDV-Dienstleistungen GmbH
All rights reserved. No part of this publication may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, electronic, mechanical, photocopying, recording or otherwise, without the prior written permission of the Together Teamlösungen EDV-Dienstleistungen GmbH.
Together Teamlösungen EDV-Dienstleistungen GmbH DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
Table of Contents
Together Application Server (TAS) differs a lot from the previous Enhydra versions. It is an application server which consist of application framework (collection of Java classes, which provide the runtime infrastructure for TAS applications) and TAS tools used for TAS applications developing. It supports servlet 2.4 specification.
Servlet container is not a part of TAS any more, but it is needed for running TAS applications. Any servlet container that supports servlet 2.3 specification can be used for running TAS applications. Tomcat, used as server container is included with TAS distribution.
The minimum recommended system configuration is:
512 MB RAM
400 MHz processor or better
500 MB disk space (see note below)
Java Development Kit (JDK) 1.4.x
NOTE: The disk space specified above reflects the minimum system requirements to install and run the TAS example applications. A minimum installation consists of:
JDK 1.4.x (approximately 70 MB)
Together Application Server (approximately 430 MB)
This chapter lists the new or updated features associated with TAS 7.1-1.
News and bugs fixing (not in Task list):
Together Application Framework maintenance - release 7.1-1 binaries are included.
DODS API is integrated in EAF API now (not part of DODS any more).
SessionManager functionality extended with empty session path support.
EmptySessionPath - new SessionManager configuration parameter whitch determins whether to use empty path (/) as session cookie path attribute value! Recognized values are true or false (default is false).
Request/Response pre/post processing:
Introduced profiling mechanism.
org.enhydra.util.ajaxforms - package contains sample response post-processor implementation (and utility classes) as integrated support for AjaxForms XForm engine.
Chiba pre-processing enabled scripting (Ajax) support! Because of this we've integrated DWR (version 1.1.3) project binaries.
Together Relational Objects maintenance - release 7.1-1 is included.
Thanks to Juan Pablo Rojas Jiménez LocalContextFactory is improved to support clean-up.
JOTM's DataSource factory patched to enable clean server shutdown.
Two new transaction factories introduced: both reduce unnecessary locks of the main cache wrapper class.
Several cache bugs fixes.
Together Application Cluster maintenance - release 7.1-1 included.
Tomcat 5.5 Connector
Getting Remote user principal problems resolved - form authentication problems are salved.
Empty request parameter now gets empty string value.
'emptySessionPath' - new configuration option. This parameter (if set on true) sets Path attribute of the session (JSESSIONID) cookie to the root one ("/"). This way we are able to share same session key across multiple applications (their contexts). Default parameter value is false!
Windows Setup Procedure
Introduced new dialog for setting TIME_WAIT (TcpTimedWaitDelay) value.
Windows Setup Procedure
Setts Together Workflow Editor (JaWE) as default application for 'xpdl' file extension.
TAS Configuration Converter (conf2xml)
"mode" parameter supported - signaling two operational modes
conf2xml
xml2conf
Chiba (XForm engine) demo application included.
XMLC maintenance - release 2.2-16 binaries are included.
Quartz maintenance - release 1.5.2 binaries are included.
NSIS maintenance - release 2.23 binaries are included.
Together Workflow Editor maintenance - release 2.1-1 binaries are included.
Together Workflow Server maintenance - release 2.0-1 binaries are included.
SharkWebClient application included as a part of new TWS release.
Together Search Server maintenance - release 1.0-15 binaries are included.
Admin application
Database reconnection attempt added.
Option for reading special characters in filenames added.
Current operation logging added(reading metadata list, include list...)
Preview application
Zoom-in or zoom-out option removes header from image preview page.
Direct Web Remoting (DWR) binaries included in this release - allows Javascript in a browser to interact with Java on a server and helps you manipulate web pages with the results. DWR is Easy Ajax for Java.
AjaxForms (XForms engine implementation) binaries are included in this release.
New Listener Implementation
DataSourceListener - Enables clean server shutdown in JOTM (DataSourcefactory) usage scenario.
New Valve Implementation
EnhydraSingleSignOnValve - SessionData and Principal replication tool. Suports replication across multiple applications deployed in the same or different tomcat service instances.
introduced sharkWebClient - demo application that administrates Together Workflow Server
introduced travelWizard - demo application, extension of sharkWebClient (source is included under demos-sources)
This chapter lists the new or updated features associated with TAS 7.0-6.
News and bugs fixing (not in Task list):
Together Relational Objects maintenance - release 7.0-6 is included.
JOTM's DataSource factory patched to read addtional parameters.
Several cache bugs fixes.
Together Data Transformer maintenance - release 3.6-3 binaries are included.
Improved relations mechanism to support result set with more rows as result of the relation.
CsvJdbc, support for input strings which contains ".
Several bug fixes.
Together Demo Applications maintenance - release 7.0-6 is included.
jtaDiscRack - configuration and coding sample implementation enabling synchronous and asynchronous DO cache load.
SimpleCacheAdmin application improved:
added new action - initialization of asynchronous caches.
visual style changed.
This chapter lists the new or updated features associated with TAS 7.0-5.
News and bugs fixing (not in Task list):
Together Relational Objects maintenance - release 7.0-5 is included.
XML column type support.
Database Manager API has gone to EAF/Together Application Framework.
Statistics and Include for Index extended to support DB2 and Oracle.
Added new parameter NextColumnType - type of column which contains next available value for "oid".
Together Application Framework maintenance - release 7.0-5 binaries are included.
Request/Response pre/post processing
Chiba pre-processing enabled scripting (Ajax) support.
Introduced generic XSLT pre and post processor.
Together Search Server maintenance - release 1.0-11 binaries are included.
Together Search Server
Admin application
Support to index WebDAV.
Reconstruction of index FTP. Support to index subfolders.
Introduction the size of the file (New field in index).
Introduction the owner of the file (New field in index).
Support to index WebDAV file metadata : 'created' and FTP file metadata : 'owner' are introduced.
Support to index the 'Author' and 'Last saved By' compound file metadata(Word, Excel and Power Point documents), E-Mail metadata( 'From', 'To', 'CC', 'BCC' and 'Subject'), according to this new fields in Lucene index are introduced.
Search application
Introduction of search through file metadata : created, accessed, owner.
Introduction of search through sent/received dates of e-mails.
Result page of search shows search parameters and fill search input field and sites search boxes again.
E-mail search is introduced, search over E-mail specific properties : 'From', 'To', 'CC', 'BCC' and 'Subject'.
Support of sorting result of e-mail search : 'by newest/oldest sent/received E-mail files' and 'by From/To E-mail is sent'.
Introduction of advanced search through file metadata : 'Author' and 'Last saved By' .
New look is introduced.
Parser
Power Point, Word and Excel parser, support to extract compound file metadata ('Author', 'Last saved By' ...).
Together Demo Applications maintenance - release 7.0-5 is included.
fopApplet - added parameters for postProcessor.
trawelWizard - removed from project.
workListHandler - removed from project.
Tomcat maintenance - release 5.5.20 binaries are included.
XMLC maintenance - release 2.2-11 binaries are included.
HSQL maintenance - release 1.8.0 binaries are included.
Integrated Enhydra Realm (version 1.0) - "database" of usernames and passwords that identify valid users of a web application (or set of web applications), plus an enumeration of the list of roles associated with each valid user. Realm uses TRO for database connection.
Integrated Enhydra Valve (version 1.0) - represents a component that will be inserted into the request processing pipeline for the associated Catalina container. Valve performs logging in the database and uses TRO for database connection.
Introduced Wrapper parameters for installing service under specific account. This parameters can be configured directly (by changing <TAS_HOME>/conf/wrapper.conf) or by using configuration batch file (<TAS_HOME>/enhydra/configure.bat). In both ways using specific account for service can be turned on or not. If turned on, username for account must be specified. For account password there is an option of prompting for password or entering it . In first case user will be prompt for password when installing the service. In second case password is written in plain text format in build.properties and wrapper.conf (so be careful about this). More about this parameters can be found here.
Documentation look and organization changes.
This chapter lists the new or updated features associated with TAS 7.0-4.
News and bugs fixing (not in Task list):
Together Relational Objects maintenance - release 7.0-4 is included.
Added support for STATISTICS create statements depending on parameter in dbVendor conf file.
Added support for statistics element in doml for create statistics statements.
Added support for includeIndexColumn in index as index extension.
Together Search Server maintenance - release 1.0-10 binaries are included.
Together Search Server
Admin application
Support for modification of configuration files.
Support for index process without 'TAS' running.
New application parameters are introduced according to this new functionality is added. Pure text of excel file is stored in index and converted text (HTML) is saved to file system.
Search application
Reread configuration files every x minutes.
Introduction of search suggest logic.
Together Document Viewer
Parse/display containers files(Archive) with subpath of contents (zip and tgz), subpaths as "directory".
Picture "zoom" links in preview of pictures is added.
Display Excel files preview as HTML table (separate preview HTML from indexed data for search).
Support of register "Together Document Viewer" action for Windows file types.
Reread configuration files every x minutes.
Parser
Excel parser, support for converting excel file to html file.
MSG/EML parser, more mail metadata is introduced.
Together Workflow Server maintenance - release 2.0-beta5 binaries are included.
Fixed bug in AssignmentFilterBuilderDODS in method addPackageIdEquals().
Fixed bug in ProcessFilterBuilderDODS in method setOrderByResourceRequesterId().
Together Application Framework maintenance - release 7.0-4 binaries are included.
Request/Response pre/post processing:
Chiba pre-processing logic changed in order to enable standardized XForm engine submission handle!
FormFaces post-processor implemented as another XForm engine support!
PDF post-processor implementation changed to support all FOP output formats (PDF, XML, TXT, SVG, MIF, PS, PCL). Therefore, according to new functionality present implementation changed name from 'Fo2PdfResponsePostProcessor' to 'Fo2FopResponsePostProcessor'.
Together Demo Applications maintenance - release 7.0-4 is included.
workListHandler - improved L&F and functionality of work-list and process list; added administrative functionality: to handle XPDL repository, to handle Packages and Process Instantiation section to view all process factories, enable/disable factories and instantiate processes.
travelWizard - implemented as workListHandler extension.
Contract view supports multiple formats - implemented demonstration of new FOP post-processing TAF features.
Configuration of garbage collector implemented in configurator.
Added option in setup to include Together Document Previewer in context (right-click) menu.
Added option in setup to index TAS documentation.
Complete new look of documentation.
Added new parameter in configuration - Tomcat Service Name.
This chapter lists the new or updated features associated with TAS 7.0-3.
News and bugs fixing (not in Task list):
Together Relational Objects maintenance - release 7.0-3 is included.
Together Search Server maintenance - release 1.0-9 binaries are included.
Together Application Cluster maintenance - release 7.0-3 binaries are included.
Together Application Framework maintenance - release 7.0-3 binaries are included.
Enhydra Demos maintenance - release 7.0-3 is included.
Added configuration of garbage collector in setup and in configuration script (not yet implemented in configurator).
Together Development Studio removed from TAS (moved to Kelp project).
Together Search Server no more includes indexed TAS documentation.
Added batch file for automatic indexing of TAS documentation.
First letter of most demo applications names changed to lowercase.
Added copyright element in all TAS documentation files.
This chapter lists the new or updated features associated with TAS 7.0-2.
News and bugs fixing (not in Task list):
Integrated new demo application - TravelWizard. It is an example of usage Together Application Framework (TAF), XForms, Chiba, XMLC and Together Workflow Server (TWS). It acts like simple software for traveling agency.
Updated demo application - WorkListHandler
Removed tool jaxb.
Removed tool Zeus.
Integrated XMLBeans (version 2.2.0) - technology for accessing XML by binding it to Java types.
Integrated Chiba (version 1.2) - an open-source Java Implementation of the W3C XForms standard.
Together Relational Objects maintenance - release 7.0-2 is included.
Together Search Server maintenance - release 1.0-8 binaries are included.
Together Application Cluster maintenance - release 7.0-2 binaries are included.
Together Application Framework maintenance - release 7.0-2 binaries are included.
Together Workflow Editor maintenance - release 2.0-5 is included.
Together Workflow Server maintenance - release 2.0-beta3 is included.
Together Development Studio (Enhydra IDE) - integrated Eclipse version 3.2
Together Data Transformer maintenance - release 3.6-2 is included.
Enhydra Demos maintenance - release 7.0-2 is included.
DocBook maintenance - release 1.70.1 is included.
FOP maintenance - release 0.20.5 is included.
JAF maintenance - release 1.1 is included.
JavaMail maintenance - release 1.4 is included.
Axis maintenance - release 1.4 is included.
Wrapper maintenance - release 3.2.0 is included.
XMLC maintenance - release 2.2.10 is included.
This chapter lists the new or updated features associated with TAS 7.0-1.
News and bugs fixing (not in Task list):
Name changes:
from Enhydra to Together Application Server (TAS)
from Enhydra IDE to Together Development Studio (TDS)
from Enhydra Shark to Together Workflow Server (TWS)
from Enhydra Director to Together Application Cluster (TAC)
from Octopus to Together Data Transformer (TDT)
from Snapper to Together Search Server (TSS)
from Oyster to Together Java S/MIME (TJS)
Integrated Xalan (version 2.7.0) - XSLT processor for transforming XML documents into HTML, text, or other XML document types.
Integrated jaxb (version 1.6) - tool that provides a convenient way to bind an XML schema to a representation in Java code.
Integrated WorkListHandler - demo application that demonstrates usage of TWS.
DODS maintenance - release 7.0-1 is included.
EAF maintenance - release 7.0-1 is included.
Xerces updated to version 2.8.0
Together Search Server (Snapper) maintenance - release 1.0-7 binaries are included.
Enhydra Demos maintenance - release 7.0-1 is included.
Together Workflow Server (Enhydra Shark) maintenance - release 2.0 is included.
Together Development Studio (Enhydra IDE) - added support for 64 bit Windows platforms
TWE maintenance - release 2.0-4 is included.
This chapter lists the new or updated features associated with Enhydra 7.0-beta1.
News and bugs fixing (not in Task list):
Tomcat maintenance - release 5.5.16 is included in this release.
IMPORTANT NOTE: Tomcat binary, included in this Enhydra release, is slightly modified.
Tomcat modifications are:
FORM Authentication
Initial BASIC authentication model is upgraded to FORM authentication model for Tomcat Manager and Host Manager application in order to enable more secure authentication option.
Default context path
Default context path is defined (trough 'index.html' page) for Tomcat Manager and Host Manager application.
Director Connector Administration
In order to enable 'Tomcat Admin' application based administration for Director Connector (just as for other HTTP and AJP connector implementations) we've modified:
'Tomcat Admin' application - deployed as separate package (not a part of original server binary),
org.apache.catalina.mbeans.MBeanFactory - additionally implemented creation of director connector option.
mbeans-descriptors.xml:
CoyoteConnector MBean
Extended with several attributes in order to enable administration of director connector specific parameters.
MBeanFactory MBean
Extended with 'createDirectorConnector' operation in order to enable creation of new Director Connector instance.
Tomcat native library updated to version 1.1.2 (from version 1.1.1).
DODS maintenance - release 7.0-beta1 is included.
EAF maintenance - release 7.0-beta1 is included.
Enhydra Demos maintenance - release 7.0-beta1 is included.
Enhydra Director maintenance - release 7.0-beta1 is included.
APR maintenance - release 1.1.2 (win32 and win64) binaries are included.
Enhydra IDE - setup changed.
Enhydra Server installation chooser dialog added.
Windows 64 Bit Support.
Enhydra Server distribution now includes separate binaries for 64 bit windows platforms (develop and runtime).
To enable support for all basic (multi)server functionalities we have additionally prepared 64 bit compatible DLLs for:
SysTray - enables Java applications access the system tray (used by EnTray).
Log4j - logging tool that enables possibility to append log messages to the NT event log system,
Wrapper - makes it possible to install a Java Application as a Windows NT Service.
NOTE: New Enhydra Server (64 bit) binaries do not include 64 bit compatible versions of:
Enhydra Director - Web server plugins for Apache, IIS and IPlanet supporting advanced load balancing / clustering and runtime administration.
Enhydra Conductor - Apache Jakarta Tomcat Connector (MOD JK).
Enhydra Octopus maintenance - release 3.6-1 binaries are included.
Enhydra Snapper maintenance - release 1.0-3 binaries are included.
Enhydra XMLC maintenance - release 2.2.9 binaries are included.
Barracuda maintenance - release 2.0 binaries are included.
Snapper maintenance - release 1.0-6 binaries are included.
Integrated TWE (version 2.0-3) Community Edition- Graphical Together Workflow Editor according to WfMC specifications supporting XPDL as its native file format. TWE can be used to edit workflow definitions for Enhydra Shark or every other XPDL conformant Workflow server..
Integrated Enhydra Shark (version 2.0-beta1) - Workflow server with a difference. Shark is completely based on standards from WfMC and OMG using XPDL as its native workflow definition language.
Integrated Enhydra Oyster (version 2.1-6) - Java library for SMIME signing and encryption using different key strengths and algorithms. It is developed with suport and testing for major E-Mail clients.
This chapter lists the new or updated features associated with Enhydra 6.6-2.
News and bugs fixing (not in Task list):
DODS maintenance - release 6.6-2 is included.
Bug fix in "QueryBuilder.compare()" method: fixed comparison of ObjectId vs. CoreDataStruct.
This chapter lists the new or updated features associated with Enhydra 6.6-1.
News and bugs fixing (not in Task list):
Tomcat maintenance - release 5.5.15 is included in this release.
IMPORTANT NOTE: Tomcat binary, included in this Enhydra release, is slightly modified.
Tomcat modifications are:
FORM Authentication
Initial BASIC authentication model is upgraded to FORM authentication model for Tomcat Manager and Host Manager application in order to enable more secure authentication option.
Default context path
Default context path is defined (trough 'index.html' page) for Tomcat Manager and Host Manager application.
Director Connector Administration
In order to enable 'Tomcat Admin' application based administration for Director Connector (just as for other HTTP and AJP connector implementations) we've modified:
'Tomcat Admin' application - deployed as separate package (not a part of original server binary),
org.apache.catalina.mbeans.MBeanFactory - additionally implemented creation of director connector option.
mbeans-descriptors.xml:
CoyoteConnector MBean
Extended with several attributes in order to enable administration of director connector specific parameters.
MBeanFactory MBean
Extended with 'createDirectorConnector' operation in order to enable creation of new Director Connector instance.
Enhydra Server Runtime distribution:
installation and configuration with JRE 5.0 enabled.
Enhydra Server:
For windows installation we have integrated APR binaries (supported by Tomcat 5.5.12).
EAF maintenance - release 6.6-1 is included in this release.
- Improved existing ('web.xml' defined) configuration parameter initialization (definition support). 'Config' object now supports different configuration parameter types (not only 'java.lang.String').
- Implemented encoding support for MIME header initialization
EnhydraDemos maintenance - release 6.6-1 is included.
Encoding Sample Application - Simple enhydra application that demonstrates basic encoded parameter handling.
Transactions Disc Rack Application - Implementation revised and application is (bu default) configured to use new enhydra DODS XAUserTransaction features.
Jta Disc Rack Application - This is a demonstration application for querying, inserting, deleting and updating a list Persons and their discs in a database. It uses enhydra DODS and it's newest XATransaction features. The default database is HSQL.
DODS maintenance - release 6.6-1 is included.
JOTM 2.0.10 integrated
Sequoia driver integrated
XMLC maintenance - release 2.2.8.1 is included.
Enhydra Manager - implemented WAR file upload functionallity.
Enhydra Configuration - implemented configuration process now allows basic JVM tuning:
jvmxms - initial JVM heap memory size,
jvmxmx - maximal JVM heap memory size,
jvmps - permanent generation size,
jvmmps - maximal permanent generation size.
Enhydra Configurator - adapted to support new Enhydra Server (JVM) configuration features.
Enhydra IDE - integraded new version based on Eclipse 3.1.2.
Enhydra Kelp maintenence - release 6.6-1 is included.
EMF (Eclipse Modeling Framework) - release 2.1.2 is included.
Appwizard - now offers generation of enhydra sample demo application with data layer.
Axis maintenance - release 1.2.1 is included.
APR maintenance - release 1.1.1 binaries are included.
Enhydra Conductor - apache pugin bases changed from MOD JK2 to MOD JK (1.2.14 release).
Octopus maintenance - release 3.5-1 is included.
This chapter lists the new or updated features associated with Enhydra 6.5-1.
News and bugs fixing (not in Task list):
Tomcat maintenance - release 5.5.9 is included in this release.
IMPORTANT NOTE: Tomcat binary, included in this Enhydra release, slightly modified.
Tomcat modifications are:
FORM Authentication
Initial BASIC authentication model is upgraded to FORM authentication model for Tomcat Manager and Host Manager application in order to enable more secure authentication option.
Director Connector Administration
In order to enable 'Tomcat Admin' application based administration for Director Connector (just as for other HTTP and AJP connector implementations) we've modified:
'Tomcat Admin' application - deployed as separate package (not a part of original server binary),
org.apache.catalina.mbeans.MBeanFactory - additionally implemented creation of director connector option.
mbeans-descriptors.xml:
CoyoteConnector MBean
Extended with several attributes in order to enable administration of director connector specific parameters.
MBeanFactory MBean
Extended with 'createDirectorConnector' operation in order to enable creation of new Director Connector instance.
org.apache.catalina.connector.Connector - We've included Tomcat CVS patch (posted at 06.06.2005.). Fixes connector initialization so sslProtocol is not required for SSL.
Enhydra Server Developer distribution:
Linux distribution now includes Enhydra IDE distribution. It is not deployed as separate distribution any more.
Enhydra Server Runtime distribution:
Tomcat demo applications are now excluded from Enhydra Server Runtime distribution binaries,
Enhydra Documentation files are additionally deployed.
Enhydra Documentation - now deployed as separate web application (placed in '<enhydra_root>/multiserver/webapps/enhydra-docs' directory).
EnTray:
SysTray updated to version 2.4.1
patched windows native implementation: resolved pop up - screen height problem (known EnTray menu display bug).
Refresh Application List - implemented new menu action which refreshes current list of deployed applications
For every single Enhydra service defined is realized as separate (service specific) 'Refresh Application List' menu item,
Group application list refresh (for all services configured - EnTray multiservice mode) is implemented as left EnTray icon click action.
EAF maintenance - release 6.5-1 is included in this release.
- Improved existing 'Container Adapter Session Management' implementation.
For better Tomcat session manager wrapping developed specialized implementation: com.lutris.appserver.server.sessionContainerAdapter.TomcatContainerAdapterSessionManager
EnhydraDemos maintenance - release 6.5-1 is included.
Enhydra Configurator - new enhydra tool for (re)configuration of existing and creation of new (pre-configured) CATALINA_BASE instances. For more detail explanation, please, consult enhydra documentation.
Enhydra Snapper - a full text search library / framework developed in Java (based on Apache Lucene) included in this release.
SimpleCacheAdmin - MBean based DODS administration tool included in this release as additional 'Enhydra Administration Application'.
This chapter lists the new or updated features associated with Enhydra 6.4-1.
News and bugs fixing (not in Task list):
Tomcat maintenance - release 5.5.9 is included in this release.
IMPORTANT NOTE: Tomcat binary, included in this Enhydra release, is patched. Patched java class is
org.apache.catalina.mbeans.MBeanFactory
placed in 'jakarta-tomcat-catalina' module. Pach enables creation of new 'Enhydra Director Connector' instance trough 'Tomcat Admin' application.
Beside this, we have implemented FORM authentication model for 'Tomcat Manager' and 'Tomcat Host Manager' application in order to enable more secure authentication for Tomcat management applications.
Additionally, we've adapted 'Tomcat Admin' application (separate package - not included in Tomcat server binary) in order to enable creation and configuration of 'Enhydra Director Connector' instances.
Implemented new 'Listener' module - Takes care of proper MBean Server (HTTP and/or RMI/JRMP) adaptor initialization and shutdown. Adaptor initialization and shutdown are realised trough 'org.enhydra.listener.AdaptorListener' class (implementation of 'org.apache.catalina.LifecycleListener' interface) which is included (during Enhydra configuration process) in basic 'Catalina' Engine definition ('server.xml' and 'server-minimal.xml' configuration files). It is initialized on Server startup and triggered during server startup and shutdown processes. Adaptor configuration parameters are read (by default) from 'adaptor.properties' file placed in '<enhydra_root>/multiserver/conf' directory. Property file is listeners configuration option and it can contain absolute or relative (from 'CATALINA_HOME' ('catalina.home') system (JVM) property) path to listener configuration file.
Server Configuration - Enhydra configuration process (ANT based configuration started trough 'configure' script or bach file) now supports a number of interesting and highly functional configuration options:
Connector configuration will allow you to enable or disable connector initialization at server startup and to select connector port setting. Existing configuration process supports:
non-SSL HTTP Connector
SSL HTTP Connector
AJP Connector
Director Connector
MBean Server Adaptor configuration will allow you to select authentication mode of initialized adapters,enable or disable adaptor initialization at server startup and to select adaptor port setting. Existing configuration process supports:
HTTP Adaptor
RMI/JRMP Adaptor
NOTE: If you specify adaptor authentication method on value other than 'none' (which is highly recommended for production environments) you will not be able to use Enhydra Console MBean administration tool (its initially defined Enhydra MBean Server Connection).
Server shutdown configuration:
Port
String
Admin user configuration:
User name
Password
NOTE: For further information regarding enhydra server configuration options please consult the 'README.txt' file placed in '<enhydra_root>/multiserver' directory.
Windows Setup - changed to allow access to all configuration parameter settings. Additionally, we've implemented optional installation of Tomcat Admin and Manager and Tomcat Demo applications (Tomcat Admin and Demo sections in Enhydra component setup).
Enhydra Admin Application - now modified to allow overview of all MBeans registered to MBean Server (including Attribute change and Operation invocation). Additionally, we've implemented application authentication support (FORM authentication model).
Enhydra Manager Application - now modified to support multiple 'Service' instances. Additionally, we've implemented new 'Delete' context functionallty (which acts the same as 'Undeploy'-'Tomcat Manager' action).
Enhydra Debugger - 'Intro' presentation object now modified to support multiple request schemes. Also, host and port URL attribute initialization was based on static configuration parameters (application configuration) and now are dynamically resumed from application request.
EnTray - now supports multiple Service, (SSL and non-SSL) HTML Connector and Host definitions.
Implemented Java 1.5 support - Enhydra configuration now detects Java version and removes (in case of Java 1.5 installation) Tomcat Compat (Java 1.4 and 1.3 compatibility) package installation.
NOTE: 'xercesImpl.jar' and 'xml-apis.jar' binaries are not deleted (only moved to '<enhydra_root>/multiserver/common/lib' directory) from '<enhydra_root>/multiserver/common/endorsed' directory because of 'Tomcat Admin' application runtime requirements.
EAF maintenance - release 6.4-1 is included in this release.
- New JMX MBean naming.
- Resolved problem with presentation resource caching.
- Changed 'MultiClassLoader' initialization.
EnhydraDemos maintenance - release 6.4-1 is included.
Octopus maintenance - release 3.4-1 (CVS version - 08.06.2005.) is included.
EnhydraIDE - we've developed two new EMF/GEF based graphical editors (plug-ins):
'DomlEditor' Eclipse plug-in for DODS "Data-Object-Model" files (.doml), with integrated validation and contents assist support.
'LoaderJobEditor' Eclipse plug-in for Octopus "Loader Job" files (.olj), with integrated validation and contents assist support.
Known Bugs:
EnTray - We've noticed some problems with EnTray menu display in situations when menu hight (depending on number of entries) is similar to Screen hight. In situations like this, workaround would be to remove one of deployed applications or to deploy another application in which case menu navigation arrows will be displayed.
This chapter lists the new or updated features associated with Enhydra 6.3-1.
(Task Id: 2209) WSABI For Axis (open source Web services management (WSM) project) - release 1.0RC1 is included in this Enhydra Server release.
News and bugs fixing (not in Task list):
Tomcat maintenance - release 5.5.9 is included in this release.
IMPORTANT NOTE: Tomcat binary, included in this Enhydra release, is pached. Pached java class is
org.apache.jk.common.JkMX
placed in 'jakarta-tomcat-connectors' module. Pach enables clean shutdown of Tomcats JMX Server with enabled rmi/jrmp protocol communication, necessary for EnTray.
Basicaly, the only thing changed is implementation of JMX shutdown (destroy method).
public void destroy() {
try {
log.info("Stoping JMX ");
if( httpServerName!=null ) {
mserver.invoke(httpServerName, "stop", null, null);
}
if (jrmpServerName!=null) {
if (adaptor!=null){
mserver.invoke(adaptor, "stop", null, null);
}
mserver.invoke(jrmpServerName, "stop", null, null);
}
} catch( Throwable t ) {
log.error( "Destroy error" + t );
}
log.info("JMX stopped!!!");
}As addition to existing implementation only thing we integrated is invocation of 'adaptor' stop method.
Enhydra Director maintenance - release 6.3-1 is included in this release.
- New "Rebalancing" mechanism – to support web server (Director) clustering (parallelism).
DODS maintenance - release 6.3-1 is included in this release.
- Java 5 compatibile
- New implementation of StandardConnectionAllocator and DataSourceConnectionAllocator.
- Several other fixes and enhancements.
Octopus maintenance - release 3.3-1 is included.
EAF maintenance - release 6.3-1 is included in this release.
- New JMX MBean model implemented.
EnhydraDemos maintenance - release 6.3-1 is included.
New application pair integrated:
tableApp: Axis Server (as Enhydra application) which returns 'Document' object as result of axis request.
tableAppClient: Axis client which presents 'Node' object extracted from 'Document' object received.
Axis maintenance - release 1.2RC2 is included.
Windows Setup - Developed silent installation support.
Toolbox - Enhydra Appwizard changed: Enhydra Application is default one now (instead of Web Application).
Known Bugs:
EnTray - We've noticed some problems with EnTray menu display in situations when menu hight (depending on number of entries) is similar to Screen hight. In situations like this, workaround would be to remove one of deployed applications or to deploy another application in which case menu navigation arrows will be displayed.
This chapter lists the new or updated features associated with Enhydra 6.2-2.
News and bugs fixing (not in Task list):
Tomcat maintenance - release 5.5.7 is included in this release.
IMPORTANT NOTE: Tomcat binary, included in this Enhydra 6.2 release, is pached. Pached java class is
org.apache.jk.common.JkMX
placed in 'jakarta-tomcat-connectors' module. Pach enables clean shutdown of Tomcats JMX Server with enabled rmi/jrmp protocol communication, necessary for EnTray.
Basicaly, the only thing changed is implementation of JMX shutdown (destroy method).
public void destroy() {
try {
log.info("Stoping JMX ");
if( httpServerName!=null ) {
mserver.invoke(httpServerName, "stop", null, null);
}
if (jrmpServerName!=null) {
if (adaptor!=null){
mserver.invoke(adaptor, "stop", null, null);
}
mserver.invoke(jrmpServerName, "stop", null, null);
}
} catch( Throwable t ) {
log.error( "Destroy error" + t );
}
log.info("JMX stopped!!!");
}As addition to existing implementation only thing we integrated is invocation of 'adaptor' stop method.
EnhydraDirector (EnhydraConnector) maintenance - release 6.2-2 is included in this release.
DODS maintenance - release 6.2-2 is included in this release.
Octopus maintenance - release 3.2-2 is included in this release.
EAF maintenance - release 6.2-2 is included in this release.
EnhydraDemos maintenance - release 6.2-2 is included in this release.
XMLC maintenance - release 2.2.6 is included in this release.
HSQL maintenance - release 1.7.3.2 is included in this release.
EnhydraIDE:
This chapter lists the new or updated features associated with Enhydra 6.2-1.
News and bugs fixing (not in Task list):
Tomcat maintenance - release 5.5.4 is included in this release.
IMPORTANT NOTE: Tomcat binary, included in this Enhydra 6.2 release, is pached. Pached java class is
org.apache.jk.common.JkMX
placed in 'jakarta-tomcat-connectors' module. Pach enables clean shutdown of Tomcats JMX Server with enabled rmi/jrmp protocol communication, necessary for EnTray.
Basicaly, the only thing changed is implementation of JMX shutdown (destroy method).
public void destroy() {
try {
log.info("Stoping JMX ");
if( httpServerName!=null ) {
mserver.invoke(httpServerName, "stop", null, null);
}
if (jrmpServerName!=null) {
if (adaptor!=null){
mserver.invoke(adaptor, "stop", null, null);
}
mserver.invoke(jrmpServerName, "stop", null, null);
}
} catch( Throwable t ) {
log.error( "Destroy error" + t );
}
log.info("JMX stopped!!!");
}As addition to existing implementation only thing we integrated is invocation of 'adaptor' stop method.
EnhydraDirector (EnhydraConnector) maintenance - release 6.2-1 is included in this release.
Converter - new enhydra module that enables automatic configuration conversion from CONF to XML configuration file. Basically, it is 'web.xml' generation (based on application CONF configuration file) tool.
DODS maintenance - release 6.2-1 is included in this release.
EnhydraDemos maintenance - release 6.2-1 is included in this release.
Windows Setup - During uninstallation process removal of Enhydra elements from LOCAL MACHINE - Path environment variable used to invoke corruption of Path environment variable (bug fix in uninstallation process).
This chapter lists the new or updated features associated with Enhydra 6.1-1.
News and bugs fixing (not in Task list):
EAF maintenance - release 6.1-1 is included in this release.
DODS maintenance - release 6.1-2 is included in this release.
EnhydraDemos maintenance - release 6.1-1 is included in this release.
Enhydra Octopus maintenance - release 3.2-1 is included in this release.
Enhydra Director - new tool that implements web server plugins for Apache, IIS and IPlanet supporting advanced load balancing / clustering and runtime administration.
Enhydra Connector - new web server connector that ties Tomcat to the Enhydra Director.
This chapter lists the new or updated features associated with Enhydra 6.0-1.
(Task Id: 1918) Integrated all implementation changes from Enhydra 5.1-16 (since Enhydra 5.1-1)
(Task Id: 1364 and 1861) Integrated MC4J JMX console with preconfigured Enhydra 6.0 conection to installed server.
News and bugs fixing (not in Task list):
New setup for Enhydra 6.0s (Components Setup) - Change or Remove (Add/Remove Programs option) installed configuration!
New, modular, Enhydra distribution structure:
Development and runtime distributions (Windows and Linux).
Integrated new implementation of 'com.lutris.util.ConfFile' class which enables config file (*.conf) configuration option (explained in more detail in Enhydra 6.0 documentation).
EAF maintenance - release 6.0-2 is included in this release.
New modular DODS release 6.0 - included in this Enhydra Server release.
EnTray
Bug fix which implements JMXConnector closure (potential memory leak),
Implemented support for multiple host definitions.
EnhydraManager - Integrated new, administration, enhydra application. Small Enhydra application which enables you to manage the status and supervise sessions of your applications.
Debugger - Integrated new, administration, enhydra application. Small Enhydra application integrated with purpose to make application debug process easier.
In EnhydraIDE (Eclipse 3.0 with integrated Enhydra Kelp) integrated four, more than useful, plugins:
Tomcat updated to version 5.0.28
IMPORTANT NOTE: Integrated Tomcat binary distribution is patched (same as in previous release). For more informations please refer to Chapter 5.
JIVAN updated to version 1.0.0
XMLC updated to version 2.2.5 (public release)
Integrated additional Tools:
Apache Axis (version 1.2) - instead of previous Soap tool
HSQL (version 1.7.2 - revision 7)
IMPORTANT NOTE: HSQL, since 1.7.2 version, uses 'NEXT' as reserved word. That is the reason why DODS using applications have to set 'DatabaseManager.DB.[DB_NAME].ObjectId.NextWithPrefix' parameter to 'true' (it is set to 'false' by default).
JAF (version 1.0.2)
Jalopy (version 1.0 beta10)
Javamail (version 1.3.1)
Jakarta ORO (version 2.0.8)
Jdepend (version 2.7)
JUnitDoclet (version 1.0.2)
Log4j (version 1.2.8)
mx4j (version 1.1.1)
Octopus (version 3.0-1).
FopApplet - On some browsers there was a problem with applet loading which is resalved in new version.
enhydraFlash - application had a Flash loading problem which is resalved now.
This chapter lists the new or updated features associated with Enhydra 6.0-beta1.
(Task Id: 471) Enhydra is completely independent from DODS during compile/build and runtime. So if DODS is not used we do not need the jars. File "eaf_api.jar" contains only Database manager API (interfaces and exceptions).
(Task Id: 474, 1316, 1357) New Admin application and cacheAdmin integration, based on JMX.
(Task Id: 649) JDDI support is removed.
(Task Id: 955) Completely new EnTray application written. It's now Java application and talks to Enhydra 6 through JMX (uses MX4J).
(Task Id: 1057) Windows source exe file for Enhydra 6.0 release are created using 7-Zip ver. 3.11 file archiver, with -sfx (Create SFX archive) switch.
(Task Id: 1361, 1369)New improved installation : Selection of http port, userid / password entry, service name, Multilanguage support, Enhydra splash screen on startup, Enhydra header image on each page, Finish page with appropriate options, Add options for manual choosing folder, which will be set as JAVA_HOME directory, Start Enhydra server as Windows system service.
(Task Id: 1367) Installation of Enhydra Conductor (MOD JK2 for Apache 2 or IIS web server) is being automatically started after finished enhydra installation (Windows). Installation of MOD JK2 for Apache 2 is provided for RedHat 9 as separated rpm package.
(Task Id: 1372) MBeans which reads size of PO and resources caches are implemented. These values are shown in new EnhydraAdmin application.
(Task Id: 1526) Comment: Some MBeans are implemented in Enhydra6.0. All configuration file entries are accessible and visible through them and jmx administration application. The Mbeans communicate with Enhydra application via notifications. The changes can be saved back to the configuration file.
(Task Id: 1531) Enhydra uses JNDI for reading application parameters. In Enhydra 6.0 we use Tomcats service provider for web.xml files.
(Task Id: 1603) EAF jars (all of them) are installed (Enhydra 6.0) in shared/lib (all jars in subordinate directories will also be loaded) directory and are shared between all applications.
Changed design of html and pdf document files. Pached stylesheets put in seperate directory.
(Task Id: 1794) Included new Zeus GUI application.
(Task Id: 1527) Documentation for new APIs and configurations (Session, Configuration, Logging and DatabaseManager) with sample configurations is included.
(Task Id: 1065) Jivan project is included. Simpe example of using jivan in enhydra application is provided.
(Task Id: 1600) PiggyBank EJOSA sample application (with DODS based data layer) include as Enhydra sample application.
(Task Id: 1542) GolfShop (Enhydra Demo Application) session problem resalved.
News and bugs fixing (not in Task list):
Enhydra6.0 distribution now includes (additional) binary distribution files. Binary, Enhydra6.0, distribution is completely configurable through configure batch/shell script file (placed in <enhydra_source>/enhydra directory). For further information's about configuration (parameter options), please, consult 'readme.txt' file placed in root directory of Enhydra6.0 binary distribution (<enhydra_source>).
EnhydraAdmin application - included source files in Enhydra's source.
XMLC updated to version 2.2.5 (public release)
FopApplet - On some browsers there was a problem with applet loading which is resalved in new wersion.
enhydraFlash - application had a Flash loading problem which is resalved now.
Table of Contents
This chapter lists the features associated with Enhydra 6.0-beta1
Servlet container is not a part of Enhydra any more, but it is needed for running Enhydra applications. Any servlet container that supports servlet 2.3 specification can be used for running Enhydra applications. Tomcat server container is included with Enhydra distribution. The documentation for this release is located in
<enhydra_root>/multiserver/webapps/tomcat-docs/index.html
Tomcat 5 implements the Servlet 2.4 and JavaServer Pages 2.0 specifications from the Java Community Process, and includes many additional features that make it a useful platform for developing and deploying web applications and web services.
IMPORTANT NOTE: Tomcat binary, release 5.0.27 included in this Enhydra 6.0 release, is pached. Pached java class is
org.apache.jk.common.JkMX
placed in 'jakarta-tomcat-connectors' module. Enabled clean shutdown of Tomcats JMX Server with enabled rmi/jrmp protocol communication, necessary for EnTray.
Basicly, the only thing changed is implementation of JMX shutdown (destroy method).
public
void destroy() { try { log.info("Stoping JMX "); if(
httpServerName!=null ) { mserver.invoke(httpServerName, "stop",
null, null); } if (jrmpServerName!=null) { if (adaptor!=null){
mserver.invoke(adaptor, "stop", null, null); }
mserver.invoke(jrmpServerName, "stop", null, null); } } catch(
Throwable t ) { log.error( "Destroy error" + t ); }
log.info("JMX stopped!!!"); } As addition to
existing implementation only thing we integrated is invocation of
'adaptor' stop method.Enhydra Tools are used for developing Enhydra Applications. In Enhydra 6.0 we included, only necessary jar files for sample applications runtime use and Enhydra 6.0 configuration process, following tools:
DODS 5.1-10 release.
Barracuda 1.2.6 release.
XMLC 2.2.5 (CVS version - date 25.02.2004.).
Ant 1.5.4 release.
AntContrib 1.5.2 release.
Zeus 3.5 release.
Soap 2.3.1 release.
gnu.regexp 1.1.4 release.
DocBook stylesheets 1.61.3 release.
Cactus 1.4.1 release.
HSQL 1.7.1 release.
Enhydra application is a servlet that can be served to the Net by different servlet continers (Tomcat, Jetty, JOnAS, ...), or it can be installed in any Servlet-capable Web server.
In Enhydra, there are the following applications:
XalanDoc (url http://localhost:8080/XalanDoc) - demonstration application that uses XML file as data source.
AirSent (url http://localhost:8080/AirSent) - demonstration application for querying, inserting, deleting and updating a tables. It uses enhydra DODS.
ImapWeb (url http://localhost:8080/ImapWeb) - sample enhydra application that represents IMAP mail client.
SimpleVXML (url http://localhost:8080/SimpleVXML) - simple Voice-XML application.
The Poker Application (url http://localhost:8080/Poker) - simulation of a poker; it can use database. By default, it doesn't use database, but, if uses, the default database is HSQL
The DiscRack Application (url http://localhost:8080/discRack) - demonstration application for querying, inserting, deleting and updating a list of Persons and their Discs in a database. It uses enhydra DODS. The default database is HSQL.
The TransactionsDiscRack Application demonstration application for querying, inserting, deleting and updating a list of Persons and their discs in a database. It uses enhydra DODS and it's new transaction features. The default database is HSQL.
The Multibase Enhydra Demo Application (url http://localhost:8080/multibase) - demonstration application for querying, inserting, deleting and updating tables in case of simultanious using multiple databases in same application. It uses enhydra DODS.
The Calculator Application (url http://localhost:8080/calculator) - little application that simulates a simple calculator.
BarracudaDiscRack (url http://localhost:8080/BarracudaDiscRack) - example of using Barracuda in Enhydra application.
BarracudaConfig (url http://localhost:8080/BarracudaConfig) - serves a twofold purpose. You can actually use it to configure a running Barracuda system (nice!), but it also provides a great example of how to combine components, events, forms, and localization all in one app (even better!).
The PhoneBook Application (url http://localhost:8080/phoneBook) - demonstration application for querying and updating a list of phone numbers in a database. It has been tested with Informix, Oracle, InstantDB and HSQL databases. The default database is HSQL.
The PhoneBookClient Application (url http://localhost:8080/phoneBookClient) - dThis is a demonstration client application for PhoneBook's Axis server.
The Project Management Application (url http://localhost:8080/projectManagement) - application whose primary use should be evidencing of working hours of employees within some organization. It holds the data of employees, customers, projects, pay rates and finally, the working hours.
The GolfShop Application (url http://localhost:8080/GolfShop) - Web shopping cart application used to support on-line Golf Store shopping Experience.
The Chat Application (url http://localhost:8080/chat) - chat room application; it uses a special algorithm to achieve the effects of push technology using standard HTTP. Messages the user sends appear immediatly.
The CGIRunner Application (url http://localhost:8080/CGIRunner) - simple CGIServlet sample. It starts "run.bat" file which dispays (on STDOUTPUT) the set of environment variables that is transfered to executable.
The SnoopServlet Application (url http://localhost:8080/SnoopServlet) - servlet that shows the data sent by the client.
The FileServlet Application (url http://localhost:8080/FileServlet) - simple FileServerServlet sample - serves static HTML page.
The JarServlet Application (url http://localhost:8080/JarServlet) - simple JarServerServlet sample - serves static HTML page from application jar file.
The Welcome Application (url http://localhost:8080/Welcome) - simple "hello world" test application.
CactusForEnhydra (url http://localhost:8080/CactusForEnhydra) - enhydra testing framework using Jakarta Cactus.
FopApplet (url http://localhost:8080/FopApplet ) - used to create PDF file from the input sources that are XSL:FO formatted. These input sources can be one of: FO parameter (path to a FO file), or XML+XSL parameters (paths to XML and XSL files)
The EnhydraFlash (url http://localhost:8080/enhydraFlash) - example of using Flash animation in enhydra application.
The JivanExample (url http://localhost:8080/JivanExample) - example of using Jivan which has its own way of DOM parsing and DOM procesing in a way to create dynamic HTML page used as users http response.
The PiggyBank (url http://localhost:8080/PiggyBank) - simple example showing the application of EJOSA Templates.
NOTE: We are assuming that Enhydra 6.0 is installed with default connection port setting (8080).
Pourpose fo this section is to explain main deferences between Enterprise and 6.0 versions.
Enterprise version:
Servlet Container: JOnAS as servlet container (two versions developed on Tomcat's and Jetty's base)
Logging: based on Monolog
6.0 version:
Servlet Container: Tomcat as base servlet container
Logging: based on Log4j.
Table of Contents
These release notes apply to Enhydra 6.0-beta1.
Enhydra 6.0 is a complete release, and should not be installed over an existing Enhydra installation.
Source code for building installations is included in source distribution.
Through the open-source development process, Enhydra 6.0 has been used on a wide variety of platforms and with many different JDBC-supported databases.
Oracle8i with the Oracle JDBC Driver
PostgreSQL 7.0.2 with the PostgreSQL JDBC Driver
Microsoft SQL Server 7.0 and 2000 on NT Server, and 2000 with the JTurbo 2.0 JDBC Driver
InstantDB
MySQL
McKoi
DB2
PostgreSQL
Sysbase
Informix
HSQL
QED
HypersonicSQL