Uploaded image for project: 'Red Hat Data Grid'
  1. Red Hat Data Grid
  2. JDG-949

Getting started guide Parts IV. - VII. review

    XMLWordPrintable

Details

    • Task
    • Resolution: Done
    • Major
    • JDG 7.1.0 GA
    • JDG 7.0.0 GA
    • Documentation
    • None

    Description

      Hi, these are the issues that I found:

      Chapter 6. - change all occurences of "Red Hat JBoss Data Grid JAR files" to just "Red Hat JBoss Data Grid", for example the title is ok with just "CHAPTER 6. RUN RED HAT JBOSS DATA GRID WITH MAVEN"

      6.1. step 3a Option 1 - "as described in ." something missing?

      6.1. and 7. are quite confusing - they are both titled the same 'Run JDG in remote client/server mode', but the first one actually talks about how to use the client, and the second one on how to start the server

      7.2. what is the '[path]' supposed to represent? The file is exactly at $JDG_HOME/standalone/configuration/standalone.xml (same for 7.3. and 7.4.)

      7.7. is redundant - everything was already mentioned

      8.4. I cannot see any subsystem called 'datagrid' nor 'modcluster' in any configuration in the server distribution

      9.4. "add the contents of the client/java/ directory, included in the Red Hat JBoss Data Grid package" what package? also the 'client/java' sounds suspicious, the chapter is about library mode, so why do we need to include client stuff?

      10.1. The first sentence at the provided link https://github.com/infinispan/infinispan-quickstart says: "WARNING This quickstarts are here only for historical reasons and are no longer maintained. Please refer to http://infinispan.org/tutorials/" Maybe we should update the link and references to the maintained version?

      10.2.2. The DefaultCacheQuickstart.java doesn't have a line 'cache.putIfAbsent("key2", "value2");'

      11.2.5.4. The programmatic configuration throws "Exception in thread "main" org.infinispan.commons.CacheConfigurationException: ISPN000343: Must have a transport set in the global configuration in order to define a clustered cache". The declarative configuration is also outdated. The correct one looks something like this https://github.com/infinispan/jdg-qe/blob/master/configs/jdg71-library/regression/library.xml

      11.2.5.5. the declarative configuration is outdated

      som na 13.1.

      14.1. we ship a lot more quickstarts, see http://download-node-02.eng.bos.redhat.com/devel/candidates/JDG/JDG-7.1.0.CR2/jboss-datagrid-7.1.0.CR2-quickstarts.zip

      Chapters 15-20 - honestly I don't see the reason to copy the quickstarts README files in the documentation. I'd rather redirect users to the github page (https://github.com/jboss-developer/jboss-jdg-quickstarts) or just let them read the READMEs from the quickstarts distribution. That way the documentation won't need to be updated with each new quickstart/with every change to an existing one.

      Attachments

        Activity

          People

            rhn-support-jbrier John Brier (Inactive)
            jmarkos Jakub Markos (Inactive)
            Jakub Markos Jakub Markos (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            3 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved: