Title: Deprecated Features
Describe the issue:
Per bug 1196790, some attributes and operations in the infinispan and jgroups subsystems are being deprecated in 6.4.0. I believe this should be documented in release notes.
Suggestions for improvement:
I believe that few sentences should be enough, something like "a bunch of attributes and operations in the infinispan and jgroups subsystems were deprecated in this release and are planned to be removed in next major version".
See bug 1196790.
Thanks for the heads up Ladislav.
Unfortunately I can't use phrasing like "A bunch of attributes..." in an enterprise document.
Are you able to provide specifics about what has been deprecated, or nominate someone who could? There's no usable details in bug 1196790.
The entire set of attributes/operations that were deprecated can be seen in the pull requests:
You can ask Paul Ferraro and/or Rado Husar for more details.
Sorry Lasislav, both of those URLs return 404s.
Paul, can you help out? Sorry for the short notice but time is a critical factor here.
Ha, true, I forgot that you probably don't have the permissions on GitHub. I'll try to summarize the PRs and let Paul clarify and/or correct if needed:
1. In the "infinispan" subsystem:
1.1 The attribute "start" (which can be EAGER or LAZY) on "cache-container" and on "*-cache" (replicated-cache, distributed-cache, ...) is deprecated. Future release will only support on-demand mode (what is now LAZY).
1.2 The attributes "stack" and "cluster" on "transport" are deprecated. I believe that this is related to the planned big overhaul of group communication in clustering.
1.3 The attributes "listener-executor", "eviction-executor" and "replication-queue-executor" on "cache-container" are deprecated. I believe that this is related to the planned removal of the "threads" subsystem.
1.4 The attribute "executor" on "transport" is deprecated. Same as 1.3 -- related to the "threads" subsystem.
2. In the "jgroups" subsystem:
2.1 The "default-stack" attribute (on the subsystem's root resource) is deprecated. Same as 1.2 -- related to the planned overhaul of group communication in clustering.
2.2 The attribute "protocols" and operations "add-protocol" and "remove-protocol" on "stack" are deprecated. Same as 1.2 -- related to the planned overhaul of group communication in clustering.
2.3 The attributes "type" and "properties" on "protocol" are deprecated. Same as 1.2 -- related to the planned overhaul of group communication in clustering.
2.4 The attributes "type", "shared" and "properties" on "transport" are deprecated. Same as 1.2 -- related to the planned overhaul of group communication in clustering.
2.5 The attributes "default-executor", "oob-executor", "timer-executor" and "thread-factory" on "transport" are deprecated. Same as 1.3 -- related to the "threads" subsystem.
How many of these are actually _supported_ and therefore need formal deprecation, I'm not sure.
Thanks for that Ladislav, very much appreciated.
I'll draft something up and put it in the Deprecated Features topic. I'll leave it commented out, though, as the topic defers to the article on access.redhat.com , which is maintained by John Doyle.
John, is this something you'll be covering in that article? If not, I can just remove the comment markup and have it appear in the Docs topic.
At his request, the content I drafted for this has been forwarded to John Doyle for inclusion in the article linked in comment 5.
The content is not appearing there, however, as of the timestamp on this comment.
John, Assigning this to you to see if you can/will cover this in the Access article linked above.
According to metrics provided by Keith Watkins, the article gets 10x more traffic than the Release Notes document. If we want people to see this, Access is the place to put it.
If that can't happen reassign this back to me and I'll see what I can do to update the 6.4 Release notes.
The content that was stored in the Deprecated Features topic have been added to the CSP article .
It is not published but has been saved in a draft state pending approval/publication from John Doyle.
Ladislav, you can possibly see (and verify) the changes in the article as well, to add your input.
Scott, I've got few comments:
1. It's "Infinispan", not "InfiniSpan".
2. Maybe the text should point out the version number since the mentioned things are deprecated (6.4).
3. The text often mentions things like "transport subsystem" or "protocol subsystem". These are not subsystems, "[management] resource" is a better word here.
I've correct the formatting on 'Infinispan', added a sentence to state these items were deprecated in 6.4 and replaced instances of 'subsystem' in the texts with 'resource'.
Thanks again for all your help on getting this content prepared.
The content now reads as follows:
The Infinispan subsystem
Deprecated in JBoss EAP 6.4:
The start attribute (which can be EAGER or LAZY) on cache-container and on *-cache (replicated-cache, distributed-cache, etc) is deprecated. Future release will only support on-demand mode (what is now LAZY).
The stack and cluster attributes on the transport resource are deprecated.
The listener-executor, eviction-executor and replication-queue-executor attributes on cache-container are deprecated.
The executor attribute on the transport resource is deprecated.
The JGroups subsystem
Deprecated in JBoss EAP 6.4:
The default-stack attribute (on the subsystem's root resource) is deprecated.
The protocols attribute and the add-protocol and remove-protocol operations on the stack resource are deprecated.
The type and properties attributes on the protocol resource are deprecated.
The type, shared and properties attributes on the transport resource are deprecated.
The default-executor, oob-executor, timer-executor and thread-factory attributes on the transport resource are deprecated.
The draft content can be viewed at  by clicking 'View current version' (you must be logged in to the portal to see draft content.
Emailed John Doyle to get a final OK on this and have it published.
This content is now live at:
Closing ticket. Thanks to Ladislav and John for assistance.