-
Sub-task
-
Resolution: Done
-
Minor
-
EAP_EWP 5.1.2
-
Documentation (Ref Guide, User Guide, etc.)
-
Not Required
-
ASSIGNED
95) 15. HTTP Session State Replication
Has no orienting material before launching into definitions, which is pretty alienating for the reader. Some introductory material would be nice. Or at least move the definitions into a Terms section so it's clearly separated. :\
Most instances of "load balancer" in this section need to be hyphenated.
96) IMPORTANT: 15. HTTP Session State Replication
"Session Persistence – A client session that is exclusively allocated to a single server instance." No. You're talking about a general concept, not a specific session here. The definition given is for a persistent session. Removing the word "that" from this sentence would reduce clarity, but also mean that the sentence was more likely to be interpreted correctly. Similarly, it is a 'persistent session' not 'session persistence' that is typically referred to as a sticky session.
97) 15. HTTP Session State Replication
"...but not configuring web applications for session replication allows you to..." --> add comma after replication to aid clarity
98) 15.1 Enabling Session Replication in your application
Sub-headings or a variablelist might help people find the particular parameters they are looking for if they choose to skim the document.
99) 15.1 Enabling Session Replication in your application
"in the absence of a setAttribute call the container" --> add comma after call
100) 15.1 Enabling Session Replication in your application
"...even if its content has not been modified but simply accessed." --> ... even if its content has only been accessed, and not modified.
101) 15.1 Enabling Session Replication in your application
Enterprise Application Platform 5 --> JBoss Enterprise Application Platform 5 (and possibly also EWP5? can't remember if it's compatible)
102) 15.1 Enabling Session Replication in your application
"the granularity of what gets replicated" <-- a little awkward
103) 15.1 Enabling Session Replication in your application
"but since all attributes values" --> attributes'
104) 15.1 Enabling Session Replication in your application
(e.g. a Person object in the "husband" attribute sharing with another Person in the "wife" attribute a reference to an Address object). --> (for example, a Person object in the "husband" attribute sharing a reference to an Address object with another Person object in the "wife" attribute).
105) 15.1 Enabling Session Replication in your application
"The default value is standard-session-cache" --> missing full stop. Following sentence needs web-tier instead of web tier.
106) 15.1 Enabling Session Replication in your application
<replication-field-batch-mode> – why is setting it to false not advised?
107) 15.2 HttpSession Passivation and Activation
HttpSessions passivation <-- HttpSession
108) 15.2.1 Configuring HttpSession Passivation
"is configured via the jboss-web.xml" <-- just configured in, not via
109) 15.2.1 Configuring HttpSession Passivation
max-active-session <-- XML example says this is max-active-sessions
number of sessions managed by the the session manager <-- remove a the
110) 15.2.1 Configuring HttpSession Passivation
"the web.xml session-timeout setting" <-- with both web.xml and session-timeout styled the same way, they blend together. maybe "the session-timeout setting in web.xml"
111) 15.2.1 Configuring HttpSession Passivation
The para immediately following the itemizedlist should be moved into the max-active-session list item. A separate section may be needed to discuss buddy replication (or just refer people to the clustering section of the admin guide)
"other nodes will also depend on" <-- rather than depend on, perhaps 'be affected by', or swap the sentence around so you can just say 'will also affect'
112) IMPORTANT: 15.3 Configuring the JBoss Cache instance used for session state replication
Please, god, get rid of all of those notes. None of those actually needs to be in an admonition. There are like six in a row with nearly identical text. Just scroll until you hit the striping.
113) 15.3 Configuring the JBoss Cache instance used for session state replication
"...refer to Deployment Via the CacheManager..." <-- Deployment Via is a street in Italy. lowercase via please.
114) 16. Using Clustered Single Sign-on
"...whether or not they are deployed on that same machine or on another node in the cluster." <-- ... regardless of whether they are...
115) 16.1 Configuration
mbean --> MBean
116) IMPORTANT: 16.1 Configuration
A positive value for this attribute allows proper handling of shutdown of a node that is the only one that had handled any of the sessions associated with an SSO. <-- This is not a good sentence.
117) 16.1 Configuration
SSO's <-- NO. SSOs.
requireReauthentication section has "true" instead of <literal>true</literal>, and seems to be missing 'for' after Realm in the following sentence: If "true", this Valve uses cached security credentials (username and password) to reauthenticate to the JBoss Web security Realm each request associated with an SSO session.
118) 16.3 Limitations
container managed authentication --> container-managed authentication
Also, this bullet needs a closing full stop.
119) 16.4 Configuring the Cookie Domain
"suppose we have a case where two apps, parenthetical statement, that wish" <-- remove 'that' after parenthetical statement
120) 16.4 Configuring the Cookie Domain
The programlisting has strange tabbing; move the cookieDomain attribute back to be in line with the start of the className attribute.
121) 17. Complete Working Example
Proxy Server example has an opening < that probably shouldn't be there
122) Appendix: workers.properties Reference
What exactly does a range of _ to / comprise?
"The structure of a Worker Property is worker.worker_name.directive" <-- missing final full stop
123) Appendix: workers.properties Reference – workers.properties Connection Directives
"For example, a correct directive flag set is worker.node1.ping_mode=CI" <-- missing full stop, and should probably describe what it is attempting to set for clarity's sake
124) Appendix: workers.properties Reference – workers.properties Load Balancing Directives
"...three times the load than other workers..." <-- three times the load OF other workers
125) Appendix: Java Properties Reference – B.1. Proxy Configuration
itemizedlist is incorrectly punctuated
Proxy Configuration Values <-- not values, parameters or attributes
The default values are displayed next to the parameter name here, but nowhere else in the document.
126) Appendix: Java Properties Reference – B.1. Proxy Configuration
"an usable worker" <-- a usable worker
127) Appendix: Java Properties Reference – B.1. Proxy Configuration
cping and cpong or CPing and CPong? Consistency required.