LS EchoRequest

From GEANT2-JRA1 Wiki

(Redirected from LS echo-results)

Contents

EchoRequest for Lookup Service

Request

Description

  • eventType echo.ls is supported
  • if just echo eventType is given, the generic Echo (from pS base) will be run
  • if no parameters are given, echo.ls works similar to generic echo
  • parameters are optional. Positive values for parameters are: "yes", "true" or "test". Otherwise the value is negative and parameter won't be applied.

XML

<nmwg:message type="EchoRequest"
                   id="msg1"
                   xmlns:nmwg="http://ggf.org/ns/nmwg/base/2.0/">
 
    <nmwg:metadata id="meta">
         <nmwg:eventType>echo.ls</nmwg:eventType>
         <nmwg:parameters>
 
             <nmwg:parameter name="testDBConnection" value="yes"/>
             <nmwg:parameter name="testDBSchema" value="yes"/>
 
         </nmwg:parameters>
    </nmwg:metadata>
 
    <nmwg:data id="data" metadataIdRef="meta"/>
 
</nmwg:message>

Parameters

  • testDBConnection - tests if connection to DB is ok. If not it usually means that the server is not run or there is a network problem
  • testDBSchema - tests if LS has the access and rights for its database. If not it usually means there is no collection, no LSStore, LSStore-control storage or access is forbidden

Response

Possible EchoRequest results

  • no eventType
<nmwg:message id="msg1_resp" messageIdRef="msg1" type="EchoResponse">
    <nmwg:metadata id="resultCodeMetadata">
        <nmwg:eventType>error.ls.no_eventtype</nmwg:eventType>
    </nmwg:metadata>
    <nmwg:data id="resultDescriptionData_for_resultCodeMetadata" metadataIdRef="resultCodeMetadata">
        <nmwgr:datum>LS EchoRequest error: Error while determining eventType (possibly no eventType at all). EventType must be [echo.ls]. Nested exception is : null</nmwgr:datum>
    </nmwg:data>
</nmwg:message>
  • wrong eventType
<nmwg:message id="msg1_resp" messageIdRef="msg1" type="EchoResponse">
    <nmwg:metadata id="resultCodeMetadata">
        <nmwg:eventType>error.ls.eventtype_not_supported</nmwg:eventType>
    </nmwg:metadata>
    <nmwg:data id="resultDescriptionData_for_resultCodeMetadata" metadataIdRef="resultCodeMetadata">
        <nmwgr:datum>LS EchoRequest error: Not supported event type [echo.ls1]. Must be: [echo.ls]</nmwgr:datum>
    </nmwg:data>
</nmwg:message>
  • No DB server connection:
<nmwg:message id="msg1_resp" messageIdRef="msg1" type="EchoResponse">
    <nmwg:metadata id="resultCodeMetadata">
        <nmwg:eventType>error.common.storage.xmldb.open</nmwg:eventType>
    </nmwg:metadata>
    <nmwg:data id="resultDescriptionData_for_resultCodeMetadata" metadataIdRef="resultCodeMetadata">
        <nmwgr:datum>
           EchoRequest (Test DB Connection) error: 
           Database connection to the LookupService is not established. 
           Nested exception is : 
           XQuery by HTTP failed. Could not connect to eXist via pure http,  
           nested exception was: class java.net.ConnectException : Connection refused
        </nmwgr:datum>
    </nmwg:data>
</nmwg:message>
  • No user/collection or wrong access rights
<nmwg:message id="msg1_resp" messageIdRef="msg1" type="EchoResponse">
    <nmwg:metadata id="resultCodeMetadata">
        <nmwg:eventType>error.common.storage.xmldb.open</nmwg:eventType>
    </nmwg:metadata>
    <nmwg:data id="resultDescriptionData_for_resultCodeMetadata" metadataIdRef="resultCodeMetadata">
        <nmwgr:datum>
            EchoRequest (Test DB Connection) error: 
            Database connection to the LookupService is not established. 
            Nested exception is : 
            XQuery by HTTP failed. Could not connect to eXist via pure http,  
            nested exception was: class java.io.IOException : 
            Server returned HTTP response code: 401 for 
            URL: http://localhost:8680/exist/rest/db/ls</nmwgr:datum>
    </nmwg:data>
</nmwg:message>
  • No LSStore.xml storage file
<nmwg:message id="msg1_resp" messageIdRef="msg1" type="EchoResponse">
    <nmwg:metadata id="resultCodeMetadata">
        <nmwg:eventType>error.echo.no_storage_content</nmwg:eventType>
    </nmwg:metadata>
    <nmwg:data id="resultDescriptionData_for_resultCodeMetadata" metadataIdRef="resultCodeMetadata">
        <nmwgr:datum>EchoRequest error: No [LSStore] schema</nmwgr:datum>
    </nmwg:data>
</nmwg:message>
 
 
  • No LSStore-control.xml storage file  :
<nmwg:message id="msg1_resp" messageIdRef="msg1" type="EchoResponse">
    <nmwg:metadata id="resultCodeMetadata">
        <nmwg:eventType>error.echo.no_storage_content</nmwg:eventType>
    </nmwg:metadata>
    <nmwg:data id="resultDescriptionData_for_resultCodeMetadata" metadataIdRef="resultCodeMetadata">
        <nmwgr:datum>EchoRequest error: No [LSStore-control] schema</nmwgr:datum>
    </nmwg:data>
</nmwg:message>
  • Everything OK.
<nmwg:message id="msg1_resp" messageIdRef="msg1" type="EchoResponse">
    <nmwg:metadata id="resultCodeMetadata">
        <nmwg:eventType>success.echo</nmwg:eventType>
    </nmwg:metadata>
    <nmwg:data id="resultDescriptionData_for_resultCodeMetadata" metadataIdRef="resultCodeMetadata">
        <nmwgr:datum>
           This is the successful echo response from the Lookup Service. 
           Additional message is:
           Test DB Connection - OK (got database current time: [2007-02-21T11:10:32.1+01:00])
           Test DB Schema: [LSStore] - OK
           Test DB Schema: [LSStore-control] - OK
        </nmwgr:datum>
    </nmwg:data>
</nmwg:message>
Personal tools