caGrid
Version 1.3
March 31, 2009
================================================================
Contents
================================================================
1.0 caGrid Introduction
2.0 Release History
3.0 New Features and Updates
4.0 Bug fixes since last release
5.0 Known Issues/Defects
6.0 Bug Reports and Support
7.0 Documentation
8.0 References
================================================================
1.0 caGrid Introduction
================================================================
This document contains the release notes for the caGrid 1.3
release.
caGrid 1.3 is a point release of the caGrid 1.x stream. It
is generally backwards compatible with the service
interfaces of caGrid 1.0/1.1/1.2. That is, services and
applications developed against the caGrid 1.0 or 1.1 or 1.2
release, will continue to function against caGrid 1.3
versions of those services (including the production grid).
More details on backwards compatibility can be found here:
http://cagrid.org/display/caGrid13/Deprecation%20Plan
This release of caGrid supports caBIG compatibility level gold.
https://cabig.nci.nih.gov/workspaces/Architecture/caGrid
http://cagrid.org
================================================================
2.0 Release History
================================================================
caGrid 0.5 was released on 31st August 2005
caGrid 0.5.1 was released on 7th October 2005
caGrid 0.5.2 was released on 15th November 2005
caGrid 0.5.3 was released on 25th January 2006
caGrid 0.5.4 was released on 12th May 2006
caGrid 1.0 Beta was released on 17th July 2006
caGrid 1.0 was released on 15th December 2006
caGrid 1.1 was released on 17th September 2007
caGrid 1.2 was released on 31st March 2008
================================================================
3.0 New Features and Updates
================================================================
RFE Description
------------------------------------------------------------
20244 Adding support for XML schema with xs:include
20243 Installer to add execute permissions to scripts used by prerequisites it installs
20240 Data service creation wizard has mac issues.
20239 DCQL foreign association on multiple attributes
20236 Reformat GAARDS UI to display properly on the MAC
20235 Add Account Auditing to Dorian
20234 Enable Dorian Host Certificates to work with new version of IE and Firefox
20231 Move from issuing Proxy Certificates to Issuing short term certificates.
20230 Spring enable Dorian
20226 DCQL fails when some target services are down
20216 Introduce upgrade to SDK 4.1
20215 Data Service plug-in for SDK 4.1
20211 Single sign-out
20208 Author System Tests for WebSSO
20188 GME needs to support the ability to update and delete schemas which are in development
20187 GME's service metadata and wsdl need to reflect the service's operations
20186 GME should allow any valid URI as a namespace
20185 GME needs to support schemas with includes/redefines
20184 GME needs to support schemas with cycles
20111 Installer should not have MyIntroduceService as a selection in the service panel
20110 Installer should have short description of each service in the sevice selection panel.
20001 Migrate caDSR service to 4.0
19996 FQP should support delegation
19989 GME to support MySQL version 5
17002 FQP should support caGrid Transfer of results
16869 ServiceConstants file shouldn't get completely re-written every save
16623 Review Advertisement settings
15606 Investigate moving caGrid to Globus 4.2
15605 CSM Introduce Authorization Extension
15604 Grid Grouper Introduce Authorization Extension
15603 Introduce GDE Extension to enable having other grape components available in Introduce
15602 Create Introduce Authorization Extension
15600 Transfer Service supporting streaming
15576 Develop system integration tests for the Authentication Service.
15574 Update GAARDS UI to leverage new Authentication Profile / Trusted IdP metadata.
15573 Add Trusted IdP metadata to Dorian
15572 Extend Trusted Identity Provider information to include information regarding the IdP's Authentication Service
15571 Add Authentication Profile Metadata to Dorian.
15570 Implement new Authentication Service interface
15569 Authentication Profile Service Metadata
15214 Grid Authentication Manager/Security Integration
15000 Transfer Service Helper returns reference and is hard to alter resource before returning
14998 Introduce Service tab should use tooltips in the jtree
14992 Introduce clients do not set user credential when returning client handle to stateful resources
14946 Introduce client code should be more override friendly
14933 Add additional utilities for working with query results
14863 Upon login dorian should automatically set the credential as the default credential.
14862 Enter key on dorian login window is not mapped to the login button
14861 Introduce services which support persistence are hard to customize persistence on the resource itself
14129 Authentication Profile Metadata
14127 Support multiple authentication profile
14080 Problem with Anonymous Security Setting
14050 Provide discovery and metadata APIs for determining if a given service is an analytical or data service and discovering the given type
13405 API to discover trusted IDs (Use case for caB2B security requirements)
13224 Introduce needs a button that will allow user to turn stub generation off and then default to the default serializers
13167 Improve Introduce usability when adding extensions or service contexts
12968 Reorganize testing resources to reduce size
12151 Improve Exception Handling
12149 To Support Multiple Authentication Providers
11863 Need a way to hook in pre-deployment validation checks to enforce policy
11388 documentation on logging in through code
6307 Add service extensions to service contexts
4513 FQP should support ws-notification
4512 FQP should support ws-enumeration transfer of results
The complete list of new features and additional details can be found on the project Gforge Tracker:
http://gforge.nci.nih.gov/tracker/?atid=2252&group_id=25&func=browse
Specific highlighted improvements in caGrid 1.3 include:
* Continuous Integration:
caGrid 1.3 enhances support for the latest releases (version 4.1.1) of the caCORE Software Development Kit (SDK)
and Common Security Module (CSM). caGrid and the caCORE SDK now share a common code base for CQL.
In addition, caGrid 1.3 supports the most recent web services containers in the
NCI CBIIT Technology Stack (Tomcat 5.5 and JBoss 4.0.5).
* Data Services:
Significant enhancements to the Federated Query Processor (FQP), allowing a single, semantic query to execute across
multiple caGrid services and return a single result set. FQP now supports WS-Notification, querying secure grid services
via the caGrid Credential Delegation Service (CDS), configurable query execution parameters to allow only partial results
to be returned, and out-of-band results using the caGrid Transfer Service and WS-Enumeration.
* Introduce Toolkit
The Introduce Toolkit has a number of security-related enhancements, adding fine-grain control over authorization using
the caCORE Common Security Module (CSM) and Grid Grouper. Introduce also includes service updaters, allowing service
developers to easily update-to and leverage caGrid 1.3.
* Metadata Services:
The Mobius Global Model Exchange (GME) has been entirely rewritten for caGrid 1.3 to support the semantic
requirements of caBIG® software developers. The caGrid-developed caDSR grid service, based on the caCORE 3.1 API,
has been deprecated, It has been replaced by the caDSR 4.0 data service (maintained by the caDSR team), and a
new caGrid Metadata Model Service (MMS), whose purpose is creation and semantic annotation of caGrid
metadata models using caDSR-derived data.
* Security:
Enhancements to the GAARDS infrastructure include support for multiple authentication profiles,
including one-time passwords. Trusted Identity Providers can now be discovered programmatically, allowing full
realization of federated authentication use cases. Auditing support has also been added to Dorian, giving systems
administrators the degree of control they have requested.
* Workflow
Orchestration of caGrid services is supported in this release though joint development with the Taverna project.
The caGrid plug-in for the Taverna 2.0 workbench allows development of workflows using their rich user interface.
================================================================
4.0 Bug fixes Since Last Release
================================================================
Bug Description
------------------------------------------------------------
20123 XMI to DomainModel tool doesn't populate association multiplicity
19812 Cannot use data types with - in them
19753 Introduce: Build: Post-processor: gov.nih.nci.cagrid.introduce.servicetasks.axis.FixSoapBindingStub does not process multiple services as defined within introduce.xml and introduce.properties
19697 Issue upgrading passwords with Dorian 1.3
19566 Modifying a provided method in Introduce allows an inconsistent GUI state
19563 Check boxes on Advanced tab of Create Service Skeleton can get in unclickable state
19181 Presence of .DS_Store file in caCORE 4.0 Output directory prevents creation of a data service
19091 Introduce Deployment UI can throw null pointer exception if an extension does not supply a deployment UI class
19066 Mapping schemas to packages in caCORE SDK 3.2 wizard can throw an exception
19052 Installer throws error for JBoss container
18974 Utils.getRelativePath() fails when comparing certain unix style paths
18972 Some methods of the FQP grid service do not perform checks against query processing constraints.
18969 Some data service creation wizards get truncated depending on system font / UI component rendering sizes.
18963 SyncGTS deploy targets not replacing cog-jglobus.jar correctly for insecure containers
18619 CQL2ParameterizedHQL valueToObject doesn't handle Boolean attributes
18512 Queries including attribute restrictions on numeric data types can return unexpected results when the queryCaseInsensitive flag is set to true
18247 SDK 4.0 query processor can return duplicate object results
18225 Introduce does not support the http://www.w3.org/XML/1998/namespace correctly
17135 SDK 3.2 query processor makes potentially slow probing query
16999 CSM authorization cannot be added to any service or methods that is not the main service or its methods.
16548 GME has issues with multiple elements of the same name/type in a complexType
16439 Pasting values in to fields on SDK 4 wizard configuration causes exception
16413 SDK 4 Data Service wizard can blank copied schema files
16319 cog-jglobus.jar file is not updated in syncgts globus container deployment
16137 Introduce Grid Grouper PDP requires default proxy to connect to Grid Grouper
16060 results from enumeration iteration contains encoded XML - no serializable into object
15757 Gaards UI throws an error popup that makes the UI unusable
15614 Schema selection from local file system can occasionally create incorrect namespace types
15607 Introduce service security metadata is not consistent with security descriptor for resource property operations
15502 Using 1.2 installer in a fresh machine that already had globus with enum installed and with the GLOBUS_LOCATION set installer still wanted to install globus
15488 Introduce services have some code in them that is not jdk 1.4 compliant
15311 silent exceptions (no service properties from custom query processor) when adding a custom query processor using Introduce data extension
15287 Properties not set for service redirect/cookie age within the cas-servlet.xml file
15196 CaGridWebSSOAttributeLoaderFilter will not work as designed
15166 Dorian Security Vulnerability - Password digest algorithm only accounts for the first 8 plus the last character of the password.
14999 Introduce Metdata Extension is not setting method descriptions properly
14944 DomainModelUtils inner class CDE is not visible outside of package context
14923 WebSSO project is missing jar dependencies for syncGTS
14922 SyncGTS Ivy "common" configuration is missing a dependency on mobius common-client
14908 classnotfoundexception when deploying to tomcat 5.5+
14860 Introduce Log Viewer hangs in certain scenarios
14793 Subject in Dorian limited to 255 characters
14606 Grape Error Dialog is allowing editing of the details.
14531 Introduce "configure types" validator lets you save when there are validation errors
14505 Deploy and Undeploy JBoss ant targets don't allow the Globus webapp name to be specified
14491 CQL QueryModifier with single, non-distinct attribute fails when run against caCORE SDK 4.0
14260 getEtcDirectoryPath() operation in the <serviceName>Configuration class was returning wrong value.
14128 Adding fault from types list is causing error
14051 Nullpointer when using SDKSerializer for non-SDK system
13968 Bug importing a schema that was already added but removed.
13952 Error importing a schema that imports other schemas.
13771 SDK 4 data service wizard fails with 'No Domain Model'
13678 Introduce GUI forgets that the main service is a Main type of service
13353 When importing a method from another introduce service package names are broken
13298 Introduce patch system is looking for the introduce.engine.properties and template in the wrong place
13231 Adding data types from schemas on the file system with cyclic imports fails
13177 When the trasfer resource is being destroyed it tries to delete the cache file. If the cache files does not exist it throws a resource exception.
13002 Portal Admin password is set to null in Portal installer
12964 If a previous release of the Installer was run, caGrid fails to build in the current installation
12532 Grid Grouper Authorization not configured but service can be deployed
12229 Security Service Metadata Anonymous Clients Ignored in Grid Grouper
10992 CDS will return delegated credentials even after user logs out
The complete fixed bug list and additional details can be found on the project Gforge Tracker:
http://gforge.nci.nih.gov/tracker/index.php?group_id=25&atid=174
================================================================
5.0 Known Issues Not Yet Fixed
================================================================
Updated bug reports and feature requests can be found on the tracker section
of the project's gforge site:
http://gforge.nci.nih.gov/tracker/?group_id=25
----------
ISSUE:
Bug #7671 Lowercase chars in complexType names from schema can cause compile failure
DETAILS:
http://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=7671&group_id=25&atid=174
IMPACT:
Data services with models using Class names that start with lowercase characters won't compile.
WORKAROUND:
None, without editing the XSD/Model.
----------
----------
ISSUE:
Bug #9466 Introduce is not passing any system properties on to it's ant calls it makes when running the engine.
DETAILS:
http://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=9466&group_id=25&atid=174
IMPACT:
Users behind web proxies may have issues communicating with grid services through Introduce
WORKAROUND:
Manually edit the Introduce ant task for your proxy settings (see bug report)
----------
----------
ISSUE:
Bug #19306 Introduce grid service path cannot contain spaces
DETAILS:
http://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=19306&group_id=25&atid=174
IMPACT:
Users creating services into a directory with spaces in it
WORKAROUND:
Move the service to a directory path without spaces
----------
----------
ISSUE:
Bug #19045 Introduce generated WSDL breaks unique key constraint of WSDL XSD
DETAILS:
http://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=19045&group_id=25&atid=174
IMPACT:
Users of external tools which validate WSDL to the its XML Schema (such as some BPEL tools)
WORKAROUND:
If you own the service, you can manually remove the spaces; otherwise you may have to disable XML Schema validation in the tool
----------
----------
ISSUE:
Bug #11607 DataService gets in inconsistent state and returns confusing errors when not properly initialized
DETAILS:
http://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=11607&group_id=25&atid=174
IMPACT:
Users deploying data services which are not properly configured may not see an appropriate error message at startup.
WORKAROUND:
After making any configuration changes, validate the service is working correctly.
----------
----------
ISSUE:
Bug #18649 Certain types of Hibernate database tables for subclasses are not supported by Data Services with SDK 4.0 and 4.1
DETAILS:
http://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=18649&group_id=25&atid=174
IMPACT:
Users using custom hibernate table mappings
WORKAROUND:
None; avoid using custom table mappings if possible.
----------
----------
ISSUE:
Bug #14007 Multiple services using WS-Enumeration cannot run in same container
DETAILS:
http://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=14007&group_id=25&atid=174
IMPACT:
Users attempting to deploy multiple services using WS-Enum in the same container
WORKAROUND:
Deploy services to a separate container, or see configuration changes described in bug report
----------
----------
ISSUE:
Bug #18966 JVM shutdown hooks sometimes don't run to completion under Tomcat
DETAILS:
http://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=18966&group_id=25&atid=174
IMPACT:
Things like service unregistration may not occur immediately.
WORKAROUND:
None; registrations will expire.
----------
----------
ISSUE:
Bug #20196 Installer overwrites the installed credentials if already installed credentials are selected
DETAILS:
http://gforge.nci.nih.gov/tracker/?func=detail&atid=174&aid=20196&group_id=25
IMPACT:
Minor.
WORKAROUND:
Use the correct credential option: "Host credentials are already installed."
----------
================================================================
6.0 Bug Reports and Support
================================================================
The preferred approach is to first search the knowledge center
forums for your problem, then post your question to the forum.
Bugs can also be entered on the gforge project page.
Knowledge Center Forums:
https://cabig-kc.nci.nih.gov/CaGrid/forums/
GForge Project Page:
http://gforge.nci.nih.gov/projects/cagrid-1-0/
Submit Bug:
http://gforge.nci.nih.gov/tracker/?func=add&group_id=25&atid=174
================================================================
7.0 Documentation
================================================================
The release documentation, and component design documentation
can be found on the project's wiki:
http://cagrid.org/display/caGrid13/Home
================================================================
8.0 References
================================================================
The following URLs access web pages relevant to caGrid.
caBIG Home Page
-- http://cabig.nci.nih.gov/
NCICB Download Center
-- http://ncicb.nci.nih.gov/download/
caGrid
-- http://cagrid.org
-- https://cabig-kc.nci.nih.gov/CaGrid/KC
-- https://cabig.nci.nih.gov/workspaces/Architecture/caGrid/
-- http://gforge.nci.nih.gov/projects/cagrid-1-0/





