Bug 1097110
| Summary: | The Infinispan API section of Unsupported Features in Release Notes is technically incorrect | ||
|---|---|---|---|
| Product: | [JBoss] JBoss Enterprise Application Platform 6 | Reporter: | Ladislav Thon <lthon> |
| Component: | Documentation | Assignee: | eap-docs <eap-docs> |
| Status: | CLOSED CURRENTRELEASE | QA Contact: | Russell Dickenson <rdickens> |
| Severity: | high | Docs Contact: | |
| Priority: | unspecified | ||
| Version: | 6.3.0 | CC: | nziakova, rsvoboda, smumford, twells |
| Target Milestone: | ER3 | ||
| Target Release: | EAP 6.3.0 | ||
| Hardware: | Unspecified | ||
| OS: | Unspecified | ||
| Whiteboard: | |||
| Fixed In Version: | Doc Type: | Bug Fix | |
| Doc Text: | Story Points: | --- | |
| 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 |
| Regression: | --- | Mount Type: | --- |
| Documentation: | --- | CRM: | |
| Verified Versions: | Category: | --- | |
| oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | |
| Cloudforms Team: | --- | Target Upstream Version: | |
| Embargoed: | |||
| Bug Depends On: | |||
| Bug Blocks: | 1051640 | ||
Reviewed in Revision 6.3.0-4. |
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.