LS EchoRequest
From GEANT2-JRA1 Wiki
(Redirected from LS echo-results)
Contents |
[edit]
EchoRequest for Lookup Service
[edit]
Request
[edit]
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.
[edit]
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>
[edit]
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
[edit]
Response
[edit]
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>
