Bug 1097110 - The Infinispan API section of Unsupported Features in Release Notes is technically incorrect
Summary: The Infinispan API section of Unsupported Features in Release Notes is techni...
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: JBoss Enterprise Application Platform 6
Classification: JBoss
Component: Documentation
Version: 6.3.0
Hardware: Unspecified
OS: Unspecified
unspecified
high
Target Milestone: ER3
: EAP 6.3.0
Assignee: eap-docs
QA Contact: Russell Dickenson
URL:
Whiteboard:
Depends On:
Blocks: eap63-beta-blockers
TreeView+ depends on / blocked
 
Reported: 2014-05-13 07:37 UTC by Ladislav Thon
Modified: 2014-09-29 22:52 UTC (History)
4 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Build Name: 22702, 6.3.0 Release Notes-6.3-1 Build Date: 12-05-2014 07:33:36 Topic ID: 30480-638724 [Latest]
Last Closed: 2014-06-28 15:24:51 UTC
Type: Bug
Embargoed:


Attachments (Terms of Use)

Description Ladislav Thon 2014-05-13 07:37:04 UTC
Title: Unsupported Features

Describe the issue:

The "Infinispan API" section claims that "The API's module.xml incorrectly indicates that direct use is possible, even though this is not the case", which is wrong. Direct use is unsupported (as signified by <property name="jboss.api" value="unsupported"/> in the module.xml), but it is technically very much possible.

Suggestions for improvement:

I'd just remove the entire sentence, together with the following "This will be fixed in a future release". Also, removing initial "the" at the beginning of the text sounds better to me. Both these suggestions would lead to the entire section reading:

"Direct use of the Infinispan API is not supported in JBoss EAP 6. Infinispan is used as an implementation detail for various clustering technologies internal to JBoss EAP 6. Direct use of the Infinispan API requires a subscription to JBoss Data Grid."

Additional information:

Just FYI, acessing the Infinispan API from an application is as simple as adding "Dependencies: org.infinispan" into META-INF/MANIFEST.MF in a .war file. The only thing that happens is that when deploying the application, EAP will log a warning like this:

09:12:07,081 WARN  [org.jboss.as.dependency.unsupported] (MSC service thread 1-5) JBAS018568: Deployment "deployment.clusterbench-ee6.ear.clusterbench-ee6-web.war" is using an unsupported module ("org.infinispan:main") which may be changed or removed in future versions without notice.

Also please note that this exact bug has been already filed (and fixed) once, about a year ago (!), see bug 968592. It is probably a good idea to check how this could happen, so that you can prevent it from happening again in the future.

Reviewed in Revision 6.3.0-3.

Comment 3 Ladislav Thon 2014-05-14 07:21:46 UTC
Reviewed in Revision 6.3.0-4.


Note You need to log in before you can comment on or make changes to this bug.