-
Bug
-
Resolution: Done
-
Major
-
None
-
None
Link to the reviewed guide http://docbuilder.usersys.redhat.com/23161/
The following are suggestions for improvements in reviewed documentation. It is mostly wrong configuration or old versions.
I assumed that all programmatic configuration should be moved developer guide, if that's not the case please ignore suggestions bellow to move chapters to developers guide.
13.3.7. Configure Locking Mode (Library Mode)
<transaction transactionManagerLookupClass="
transactionMode="{TRANSACTIONAL,NON_TRANSACTIONAL}"
lockingMode="{OPTIMISTIC,PESSIMISTIC}"
useSynchronization="true">
</transaction>
Set the lockingMode value to OPTIMISTIC or PESSIMISTIC to configure the locking mode used for the transactional cache.
Should be:
<transaction transaction-manager-lookup="{TransactionManagerLookupClass}
"
mode="
"
locking="
">
</transaction>
Set the locking value to OPTIMISTIC or PESSIMISTIC to configure the locking mode used for the transactional cache.
This chapter should be moved to developer guide:
16.2.3. Configure the Cache Store Programmatically
16.4. Connection Factories
- Shouldn't there be sub chapter about PooledConnectionFactory?
17.2. Cache Store Configuration Details (Library Mode)
- this cache store can bounded by a maximum number
should be: - this cache store can be bounded by a maximum number
17.4. Single File Cache Store
Full stop missing at the end of the sentence.
.... lead to data loss which is undesirable in this use case
17.4.3. Upgrade JBoss Data Grid Cache Stores
Red Hat JBoss Data Grid stores data in a different format than previous versions of JBoss Data Grid.
There should be version reference:
Red Hat JBoss Data Grid 7 stores data in a different format than previous versions of JBoss Data Grid.
17.4.3. Upgrade JBoss Data Grid Cache Stores
This paragraph talks about rolling upgrades in library mode, but next one says they are only available in clients-server mode. I suggest removing part about library mode.
Rolling upgrades is the process by which a JBoss Data Grid installation is upgraded without a service shutdown. In Library mode, it refers to a node installation where JBoss Data Grid is running in Library mode. For JBoss Data Grid servers, it refers to the server side components. The upgrade can be due to either hardware or software change such as upgrading JBoss Data Grid.
Rolling upgrades are only available in JBoss Data Grid's Remote Client-Server mode.
17.6.3.3. JdbcMixedStore Programmatic Configuration and Procedure 17.3. Configure JdbcMixedStore Programmatically
should be moved to Developer guide
Sample config is wrong in these chapters followed by correct line:
17.5.2. LevelDB Cache Store Sample XML Configuration (Library Mode)
<leveldb-store xmlns="urn:infinispan:config:store:leveldb:8.0
17.6.1.2. JdbcBinaryStore Configuration (Library Mode)
<infinispan
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="urn:infinispan:config:8.3 http://www.infinispan.org/schemas/infinispan-config-8.3.xsd
urn:infinispan:config:store:jdbc:8.0 http://www.infinispan.org/schemas/infinispan-cachestore-jdbc-config-8.0.xsd"
xmlns="urn:infinispan:config:8.3">
<!-- Additional configuration elements here -->
<persistence>
<binary-keyed-jdbc-store xmlns="urn:infinispan:config:jdbc:8.0"
Please make the same version modifications as above to the 2 following chapters
17.6.2.2. JdbcStringBasedStore Configuration (Library Mode)
- also replace urn:infinispan:config:jdbc with urn:infinispan:config:store:jdbc
17.6.3.2. JdbcMixedStore Configuration (Library Mode) - also replace urn:infinispan:config:jdbc with urn:infinispan:config:store:jdbc
17.8.1. JPA Cache Store Sample XML Configuration (Library Mode)
<jpa-store xmlns="urn:infinispan:config:store:jpa:8.0"
Procedure 17.7. Download JBoss Data Grid Source Code
There is reference to 6.6.0 version, should be 7.0.0
Procedure 17.8. Generate a Maven Archetype
reference to 6.6.0 maven repository and 6.4.0. version
17.8.1. JPA Cache Store Sample XML Configuration (Library Mode)
<jpa-store xmlns="urn:infinispan:config:store:jpa:8.0"
17.8.3. Deploying JPA Cache Stores in Various Containers
reference to 6.4.0.Final-redhat-4 dependency version
Procedure 17.5. Deploy JPA Cache Stores in JBoss EAP 6.3.x and earlier
reference to JDG 6.6
Procedure 17.6. Deploy JPA Cache Stores in JBoss EAP 6.4 and later
reference to JDG 6.6.
Example 18.1. Toggle Passivation in Remote Client-Server Mode
<!-- Additional configuration elements here --> this comment is there twice
20.4. Enable JMX for Cache Instances
the following chapters should be moved to developer guide:
Enable JMX Programmatically at the Cache Level
Enable JMX Programmatically at the CacheManager Level
Set a CacheManager Name Programmatically
To Add the Fully Qualified Domain Name Programmatically
21.6.4. Create a New Cache Using JBoss Operations Network (JON)
repeated word:
From from the JBoss Operations Network ...