Bug 1037886

Summary: Remote Querying chapter in Infinispan Query Guide
Product: [JBoss] JBoss Data Grid 6 Reporter: Divya Mehra <dmehra>
Component: DocumentationAssignee: gsheldon
Status: CLOSED DUPLICATE QA Contact:
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 6.2.0CC: anistor, dmehra, jdg-bugs, mmarkus, sanne
Target Milestone: GA   
Target Release: 6.2.0   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2013-12-04 02:11:01 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:

Description Divya Mehra 2013-12-04 01:57:46 UTC
Description of problem:
More work needed to get the flow right in Remote Querying chapter.

1) The chapter starts with using DSL in Embedded Querying.
This is not the primary use case.

Chapter should primarily discuss Querying over Hot Rod
and show Step-by-Step how to configure and write a Hot Rod client which performs Remote Queries.

(Use of same DSL in Library mode can be discussed in a final section.)


2) >>6.2. Protobuf Marshaller
The Infinispan Query DSL can be used remotely via the Hot Rod client. In order to do this, protocol buffers are used to adopt a common format for storing cache entries and marshalling them. 

Need more background - what is the Protobuf format? 

3) Protobuf requires data to be structured. This is achieved by declaring Protocol Buffer message types in .proto files 

Where are the .proto files located - client or server side ? Which directory?

4) 6.3. Performing Remote Queries via the Java Hot Rod Client
This section should be earlier in my view - as the primary use case is Querying over Hot Rod.

5) Add .jar Files
Add the following .jar files.

    Add the DSL .jar to the client's classpath. <---- which Jar file ?
    Add the infinispan-remote-query-server.jar to the server's classpath.
    Add the infinispan-remote-query-client.jar to both the client and the server's classpath.

Comment 2 Misha H. Ali 2013-12-04 02:11:01 UTC
It's probably simpler to track all the feedback for this content in the single tracking bug. Copied content across and closing this as a duplicate.

*** This bug has been marked as a duplicate of bug 965346 ***