• 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.

            rdickens_jira Russell Dickenson (Inactive)
            rhn-ecs-lbailey Laura Bailey
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Created:
              Updated:
              Resolved:

                Estimated:
                Original Estimate - 3 hours
                3h
                Remaining:
                Remaining Estimate - 3 hours
                3h
                Logged:
                Time Spent - Not Specified
                Not Specified